JSPM

  • Created
  • Published
  • 0
  • Score
    100M100P100Q53579F
  • License ISC

content direct product catalog command line tool

Package Exports

  • immersion

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (immersion) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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.

The entity rows can contain either primitive values (i.e. boolean, number, string) or valid JSON.

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 directory of the file provided when immersion is run. A sub-folder is created for the core API method used for the requests. Sub-sub-folders are created for each entity id. The sub-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 update Media

Updates media objects in staging.

immersion -f examples/product.csv -t update Product

Updates product objects in sandbox using targetted method.

License

ISC???