DSPL ตําราอาหาร

เอกสารนี้มีตําราอาหารของแนวคิด DSPL และ Canonical ที่มีประโยชน์ว่า "สูตรอาหาร" คําแนะนําเหล่านี้เป็นแนวทางทีละขั้นตอนสําหรับงานต่างๆ ที่เหนือไปกว่าฟีเจอร์พื้นฐานด้านภาษาที่อธิบายไว้ในบทแนะนําและคู่มือนักพัฒนาซอฟต์แวร์ เนื้อหาด้านล่างจะถือว่าได้รับทราบข้อมูลเกี่ยวกับเอกสารก่อนหน้าแล้ว ดังนั้น โปรดอ่านเนื้อหาเหล่านั้นก่อนเริ่ม "ทําอาหาร"

แต่ละสูตรอาหารเริ่มต้นด้วยเป้าหมาย ตามด้วยรายการขั้นตอนที่ควรทําตาม โค้ดนี้ยังรวมถึงข้อมูลโค้ด DSPL หรือลิงก์ไปยังตัวอย่างภายนอกด้วย หากมีความคิดเห็นเกี่ยวกับสูตรอาหารหรือต้องการแนะนําผู้อื่น โปรดโพสต์ข้อความลงในฟอรัม DSPL

สูตรอาหารพื้นฐาน

การระบุชื่อที่แสดง

เป้าหมาย

เชื่อมโยง "ชื่อที่แสดง" กับแต่ละอินสแตนซ์ของแนวคิด (มิติข้อมูล) ชื่อเหล่านี้จะปรากฏใน UI ของ Public Data Explorer แทนรหัสอินสแตนซ์ของแนวคิด ซึ่งโดยทั่วไปแล้วจะสั้นและเข้าใจยากสําหรับผู้ใช้

จำนวนก้าว

1. ขยายแนวคิดentity:entity.
2. เพิ่มคอลัมน์ name ลงในตารางคําจํากัดความของแนวคิดที่เกี่ยวข้อง
3. ป้อนข้อมูลพร็อพเพอร์ตี้หลังด้วยชื่อของอินสแตนซ์แต่ละรายการ

หมายเหตุ

• ไม่จําเป็นต้องกําหนดพร็อพเพอร์ตี้ name ในข้อมูลเมตาแนวคิดอย่างชัดแจ้ง เพราะคําจํากัดความนี้จะรวมโดยอัตโนมัติเมื่อคุณขยาย entity:entity
• นอกจากนี้ คุณยังเพิ่มคอลัมน์ description และ info_url เพื่อระบุคําอธิบายและ URL ระดับอินสแตนซ์ตามลําดับได้ด้วย

การสร้างลําดับชั้นแนวคิด

เป้าหมาย

สร้างลําดับชั้นของแนวคิด (มิติข้อมูล) รายการเหล่านี้จะปรากฏใน UI เครื่องมือสํารวจข้อมูลสาธารณะในรูปแบบแผนผัง ซึ่งช่วยให้ผู้ใช้เข้าใจการจัดกลุ่มและไปยังการจัดกลุ่มเหล่านั้นได้

จำนวนก้าว

1. กําหนดแนวคิด "หลัก" (เช่น region)
2. กําหนดแนวคิดแบบ "ย่อย" (เช่น subregion)
3. เพิ่มพร็อพเพอร์ตี้ในองค์ประกอบย่อยที่อ้างอิงถึงระดับบนสุดและรวมแอตทริบิวต์ isParent:

   <property concept="..." isParent="true"/>
   

   ที่ระบบจะแทนที่จุดด้วยรหัสระดับบนสุด
4. ในตารางคําจํากัดความย่อย ให้เพิ่มคอลัมน์ที่อ้างอิงถึงระดับบนสุด
5. สําหรับอินสแตนซ์ย่อยแต่ละรายการ ให้ใส่อินสแตนซ์ที่ถูกต้องของแนวคิดระดับบนสุด

หมายเหตุ

