الأشجار

تستخدم العديد من منتجات edge والنُسخ المعدلة الهياكل الشجرية لواجهة المستخدم لعرض العلاقات الهيكلية بين السجلات في النظام. يوفر إطار العمل كائنات لتحديد هيكل شجري وقواعد حول كيفية ملء نقاط التوصيل في الشجرة، وعمليات لتفسير التكوين وعرض الشجرة ديناميكيًا.

توفر الموضوعات الواردة في هذا القسم معلومات حول ما تم توفيره في إطار العمل. قد يوفر منتجك مكونات واجهة مستخدم بِأشجار جاهزة الإنشاء لحالات الاستخدام الشائعة. ارجع إلى توثيق المنتج لمزيد من المعلومات.

السمات العامة للأشجار

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

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

  • بالإضافة إلى إمكانية التنقل إلى الكيان المرتبط، توفر العديد من أنواع نقاط التوصيل قائمة سياقات تحتوي على مسارات تنقل أخرى.

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

تحدد كل شجرة نقاط التوصيل التي تُشكّل الشجرة والعلاقة الرئيسية/الفرعية بين نقاط التوصيل هذه. وتحدد نقطة التوصيل السمات العامة القابلة للتطبيق عليها والخوارزميات المسؤولة عن استرجاع بيانات نقطة التوصيل، واختياريًا الخوارزميات المسؤولة عن تحديد معلومات نقطة التوصيل المطلوب عرضها.

خوارزمية ملء نقطة التوصيل

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

تتمثل المسئولية الأساسية لخوارزمية ملء نقطة التوصيل في استلام رمز الشجرة واسم نقطة التوصيل وقيمة (أو قيم) السياق الرئيسي، وتحديد ما إذا كان يجب عرض بيانات لنقطة التوصيل هذه أم لا، وإرجاع قائمة بحقول السياق والقيم القابلة للتطبيق على كل صف في نقطة التوصيل. فيما يلي معلومات اختيارية إضافية يمكن إرجاعها بواسطة الخوارزمية:

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

  • قيمة أيقونة عرض. ويتم استخدامها لتجاوز الأيقونة المحددة في نقطة التوصيل و/أو الأيقونة الافتراضية للكيان كما هي محددة في كائن الصيانة أو كائن العمل.

  • سلسلة معلومات. يمكن استخدامها لتجاوز سلسلة المعلومات الافتراضية لكيان أو لعرض نص مستقل مثل ملخص أو وصف لنقاط التوصيل الفرعية المطلوب اتباعها.

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

خوارزمية تجاوز المعلومات

يوجد غرضان أساسيان لخوارزمية تجاوز المعلومات، وهما:

  • توفير نص معلومات بديل لنقطة توصيل عندما تكون المعلومات المُقدمة غير مناسبة للنسخة المُعدلة الخاصة بك.

  • استرجاع النظرات العامة السياقية المرتبطة بكيان نقطة التوصيل، ليتم تضمينها في نص معلومات نقطة التوصيل. ويتم حاليًا دعم أنواع النظرات العامة المميزة بعلامة فقط.

تتلقى خوارزمية تجاوز المعلومات رمز الشجرة واسم نقطة التوصيل وكائن الصيانة وقيم المفاتيح الأساسية لنقطة التوصيل. فيما يلي المعلومات التي يمكن إرجاعها بواسطة الخوارزمية:

  • قيمة أيقونة عرض.

  • سلسلة معلومات. ويتم استخدامها لتجاوز سلسلة المعلومات الافتراضية في السلسلة المُنسقة لنقطة التوصيل.

  • نص نقطة التوصيل الكامل. يتم استخدامه باعتباره النص الكامل للعرض، وهو يتجاوز الصياغة المحددة في نقطة التوصيل.

  • قائمة بأنواع النظرات العامة المميزة بعلامة وسياقها.

