Go to primary content
Oracle® Retail Xstore Office Cloud Service Administration Guide
Release 18.0
F13698-02
  Go To Table Of Contents
Contents

Previous
Previous
 
Next
Next
 

2 Setup Xstore Office Cloud Service

This chapter describes how to set up Xstore Office Cloud Service.

Data Seeding

This section deals with data seeding.

Organization Hierarchy and Stores

In order to use Xstore Office Cloud Service, it will need stores and organization hierarchy as one of the first sets of data loaded into it. The provisioning process should have set up the merchant's organization IDs. Further creation of the hierarchy can be done via the UI. See the Oracle Retail Xstore Office/Xstore Office Cloud Service User Guide on more information about managing the organization hierarchy.

Stores can be created by following the instructions about stores in the user guide. However, before creating stores, Tax Locations will have to be loaded via a data load file, like in the example below.

<Header line_count="13" download_id="123" application_date="2018-11-06" />
INSERT~XML_PERSISTABLES~<ConfigData><dao name="TaxLocation" cmd="INSERT_OR_UPDATE|UPDATE"><fld id="OrganizationId" val="10"/><fld id="TaxLocationId" val="TL-1000"/><fld id="CreateDate" val="1525803068534"/><fld id="CreateUserId" val="XADMIN"/><fld id="UpdateDate" val="1541542977883"/><fld id="UpdateUserId" val="XADMIN"/><fld id="OrgCode" val="*"/><fld id="OrgValue" val="*"/><fld id="Description" val="Ohio Tax Location"/><fld id="Name" val="Ohio Tax Location"/><originDS>Local</originDS></dao></ConfigData>
INSERT~XML_PERSISTABLES~<ConfigData><dao name="TaxLocation" cmd="INSERT_OR_UPDATE|UPDATE"><fld id="OrganizationId" val="10"/><fld id="TaxLocationId" val="TL-2000"/><fld id="CreateDate" val="1525803068538"/><fld id="CreateUserId" val="XADMIN"/><fld id="UpdateDate" val="1541542977883"/><fld id="UpdateUserId" val="XADMIN"/><fld id="OrgCode" val="*"/><fld id="OrgValue" val="*"/><fld id="Description" val="Illinois Tax Location"/><fld id="Name" val="Illinois Tax Location"/><originDS>Local</originDS></dao></ConfigData>
INSERT~XML_PERSISTABLES~<ConfigData><dao name="TaxLocation" cmd="INSERT_OR_UPDATE|UPDATE"><fld id="OrganizationId" val="10"/><fld id="TaxLocationId" val="TL-AT"/><fld id="CreateDate" val="1525803068540"/><fld id="CreateUserId" val="XADMIN"/><fld id="UpdateDate" val="1541542977883"/><fld id="UpdateUserId" val="XADMIN"/><fld id="OrgCode" val="*"/><fld id="OrgValue" val="*"/><fld id="Description" val="AT Tax Location"/><fld id="Name" val="AT Tax Location"/><originDS>Local</originDS></dao></ConfigData>
INSERT~XML_PERSISTABLES~<ConfigData><dao name="TaxLocation" cmd="INSERT_OR_UPDATE|UPDATE"><fld id="OrganizationId" val="10"/><fld id="TaxLocationId" val="TL-BR_SP"/><fld id="CreateDate" val="1525803068559"/><fld id="CreateUserId" val="XADMIN"/><fld id="UpdateDate" val="1541542977883"/><fld id="UpdateUserId" val="XADMIN"/><fld id="OrgCode" val="*"/><fld id="OrgValue" val="*"/><fld id="Description" val="Brazil State - SAO PAULO"/><fld id="Name" val="Brazil State - SAO PAULO"/><originDS>Local</originDS></dao></ConfigData>
INSERT~XML_PERSISTABLES~<ConfigData><dao name="TaxLocation" cmd="INSERT_OR_UPDATE|UPDATE"><fld id="OrganizationId" val="10"/><fld id="TaxLocationId" val="TL-DE"/><fld id="CreateDate" val="1525803068542"/><fld id="CreateUserId" val="XADMIN"/><fld id="UpdateDate" val="1541542977883"/><fld id="UpdateUserId" val="XADMIN"/><fld id="OrgCode" val="*"/><fld id="OrgValue" val="*"/><fld id="Description" val="DE Tax Location"/><fld id="Name" val="DE Tax Location"/><originDS>Local</originDS></dao></ConfigData>
INSERT~XML_PERSISTABLES~<ConfigData><dao name="TaxLocation" cmd="INSERT_OR_UPDATE|UPDATE"><fld id="OrganizationId" val="10"/><fld id="TaxLocationId" val="TL-ES"/><fld id="CreateDate" val="1525803068543"/><fld id="CreateUserId" val="XADMIN"/><fld id="UpdateDate" val="1541542977883"/><fld id="UpdateUserId" val="XADMIN"/><fld id="OrgCode" val="*"/><fld id="OrgValue" val="*"/><fld id="Description" val="ES Tax Location"/><fld id="Name" val="ES Tax Location"/><originDS>Local</originDS></dao></ConfigData>
INSERT~XML_PERSISTABLES~<ConfigData><dao name="TaxLocation" cmd="INSERT_OR_UPDATE|UPDATE"><fld id="OrganizationId" val="10"/><fld id="TaxLocationId" val="TL-FR"/><fld id="CreateDate" val="1525803068545"/><fld id="CreateUserId" val="XADMIN"/><fld id="UpdateDate" val="1541542977883"/><fld id="UpdateUserId" val="XADMIN"/><fld id="OrgCode" val="*"/><fld id="OrgValue" val="*"/><fld id="Description" val="FR Tax Location"/><fld id="Name" val="FR Tax Location"/><originDS>Local</originDS></dao></ConfigData>
INSERT~XML_PERSISTABLES~<ConfigData><dao name="TaxLocation" cmd="INSERT_OR_UPDATE|UPDATE"><fld id="OrganizationId" val="10"/><fld id="TaxLocationId" val="TL-GB"/><fld id="CreateDate" val="1525803068547"/><fld id="CreateUserId" val="XADMIN"/><fld id="UpdateDate" val="1541542977883"/><fld id="UpdateUserId" val="XADMIN"/><fld id="OrgCode" val="*"/><fld id="OrgValue" val="*"/><fld id="Description" val="GB Tax Location"/><fld id="Name" val="GB Tax Location"/><originDS>Local</originDS></dao></ConfigData>
INSERT~XML_PERSISTABLES~<ConfigData><dao name="TaxLocation" cmd="INSERT_OR_UPDATE|UPDATE"><fld id="OrganizationId" val="10"/><fld id="TaxLocationId" val="TL-IT"/><fld id="CreateDate" val="1525803068549"/><fld id="CreateUserId" val="XADMIN"/><fld id="UpdateDate" val="1541542977883"/><fld id="UpdateUserId" val="XADMIN"/><fld id="OrgCode" val="*"/><fld id="OrgValue" val="*"/><fld id="Description" val="IT Tax Location"/><fld id="Name" val="IT Tax Location"/><originDS>Local</originDS></dao></ConfigData>
INSERT~XML_PERSISTABLES~<ConfigData><dao name="TaxLocation" cmd="INSERT_OR_UPDATE|UPDATE"><fld id="OrganizationId" val="10"/><fld id="TaxLocationId" val="TL-MX"/><fld id="CreateDate" val="1525803068555"/><fld id="CreateUserId" val="XADMIN"/><fld id="UpdateDate" val="1541542977883"/><fld id="UpdateUserId" val="XADMIN"/><fld id="OrgCode" val="*"/><fld id="OrgValue" val="*"/><fld id="Description" val="MX Tax Location"/><fld id="Name" val="MX Tax Location"/><originDS>Local</originDS></dao></ConfigData>
INSERT~XML_PERSISTABLES~<ConfigData><dao name="TaxLocation" cmd="INSERT_OR_UPDATE|UPDATE"><fld id="OrganizationId" val="10"/><fld id="TaxLocationId" val="TL-NL"/><fld id="CreateDate" val="1525803068551"/><fld id="CreateUserId" val="XADMIN"/><fld id="UpdateDate" val="1541542977883"/><fld id="UpdateUserId" val="XADMIN"/><fld id="OrgCode" val="*"/><fld id="OrgValue" val="*"/><fld id="Description" val="NL Tax Location"/><fld id="Name" val="NL Tax Location"/><originDS>Local</originDS></dao></ConfigData>
INSERT~XML_PERSISTABLES~<ConfigData><dao name="TaxLocation" cmd="INSERT_OR_UPDATE|UPDATE"><fld id="OrganizationId" val="10"/><fld id="TaxLocationId" val="TL-PT"/><fld id="CreateDate" val="1525803068553"/><fld id="CreateUserId" val="XADMIN"/><fld id="UpdateDate" val="1541542977883"/><fld id="UpdateUserId" val="XADMIN"/><fld id="OrgCode" val="*"/><fld id="OrgValue" val="*"/><fld id="Description" val="PT Tax Location"/><fld id="Name" val="PT Tax Location"/><originDS>Local</originDS></dao></ConfigData>
INSERT~XML_PERSISTABLES~<ConfigData><dao name="TaxLocation" cmd="INSERT_OR_UPDATE|UPDATE"><fld id="OrganizationId" val="10"/><fld id="TaxLocationId" val="TL-SE"/><fld id="CreateDate" val="1525803068557"/><fld id="CreateUserId" val="XADMIN"/><fld id="UpdateDate" val="1541542977883"/><fld id="UpdateUserId" val="XADMIN"/><fld id="OrgCode" val="*"/><fld id="OrgValue" val="*"/><fld id="Description" val="SE Tax Location"/><fld id="Name" val="SE Tax Location"/><originDS>Local</originDS></dao></ConfigData>

