كتاب الطبخ 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. بالنسبة إلى كل مثيل فرعي، املأ الحقل الأخير بمثال صالح لمفهوم الفئة.

ملاحظات

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

تحديد ترتيب التصنيف لمثيلات المفهوم

الهدف

تحديد ترتيب التصنيف لمثيلات المفهوم. ويتم استخدام هذا الترتيب عند إدراج النُسخ الافتراضية في شريط التنقّل الأيمن في صفحات التمثيل البصري لـ 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>
   

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

الهدف

استخدِم مجموعة فرعية من مفهوم جغرافي أساسي بحيث تظهر هذه المجموعة الفرعية فقط (وليس القائمة بالكامل، مثل جميع البلدان في العالم) في واجهة مستخدم 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>
   

ملاحظات

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