مشاركة عبر

إنشاء تعليمات إرشادية لتطبيق الواجهة الموحدة

  • مقالة

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

هام

  • يحل جزء التعليمات المخصصة محل ميزة التعليمات الإرشادية لمسار التعليم السابقة المستخدمة مع تطبيقات عميل الويب القديمة.
  • لا تعمل أجزاء المساعدة المخصصة مع تطبيقات الواجهة الموحدة التي تعمل على جهاز محمول، مثل Android و iOS الأجهزة اللوحية والهواتف الذكية.

أجزاء التعليمات المخصصة ومسار التعليم

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

توفر أجزاء التعليمات المخصصة الميزات الرئيسية التالية والتي لا تتوفر مع مسار التعليم:

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

لا توفر أجزاء التعليمات المخصصة الميزات الرئيسية التالية والتي تتوفر مع مسار التعليم:

  • بالونات التعليمات التسلسلية.
  • صفحات التعليمات لكل دور.
  • صفحات تعليمات لعامل التصميم لكل جهاز، مثل الهواتف الذكية.

المتطلبات

لاستخدام ميزة جزء تعليمات مخصصة، تحتاج البيئة الخاصة بك إلى ما يلي:

تمكين أجزاء التعليمات المخصصة لبيئتك

  1. افتح تطبيقا يعتمد على النموذج، ومن شريط الأوامر حدد إعداداتإعدادات. > الإعدادات المتقدمة.

  2. انتقل إلى الإعدادات > النظام > الإدارة.

  3. في صفحة الإدارة، حدد إعدادات النظام.

  4. في علامة التبويب عام، ضمن تعيين عنوان URL الخاص بالتعليمات المخصص، حدد نعم لـ تمكين أجزاء التعليمات المخصصة والمهام الإرشادية، ثم حدد موافق.

    تمكين أجزاء التعليمات المخصصة.

هام

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

الامتيازات المطلوبة

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

مزيد من المعلومات: أدوار الأمان والامتيازات

التعليمات المخصصة الحساسة للسياق

يكون كل جزء من أجزاء التعليمات فريدًا لهذه السياقات:

  • التطبيق
  • الجدول
  • النموذج
  • اللغة‬

التنقل لجزء التعليمات

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

لمؤلف محتوى جزء التعليمات

  1. لعرض جزء التعليمات، افتح تطبيق يستند إلى نموذج، ثم حدد تعليمات في شريط الأوامر.

    المساعدة.

  2. في جزء التعليمات، حدد علامة الحذف العمودية، ثم حدد تحرير.

    تحرير التعليمات.

    يكون جزء التعليمات الآن في وضع التحرير ويتم وضع المؤشر على عنوان جزء التعليمات.

  3. يمكنك تنفيذ المهام التالية من الجزء تحرير:

    • إدخال نص من خلال الكتابة في منطقة جزء التعليمات مباشرة.
    • تمكّن من تنسيق النص من خلال قدرات النص الغني وإضافة قوائم رقمية/نقطية وأقسام ومقاطع فيديو وصور وارتباطات وعلامات التدريب وبالونات المساعدة.

  4. لحفظ التغييرات التي أجريتها، حدد حفظ.

نص حر

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

ال‏‫علامات النقطية‬ والقوائم الرقمية

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

الأقسام

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

الفيديو والصور الثابتة

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

تلميح

تذكر نسخ عنوان URL للارتباط للفيديو أو الصورة التي تريدها حتى يمكنك لصقه في جزء التعليمات.

تدعم أجزاء التعليمات المخصصة مصادر الفيديو التالية:

  • Microsoft Stream(كلاسيكي) (يستخدم للمحتوى الخاص)
  • YouTube
  • Facebook
  • Vimeo

قد تكون الارتباطات لمواقع ويب وتفتح في نفس النافذة (الافتراضية) أو تفتح في نافذة منفصلة. لم يتم بعد تمكين القدرة على الارتباط بصفحة تعليمات موجودة.

البالونات وعلامات التوجيه

يمكن استخدام البالونات وعلامات التوجيه للإشارة إلى عناصر واجهة مستخدم معينة. يمكن أن يحتوي بالون على نص بداخله.

إدراج بالون

تميّز علامة التدريب عنصرًا مع مؤشر تدريب يلفت انتباه المستخدم إلى عنصر واجهة المستخدم هذا.

إدراج علامات تدريب

يحتاج المؤلف إلى تعريف الهدف من خلال إمكانية السحب والإفلات في خصائص البالونات وعلامات التدريب. بإمكان المؤلف إدخال نص عنوان ووصف لعلامات التدريب.

السحب والإفلات

ملاحظة

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

محتوى جزء الحلول والتعليمات المخصصة

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

