Schema DSPL

Questa pagina e le relative pagine secondarie collegate documentano lo schema XML di DSPL. Questo materiale è destinato a utenti avanzati che vogliono comprendere i dettagli di basso livello della lingua; per la maggior parte degli utenti, i contenuti della guida per gli sviluppatori devono essere sufficienti per creare e modificare i set di dati DSPL.

Lo schema XML completo è disponibile per il download in formato XSD sul sito del codice DSPL.

Elemento: dspl

Spazio dei nomi http://schemas.google.com/dspl/2010
Annotazioni Una specifica DSPL descrive un set di dati. Un set di dati è identificato dal suo spazio dei nomi. Un set di dati è costituito dai seguenti elementi: - Tabelle: dati relativi a concetti e sezioni definiti nel set di dati - Concetti: definizioni e strutture specificate dall'utente nel set di dati - Sezioni: combinazioni di dimensioni e metriche presenti nel set di dati - Argomenti: etichette gerarchiche utilizzate per organizzare i concetti del set di dati
Diagramma Diagramma 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
Proprietà
contenuti: complesso
Modello import* , info , provider , attribute* , topics{0,1} , concept{0,1} , slices{0,1} , tabelle{0,1}
Bambini attributo, concetti, importazione, informazioni, provider, fette, tabelle, argomenti
Istanza 
<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>
Attributi
QName Tipo Fisso Predefinito Utilizzo Annotazione
spazio dei nomi target xs:qualsiasiURI facoltativo Ciascun set di dati può fornire uno spazio dei nomi di destinazione. Lo spazio dei nomi target è un URI che identifica in modo univoco il set di dati. Per ulteriori informazioni sull'uso degli spazi dei nomi in XML, consulta: http://www.w3.org/TR/REC-xml-names/ Se non viene fornito alcuno targetNamespace, verrà generato uno spazio dei nomi durante l'importazione del set di dati.
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 / importazione

Spazio dei nomi http://schemas.google.com/dspl/2010
Annotazioni Istruzione di importazione per set di dati esterni, modellata sulla direttiva di importazione dello schema XML. Per utilizzare gli elementi definiti in un set di dati esterno, è necessario fare riferimento a tale set di dati utilizzando un'istruzione di importazione.
Diagramma Diagramma dspl9.tmp#id3 dspl9.tmp#id4
Proprietà
contenuti: complesso
minOccorre: 0
maxOccurs: senza limiti
Attributi
QName Tipo Fisso Predefinito Utilizzo Annotazione
località facoltativo Una località facoltativa in cui è possibile trovare la definizione del set di dati importato, specificata come URL. Se la località viene omessa, il sistema che elabora questo set di dati DSPL deve già conoscere il set di dati importato. Nota di implementazione: l'importatore di set di dati di Google ignora l'attributo location. Qualsiasi set di dati importato deve essere conosciuto in anticipo dall'importatore Google.
spazio dei nomi obbligatorio Lo spazio dei nomi del set di dati importato, specificato come URI. Per poter fare riferimento ai relativi contenuti, è necessario associare un prefisso allo spazio dei nomi. Per saperne di più sull'uso degli spazi dei nomi e dei prefissi in XML, consulta [spazi dei nomi 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/informazioni

Spazio dei nomi http://schemas.google.com/dspl/2010
Annotazioni Informazioni generali sul set di dati.
Diagramma Diagramma dspl4.tmp#id7 dspl4.tmp#id14 dspl4.tmp#id15 dspl4.tmp#id6
Tipo Informazioni
Proprietà
contenuti: complesso
minOccorre: 1
Modello nome , description{0,1} , url{0,1}
Bambini descrizione, nome, url
Istanza 
<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

Spazio dei nomi http://schemas.google.com/dspl/2010
Annotazioni Informazioni generali sul provider del set di dati.
Diagramma Diagramma dspl4.tmp#id7 dspl4.tmp#id14 dspl4.tmp#id15 dspl4.tmp#id6
Tipo Informazioni
Proprietà
contenuti: complesso
Modello nome , description{0,1} , url{0,1}
Bambini descrizione, nome, url
Istanza 
<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/attributo

