Custom Asset Fields (Standard ABO)

Overview

Administrators can extend the asset table by adding custom asset fields that suit their company's business needs.

In Oracle CPQ, the available count of Custom Asset Fields is 600. This field count includes:

ClosedAsset Fields

By clicking Assets on the Admin Home page, administrators can view custom asset fields.

This page contains a list of the custom asset fields and the count of available fields.

  • The remaining Available Fields count is displayed at the top of the page.
  • Asset fields displayed in red indicate an un-deployed fields After successful deployment, the fields are no longer displayed in red.
  • Administrators can check the Delete checkbox to select one or more custom asset fields to delete.
  • Administrators can click Add to create new custom asset fields.

Customer Asset Fields

Administrators can select a link in the Field Name column to open the corresponding field editor and modify the associated field properties.


Administration

ClosedAdd Custom Asset Fields

Complete the following steps to add a custom asset field.

  1. Navigate to the Admin Home page.
  2. Click Assets in the Products section.
  3. Click Add.

  4. Enter the Field Name and Variable Name.

    A "_c" suffix will be appended to the variable name.

    String Field Editor

  5. Select the desired Data Type.

  6. Click Add.

    After you click Add, String, Integer, and Date field types are automatically added to the Asset Defined Fields list.

  7. For Single Select Menu or Float field types, complete the applicable steps below:

    ClosedSingle Select Menu

    1. Enter the Menu Entry Displayed Text and Variable Name, and then click Add Entry.

      • Repeat this step for all desired menu options.
      • To Change the Order of menu entries, select a menu entry and use the up and down arrows to move the selected entry.
      • To Delete a menu entry, select the menu entry, and then click Delete.
    2. Click Add.

    Single Select Menu Field Edtor


    ClosedFloat

    1. Check the Currency box currency type fields.

      Currency fields are displayed as floating point number fields that will display the number in currency format. The currency displayed is the user's currency.

    2. Select the Precision value (the number of decimal places that will be accepted in the asset field).
    3. Click Add.

    Float Field Editor


ClosedDelete Custom Asset Fields

Note: Administrators cannot delete custom asset fields that are referenced in a UI Designer layout. If administrators attempt to delete a deployed custom asset field used in a layout, an error message will display. Administrators cannot delete the field until after the custom asset attribute is removed from the UI layout.

Complete the following steps to delete a custom asset field:

  1. Navigate to the Admin Home page.
  2. Under Products, click Assets.
  3. Under Asset Defined Fields, select the custom asset fields you want to delete.
  4. Click Delete.

    The custom asset field no longer displays in the Asset Defined Fields section.


ClosedDeploy Custom Asset Fields

By deploying one or more custom asset fields, administrators are adding the fields to the list of UI Designer attributes. Administrators can then use UI Designer to add deployed, re-deployed, and updated custom asset fields to the ABO Workbench layout.

Notes:

  • After the successful deployment of a custom asset field, the field no longer displays in red under Asset Defined Fields.
  • Deployed custom asset fields are available for asset REST services.
  • The following deployed custom asset field types are available in the ABO Workbench layout: String, Single Select Menu, Float, Integer, and Date.

Complete the following steps:

  1. Navigate to the Admin Home page.
  2. Under Products, click Assets.

    Under the Asset Defined Fields section, all newly created or modified custom asset fields display in red.

    Note: Administrators do not need to select the custom fields to deploy. Upon clicking Deploy, all custom fields displayed in red are deployed.

  1. Click Deploy.

    The deployed custom asset fields remain in the Asset Defined Fields section, but no longer display in red.


ClosedMap Custom Asset Attribute to Transaction Attribute

The Oracle CPQ Commerce Standard Process allows you to map custom asset attributes to transaction attributes. Oracle CPQ provides a user-friendly asset management mapping interface for creating mappings, editing existing mappings, deleting a mapping, and previewing the asset mapping.

The following asset mappings are supported in Oracle CPQ 25D:

  • Update Asset maps the attributes from the Transaction to the asset when the transaction is fulfilled and the asset is created.

  • Load From Asset maps the attributes from the asset to the transaction when the asset is modified.

Complete the following steps to add new asset attribute mappings:

  1. Navigate to the Admin Home page.
  2. Click Process Definition from the Commerce section.
  3. Click Standard Quote Process under the Name column.
  4. Click the Asset Management tab.

  5. Click Edit next to Update Asset Mapping. The Attribute Mapping for Update Asset page opens.

    Update Asset Mapping

  6. Click the Add Row icon or drag and drop an attribute to create a new attribute mapping row.

    1. Select the appropriate CPQ attribute on the left side.

    2. Select the appropriate Asset attribute on the right side.

    3. Click on the Apply icon or click outside the row to register the mapping.

    4. Click Finish to return to the Asset Management tab.

  7. Click Edit next to Load From Asset Mapping. The Attribute Mapping for Load From Asset Mapping page opens.

    Load from Asset Mapping

  8. Click the Add Row icon or drag and drop an attribute to create a new attribute mapping row.

    1. Select the appropriate CPQ attribute on the left side.

    2. Select the appropriate Asset attribute on the right side.

    3. Click on the Apply icon or click outside the row to register the mapping.

    4. Click Finish to return to the Asset Management tab.

  9. (Optional) If you would like to preview the asset mapping, enter the Transaction ID then click the Preview link to preview the associated mapping.

  10. Click Apply or Update to save the asset mapping.


NOTES

There is not a strict limit on number of assets within Oracle CPQ, but there are performance, backup, and administration considerations to evaluate for large data sets.

Related Topics

Related Topics Link Icon<MadCap:conditionalText MadCap:conditions="Default.ScreenOnly">Related Topics</MadCap:conditionalText>