Esquema DSPL

Esta página e as subpáginas vinculadas a ela documentam o esquema XML da DSPL. Este material é destinado a usuários avançados que querem entender os detalhes de baixo nível da linguagem. Para a maioria dos usuários, o conteúdo no Guia do desenvolvedor deve ser suficiente para criar e editar conjuntos de dados DSPL.

O esquema XML completo está disponível para download no formato XSD no site do código DSPL.

Elemento: dspl

Namespace http://schemas.google.com/dspl/2010
Anotações Uma especificação DSPL descreve um conjunto de dados. Um conjunto de dados é identificado pelo namespace. Um conjunto de dados é composto dos seguintes elementos: - Tabelas: dados para os conceitos e frações definidas no conjunto de dados - Conceitos: definições e estruturas especificadas pelo usuário usadas no conjunto de dados - Fatias: combinações de dimensões e métricas presentes no conjunto de dados - Tópicos: rótulos hierárquicos usados para organizar os conceitos do conjunto de dados
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
Propriedades
content: complexo
Modelo import* , info , provider, attribute* , topics{0,1} , concepts{0,1} , fatias{0,1} , tabelas{0,1}
Children atributo, conceitos, importar, informações, provedor, fatias, tabelas, tópicos
Instância 
<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 Fixo Padrão Uso Annotation
targetNamespace x:qualquerURI opcional Cada conjunto de dados pode fornecer um namespace de destino. O namespace de destino é um URI que identifica exclusivamente o conjunto de dados. Para mais informações sobre o uso de namespaces em XML, consulte: http://www.w3.org/TR/REC-xml-names/ Se nenhum targetNamespace for fornecido, um namespace será gerado quando o conjunto de dados for importado.
Fonte 
<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

Namespace http://schemas.google.com/dspl/2010
Anotações Diretiva de importação para conjuntos de dados externos: modelada de acordo com a diretiva de importação de esquema XML. Para usar elementos definidos em um conjunto de dados externo, ele precisa ser referenciado usando uma diretiva de importação.
Diagrama Diagrama dspl9.tmp#id3 dspl9.tmp#id4
Propriedades
content: complexo
minOccurs: 0
maxOccurs: ilimitada
Atributos
QName Tipo Fixo Padrão Uso Annotation
local opcional Um local opcional em que a definição do conjunto de dados importado pode ser encontrada, especificada como um URL. Se o local for omitido, o sistema que processa esse conjunto de dados DSPL já precisará saber o conjunto importado. Observação de implementação: o importador de conjunto de dados do Google ignora o atributo local. Qualquer conjunto de dados importado precisa ser conhecido pelo importador do Google com antecedência.
namespace exigiu O namespace do conjunto de dados importado, especificado como um URI. É preciso associar um prefixo a esse namespace para que ele possa ser referenciado. Consulte [Namespaces XML] para ver mais informações sobre o uso de namespaces e prefixos em XML.
Fonte 
<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

Namespace http://schemas.google.com/dspl/2010
Anotações Informações gerais sobre o conjunto de dados.
Diagrama Diagrama dspl4.tmp#id7 dspl4.tmp#id14 dspl4.tmp#id15 dspl4.tmp#id6
Tipo Informações
Propriedades
content: complexo
minOccurs: 1
Modelo nome , description{0,1} , url{0,1}
Children descrição, nome, URL
Instância 
<info>
  <name>{1,1}</name>
  <description>{0,1}</description>
  <url>{0,1}</url>
</info>
Fonte 
<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

Namespace http://schemas.google.com/dspl/2010
Anotações Informações gerais sobre o provedor do conjunto de dados.
Diagrama Diagrama dspl4.tmp#id7 dspl4.tmp#id14 dspl4.tmp#id15 dspl4.tmp#id6
Tipo Informações
Propriedades
content: complexo
Modelo nome, description{0,1}, url{0,1}
Children descrição, nome, URL
Instância 
<provider>
  <name>{1,1}</name>
  <description>{0,1}</description>
  <url>{0,1}</url>
</provider>
Fonte 
<xs:element name="provider" type="Info">
  <xs:annotation>
    <xs:documentation>General information about the dataset provider.</xs:documentation>
  </xs:annotation>
