Skip to main content
Matrix42 Self-Service Help Center

Deep Linking

How to Use Deep Linking  

  • URL pattern:
    <HOST>/wm/app-<App Name>/<Navigation Id>/create-object/<Entity Type>?viewOptions={"embedded":true,"viewId":"0944d5ed-bc62-f8f6-7187-f6800a3bcb2b"}
  • Example demonstrates how to open create new incident in Service Desk, without header and navigation, with prefilled User and Subject{"embedded":true}&presetParams={"SPSActivityClassBase":{"Subject":"SUBBBBBJECT!!!!","Initiator":"af72bbed-3d28-e811-719c-d850e6420719"}}
  • Example demonstrates how to open the create new incident in Service Desk without header and navigation, and with single dialog tab shown: {"embedded":true,"viewId":"0944d5ed-bc62-f8f6-7187-f6800a3bcb2b"}
  • JS code to perform "save" action in embedded view:

Mandatory parameters

  • "navigationId" parameter provides possibility to navigate to concrete navigation item in Navigation Tree view panel; otherwise, "notSet" should be set. This parameter isn't applicable in case "embedded" is set to true.
  • "entityType" parameter represents the configuration item name in the system an object of which will be created.

As you can see from the url pattern, there are few optional parameters which you can provide depending on the purpose

  • "?viewOptions={}" parameter gives possibility to open create dialog in different modes.
  • "embedded":true option makes create form mobile responsive and hides UUX navigation panels
  •  You can also use "viewId:"" parameter to provide direct link to concrete tabulator in your dialog
  • presetParams: provides access to prefill datamodel

For example, lets open Incident General tab create dialog in embedded view:


You can see that the dialog is responsive, so it can be used for mobile app integration and also only the General tab is available.

  • URL pattern: <HOST> /app-<App Name>/<Navigation Id>/edit-object/<Entity Type>/<Object Id>?viewOptions={"embedded":true}
  • URL Example:{"embedded":true}

The "objectId" is mandatory parameter representing an object that will be edited.

  • URL pattern: <HOST> /app-<App Name>/<Navigation Id>/preview-object/<Entity Type>/<Object Id>/<Is Archived>/optional:<Preview Widget Id>?viewOptions={"embedded":true}
  • URL Example:{"embedded":true}

 "isArchived" is a mandatory parameter indicating a current object will be taken for previewing if the value is set to "0"; otherwise, an archived one if parameter is set to "1".
The "previewWidgetId" parameter is optional providing a concrete dialog for preview; otherwise, used by dialog with higher priority (by default).

  • Was this article helpful?