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

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

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

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

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

יעד

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

שלבים

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

הערות

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

יצירת היררכיות של מושגים

יעד

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

שלבים

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 של נתוני פרוסות הם מזהים חוקיים מהמדינה הקנונית state (מדינה) בטבלאות של ההגדרות.
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 או אחד מהצאצאים שלו. לאחר מכן: להוסיף מאפיין שמפנה למושג היחידה (unit testing). דוגמה:

   <concept id="..." extends="quantity:amount">
     ...
     <attribute concept="my_unit">
       <value>SQKM</value>
     </attribute>
     ...
   </concept>
   

הערות

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