Go to primary content
Oracle® Retail Xstore Office Cloud Service 18.1 User Guide
Release 18.1
F18648-05
  Go To Table Of Contents
Contents

Previous
Previous
 
Next
Next
 

4 Profile Management

The goal of the Profile Management component of Configuration Manager is to define Store Personalities for your organization. The Store Personalities allow you to easily maintain portions of your configuration paths using a GUI format in Oracle Retail Xstore Office Cloud Service. Behind the scenes, these Store Personalities are translated into the various configuration paths specified in configPath.properties. For more information on Personality Maintenance and configuration paths, see Appendix B, "Appendix: Personality Maintenance and Config Paths."


Note:

The Configurator component of Configuration Manager is used to create, maintain, and deploy Oracle Retail Xstore Point-of-Service configuration changes selectively, or globally across the entire organization. Refer to Chapter 5, "Configurator" for more information about making configuration changes and deploying the information to your stores.

About this Chapter

Profile Management includes functions for creating and maintaining profile groups and elements for stores and registers, creating and maintaining the personalities that determine the prioritized profile elements for configuration overrides, and creating and maintaining the store landscapes used for machine (register) configurations. After setting up this information, you can assign Store Personalities to your stores.

Figure 4-1 Profile Management Page

Profile Management Page

Setup Overview

  1. First, create Profile Groups and their associated Elements. Follow the steps outlined in Profile Maintenance to set up and maintain the Profile Groups.

  2. Next, after creating the Profile Group and Element combinations, set up your Personalities and Landscapes.

    • A Personality is a grouping of at least one or many Profile Group and Element combinations in an ordered list that work together to define a store. For example, using the Profile Groups and Elements you set up previously (step 1 above), you can identify a personality as being Canadian, Banner, Outlet, in addition to another personality defined as US, Banner, Flagship, Retail, and so on.

    • A Landscape is a collection of prioritized profile groups and elements for register-specific configuration overrides. When assigned to a store, the landscape determines the configurations that are applicable to individual register numbers or ranges of register numbers (for example, "22-Managers Terminal", "44-Lead Register", and so on).

      Follow the steps outlined in Personality Maintenance and Landscape Maintenance to create Personalities and Landscapes.

  3. Finally, set up each Store Personality by assigning the Personalities and Landscapes you created (step 2 above) to your stores. Follow the steps outlined in Store Personality Maintenance to create Store Personalities.

Summary

  • The Profile Groups/Elements you create (step 1) will be used to set up Personalities and Landscapes.

  • The Personality/Landscape pairs (step 2) will then be used to create a Store Personality (step 3).

Profile Maintenance

This section describes the profile maintenance functionality.

Setting Up Profile Groups & Elements

The profiles you set up here will be available as configuration scope overrides for Personality and Landscape group types in the Configurator component, providing the ability to deploy configurations that will override the global layer for specific locations as defined by the Store Personality. Refer to Chapter 5, "Configurator" for more information about the Configurator component.