• ดูตัวอย่างความสัมพันธ์ของ country / state ในชุดข้อมูลบทแนะนําเพื่อเป็นตัวอย่าง
• รหัสระดับบนสุดแต่ละรหัสที่มีการอ้างอิงจากผู้เผยแพร่โฆษณาย่อยต้องอยู่ในตารางคําจํากัดความของระดับบนสุด มิฉะนั้นผู้นําเข้าจะสร้างข้อผิดพลาด
• ระดับบนสุดและย่อยอาจมีแนวคิดเดียวกัน (เช่น ลําดับชั้นที่อ้างอิงตัวเอง) ดูตัวอย่างของแนวคิด business ในชุดข้อมูลการขายสําหรับการค้าปลีกในสหรัฐอเมริกา

การจัดหมวดหมู่อินสแตนซ์แนวคิด

เป้าหมาย

สร้างหมวดหมู่สําหรับอินสแตนซ์แนวคิดที่จะแสดงเป็นตัวเลือกในตัวเลือกสีของเครื่องมือสํารวจข้อมูลสาธารณะ

จำนวนก้าว

1. กําหนดแนวคิด "หมวดหมู่" (เช่น income_level)
2. กําหนดแนวคิดแบบ "ย่อย" (เช่น country)
3. เพิ่มพร็อพเพอร์ตี้ในย่อยที่อ้างถึงแนวคิดหมวดหมู่และรวมองค์ประกอบ name ดังนี้

   <property concept="..."/>
     <info>
       <name><value>"..."</value></name>
     </info>
   </property>
   

   โดยแทนที่เครื่องหมายจุดชุดแรกด้วยรหัสแนวคิดหมวดหมู่ และชุดที่สองจะแทนที่ด้วยชื่อที่แสดงของพร็อพเพอร์ตี้ที่ต้องการ (เช่น "ระดับรายได้")
4. ในตารางคําจํากัดความย่อย ให้เพิ่มคอลัมน์ที่อ้างอิงแนวคิดหมวดหมู่
5. สําหรับอินสแตนซ์ย่อยแต่ละรายการ ให้ใส่อินสแตนซ์ที่ถูกต้องของแนวคิดหมวดหมู่แทน

หมายเหตุ

• แนวคิดหนึ่งๆ อาจมีพร็อพเพอร์ตี้หลายรายการที่แสดงเป็นหมวดหมู่ ในกรณีนี้ผู้ใช้จะเห็นพร็อพเพอร์ตี้ทั้งหมดเป็นตัวเลือกในเครื่องมือเลือกสี
• หมวดหมู่หนึ่งอาจใช้เป็นระดับบนสุดเพื่อวัตถุประสงค์ในการจัดระเบียบอินสแตนซ์แบบเป็นลําดับชั้นใน UI ดูรายละเอียดได้ที่สูตรก่อนหน้า

การระบุลําดับการจัดเรียงสําหรับอินสแตนซ์แนวคิด

เป้าหมาย

ระบุลําดับการจัดเรียงสําหรับอินสแตนซ์ของแนวคิด คําสั่งซื้อนี้จะใช้เมื่อระบุอินสแตนซ์ในการนําทางด้านซ้ายของหน้าการแสดงภาพข้อมูลแบบสาธารณะ

จำนวนก้าว

1. ทําให้แนวคิดของคุณขยายพื้นที่ entity:entity หรือหนึ่งในเด็ก (เช่น geo:location)
2. เพิ่มแอตทริบิวต์ entity_order ลงในข้อมูลเมตาแนวคิด
3. กําหนดค่าของส่วนก่อนหน้าเป็น 1 ใน ALPHA หรือ TABLE ส่วนแรกจะทําให้อินสแตนซ์แสดงตามลําดับชื่อที่แสดง ส่วนรายการหลังจะเก็บอินสแตนซ์ตามลําดับเดียวกันกับที่ปรากฏในตารางคําจํากัดความของแนวคิด

หมายเหตุ

• ALPHA คือค่าเริ่มต้นในปัจจุบัน ดังนั้นหากต้องการใช้ลําดับนี้ ขั้นตอนข้างต้นไม่จําเป็น
• ดูตัวอย่างจากเอกสารประกอบของ entity:entity

สูตรเวลา

ข้อมูลรายไตรมาส

เป้าหมาย

แสดงภาพข้อมูลที่ระบุเป็นรายไตรมาส

