Schemat DSPL

Ta strona i powiązane z nią podstrony dokumentują schemat XML DSPL. Ten materiał jest przeznaczony dla zaawansowanych użytkowników, którzy chcą zrozumieć ogólne informacje na temat języka. Dla większości użytkowników materiały w przewodniku dla programistów powinny wystarczyć do tworzenia i edytowania zbiorów danych DSPL.

Pełny schemat XML jest dostępny do pobrania w formacie XSD ze strony kodu DSPL.

Element: dspl

Przestrzeń nazw http://schemas.google.com/dspl/2010
Adnotacje Specyfikacja DSPL opisuje zbiór danych. Zbiór danych jest identyfikowany przez jego przestrzeń nazw. Zbiór danych składa się z tych elementów: – tabele – dane dotyczące pojęć i wycinków zdefiniowanych w zbiorze danych – pojęcia: definicje i struktury określone przez użytkownika w zbiorze danych – wycinki: kombinacje wymiarów i danych obecnych w zbiorze danych – tematy: etykiety hierarchiczne używane do porządkowania koncepcji zbioru danych
Diagram Diagram 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
Właściwości
treść: Złożone
Model import* , info , dostawca , attribute* , tematy{0,1} , koncepcje{0,1} , wycinki{0,1} , tabele{0,1}
Dzieci atrybut, koncepcje, import, informacje, dostawca, wycinki, tabele, tematy
Instancja 
<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>
Atrybuty
QName Typ Naprawiono Domyślna Użyj Adnotacja
targetNamespace xs:anyURI opcjonalnie Każdy zbiór danych może mieć docelową przestrzeń nazw. Docelowa przestrzeń nazw to identyfikator URI, który jednoznacznie identyfikuje zbiór danych. Więcej informacji o użyciu przestrzeni nazw w pliku XML znajdziesz na stronie: http://www.w3.org/TR/REC-xml-names/ Jeśli nie podano docelowego obszaru nazw, przestrzeń nazw zostanie wygenerowana po zaimportowaniu zbioru danych.
Źródło 
<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>

Element: dspl / import

Przestrzeń nazw http://schemas.google.com/dspl/2010
Adnotacje Dyrektywa importu dla zewnętrznych zbiorów danych – modelowana na podstawie dyrektywy importowania schematu XML. Aby można było używać elementów zdefiniowanych w zewnętrznym zbiorze danych, należy się do niego odwoływać za pomocą dyrektywy importu.
Diagram Diagram dspl9.tmp#id3 dspl9.tmp#id4
Właściwości
treść: Złożone
min.: 0
maxOccurs: nieograniczony
Atrybuty
QName Typ Naprawiono Domyślna Użyj Adnotacja
lokalizacja opcjonalnie Opcjonalna lokalizacja, w której można znaleźć definicję zaimportowanego zbioru danych, określona jako adres URL. Jeśli lokalizacja zostanie pominięta, system przetwarzający ten zbiór danych DSPL musi już znać zaimportowany zbiór danych. Uwaga dotycząca implementacji: importer zbioru danych Google ignoruje atrybut lokalizacji. Każdy zaimportowany zbiór danych musi być wcześniej znany importerowi Google.
przestrzeń nazw wymagane Przestrzeń nazw zaimportowanego zbioru danych określona jako identyfikator URI. Aby można było odwoływać się do jej zawartości, trzeba powiązać prefiks z tą przestrzenią nazw. Więcej informacji o użyciu przestrzeni nazw i prefiksów w pliku XML znajdziesz w sekcji [Przestrzenie nazw XML].
Źródło 
<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>

Element: dspl / info

Przestrzeń nazw http://schemas.google.com/dspl/2010
Adnotacje Ogólne informacje o zbiorze danych.
Diagram Diagram dspl4.tmp#id7 dspl4.tmp#id14 dspl4.tmp#id15 dspl4.tmp#id6
Typ Informacje
Właściwości
treść: Złożone
min.: 1
Model name , description{0,1} , url{0,1}
Dzieci description, name, url
Instancja 
<info>
  <name>{1,1}</name>
  <description>{0,1}</description>
  <url>{0,1}</url>
</info>
Źródło 
<xs:element name="info" type="Info" minOccurs="1">
  <xs:annotation>
    <xs:documentation>General information about the dataset.</xs:documentation>
  </xs:annotation>
</xs:element>

Element: dspl / dostawca

Przestrzeń nazw http://schemas.google.com/dspl/2010
Adnotacje Ogólne informacje o dostawcy zbioru danych.
Diagram Diagram dspl4.tmp#id7 dspl4.tmp#id14 dspl4.tmp#id15 dspl4.tmp#id6
Typ Informacje
Właściwości
treść: Złożone
Model name , description{0,1} , url{0,1}
Dzieci description, name, url
Instancja 
<provider>
  <name>{1,1}</name>
  <description>{0,1}</description>
  <url>{0,1}</url>
</provider>
Źródło 
<xs:element name="provider" type="Info">
  <xs:annotation>
    <xs:documentation>General information about the dataset provider.</xs:documentation>
  </xs:annotation>
