Esquema DSPL

Esta página e as subpáginas vinculadas documentam o esquema XML do DSPL. Este material é destinado a usuários avançados que desejam entender os detalhes da linguagem, para a maioria dos usuários, o conteúdo na o guia para desenvolvedores deve ser suficiente para criar e editar conjuntos de dados DSPL.

O esquema XML completo está disponível para download em formato XSD no(a) Site do código DSPL (em inglês).

Elemento: dspl

Namespace	http://schemas.google.com/dspl/2010
Anotações	Uma especificação DSPL descreve um conjunto de dados. Um conjunto de dados é identificados pelo próprio namespace. Um conjunto de dados é composto pelo seguinte: elementos: - Tabelas: dados dos conceitos e frações definidas no conjunto de dados - Conceitos: definições e estruturas especificadas pelo usuário usadas na conjunto de dados — Slices: combinações de dimensões e métricas presentes no conjunto de dados - Tópicos: rótulos hierárquicos usados para organizar os conceitos de conjunto de dados
Diagrama
Propriedades	content: complexo
Modelo	import* , informações , provedor , atributo* , tópicos{0,1} , conceitos{0,1} , fatias{0,1} , tabelas{0,1}
Filhos	atributo, conceitos, import, 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 Usar Nota targetNamespace xs:anyURI opcional Cada conjunto de dados pode fornecer um namespace de destino. O objetivo namespace é 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 importadas.
Origem	<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, modeladas de acordo com o XML Diretiva de importação do esquema. Para usar elementos definidos em um conjunto de dados externo, ele precisa ser referenciado usando uma diretiva de importação.
Diagrama
Propriedades	content: complexo minOccurs: 0 maxOccurs: ilimitada
Atributos	QName Tipo Fixo Padrão Usar Nota local opcional Um local opcional em que a definição do conjunto de dados importado pode ser encontrada, especificado como um URL. Se o local for omitido, o sistema que processa este conjunto de dados DSPL já deve saber conjunto de dados importado. Observação de implementação: o conjunto de dados do Google importador ignora o atributo location. Todo conjunto de dados importado precisa ser conhecido pelo importador do Google de antemão. namespace obrigatório O namespace do conjunto de dados importado, especificado como um URI. Um prefixo deve ser associado a este namespace antes de seu onde esses conteúdos possam ser referenciados. Consulte [Namespaces XML] para mais informações sobre o uso de namespaces e prefixos em XML.
Origem	<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
Tipo	Informação
Propriedades	content: complexo minOccurs: 1
Modelo	name , description{0,1} , url{0,1}
Filhos	descrição, nome, url
Instância	<info> <name>{1,1}</name> <description>{0,1}</description> <url>{0,1}</url> </info>
Origem	<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 / provedor

Namespace	http://schemas.google.com/dspl/2010
Anotações	Informações gerais sobre o provedor do conjunto de dados.
Diagrama
Tipo	Informação
Propriedades	content: complexo
Modelo	nome , descrição{0,1} , url{0,1}
Filhos	descrição, nome, url
Instância	<provider> <name>{1,1}</name> <description>{0,1}</description> <url>{0,1}</url> </provider>
Origem	<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

Namespace	http://schemas.google.com/dspl/2010
Anotações	Atributo associado ao conjunto de dados.
Diagrama
Tipo	Attribute
Propriedades	content: complexo minOccurs: 0 maxOccurs: ilimitada
Modelo	info{0,1} , tipo{0,1} , (valor* | conceptValue{0,1})
Filhos	conceptValue, info, type, valor
Instância	<attribute concept="" id=""> <info>{0,1}</info> <type format="" ref="">{0,1}</type> </attribute>
Atributos	QName Tipo Fixo Padrão Usar Nota Conceito xs:QName opcional Uma referência a um conceito que corresponde aos valores do atributo. Se o atributo especificar um tipo, ele precisa corresponder ao tipo do conceito referenciado. Uma referência a um conceito externo precisa ter o formato "prefixo:outro_id_conceito", em que "prefixo" é o prefixo usado para o namespace do conjunto de dados externo (consulte os namespaces XML). id LocalId opcional O ID do atributo de conceito. Esse identificador deve ser exclusivos dentro do conceito (em atributos e propriedades). O id pode ser omitido se o atributo conceitual for especificado. Nesse no caso, um ID é implicitamente criado com um valor igual ao nome local do conceito referenciado. Por exemplo: <attribute concept=&quot;unit:currency&quot;/&gt; é equivalente a <attribute id="currency" concept=&quot;unit:currency&quot;/&gt;
Origem	<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 / tópicos

