xpxInsertQualifiersInInstanceHashTablesWithRoles

Owned by Former user (Deleted)
Nov 29, 2017
3 min read
FUNCTION xpxInsertQualifiersInInstanceHashTablesWithRoles (instanceHashTableIndex                : INTEGER;
                                                           options                               : INTEGER;
                                                           instanceIdOrAggrId                    : GENERIC;
                                                           qualifier1,qualifier2, ...qualifier32 : GENERIC)
                                                           status                                : INTEGER;

Function to set one or more qualifiers to an existing element, or to an new created  element in an EDMinstanceHashTable. This function is only applicable for EDMinstanceHashTable of type INSTANCE_HASH_TABLE_WITH_ROLES. This function have variable number of arguments. The minimum number of arguments is 3 and the maximum number of arguments are 35.

Arguments

1TypeNameComment
2INTEGERinstanceHashTableIndexAn integer value that identifies the actual EDMinstanceHashTable. This "instanceHashTableIndex" is returned when the actual EDMinstanceHashTable was created. The actual EDMinstanceHashTable must be of type INSTANCE_HASH_TABLE_WITH_ROLES
3INTEGERoptionsOptional argument. The default value is INDETERMINATE (?)
4GENERICinstanceIdOrAggrIdThe given "instanceIdOrAggrId" must be an instanceId or an aggregateId that identifies an element in the specified EDMinstanceHashTable. When the given "instanceIdOrAggrId" does not exist in the specified EDMinstanceHashTable, it will be inserted by this xpxInsertQualifiersInInstanceHashTablesWithRoles() operation.
5GENERICqualifier1 - qualifier32

This argument specifies one or more qualifiers to the EDMinstanceHashTable element identified by the "instanceIdOrAggrId" argument. The "qualifier" argument can be one of the following:

  1. Aggregate index interval(s). See description of xpxAGGR_ELEMENTS_INTERVAL option for more details. Maximum 16 intervals can be defined in one xpxInsertIndexOfAggregateInInstanceHashTable() operation.  This qualifier is only legal when the given "instanceIdOrAggrId" is an aggregateId.
  2. Agregate index. Maximum 32 aggregate indexes can be defined in one xpxInsertIndexOfAggregateInInstanceHashTable() operation. This qualifier is only legal when the given "instanceIdOrAggrId" is an aggregateId.
  3. An attribute name that is a role (attributeId) in the "instanceIdOrAggrId" argument. This qualifier is only legal when the given "instanceIdOrAggrId" is an instanceId. Maximum 32 attribute names can be defined in one xpxInsertIndexOfAggregateInInstanceHashTable() operation.
  4. An attributeId that is a role in the "instanceIdOrAggrId" argument.This qualifier is only legal when the given "instanceIdOrAggrId" is an instanceId. Maximum 32 attributeId can be defined in one xpxInsertIndexOfAggregateInInstanceHashTable() operation.

 All "qualifier" arguments will be inserted in the actual EDMinstanceHashTable as a "qualifier" to the EDMinstanceHashTable element specified by the "instanceIdOrAggrId" argument.

Return Value

Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'US:_r_XPX_Return_Value'.

Options

OptionComment
xpxAGGR_ELEMENTS_INTERVALthe specified "qualifier" arguments defines an "aggregate index interval", i.e., "qualifier1 - qualifier2" defines one interval, "qualifier3 - qualifier4" another interval and so on. Hence with this option specified, the number of "qualifier" arguments must be an "even number". This option is only legal when the "instanceIdOrAggrId" argument is an aggregateId.

 

Example

<Missing Example>

 

See also

Filter by label

There are no items with the selected labels at this time.

Â