4 Managing Domains

Use domains in Solution Designer to organize and manage specifications such as Customer Facing Services (CFS), Resource Facing Services (RFS), and resources into meaningful groups.

About Domains

A domain is a logical group or category that represents a specific area or type of service within the telecommunications industry. It is used to organize and classify the specifications, offerings, and capabilities provided by the service provider. Each domain typically represents a distinct aspect of the telecommunications services, such as voice services, data services, network infrastructure, security, customer support, cloud services, Internet of Things (IoT), or any other relevant category specific to your service offerings.

Domains are divided into service domains and technology domains to provide a granular categorization within a specific domain. A technology domain can reference zero or more service domains. Domains are used for filtering when creating service and technology models. For example, if the Mobile service domain is selected, then only those entities belong to the same service domain are available for selection when building the PSR model.

A service specialist manages service domains and technology domains. Domains are a required part of entity definitions in Solution Designer. Each entity belongs to a domain:

Table 4-1 Types of Domain

Domain Type Description Specifications
Service Manage the specifications related to customer services. Service domains represent different types of services that are offered. Examples include Mobile, Broadband, TV, Voice, Cloud Services, and Internet of Things (IoT).

CFS

RFS

Resource

Technology Manage the specifications related to the underlying technologies that are used to implement those customer services. Technology domains represent the different technologies used to deliver the services. Examples include DSL, Fiber, Cable, 5G, LTE, Wi-Fi, and Satellite.

Resource

RFS

You can use multiple domains of the appropriate type to help organize your specifications and models. For example, a Mobile Service offering can have a service domain as Mobile and technology domains as 5G, 4G, and so on.

A service domain can be associated with multiple service models and specifications. Similarly a technology domain can be associated with multiple technology models and specifications. The specifications can have one primary domain and multiple secondary domains.

Domains play an important role in realizing a design. After an initiative is released, you can use the domains belonging to that initiative elsewhere in the application.

Creating Domains

You create domains using the Domains application, or in Select service domain step when creating service models, or in Select technology domain step when creating technology models in the guided process.

To create domains:
  1. In the Solution Designer landing page, click the Domains application.

  2. To create domains, do one of the following:

    • In the Domains application, click Create Domain.

    • In the PSR Models application, click Create Service Domain in the Select service domain step while creating a service model.

    • In the PSR Models application, click Create Technology Domain in the Select technology domain step while creating a technology model.

    The New Domain drawer appears.

  3. Enter the following details:

    Table 4-2 New Domain Fields

    Name Required or Optional Description
    Name Required

    Name of the domain. Name must have more than one character.

    ID Required

    Id of the domain.

    Type Required
    The type of domain.
    • Service
    • Technology
    Description Optional

    The description of domain.

    Associated Service Domains Optional

    The service domains that are associated with the technology domain. This field appears only when you select Technology as the Type.

    Implementation Assets Optional

    The relative path of the helper class files. For example, /bucket/helperclass.zip.The helper classes in compressed (zipped) format must be placed in S3-compatible object storage.

    Initiative Required

    The initiative that the domain belongs to.

    The domain IDs must follow the naming rules. See "About Naming Rules" for more information on naming rules.

  4. Click Add.

    The domain is created.

Viewing Domains

A Service Specialist views the domains from the Domains application or from the Initiative Items tab in the initiatives editor page in the Initiatives application.

To view domains:

  1. In the Solution Designer landing page, click the application that you want to work with.

  2. Do one of the following:

    • In the Domains application, search for a domain using the following criteria:

      • Domain name
      • Type: Service or Technology
      • Status: Lifecycle status
      • Initiatives
      • Last Updated date

      The domain result is filtered based on the search criteria.

    • In the Initiatives application, search for an initiative and click the Initiative Items tab in the initiatives editor page.

  3. Select a domain to view the details of that domain.

    A Domain drawer appears.

    The following details are displayed:
    • Overview tab: Shows the details of the domain.
    • Used by tab: Shows all the items such as models, domains, and specifications that the domain is associated with. You can filter the results by searching with the item name.
  4. After viewing the details, click anywhere outside the dialog box to return to the Domain list page or the initiatives editor page.

Updating Domains

You can update the domain details such as Name, Description, and Associated service domains.

To update a domain:
  1. In the Solution Designer landing page, click the application that you want to work with.

  2. Do one of the following:
    • In the Domains application, search and select a domain.

    • In the Initiatives application, search for an initiative and select a domain from the Initiative Items tab in the initiatives editor page.

    The domain dialog box opens.

  3. Click Edit and update the name, description, implementation assets, or the associated service domain.
  4. Click Update.

Note:

You can't update the domain Type.

You can't update the domain details in the following scenarios:

  • If the associated initiative has completed the definition phase but is not approved for testing.

  • If the associated initiative is in the Acceptance Testing phase, the Approval phase, or the Released phase.

Deleting Domains

You delete a domain from the Domains application or from the Initiatives application.

To delete a domain:

  1. In the Solution Designer landing page, click the application that you want to work with.

  2. Do one of the following:

    • In the Domains application, select a domain.

      The domain drawer opens.

    • In the Initiatives application, search for an initiative and click the Initiative Items tab in the initiatives editor page.

  3. Click Delete.

    The domain is deleted if it is not associated with any entities or domains.

Note:

You can't delete a domain:

  • If the associated initiative has completed the definition phase but is not approved for testing.

  • If the associated initiative is in the Acceptance Testing phase, the Approval phase, or the Released phase.