(v24) Import Visual Gallery Visuals

Import Visual Gallery Visuals

Import one or more visuals

1. Log in as a user with the Manage Connections, Administer Sources, Administer Visuals  privilege. If you are logged in as a tenant admin, verify you're in or switch to the appropriate tenant.

2. Select Visual Gallery on the top-level navigation banner or the UI menu, or select the Visual Gallery box on the Home page. The visual gallery work area opens.

3. Select Import Visual. The Import Visuals dialog opens.

4. Browse to and choose the json file for the visuals you want to import, then select Open.

   The Import Visuals dialog populates with information about the objects that make up your visuals and the settings you can use to define how your software inserts each object.

   

5. Add and remove tenants by selecting the Tenants field. Add or remove them from the list or field.

   Note: Only system admins or members of the Content Distributors group see the Tenants field. If this field is not shown, the content is imported into the tenant you are currently working in.

6. Optionally, enable or disable Ignore Warnings.

   When you enable Ignore Warnings, a Tags field is added to the Import work area. Add or create tags to apply to objects that do not import cleanly.

   • If errors occur during import, your software adds the tags you select to the affected objects.

   • Use the tags to find visuals or sources you need to fix.

   Note: When you enable Ignore Warnings, items that can be imported with warnings are imported and tagged. Use these tags to find and fix the warnings in tagged objects. When disabled, no objects are imported, and errors are returned to aid in troubleshooting.

7. Select an Insertion Strategy for each group of objects.

   • Always create objects: Select to create an object every time, even if an existing object exists with the same name or unique ID.

   • Reuse existing objects: Select to create an object if no object with the same name exists. If an object with the same name or unique ID exists, the original object is reused.

   • Update existing objects: Select to update (overwrite) an existing object with the same name or unique ID. If an object with the same name does not exist, an object is created.

8. Use the default Matching Strategy or select the appropriate strategies for your sources in the order you want the strategies to be processed. See Matching Strategies .

9. Enable Share Default Access With All Users to immediately give your users access to the content you import.

10. After you've confirmed your choices, select Import. The visuals are imported and a success message is returned if objects import successfully or with accepted warnings. Any items imported with warnings have your selected tags applied.

Note: If you import an exported source that has an associated translation file, you must re-upload the translation for that source.

Visuals with a unique name are imported with that name. If the name is not unique, the newly imported visual is imported and the name appended with a date and time.

Important: Trying to import a visual that uses the same source name as an existing source but uses different connection details or credentials may cause issues. Change the name of the source before you export it from one instance and import it into another.

See Export Visual Gallery Visuals.

Matching Strategies

When you import objects into Composer, combine these matching strategies with your selected insertion strategies to meet your organization's needs. The strategies are applied in the order you select. When you create new objects, matching strategies are not used.

Visuals

Strategy	Notes
By Name	The default strategy used if no other strategies are selected.
By Origin ID

Sources

Strategy	Notes
By Name	The default strategy used if no other strategies are selected.
By Origin ID

Connections

Strategy	Notes
By Id, Type, and Parameters	A default strategy used if no other strategies are selected. Used with By Type and Parameters if it's not deselected.
By Type and Parameters	A default strategy used if no other strategies are selected. Used with By Id, Type, and Parameters.
By Name
By Name and Type
By Origin ID
By Type and Parameter Keys