كتاب الطبخ 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 لبيانات الشرائح هي معرّفات صالحة من البلد الأساسي الولاية جداول التعريف.
2. إضافة geo:country و/أو geo_us:state كـ وأبعادها في الشرائح المتجاوبة.
3. تأكَّد من أنّ أسماء الأعمدة لهذه تتطابق مع الأسماء المفاهيم السابقة (بدون تضمين اسم مجموعة البيانات التي تم استيرادها، على سبيل المثال، country) أو إذا لم يكن الأمر كذلك، يمكنك تضمين mapDimension. العبارات في تعريف الشريحة لديك. مثال:

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

إن استخدام مجموعة فرعية فقط من البلدان الأساسية أو الولايات

الهدف

استخدم مجموعة فرعية من مفهوم جغرافي أساسي بحيث لا تمثل سوى هذه المجموعة الفرعية (وليس القائمة بأكملها، على سبيل المثال جميع البلدان في العالم) بشكل عام واجهة مستخدم "مستكشف البيانات"

الخطوات

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>
   

ملاحظات

• إذا كان مفهوم الوحدة له مثيل واحد فقط، يمكنك حذف المعرّف. من جدول التعريف الخاص به بالإضافة إلى علامات value في والمقاييس التي تستخدمها.
• الاطّلاع على تعريف العملة الأساسية المفهوم للحصول على مثال كامل.