Skip To Content

إضافة عناصر واجهة مستخدم مخصصة

بدءًا من الإصدار ArcGIS Enterprise 10.5.1, يمكنك إضافة عناصر واجهة مستخدم مخصصة إلى البوابة الإلكترونية. يعني ذلك أنه يمكنك اختيار عناصر واجهة مستخدم مخصصة في بيئة المنشيء عند إنشاء التطبيق. قبل استخدام عنصر واجهة مستخدم مخصص، يجب استضافته على خادم الويب وتسجيله على البوابة الإلكترونية. لأسباب أمنية، يمكن فقط لمسؤولي البوابة الإلكترونية تسجيل عناصر واجهة مستخدم مخصصة. في الإصدار 10.6، يمكن استخدام عناصر واجهة المستخدم المخصصة التي تشاركها مع كل الأشخاص (عام) في التطبيقات العامة من أجل وصول المستخدمين المجهولين.

قديم:

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

استضافة عنصر واجهة مستخدم مخصص على خادم الويب

لا يختلف استضافة عنصر واجهة مستخدم مخصص على خادم الويب عن استضافة أي تطبيق ويب آخر. يتعين عليك تثبيت وتكوين خادم الويب. تشمل خوادم الويب المشتركة IIS، وOS X Server وApache.

لاستضافة عناصر واجهة مستخدم مخصصة على خادم الويب، أكمل الخطوات التالية:

  1. تمكين الوصول المجهول المصدر على خادم الويب.

    يجب أن يكون موقع الاستضافة قابل للوصول إليه دون الافصاح عن الهوية.

  2. تمكين HTTPS.

    تمكين الوصول إلى HTTPS في خادم الويب لتجنب إنشاء محتوى مختلط. Web AppBuilder لا يتيح محتوى نشط مختلط ناتج عن تحميل HTTP أسفل اتصال HTTPS. بالإضافة إلى ذلك، يجب أن يحتوي الخادم على شهادة SSL صالحة صادرة من جهة اعتماد لتأسيس اتصال HTTPS.

  3. تمكين مشاركة الموارد عبر المصادر (CORS).

    يعمل Web AppBuilder أسفل مجال البوابة الإلكترونية، الذي قد يختلف عن مجال خادم الويب الذي يستضيف عنصر واجهة استخدام مخصص. يتعين عليك تمكين CORS في خادم الويب وبالتالي الوصول من مجال البوابة الإلكترونية يكون مسموح.

  4. أضف معالج JSON إلى خادم الويب.

    يتألف كل عنصر واجهة مستخدم من ملف بيانا JSON الذي يصف خصائص عنصر واجهة المستخدم. لا تتعرف بعض خوادم الويب على امتداد ملف JSON افتراضيًا. في مثل هذه الحالات، يجب عليك إضافته إلى الخادم مثل نوع MIME في التطبيق أو مستوى أعلى. يجب أن يحتوي نوع MIME على .json في صورة امتداد اسم الملف و application/json في صورة نوع MIME.

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

    يمكنك نسخ مجلد عنصر واجهة المستخدم إلى خادم الويب. بعد عملية النشر، يتعين عليك الحصول على مسار عنوان URL إلى ملف البيان من عنصر واجهة المستخدم المخصص. إحدى الأمثلة على مسار عنوان URL على ملف البيان هو <server.domain.com>/<my widget>/manifest.json.

تسجيل عنصر واجهة مستخدم مخصص

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

  1. في نافذة المستعرض، قم بتسجيل الدخول على البوابة الإلكترونية.
  2. انقر على علامة تبويب المحتوى في صفحة المجموعة.
  3. انقر على إضافة عنصر ثم اختر تطبيق.

    إضافة عنصر واجهة مستخدم مخصصة

  4. اختر ملحق التطبيق (AppBuilder)، واكتب عنوان URL لملف البيان.
    مربع حوار إضافة ملحق AppBuilder

    إحدى الأمثلة على مسار عنوان URL على ملف البيان هو <server.domain.com>/<my widget>/manifest.json.

  5. انقر على مربع العنوان.

    يعمل عنوان العنصر على التعبئة تلقائيًا من ملف البيان. اختياريًا، يمكنك تحرير العنوان يدويًا.

  6. أضف علامات في مربع العلامات.
  7. انقر على إضافة عنصر.

    عنصر واجهة المستخدم المخصصة متوفرة الآن في علامة تبويب المحتوى في صفحة المحتوى كنوع ملحق AppBuilder.

مشاركة عنصر واجهة مستخدم مخصص

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

تنبيه:

لن يقوم التطبيق إلا بتحميل عنصر واجهة المستخدم المخصص المُسجَّل في نفس المؤسسة في صورة المستخدمين الذين لديهم أذونات للوصول إلى التطبيق.

في المحتوى الخاص بي, حدد موقع عنصر واجهة المستخدم المخصص ومشاركته. عند فتح المُنشيء، يعرض عنصر واجهة المستخدم المخصص أسفل علامة تبويب مخصص على مربع الخوار اختر عنصر واجهة المستخدم.

تنبيه:

إذا ظهر خطأ 404 عند تحميل عنصر واجهة المستخدم المخصص، تأكد من أن عنصر واجهة المستخدم لا يتطلب أي وحدات نمطية باستخدام اسم حزمة عناصر واجهة المستخدم. وبدلاً من ذلك، استخدم مسارًا نسبيًا لتحميل الوحدات النمطية.

تحديث عنصر واجهة المستخدم المخصص

على الرغم من أنه يتعذر عليك تحديث عنصر واجهة المستخدم المخصص في البوابة الإلكترونية، يمكنك تحديث بنية HTML وكود JavaScript من عنصر واجهة المستخدم المخصص المستضاف في خادم الويب.

ملاحظة:‏

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