Locality es una área geográfica.
Locality DataObject se extiende desde el objeto de datos abstracto GeographicLocation. Locality
representa una ubicación geográfica.
La estructura de un objeto de datos Locality está formada por los elementos siguientes:
- identifier
- contiene un único objeto de datos IdentifierType.
- localityName
- especifica el nombre de la localidad, por ejemplo una ciudad o un pueblo.
- parent
- es una propiedad de contención que se utiliza para enlazar con el padre de la entidad
en la jerarquía de virtual member manager. Sólo contiene un único objeto de datos Entity
porque una entidad sólo puede tener un padre. Además, puesto que una entidad puede ser
padre de cualquier otra entidad, el objeto de datos de la propiedad es un objeto de datos
Entity.
- children
- es una propiedad de contención que se utiliza para enlazar con el hijo de la entidad
en la jerarquía de virtual member manager. Contiene varios objetos de datos Entity puesto
que una entidad puede tener varios hijos. Además, puesto que una entidad puede ser hija
de otra entidad, el objeto de datos de la propiedad es un objeto de datos Entity.
- changeType
- es una propiedad opcional que sólo se establece como respuesta a
una búsqueda de entidades cambiadas. Describe el tipo de cambio que se ha producido, que
podría añadir una nueva entidad, modificar una entidad existente, suprimir una entidad o
renombrar una entidad. Los valores y constantes de tipo serie válidos de la propiedad
changeType son add (para CHANGETYPE_ADD), delete (para
CHANGETYPE_DELETE), modify (para CHANGETYPE_MODIFY) y
rename (para CHANGETYPE_RENAME).
Definición de esquema XML
A continuación se proporciona la
definición del esquema XML para 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>
Objeto de datos de ejemplo
A continuación se proporciona un
Locality DataObject de ejemplo. La propiedad l es la forma abreviada para 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>