Working with Node Type Qualifiers

A node type qualifier is a prefix or suffix that you define for a node type which allows for unique node type naming. You define node type qualifiers for external applications that use unique naming for node types or dimensions. For example, an application may use these qualifiers for entities, accounts, and cost centers: ENT_, ACCT_, and CC_.

Qualifiers are used by Oracle Enterprise Data Management Cloud when you compare nodes, display viewpoints side by side, and drag and drop from one viewpoint to another.

For example, if you have a cost center named 750 in your general ledger application and you want to add it to your Planning application, you can drag and drop the cost center from the general ledger viewpoint to the Planning viewpoint. With the node type qualifier defined and a node type converter set up, the cost center in Planning will be added as CC_750.

Note:

When calculating node counts for licensing, two nodes are counted as equivalent if:
  • The two node types share a node type converter
  • The source and target nodes have the same base name after the qualifier is removed (default or alternate qualifier, prefix or suffix)

See Viewing the Record Count.

Default and Alternate Qualifiers

Node types support a default qualifier as well as up to three alternate qualifiers, which are used when the node can't be found using the default qualifier. All default and alternate qualifiers for a given node type must be either a prefix or a suffix. You cannot mix prefixes and suffixes as qualifiers in a single node type.

Note:

You must have a default qualifier defined in order to specify alternate qualifiers. Deleting the default qualifier will also delete the alternate qualifiers.

When comparing, locating, and adding or inserting nodes across node types (using a node type converter), default and alternate qualifiers are handled as follows:

  • When comparing, locating, and aligning nodes:
    • If the source node name begins with the default qualifier, remove the qualifier and use the result as the base name. If the default qualifier is not found, look for the node using each of the alternate qualifiers. If one is found, remove the qualifier and use the result as the base name.
    • If the target node type has a default qualifier defined, add it to the beginning of the name and look for a node with that node type and name in the target viewpoint. If the default qualifier isn't found, look for the node using each of the alternate qualifiers.
  • When adding or inserting nodes across node types:
    • If the source node name begins with the default qualifier, remove the qualifier and use the result as the base name. If the default qualifier is not found, look for the node using each of the alternate qualifiers. If one is found, remove the qualifier and use the result as the base name.
    • For target nodes, the default qualifier is always used for the new node name.

Note:

You can also define property name transformations in the node type converter in order to transform the node name when adding or inserting nodes. See Property Transformations in Working with Node Type Converters.