ملاحظة: إذا أرجعت خوارزمية تجاوز المعلومات أنواع النظرات العامة للكيان، فستكون مسؤولة أيضًا عن إرجاع كل قيم السياق المطلوبة لأنواع النظرات العامة هذه. لمزيد من المعلومات، ارجع إلى النظرات العامة السياقية.

تجهيز نقطة توصيل للعرض

يوضح القسم التالي الخطوات الأساسية لجلب بيانات نقطة التوصيل وتنسيقها للعرض.

تحديد محتوى نقطة التوصيل

يتم تنفيذ الخطوات التالية لاسترجاع المكونات التي تُشكّل بيانات عرض نقطة التوصيل:

  • يتم استدعاء خوارزمية "ملء نقطة التوصيل" لتحديد كل نقاط توصيل المثيلات الخاصة بنقطة توصيل الشجرة بالإضافة إلى التفاصيل المرتبطة بها.

  • يتم استدعاء خوارزمية "تجاوز المعلومات" لكل مثيل نقطة توصيل للسماح بالتجاوز الاختياري للتفاصيل المرتبطة بالعرض.

يتم تحديد محتويات عرض نقطة التوصيل كما يلي:

  • يتم تحديد الأيقونة من المصادر التالية، بالترتيب: تعريف نقطة التوصيل، قيمة خوارزمية تجاوز المعلومات، قيمة خوارزمية ملء نقطة التوصيل، القيمة الافتراضية لكائن الصيانة/كائن العمل.

  • يتم تحديد استخدام النقل بواسطة الإعداد المحدد في تعريف نقطة التوصيل.

  • يتم تحديد سلسلة المعلومات من المصادر التالية، بالترتيب: قيمة خوارزمية تجاوز المعلومات، قيمة ملء نقطة التوصيل، خوارزمية معلومات كائن الصيانة/كائن العمل. في حالة اشتقاق السلسلة من خوارزمية كائن الصيانة/كائن العمل، يتم استخدام نص المعلومات المختصر عند توفره، بخلاف ذلك، يتم استخدام المعلومات القياسية.

  • يتم تحديد استخدام قائمة السياقات بواسطة الإعدادات المحددة في تعريف نقطة التوصيل.

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

تنسيق نص نقطة التوصيل

يتكون عادةً نص نقاط التوصيل التي تشير إلى كيان نظام من توليفةٍ ما من التسمية ومفتاح الكيان وسلسلة معلومات. يوفر تكوين نقطة التوصيل حقل تسمية وحقل سلسلة صيغة بديلة يمكن استخدامه لتعريف صيغة نص نقطة التوصيل. تحدد سلسلة الصيغة أيًا من المكونات الثلاثة التي يجب تضمينها في النص وترتيب تلك المكونات وأي نص محيط وترميز HTML. على سبيل المثال، سينتج عن سلسلة الصيغة "%label - %key - %info" نص نقطة توصيل مثل المثال أدناه:

تنسيق نقطة توصيل الشجرة

إذا كانت سلسلة الصيغة فارغة، سيتضمن النص الافتراضي "%info" فقط. وفي حالة تكوين خوارزمية تجاوز معلومات تُرجِع نص نقطة التوصيل الكامل، يتم عرض النص بدون المزيد من الصياغة.

التوسيع الآلي

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

الأشجار المُقدّمة مع المنتج الأساسي

الأشجار هي بيانات نظام وقد يُقدم المنتج بالفعل العديد من الأشجار الجديدة. يمكنك اختيار تخصيص شجرة مُقدّمة مع المنتج الأساسي بالطرق التالية:

  • يمكنك إضافة نقاط التوصيل الخاصة بك إلى تعريف شجرة موجود.

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

عرض شجرة

لعرض شجرة في واجهة المستخدم، يجب تضمين مكون ويب الشجرة-الوحدة التشغيلية (ou-tree) في مخطط واجهة المستخدم الذي يشير إلى تعريف الشجرة.

ملاحظة: لمزيد من المعلومات، ارجع إلى تضمين مكون ويب.