Manage Products

About Products

Products consist of application artifacts like templates, cases, dashboards, and assets, and extended or customized APM content that product designers create for subscribed tenants whose business needs require extension.

The parts of a product that can be customized by the product designer include:

  • Profiles
  • Navigation menu
  • Asset context browser

Product Creation Workflow

Product creation involves a combination of roles, tasks, and tools.

The product creation workflow includes the following high-level steps:
  1. The product designer creates and customizes a product, publishes it, and marks the product as a release version in the Extensibility Tool. This initiates an export of the product artifacts.
  2. The subscribed tenant administrator, or a user with upgrade permissions, upgrades product versions for the tenant in the Administration tool. This initiates an import of the product artifacts.
  3. The subscribed tenant user can view the new version of extended APM.
A more detailed product creation workflow is shown in the following diagram:


Create and Publish a New Product

As a product designer, you can create and publish a new product for a subscribed tenant.

About This Task

When you initially create a product, you assign a name to the product. After you publish the product, the name appears above the version table and a new product version appears.

Procedure

  1. In the left navigation menu, select Extensibility Tool.
    The Extensibility Tool page appears, and a blank product name field is in focus.
  2. Enter a unique name for your product.
    Note: You cannot modify the name of the product after you have published it, so verify that the product name is accurate.
  3. Optional: Create profiles.
  4. Optional: Modify navigation settings.
  5. Optional: Configure the context browser.
  6. Select Publish.
    When the status is Completed, a version number is assigned, and product artifacts are exported.
    Note: If the export of artifacts fails, a notification appears.

Create a New Version of an Existing Product

As a product designer, you can publish a product to create new version of the product.

About This Task

When you access a product, the current product versions are displayed. You can then modify or create new settings and publish the product to create a new version. All the modified profile, navigation, and context browser settings are published and replace any settings in the previous version of the product. New versions of the associated product artifacts are also exported. You create a new version of the product when you publish it.
Important: If a product version is In Progress, you cannot publish a new version until the status is Completed.

Procedure

  1. In the left navigation menu, select Extensibility Tool.
    The Extensibility Tool page appears and all settings from the current version are displayed.
  2. Optional: Create profiles.
  3. Optional: Modify navigation settings.
  4. Optional: Choose the context browser.
  5. Select Publish.

Results

When the status is Completed, the product you created appears in the version table and is assigned a version number and a timestamp. The profile set as the default at the time of publishing is exported as the profile associated with the product version.

Tag a Product Version as a Release Version

As a product designer, you can tag a product version as a release version.

About This Task

After a product version is tagged as a release version, the tenant administrator, or a user with upgrade permissions, can then upgrade to the new release version using the Administration tool. The tenant administrator can also view or change profiles associated with the product version.

Procedure

  1. In the left navigation menu, select Extensibility Tool.
    The Extensibility Tool page appears.
  2. In the product version table, select the tag icon () to specify a version as the release version.
    A message appears, asking you to confirm that you want to tag the version.
    Note: You can only tag a version as a release version if the status is Completed.
  3. Select Accept.
    A message appears and confirms that tag was successful. A check mark appears in the Release Version column.

Results

The product version number is now available for updates by the subscribed tenant administrator or a user with upgrade permissions. Profiles associated with the product version are available for selection.