Skip to main content
Use the Visual Gallery to view and manage the visuals defined in a Self-Service Analytics instance and shared with other users. You must be logged in as a user in a group with the Administer Visuals privilege to see the Visual Gallery. Read, write, and delete permissions for a visual gallery visual are controlled by the permissions assigned the data source used by the visual in combination with the user’s group privileges. As creator and owner of a visual, you are automatically granted read, write, and delete for the visual in the Visual Gallery. When you remove a user who has created visuals from the system, items created by that user are retained.
Local visuals exist only on the dashboard on which they were created. Convert to a Visual Gallery visual and add to the Visual Gallery at any time. Visual gallery visuals can be converted to a local visual at any time. See Convert Visual Gallery Visuals and Local Visuals.
If you log in as a user who has not been granted permissions for any visuals, the work area displays a message indicating that no visuals are available.
In this release, when your admin enables the Enhanced Experience user interface, you will see changes to workflows you may have used in previous releases.
To access the visual gallery, log in as an administrator or as a user with the Administer Visuals privilege.Select Visual Gallery from the main menu. The Visuals library appears, and visuals are listed in a table format. use this work area to manage your visuals
You can select and open a visual in the visual gallery to make a copy of a visual if needed. See Copy Visuals.

Search Field

Use the search field to filter the visuals shown by visual Type, Name, Description, Data Source, or Author. For example, if you type a C in the search box, only visuals that include the letter C in the selected field searched (or all fields if All is selected) are shown in the working area. See Search and Filter Lists.

Buttons

The buttons on the page allow easy access to saved visuals, as well as other visuals created by other users in your Self-Service Analytics environment. They also allow you to create a new visual and filter the visuals shown.
ButtonDescription
AllRemoves any filters for the visual gallery and displays all visuals you can access within your Self-Service Analytics environment.
Displays only the visuals that you have marked as favorites.
Displays only visuals that you created and saved. Visuals created and saved by other users are hidden.
Displays only the visuals that other users shared with you.
See Grant Permissions for a Visual.
Select to generate an embeddable visual link.
See Generate a Visual Gallery HTML Snippet.
Export Selected ItemsSelect to export multiple selected items.
See Export Visual Gallery Visuals.
Import VisualSelect to import one or more visuals.
See Import Visual Gallery Visuals.
Create VisualSelect to create a new visual. See Create and Add Visuals to the Visual Gallery.
Each column in the table is described below. Several of these columns can be used to sort the list: select the column header to sort first to last and again to sort last to first. You can search for items by the contents of several columns. See Search and Filter Lists.
ColumnDescription
Select (not labeled)Select one or more items to perform bulk actions, such as export, for your resources.
FavIdentifies favorite visuals using a star icon. If the star is colored (), the visual is a favorite. If the star is empty (), the visual is not a favorite.
TypeAn icon identifying the visual type (style) of the visual in the visual.
See Self-Service Analytics Visual Metrics and Attributes Reference to see all the possibilities.
NameThe name assigned to the visual. The visual name is not necessarily the same as the display name.
See Configure Visual Names, Descriptions, and Properties for more information about how visual names and display names are set.
Description (not labeled)The description icon is visible if a description associated with a visual. You can search for a visual by the contents of this field.
TagsContent tags applied to the visual. Select the filter icon to open a drop-down list and select tags to filter your list or to narrow your search results. If several tags are associated with an item, hover over the ellipsis to see all tags for this resource.
Data SourceThe name of the data source used by the visual. If a user does not have permission to view the data source, this field is blank.
AuthorThe name of the user who defined the visual.
Modified DateThe time stamp indicating when the visual was last modified.
PermissionsAssign and manage the permissions for a visual. Visible if you are logged in as a user with the Administer Sources privilege, or as a user with the Manage Source Permissions privilege.
ActionsDelete a visual if you have delete permissions. Before you delete a visual, you must remove it from all the dashboards that use it.
See Delete and Remove Visuals.
In this release, when your admin enables the Enhanced Experience user interface, you will see changes to workflows you may have used in previous releases.
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 from the main menu. 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. Use this work are to define what JSON file to import, for which tenants, using what insertion strategies, matching strategies, tags, and access rights
  5. Add and remove tenants by selecting the Tenants field. Add or remove them from the list or field.
    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.
    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. The object is created, appended with a date and time to the name, and assigned a 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 have 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.
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.
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 Self-Service Analytics, 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
Sources
Connections
Export one or more visuals
  1. Log in as a user with the Export Visuals privilege. Open the Visual Gallery to view a list of the available visuals.
  2. Select to export one or more visuals by selecting the checkbox for each visual to export. The Export Selected Items button becomes active.
  3. Select Export Selected Items. You browser downloads the selected items in JSON format, placing them in the location you select or the default location for your browser downloads.
Visual gallery visuals exported using the export API can include source cache settings for the data and statistics caches in the payload. API documentation is provided in your environment at this link: https://<Self-Service Analytics-URL>/composer/swagger-ui.html.