</xs:element>

Elemento: dspl / attribute

Namespace http://schemas.google.com/dspl/2010
Anotações Atributo associado ao conjunto de dados.
Diagrama Diagrama dspl14.tmp#id24 dspl14.tmp#id26 dspl14.tmp#id19 dspl14.tmp#id20 dspl0.tmp#id10 dspl0.tmp#id12 dspl0.tmp#id9 dspl14.tmp#id18
Tipo Attribute
Propriedades
content: complexo
minOccurs: 0
maxOccurs: ilimitada
Modelo info{0,1} , type{0,1} , (value* | conceptValue{0,1})
Children conceptValue, informação, tipo e valor
Instância 
<attribute concept="" id="">
  <info>{0,1}</info>
  <type format="" ref="">{0,1}</type>
</attribute>
Atributos
QName Tipo Fixo Padrão Uso Annotation
conceito xs:QName opcional Uma referência a um conceito que corresponde aos valores do atributo. Se o atributo especificar um tipo, ele precisará corresponder ao tipo do conceito referenciado. Uma referência a um conceito externo precisa estar no formato "prefix:other_concept_id", em que "prefixo" é o prefixo usado para o namespace do conjunto de dados externo (consulte namespaces XML).
id LocalId (em inglês) opcional O ID do atributo do conceito. Esse identificador precisa ser exclusivo no conceito (entre atributos e propriedades). O ID pode ser omitido se o atributo do conceito for especificado. Nesse caso, um ID é implicitamente criado com o valor do nome local do conceito referenciado. Por exemplo, <attribute conceitua="unit:currency"/> é equivalente a <attribute id="currency" conceitua="unit:currency"/>
Fonte 
<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 / topics

Namespace http://schemas.google.com/dspl/2010
Anotações Uma hierarquia de tópicos usada para organizar o conteúdo do conjunto de dados. A ordem em que os temas são fornecidos é significativa e precisa ser respeitada pelas visualizações que mostram esses temas.
Diagrama Diagrama dspl9.tmp#id28
Propriedades
content: complexo
minOccurs: 0
Modelo tópico+
Children tema
Instância 
<topics>
  <topic id="" parentTopic="">{1,unbounded}</topic>
</topics>
Fonte 
<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

Namespace http://schemas.google.com/dspl/2010
Diagrama Diagrama dspl15.tmp#id32 dspl15.tmp#id34 dspl15.tmp#id30 dspl15.tmp#id31 dspl15.tmp#id29
Tipo Topic
Propriedades
content: complexo
maxOccurs: ilimitada
Modelo informação , tópico*
Children informações, tópico
Instância 
<topic id="" parentTopic="">
  <info>{1,1}</info>
  <topic id="" parentTopic="">{0,unbounded}</topic>
</topic>
Atributos
QName Tipo Fixo Padrão Uso Annotation
id Código exigiu O identificador exclusivo do tópico no conjunto de dados.
parentTopic (link em inglês) xs:QName opcional O ID do tópico pai deste tópico, se tiver um. parentTopic não pode ser especificado para tópicos inline dentro de outros tópicos.
Fonte 
<xs:element name="topic" type="Topic" maxOccurs="unbounded"/>

Elemento: dspl / conceitos

Namespace http://schemas.google.com/dspl/2010
Anotações Uma lista de conceitos definidos neste conjunto de dados.
Diagrama Diagrama dspl9.tmp#id36
Propriedades
content: complexo
minOccurs: 0
Modelo conceito+
Children conceito
Instância 
<concepts>
  <concept extends="" id="">{1,unbounded}</concept>
</concepts>
Fonte 
<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 / conceito

Namespace 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 Conceito
Propriedades
content: complexo
maxOccurs: ilimitada
Modelo info , topic* , type{0,1}, attribute* , property* , defaultValue{0,1} , table{0,1}
Children attribute, defaultValue, info, property, table, topic, tipo
Instância 
<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 Fixo Padrão Uso Annotation
estende xs:QName opcional O identificador exclusivo de um conceito estendido por ele. O conceito referenciado pode ser definido no mesmo conjunto de dados ou externamente, ou seja, em outro conjunto de dados. Uma referência a um conceito externo precisa ter o formato "prefix:other_concept_id", em que "prefixo" é o prefixo usado para o namespace do conjunto de dados externo (consulte namespaces XML).
id Código exigiu O identificador exclusivo do conceito, que precisa ser globalmente exclusivo no conjunto de dados.
Fonte 
<xs:element name="concept" type="Concept" maxOccurs="unbounded"/>