Profile Groups are used to associate configuration overrides with specific Profile Elements.

  • A Profile Group is simply a collection of configuration elements by type; for example Location, Register Type, Store Type, and so on.

  • A Profile Element is the child property associated with the Profile Group; for example, Location= Ohio, California, Iowa, and so on.

  1. From the Oracle Retail Xstore Office Cloud Service menu, select Configuration Manager, then Profile Management, or click the Profile Management link in the Configuration Manager panel.

  2. From the Profile Management page (Figure 4-1), select Profile Maintenance.

  3. The Profile Maintenance page displays. Click Add to create a new Profile Group.

    Figure 4-2 Profile Maintenance Page

    Profile Maintenance Page
  4. At the Create Profile Group window, enter the information required to create a new Profile Group:

    Figure 4-3 Create Profile Group Window

    Create Profile Group Window
    1. Group ID - The profile group identifier. Spaces are not allowed here.

    2. Group Type - The type of profile group: Personality or Landscape

      The Group Type selected here determines where the Profile Group will be available for selection when setting up Personalities and Landscapes. Landscape profile groups will only be available for Menu Configuration and System Configuration overrides.

    3. Description - The profile group description.

    4. Comments - [OPTIONAL] A comment associated with the Profile Group.

  5. Click OK.

  6. The Profile Maintenance window displays the new Profile Group information you added.

    Figure 4-4 Profile Maintenance Window - Populated

    Profile Maintenance Window populated
    • The red icon Not Saved icon in the tab header indicates this Profile Group has not been saved.

    • To close the tab, click the close icon. You will be prompted if there are un-saved changes.

    • To delete this Profile Group, click Delete. You will be prompted to confirm the deletion.

    • If a Profile Group (and its Elements) is being used by a Personality or Landscape, it cannot be deleted.

  7. Click Save to save the Profile Group to the Profile Group list, or continue with step 8 below before saving.

  8. Click Add in the Profile Elements section of the window to add elements to this Profile Group.

  9. At the Create Profile Element window, enter the information required to create a new Profile Element for the Profile Group:

    Figure 4-5 Create Profile Element Window

    Create Profile Element Window
    1. Element ID - The element identifier. (Note: Spaces are not allowed here.)

    2. Description - The element description.

    3. Comments - [OPTIONAL] A comment associated with the Profile Element.

  10. Click OK.

  11. Repeat steps 8 through 10 to add additional Elements to the Profile Group.

  12. When all Elements have been associated with the Profile Group, click Save.

    Figure 4-6 Profile Group and Elements - Before Saving Example

    Profile Group/Elements before saving

The Profile Group created here will now be available in the Overrides feature in the Personality Maintenance and Landscape Maintenance sections of Profile Maintenance where applicable for the group type. (See Figure 4-1)

Delete Options:

  • If you need to delete the Profile Group and all the associated Elements, click the Delete button.

  • If you need to delete an Element, click the Delete icon.

  • You will be prompted to confirm your selection.

  • If a Profile Group (and its Elements) is being used by a Personality or Landscape, it cannot be deleted.

Profile Group and Element Versioning

The version number is shown on the Profile Maintenance page for the Profile Group and Element. This value will be increased by one each time the Profile Group/ Element is deployed, or scheduled for deployment, with a new set of configurations.

About Profile Group and Element Versioning

  • The version number is not increased until the configuration is deployed (or scheduled for deployment). Editing an existing profile element does not increment the version number.

  • Rollback is not available at this time.

  • Audit logging includes who, when, and in which version the change was made.

  • See also Chapter 5, "Configurator".

Personality Maintenance

Use Personality Maintenance to group one or many Profile Group and Element combinations that will be used to define a store.

  1. From the Oracle Retail Xstore Office Cloud Service menu, select Config Manager - Profile Management, or click the Profile Management link in the Configuration Manager panel.

  2. From the Profile Management page (Figure 4-1), select Personality Maintenance.

  3. At the Personality Maintenance page, add a new Personality or edit an existing one:

    Figure 4-7 Personality Maintenance Page

    Personality Maintenance Page

    Note:

    To quickly find a Personality, enter text in the Description field. The list will be filtered to show the Personalities with the text in their descriptions.

    If adding a new Personality:

    1. Click Add New.

    2. At the Edit Personality page, use the wizard to complete the information on each tab, then click Next. See Personality Setup Options for a list of Personality options.

    3. Skip to step 4 to review your selections.

    If editing an existing Personality:

    1. Select the Personality in the list.

    2. At the Personality Detail window, click Edit.

    3. Complete the fields as required, then click Next. See Personality Setup Options for a list of Personality options.

    4. Continue with step 4 to review your selections.

  4. Review the Personality options you selected:

    Figure 4-8 Personality Options Review

    Personality Options Review
    • To save the Personality, click Save. The Personality is added to the list on the Personality Maintenance page.

    • To edit the Personality:

      • Click Previous to go back one page, or select a configuration option in the Edit Personality section in the left panel of the window.

      • After making your changes, click Save. The new Personality is added to the list on the Personality Maintenance page.

    • To discard the Personality, click Cancel. When prompted, click Yes to confirm you want to cancel Personality setup.

  5. After completing Personality setup, Oracle Retail Xstore Office Cloud Service returns to the Personality Maintenance page.

    • To delete a Personality that has been created or updated, click the Delete icon associated with the Personality on the Personality Maintenance page.

    • When prompted, click Yes to confirm the deletion.

    • If a Personality has been assigned to a Store, it cannot be deleted.