Namespace	http://schemas.google.com/dspl/2010
Anotações	Uma hierarquia de tópicos usada para organizar o conteúdo do no conjunto de dados. A ordem em que os tópicos são apresentados é significativa e deve ser respeitadas por visualizações que mostram esses temas.
Diagrama
Propriedades	content: complexo minOccurs: 0
Modelo	topic+ (link em inglês)
Filhos	tema
Instância	<topics> <topic id="" parentTopic="">{1,unbounded}</topic> </topics>
Origem	<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
Tipo	Tópico
Propriedades	content: complexo maxOccurs: ilimitada
Modelo	info , assunto*
Filhos	info, tema
Instância	<topic id="" parentTopic=""> <info>{1,1}</info> <topic id="" parentTopic="">{0,unbounded}</topic> </topic>
Atributos	QName Tipo Fixo Padrão Usar Nota id ID obrigatório O identificador exclusivo do tópico no conjunto de dados. parentTopic xs:QName opcional O ID do tópico pai, se houver. O parentTopic não pode ser especificado para tópicos inline em outros.
Origem	<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
Propriedades	content: complexo minOccurs: 0
Modelo	concept+
Filhos	conceito
Instância	<concepts> <concept extends="" id="">{1,unbounded}</concept> </concepts>
Origem	<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 / conceitos / conceito

Namespace	http://schemas.google.com/dspl/2010
Diagrama
Tipo	Conceito
Propriedades	content: complexo maxOccurs: ilimitada
Modelo	info , topic* , type{0,1} , attribute* , property* , defaultValue{0,1} , table{0,1}
Filhos	attribute, defaultValue, info, propriedade, tabela, tópico, 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 Usar Nota extende xs:QName opcional O identificador exclusivo de um conceito que este conceito se estende. O conceito mencionado pode ser definido no mesmo conjunto de dados ou externamente, ou seja, em outro conjunto de dados. Uma referência a um objeto externo conceito precisa ter o formato "prefixo:other_concept_id", em que "prefixo" é o prefixo usado para o namespace do conjunto de dados externo (consulte Namespaces XML). id ID obrigatório O identificador exclusivo do conceito, que deve ser globalmente exclusivos dentro do conjunto de dados.
Origem	<xs:element name="concept" type="Concept" maxOccurs="unbounded"/>

Elemento: dspl / parcelas

Namespace	http://schemas.google.com/dspl/2010
Anotações	Uma lista de fatias definidas neste conjunto de dados.
Diagrama
Propriedades	content: complexo minOccurs: 0
Modelo	fatia+
Filhos	slice
Instância	<slices> <slice id="">{1,unbounded}</slice> </slices>
Origem	<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
Tipo	Fatia
Propriedades	content: complexo maxOccurs: ilimitada
Modelo	info{0,1} , dimension+ , metric+ , tabela
Filhos	dimension, info, metric, 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 Usar Nota id ID obrigatório O identificador exclusivo da fração.
Origem	<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
Propriedades	content: complexo minOccurs: 0
Modelo	table+
Filhos	tabela
Instância	<tables> <table id="">{1,unbounded}</table> </tables>
Origem	<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
Tipo	Tabela
Propriedades	content: complexo maxOccurs: ilimitada
Modelo	info{0,1} , coluna+ , dados{0,1}
Filhos	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 Usar Nota id ID obrigatório O identificador exclusivo da tabela no conjunto de dados.
Origem	<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. Um deve ser associado a este namespace antes que seu conteúdo possa ser referenciadas. Consulte [Namespaces XML] para mais informações sobre o uso de namespaces e prefixos em XML.
Propriedades	use: obrigatório
Usados por	Elemento dspl/import
Origem	<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 arquivo conjunto de dados pode ser encontrado, especificado como um URL. Se o local for omitido, o que está processando este conjunto de dados DSPL já deve saber o ID no conjunto de dados. Observação de implementação: o importador de conjunto de dados do Google ignora as location. Qualquer conjunto de dados importado precisa ser conhecido pelo Google importador com antecedência.
Propriedades	use: opcional
Usados por	Elemento dspl/import
Origem	<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 objetivo namespace é 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 importadas.
Tipo	xs:anyURI
Propriedades	use: opcional
Usados por	Elemento dspl
Origem	<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 usando o Editor XML oXygen.