Elemento: dspl / fatias

Namespace http://schemas.google.com/dspl/2010
Anotações Uma lista de frações definidas neste conjunto de dados.
Diagrama Diagrama dspl9.tmp#id69
Propriedades
content: complexo
minOccurs: 0
Modelo Slice+
Children slice
Instância 
<slices>
  <slice id="">{1,unbounded}</slice>
</slices>
Fonte 
<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 / fatia

Namespace http://schemas.google.com/dspl/2010
Diagrama Diagrama dspl2.tmp#id85 dspl2.tmp#id71. dspl2.tmp#id72 dspl2.tmp#id75 dspl2.tmp#id76 dspl2.tmp#id70
Tipo Fatia
Propriedades
content: complexo
maxOccurs: ilimitada
Modelo info{0,1}, dimension+, metric+ e tabela
Children dimensão, informações, métrica, tabela
Instância 
<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 Fixo Padrão Uso Annotation
id Código exigiu É o identificador exclusivo da fatia.
Fonte 
<xs:element name="slice" type="Slice" maxOccurs="unbounded"/>

Elemento: dspl / tabelas

Namespace http://schemas.google.com/dspl/2010
Anotações Uma lista de tabelas definidas neste conjunto de dados.
Diagrama Diagrama dspl9.tmp#id87
Propriedades
content: complexo
minOccurs: 0
Modelo tabela +
Children tabela
Instância 
<tables>
  <table id="">{1,unbounded}</table>
</tables>
Fonte 
<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 / tabela

Namespace http://schemas.google.com/dspl/2010
Diagrama Diagrama dspl10.tmp#id102 dspl10.tmp#id89 dspl10.tmp#id90 dspl10.tmp#id97 dspl10.tmp#id88
Tipo Tabela
Propriedades
content: complexo
maxOccurs: ilimitada
Modelo info{0,1} , column+ , data{0,1}
Children coluna, dados, informações
Instância 
<table id="">
  <info>{0,1}</info>
  <column format="" id="" type="">{1,unbounded}</column>
  <data>{0,1}</data>
</table>
Atributos
QName Tipo Fixo Padrão Uso Annotation
id Código exigiu O identificador exclusivo da tabela no conjunto de dados.
Fonte 
<xs:element name="table" type="Table" maxOccurs="unbounded"/>

Atributo: dspl / import / @namespace

Namespace Nenhum namespace
Anotações O namespace do conjunto de dados importado, especificado como um URI. É necessário que um prefixo esteja associado a esse namespace antes que seu conteúdo possa ser referenciado. Consulte [Namespaces XML] para ver mais informações sobre o uso de namespaces e prefixos em XML.
Propriedades
use: exigiu
Usados por
Elemento dspl/import (em inglês)
Fonte 
<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

Namespace Nenhum namespace
Anotações Um local opcional em que a definição do conjunto de dados importado pode ser encontrada, especificada como um URL. Se o local for omitido, o sistema que processa esse conjunto de dados DSPL já precisará saber o conjunto de dados importado. Observação de implementação: o importador de conjunto de dados do Google ignora o atributo local. Qualquer conjunto de dados importado precisa ser conhecido pelo importador do Google com antecedência.
Propriedades
use: opcional
Usados por
Elemento dspl/import (em inglês)
Fonte 
<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

Namespace Nenhum namespace
Anotações Cada conjunto de dados pode fornecer um namespace de destino. O namespace de destino é um URI que identifica exclusivamente o conjunto de dados. Para mais informações sobre o uso de namespaces em XML, consulte: http://www.w3.org/TR/REC-xml-names/ Se nenhum targetNamespace for fornecido, um namespace será gerado quando o conjunto de dados for importado.
Tipo x:qualquerURI
Propriedades
use: opcional
Usados por
Elemento dspl (em inglês)
Fonte 
<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>

Criado com o editor XML oXygen.