SX Content Management

Concepts

Content packs are extension points to Service Exchange (SX). In collaboration with adapters, content packs enable SX to communicate with end-point systems. A content pack is a ZIP or JAR file that can contain operation definitions, Free Marker templates, Operation Orchestration (OO) flows, or other configuration files. Content packs contain the order message lifecycle modeled in OO flows in request-to-fulfill (R2F) use cases. Content packs can be installed or uninstalled.

Tip Refer to the Propel Service Exchange SDK for more information on Content Management.

The Service Manager Service Portal Administrator uses the Content Management application to view, download, upload, and delete Service Manager Service Portal content packs. Upload and delete operations include upload or removal of relevant OO JAR files (OO content packs), and the merging of SX customizations into Service Manager Service Portal.

Content Pack Structure

Though the structure of content packs differs, the following folders and files are typical:

  • oo - folder containing the OO content packs of custom OO flows
  • sx - folder containing SX-specific configuration files
  • template- folder containing Free Marker templates
  • operations.json - file containing SX operation definitions
  • flows.json - file containing the mapping of adapter and message type to OO flow
  • metadata.json - the content pack description file

Examples with different content pack structures:

  • SM content packs contain an sm folder for the customization SM unload files.
  • Ticketing content packs do not contain OO flows OO content packs), so the oo folder and flows.json file are not present.

Tasks

The Service Manager Service Portal Administrator can perform the following tasks from the Content Management application:

View Content Packs

To view Service Manager Service Portal content packs:

  1. From the Launchpad, click the Content Management application.

The list of Service Manager Service Portal content packs is displayed in the Content Pack List.

See Content Pack Details for detailed information about a content pack.

Download Content Pack

To download a content pack:

  1. From the Launchpad, click the Content Management application. The list of content packs is displayed in the Content Pack List.
  2. For the content pack to download, click and select Download.
  3. In the download dialog, save the content pack file.

The Service Manager Service Portal content pack is downloaded to your file system.

Upload Content Pack

To upload a content pack:

  1. From the Launchpad, click the Content Management application. The list of Service Manager Service Portal content packs is displayed in the Content Pack List.
  2. Click Upload New Content Pack.
  3. In the File Upload dialog, locate and select the .zip or .jar file to be uploaded.
  4. Click Open.

When the upload is complete, a confirmation appears near the top of the Content Management view. The upload time for the content pack is updated.

Note When uploading a content pack that was previously loaded, SX replaces the existing version. Content packs are identified by an ID attribute provided in their metadata file.

Delete Content Pack

To delete a content pack:

  1. From the Launchpad, click the Content Management application. The list of Service Manager Service Portal content packs is displayed in the Content Pack List.
  2. For the content pack to delete, click and select Delete.
  3. In the confirmation dialog, confirm deleting the content pack.

The Service Manager Service Portal content pack is deleted.

 

Related Topics

Content Pack Details