Схема DSPL

На этой странице и связанных с ней подстраницах документирована схема XML DSPL. Этот материал предназначен для опытных пользователей, желающих разобраться в низкоуровневых деталях языка; для большинства пользователей содержания Руководства разработчика должно быть достаточно для создания и редактирования наборов данных DSPL.

Полная XML-схема доступна для скачивания в формате XSD на сайте кода DSPL .

Элемент: дспл

Пространство имен http://schemas.google.com/dspl/2010
Аннотации Спецификация DSPL описывает набор данных. Набор данных идентифицируется по его пространству имен. Набор данных состоит из следующих элементов: - Таблицы: данные для понятий и срезов, определенных в наборе данных - Понятия: определяемые пользователем определения и структуры, используемые в наборе данных - Срезы: комбинации измерений и показателей, присутствующих в наборе данных - Темы: Иерархические метки, используемые для организации понятий набора данных.
Диаграмма Диаграммаdspl9.tmp#id103dspl9.tmp#id2dspl9.tmp#id5dspl9.tmp#id16dspl9.tmp#id17dspl9.tmp#id27dspl9.tmp#id35dspl9.tmp#id68dspl9.tmp#id86
Характеристики
содержание: сложный
Модель импорт* , информация , поставщик , атрибут* , темы{0,1} , концепции{0,1} , фрагменты{0,1} , таблицы{0,1}
Дети атрибут , понятия , импорт , информация , поставщик , фрагменты , таблицы , темы
Пример 
<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>
Атрибуты
QName Тип Зафиксированный По умолчанию Использовать Аннотация
целевое пространство имен хз: любойURI необязательный Каждый набор данных может предоставлять целевое пространство имен. Целевое пространство имен — это URI, который уникально идентифицирует набор данных. Дополнительную информацию об использовании пространств имен в XML см. по адресу: http://www.w3.org/TR/REC-xml-names/. Если targetNamespace не указано, то при импорте набора данных будет создано пространство имен.
Источник 
<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>

Элемент: dspl /импорт

Пространство имен http://schemas.google.com/dspl/2010
Аннотации Директива импорта для внешних наборов данных, созданная по образцу директивы импорта схемы XML. Чтобы использовать элементы, определенные во внешнем наборе данных, на внешний набор данных необходимо ссылаться с помощью директивы импорта.
Диаграмма Диаграммаdspl9.tmp#id3dspl9.tmp#id4
Характеристики
содержание: сложный
минПроисходит: 0
МаксПроисходит: неограниченный
Атрибуты
QName Тип Зафиксированный По умолчанию Использовать Аннотация
расположение необязательный Необязательное местоположение, в котором можно найти определение импортированного набора данных, указанное в виде URL-адреса. Если местоположение опущено, система, обрабатывающая этот набор данных DSPL, должна уже знать импортированный набор данных. Примечание по реализации. Импортер набора данных Google игнорирует атрибут местоположения. Любой импортированный набор данных должен быть заранее известен импортеру Google.
пространство имен необходимый Пространство имен импортированного набора данных в виде URI. Префикс должен быть связан с этим пространством имен, прежде чем на его содержимое можно будет ссылаться. См. [Пространства имен XML] для получения дополнительной информации об использовании пространств имен и префиксов в XML.
Источник 
<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>

Элемент: dspl /информация

Пространство имен http://schemas.google.com/dspl/2010
Аннотации Общая информация о наборе данных.
Диаграмма Диаграммаdspl4.tmp#id7dspl4.tmp#id14dspl4.tmp#id15dspl4.tmp#id6
Тип Информация
Характеристики
содержание: сложный
минПроисходит: 1
Модель имя , описание{0,1} , URL{0,1}
Дети описание , название , URL
Пример 
<info>
  <name>{1,1}</name>
  <description>{0,1}</description>
  <url>{0,1}</url>
</info>
Источник 
<xs:element name="info" type="Info" minOccurs="1">
  <xs:annotation>
    <xs:documentation>General information about the dataset.</xs:documentation>
  </xs:annotation>
</xs:element>

Элемент: dspl /провайдер

Пространство имен http://schemas.google.com/dspl/2010
Аннотации Общая информация о поставщике набора данных.
Диаграмма Диаграммаdspl4.tmp#id7dspl4.tmp#id14dspl4.tmp#id15dspl4.tmp#id6
Тип Информация
Характеристики
содержание: сложный
Модель имя , описание{0,1} , URL{0,1}
Дети описание , название , URL
Пример 
<provider>
  <name>{1,1}</name>
  <description>{0,1}</description>
  <url>{0,1}</url>
</provider>
Источник 
<xs:element name="provider" type="Info">
  <xs:annotation>
    <xs:documentation>General information about the dataset provider.</xs:documentation>
  </xs:annotation>