See the Data Loading section, for information about loading data via files.

Data Loading

Data can be uploaded and deployed to the Xcenter database (and stores) through the Xadmin UI. Follow the Oracle Retail Xstore Office/Xstore Office Cloud Service User Guide, section Deployment Manager.

Data can be deployed to the Xcenter database (and stores) by using the REST web service to put a file in the "autodeploy" directory. Review the details of the service in the Services Guide from the online documentation. For more info about the "autodeploy" feature, see the Oracle Retail Xstore Office/Xstore Office Cloud Service User Guide on how to Automatically Deploy Data Manager Changes and Data Manager Automatic Deployment Time.

Call this service via REST like PUT: https://CLOUDHOST:443/xcenter/rest/MyMerchCode/v1/file/autodeploy/1000/mydatafile.mnt

Integrations

If integrations to third-party applications or Oracle Retail Merchandise Operations Management (MOM) have been set up, data will be loaded through these integrations. See the Oracle Retail Merchandising Operations Management (MOM) section for a link to that integration guide.

Users Setup

A Customer Administration User will be created as part of the Xstore Office Cloud Service provisioning process. Before end users can access the Xstore Office Cloud Service application it is necessary to create and provision users. This includes provisioning access to the system, assigning organizations, a role and org nodes to each user to control what functionality will be available to them.

Users can be created via the Xadmin User Management UI or the Identity Cloud Service (IDCS) UI. Refer to the Oracle Cloud Administering Oracle Identity Cloud Service Guide on the steps how to create users via the Identity Cloud Service (IDCS) UI. Refer to the Oracle Retail Xstore Office/Xstore Office Cloud Service User Guide on steps how to create and provision users via the Xadmin User Management UI.

Setup Xstore Registers for Xstore Office Cloud Service

Any Xstore register that communicates with Xstore Office Cloud Service must first be enrolled in IDCS via Xstore Office Cloud Service. This can be done either via Xadmin or Xenvironment. Refer to the Oracle Retail Xstore Office Cloud Service Security Guide about the steps to be followed for Cloud Enrollment of Xstore Clients.