2 Prerequisites

The following prerequisites are required for access to FTS services:

  1. Access to a Unix or Linux Server.

  2. Install jq on the Unix/Linux Server.

    This is a JSON query tool.

  3. Retrieve the Client ID and Client Secret generated with the creation of a OAuth Client Application. For more information, review the Oauth2.0 for Merchandising Rest Services video.

    When creating the OAuth Client Application, ensure that the OCI IAM scope follows the pattern below:

    • The scope pattern that is used in the MFCS OCI IAM application creation template is rgbu:merch:<SERVICETYPE>-<ENVIRONMENT>  where:

      • <SERVICETYPE> is MFCS

      • <ENVIRONMENT> is the environment type (STG, PRD, UAT, DEV1, DEV2, and so on).

      For example:

      "scope": "rgbu:merch:MFCS-PRD"
      "scope": "rgbu:merch:MFCS-STG"  
  4. Retrieve the OCI IAM Scope generated with the creation of the OAuth Client Application.  Refer to scope in Prerequisite 3.

  5. Retrieve the OCI IAM base URL from the Welcome Email.

  6. Retrieve the Region and Customer Subnamespace from the Merchandising application URL.  The format for the hostname is rex.retail.<Region Name>.ocs.oraclecloud.com/<Customer Subnamespace>/, where 

    • <Region Name> is the region for your data center

    • <Customer Subnamespace> is specific to your company’s name and environment (production, stage, and so on)

    For example, in the Merchandising Application URL - https://rex.retail.us-phoenix-1.ocs.oc-test.com/rgbu-rex-rgbu-stg116-mfcs/Rms/faces/RmsHome

    • The Region is us-phoenix-1

    • The Customer Subnamespace is rgbu-rex-rgbu-stg116-mfcs