Import a workflow configuration

You can import a workflow item configuration file and a mapping file to update or configure workflow items in another ArcGIS Workflow Manager system.

The mapping file can be used to associate organization items in the source configuration with organization items in the target configuration that are used by Workflow Manager. To import a workflow configuration file from a later version of Workflow Manager, upgrade your workflow item to the latest version.

To import a workflow item configuration, complete the following steps:

1. Access the Workflow Manager web app.
2. Click the Design tab.

   The Design page appears.

   Note:

   If you don't have sufficient privileges, the Design tab is not available.

3. Click Settings .

   Note:

   If you don’t have sufficient privileges, Settings is not available.

4. Click the Import Data tab.
5. Click Select configuration file and browse to the location of the workflow_configuration_<export_ID>.wmc file.
6. If you downloaded a mapping file, configure the mapping file, click Select mapping file and browse to the location of the workflow_mapping_<export_ID>.json file.
7. Optionally, check the Overwrite data in this item check box to overwrite all data in the current workflow item.

   If this option is not checked, existing data will be maintained with the imported data.

   Note:

   Existing jobs must be deleted before you can overwrite data in the workflow item.

8. Click Import data.

   The workflow item configuration is imported.

   Note:

   If the job template fails to import, but the settings data imports successfully, check the sharing settings for the job templates that failed to import and re-import the .wmc file.

Configure the mapping file

The mapping file is an optional file that allows you to associate organization items that are used by Workflow Manager, such as feature service data references, ArcGIS Survey123 extended properties, user-defined settings, and organization groups. Mapping files are commonly used when sharing workflows with other organization members, or in continuous integration and continuous delivery (CI/CD) workflows. Before importing the mapping file, parameters for the target configuration must be provided.

To associate items in the source configuration with items in the target configuration, complete the following steps:

1. Open the workflow_mapping_<export_ID>.json file in a text editor.
2. Provide values for the targetPortalItemId and targetPortalUrl properties as necessary.

   For example:

   {
      "workflowItemId":"b196643dad27488b9204846235cffbe0",
      "workflowItemName":"Workflow Item 1",
      "diagrams":[
         {
            "diagramName":"Workflow Diagram 1",
            "diagramId":"m7R2ap-eQlC3q2RrQCDWRQ",
            "centralizedDataReferences":[
               {
                  "centralizedDataReferenceAlias":"Gas_Utility_Network",
                  "centralizedDataReferenceId":"45faee8c-9408-4915-abf5-43a7adace12f",
                  "sourcePortalType":"ArcGISOnline",
                  "sourcePortalItemId":"e8dc20b5c9dc4cbfa65f8125ec2b7227",
                  "targetPortalItemId":"1daaeba244064ba1945aaa8d8f9f1457"
               }
            ]
         }
      ],
      "extendedProperties":[
         {
            "tableName":"property_damage_survey",
            "tableId":"xQ1KCoVfRhyzZo1n_EZbmw",
            "isSurvey":true,
            "sourcePortalType":"Current",
            "sourcePortalItemId":"39a0c0b4e808470fbb97cadb3c956db4",
            "targetPortalItemId":"aa73b31da9424f52bb70ac20f99cc490"
         }
      ],
      "userDefinedSettings":[
         {
            "settingName":"user_1",
            "isEncrypted":true,
            "targetPreserveValue":false
         }
      ],
      "groups":[
         {
            "sourceGroupId":"e4ba6bfff9834f8a91200b6152ecef5d",
            "targetGroupId":"1da4fe3ff3db42e08b2258cdbc642b22"
         }
      ]
   }

3. Save the file.
4. Import the mapping file to Workflow Manager.