DSPL ตําราอาหาร

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

สูตรอาหารแต่ละสูตรเริ่มต้นด้วยเป้าหมาย ตามด้วยรายการขั้นตอนที่เจาะจงเพื่อ ติดตาม นอกจากนี้ยังมีข้อมูลโค้ด DSPL หรือลิงก์ไปยังตัวอย่างภายนอกด้วย หากคุณ หากมีความคิดเห็นเกี่ยวกับสูตรอาหารหรือต้องการแนะนำสูตรอื่นๆ โปรดโพสต์ ข้อความในฟอรัม DS

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

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

เป้าหมาย

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

ขั้นตอน

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 ดูข้อมูลก่อนหน้า สำหรับรายละเอียดเพิ่มเติม

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

เป้าหมาย

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

ขั้นตอน

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

หมายเหตุ

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

สูตรทำอาหาร

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

เป้าหมาย

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

ขั้นตอน

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

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

เป้าหมาย

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

ขั้นตอน

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

สูตรอาหารภูมิศาสตร์

กำลังใช้ country หรือ state แนวคิด Canonical

เป้าหมาย

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

ขั้นตอน

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

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

ใช้เพียงบางประเทศตามรูปแบบบัญญัติ หรือ รัฐ

เป้าหมาย

ใช้เซ็ตย่อยของแนวคิดภูมิศาสตร์ตามรูปแบบบัญญัติ เพื่อให้มีเพียงชุดย่อยนี้ (และไม่ รายการทั้งหมด เช่น ทุกประเทศในโลก) จะปรากฏต่อสาธารณะ UI เครื่องมือสำรวจข้อมูล

ขั้นตอน

1. กำหนดแนวคิดในท้องถิ่นที่ขยายแนวคิดซูเปอร์เซ็ต ตัวอย่าง

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

2. ในไฟล์ CSV คำจำกัดความแนวคิดที่เกี่ยวข้อง ให้ใส่เฉพาะรหัสของ แนวคิดขั้นสูงที่คุณต้องการใช้ ตัวอย่าง

   my_country_subset
   FR  
   MX
   US
   

หมายเหตุ

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

การกำหนดแนวคิดทางภูมิศาสตร์ของคุณเอง

เป้าหมาย

สร้างแนวคิดทางภูมิศาสตร์ของคุณเอง ซึ่งสามารถสำรวจและทำแผนที่ได้ เพียงแค่ เช่น Canonical URL ที่ 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 ใน เมตริกที่ใช้เมตริกนั้น
• ดูคำจำกัดความของสกุลเงินตามรูปแบบบัญญัติ เพื่อเป็นตัวอย่างที่สมบูรณ์