Set-Identity
DESCRIPTION
Adds attributes and meta-attributes to every element of a group. These attributes specify the UFID (unique federation identifier) and object class of each element. Task delegation can then be easily applied to the group by providing it as the value of the GROUP_IN parameter of the Dispatch-Tasks webject.
SYNTAX
<ie:webject name="Set-Identity" type="GRP">
<ie:param name="GROUP_IN" data="input_group_name"/>
</ie:webject>
PARAMETERS
|
Required
|
Select
|
Optional
|
|
GROUP_IN
|
DOMAIN
|
CLASS
|
|
DOMAIN_ATTRIBUTE
|
CLASS_ATTRIBUTE
|
|
UFID
|
GUID
|
|
|
GUID_ATTRIBUTE
|
|
|
LOCAL_ID
|
|
|
LOCAL_ID_ATTRIBUTE
|
|
|
UFID_ATTRIBUTE
|
CLASS
Specifies a logical object class name. This value is added to each element of the input group as the value of an attribute whose name is specified by CLASS_ATTRIBUTE. This parameter may be specified more than once. If the number of values is less than the number of elements in the input group, the last value specified is reused as many times as necessary to accommodate the remaining elements. If this parameter is omitted, no class name attribute is added to any elements of the input group. This parameter is optional.
CLASS_ATTRIBUTE
Specifies the name of the attribute in which logical class names specified by CLASS is stored. The default value of this parameter is class. If the CLASS parameter is omitted, CLASS_ATTRIBUTE is ignored. This parameter is optional.
DOMAIN
Specifies the domain name of an information repository. This value is combined with LOCAL_ID and GUID to form a UFID (unique federation identifier) value that is added to each element of the input group. This parameter may be specified more than once. If the number of values is less than the number of elements in the input group, the last value specified is reused as many times as necessary to accommodate the remaining elements. If this parameter is omitted, then either the DOMAIN_ATTRIBUTE or UFID parameter must be specified.
DOMAIN_ATTRIBUTE
Specifies the name of an attribute that each element of the input group contains. The value of each such attribute identifies the domain name of an information repository. Each value is combined with LOCAL_ID and GUID to form a UFID (unique federation identifier) value that is added to each element of the input group. If this parameter is omitted, then either the DOMAIN or UFID parameter must be specified.
GROUP_IN
Specifies the name of a group to which class and UFID attributes are added, which is modified in place (this webject has no GROUP_OUT parameter). This parameter is required.
GUID
Specifies the globally unique identifier of an information repository. This value is combined with LOCAL_ID and DOMAIN to form a UFID (unique federation identifier) value that is added to each element of the input group. This parameter may be specified more than once. If the number of values is less than the number of elements in the input group, the last value specified is reused as many times as necessary to accommodate the remaining elements. If this parameter is omitted, and GUID_ATTRIBUTE is also omitted, the globally unique identifier is derived from the DOMAIN value. This parameter is optional.
GUID_ATTRIBUTE
Specifies the name of an attribute contained in each element of the input group. Each such value provides the globally unique identifier of an information repository. This value is combined with LOCAL_ID and DOMAIN to form a UFID (unique federation identifier) value that is added to each element of the input group. If this parameter is omitted, and GUID is also omitted, the globally unique identifier is derived from the DOMAIN value. This parameter is optional.
LOCAL_ID
Specifies the repository-specific identifier of the object represented by an element of the input group. This value is combined with GUID and DOMAIN to form a UFID (unique federation identifier) value that is added to each element of the input group. This parameter may be specified more than once. If the number of values specified is less than the number of elements in the input group, then only those elements with assigned values have a UFID. If this parameter is omitted, and both LOCAL_ID_ATTRIBUTE and UFID are also omitted, then no UFID attribute is added to any elements of the input group. This parameter is optional.
LOCAL_ID_ATTRIBUTE
Specifies the name of an attribute contained in each element of the input group. Each such value provides the repository-specific identifier of the object represented by the element that contains it. This value is combined with GUID and DOMAIN to form a UFID (unique federation identifier) value that is added to each element of the input group. If this parameter is omitted, and both LOCAL_ID and UFID are also omitted, then no UFID attribute is added to any elements of the input group. This parameter is optional.
UFID
Directly specifies the value that is added as a UFID to each element of the input group. This parameter may be specified more than once. If the number of values specified is less than the number of elements in the input group, then only those elements with assigned values have a UFID. If this parameter is omitted, and both LOCAL_ID and LOCAL_ID_ATTRIBUTE are also omitted, then no UFID attribute is added to any elements of the input group. This parameter is optional.
UFID_ATTRIBUTE
Specifies the name of the attribute that is added to each element of the input group to identify each element's UFID. The default value of this parameter is obid. This parameter is optional.