Importing Linked Visuals

In Arcadia Enterprise, you can import linked visuals from another system using an appropriate JSON file that captures the definitions of these visual artifacts and all their dpendencies (such as datasets and custom styles).

Follow these steps to import linked visuals. We previously created them in Exporting Linked Visuals.

  1. Click Data in the top navigation menu.
  2. Select the connection where to import the artifacts.

    We selected Documentation, because we are connecting to the same data source for both systems.

  3. At the top of the screen, click the (supplemental) menu.
  4. In the (supplemental) menu, click the Import Visual Artifacts option.

    starting import of visual artifacts
  5. The Import Visual Artifacts window modal appears.

  6. Click Choose File.

    Import Visual Artifacts modal, default
  7. Select the backup file in your file system. Here, we are getting visuals_flow_of_events.json, the file created in Exporting Dashboards.

    getting the backup json file
  8. In the updated Import Visual Artifacts modal, notice the three import options:

    • Import to Workspace (Private by default)

      The drop-down menu enables you to specify the destination workspace. By default, Arcadia Enterprise imports the visual artifacts into the user's Private workspace.

    • Disregard artifacts that exist in other workspaces (Off by default)

      Before importing an artifact, Arcadia Enterprise searches for it on the system. If it already exists, it is either updated (if changed from a previous import), or left 'as is'. If it does not exist, it is imported as a new visual artifact.

      By default, the search domain is the entire system. By selecting this option, you are limiting the search to the specified workspace.

    • Check data table compatibility (On by default)

      This is a 'sanity check' that confirms that tables suitable for the incoming dataset(s) exist on the system. This means that the database and tables have the same names on the source and target systems.

    After making the appropriate selections, click Import.

    completing import request
  9. After processing the import *.json file, Arcadia Enterprise opens the Import interface to show its visual artifacts. Here, it displays the visual and the dataset that we saved earlier into the visual_flow_of_events.json file, during export.

    Notice also that the Planned Action column shows that this is a new import for all artifacts. At this point, none of them have an assigned ID.

    Click Accept and Import.

    Accept prepared import
  10. After the import completes, a Success message appears on the Import interface.

    Notice that all the artifacts have an assigned ID. These are generated by the system, sequentially. Visuals/Dashboards and datasets have separate id queues.

    Import success
  11. To confirm that the visual is imported successfully, select the appropriate workspace (here, Private), and click Linked Visuals in the top navigation.

    The new linked visual is in the catalog.

    confirming that imported visual is in ArcViz, tile view

    If you are using the list view of the catalog, you may notice that the new visual has an ID generated by the new system. Notice also that you can confirm the dataset and connection names that the visual uses, both in the Dataset column.

    confirming that imported visual is in ArcViz, list view
  12. Lastly, if you examine the same visual in edit mode, you can confirm that it has the same appearance as in the source system. Note also that it is not part of any dashboard in the new system.

    confirming appearance of visual, that it is not in a dashboard