Creating a Deep Link

How to create a deep link

Deep links allow data to be passed from another application directly into a form. A deep link is a URL that, when clicked, opens the app and launches a specific form with pre-filled values and settings. For example, a deep link can be triggered from IFS Mobile Work Order (MWO) to open and populate a form automatically.

The Deep Links page offers a consistent way to create and manage deep links for a form. This page displays all available parameters and form fields, making it easy to add them to the link.

If you're not familiar with the steps in this process, please contact your IT department or support@omnibyte.com for assistance.

1. From the toolbar, click (Connect) and select Deep Links. Then select + Deep Link to open the Deep Link window.
   
2.  Enter a name for the deep link.
3. Toggle on/off the parameters for the deep link you are building. If you use one of the parameters that add “<<addvaluehere>>” anything between << and >> needs to be manually updated before the link can be used. 

   FindSaved	Uses the IntegrationFormEntityID to find a saved form on the in the app. Typically used to allow users to resume a previously started form that was saved but not yet submitted. By providing a direct link to the saved form, FindSaved lets a user bypass the need to manually search for the form, enabling quick and seamless continuation of incomplete submissions.
   HideFormList	Hides the homepage when opening a form from a deep link.
   ShowSubmitPage	Shows a page that says “Form Submitted” rather than taking the user back to the forms listing.
   HideFieldParams	Hides the bar at the top of the main menu in the app that displays the values that were passed in. This can be useful when passing sensitive data or when you want to minimize on-screen clutter for the user.
   SendFormSubmissionEmails	Triggers the sending of submission emails when a form is successfully submitted. The system will send emails according to the form’s configured submission email rules.
   HideBackButton	Hides the back button in the app when a form is accessed via a deep link. When enabled, users are prevented from navigating back to the homepage.
   NoSync	Prevents the application from performing a data sync when a user accesses the app via a deep link.
   FormName	App tries to automatically open a specific form when the app is launched via the deep link. The value of this parameter should match the exact name of the form as defined in the system.
   LinkID (?)	Associates or groups multiple form submissions under a common identifier submission by the app deep linking. For example, a service call may be “linked” to multiple safety form submissions.
   FormDefinitionID	Directs the app to automatically open a specific form based on its unique internal identifier when the app is launched. The FormDefinitionID references the form by its system-assigned unique ID, ensuring greater accuracy—especially when multiple forms may share similar names.
   IntegrationFormEntityID (?)	Locates and references a specific existing form submission or saved draft. It is typically passed as a parameter in a deep link to retrieve a form that has already been created but not yet submitted. The IntegrationFormEntityID points to a specific instance of that form — usually tied to an external system record such as a job, task, inspection, work order, or assessment.
   AdditionalEmails	Allows one or more email addresses to be added to the recipient list for submission notification emails associated with a form.
   CallBackURL	Specifies a URL to which the app will redirect or deep link after a form is saved or submitted.
   ExternalSync	Used with the CallBackURL to facilitate seamless data synchronization workflows with an integrating application. When ExternalSync is enabled, the app first opens to perform a data sync, ensuring that the latest form data and configurations are updated. After the sync is complete, the app automatically navigates back to the integrating app via the specified CallBackURL, enabling smooth transitions and up-to-date information exchange between systems.
   DataSetParameters	When toggled on click Add Data Set. Select the data set you want to use on this deep link. Once a data set is selected, the Parameter fields for all parameters on the selected data set are added. You can add values as needed.
   RegKey	Accept and uses a registration key passed directly within the deep link URL. By including this parameter, the user can bypass the manual entry of the registration key during the app’s launch or form access process.

4. Toggle DataSetParameters on to use a data set on the deep link.
5. Click + Form Field to add any fields you want to include in the deep link along with the value you want them to contain.
6. When a static or dynamic table is selected as the Field, the Value field is an array of rows that contain an “outline” of the table columns so that you only need to enter the values in the appropriate rows. You can leave any values blank. When a table is being passed in, the whole table is brought in at once as a whole. Passing the value for a static table and a dynamic table differ slightly. For example:
   Static Table: {“rows”:[[“”, “text”, 4,”hi”],[“”,”text3”,6,”hello”]]}
   

   Dynamic Table: {“rows”:[[“text”, 4,”hi”],[”text3”,6,”hello”]]}

   The value is an object containing an array of rows. Each row needs to have the exact number of values for the number of columns in the table. Static table values need to include a blank string at the beginning of each row array because of the label column.

   A blank string is passed for any other cells that aren’t being filled by the deep link.

   If more than one row is passed for a dynamic table value, then a new row is created in the dynamic table for each extra row passed in the deep link value.

7. Toggle Encode on if you want certain characters in the URL to be converted into a format that can be safely transmitted over the internet—without breaking the link or causing errors. For example, ampersands and question marks have special meanings in URLs. When included as a deep link they could be misinterpreted by browsers.
8. Select the link format you want to use: Mobile App, Windows Desktop, or Browser.
9. Click Create Link to create the deep link. Once the link is created, you can edit any of the information in the link as needed. The Copy button can be used to copy the link into the integrating product as needed.
10. Click Save. Saving the deep link allows you to make changes later if the form changes or your data in the integrating product changes.