يعتمد قالب Sidebar على قالب تطبيق ويب Sidebar من Instant Apps. يوفر تجربة تطبيق أصلي لمجموعة من الأدوات والخيارات التي تظهر في لوحة جانبية بجوار الخريطة. يمكنك تضمين أدوات خريطة أساسية لاستكشاف الخريطة والعلامات المرجعية للتكبير/التصغير إلى مناطق معينة. قم بتوفير أدوات التحرير كي يتمكن المستخدمون من إضافة المعالم وتحديثها في الخريطة. قم بتكوين عوامل التصفية التي يمكن للمستخدمين استخدامها للحصول على مزيد من المعلومات عن البيانات.
المتطلبات
متطلبات استخدام قالب Sidebar هي كما يلي:
- قم بتوفير تطبيق ويب Sidebar واحد أو أكثر. قد تكون هذه التطبيقات معرف عنصر صالحًا، أو معرفًا لمجموعة تحتوي على تطبيقات ويب Sidebar المتعددة أو استعلام البحث الذي يحتوي على معرفات عناصر متعددة.
- قد تكون تطبيقات ويب Sidebar عامة أو مؤمَّنة. للوصول إلى تطبيق ويب مُؤمَّن في مؤسسة ArcGIS Online أو بوابة ArcGIS Enterprise الإلكترونية باستخدام OAuth2، سجل تطبيقك، وأدخل معرف عميل. للحصول على مزيد من المعلومات، راجع توقيع التطبيق الخاص بك. بشكل افتراضي، تظهر تطبيقات ويب Sidebar العامة فقط في معرض Sidebar. للوصول إلى تطبيقات ويب Sidebar المؤمَّنة، انقر فوق الإعدادات > الترخيص > المعرض وأدخل معرف عميل.
إمكانات التطبيق
تتضمن القائمة التالية الإعدادات والإمكانات الرئيسية، التي إذا تم تكوينها في تطبيق الويب، تكون مدعومة في التطبيق الأصلي:
- قائمة الطبقات—تعرض قائمة من الطبقات التي تتضمن أيقونات لإيقاف تشغيل الرؤية وتشغيلها في الخريطة. يمكنك اختيار الطبقات المراد تضمينها في الأداة في وقت التشغيل.
- العلامات المرجعية—تعمل على تكبير/تصغير الخريطة وتحريكها ضمن مجموعة من النطاقات المعينة مسبقًا والمحفوظة في الخريطة.
- النافذة المنبثقة—تعرض محتوى النافذة المنبثقة الذي تم تكوينه عند النقر على معلم.
- أدوات التحرير—توفر خيارات إضافة المعالم وتحديثها في طبقات قابلة للتعديل.
- التفاصيل—تظهر محتوى الوصف من تفاصيل عنصر الخريطة المصدر في اللوحة الجانبية للتطبيق.
- عامل التصفية—يعمل على تصفية البيانات في الخريطة بناءً على الخيارات المحددة مسبقًا.
- زر تبديل خريطة الأساس—يغير مظهر الخريطة عن طريق التبديل إلى خريطة أساس مختلفة.
يتضمن التطبيق الذي تم إنشاؤه باستخدام قالب Sidebar أيضًا دعمًا للخرائط غير المتصلة بالإنترنت عند تمكين الطبقات والخرائط للاستخدام في وضع عدم الاتصال.
تخصيص تطبيق
بمجرد إنشاء التطبيق، يمكنك تخصيصه بتغيير إعدادات التطبيق.
شغِّل AppStudio ثم انقر فوق الإعدادات > الخصائص في اللوحة الجانبية. يدرج الجدول التالي محتويات علامات التبويب في علامة تبويب خصائص Sidebar مصنفة حسب علامة التبويب التي تظهر فيها، وأغراضها. يمكنك أيضًا تعديل الخصائص مباشرةً في ملف appinfo.json للتطبيق. إذا قمت بتغيير أي خصائص، فانقر فوق تطبيق لحفظها قبل بدء التطبيق مرة أخرى.
محتويات علامة تبويب شاشة البدء
الخاصية | اسم JSON | النوع | الوصف |
---|---|---|---|
صورة الخلفية | startBackground | سلسلة (عنوان URL للصورة) | صورة يمكن استخدامها لخلفية صفحة البدء. |
لون العلامة التجارية | brandColor | السلسلة (قيمة اللون) | لون يمكن استخدامه كلون رئيسي. |
ملف خط العنوان | mediumFontTTF | سلسلة (عنوان URL لملف الخط) | يعين خط العنوان المخصص المطلوب استخدامه في التطبيق. سيتم استخدام هذا الخط في العناوين وعناوين الصفحات وما إلى ذلك. |
ملف خط النص | regularFontTTF | سلسلة (عنوان URL لملف الخط) | يُعيّن خط النص المخصص المراد استخدامه في التطبيق. سيُستخدم هذا الخط في أوصاف الصور، ونص نبذة عن التطبيق، وما إلى ذلك. |
البريد الإلكتروني للملاحظات | feedbackEmail | سلسلة (معرف البريد الإلكتروني) | عنوان البريد الإلكتروني الذي يجب إرسال ملاحظات المستخدم إليه. |
إظهار إخلاء المسئولية | showDisclaimer | منطقي (صحيح|خطأ) | إظهار نص إخلاء المسئولية في صورة عنصر منبثق في التطبيق. هذا النص هو المحتوى من قسم قيود الدخول والاستخدام في علامة تبويب التفاصيل. |
محتويات علامة تبويب المعرض
الخاصية | اسم JSON | النوع | الوصف |
---|---|---|---|
تطبيقات ويب Sidebar | galleryMapsQuery | السلسلة | أدخل استعلام ArcGIS لسرد تطبيقات ويب Sidebar الصالحة في المعرض. قد يكون هذا معرف عنصر فرديًا صالحًا لتطبيق الويب مثل المعرف: 87e4ea0800d64d4cb0e9d2e3784a5519 أو معرف مجموعة يحتوي على تطبيقات ويب متعددة مثل المجموعة: 47597bdf4b6d49fd85c0f4175a6e7b60، أو استعلام بحث بمعرفات عناصر تطبيق ويب متعددة مثل: (المعرف:87e4ea0800d64d4cb0e9d2e3784a5519 أو المعرف:5a2cff5558704870bd5dbe36fbb94183). |
إجمالي النتائج للعرض في المعرض | maxNumberOfQueryResults | رقم | أدخل العدد الأقصى لخرائط الويب التي يجب إرجاعها من استعلام البوابة الإلكترونية. |
عنوان URL لـ Portal | portalUrl | السلسلة | عنوان URL الخاص بـ Portal المطلوب للاستعلام عن تطبيقات ويب Sidebar. |
دعم تطبيقات الويب الآمنة | supportSecuredMaps | منطقي (صحيح|خطأ) | توفير إمكانية تسجيل الدخول إلى المؤسسة للوصول إلى تطبيقات الويب المُؤمَّنة بموجب معلمات الاستعلام. |
تخطي تسجيل الدخول | enableAnonymousAccess | منطقي (صحيح|خطأ) | إذا تم تعيين دعم تطبيقات الويب الآمنة على صحيح، فيوفر تعيين هذا الخيار على صحيح إمكانية اجتياز تسجيل الدخول ويعرض تطبيقات الويب المتاحة عامة في المعرض. |
حقل فرز البوابة الإلكترونية | portalSortField | السلسلة | يستخدم لفرز تطبيقات الويب المعروضة في المعرض. تتضمن القيم الممكنة: العنوان والذي تم إنشاؤه والنوع والمالك والمُعدل وavgRating وnumRatings وnumComments وnumViews. |
ترتيب فرز البوابة الإلكترونية | portalSortOrder | السلسلة | مستخدم بالتزامن مع حقل فرز المعرض لترتيب تطبيقات الويب تصاعديًا أو تنازليًا. القيم الممكنة كتصاعدية أو تنازلية. |