סכימת DSPL

הדף הזה ודפי המשנה המקושרים שלו מתעדים את סכימת ה-XML של DSPL. התוכן הזה מיועד למשתמשים מתקדמים שרוצים להבין פרטים ברמה נמוכה של השפה. רוב המשתמשים צריכים לקרוא את המדריך למפתחים כדי ליצור ולערוך מערכי נתונים של DSPL.

סכימת ה-XML המלאה זמינה להורדה בפורמט XSD באתר קוד DSPL.

אלמנט: dspl

מרחב שמות http://schemas.google.com/dspl/2010
הערות מפרט של DSPL מתאר מערך נתונים. מערך הנתונים מזוהה על ידי מרחב השמות שלו. מערך נתונים מורכב מהרכיבים הבאים: – טבלאות: נתונים עבור הקונספטים והפלחים המוגדרים במערך הנתונים – מושגים: הגדרות ומבנים ספציפיים שצוינו במערך הנתונים – פרוסות: שילובים של מאפיינים ומדדים שנמצאים במערך הנתונים – נושאים: תוויות היררכיות המשמשות לארגון הערכים של מערך הנתונים
דיאגרמה דיאגרמה dpl9.tmp#id103 dpl9.tmp#id2 dpl9.tmp#id5 dpl9.tmp#id16 dpl9.tmp#id7 dpl9.tmp#id27 dpl9.tmp#id35 dpl9.tmp#id68 dpl9.tmp#id86
נכסים
תוכן: מורכב
דגם Import* , info , provider , attribute* , topics{0,1} , concepts{0,1} , slices{0,1} , tables{0,1}
ילדים מאפיין, קונספטים, ייבוא, מידע, ספק, slices, טבלאות, נושאים
Instance 
<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>
מאפיינים
שם סוג קבוע ברירת מחדל שימוש הערה
targetNamespace xs:anyURI אופציונלי כל מערך נתונים יכול לספק מרחב שמות ייעודי. מרחב השמות של היעד הוא URI שמזהה את מערך הנתונים באופן ייחודי. למידע נוסף על השימוש במרחבי שמות ב-XML, אפשר לעיין במאמר הבא: http://www.w3.org/TR/REC-xml-names/ אם לא יסופק מרחב שמות Name, ייווצר מרחב שמות כשמייבאים את מערך הנתונים.
מקור 
<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. כדי להשתמש ברכיבים שמוגדרים במערך נתונים חיצוני, צריך להפנות למערך הנתונים החיצוני באמצעות הנחיית ייבוא.
דיאגרמה דיאגרמה dpl9.tmp#id3 dpl9.tmp#id4
נכסים
תוכן: מורכב
minOccurs: 0
maxOccurs: ללא הבחנה
מאפיינים
שם סוג קבוע ברירת מחדל שימוש הערה
מיקום אופציונלי מיקום אופציונלי שבו ניתן למצוא את ההגדרה של מערך הנתונים המיובא, שמצוין ככתובת URL. אם לא תכללו את המיקום, מערך הנתונים שמטפל ב-DSPL חייב להכיר את מערך הנתונים שיובא. הערה להטמעה: כלי הייבוא של מערכי הנתונים של Google מתעלם ממאפיין המיקום. היבואן של Google חייב להכיר את מערכי הנתונים המיובאים מראש.
namespace חובה מרחב השמות של מערך הנתונים שיובא, שצוין כ-URI. צריך לשייך את הקידומת למרחב השמות הזה לפני שאפשר יהיה להפנות לתוכן שלה. פרטים נוספים על השימוש במרחבי שמות ובקידומות ב-XML מפורטים ב-[XML Namespaces].
מקור 
<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
הערות מידע כללי על מערך הנתונים
דיאגרמה דיאגרמה dpl4.tmp#id7 dpl4.tmp#id14 dpl4.tmp#id15 dpl4.tmp#id6
סוג מידע
נכסים
תוכן: מורכב
minOccurs: 1
דגם name , description{0,1} , url{0,1}
ילדים description [תיאור], name [שם], url [כתובת_URL]
Instance 
<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
הערות מידע כללי על ספק מערך הנתונים
דיאגרמה דיאגרמה dpl4.tmp#id7 dpl4.tmp#id14 dpl4.tmp#id15 dpl4.tmp#id6
סוג מידע
נכסים
תוכן: מורכב
דגם name , description{0,1} , url{0,1}
ילדים description [תיאור], name [שם], url [כתובת_URL]
Instance 
<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
הערות מאפיין המשויך למערך הנתונים.
דיאגרמה דיאגרמה dpl14.tmp#id4 dpl14.tmp#id66 dpl14.tmp#id19 dpl14.tmp#id20 dpl0.tmp#id10 dpl0.tmp#id12 dpl0.tmp#id9 dpl14.tmp#id18
סוג מאפיין
נכסים
תוכן: מורכב
minOccurs: 0
maxOccurs: ללא הבחנה
דגם info{0,1} , type{0,1} , (value* | conceptValue{0,1})
ילדים conceptValue, info, type, value
Instance 
<attribute concept="" id="">
  <info>{0,1}</info>
  <type format="" ref="">{0,1}</type>
