XML Schema elementElemento
Manual de referencia completo de XML Schema
Definición y uso
El elemento element define un elemento.
Información del elemento
- Elemento padre: schema, choice, all, sequence, group
Sintaxis
id=ID
name=NCName
ref=QName
type=QName
substitutionGroup=QName
default=string
fixed=string
form=qualified|unqualified
maxOccurs=nonNegativeInteger|unbounded
minOccurs=nonNegativeInteger
nillable=true|false
abstract=true|false
block=(#all|list of (extension|restriction))
final=(#all|list of (extension|restriction))
any attributes
>
annotation?,(simpleType|complexType)?,(unique|key|keyref)*
</element>
(El signo ? declara que el elemento puede aparecer cero o una vez dentro del elemento element, el signo * declara que el elemento puede aparecer cero o más veces).
| Atributos | Descripción |
|---|---|
| id | Opcional. Especifica una ID única para el elemento. |
| name | Opcional. Especifica el nombre del elemento. Este atributo es obligatorio si el elemento padre es el elemento schema. |
| ref | Opcional. Una referencia a otro elemento. El atributo ref puede contener un prefijo de espacio de nombres. Este atributo no se utiliza si el elemento padre es el elemento schema. |
| type | Opcional. Especifica el nombre de un tipo de datos integrado, o el nombre de un elemento simpleType o complexType. |
| substitutionGroup | Opcional. Especifica el nombre de un elemento que se puede utilizar para reemplazar este elemento. Este elemento debe tener el mismo tipo o un tipo derivado del tipo de elemento especificado. Este atributo no se puede utilizar si el elemento padre no es el elemento schema. |
| default | Opcional. Especifica un valor predeterminado para el elemento (solo se utiliza cuando el contenido del elemento es un tipo simple o textOnly). |
| fixed | Opcional. Especifica un valor fijo para el elemento (solo se utiliza cuando el contenido del elemento es un tipo simple o textOnly). |
| form | Opcional. La forma del elemento. El valor predeterminado es el valor del atributo elementFormDefault del elemento schema que contiene este atributo. El valor debe ser una de las siguientes cadenas: "qualified" o "unqualified". Este atributo no se puede utilizar si el elemento padre es el elemento schema.
|
| maxOccurs | Opcional. Especifica el número máximo de veces que el elemento element puede aparecer en el elemento padre. El valor puede ser un entero mayor o igual que cero. Para no establecer ningún límite en el número máximo, utilice la cadena "unbounded". El valor predeterminado es 1. Este atributo no se puede utilizar si el elemento padre es el elemento schema. |
| minOccurs | Opcional. Especifica el número mínimo de veces que el elemento element puede aparecer en el elemento padre. El valor puede ser un entero mayor o igual que cero. El valor predeterminado es 1. Este atributo no se puede utilizar si el elemento padre es el elemento schema. |
| nillable | Opcional. Indica si se puede asignar un valor cero explícito al elemento. Esto se aplica al contenido del elemento y no es un atributo del elemento. El valor predeterminado es false.
Si nillable es true, permitirá que una instancia del elemento pueda establecer el atributo nil en true. El atributo nil se define como parte del espacio de nombres de XML Schema para instancias. |
| abstract | Opcional. Indica si el elemento se puede utilizar en documentos de instancia. Si el valor es true, el elemento no puede aparecer en documentos de instancia. En su lugar, otro elemento cuyo atributo substitutionGroup contenga el nombre calificado (QName) de este elemento debe aparecer en su lugar. Múltiples elementos pueden hacer referencia a este elemento en su atributo substitutionGroup. El valor predeterminado es false. |
| block | Opcional. El tipo de derivación. El atributo block evita que elementos con el tipo de derivación especificado se utilicen para reemplazar este elemento. El valor puede contener #all o una lista que sea un subconjunto de extension, restriction o substitution:
|
| final | Opcional. Establece el valor predeterminado del atributo final en los elementos element. Este atributo no se puede utilizar si el elemento padre no es el elemento schema. El valor puede contener #all o una lista que sea un subconjunto de extension o restriction:
|
| any attributes | Opcional. Especifica cualquier otro atributo con un espacio de nombres que no sea de schema. |
Ejemplo 1
El siguiente ejemplo es un schema con cuatro elementos simples: "fname", "lname", "age" y "dateborn", de tipos string, nonNegativeInteger y date:
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="fname" type="xs:string"/>
<xs:element name="lname" type="xs:string"/>
<xs:element name="age" type="xs:nonNegativeInteger"/>
<xs:element name="dateborn" type="xs:date"/>
</xs:schema>
Ejemplo 2
El siguiente ejemplo es un schema con un elemento "note" de tipo complejo. El elemento "note" contiene cuatro elementos simples: "to", "from", "heading" y "body":
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="note">
<xs:complexType>
<xs:sequence>
<xs:element name="to" type="xs:string"/>
<xs:element name="from" type="xs:string"/>
<xs:element name="heading" type="xs:string"/>
<xs:element name="body" type="xs:string"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
Ejemplo 3
Este ejemplo es el mismo que el ejemplo 2, pero en este caso elegimos usar el atributo ref para hacer referencia a los nombres de los elementos:
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="note">
<xs:complexType>
<xs:sequence>
<xs:element ref="to"/>
<xs:element ref="from"/>
<xs:element ref="heading"/>
<xs:element ref="body"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="to" type="xs:string"/>
<xs:element name="from" type="xs:string"/>
<xs:element name="heading" type="xs:string"/>
<xs:element name="body" type="xs:string"/>
</xs:schema>
Manual de referencia completo de XML Schema Otras extensiones