Generating deep link items (encrypted URLs)
You generate deep link items (encrypted URLs) in Planon ProCenter > Report generator.
Precondition for creating encrypted URLs:
• you have generated a deep link key pair in the Security TSI.
• you have activated and configured deep link navigation for the relevant business object(s).
In this example we generate a deep link item for the Personnel business object and the Personnel selection step in the Core - Personnel TSI. Proceed by generating deep link items in the Report generator, with the following procedure.
 | If you include deep links in a report without generating key pairs first and then generate the report, this might lead to an excessive number of errors in the error log. |
 | If you do not require an encrypted URL, follow the procedure in Creating deep link lists (unencrypted URLs) to generate unencrypted URLs. |
Procedure
1. In Core - Personnel, select the Personnel selection step
2. On the action panel, click Report.
3. In the Reporting dialog's action panel, click Add to add a new user report.
4. Under Settings, fill in the relevant fields, such as Type, Name and Title.
5. At the right of the Selected fields section, click the Add expression button.
6. Under Functions, scroll down and select generateDeepLinkItemURL.
7. Click the Add button at the bottom of this panel.
Under Expression, the expression is now partly displayed:
generateDeepLinkItemURL(,,)
8. Fill in the part between brackets by entering the system name of the relevant base business object name. It must be entered before the first comma and between double quotes.
You can find the system name of the business object in the Deep link navigation TSI > Business objects selection level.
9. Enter the field name of the system code after the comma by double-clicking the System code field in the Available fields section.
The system code must relate to the business object you enter.
10. Optional: you can enter a navigation code if you want to direct users to a specific selection step, and override the configured priority. However, if you do not want to use a navigation code, just leave the space between the "" empty. In that case the automatic detection of the correct TSI is applied.
You can find the Code of the navigation definition by going to the Deep link navigation TSI > Deep link navigation selection level and selecting the relevant definition. Enter double quotes around the business object name and navigation definition code, and single quotes around the system code field . See the example:
generateDeepLinkItemURL("Person", Personnel.'System code', "NavDef001")
11. Click Check to verify if the expression is valid.
12. At Available fields, add the Code field to the report definition, so you can check in the report which URL is generated for which personnel record.
13. Adjust the report layout as required, for example by widening or narrowing column width.
| | For more information on the Expression builder and user-defined reports in general see Working with expressions. For special functions such as including deep link items in mail merge reports, see Special functions. |
14. Click Preview & print.
The report displays a URL per personnel record.
15. Click Save.
The URLs in the report can now be shared with the relevant user groups. The users in the linked user groups can access the records via the URLs.