</attribute>
מאפיינים
שם סוג קבוע ברירת מחדל שימוש הערה
קונספט xs:QName אופציונלי הפניה לקונספט שתואם לערכים של המאפיין. אם המאפיין מציין סוג, הסוג צריך להיות תואם לסוג הקונספט שאליו מתייחסים. ההתייחסות לקונספט חיצוני צריכה להיות בפורמט "prefix:other_concept_id", כאשר "prefix" הוא הקידומת של מרחב השמות החיצוני של מערך הנתונים החיצוני (פרטים של מרחבי שמות מסוג XML).
id LocalId אופציונלי מזהה מאפיין הקונספט. המזהה הזה צריך להיות ייחודי בתוך הקונספט (בכל המאפיינים והמאפיינים). אם המאפיין קונספט מופיע, אפשר להשמיט את המזהה. במקרה כזה, מזהה הוא פשטות שנוצרה עם ערך השם המקומי של הקונספט המדובר. לדוגמה, המאפיין <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
הערות היררכיה של נושאים שמשמשים לארגון התוכן של מערך הנתונים. הסדר שבו הנושאים מוצגים הוא משמעותי ויש לכבד אותם באמצעות תצוגות חזותיות שמציגות את הנושאים האלה.
דיאגרמה דיאגרמה dpl9.tmp#id28
נכסים
תוכן: מורכב
minOccurs: 0
דגם topic+
ילדים topic
Instance 
<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 / topics / topic

מרחב שמות http://schemas.google.com/dspl/2010
דיאגרמה דיאגרמה dpl15.tmp#id32 dpl15.tmp#id34 dpl15.tmp#id30 dpl15.tmp#id31 dpl15.tmp#id29
סוג נושא
נכסים
תוכן: מורכב
maxOccurs: ללא הבחנה
דגם info , topic*
ילדים מידע, נושא
Instance 
<topic id="" parentTopic="">
  <info>{1,1}</info>
  <topic id="" parentTopic="">{0,unbounded}</topic>
</topic>
מאפיינים
שם סוג קבוע ברירת מחדל שימוש הערה
id מזהה חובה המזהה הייחודי של הנושא במערך הנתונים.
parentTopic xs:QName אופציונלי מזהה הנושא הראשי של הנושא הזה, אם יש לו נושא כזה. לא ניתן לציין הורה לגבי נושאים שבתוך נושאים אחרים.
מקור 
<xs:element name="topic" type="Topic" maxOccurs="unbounded"/>

רכיב: dspl / מושגים

מרחב שמות http://schemas.google.com/dspl/2010
הערות רשימת מושגים שהוגדרו במערך הנתונים הזה.
דיאגרמה דיאגרמה dpl9.tmp#id36
נכסים
תוכן: מורכב
minOccurs: 0
דגם קונספט +
ילדים קונספט
Instance 
<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>

הרכיב: קונספט / קונספט / קונספט

