The Retail Home Seed Utility

The Retail Home Seed Utility is a standalone Java utility that populates the application list and dashboards of a Retail Home deployment. It takes a wallet containing admin credentials for Retail Home, a JSON template of application URL patterns, and a CSV of applications to load and populate. The JSON and a template of the CSV file are provided in an accompanying ZIP file.

Wallet Credentials

The wallet for the seed utility is a standard Oracle Wallet containing the credential map oracle.retail.apps.platform.services.common.model.security with two keys:

• idcsOAuthClient - application client ID and secret for IDCS or OCI IAM

• idcsOAuthUser - Retail Home administrator username and password

Application CSV

The CSV file containing application information has two columns. The first column is the application code of the Retail application, which must correspond to an entry in the template JSON. The second column is the application host (the domain and port) of the external URL for the application.

Template JSON

There should be no need to modify the provided template JSON, which maps application codes to the format for the full application URL and the platform service URL (the application host value is substituted in for <app.host>).

Calling the Seed Utility

The seed utility is invoked as follows:

java -jar RetailHomeSeedUtil.jar <Retail Home Host> <IDCS or OCI IAM URL> <Wallet> <Application File> <Template File>

The Retail Home host is the protocol, domain, and port of the URL to Retail Home. The IDCS or OCI IAM URL is the same to the IDCS or OCI IAM tenant. The remaining fields are the paths (relative or absolute) to the files needed to run the utility.

When running, the utility may report that it was unable to retrieve seed data for one or more applications. This is normal behavior and means that the installed version of the application in question does not provide seed data.