Personality Setup Options

This section describes the personality setup options.

General Information

Define the basic information for the Personality, then click Next.

  1. Description - Enter the Personality identifier.

  2. Comments - [OPTIONAL] Enter additional identifying information for the Personality.

Base Features

Select the Oracle Retail Xstore Point-of-Service features that are active for this Personality, then click Next.

Overrides

About the Profile Group and Element combinations:

  • The Profile Groups and Elements available here are created in Profile Maintenance. See Profile Maintenance for more information.

  • Only the Profile Groups with the type "Personality" are available in the drop-down list. (Profile Groups with the type "Landscape" are not available in Personality Maintenance.)

  • A <Store Specific> override entry is available by default in the drop-down list.

Select and prioritize the Profile Group and Element combinations:

  1. Select the Profile Group for this Personality.

  2. Select the Profile Element for this Personality.

  3. Click Add Element.

  4. Repeat steps a through c as needed to add all the Profile Group and Element combinations to this Personality.

  5. If needed, select a Profile Group and Element combination row and use the up/ down arrows to change the priority. Elements at the top of the list have higher priority.

  6. If needed, click the icon to remove the Profile Group and Element combination from the Personality.

  7. Click Next.

Review

Review the options you selected. Go to step 4 on page 7.

Landscape Maintenance

Use Landscape Maintenance to create and edit the register layout portion of configuration paths.

  1. From the Oracle Retail Xstore Office Cloud Service menu, select Config Manager - Profile Management, or click the Profile Management link in the Configuration Manager panel.

  2. From the Profile Management page (Figure 4-1), select Landscape Maintenance.

  3. At the Landscape Maintenance page, add a new Landscape or edit an existing one.

    Figure 4-9 Landscape Maintenance Page

    Landscape Maintenance Page

Adding a New Landscape

  1. At the Landscape Maintenance page, click Add New.

  2. At the Edit Landscape page, complete the following information:

    Figure 4-10 Edit Landscape Page - Add New

    Edit Landscape Page - Add New
    1. Description - Enter a short description for the new Landscape.

    2. Comments - [OPTIONAL] Enter additional information about the new Landscape.

  3. Select a Profile Group from the drop-down list, then click Add New to add the Profile Group to the Landscape.


    Note:

    The Profile Groups and Elements available here are created in Profile Maintenance. See Profile Maintenance for more information. Only the Profile Groups with the type Landscape are available in the drop-down list. Profile Groups with the type Personality are not available in Landscape Maintenance.

  4. At the Profile Group page, click Add New to add a Profile Element to the Profile Group.

    Figure 4-11 Profile Group Page - Register Types Example

    Profile Group Page - Register Types
  5. At the Add Register Range window, complete the fields, then click OK.

    Figure 4-12 Add Register Range Window

    Add Register Range window
    1. Profile Element - Select a Profile Element from the drop-down list.

    2. Register Range - Enter a starting and ending register range. If there is only one register, enter the register number in both fields.

  6. Repeat steps 4 and 5 as needed to add all the Profile Elements and Register Ranges for the Profile Group.

  7. Click Done to return to the Edit Landscape page.

  8. You have the following options at the Edit Landscape page before saving the Landscape:

    Figure 4-13 Edit Landscape Page

    Edit Landscape Page
    • To add additional Profile Groups and Elements to the Landscape, repeat steps 3 through 7.

    • To edit the register ranges, select the row to open the Add Register Range window and make changes as needed.

    • To change the priority, click the Selector Control icon Selector Control icon to select the row and activate the up and down arrows on the right side of the page.

      With the row selected, use the up/down arrows to move the row up or down in the list. Profile Groups at the top of the list have higher priority.

    • To delete a register range, select the row and click the Delete icon.

  9. When Landscape setup is complete, click Save to return to the Landscape Maintenance page.

