Displaying Web Controls in WorkPoint Express

In this example we have developed a Microsoft Power App which shows a map indicating the location of company entities. For information about how to create Microsoft Power Apps, please visit this article.

We want this Power App to be usable when inspecting a Company on our solution in WorkPoint Express.

This configuration can be set up in the WorkPoint Express settings:

1. In the WorkPoint Express interface, click the "Menu" button.
2. In the menu, click "Settings".

3. In the WorkPoint Express settings, go to the "System" tab.
4. In the System tab, go to the "Embedded Web Controls" tab.
5. In a new line, in the "Site" field, select the solution for which you wish to display the web control (in this case, the Power App). In this example, we select the "anm0011" site. Only sites added to the current WorkPoint Express solution ID are selectable here.
6. In the "Business Module" field, select on which business module this web control should appear. In this case, the Power App displays information about companies, so we select the "Companies" business module.
7. In the "Name" field, we can type in a name for the embedded web control. This will be the displayed name for the control in WorkPoint Express.
8. In the "Link" field, paste in the link to the Power App in play mode. It is important to remember that if the Power App uses any WorkPoint fields, these need to be added in the link. For example, the Power App used in this example utilizes two Company fields: the Address 2, and the Email fields. Depending on the WorkPoint to Power App configuration, these field names can be customized. In this example, the Power App uses fields entitled Entity_Address and Entity_Email (The "Entity_" prefix indicates that the field is an entity field). These are then mapped in internal field names on the Company entities. The link given in this example is the following:

Pay special attention to the "&Entity_Address={wpAddress2}&Entity_Email={wpEmail}" part. This is where we tell the Power App to show the field with internal name of "wpAddress2" where the "Entity_Address" parameter is used in the Power App, and to use the field with the internal name "wpEmail" where the Entity_Email parameter is used.

9. Once the configuration is complete, click the "Close" button. WorkPoint Express will prompt you to restart WorkPoint Express for the changes to take place.

Once WorkPoint Express is up and running after the restart, the web control now shows up on Company entities:

In this example, for each project in WorkPoint Express, we wish to display a web control which automatically searches google for the project title.

This can be configured in the WorkPoint Express settings:

10. In the WorkPoint Express interface, click the "Menu" button.
11. In the menu, click "Settings".

12. In the WorkPoint Express settings, go to the "System" tab.
13. In the System tab, go to the "Embedded Web Controls" tab.
14. In a new line, in the "Site" field, select the solution for which you wish to display the web control. In this example, we select the "anm0011" site. Only sites added to the current WorkPoint Express solution ID are selectable here.
15. In the "Business Module" field, select on which business module this web control should appear. In this case, the google search should be performed for Project titles, so we select the "Projects" business module.
16. In the "Name" field, we can type in a name for the embedded web control. This will be the displayed name for the control in WorkPoint Express.
17. In the "Link" field, type in the google search query. Here, we can use WorkPoint entity fields in the search query. In this example, we use the following link:

Note that in the google url, we have added "search?q={Title}". This tells google to perform a search for whatever comes after "q=". In this case, we have used to WorkPoint entity field called "Title". It is important to note that WorkPoint fields must be encompassed by curly braces. It is also important to note that you must use the internal name of the field. We could also have used e.g. the Project ID as a search query. In that case, we would instead type "search?q={wpProjectID}" after the google url.

18. Once the configuration is complete, click the "Close" button. WorkPoint Express will prompt you to restart WorkPoint Express for the changes to take place.

Once WorkPoint Express is up and running after the restart, the web control now shows up on Project entities:

In this example, we will set up a custom link to a google search for companies' CVR numbers:

19. In the WorkPoint Express interface, click the "Menu" button.
20. In the menu, click "Settings".

21. In the WorkPoint Express settings, go to the "System" tab.
22. In the System tab, go to the "Embedded Web Controls" tab.
23. In a new line, in the "Site" field, select the solution for which you wish to display the web control. In this example, we select the "anm0011" site. Only sites added to the current WorkPoint Express solution ID are selectable here.
24. In the "Business Module" field, select on which business module this web control should appear. In this case, the google search should be performed for company CVR numbers, so we select the "Companies" business module.
25. In the "Name" field, we can type in a name for the embedded web control. This will be the displayed name for the control in WorkPoint Express. In this case, we type in "Search CVR".
26. In the "Link" field, type in the google search query. Here, we can use WorkPoint entity fields in the search query. In this example, we use the following link:

Note that in the google url, we have added "search?q=CVR+{wpCVR}". This tells google to perform a search for whatever comes after "q=". In this case, we have typed in a static query of "CVR" followed by a WorkPoint entity field called "wpCVR". It is important to note that WorkPoint fields must be encompassed by curly braces. It is also important to note that you must use the internal name of the field. We could also have used e.g. the company Account Number as a search query. In that case, we would instead type "search?q={wpAccountNumber}" after the google url.

18. Once the configuration is complete, click the "Close" button. WorkPoint Express will prompt you to restart WorkPoint Express for the changes to take place.

Once WorkPoint Express is up and running after the restart, the web control now shows up on Company entities: