How to Edit and Deploy Route

Aim of this article

Explains how to edit and deploy a route – while considering various synchronization use cases.

Related sections

Routes (Reference Manual)

Required permissions

Integration Instance - Edit

Editing Already Deployed Route

  1. Go to Account > Integrations > Routes > Instance Repository tab.

  2. Finds the route to edit. 

  3. Click Create Local Copy in the row menu.

  4. Provide a name of the local copy (you can use the same name as the already deployed route has). 

  5. After you click Copy, you will be redirected to the Workspace tab.

  6. Find your new route and click Edit in its row menu.

  7. Update the XML definition as needed. 

  8. Click Save & Deploy if you want to have the route deployed immediately. 
    Alternatively, click Save if you want to deploy the route later.

  9. The route is deployed (updated in IM), the local copy disappears from the Workspace and information about the route in Instance Repository is updated (e.g., the last updated column). 

Deploying New Version of Route Modified in IM

The following scenario covers the case when you want to deploy a new Version of a route which was meanwhile modified in IM (e.g., via Git). 

  1. First 8 steps from the previous scenario apply. 

  2. Click Deploy for your route in Workspace.

  3. A warning is shown that the route was changed in IM meanwhile. The code comparison is shown.

  4. You can deploy the route anyway (and overwrite the changes in IM with your local copy).
    or
    You can create a fresh local copy, make the required changes there and deploy it.

Deploying New Version of Route whose Unique Name Was Changed Meanwhile

  1. User A is working on a local copy of an already deployed route “Route1”.

  2. User B changes the Unique Name of the “Route1” to “Route2” in IM. 

  3. User A can see in PlatformManager in their Workspace that the “IM parent” is now empty in their local copy of the route and a warning is shown there that there is no such route in IM. 

  4. User A deploys their changes to IM. 

  5. There are 2 routes in IM now:  “Route1” (deployed as a new route by user A) and “Route2” (original route renamed by User B).

PlatformManager version 1.75.0