Domain separation for Platform Analytics dashboards

  • Release version: Xanadu
  • Updated August 1, 2024
  • 2 minutes to read
  • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Domain Separation for Platform Analytics Dashboards

    Domain separation in Platform Analytics allows for the logical grouping of data, processes, and administrative tasks into separate domains. This feature enables control over user access to data, ensuring that users can only view and interact with information pertinent to their specific domain.

    Show full answer Show less

    To activate domain separation, users must request the domain separation plugin. It is crucial that both domain separation and delegated administration are enabled for users in child domains to access dashboards in parent domains. Notably, users in child domains have read-only access to dashboards and cannot modify them.

    Key Features

    • Data Visibility: Only shared dashboards are visible to other users, ensuring domain boundaries are respected.
    • Edit Permissions: Users can edit dashboards only within their domain; for instance, an HR domain user cannot edit a dashboard created in the parent domain.
    • Domain-Specific Content: Dashboard data, including records, tabs, and widget containers, is subject to domain separation rules. Widget content visibility depends on its originating domain.
    • Global Dashboards: Dashboards defined at the global level can be accessed by all users with whom they have been shared, ensuring broad visibility across domains.

    Key Outcomes

    Implementing domain separation allows ServiceNow customers to manage their analytics more effectively by ensuring that dashboard data remains confined to appropriate user groups. This structure enhances data security and integrity while providing clear visibility into domain-specific operations. Administrators are advised to avoid editing domain-separated dashboards from the global domain to prevent visibility issues. Always ensure you are logged into the correct domain when managing dashboards.

    Domain separation is supported throughout Platform Analytics. Domain separation enables you to separate data, processes, and administrative tasks into logical groupings called domains. You can control several aspects of this separation, including which users can see and access data.

    Support level: Standard

    • Includes all aspects of Basic level support.
    • Application properties are domain-aware as needed.
    • Business logic: The service provider (SP) creates or modifies processes per customer. The use cases reflect proper use of the application by multiple SP customers in a single instance.
    • The instance owner must configure the minimum viable product (MVP) business logic and data parameters per tenant as expected for the specific application.

    Sample use case: An admin must be able to make comments required when a record closes for one tenant, but not for another.

    For more information on support levels, see Application support for domain separation.

    Overview of domain separation

    To activate the domain separation plugin, see Request domain separation.

    Important:
    For users in child domains to view dashboards in parent domains, both domain separation and delegated administration must be enabled.

    Users in child domains cannot overwrite dashboards. Child domain users only have read access to dashboards.

    How domain separation works in Dashboards

    Assumptions:
    • Only dashboards that have been shared are visible to other users. See Share a responsive dashboard.
    • Users granted edit permissions on a dashboard can only edit that dashboard if they are in the same domain as the dashboard. For example, a user who is in the HR domain cannot edit a dashboard created in the parent of the HR domain.

    Dashboard data that is domain separated includes dashboard records, dashboard tabs, and widget containers. Widget content is governed by the domain separation that applies to the content itself. For example, an admin adds a report created in the HR domain to a dashboard in the IT domain. This report is not visible to users in the IT domain, although they can see the widget container.

    A dashboard defined at the global level is visible to all users with whom it has been shared. A shared dashboard created in a parent domain is visible to users in the parent and all its child domains. For example, a dashboard created in the TOP company is visible to users in:
    • Joe's company
    • Other companies in the TOP company
    • All HR, CS, and IT child domains in those companies if it is shared with those users.
    In the following figure, dashboards created in the IT, CS, and HR domains are not visible to users in the other child domains or in the parent domain.
    Figure 1. Domains list example
    List of company departments in separate domains including IT, CS, and HR
    Important:
    Administrators should not edit a domain-separated dashboard from the global domain, because additions made to the dashboard are not visible to users within the separated domain. When editing dashboards, make sure that you are logged in to the correct domain.