Popdock Widgets allow you to display data from disparate applications inside of the application that you choose to work in, without moving the data into that application. Widgets are extremally powerful in providing data access to your teams within their primary application and can dramatically decrease the time it takes for users to search for the data they need to perform their day to day tasks.
When embedding a Popdock widget into an external application, some applications allow for parameters. Parameters are values contained within a selected list/widget that can be passed through to an end destination, which in turn can filter the widget to be contextual to the page the widget is displayed on. For example, if we are embedding a Popdock widget containing ERP Invoice data into an Account page within a CRM, we can pass a parameter of Account Number so the widget is filtered and only shows invoices for the Account on display. We will dive into how to set up Widget Parameters below.
Environment
To locate the environment section of a widget, edit the widget you plan on adding a parameter to. Then select Widget from the left navigation pane.
The widget page will allow you to publish a widget to some connectors using the Connector drop-down menu, such as Business Central, Zendesk, or Salesforce. If you are not using one of these, you can select None for the Connector.
If you select None for the connector, no other dropdown will display.
From the Connector dropdown, select the connector you want to publish the widget to.
Once you have selected your connector, you’ll see either an Environment (Business Central and Zendesk) or Visualforce (Salesforce) dropdown. Select the object from the dropdown list where you want the widget to appear.
The connector on the Widget page does not need to be the same as the connector on the Parameter page. The connector you select on the Widget page is where the list is from. While the connector on the Parameter page is where you display the list. You could take a list from one connector and display it in a widget in a different connector.
Parameters
In the Parameters section, you can add an Environment parameter, URL parameter or Calculated parameter.
URL Parameters
URL parameter – You can use the URL parameter if you need to manually embed a widget. The URL parameter is used when your connector is set to None.
In the Name field, enter the name for the parameter. This is the name that will display as the prompt for the parameter.
From the Field dropdown, select the field from your list that you want to pull data from.
In the example above, the parameter is set up so that when you enter the customer’s name, it will return records from the list where the name matches.
If you have created a Lookup, you can use that in your parameter.
You can create multiple parameters and then Apply parameters in stages. Once you select Apply parameters in stages, you can assign the parameters to a Stage. By using a stages, you can enter a value in one or more of the parameters and the widget will return data based on what is entered.
If you want to make the parameters required, select the Required checkbox. Users will then be required to enter a value for the parameters, in order for the widget to return data.
Environment Parameters
Environment parameter – This type of parameter pulls all the fields from the object selected in the Environment drop down menu. This allows you to automatically pass your parameter through when you embed the widget to that object.
On the Parameters tab, select Environment parameters and then select Add an environment parameter.
In the Parameter dropdown, select a parameter. The Parameter dropdown list will show you the fields from the object you selected in the Environment field.
In the Field dropdown, select the field from your list. There should be a relationship between the parameter and the field.
In this example, the widget will show data when the bill to name from the list is equal to the name from the customer card. In other words, when you open the Customer Card and select a customer with a Name of ABC, the widget will display data from the Invoice list where the Bill to name is also ABC.
If you have created a Lookup, you can use that in your parameter.
You can create multiple parameters and then Apply parameters in stages. Once you select Apply parameters in stages, you can assign the parameters to a Stage. By using a stages, you can enter a value in one or more of the parameters and the widget will return data based on what is entered.
If you have additional questions about widget parameters, contact support@eonesolutions.com.
