Overview

Object Views are made up of tabs containing Workshop modules. Workshop modules are configurable parts of the view used to display data, such as tables or charts.

Administrators and users with Object View Admin application permissions in Control Panel can edit the configuration of object views. Some configuration options include changing the tab visibility or modifying tab content.

A change to an object view applies to all users and the entire object type. For example, if you edit the Airport object type by working within the "John F Kennedy International Airport" object view, the changes you make will apply to all airports that share the same object type.

Default configurations

An object view starts with a default configuration based on the object type definition in the Ontology. The default configuration is generated using prominent properties and links. You can find key properties and associated links in the Overview tab. This default view is dynamically updated based on the object type definition until the first view configuration edit is saved. After this first saved edit, the object view configuration is fully in the editor's control and all updates must be made manually.

Editing object views

Permissions

You must have appropriate permissions to edit an object view. The permissions required to edit the object view for an object type depend upon whether the object type uses Ontology Roles:

  • If the object type does not use Ontology Roles, a user must have the Object View Admin application permission in Control Panel as well as the Editor role on the object type's input datasources.
  • If the object type uses Ontology Roles, the user only requires the Ontology Editor role on the object type.

Configuration options include changing the tabs and widgets within the view and customizing the layout and conditional visibility. By default, an object view starts with a configuration based on the object type definition in the Ontology.

Administrators can also use Control Panel to configure profiles to use in object view. Profiles allow users to view object information relevant to their role.

Editing

To make changes to an object view, navigate to a relevant object type within Object Explorer. From the object view header, open the More menu, click Advanced, and then click on Edit object view.

Access object view editor in the More tab

After applying your changes, click on the "open" icon in the upper right corner to open the object in Object Explorer.

Open object in Object Exploring after editing

Use the object view editor

There are three main sections within the Object View editor: the object preview, the header, and the editor sidebar.

The preview shows your current working state for the object view configuration using a selected preview object and custom view, if configured. You may change the preview object and custom view in order to test your changes across different combinations of data.

Preview of edit object view

The header includes controls for three functionalities:

  1. The History button enables you to look into the object’s version history using the sidebar. When a user changes the object view configuration, buttons will appear to allow you to save, publish, discard, or republish your work. Learn more about managing object view versions.
  2. The Preview button opens and closes the editor sidebar. When the sidebar is closed, the object view is shown as a normal user (without editor controls) would see it.
  3. The Editor button opens the object view configuration sidebar.

Edit object view header

Use the editor sidebar to edit configuration and navigate between the three different levels of object view configuration: Tabs, Sidebar, and Settings.

In the Tabs section, you can edit the order of tabs in the object view or delete them. Click on a tab to configure the widgets within them or add a new widget. You can also configure visibility settings and layout in the Visibility and Settings options of the tab settings.

Edit object view tabs in object view editor

In the Sidebar section, add, remove, or reorder configured groups for the object type. You can view these groups in a collapsible sidebar to the right of your object view. Click on a group to configure its contents, visibility, and title.

Edit object view sidebar in object view editor

Use the Settings section of the editor sidebar to adjust the view width of your object view.

Edit object view settings in object view editor

At each level of configuration, you can switch between the visual editor and the code editor, which allows you to edit configuration as YAML.