Esta página y sus subpáginas vinculadas documentan el esquema XML de la DSPL.
Este material está dirigido a usuarios avanzados que deseen comprender los detalles de nivel bajo del lenguaje. Para la mayoría de los usuarios, el contenido en la Guía para desarrolladores debería ser suficiente para crear y editar conjuntos de datos de DSPL.
El esquema completo de XML está disponible para descargar en formato XSD en el sitio de código de DSPL.
Elemento: dspl
Espacio de nombres |
http://schemas.google.com/dspl/2010 |
Anotaciones |
Una especificación DSPL describe un conjunto de datos. Un conjunto de datos se identifica por su espacio de nombres. Un conjunto de datos se compone de los siguientes elementos: - Tablas: datos de los conceptos y secciones definidos en el conjunto de datos - Conceptos: definiciones y estructuras especificadas por el usuario del conjunto de datos - Segmentos: combinaciones de dimensiones y métricas presentes en el conjunto de datos - Temas: etiquetas jerárquicas usadas para organizar los conceptos del conjunto de datos |
Diagrama |
|
Propiedades |
|
Modelo |
import*, info, provider, attribute*, topics{0,1}, conceptos{0,1}, porciones{0,1}, tablas{0,1} |
Children |
atributo, conceptos, import, información, proveedor, porciones, tablas, temas |
Instancia |
<dspl targetNamespace="">
<import location="" namespace="">{0,unbounded}</import>
<info>{1,1}</info>
<provider>{1,1}</provider>
<attribute concept="" id="">{0,unbounded}</attribute>
<topics>{0,1}</topics>
<concepts>{0,1}</concepts>
<slices>{0,1}</slices>
<tables>{0,1}</tables>
</dspl>
|
Atributos |
QName |
Tipo |
Fixed |
Predeterminado |
Uso |
Anotación |
targetNamespace |
xs:cualquierURI |
|
|
columna |
Cada conjunto de datos puede proporcionar un espacio de nombres de destino. El espacio de nombres de destino es un URI que identifica de forma única el conjunto de datos. Para obtener más información sobre el uso de los espacios de nombres en XML, consulta: http://www.w3.org/TR/REC-xml-names/ Si no se proporciona un espacio de nombres, se generará un espacio de nombres cuando se importe el conjunto de datos. |
|
Fuente |
<xs:element name="dspl">
<xs:annotation>
<xs:documentation>A DSPL specification describes a dataset. A dataset is
identified by its namespace. A dataset is comprised of the
following elements:
- Tables: Data for the concepts and slices defined in the
dataset
- Concepts: User-specified definitions and structures used in
the dataset
- Slices: Combinations of dimensions and metrics present in
the dataset
- Topics: Hierarchical labels used to organise the concepts of
the dataset</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="import" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Import directive for external datasets -- modeled after
the XML Schema import directive. In order to use
elements defined in an external dataset, the external
dataset must be referenced using an import directive.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attribute name="namespace" use="required">
<xs:annotation>
<xs:documentation>The namespace of the imported dataset, specified as
a URI. A prefix must be associated with this
namespace before its contents can be referenced. See
[XML Namespaces] for more information about the use
of namespaces and prefixes in XML.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="location" use="optional">
<xs:annotation>
<xs:documentation>An optional location where the definition of the
imported dataset can be found, specified as a
URL. If the location is omitted, the system
processing this DSPL dataset must already know the
imported dataset.
Implementation note: The Google dataset importer
ignores the location attribute. Any imported dataset
must be known by the Google importer beforehand.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>
<xs:element name="info" type="Info" minOccurs="1">
<xs:annotation>
<xs:documentation>General information about the dataset.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="provider" type="Info">
<xs:annotation>
<xs:documentation>General information about the dataset provider.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="attribute" type="Attribute" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Attribute associated with the dataset.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="topics" minOccurs="0">
<xs:annotation>
<xs:documentation>A hierarchy of topics used to organize the contents of
the dataset. The order in which topics are given is
meaningful and should be respected by visualizations
that displays these topics.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="topic" type="Topic" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="concepts" minOccurs="0">
<xs:annotation>
<xs:documentation>A list of concepts defined in this dataset.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="concept" type="Concept" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="slices" minOccurs="0">
<xs:annotation>
<xs:documentation>A list of slices defined in this dataset.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="slice" type="Slice" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="tables" minOccurs="0">
<xs:annotation>
<xs:documentation>A list of tables defined in this dataset.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="table" type="Table" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="targetNamespace" type="xs:anyURI" use="optional">
<xs:annotation>
<xs:documentation>Each dataset may provide a target namespace. The
target namespace is a URI that uniquely identifies the
dataset. For more information about the use of namespaces in XML,
see:
http://www.w3.org/TR/REC-xml-names/
If no targetNamespace is provided, then a namespace will be
generated when the dataset is imported.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>
|
Elemento: dspl / import
Espacio de nombres |
http://schemas.google.com/dspl/2010 |
Anotaciones |
Directiva de importación para conjuntos de datos externos, modelada a partir de la directiva de importación del esquema XML. Para usar elementos definidos en un conjunto de datos externo, se debe hacer referencia al conjunto de datos externo con una directiva de importación. |
Diagrama |
|
Propiedades |
content: |
complejo |
minOccurs: |
0 |
maxOccurs: |
no delimitado |
|
Atributos |
QName |
Tipo |
Fixed |
Predeterminado |
Uso |
Anotación |
ubicación |
|
|
|
columna |
Una ubicación opcional en la que se puede encontrar la definición del conjunto de datos importado, especificada como una URL. Si se omite la ubicación, el sistema que procesa este conjunto de datos de DSPL ya debe conocer el conjunto de datos importado. Nota de implementación: el importador del conjunto de datos de Google ignora el atributo de ubicación. El importador de Google debe conocer de antemano cualquier conjunto de datos importado. |
namespace |
|
|
|
required |
El espacio de nombres del conjunto de datos importado, especificado como un URI. Se debe asociar un prefijo a este espacio de nombres antes de hacer referencia a su contenido. Consulta [Espacios de nombres XML] para obtener más información sobre el uso de espacios de nombres y prefijos en XML. |
|
Fuente |
<xs:element name="import" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Import directive for external datasets -- modeled after
the XML Schema import directive. In order to use
elements defined in an external dataset, the external
dataset must be referenced using an import directive.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attribute name="namespace" use="required">
<xs:annotation>
<xs:documentation>The namespace of the imported dataset, specified as
a URI. A prefix must be associated with this
namespace before its contents can be referenced. See
[XML Namespaces] for more information about the use
of namespaces and prefixes in XML.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="location" use="optional">
<xs:annotation>
<xs:documentation>An optional location where the definition of the
imported dataset can be found, specified as a
URL. If the location is omitted, the system
processing this DSPL dataset must already know the
imported dataset.
Implementation note: The Google dataset importer
ignores the location attribute. Any imported dataset
must be known by the Google importer beforehand.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>
|
Elemento: dspl / info
Espacio de nombres |
http://schemas.google.com/dspl/2010 |
Anotaciones |
Información general sobre el conjunto de datos. |
Diagrama |
|
Tipo |
Información |
Propiedades |
content: |
complejo |
minOccurs: |
1 |
|
Modelo |
nombre , descripción{0,1} , url{0,1} |
Children |
descripción, nombre, URL |
Instancia |
<info>
<name>{1,1}</name>
<description>{0,1}</description>
<url>{0,1}</url>
</info>
|
Fuente |
<xs:element name="info" type="Info" minOccurs="1">
<xs:annotation>
<xs:documentation>General information about the dataset.</xs:documentation>
</xs:annotation>
</xs:element>
|
Elemento: dspl / provider
Espacio de nombres |
http://schemas.google.com/dspl/2010 |
Anotaciones |
Información general sobre el proveedor de conjuntos de datos. |
Diagrama |
|
Tipo |
Información |
Propiedades |
|
Modelo |
nombre, descripción{0,1}, url{0,1} |
Children |
descripción, nombre, URL |
Instancia |
<provider>
<name>{1,1}</name>
<description>{0,1}</description>
<url>{0,1}</url>
</provider>
|
Fuente |
<xs:element name="provider" type="Info">
<xs:annotation>
<xs:documentation>General information about the dataset provider.</xs:documentation>
</xs:annotation>
</xs:element>
|
Elemento: dspl / atributo
Espacio de nombres |
http://schemas.google.com/dspl/2010 |
Anotaciones |
Atributo asociado con el conjunto de datos. |
Diagrama |
|
Tipo |
Attribute |
Propiedades |
content: |
complejo |
minOccurs: |
0 |
maxOccurs: |
no delimitado |
|
Modelo |
info{0,1}, tipo{0,1}, (valor*
| conceptValue{0,1}) |
Children |
conceptValue, info, type, value |
Instancia |
<attribute concept="" id="">
<info>{0,1}</info>
<type format="" ref="">{0,1}</type>
</attribute>
|
Atributos |
QName |
Tipo |
Fixed |
Predeterminado |
Uso |
Anotación |
concepto |
xs:nombredeQ |
|
|
columna |
Referencia a un concepto que corresponde a los valores del atributo. Si el atributo especifica un tipo, este debe coincidir con el tipo del concepto al que se hace referencia. Una referencia a un concepto externo debe tener el formato “prefix:other_concept_id”, en el que “prefix” es el prefijo que se usa para el espacio de nombres del conjunto de datos externo (consulta los espacios de nombres XML). |
id |
LocalId |
|
|
columna |
El ID del atributo de concepto. Este identificador debe ser único dentro del concepto (en todos los atributos y propiedades). El ID se puede omitir si se especifica el atributo de concepto. En ese caso, un ID se crea de forma implícita con el valor local del concepto al que se hace referencia. Por ejemplo, <attribute
="="unit:currency"/> es equivalente a
<attribute id="currency"
concept="unit:currency"/> |
|
Fuente |
<xs:element name="attribute" type="Attribute" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Attribute associated with the dataset.</xs:documentation>
</xs:annotation>
</xs:element>
|
Elemento: dspl / temas
Espacio de nombres |
http://schemas.google.com/dspl/2010 |
Anotaciones |
Una jerarquía de temas que se usa para organizar el contenido del conjunto de datos. El orden en que se dan los temas es significativo y las visualizaciones que muestran estos temas deben respetarlos. |
Diagrama |
|
Propiedades |
content: |
complejo |
minOccurs: |
0 |
|
Modelo |
+tema |
Children |
tema |
Instancia |
<topics>
<topic id="" parentTopic="">{1,unbounded}</topic>
</topics>
|
Fuente |
<xs:element name="topics" minOccurs="0">
<xs:annotation>
<xs:documentation>A hierarchy of topics used to organize the contents of
the dataset. The order in which topics are given is
meaningful and should be respected by visualizations
that displays these topics.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="topic" type="Topic" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
|
Elemento: dspl / topics / topic
Espacio de nombres |
http://schemas.google.com/dspl/2010 |
Diagrama |
|
Tipo |
Tema |
Propiedades |
content: |
complejo |
maxOccurs: |
no delimitado |
|
Modelo |
info, tema* |
Children |
información, tema |
Instancia |
<topic id="" parentTopic="">
<info>{1,1}</info>
<topic id="" parentTopic="">{0,unbounded}</topic>
</topic>
|
Atributos |
QName |
Tipo |
Fixed |
Predeterminado |
Uso |
Anotación |
id |
ID |
|
|
required |
El identificador único del tema en el conjunto de datos. |
parentTopic |
xs:nombredeQ |
|
|
columna |
El ID del tema principal de este tema, si tiene uno.
parentTopic no se puede especificar para temas que están intercalados dentro de otros temas. |
|
Fuente |
<xs:element name="topic" type="Topic" maxOccurs="unbounded"/>
|
Elemento: dspl / Concepts
Espacio de nombres |
http://schemas.google.com/dspl/2010 |
Anotaciones |
Una lista de conceptos definidos en este conjunto de datos. |
Diagrama |
|
Propiedades |
content: |
complejo |
minOccurs: |
0 |
|
Modelo |
concept+ |
Children |
concepto |
Instancia |
<concepts>
<concept extends="" id="">{1,unbounded}</concept>
</concepts>
|
Fuente |
<xs:element name="concepts" minOccurs="0">
<xs:annotation>
<xs:documentation>A list of concepts defined in this dataset.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="concept" type="Concept" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
|
Espacio de nombres |
http://schemas.google.com/dspl/2010 |
Diagrama |
|
Tipo |
Concepto |
Propiedades |
content: |
complejo |
maxOccurs: |
no delimitado |
|
Modelo |
info, topic*, type{0,1}, attribute*, property*, defaultValue{0,1}, tabla{0,1} |
Children |
atributo, valorpredeterminado, información, propiedad, tabla, tema, tipo |
Instancia |
<concept extends="" id="">
<info>{1,1}</info>
<topic ref="">{0,unbounded}</topic>
<type ref="">{0,1}</type>
<attribute concept="" id="">{0,unbounded}</attribute>
<property concept="" id="" isMapping="false" isParent="false">{0,unbounded}</property>
<defaultValue>{0,1}</defaultValue>
<table ref="">{0,1}</table>
</concept>
|
Atributos |
QName |
Tipo |
Fixed |
Predeterminado |
Uso |
Anotación |
se extiende |
xs:nombredeQ |
|
|
columna |
El identificador único de un concepto que extiende este concepto. El concepto al que se hace referencia puede definirse en el mismo conjunto de datos o de forma externa, es decir, en otro conjunto de datos. Una referencia a un concepto externo debe tener el formato “prefix:other_concept_id”, en el que “prefix” es el prefijo que se usa para el espacio de nombres del conjunto de datos externo (consulta los espacios de nombres XML). |
id |
ID |
|
|
required |
El identificador único del concepto, que debe ser único a nivel global dentro del conjunto de datos. |
|
Fuente |
<xs:element name="concept" type="Concept" maxOccurs="unbounded"/>
|
Elemento: dspl / slices
Espacio de nombres |
http://schemas.google.com/dspl/2010 |
Anotaciones |
Una lista de porciones definidas en este conjunto de datos. |
Diagrama |
|
Propiedades |
content: |
complejo |
minOccurs: |
0 |
|
Modelo |
porción+ |
Children |
slice |
Instancia |
<slices>
<slice id="">{1,unbounded}</slice>
</slices>
|
Fuente |
<xs:element name="slices" minOccurs="0">
<xs:annotation>
<xs:documentation>A list of slices defined in this dataset.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="slice" type="Slice" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
|
Elemento: dspl / slices / slice
Espacio de nombres |
http://schemas.google.com/dspl/2010 |
Diagrama |
|
Tipo |
Segmento |
Propiedades |
content: |
complejo |
maxOccurs: |
no delimitado |
|
Modelo |
info{0,1}, dimensión+, métrica+, tabla |
Children |
dimension, info, metric, table |
Instancia |
<slice id="">
<info>{0,1}</info>
<dimension concept="">{1,unbounded}</dimension>
<metric concept="">{1,unbounded}</metric>
<table ref="">{1,1}</table>
</slice>
|
Atributos |
QName |
Tipo |
Fixed |
Predeterminado |
Uso |
Anotación |
id |
ID |
|
|
required |
El identificador único de la porción. |
|
Fuente |
<xs:element name="slice" type="Slice" maxOccurs="unbounded"/>
|
Elemento: dspl / Tables
Espacio de nombres |
http://schemas.google.com/dspl/2010 |
Anotaciones |
Una lista de tablas definidas en este conjunto de datos. |
Diagrama |
|
Propiedades |
content: |
complejo |
minOccurs: |
0 |
|
Modelo |
tabla+ |
Children |
tabla |
Instancia |
<tables>
<table id="">{1,unbounded}</table>
</tables>
|
Fuente |
<xs:element name="tables" minOccurs="0">
<xs:annotation>
<xs:documentation>A list of tables defined in this dataset.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="table" type="Table" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
|
Elemento: dspl / tables / tabla
Espacio de nombres |
http://schemas.google.com/dspl/2010 |
Diagrama |
|
Tipo |
Tabla |
Propiedades |
content: |
complejo |
maxOccurs: |
no delimitado |
|
Modelo |
info{0,1} , columna+ , datos{0,1} |
Children |
column, data, info |
Instancia |
<table id="">
<info>{0,1}</info>
<column format="" id="" type="">{1,unbounded}</column>
<data>{0,1}</data>
</table>
|
Atributos |
QName |
Tipo |
Fixed |
Predeterminado |
Uso |
Anotación |
id |
ID |
|
|
required |
El identificador único de la tabla en el conjunto de datos. |
|
Fuente |
<xs:element name="table" type="Table" maxOccurs="unbounded"/>
|
Atributo: dspl / import / @namespace
Espacio de nombres |
No hay espacios de nombres |
Anotaciones |
El espacio de nombres del conjunto de datos importado, especificado como un URI. Se debe asociar un prefijo con este espacio de nombres antes de que se pueda hacer referencia a su contenido. Consulta [Espacios de nombres XML] para obtener más información sobre el uso de los espacios de nombres y prefijos en XML. |
Propiedades |
|
Utilizado por |
|
Fuente |
<xs:attribute name="namespace" use="required">
<xs:annotation>
<xs:documentation>The namespace of the imported dataset, specified as
a URI. A prefix must be associated with this
namespace before its contents can be referenced. See
[XML Namespaces] for more information about the use
of namespaces and prefixes in XML.</xs:documentation>
</xs:annotation>
</xs:attribute>
|
Atributo: dspl/import/ @location
Espacio de nombres |
No hay espacios de nombres |
Anotaciones |
Una ubicación opcional en la que se puede encontrar la definición del conjunto de datos importado, especificada como una URL. Si se omite la ubicación, el sistema que procesa este conjunto de datos de DSPL ya debe conocer el conjunto de datos importado. Nota de implementación: el importador del conjunto de datos de Google ignora el atributo de ubicación. El importador de Google debe conocer con anterioridad cualquier conjunto de datos importado. |
Propiedades |
|
Utilizado por |
|
Fuente |
<xs:attribute name="location" use="optional">
<xs:annotation>
<xs:documentation>An optional location where the definition of the
imported dataset can be found, specified as a
URL. If the location is omitted, the system
processing this DSPL dataset must already know the
imported dataset.
Implementation note: The Google dataset importer
ignores the location attribute. Any imported dataset
must be known by the Google importer beforehand.</xs:documentation>
</xs:annotation>
</xs:attribute>
|
Atributo: dspl/ @targetNamespace
Espacio de nombres |
No hay espacios de nombres |
Anotaciones |
Cada conjunto de datos puede proporcionar un espacio de nombres de destino. El espacio de nombres de destino es un URI que identifica de forma única el conjunto de datos. Para obtener más información sobre el uso de los espacios de nombres en XML, consulta: http://www.w3.org/TR/REC-xml-names/ Si no se proporciona targetNamespace, se generará un espacio de nombres cuando se importe el conjunto de datos. |
Tipo |
xs:cualquierURI |
Propiedades |
|
Utilizado por |
|
Fuente |
<xs:attribute name="targetNamespace" type="xs:anyURI" use="optional">
<xs:annotation>
<xs:documentation>Each dataset may provide a target namespace. The
target namespace is a URI that uniquely identifies the
dataset. For more information about the use of namespaces in XML,
see:
http://www.w3.org/TR/REC-xml-names/
If no targetNamespace is provided, then a namespace will be
generated when the dataset is imported.</xs:documentation>
</xs:annotation>
</xs:attribute>
|
Se crea con el Editor XML de oxygen.