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

Locality DataObject

Locality is a geographic area.

Locality DataObject extends from the abstract data object GeographicLocation. Locality represents a geographic location.

The structure of a Locality data object consists of:

identifier

contains a single IdentifierType data object.

localityName

specifies the name of the locality, for example a city or town.

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.

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

XML schema definition

The following is the XML schema definition for Locality DataObject:

<xsd:complexType name="Locality">
<xsd:complexContent>
<xsd:extension base="GeographicLocation">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" ref="localityName"/>
<xsd:element maxOccurs="unbounded" minOccurs="0" ref="stateOrProvinceName"/>
<xsd:element maxOccurs="unbounded" minOccurs="0" ref="street"/>
</xsd:sequence>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType> 

Sample data object

Following is a sample Locality DataObject. The l property is the short form for localityName.

<wim:Root>
<wim:entities xsi:type="wim:Locality">
<wim:identifier externalName="l=Toronto,c=CA"
                      repositoryId="LDAP1"
                      uniqueId="eeee9201-1dd111b2-80d5f611-4d759b2b"
                      uniqueName="l=Toronto,c=CA"/>
<wim:l>Toronto
</wim:l>
</wim:entities>
</wim:Root> 

Parent topic: GeographicLocation DataObject

---

+

Search Tips   |   Advanced Search