2 Domain Configuration

The Retail Home Domain Configuration page gives administrators the ability to define domains within Retail Home.

Figure 2-1 Retail Home Domain Configuration Page

What is a Domain?

A domain is a logical grouping of Retail Applications.

The main characteristic of a domain is that applications within a domain share one (1) database schema for managing their application data.

Examples of domains include:

• The Merchandising Domain which includes the applications: Merchandising System (RMS), Sales Audit (RESA), Invoice Match (REIM), Allocations (ALC), and Price Management (RPM).

• The Advanced Science Domain which includes the applications: Assortment Space Optimization (ASO), Customer Decision Tree (CDT), and Demand Transference (DT).

Figure 2-2 Example Domains: Merchandising and Advanced Science

Domain Applications Assumptions

Retail Applications within a given domain all implement the Retail Applications Framework also known as "RAF" or "Platform".

The implementation of Platform for each Retail Application in the domain requires the following:

• Each Retail Application uses Platform runtime libraries.

• Each Retail Application deploys the common Platform REST services deployment (PSRAF).

• The database shared by Retail Applications within the domain includes the common Platform database tables.

Figure 2-3 Domain Applications with Platform Components

Domains within Retail Home

Retail Home relies on the Platform Services deployments by various domain applications to deliver administration of these applications.

Figure 2-4 Retail Home's Dependency on Platform Services in Each Domain

The following administration functions within Retail Home rely on the proper setup of domains:

• Customer Modules Management - Retail Home can determine the provisioning state of applications for customers by inspecting the Module Definition Framework (MDF) data in each domain's Platform tables. Retail Home can also allow customer administrators to modify the activation statuses of their applications and modules.

• Application Navigator Management - Retail Home can automatically generate and publish application navigator links down to each domain's applications allowing users to navigate between the applications with ease.

Launching the Domain Configuration Page

The Domain Configuration page can be launched from the Retail Home Settings menu's Application Administration section.

Figure 2-5 Domain Configuration Link within Retail Home's Settings Menu

The Domain Configuration page shows a table of all the domains registered in Retail Home.

Figure 2-6 Domain Configuration Page

The following information is shown for each domain:

• Domain Name - A descriptive name for the Domain

• Domain Instance URL - The URL indicating the host and port of the domain.

• Applications in Domain - The list of applications included in the domain.

The table toolbar gives users the ability to create, edit, delete or refresh domains.

Creating a Domain

The "Create" icon on the table toolbar allows users to register a new domain in Retail Home.

To create a domain, users enter the following required information in the "Create Domain" dialog:

• Domain Name - A unique name for the domain.

• Domain Instance URL - A unique URL for the domain.

  The Domain Instance URL is the host or host-port of the Platform REST Services (PSRAF) deployment for one of the applications in the domain.

  The domain instance URL is used by Retail Home to perform cross-application lookups and updates of Platform information in the domains.

Figure 2-7 Create Domain Dialog

Saving the New Domain

The OK and OK and Create Another buttons in the Create Domain dialog will save all entered values in the dialog into Retail Home.

The following events are triggered when saving the new domain:

1. Validate the Domain Instance URL

   The system validates the Domain Instance URL value for the domain by retrieving the list of provisioned applications from the domain's Module Definition Framework (MDF) repository.

2. Create System-Generated Application Navigator Entries

   The system generates application navigator entries that are used to render links within dashboard tiles in Retail Home. These links allow users to navigate to Retail Applications from Retail Home dashboard tiles.

   The system-generated application navigator entries are based on the provisioned applications reported during the domain validation in the previous step.

   These entries are associated to the new domain. The edits users can perform on these system-generated application navigator entries are limited. Users will be unable to delete them unless the domain that generated them is deleted.

   For more information about Retail Home's Application Navigator feature, refer to the section, "Application Configuration".

Editing a Domain

The "Edit" icon on the table toolbar allows users to change the information of an existing domain in Retail Home.

Users can modify the information the "Edit Domain" dialog:

Figure 2-8 Edit Domain Dialog

The rules and assumptions around the required domain fields described in the section Creating a Domain are applicable to domain editing.

Saving the Edited Domain

The OK button in the Edit Domain dialog will save all entered values in the dialog into Retail Home.

The validation and application association process applied when saving new domains is also applicable to saving edited domains:

• Validation of the domain instance URL is performed.

• The system-generated application navigator entries associated to the domain are refreshed based on the applications reported during the domain instance URL validation.

Refer to Creating a Domain for more information.

Deleting a Domain

The "Delete" icon on the table toolbar allows users to delete a domain in the system.

When a domain is deleted, system-generated application navigator links associated with the domain are also deleted.

Refreshing Domains

The "Refresh" icon on the table toolbar allows users to refresh the list of registered domains in the Retail Home system.