Group represents a collection of entities.
The members of a group are any entity types. A group can be a group
consisting of mixed entities such as groups, persons, accounts, parties
and so forth.
The
structure of a Group data object consists of:
- identifier
- contains a single IdentifierType data object.
- parent
- is a containment property which is used to link to the parent
of the entity in the virtual member manager hierarchy. It only contains
a single Entity data object because an entity can only have one parent.
Also, because any entity can be parent of any other entity, the data
object in the property is an Entity data object.
- children
- is a containment property that is used to link to the children
of the entity in the virtual member manager hierarchy. It contains
multiple Entity data objects because an entity can have multiple children.
Also, because any entity can be a child of another entity, the data
object in the property is an Entity data object.
- groups
- is a containment property which is used to link to the groups
this entity belongs to. It contains multiple Group data objects because
an entity can belong to multiple groups.
- members
- is a containment property that is used to link to the group members
of this group. It contains multiple entity data objects because a
group can have multiple group members.
- changeType

- is an optional property that is set only in
response to a search for changed entities. It describes the type of
change that occurred, which could be adding a new entity, modifying
an existing entity, deleting an entity, or renaming an entity. The
valid values and string constants of the changeType property are add (for
CHANGETYPE_ADD), delete (for CHANGETYPE_DELETE), modify (for
CHANGETYPE_MODIFY), and rename (for CHANGETYPE_RENAME).
- additional properties
-
XML schema definition
The following is the
XML schema definition for Group DataObject:
<xsd:complexType name="Group">
<xsd:complexContent>
<xsd:extension base="Party">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" ref="cn"/>
<xsd:element maxOccurs="unbounded" minOccurs="0" name="members" type="Entity"/>
<xsd:element maxOccurs="unbounded" minOccurs="0" ref="displayName"/>
</xsd:sequence>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
Sample data object
Following is a sample
Group data object that contains the cn property and its group member:
<wim:Root>
<wim:entities xsi:type="wim:Group">
<wim:identifier externalName="cn=Managers,cn=groups,dc=soundpost,dc=com"
repositoryId="LDAP1"
uniqueId="eeee9204-1dd111b2-80d5f611-4d759b2b"
uniqueName="cn=Managers,cn=groups,dc=yourco,dc=com"/>
<wim:groups>
<wim:identifier externalName="cn=Employee,cn=groups,dc=soundpost,dc=com"
repositoryId="LDAP1"
uniqueId="eeee9205-1dd111b2-80d5f611-4d759b2b"
uniqueName="cn=Employee,cn=groups,dc=yourco,dc=com"/>
<wim:cn>Employee</wim:cn>
</wim:groups>
<wim:cn>Managers</wim:cn>
</wim:entities>
</wim:Root>