D Appendix: Enrollment with Cloud Services

This chapter describes how to enroll Xstore Office On-Premise with other Retail Cloud Services and how to enroll Xstore Stores in Xstore Office Cloud Service through the Xstore Office UI (On-Premise).

Note:

For more information about how to configure web service authentication for the Retail Omnichannel products, like Order Management System Cloud Service, Order Broker Cloud Service and Customer Engagement Cloud Services, see the Oracle Retail Omnichannel Web Service Authentication Configuration Guide (Doc ID 2728265.1) on My Oracle Support.

Enrolling Xstore Office On-Premise with Retail Cloud Services

This section describes how to enroll Xstore Office On-Premise with other Retail Cloud Services.

Configuring Xstore Office On-Premise with IDCS

To configure Xstore Office On-Premise with IDCS follow the steps listed below:

Add the following entries to the xcenter.properties file:
- Add :idcs to the config path global extensions.
- Configure the idp.connectionURL.
- Add :idcs/relate to the config path base features to broadcast poslog data to Customer Enagement using IDCS.
- Add :idcs/locate to the config path base features to send item and inventory data to Order Broker using IDCS.
- For Order Broker configurations, cloud.http.locate.oauth2 needs to be set to true in the xcenter.properties file.

For Customer Engagement configurations, the relateAuthHandlerResolver bean needs to be commented out in the xcenter-spring-beans.xml file:

<!--
  <bean id="relateAuthHandlerResolver"
        class="com.micros_retail.xcenter.broadcast.relate.RelateAuthHandlerResolver">
    <property name="relateOrgCode" value="ORGCODE" />
    <property name="encryptedUsername" value="encryptedUsername" />
    <property name="encryptedPassword" value="encryptedPassword" />
  </bean>
-->

Then submit and store credentials which will allow Xstore Office On-Premise to communicate with Identity Cloud Service (IDCS).

Note:
These credentials need to be generated in another cloud application. The cloud application needs to grant access to Xstore Office On-Premise to complete the communication setup.
1. From the Oracle Retail Xstore Office menu, select System Management, and then select System Manager. From the System Manager menu, select Credentials Storage.
  
  Figure D-1 Credentials Storage
  
  For more information on how to submit and store credentials, see the Credentials Storage section in chapter System Management.

Configuring Xstore Registers for IDCS

To configure Xstore registers for IDCS follow the steps listed below:

Enroll one or all stores in an organization node with cloud services.
1. From the Oracle Retail Xstore Office menu, select System Management, then select Store Authorization Manager. From the Store Authorization Manager menu, select Store Authorization Manager. Select an organization node and press Next. The Store Enrollment Screen is displayed.
  
  Figure D-2 Store Enrollment Screen
2. Select Enroll to enroll the selected stores to communicate with Cloud Services. No connection details are required.
  
  For more detailed information on how to enroll stores with cloud services, see the Store Enrollment section in chapter System Management.
After the enrollment deployments have changed to status Complete, use the Personality Maintenance functionality to configure IDCS access for a service, for example Customer Engagement or Order Broker.
1. From the Oracle Retail Xstore Office menu, select Config Manager - Profile Management, or click the Profile Management link in the Configuration Manager panel. From the Profile Management page, select Personality Maintenance add a new personality.
2. At the Base Features tab, enable IDCS access for a service.
  
  Figure D-3 Personality Maintenance Screen - Base Features
For more detailed information on how to enable IDCS access for a service, see the Personality Maintenance section in chapter Configurator.
The Xservices must be manually configured with the correct configuration path to use IDCS for the various services. Add the following entries to the xservices.properties file:
- For IDCS Access to Customer Engagement add :idcs/relate to the config path base features.
- For IDCS Access to Order Broker add :idcs/locate to the config path base features.

Enrolling Xstore Stores in Xstore Office Cloud Service

Xstore Stores can be enrolled in Xstore Office Cloud Service trough the Xstore Office On-Premise UI.

Note:

Xstore Office Cloud Service is provisioned with IDCS and has a client ID/provisioning ID.

For more information on Xstore Office Cloud Service provisioning, see the Oracle Retail Xstore Office Cloud Service Security Guide and the Oracle Retail Xstore Office Cloud Service Administration Guide.

You need to grant access to the parent client ID in each integrating application before enrolling stores.

Enroll all stores in the organization node with an Xstore Office Cloud Service environment.
1. From the Oracle Retail Xstore Office menu, select System Management, then select Store Authorization Manager. From the Store Authorization Manager menu, select Store Authorization Manager. Select an organization node and press Next. The Store Enrollment Screen is displayed.
  
  Figure D-4 Store Enrollment Screen
2. Enter the connection details for the Xcenter cloud Xstore Office Cloud URL.
3. Then select Enroll with Xoffice Cloud to validate credentials and enroll the location(s). A deployment will be created for each location in the selected organization node to be applied during the next store close.
  
  At the next store close, all POS applications will be configured for Xstore Office Cloud service. All systems will be restarted.
  
  For more detailed information on how to enroll stores with an Xstore Office Cloud service environment, see the Store Enrollment in the System Management chapter.
After the enrollment deployments have changed to status Complete, use the Personality Maintenance functionality to configure IDCS access for a service, for example Customer Engagement or Order Broker.
1. From the Oracle Retail Xstore Office menu, select Config Manager - Profile Management, or click the Profile Management link in the Configuration Manager panel. From the Profile Management page, select Personality Maintenance add a new personality.
2. At the Base Features tab, enable IDCS access for a service.
  
  Figure D-5 Personality Maintenance Screen - Base Features
For more detailed information on how to enable IDCS access for a service, see the Personality Maintenance section in chapter Configurator.