ספר המתכונים של DSPL

המסמך הזה כולל ספר מתכונים שימושי בנושא DSPL וקונספט קנוני 'מתכונים'. ההוראות האלה מספקות הדרכה מפורטת במגוון משימות מעבר לתכונות השפה הבסיסיות המתוארות במדריך ובמדריך למפתחים. התוכן שלהלן מחשב את המסמכים הקודמים, לכן חשוב לקרוא אותם לפני התחלת ה"בישול".

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

מתכונים בסיסיים

ציון שמות תצוגה

יעד

שיוך "שם תצוגה" לכל מופע של קונספט (מאפיין). השמות האלה יופיעו בממשק המשתמש של Public Data Explorer במקום במזהי המופע של הקונספט, שבאופן כללי הם קצרים יותר וקשה יותר להבנה.

צעדים

1. איך להרחיב את הקונספט שלך entity:entity.
2. צריך להוסיף עמודה name לטבלת הגדרות הקונספט המשויכת.
3. לאכלס את המאפיין השני בשם של כל מכונה.

הערות

• אין צורך להגדיר באופן מפורש נכס של name במטא-נתונים של הקונספט שלך. ההגדרה הזו נכללת באופן אוטומטי כשמרחיבים את entity:entity.
• אפשר גם להוסיף description ו-info_url עמודות כדי לספק תיאורים וכתובות URL ברמת המכונה, בהתאמה.

יצירת היררכיות של רעיונות

יעד

יצירת היררכיה של מושגים (מאפיין). הם יופיעו בממשק המשתמש הציבורי של סייר הנתונים כעץ, כדי לאפשר למשתמשים להבין את הקבוצות ולנווט ביניהן.

צעדים

1. הגדרת מושג 'הורה' (למשל, region).
2. הגדרת מושג 'ילד' (למשל, subregion).
3. יש להוסיף נכס צאצא שמפנה להורה וכולל את המאפיין isParent:

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

   כאשר הנקודות מוחלפות על ידי מזהה ההורה.
4. בטבלת ההגדרות של הילד או הילדה, מוסיפים עמודה עם ההורה.
5. צריך לאכלס כל מופע צאצא עם מופע חוקי של אובייקט האב.

הערות

• בדוגמת מערך הנתונים של מערך השיעור ניתן לראות את היחס הזה אל country / state.
• כל מזהה הורה שהוזכר בו מהילד צריך להיות בטבלת ההגדרות של ההורה. אחרת, המייבא ייצור שגיאה.
• ההורה והילד יכולים להיות אותו קונספט (כלומר, היררכיה של אזכור עצמי). כדי לקבל דוגמה לכך, אפשר לעיין בקונספט business במערך הנתונים בנושא מכירות קמעונאיות בארה"ב.

סיווג מופעים של קונספט

יעד

יצירת קטגוריות למופעי קונספט שיופיעו כאפשרויות בבוררי הצבעים של Public Data Explorer.

צעדים

1. הגדרת הקונספט "קטגוריה" (למשל, income_level).
2. הגדרת מושג 'ילד' (למשל, country).
3. הוספה של נכס צאצא שמפנה לקונספט של הקטגוריה וכוללת רכיב בשם name:

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

   כאשר קבוצת הנקודות הראשונה מוחלפת על ידי מזהה הקונספט של הקטגוריה, והקבוצה השנייה מוחלפת בשם התצוגה הרצוי של הנכס (למשל, 'רמת הכנסה').
4. בטבלת ההגדרות של הילד או הילדה, מוסיפים עמודה הקשורה לקונספט של הקטגוריה.
5. צריך לאכלס כל מופע צאצא עם מופע חוקי של מושג הקטגוריה.

הערות

• מושג יכול לכלול נכסים מרובים המשמשים כקטגוריות. במקרה כזה, המשתמש יראה את כולם כאפשרויות בבוררי הצבעים.
• אחת הקטגוריות יכולה להיות גם הורה כדי לארגן את המופעים בהיררכיה בממשק המשתמש. פרטים נוספים זמינים במתכון הקודם.

ציון סדר המיון של מופעי קונספט

יעד

יש לציין את סדר המיון של מופעים. הסדר הזה משמש ליצירת רשימת המכונות, בסרגל השמאלי של דפי ההדמיה של 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

יעד

יש להשתמש בקונספטים הקנוניים country או state, שמייבאים את כל ערכי הרוחב/אורך וכו', כדי שלא יהיה צורך להגדיר אותם במערך הנתונים.

צעדים

1. יש לוודא שכל ההפניות לקובצי ה-CSV של המדינה ו/או המדינה בארה"ב בקובצי ה-CSV של נתוני הפלח הן מזהים חוקיים מטבלאות ההגדרות הקנוניות של המדינה והמדינה.
2. יש להוסיף את geo:country ואת geo_us:state כמאפיינים בפלחים התואמים.
3. חשוב לוודא שהשמות של העמודות האלה תואמים לשמות של המושגים הקודמים (לא כולל את השם של מערך הנתונים המיובאים, למשל country), ואם לא, צריך לכלול mapDimension הצהרות בהגדרת הפלח. דוגמה:

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

שימוש רק בקבוצת משנה של המדינות או המדינות הקנוניות

יעד

יש להשתמש בקבוצת משנה של קונספט גיאוגרפי קנוני, כך שרק קבוצת המשנה הזו (ולא הרשימה המלאה, למשל כל המדינות בעולם) תופיע בממשק המשתמש של Public 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>
   

הערות

• אם לקונספט של יחידה יש רק מופע אחד, אפשר להשמיט את העמודה ID מטבלת ההגדרות שלה וגם מתגי value במדדים שמשתמשים בה.
• כדי לראות דוגמה מלאה, אפשר לעיין בהגדרה של קונספט המטבע הקנוני.