</xs:element>

Элемент: dspl /атрибут

Пространство имен http://schemas.google.com/dspl/2010
Аннотации Атрибут, связанный с набором данных.
Диаграмма Диаграммаdspl14.tmp#id24dspl14.tmp#id26dspl14.tmp#id19dspl14.tmp#id20dspl0.tmp#id10dspl0.tmp#id12dspl0.tmp#id9dspl14.tmp#id18
Тип Атрибут
Характеристики
содержание: сложный
минПроисходит: 0
МаксПроисходит: неограниченный
Модель информация{0,1} , тип{0,1} , ( значение* | ConceptValue{0,1} )
Дети ConceptValue , информация , тип , значение
Пример 
<attribute concept="" id="">
  <info>{0,1}</info>
  <type format="" ref="">{0,1}</type>
</attribute>
Атрибуты
QName Тип Зафиксированный По умолчанию Использовать Аннотация
концепция xs: QName необязательный Ссылка на концепцию, соответствующую значениям атрибута. Если атрибут указывает тип, то этот тип должен соответствовать типу ссылочного понятия. Ссылка на внешнее понятие должна иметь форму «префикс:other_concept_id», где «префикс» — это префикс, используемый для пространства имен внешнего набора данных (см. Пространства имен XML).
идентификатор ЛокальныйИд необязательный Идентификатор атрибута концепции. Этот идентификатор должен быть уникальным в рамках концепции (для атрибутов и свойств). Идентификатор может быть опущен, если указан атрибут концепции. В этом случае идентификатор — это неявно созданный идентификатор со значением локального имени ссылочного понятия. Например, <attribute Concept="unit:currency"/> эквивалентен <attribute id="currency" Concept="unit:currency"/>
Источник 
<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>

Элемент: dspl /темы

Пространство имен http://schemas.google.com/dspl/2010
Аннотации Иерархия тем, используемая для организации содержимого набора данных. Порядок, в котором даны темы, имеет смысл и должен соблюдаться при визуализациях, отображающих эти темы.
Диаграмма Диаграммаdspl9.tmp#id28
Характеристики
содержание: сложный
минПроисходит: 0
Модель тема+
Дети тема
Пример 
<topics>
  <topic id="" parentTopic="">{1,unbounded}</topic>
</topics>
Источник 
<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>

Элемент: dspl / темы /тема

Пространство имен http://schemas.google.com/dspl/2010
Диаграмма Диаграммаdspl15.tmp#id32dspl15.tmp#id34dspl15.tmp#id30dspl15.tmp#id31dspl15.tmp#id29
Тип Тема
Характеристики
содержание: сложный
МаксПроисходит: неограниченный
Модель информация , тема*
Дети информация , тема
Пример 
<topic id="" parentTopic="">
  <info>{1,1}</info>
  <topic id="" parentTopic="">{0,unbounded}</topic>
</topic>
Атрибуты
QName Тип Зафиксированный По умолчанию Использовать Аннотация
идентификатор Идентификатор необходимый Уникальный идентификатор темы в наборе данных.
родительская тема xs: QName необязательный Идентификатор родительской темы этой темы, если она есть. ParentTopic не может быть указан для тем, которые встроены в другие темы.
Источник 
<xs:element name="topic" type="Topic" maxOccurs="unbounded"/>

Элемент: dspl /concepts

Пространство имен http://schemas.google.com/dspl/2010
Аннотации Список понятий, определенных в этом наборе данных.
Диаграмма Диаграммаdspl9.tmp#id36
Характеристики
содержание: сложный
минПроисходит: 0
Модель концепция+
Дети концепция
Пример 
<concepts>
  <concept extends="" id="">{1,unbounded}</concept>
</concepts>
Источник 
<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>

Элемент: dspl / concepts /concept

Пространство имен http://schemas.google.com/dspl/2010
Диаграмма Диаграммаdspl6.tmp#id66dspl6.tmp#id67dspl6.tmp#id38dspl6.tmp#id43dspl6.tmp#id45dspl6.tmp#id47dspl6.tmp#id48dspl6.tmp#id57dspl6.tmp#id58dspl6.tmp#id37
Тип Концепция
Характеристики
содержание: сложный
МаксПроисходит: неограниченный
Модель информация , тема* , тип{0,1} , атрибут* , свойство* , значение по умолчанию{0,1} , таблица{0,1}
Дети атрибут , значение по умолчанию , информация , свойство , таблица , тема , тип
Пример 
<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>
Атрибуты
QName Тип Зафиксированный По умолчанию Использовать Аннотация
простирается xs: QName необязательный Уникальный идентификатор концепции, которую эта концепция расширяет. Упомянутое понятие может быть определено в том же наборе данных или внешне, т. е. в другом наборе данных. Ссылка на внешнее понятие должна иметь форму «префикс:other_concept_id», где «префикс» — это префикс, используемый для пространства имен внешнего набора данных (см. Пространства имен XML).
идентификатор Идентификатор необходимый Уникальный идентификатор концепции, который должен быть глобально уникальным в наборе данных.
Источник 
<xs:element name="concept" type="Concept" maxOccurs="unbounded"/>

