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

Пространство имен http://schemas.google.com/dspl/2010
Аннотации Общая информация о наборе данных.
Диаграмма Диаграммаdspl4.tmp#id7dspl4.tmp#id14dspl4.tmp#id15dspl4.tmp#id6
Тип Информация
Характеристики
содержание: сложный
minПроисходит: 1
Модель имя , описание{0,1} , URL{0,1}
Дети описание , имя , адрес
Экземпляр 
<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}
Дети описание , имя , адрес
Экземпляр 
<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
Тип Атрибут
Характеристики
содержание: сложный
minПроисходит: 0
maxПроисходит: неограниченный
Модель информация{0,1} , тип{0,1} , ( значение* | conceptValue{0,1} )
Дети conceptValue , информация , тип , значение
Экземпляр 
<attribute concept="" id="">
  <info>{0,1}</info>
  <type format="" ref="">{0,1}</type>
</attribute>
Атрибуты
QName Тип Зафиксированный По умолчанию Использовать Аннотация
концепция хз: QName необязательный Ссылка на понятие, которое соответствует значениям атрибута. Если атрибут определяет тип, то этот тип должен соответствовать типу понятия, на которое делается ссылка. Ссылка на внешнее понятие должна иметь вид «префикс:идентификатор_другого_понятия», где «префикс» — это префикс, используемый для пространства имен внешнего набора данных (см. Пространства имен 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
Характеристики
содержание: сложный
minПроисходит: 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
Тип Тема
Характеристики
содержание: сложный
maxПроисходит: неограниченный
Модель информация , тема*
Дети информация , тема
Экземпляр 
<topic id="" parentTopic="">
  <info>{1,1}</info>
  <topic id="" parentTopic="">{0,unbounded}</topic>
</topic>
Атрибуты
QName Тип Зафиксированный По умолчанию Использовать Аннотация
я бы Идентификатор обязательный Уникальный идентификатор темы в наборе данных.
родительская тема хз: QName необязательный Идентификатор родительской темы этой темы, если она есть. parentTopic нельзя указать для тем, встроенных в другие темы.
Источник 
<xs:element name="topic" type="Topic" maxOccurs="unbounded"/>

Элемент: dspl /концепты

Пространство имен http://schemas.google.com/dspl/2010
Аннотации Список понятий, определенных в этом наборе данных.
Диаграмма Диаграммаdspl9.tmp#id36
Характеристики
содержание: сложный
minПроисходит: 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 / концепты /концепт

Пространство имен 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
Тип Концепция
Характеристики
содержание: сложный
maxПроисходит: неограниченный
Модель информация , тема* , тип{0,1} , атрибут* , свойство* , defaultValue{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 Тип Зафиксированный По умолчанию Использовать Аннотация
расширяет хз: QName необязательный Уникальный идентификатор концепции, которую расширяет эта концепция. Понятие, на которое делается ссылка, может быть определено в том же наборе данных или внешне, т. е. в другом наборе данных. Ссылка на внешнее понятие должна иметь вид «префикс:идентификатор_другого_понятия», где «префикс» — это префикс, используемый для пространства имен внешнего набора данных (см. Пространства имен XML).
я бы Идентификатор обязательный Уникальный идентификатор понятия, который должен быть глобально уникальным в наборе данных.
Источник 
<xs:element name="concept" type="Concept" maxOccurs="unbounded"/>

Элемент: dspl /срезы

Пространство имен http://schemas.google.com/dspl/2010
Аннотации Список срезов, определенных в этом наборе данных.
Диаграмма Диаграммаdspl9.tmp#id69
Характеристики
содержание: сложный
minПроисходит: 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 / срезы /срез

Пространство имен http://schemas.google.com/dspl/2010
Диаграмма Диаграммаdspl2.tmp#id85dspl2.tmp#id71dspl2.tmp#id72dspl2.tmp#id75dspl2.tmp#id76dspl2.tmp#id70
Тип Кусочек
Характеристики
содержание: сложный
maxПроисходит: неограниченный
Модель информация{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
Характеристики
содержание: сложный
minПроисходит: 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 / таблицы /таблица

Пространство имен http://schemas.google.com/dspl/2010
Диаграмма Диаграммаdspl10.tmp#id102dspl10.tmp#id89dspl10.tmp#id90dspl10.tmp#id97dspl10.tmp#id88
Тип Стол
Характеристики
содержание: сложный
maxПроисходит: неограниченный
Модель информация{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.
Характеристики
использовать: обязательный
Использован
Элемент dspl/импорт
Источник 
<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.
Характеристики
использовать: необязательный
Использован
Элемент dspl/импорт
Источник 
<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/ Если целевое пространство имен не указано, то пространство имен будет создано при импорте набора данных.
Тип хз:любой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 .