Spazio dei nomi http://schemas.google.com/dspl/2010
Annotazioni Attributo associato al set di dati.
Diagramma Diagramma 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 Attributo
Proprietà
contenuti: complesso
minOccorre: 0
maxOccurs: senza limiti
Modello info{0,1} , type{0,1} , (value* | conceptValue{0,1})
Bambini conceptValue, informazioni, tipo, valore
Istanza 
<attribute concept="" id="">
  <info>{0,1}</info>
  <type format="" ref="">{0,1}</type>
</attribute>
Attributi
QName Tipo Fisso Predefinito Utilizzo Annotazione
idea xs:Nome Q facoltativo Un riferimento a un concetto che corrisponde ai valori dell'attributo. Se l'attributo specifica un tipo, il tipo deve corrispondere al tipo del concetto a cui si fa riferimento. Un riferimento a un concetto esterno deve essere nel formato "prefix:other_concept_id", dove "prefix" è il prefisso utilizzato per lo spazio dei nomi del set di dati esterno (vedi gli spazi dei nomi XML).
id ID locale facoltativo L'ID dell'attributo concept. Questo identificatore deve essere univoco all'interno del concetto (per tutti gli attributi e le proprietà). L'ID può essere omesso se è specificato l'attributo concept. In quel caso, un ID è implicitamente creato con valore il nome locale del concetto a cui si fa riferimento. Ad esempio, <attribute concept="unit:currency"/> equivale a <attribute id="currency" concept="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/argomenti

Spazio dei nomi http://schemas.google.com/dspl/2010
Annotazioni Una gerarchia di argomenti utilizzati per organizzare i contenuti del set di dati. L'ordine in cui vengono forniti gli argomenti è significativo e deve essere rispettato dalle visualizzazioni che mostrano questi argomenti.
Diagramma Diagramma dspl9.tmp#id28
Proprietà
contenuti: complesso
minOccorre: 0
Modello argomento+
Bambini argomento
Istanza 
<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

Spazio dei nomi http://schemas.google.com/dspl/2010
Diagramma Diagramma dspl15.tmp#id32 dspl15.tmp#id34 dspl15.tmp#id30 dspl15.tmp#id31 dspl15.tmp#id29
Tipo Argomento
Proprietà
contenuti: complesso
maxOccurs: senza limiti
Modello informazioni, argomento*
Bambini informazioni, argomento
Istanza 
<topic id="" parentTopic="">
  <info>{1,1}</info>
  <topic id="" parentTopic="">{0,unbounded}</topic>
</topic>
Attributi
QName Tipo Fisso Predefinito Utilizzo Annotazione
id ID obbligatorio L'identificatore univoco dell'argomento nel set di dati.
argomento principale xs:Nome Q facoltativo L'ID dell'argomento principale di questo argomento, se disponibile. parentTopic non può essere specificato per gli argomenti incorporati in altri argomenti.
Fonte 
<xs:element name="topic" type="Topic" maxOccurs="unbounded"/>

Elemento: dspl/concetti

Spazio dei nomi http://schemas.google.com/dspl/2010
Annotazioni Un elenco di concetti definiti in questo set di dati.
Diagramma Diagramma dspl9.tmp#id36
Proprietà
contenuti: complesso
minOccorre: 0
Modello concetto+
Bambini idea
Istanza 
<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/concept/concept

Spazio dei nomi http://schemas.google.com/dspl/2010
Diagramma Diagramma 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 Concetto
Proprietà
contenuti: complesso
maxOccurs: senza limiti
Modello informazioni, topic*, type{0,1}, attribute*, proprietà*, defaultValue{0,1}, table{0,1}
Bambini attribute, defaultValue, info, property, tabella, argomento, type
Istanza 
<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>
Attributi
QName Tipo Fisso Predefinito Utilizzo Annotazione
si estende xs:Nome Q facoltativo L'identificatore univoco di un concetto esteso da questo concetto. Il concetto di riferimento può essere definito nello stesso set di dati oppure esternamente, ad esempio in un altro set di dati. Un riferimento a un concetto esterno deve avere il formato "prefix:other_concept_id", dove "prefix" è il prefisso utilizzato per lo spazio dei nomi del set di dati esterno (vedi gli spazi dei nomi XML).
id ID obbligatorio L'identificatore univoco del concetto, che deve essere univoco a livello globale all'interno del set di dati.
Fonte 
<xs:element name="concept" type="Concept" maxOccurs="unbounded"/>

Elemento: dspl / fette