</xs:element>

Element: dspl / atrybut

Przestrzeń nazw http://schemas.google.com/dspl/2010
Adnotacje Atrybut powiązany ze zbiorem danych.
Diagram Diagram dspl14.tmp#id24 dspl14.tmp#id26 dspl14.tmp#id19 dspl14.tmp#id20 dspl0.tmp#id10 dspl0.tmp#id12 dspl0.tmp#id9 dspl14.tmp#id18
Typ Atrybut
Właściwości
treść: Złożone
min.: 0
maxOccurs: nieograniczony
Model info{0,1} , type{0,1} , (value* | ConceptValue{0,1})
Dzieci conceptValue, info, type oraz value
Instancja 
<attribute concept="" id="">
  <info>{0,1}</info>
  <type format="" ref="">{0,1}</type>
</attribute>
Atrybuty
QName Typ Naprawiono Domyślna Użyj Adnotacja
koncepcja xs:QName opcjonalnie Odniesienie do pojęcia, który odpowiada wartościom atrybutu. Jeśli atrybut określa typ, to typ musi być zgodny z typem wskazanego koncepcji. Odniesienie do zewnętrznej koncepcji musi mieć postać „prefix:other_Concept_id”, gdzie „prefiks” to prefiks używany przez przestrzeń nazw zewnętrznego zbioru danych (patrz: przestrzenie nazw XML).
id LocalId opcjonalnie Identyfikator atrybutu koncepcja. Ten identyfikator musi być unikalny w obrębie danej koncepcji (w obrębie atrybutów i właściwości). Identyfikator można pominąć, jeśli określono atrybut Concept. W tym przypadku identyfikator to prostota utworzona z wartością lokalną nazwę odniesienia. Na przykład atrybut <attribute Concept="unit:currency"/> jest odpowiednikiem atrybutu <attribute id="currency" Concept="unit:currency"/>
Źródło 
<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>

Element: dspl / tematy

Przestrzeń nazw http://schemas.google.com/dspl/2010
Adnotacje Hierarchia tematów używanych do porządkowania zawartości zbioru danych. Kolejność, w jakiej są podawane tematy, ma znaczenie i należy ją uwzględniać w wizualizacjach przedstawiających te tematy.
Diagram Diagram dspl9.tmp#id28
Właściwości
treść: Złożone
min.: 0
Model topic+,
Dzieci temat
Instancja 
<topics>
  <topic id="" parentTopic="">{1,unbounded}</topic>
</topics>
Źródło 
<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>

Element: dspl / tematy / temat

Przestrzeń nazw http://schemas.google.com/dspl/2010
Diagram Diagram dspl15.tmp#id32 dspl15.tmp#id34 dspl15.tmp#id30 dspl15.tmp#id31 dspl15.tmp#id29
Typ Temat
Właściwości
treść: Złożone
maxOccurs: nieograniczony
Model info , topic*
Dzieci info, topic
Instancja 
<topic id="" parentTopic="">
  <info>{1,1}</info>
  <topic id="" parentTopic="">{0,unbounded}</topic>
</topic>
Atrybuty
QName Typ Naprawiono Domyślna Użyj Adnotacja
id Identyfikator wymagane Unikalny identyfikator tematu w zbiorze danych.
parentTopic xs:QName opcjonalnie Identyfikator tematu nadrzędnego danego tematu, jeśli taki istnieje. Nie można określić parametru nadrzędnyTopic w przypadku tematów, które są wstawiane w inne tematy.
Źródło 
<xs:element name="topic" type="Topic" maxOccurs="unbounded"/>

Element: dspl / pojęcia

Przestrzeń nazw http://schemas.google.com/dspl/2010
Adnotacje Lista pojęć zdefiniowanych w tym zbiorze danych.
Diagram Diagram dspl9.tmp#id36
Właściwości
treść: Złożone
min.: 0
Model Concept+
Dzieci koncepcja
Instancja 
<concepts>
  <concept extends="" id="">{1,unbounded}</concept>
</concepts>
Źródło 
<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>

Element: dspl / koncepcje / koncepcja

Przestrzeń nazw http://schemas.google.com/dspl/2010
Diagram Diagram 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
Typ Koncepcja
Właściwości
treść: Złożone
maxOccurs: nieograniczony
Model info , topic* , type{0,1} , attribute* , property* , defaultValue{0,1} , table{0,1}
Dzieci attribute, defaultValue, info, property, table, topic, type
Instancja 
<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>
Atrybuty
QName Typ Naprawiono Domyślna Użyj Adnotacja
extends xs:QName opcjonalnie Unikalny identyfikator pojęcia, do którego odnosi się ta koncepcja. Przywołane pojęcie może być zdefiniowane w tym samym zbiorze danych lub zewnętrznie, np. w innym zbiorze danych. Odniesienie do zewnętrznej koncepcji musi mieć postać „prefiks:inna_koncepcja_id”, gdzie „prefiks” to prefiks używany przez przestrzeń nazw zewnętrznego zbioru danych (patrz: przestrzenie nazw XML).
id Identyfikator wymagane Unikalny identyfikator koncepcji, który musi być globalnie unikalny w obrębie zbioru danych.
Źródło 
<xs:element name="concept" type="Concept" maxOccurs="unbounded"/>

