immersion

Immersion

Immersion is a command-line (CLI) tool built for the Content Direct product catalog system.

Node.js is required in order to run Immersion. Please ensure you have Node.js installed: http://nodejs.org/.

Immersion helps in ingesting categories, media, people, playlists, and products by pulling data from a CSV file.

Installation

1. Ensure you have Node.js installed: http://nodejs.org/.
2. Globally install the immersion package using npm: npm install -g immersion

Running immersion -h will display the help menu which indicates a successful install.

CSV Format

The CSV file that is ingested should have a header row followed by the rows of entity (i.e. Category, Media, Person, Playlist, Product) information. Each row below the header is equivalent to one entity that will be created or updated.

Each column in the header should map to an object in the specified request. For example, when creating products the headers should follow the CreateProduct request format:

Product.Id.Type,Product.Id.Value,Product.Name,Product.References[0].Type,Product.References[0].Value

Objects are referenced using dot notation while arrays use brackets.

{Entity}.Id.Value is required.

Core Documentation

Use your sandbox credentials to view the core request formats: https://documentation.doc1.cdops.net/v5.7/Interface.aspx?interface=Catalog.

Logging

A logs folder is created in the current working directory when immersion is run. Sub-folders are created for each entity id. The sub-folders will contain a request.json file and a response.json file for every create or update API call.

Examples

immersion -f examples/person.csv create Person

Creates person objects in sandbox.

immersion -e stg1 -f examples/media.csv create Media

Creates media objects in staging.

immersion -f examples/product.csv update Product

Updates product objects in sandbox.

License

ISC???