מרחב שמות http://schemas.google.com/dspl/2010
דיאגרמה דיאגרמה dpl6.tmp#id66 dpl6.tmp#id77 dpl6.tmp#id38 dpl6.tmp#id33 dpl6.tmp#id55 dpl6.tmp#id77 dpl6.tmp#id48 dpl6.tmp#id57 dpl6.tmp#id58 dpl6.tmp#id37
סוג קונספט
נכסים
תוכן: מורכב
maxOccurs: ללא הבחנה
דגם info , topic* , type{0,1} , attribute* , property* , defaultValue{0,1} , table{0,1}
ילדים attribute, defaultValue, info, המאפיין, table, topic, type
Instance 
<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>
מאפיינים
שם סוג קבוע ברירת מחדל שימוש הערה
מאריך xs:QName אופציונלי המזהה הייחודי של מושג מסוים שעל פיו מתייחס התוכן. אפשר להגדיר את הקונספט שאליו בוצעה הפניה באותו מערך נתונים, או מחוץ לו, כלומר במערך נתונים אחר. ההתייחסות לקונספט חיצוני צריכה להיות בצורה "prefix:other_concept_id", כש-"prefix" הוא הקידומת שבה נעשה שימוש במרחב השמות של מערך הנתונים החיצוני (מידע נוסף על מרחבי שמות של XML).
id מזהה חובה המזהה הייחודי של הקונספט, שצריך להיות ייחודי גלובלית במערך הנתונים.
מקור 
<xs:element name="concept" type="Concept" maxOccurs="unbounded"/>

רכיב: dspl / פרוסות

מרחב שמות http://schemas.google.com/dspl/2010
הערות רשימה של פרוסות המוגדרות במערך הנתונים הזה.
דיאגרמה דיאגרמה dpl9.tmp#id69
נכסים
תוכן: מורכב
minOccurs: 0
דגם slice+
ילדים פרוסה
Instance 
<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 / פרוסה

מרחב שמות http://schemas.google.com/dspl/2010
דיאגרמה דיאגרמה dpl2.tmp#id55 dpl2.tmp#id71 dpl2.tmp#id72 dpl2.tmp#id55 dpl2.tmp#id76 dpl2.tmp#id70
סוג פרוסה
נכסים
תוכן: מורכב
maxOccurs: ללא הבחנה
דגם info{0,1} , dimension+ , measure+ , table
ילדים מאפיין, מידע, ערך, טבלה
Instance 
<slice id="">
  <info>{0,1}</info>
  <dimension concept="">{1,unbounded}</dimension>
  <metric concept="">{1,unbounded}</metric>
  <table ref="">{1,1}</table>
</slice>
מאפיינים
שם סוג קבוע ברירת מחדל שימוש הערה
id מזהה חובה המזהה הייחודי של הפלח.
מקור 
<xs:element name="slice" type="Slice" maxOccurs="unbounded"/>

הרכיב: dspl / טבלאות

מרחב שמות http://schemas.google.com/dspl/2010
הערות רשימה של טבלאות המוגדרות במערך הנתונים הזה.
דיאגרמה דיאגרמה dpl9.tmp#id87
נכסים
תוכן: מורכב
minOccurs: 0
דגם table+
ילדים table
Instance 
<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 / טבלה

מרחב שמות http://schemas.google.com/dspl/2010
דיאגרמה דיאגרמה dpl10.tmp#id102 dpl10.tmp#id89 dpl10.tmp#id90 dpl10.tmp#id97 dpl10.tmp#id88
סוג טבלה
נכסים
תוכן: מורכב
maxOccurs: ללא הבחנה
דגם info{0,1}, column+, data{0,1}
ילדים column, data, info
Instance 
<table id="">
  <info>{0,1}</info>
  <column format="" id="" type="">{1,unbounded}</column>
  <data>{0,1}</data>
</table>
מאפיינים
שם סוג קבוע ברירת מחדל שימוש הערה
id מזהה חובה המזהה הייחודי של הטבלה במערך הנתונים.
מקור 
<xs:element name="table" type="Table" maxOccurs="unbounded"/>

מאפיין: dspl / import / @namespace

מרחב שמות אין מרחב שמות
הערות מרחב השמות של מערך הנתונים המיובא, שצוין כ-URI. צריך לשייך קידומת למרחב השמות הזה לפני שאפשר יהיה להפנות לתוכן שלו. פרטים נוספים על השימוש במרחבי שמות ובקידומות ב-XML מפורטים ב-[XML Namespaces] .
נכסים
משתמשים: חובה
בשימוש על ידי
רכיב dspl/Import
מקור 
<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/Import
מקור 
<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/ אם לא יסופק מרחב שמות שם, ייווצר מרחב שמות כשמייבאים את מערך הנתונים.
סוג xs:anyURI
נכסים
משתמשים: אופציונלי
בשימוש על ידי
רכיב dspl
מקור 
<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>

נוצר באמצעות OXygen XML Editor.