Adding New Application Entity Fields

Adding new fields to the application entity requires additional setup in APM. Customize the entity by:

Adding a New Field to the APM - Application Entity

The APM - Application entity is a predefined request type and request header type. To add a field to the application entity, follow the instructions for configuring a request type and request header type fields in the Demand Management User’s Guide. Use Table 2-1. Location of editable fields to determine if you need to modify the request type or request header type.

Generating a Data Source

After you have customized the application entity (by adding, disabling, or removing fields), you must generate a new data source for this entity. Any time you update an entity's fields, you must generate or regenerate the data source. When you generate a new data source, you must create new portlet definitions that use this new data source.

  1. Rename the existing data source of the application entity for which you are generating a data source:

    Note: If you are generating a data source for the first time, you may skip this step (there is no existing data source to rename).

    1. Select Open > Administration > Open Workbench.

    2. From the shortcut bar, select Dashboard > Data Sources.

      The Data Source Workbench opens.

    3. Click List.

    4. Select the data source to rename and click Open.

    5. Update the Data Source Name and click OK.

  2. Go to http<s>://<Host>:<Port>/itg/web/knta/apm/entity/default.jsp.

    The Entity Query Tool page opens.

  3. From the Entity Query Tool page, enter the following information:

    Field

    Value Entered

    Entity

    The name of the entity for which you are generating the data source. For example, APM - Application. Or, use % to generate data sources for all entities.

    Type

    % (generates the data source for all types).

    Include Attributes

    Leave this field blank.

    Include Data

    Leave this field blank.

    Operation

    Select one of the following:

    • Generate Datasources. Generate a standard data source.

    • Generate Datasources (w/Filters). Generate a standard data source with filters. Filters are the preferences (filter fields) found on the edit page of a portlet.

    • Generate Datasources (w/Filters & Counts). Generate a standard data source with filters and counts. Filters are the preferences (filter fields) found on the edit page of a portlet. Counts allow you to show the quantity of entries in a multi-select field.

  4. Click Execute.

  5. A separate browser page opens and displays the results.

See Creating Portlets and Modules for more information about data sources.

Creating Portlet Definitions

After you generate the data source, you must create portlet definitions that use the data source (PPM-provided portlets do not use these new data sources and you cannot change an existing portlet's data source).

See Creating Portlets and Modulesfor more information about creating portlet definitions.