DSPL 食譜集

本文件內含實用的 DSPL 和標準概念教戰手冊 「食譜」。這些工具能逐步引導您 實作基本語言功能 教學課程和開發人員指南。內容 以下假設您已熟悉前述文件，因此請務必詳讀 然後再開始「烹飪」

每個方案都是以目標開頭，接下來是指向特定訓練步驟清單的具體步驟清單。 後續追蹤。其中許多網址也包含 DSPL 程式碼片段或外部範例連結。如果發生以下情況： 有任何關於食譜的意見或想推薦其他人嗎？請張貼 DSPL 論壇中的訊息。

基本食譜

指定顯示名稱

目標

連結「顯示名稱」每個 (維度) 的每個例項 概念這些名稱會顯示在 Public Data Explorer UI 中，而不是 概念執行個體 ID，這類 ID 通常較短，較不容易 好瞭解。

步驟

  1. 讓概念延伸 entity:entity.
  2. 將 name 欄新增至相關的概念定義 表格。
  3. 將每個執行個體的名稱填入後者屬性。

附註

  • 您不需要在name 您的概念中繼資料系統就會自動納入該定義 可擴充 entity:entity。
  • 你也可以新增description和info_url 資料欄，分別提供執行個體層級的說明和網址。

建立概念階層

目標

建立階層 (維度) 概念。這些資訊會顯示在 以樹狀結構表示的公開資料瀏覽器使用者介面，可讓使用者瞭解分組 並在各個帳戶間瀏覽

步驟

  1. 定義「父項」概念 (例如region)。
  2. 定義「子項」概念 (例如subregion)。
  3. 在參照父項的子項中新增屬性，並包含 isParent 屬性： 
    <property concept="..." isParent="true"/>
    其中的點會替換成父項 ID。
  4. 在子項的定義表格中，新增參照 父項。
  5. 針對每個子項例項，在後者中填入有效的 父項概念

附註

  • 請參見 country / state 關係 教學課程資料集： 例如這樣
  • 從子項參照的每個父項 ID 都必須位於父項的 定義資料表否則，匯入程式會產生錯誤。
  • 父項和子項屬於同一概念 (即自我參照) 階層)。如要瞭解 business 概念，請參閱 美國零售銷售資料集 舉例來說

將概念執行個體分類

目標

為概念執行個體建立類別，這些類別會顯示為選項 公開資料瀏覽器顏色挑選器中的選項。

步驟

  1. 定義「類別」概念 (例如income_level)。
  2. 定義「子項」概念 (例如country)。
  3. 在參照類別概念的子項中新增屬性 包含 name 元素： 
    <property concept="..."/>
  <info>
    <name><value>"..."</value></name>
  </info>
</property>
    第一組點會換成類別概念 ID， 第二個組合會替換為資源所需的顯示名稱 (例如：「收入等級」)。
  4. 在子項的定義表格中，新增參照 類別概念
  5. 針對每個子項例項，在後者中填入有效的 和類別概念

附註

  • 一個概念可包含多個屬性做為類別；在此流程的各個階段 這時顏色挑選器中就會列出所有選項。
  • 其中一個類別也可以是上層 在使用者介面中以階層方式整理執行個體。請參閱上一首 最佳方式

指定概念執行個體的排序順序

目標

指定概念例項的排序順序。這個順序會在以下時機使用： 在「公開資料瀏覽器」的左側導覽列中列出執行個體 圖表中

步驟

  1. 擴展您的概念，或是擴充 entity:entity 的概念 子項 (例如geo:location)。
  2. 將 entity_order 屬性新增至概念中繼資料。
  3. 將先前的值設為 ALPHA 或 TABLE；前者會使執行個體 而後者會保留執行個體 名稱與概念定義表中顯示的順序相同

附註

時間食譜

每季資料

目標

將每季指定的資料視覺化。

步驟

  1. 將配量資料中的所有季度轉換為月 (例如 每季的第一月)。
  2. 將這個維度視為片段中的 time:month XML

