Importing a visual

In CDP Data Visualization, you can import linked visuals from another system using an appropriate .json file that captures the definitions of these visual artifacts and all their dependencies (such as datasets and custom styles).

Follow these steps to import a visual.

  1. Click DATA in the Main navigation bar.
  2. Select the connection where to import the artifacts.

    In this example Documentation has been selected, showing connecting to the same data source for both systems.

  3. At the top of the screen, click the (supplemental) menu.

    The Import Visual Artifacts modal window appears.

  4. Click Choose File.
  5. Select the file you want to import.
    In this example, visuals_flow_of_events.json is selected.
  6. Specify the destination workspace in the Import to Workspace drop-down menu.
    By default, Data Visualization imports the visual artifacts into your Private workspace. However, you can choose the Public workspace, or another workspace.
  7. Specify how you want to handle thumbnails.
    There are three options:
    • Import from the file
    • Generate new thumbnails
    • Skip thumbnail import
    By default, Data Visualization imports the thumbnails from the file. However, you can choose to generate new thumbnails during the import process, or skip thumbnail import.
  8. Define the Disregard artifacts that exist in other workspaces option.
    Before importing an artifact, Data Visualization 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.
  9. Check data table compatibility.
    This is to confirm that tables suitable for the incoming dataset(s) exist on the system. It means that the database and tables have the same names on the source and target systems. This option is 'on' by default.
  10. Click IMPORT.
    After processing the import .json file, Data Visualization opens the Import interface to show its visual artifacts. Here, it displays the visual and the dataset that you saved earlier into the visuals_flow_of_events.json file. The Planned Action column shows that this is a new import for all artifacts. At this point, none of them have an assigned ID.
After the import completes, a success message appears on the Import interface. All the artifacts have an assigned ID, which are generated by the system, sequentially. Visuals/Dashboards and datasets have separate ID queues.

For instructions on how to export a visual, see Exporting a visual.

For more information about the visual artifact migration utility, see Exporting and importing visual artifacts.