Spazio dei nomi http://schemas.google.com/dspl/2010
Annotazioni Un elenco di sezioni definite in questo set di dati.
Diagramma Diagramma dspl9.tmp#id69
Proprietà
contenuti: complesso
minOccorre: 0
Modello fetta+
Bambini fetta
Istanza 
<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/fette/sezione

Spazio dei nomi http://schemas.google.com/dspl/2010
Diagramma Diagramma dspl2.tmp#id85 dspl2.tmp#id71 dspl2.tmp#id72 dspl2.tmp#id75 dspl2.tmp#id76 dspl2.tmp#id70
Tipo Fetta
Proprietà
contenuti: complesso
maxOccurs: senza limiti
Modello informazioni{0,1} , dimensione+ , metrica+ , tabella
Bambini dimensione, informazioni, metrica, tabella
Istanza 
<slice id="">
  <info>{0,1}</info>
  <dimension concept="">{1,unbounded}</dimension>
  <metric concept="">{1,unbounded}</metric>
  <table ref="">{1,1}</table>
</slice>
Attributi
QName Tipo Fisso Predefinito Utilizzo Annotazione
id ID obbligatorio L'identificatore univoco della sezione.
Fonte 
<xs:element name="slice" type="Slice" maxOccurs="unbounded"/>

Elemento: dspl / tabelle

Spazio dei nomi http://schemas.google.com/dspl/2010
Annotazioni Un elenco di tabelle definite in questo set di dati.
Diagramma Diagramma dspl9.tmp#id87
Proprietà
contenuti: complesso
minOccorre: 0
Modello tabella+
Bambini tabella
Istanza 
<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 / tabelle / tabella

Spazio dei nomi http://schemas.google.com/dspl/2010
Diagramma Diagramma dspl10.tmp#id102 dspl10.tmp#id89 dspl10.tmp#id90 dspl10.tmp#id97 dspl10.tmp#id88
Tipo Tabella
Proprietà
contenuti: complesso
maxOccurs: senza limiti
Modello informazioni{0,1}, colonna+, dati{0,1}
Bambini colonna, dati, informazioni
Istanza 
<table id="">
  <info>{0,1}</info>
  <column format="" id="" type="">{1,unbounded}</column>
  <data>{0,1}</data>
</table>
Attributi
QName Tipo Fisso Predefinito Utilizzo Annotazione
id ID obbligatorio L'identificatore univoco della tabella nel set di dati.
Fonte 
<xs:element name="table" type="Table" maxOccurs="unbounded"/>

Attributo: dspl/import/ @namespace

Spazio dei nomi Nessuno spazio dei nomi
Annotazioni Lo spazio dei nomi del set di dati importato, specificato come URI. Per poter fare riferimento ai contenuti, è necessario associare un prefisso allo spazio dei nomi. Consulta la sezione [Spazi dei nomi XML] per ulteriori informazioni sull'uso degli spazi dei nomi e dei prefissi in XML.
Proprietà
utilizza: obbligatorio
Usato da
Elemento dspl/importazione
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>

Attributo: dspl/import/ @location

Spazio dei nomi Nessuno spazio dei nomi
Annotazioni Una località facoltativa in cui è possibile trovare la definizione del set di dati importato, specificata come URL. Se la località viene omessa, il sistema che elabora questo set di dati DSPL deve già conoscere il set di dati importato. Nota di implementazione: l'importatore di set di dati di Google ignora l'attributo località. Qualsiasi set di dati importato deve essere conosciuto in anticipo dall'importatore Google.
Proprietà
utilizza: facoltativo
Usato da
Elemento dspl/importazione
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>

Attributo: dspl / @targetNamespace

Spazio dei nomi Nessuno spazio dei nomi
Annotazioni Ciascun set di dati può fornire uno spazio dei nomi di destinazione. Lo spazio dei nomi target è un URI che identifica in modo univoco il set di dati. Per ulteriori informazioni sull'uso degli spazi dei nomi in XML, consulta: http://www.w3.org/TR/REC-xml-names/ Se non viene fornito alcun targetNamespace, verrà generato uno spazio dei nomi durante l'importazione del set di dati.
Tipo xs:qualsiasiURI
Proprietà
utilizza: facoltativo
Usato da
Elemento dspl
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>

Creato con l'editor XML oXygen.