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