จำนวนก้าว

1. แปลงทุกไตรมาสในข้อมูลส่วนแบ่งเป็นเดือน (เช่น เดือนแรกของไตรมาส)
2. ถือว่ามิติข้อมูลนี้เป็น time:month ใน XML ของส่วนแบ่งของคุณ

ข้อมูลรายสัปดาห์

เป้าหมาย

แสดงภาพข้อมูลที่ระบุเป็นรายสัปดาห์

จำนวนก้าว

1. แปลงสัปดาห์ทั้งหมดในข้อมูลส่วนแบ่งเป็นวัน (เช่น วันแรกของสัปดาห์)
2. ถือว่ามิติข้อมูลนี้เป็น time:day ใน XML ของส่วนแบ่งของคุณ

สูตรทางภูมิศาสตร์

การใช้แนวคิด Canonical country หรือ state

เป้าหมาย

ใช้แนวคิด Canonical country หรือ state โดยนําเข้าค่าลาติน/ยาวทั้งหมด ฯลฯ เพื่อไม่จําเป็นต้องกําหนดค่าเหล่านี้ภายในชุดข้อมูล

จำนวนก้าว

1. ตรวจสอบว่าไฟล์ CSV ทั้งหมดของข้อมูลประเทศและ/หรือรัฐในสหรัฐอเมริกาเป็นรหัสที่ถูกต้องจากตารางคําจํากัดความประเทศและรัฐ
2. เพิ่ม geo:country และ/หรือ geo_us:state เป็นมิติข้อมูลในส่วนที่เกี่ยวข้อง
3. ตรวจสอบว่าชื่อคอลัมน์ของแนวคิดเหล่านี้ตรงกับชื่อแนวคิดก่อนหน้า (ไม่รวมชื่อชุดข้อมูลที่นําเข้า เช่น country) หรือหากไม่ใช่ ให้ใส่ข้อความ mapDimension ลงในคําจํากัดความสไลซ์ ตัวอย่าง

   <slice id="...">
     ...
     <dimension concept="geo:country"/>
     ...
     <mapDimension concept="geo:country" toColumn="my_country"/>
   </slice>
   

ใช้เฉพาะประเทศ Canonical ของประเทศหรือรัฐต่างๆ

เป้าหมาย

ใช้แนวคิดย่อยด้านภูมิศาสตร์ Canonical เพื่อให้เฉพาะชุดข้อมูลย่อยนี้ (ไม่ใช่รายการทั้งหมด เช่น ทุกประเทศในโลก) ปรากฏใน UI ของ Public Data Explorer

จำนวนก้าว

1. กําหนดแนวคิดท้องถิ่นที่ขยายแนวคิด Superset ตัวอย่าง

   <concept id="my_country_subset" extends="geo:country">
   ...
   </concept>
   

2. ใน CSV ของคําจํากัดความแนวคิดที่เกี่ยวข้อง ให้ใส่เฉพาะรหัสของแนวคิด Superset ที่ต้องการใช้ ตัวอย่าง

   my_country_subset
   FR  
   MX
   US
   

หมายเหตุ

• แต่ละอินสแตนซ์ของแนวคิดชุดย่อยต้องเป็นอินสแตนซ์ที่ถูกต้องของแนวคิด Superset คุณไม่สามารถ "ขยาย" แนวคิดด้วยอินสแตนซ์ใหม่

ให้คํานิยามแนวคิดทางภูมิศาสตร์ของคุณเอง

เป้าหมาย

สร้างแนวคิดทางภูมิศาสตร์ของคุณเองที่สํารวจได้และแมปได้ เหมือนกับแนวคิด Canonical ที่ 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 รายการ

จำนวนก้าว

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>
   

หมายเหตุ

• หากแนวคิดเกี่ยวกับหน่วยมีอินสแตนซ์เดียว คุณจะละเว้นคอลัมน์รหัสจากตารางคําจํากัดความ รวมถึงแท็ก value ในเมตริกที่ใช้อินสแตนซ์นี้ได้
• ดูคําจํากัดความของแนวคิดสกุลเงิน Canonical เพื่อดูตัวอย่างที่สมบูรณ์