Exporting And Importing Maps

After you create one or more Maps, use the import/export feature to save your current Maps as a single JSON file and then reuse the Maps with other Solutions. Maps in Integration Solutions can be imported into Migration Solutions and vice versa.

Exporting Maps

Export one or more Maps to save the Maps in a JSON file and import them into other TIBCO Scribe® Online Solutions.

1. Select Solutions from the menu bar.
2. On the Solutions page, select a Solution name to open it.
3. In the Maps section, select one or more Maps to export by marking the check box or select the Select All link at the top column to include all Maps.
4. From the Maps section Menu , select Export Selected.
5. TIBCO Scribe® Online creates a single JSON file with the same name as the Solution. Any characters that are not alphanumeric are stripped out of the file name. Depending on the browser the file is stored in your default downloads location or you are asked to save it.

Importing Maps

When you receive file with Maps to import, save the file to a convenient location, such as the SampleMaps sub-directory under your TIBCO Scribe® Online Agent directory. When a Map is imported, the first revision has the associated comment Map Import in the Revisions dialog for that Map. See Map Revisions for more information.

1. Select Solutions from the menu bar.
2. On the Solutions page, select a Solution name to open it.
3. From the Maps section Menu , select Import.



4. Use the Choose File button to browse to the location of the Map file you want to import.
5. Select the file and select Open.
6. TIBCO Scribe® Online imports the selected file and adds all of the Maps in the file to this Solution, as follows:
   • If the Solution already contains Maps, the new maps are appended to the existing Map list.
   • Every imported Map is renamed with the prefix Imported - . For example if the original name of the Map is Update Contacts, the new name after import is Imported - Update Contacts.
   • If the Solution contains Maps with the same names as those in the import file, the existing Maps are overwritten with the imported Maps. However, since Map names are modified on import, the only way a Map name would match is if the Map name in the Solution had a prefix of Imported, but the Map in the import file did not, as follows: 

   • Solution Map Name	Import File Map Name	Map Name After Import	Import Action
     Update Contacts	Update Contacts	Imported - Update Contacts	Appends Map to list
     Imported - Update Contacts	Update Contacts	Imported - Update Contacts	Overwrites existing Map
     Update Contacts	Imported - Update Contacts	Imported - Imported - Update Contacts	Appends Map to list
     Imported - Update Contacts	Imported - Update Contacts	Imported - Imported - Update Contacts	Appends Map to list

     Important: A locked Map can be overwritten by an Administrator or the Map owner during the import process.

     Importing an exported Map revision always appends the Map to the list of Maps in the Solution. See Exporting A Map Revision.

7. Select Close to return to the Maps list.

Complete Imported Maps

1. On the Solution Edit page scroll to the Maps list.
2. Select an Incomplete Map.
3. On the Gear menu select Edit to open the Map.

   TIBCO Scribe® Online attempts to match the Connections in the imported Map with the correct Connections configured in the Organization. If Connection Names or IDs in the imported Map do not match Connections configured for the Organization, you must reassign those Connections to complete the Map. See Reassigning Connections.

4. If a matching Connection cannot be found, a warning message displays in the Connections panel on the Map workspace. Select Reassign on the Gear menu to choose a replacement Connection. See Reassigning Connections.

   Note: If you validate an imported Map before reassigning Connections, you will see multiple duplicate errors in the Errors and Warnings tab, instead of a single error.

5. When the correct Connections are set in the Map, allow the entities to populate and then make any necessary changes to ensure that there are no errors or warnings. See Block And Map Errors And Warnings.
6. When you are done, click OK to close and save the Map.
7. After you have updated all your Maps, exit the Solution. Changes to Solutions are saved immediately.

Importing Maps From Prior Versions Of TIBCO Scribe® Online

If you import Maps from an older TIBCO Scribe® Online Classic version that were created before multitarget Maps were supported, when you reassign Connections, the Connection Alias does not cascade down into the mapped fields.

Workaround — Update the field names in the Fields tab for each Block and prepend the Connection Alias. For example, if the Connection Alias is CRM_1 and the source field name is Campaign.Name, change the field name to CRM_1.Campaign.Name in the target Formula field.

Related Topics

Maps

Managing Maps