Editing an Existing Landscape

  1. At the Landscape Maintenance page, select the Landscape in the list.

    • To delete a Landscape, click the Delete icon.

    • When prompted, click Yes to confirm the deletion.

    • If a Landscape has been assigned to a Store, it cannot be deleted.

  2. At the Edit Landscape page, edit the Landscape as needed:

    Figure 4-14 Edit Landscape Page

    Edit Landscape Page
    • To change the Description or Comment, enter the information in the appropriate field.

    • To add a new profile group perform step 3 on page 8 through step 7 on page 10.

    • To edit the register ranges, select the row to open the Add Register Range window and make changes as needed.

    • To change the priority, click the Selector Control icon Selector Control icon to select the row and activate the up and down arrows.

      With the row selected, use the arrows to move the row up or down in the list. Profile Groups at the top of the list have higher priority.

  3. Click Save when the edits are complete to return to the Landscape Maintenance page.

Store Personality Maintenance

Store Personalities are used to create the configuration paths specified in configPath.properties.

Store Personality Maintenance is where you assign the Personalities (created in Personality Maintenance) and Landscapes (created in Landscape Maintenance) to stores.

  1. From the Oracle Retail Xstore Office Cloud Service menu, select Config Manager - Profile Management, or click the Profile Management link in the Configuration Manager panel.

  2. From the Profile Management page (Figure 4-1), select Store Personality Maintenance.

  3. [OPTIONAL] At the Store Personality Maintenance page, use the Filter Criteria and Find a Node search options to quickly find a store:

    Figure 4-15 Store Personality Maintenance Page

    Store Personality Maintenance Page

    To quickly find a store you can:

    • Select an option from the Filter Criteria drop-down list to filter the nodes displayed in the org hierarchy tree based on assigned personalities and landscapes. The following filter options are available:

      • No Filter (default): Select this option to remove any filters.

      • No Store Personality - Select this option to display only the stores that do not have store personalities assigned to them.

      • Personalities or Landscapes: All the personalities created on the Personalities Maintenance page are listed under the heading Personalities, and all the landscapes created on the Landscapes Maintenance page are listed under the heading Landscapes. Select a personality or landscape to display only the stores that have the selected personality or landscape assigned to them.

      <OR>

    • In the Find a Node field, begin typing the node description to search for a specific node in the org hierarchy tree.

  4. From the hierarchy tree, select a node to assign a Personality/Landscape pair.

    Figure 4-16 Store Personality Maintenance Page - Store Node Selected

    Store Personality Maintenance - Store Node Selected

    Note:

    If you select a non-store node (for example District), all stores contained in that node will be affected by any change made to the personality and landscape. This will remove and replace any personality/landscapes that were previously assigned to stores within that node.

  5. Click Edit to modify the personality/landscape assignments for the selected store.

  6. At the Edit Store Personality window, select a Personality and a Landscape from the drop-down lists. Both a Personality and a Landscape are required.

    Figure 4-17 Edit Sore Personality Window

    Edit Store Personality window
  7. Click Save to assign the selected Personality and Landscape to the store.

    Figure 4-18 Store Personality Maintenance Page - Assignment Complete

    Store Personality - Personality Landscape Assigned

    See also Appendix B, "Appendix: Personality Maintenance and Config Paths".