Esquema de DSPL

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 Diagrama dspl9.tmp#id103 dspl9.tmp#id2 dspl9.tmp#id5 dspl9.tmp#id16 dspl9.tmp#id17 dspl9.tmp#id27 dspl9.tmp#id35 dspl9.tmp#id68 dspl9.tmp#id86
Propiedades
content: complejo
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 Diagrama dspl9.tmp#id3 dspl9.tmp#id4
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 Diagrama dspl4.tmp#id7 dspl4.tmp#id14 dspl4.tmp#id15 dspl4.tmp#id6
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 Diagrama dspl4.tmp#id7 dspl4.tmp#id14 dspl4.tmp#id15 dspl4.tmp#id6
Tipo Información
Propiedades
content: complejo
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 Diagrama dspl14.tmp#id24 dspl14.tmp#id26 dspl14.tmp#id19 dspl14.tmp#id20 dspl0.tmp#id10 dspl0.tmp#id12 despl0.tmp#id9 dspl14.tmp#id18
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 Diagrama dspl9.tmp#id28
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 Diagrama dspl15.tmp#id32, dspl15.tmp#id34 dspl15.tmp#id30 dspl15.tmp#id31, dspl15.tmp#id29
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 Diagrama dspl9.tmp#id36
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>

Elemento: dspl / concepts / concepto

Espacio de nombres http://schemas.google.com/dspl/2010
Diagrama Diagrama dspl6.tmp#id66 dspl6.tmp#id67 dspl6.tmp#id38 dspl6.tmp#id43 dspl6.tmp#id45 dspl6.tmp#id47 dspl6.tmp#id48 dspl6.tmp#id57 dspl6.tmp#id58 dspl6.tmp#id37
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 Diagrama dspl9.tmp#id69
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 Diagrama dspl2.tmp#id85 dspl2.tmp#id71 dspl2.tmp#id72. despl2.tmp#id75 dspl2.tmp#id76 dspl2.tmp#id70
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 Diagrama dspl9.tmp#id87
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 Diagrama dspl10.tmp#id102. dspl10.tmp#id89 dspl10.tmp#id90 dspl10.tmp#id97 dspl10.tmp#id88
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
utiliza esto: required
Utilizado por
Elemento dspl/import
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
utiliza esto: columna
Utilizado por
Elemento dspl/import
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
utiliza esto: columna
Utilizado por
Elemento dspl
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.