You can use deep links in conjunction with the Workspace (Mobile) apps to link to specific locations (such as Tasks, Application Forms and login pages). When you click a deep link the Workspace (Mobile) apps will open that item directly, without requiring you to navigate to a specific form.
You can set up the following types of deep links:
You can send deep links to users via notification emails (for workflow steps), in a normal email, by text message, from a website, or other ways that links are typically shared. When you tap a deep link on a mobile device, the targeted detail card or form opens.
If the Workspace app is not running, the app opens and shows the login screen. However, the deep link context is lost in this case and you are not taken to the detail card or form. You must tap the deep link again (while the Workspace app is running) to open the
detail card or form.
Building a deep link
Deep links have a unique prefix made up of 'K2://', the public-facing server address (the server you log into when using the Workspace app), and the target detail card or form. For example: K2://m1.denallix.com/task/[task serial number]will open the task detail card for the specified task serial number.
Target Type |
Deep link example |
Task |
K2://[server]/task/[serial_number] |
Task Form |
K2://[server]/task/[serial_number]/form |
Application Form |
K2://[server]/form/[system name]
The application form deep link uses the form's system name, not the display name.
Deep Link URIs do not allow spaces - substitute spaces in the form's system name with the + (plus) character. |
Login Page |
K2://[server]/signIn
When you tap a deep link that specifies a server and you are already logged in to the Workspace mobile app, you will be prompted whether to continue since you will be signed out. If there are outbox items or draft items present, data will be lost on sign out. If you choose to continue, you will be signed out and presented with the sign in screen for the specified server.
|
If you build the deep link as part of a customized email notification within a workflow, you need to manually type in the URI, but you can drag the task serial number for a task or application form from the context browser, as shown in the following image:
You may not use spaces in the form system name or the deep link URI breaks. You can manually enter the form system name substituting any spaces with the + (plus) character.