Express (Distributed operating systems), v8.0 > Secure applications and their environment > Authenticate users > Select a registry or repository > Manage realms in a federated repository > Virtual member manager > Reference > Program model > Entity DataObject

Group DataObject

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 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 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

• cn
• members
• displayName

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> 

Parent topic: Entity DataObject

---

+

Search Tips   |   Advanced Search