نقل المحتوى عبر الحلول

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

  1. سجل دخولك إلى Power Apps.
  2. في جزء التنقل الأيمن، حدد الحلول. If the item isn’t in the side panel pane, select …More and then select the item you want.
  3. افتح الحل غير المدار الذي تريده.
  4. حدد إضافة حل موجود في شريط الأوامر، ثم حدد صفحة التعليمات.
  5. حدد صفحات التعليمات التي تريد إضافتها، ثم حدد إضافة. مزيد من المعلومات: تصدير الحلول

أتمته وثائق صفحات التعليمات

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

تدعم أجزاء التعليمات المخصصة تنسيق XML المخصص. تم توثيق هذا التنسيق أدناه. لمزيد من المعلومات: تعريف XML للتعليمات المخصصة

وعند تصديرها، يتم تصدير كل صفحة من صفحات التعليمات كملف منفصل.

حول الحل المُدار للتعليمات السياقية

تتكون ميزات أجزاء التعليمات المخصصة والمهام الإرشادية‬ من مكونات الحل في الحل المُدار للتعليمات السياقية. تخصيص أو إنشاء السجلات باستخدام الجداول خارج ميزات أجزاء التعليمات المخصصة والمهام الإرشادية‬ غير مدعوم.

لاحظ أن بعض التطبيقات، مثل Dynamics 365 Sales وDynamics 365 Service، تتضمن تجارب التشغيل الأول التي تم تضمينها باستخدام الجداول المضمنة في الحل المُدار للتعليمات السياقية. على سبيل المثال، يتم استخدام جدولي صفحة التعليمات (msdyn_helppage) والجولة (msdyn_tour) في إنشاء تجارب التشغيل الأول هذه. في الوقت الحالي، لا تدعم ميزة أجزاء التعليمات المخصصة والمهام الإرشادية‬ إنشاء تجارب التشغيل الأول هذه.

الأسئلة الشائعة

يناقش هذا القسم الأسئلة الشائعة حول صفحات التعليمات المخصصة.

هل صفحات التعليمات المخصصة هي ذاتها التعليمات القابلة للتخصيص؟

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

لمزيد من المعلومات عن التعليمات القابلة للتخصيص، راجع تمكين التعليمات القابلة للتخصيص واستخدامها.

كيف يمكنني ترحيل بياناتي من مسار التعليم إلى صفحات التعليمات المخصصة؟

يحتوي مسار التعليم على نوعين من التعليمات: أجزاء التعليمات وبالونات التعليمات التسلسلية. تتكامل مواقع بالونات التعليمات التسلسلية بدرجة كبيرة مع واجهة مستخدم عميل الويب القديمة وهي غير قابلة للنقل لأجزاء التعليمات المخصصة الجديدة.

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

تعريف XML للتعليمات المخصصة

يوضح هذا القسم تعريف XML للتعليمات المخصصة.

PPHML

<pphml>
    <h1>FAQ</h1>
    <collapsible title="What is PPHML?">
        <p>PPHML is a domain specific language for help content. It is used to create help content that includes elements such as images, videos, balloons, coach marks, etc.</p>
    </collapsible>
    <collapsible title="What does PPHML stand for?">
        <p>PPHML stands for Power Platform Help Markup Language</p>
    </collapsible>
</pphml>

التعريف والاستخدام

ويقوم العنصر <pphml> بإعلام مستعرض التعليمات أن هذا المستند هو PPHML.

يمثل العنصر <pphml> جذر مستند PPHML.

العنصر <pphml> هو حاوية لكافة عناصر PPHML الأخرى.

عنوان

يقدم عنوانًا في صفحة التعليمات.

<h1>This will be displayed at the top of the help page</h1>

التعريف والاستخدام

يحدد العنصر <h1> عنوان صفحة التعليمات.

<h1> يجب أن يكون هذا هو العنصر الأول في <pphml>.

صورة

يقدم صورة في صفحة التعليمات.

<img src="smiley.gif" alt="Smiley face" title="Smiley face"/>

التعريف والاستخدام

يقوم العنصر <img> بتضمين صورة في إحدى صفحات التعليمات.

السمات

  • src: تحديد عنوان URL لصورة. يجب توافر هذه السمة.

  • title: تحديد عنوان لإظهاره مع الصورة، عادة كأداة تلميح التحويم.

  • alt: تحديد نص بديل لصورة. يستخدم هذا النص بواسطة قارئات الشاشة.

فيديو

يقدم فيديو في صفحة التعليمات.

<video src="https://www.youtube.com/watch?v=WSWmn7WM3i4" />

التعريف والاستخدام

يضمِّن العنصر <video> مقطع فيديو، مثل برنامج تعليمي أو فيلم تدريب، في صفحة التعليمات.

المصادر المدعومة
  • Microsoft Stream
  • YouTube
  • Facebook
  • Vimeo

