You can use deep links in conjunction with the K2 Workspace (Mobile) apps to link to specific locations (such as Tasks, Application Forms and K2 login pages). When you click a deep link the K2 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:
- Link to the Task Detail Card
- Link to the Task Form
- Link to the Application Form
- Link to a K2 Server
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 K2 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 K2 Workspace app is running) to open the detail card or form.
Building a deep link
K2 deep links have a unique prefix made up of 'K2://', the public-facing K2 server address (the server you log into when using the K2 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. |
K2 Login Page |
K2://[server]/signIn
When you tap a deep link that specifies a server and you are already logged in to the K2 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 K2 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.