每週資料

目標

將每週間隔指定的資料視覺化。

步驟

  1. 將配量資料中所有週別轉換成天數 (例如， 。
  2. 請在切片 XML 中將此維度視為 time:day。

地理食譜

正在使用 country 或 state 標準概念

目標

請使用 country 或 state 標準概念。 匯入所有經緯度值等 特定屬性

步驟

  1. 請確認國家/地區及/或美國各州的參考資料 配量資料 CSV 是標準國家/地區中的有效 ID， 州/省 定義資料表
  2. 將 geo:country 和/或 geo_us:state 新增為 指定對應的尺寸
  3. 請確認這些資料欄的名稱與名稱相符 共通概念 (不包括匯入的資料集名稱，例如 country)，如果沒有，請加入 mapDimension 陳述式範例： 
    <slice id="...">
  ...
  <dimension concept="geo:country"/>
  ...
  <mapDimension concept="geo:country" toColumn="my_country"/>
</slice>

只使用部分標準國家/地區，或是 州

目標

使用標準地理概念的子集，僅確保目標子集 整份清單 (例如全球所有國家/地區) Data Explorer 使用者介面。

步驟

  1. 定義延伸超集合概念的本機概念。範例： 
    <concept id="my_country_subset" extends="geo:country">
...
</concept>
  2. 在相關概念定義 CSV 中，只包含 要使用的超集概念範例： 
    my_country_subset
FR  
MX
US

附註

  • 子集概念中的每個執行個體都必須是 超集合概念無法「展開」新的概念 執行個體。

定義自己的地理概念

目標

創造自己的地理概念 可供探索和可映射 例如 Google 定義的標準網址

步驟

  1. 建立延伸 geo:location 的概念。
  2. 在相關的概念定義表格中，將資料欄納入 name、latitude和longitude。
  3. 為概念的每個例項填入後者屬性。這個 經緯度值採用 N 和 E 慣例 的值為正數，W 和 S 為負數。

附註

  • 不需要明確加入 name latitude，以及 longitude 資源中的 因為在擴充容器時 geo:location。
  • 請參閱教學課程資料集中的 state 定義，以瞭解 範例。

指標與單位食譜

使用百分比

目標

定義代表其他百分比的 (指標) 概念。

步驟

  1. 讓概念延伸 quantity:ratio。
  2. 將 is_percentage 屬性設為 true。 
    <attribute id="is_percentage">
  <value>true</value>
</attribute>
  3. 視需要設定 percentage_of 屬性。 這種概念範例： 
    <attribute id="percentage_of">
  <value>labor force</value>
</attribute>

使用 currency 個單位

目標

定義使用貨幣單位 (例如美元)。

步驟

  1. 請將指標擴充 quantity:quantity 或其中一個指標 子項，例如quantity:amount。
  2. 新增參照的 unit 屬性 unit:currency，並將這個值設為 相關的貨幣定義 表格。範例： 
    <concept id="...">
  <attribute concept="unit:currency">
    <value>EUR</value>
  </attribute>
</concept>

建立自訂單位

目標

為一或多個指標建立自訂單位。

步驟

  1. 建立延伸 unit:unit 的概念。
  2. 將 unit_text 和 symbol 欄新增至 相關的定義資料表(選擇性) 如果您要調整 符號位置，您還可以新增 symbol_position 。
  3. 為 。「區域」的 CSV 範例單位： 
    my_unit,unit_text,symbol,symbol_position
SQKM,square kilometers,km²,END
SQML,square miles,miles²,END
  4. 如要以 (指標) 概念使用新建立的單元，請確認 後者會擴充 quantity:quantity 或其其中一個子項。接著： 新增參照單位概念的屬性。範例： 
    <concept id="..." extends="quantity:amount">
  ...
  <attribute concept="my_unit">
    <value>SQKM</value>
  </attribute>
  ...
</concept>

附註