السمات

  • src: تحديد عنوان URL للفيديو. يجب توافر هذه السمة.

  • allowFullScreen: تحديد ما إذا كان بإمكان المستخدم تبديل الفيديو إلى ملء الشاشة. وتكون القيم المحتملة "صواب" أو "خطأ". هذه السمة غير مدعومة لكافة مصادر الفيديو.

  • autoplay: تحديد بدء تشغيل الفيديو بمجرد تحميل صفحة التعليمات. وتكون القيم المحتملة "صواب" أو "خطأ". هذه السمة غير مدعومة لكافة مصادر الفيديو.

  • startTime: تعين نقطة بدء تشغيل الفيديو بالثواني.

الفقرة

يقدم فقرة في صفحة التعليمات.

<p>This is some text in a paragraph.</p>

التعريف والاستخدام

يحدد العنصر <p> فقرة.

يمكن تزيين النص الموجود داخل الفقرة بالطرق التالية:

  • غامق، بالعنصر <strong>
  • مائل، بالعنصر <em>
  • يتوسطه خط، بالعنصر <del>
  • تسطير، بالعنصر <u>

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

القائمة النقطية

تقدم قائمة نقطية في صفحة التعليمات.

<ul>
    <li>Coffee</li>
    <li>Tea</li>
    <li>Milk</li>
</ul>

التعريف والاستخدام

يحدد العنصر <ul> قائمة نقطية.

استخدم العنصر <ul> مع العنصر <li> لإنشاء قوائم نقطية.

قائمة رقمية

تقدم قائمة رقمية في صفحة التعليمات.

<ol>
    <li>First step</li>
    <li>Second step</li>
    <li>Third step</li>
</ol>

التعريف والاستخدام

يحدد العنصر <ol> قائمة مرتبة (رقميًا). استخدم علامة <ol> مع العنصر <li> لإنشاء قوائم رقمية.

قابل للطي

يقدم قسمًا قابلاً للطي في صفحة التعليمات.

<collapsible title="This is a Section">
    <p>This is a paragraph inside a section</p>
    <img src=smiley.gif" title="This is an image inside a section" />
</collapsible>

التعريف والاستخدام

يحدد العنصر <collapsible> قسم محتوى يمكن للمستخدم عرضه أو إخفاؤه حسب الطلب.

السمات

  • collapsed: تحديد ما إذا كان القسم مطويًا أو موسعًا في البداية. وتكون القيم المحتملة هي "صواب" (مطوي‬) أو "خطأ" (موسع).

يقدم ارتباطًا في صفحة التعليمات.

ارتباط بموقع ويب يفتح في نافذة مستعرض جديدة:

<a href="https://www.microsoft.com" target="_blank">Microsoft Home Page</a>

ارتباط بصفحة تعليمات أخرى:

<a href="./LearnMore">Learn More</a>

التعريف والاستخدام

تحدد <a>العلامة ارتباطًا، وهو ما يسمح للمستخدم بالتنقل من صفحة تعليمات إلى موقع ويب، أو إلى صفحة تعليمات أخرى.

السمات

  • href: تحديد عنوان URL لموقع الويب أو صفحة التعليمات المطلوب الانتقال إليها. يجب توافر هذه السمة.
  • target: يحدد مكان فتح عنوان URL المرتبط.
    • إذا لم تكن موجودة أو _self، سيتم الافتراض أن الارتباط بصفحة تعليمات أخرى ويتم فتحه في مستعرض التعليمات.
    • إذا كان _blank يتم فتح الارتباط في نافذة مستعرض جديدة.
    • إذا كان _top يتم فتح الارتباط في نافذة المستعرض الحالية.
    • إذا كانت القيمة هي اسم iframe، يتم فتح الارتباط في iframe هذه.

علامة التوجيه

تقدم علامة توجيه في صفحة التعليمات.

<coachmark target="#my-html-button">Click to highlight the HTML element with id [my-html-button]</coachmark>

التعريف والاستخدام

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

السمات

  • target: CSS المحدد الذي يحدد عنصر HTML الذي سيتم عرض علامة التوجيه من خلاله. يجب توافر هذه السمة.

البالون

يقدم بالون في صفحة التعليمات.

<balloon target="#my-html-button" title="This button submits the form" details="Please click this button to continue and submit the form">Click to show a balloon over the HTML element with id [my-html-button]</balloon>

التعريف والاستخدام

البالون هو عنصر تفاعلى يمكن استخدامه لمساعدة المستخدم على تنفيذ إجراء في واجهة مستخدم التطبيق الذي يستضيف مستعرض التعليمات.

السمات

  • target: CSS المحدد الذي يحدد عنصر HTML الذي سيظهر ارتباط البالون من خلاله. يجب توافر هذه السمة.
  • title: تحديد عنوان البالون.
  • details: تحديد المحتوى الذي سيظهر داخل البالون.