Элемент: дспл /ломтики

Пространство имен http://schemas.google.com/dspl/2010
Аннотации Список срезов, определенных в этом наборе данных.
Диаграмма Диаграммаdspl9.tmp#id69
Характеристики
содержание: сложный
минПроисходит: 0
Модель кусочек+
Дети кусочек
Пример 
<slices>
  <slice id="">{1,unbounded}</slice>
</slices>
Источник 
<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>

Элемент: dspl / slices /slice

Пространство имен http://schemas.google.com/dspl/2010
Диаграмма Диаграммаdspl2.tmp#id85dspl2.tmp#id71dspl2.tmp#id72dspl2.tmp#id75dspl2.tmp#id76dspl2.tmp#id70
Тип Срез
Характеристики
содержание: сложный
МаксПроисходит: неограниченный
Модель информация{0,1} , измерение+ , метрика+ , таблица
Дети измерение , информация , метрика , таблица
Пример 
<slice id="">
  <info>{0,1}</info>
  <dimension concept="">{1,unbounded}</dimension>
  <metric concept="">{1,unbounded}</metric>
  <table ref="">{1,1}</table>
</slice>
Атрибуты
QName Тип Зафиксированный По умолчанию Использовать Аннотация
идентификатор Идентификатор необходимый Уникальный идентификатор среза.
Источник 
<xs:element name="slice" type="Slice" maxOccurs="unbounded"/>

Элемент: dspl /таблицы

Пространство имен http://schemas.google.com/dspl/2010
Аннотации Список таблиц, определенных в этом наборе данных.
Диаграмма Диаграммаdspl9.tmp#id87
Характеристики
содержание: сложный
минПроисходит: 0
Модель стол+
Дети стол
Пример 
<tables>
  <table id="">{1,unbounded}</table>
</tables>
Источник 
<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>

Элемент: dspl / tables /table

Пространство имен http://schemas.google.com/dspl/2010
Диаграмма Диаграммаdspl10.tmp#id102dspl10.tmp#id89dspl10.tmp#id90dspl10.tmp#id97dspl10.tmp#id88
Тип Стол
Характеристики
содержание: сложный
МаксПроисходит: неограниченный
Модель информация{0,1} , столбец+ , данные{0,1}
Дети столбец , данные , информация
Пример 
<table id="">
  <info>{0,1}</info>
  <column format="" id="" type="">{1,unbounded}</column>
  <data>{0,1}</data>
</table>
Атрибуты
QName Тип Зафиксированный По умолчанию Использовать Аннотация
идентификатор Идентификатор необходимый Уникальный идентификатор таблицы в наборе данных.
Источник 
<xs:element name="table" type="Table" maxOccurs="unbounded"/>

Атрибут: dspl / import /@namespace

Пространство имен Нет пространства имен
Аннотации Пространство имен импортированного набора данных в виде URI. Префикс должен быть связан с этим пространством имен, прежде чем на его содержимое можно будет ссылаться. См. [Пространства имен XML] для получения дополнительной информации об использовании пространств имен и префиксов в XML.
Характеристики
использовать: необходимый
Используется
Элемент дспл/импорт
Источник 
<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>

Атрибут: dspl / import /@location

Пространство имен Нет пространства имен
Аннотации Необязательное местоположение, в котором можно найти определение импортированного набора данных, указанное в виде URL-адреса. Если местоположение опущено, система, обрабатывающая этот набор данных DSPL, должна уже знать импортированный набор данных. Примечание по реализации. Импортер набора данных Google игнорирует атрибут местоположения. Любой импортированный набор данных должен быть заранее известен импортеру Google.
Характеристики
использовать: необязательный
Используется
Элемент дспл/импорт
Источник 
<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>

Атрибут: dspl / @targetNamespace

Пространство имен Нет пространства имен
Аннотации Каждый набор данных может предоставлять целевое пространство имен. Целевое пространство имен — это URI, который уникально идентифицирует набор данных. Дополнительную информацию об использовании пространств имен в XML см. по адресу: http://www.w3.org/TR/REC-xml-names/. Если targetNamespace не указано, то при импорте набора данных будет создано пространство имен.
Тип хз: любойURI
Характеристики
использовать: необязательный
Используется
Элемент ДСПЛ
Источник 
<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>

Создано с помощью XML-редактора oXygen .