Element: dspl / wycinki

Przestrzeń nazw http://schemas.google.com/dspl/2010
Adnotacje Lista wycinków zdefiniowanych w tym zbiorze danych.
Diagram Diagram dspl9.tmp#id69
Właściwości
treść: Złożone
min.: 0
Model wycinek+
Dzieci wycinek
Instancja 
<slices>
  <slice id="">{1,unbounded}</slice>
</slices>
Źródło 
<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>

Element: dspl / slices / wycinek

Przestrzeń nazw http://schemas.google.com/dspl/2010
Diagram Diagram dspl2.tmp#id85 dspl2.tmp#id71 dspl2.tmp#id72 dspl2.tmp#id75 dspl2.tmp#id76 dspl2.tmp#id70
Typ Wycinek
Właściwości
treść: Złożone
maxOccurs: nieograniczony
Model info{0,1} , wymiar+ , dane+, tabela
Dzieci wymiar, informacje, dane, tabela
Instancja 
<slice id="">
  <info>{0,1}</info>
  <dimension concept="">{1,unbounded}</dimension>
  <metric concept="">{1,unbounded}</metric>
  <table ref="">{1,1}</table>
</slice>
Atrybuty
QName Typ Naprawiono Domyślna Użyj Adnotacja
id Identyfikator wymagane Unikalny identyfikator wycinka.
Źródło 
<xs:element name="slice" type="Slice" maxOccurs="unbounded"/>

Element: dspl / tabele

Przestrzeń nazw http://schemas.google.com/dspl/2010
Adnotacje Lista tabel zdefiniowanych w tym zbiorze danych.
Diagram Diagram dspl9.tmp#id87
Właściwości
treść: Złożone
min.: 0
Model tabela+
Dzieci tabela
Instancja 
<tables>
  <table id="">{1,unbounded}</table>
</tables>
Źródło 
<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>

Element: dspl / tables / table

Przestrzeń nazw http://schemas.google.com/dspl/2010
Diagram Diagram dspl10.tmp#id102 dspl10.tmp#id89 dspl10.tmp#id90 dspl10.tmp#id97 dspl10.tmp#id88
Typ Tabela
Właściwości
treść: Złożone
maxOccurs: nieograniczony
Model info{0,1} , column+ , data{0,1}
Dzieci kolumna, dane, informacje
Instancja 
<table id="">
  <info>{0,1}</info>
  <column format="" id="" type="">{1,unbounded}</column>
  <data>{0,1}</data>
</table>
Atrybuty
QName Typ Naprawiono Domyślna Użyj Adnotacja
id Identyfikator wymagane Unikalny identyfikator tabeli w zbiorze danych.
Źródło 
<xs:element name="table" type="Table" maxOccurs="unbounded"/>

Atrybut: dspl / import / @namespace

Przestrzeń nazw Brak przestrzeni nazw
Adnotacje Przestrzeń nazw zaimportowanego zbioru danych określona jako identyfikator URI. Aby można było odwoływać się do jej zawartości, musisz powiązać prefiks z tą przestrzenią nazw. Więcej informacji o użyciu przestrzeni nazw i prefiksów w pliku XML znajdziesz w sekcji [Przestrzenie nazw XML].
Właściwości
użyj: wymagane
Używane przez
Element dspl/import
Źródło 
<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>

Atrybut: dspl / import / @location

Przestrzeń nazw Brak przestrzeni nazw
Adnotacje Opcjonalna lokalizacja, w której można znaleźć definicję zaimportowanego zbioru danych, określona jako adres URL. Jeśli lokalizacja zostanie pominięta, system przetwarzający ten zbiór danych DSPL musi już znać zaimportowany zbiór danych. Uwaga dotycząca implementacji: importujący zbiór danych Google ignoruje atrybut lokalizacji. Każdy zaimportowany zbiór danych musi być wcześniej znany importerowi Google.
Właściwości
użyj: opcjonalnie
Używane przez
Element dspl/import
Źródło 
<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>

Atrybut: dspl / @targetNamespace

Przestrzeń nazw Brak przestrzeni nazw
Adnotacje Każdy zbiór danych może mieć docelową przestrzeń nazw. Docelowa przestrzeń nazw to identyfikator URI, który jednoznacznie identyfikuje zbiór danych. Więcej informacji o użyciu przestrzeni nazw w pliku XML znajdziesz na stronie: http://www.w3.org/TR/REC-xml-names/ Jeśli nie podano docelowego obszaru nazw, przestrzeń nazw zostanie wygenerowana po zaimportowaniu zbioru danych.
Typ xs:anyURI
Właściwości
użyj: opcjonalnie
Używane przez
Element dspl,
Źródło 
<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>

Utworzono za pomocą oXygen XML Editor.