لإنشاء قالب تطبيق ويب مخصص، يمكنك تنزيل أحد القوالب الحالية وتعديلها أو تحديث تطبيق ويب حالي للتعامل مع المحتوى من البوابة الإلكترونية أو إنشاء تطبيق ويب جديد باستخدام أحد ArcGIS Web APIs. بغض النظر عن كيفية إنشاء القالب، سوف تتعامل مع معلمات عنوان URL وكذلك خرائط الويب. يمكن أن تتعامل مع المجموعات إذا قمت بإنشاء قالب المجموعة ويمكن أن تضع في الاعتبار متطلبات إضافية للتعامل مع خرائط أساس Bing أو الوصول إلى الخرائط غير العامة والتعامل مع الموارد التي تتطلب وكيل أو مشاركة مصدر الأصل العكسي (CORS). ستقوم بإضافة العنصر إلى البوابة الإلكترونية، إذا كانت المنظمة تخطط لاستخدام القالب في معرض القوالب الخاص بها، ومشاركته مع أحد مجموعات قوالب المنظمة.
تتضمنPortal for ArcGIS ArcGIS API 3.15 for JavaScript. لا تقتضي الحاجة إلى استضافة API والإشارة إلى المدخل في الإصدار المحلي لقالب التطبيقات التي تم إنشائها حديثًا، يتم إرجاع قوالب تطبيق الويب لـ API المثبت تلقائيًا. يتوفر API الذي تم تثبيته محليًا على https://webadaptorhost.domain.com/webadaptorname/jsapi/jsapi.
تنبيه:
لا تقم بتبديل ملفات قالب تطبيق الويب التي تم توفيرها مع Portal for ArcGIS، لأن هذه الملفات مدارة بواسطة المدخل، وأي تبديل ستقوم به يمكن أن يؤثر بدوره على المدخل. إذا أردت تخصيص القوالب، قم بما يلي:
- قم بعمل نسخة من ملف القالب الحالي والذي ترغب في تخصيصه.
- ضع النسخة في موقع مختلف على القرص
- قم بتخصيص نسخة من القالب.
- اضفها إلى البوابة الإلكترونية بصفتها قالب جديد.
يشمل هذا الموضوع كيفية إنشاء قالب تطبيق الويب. يُفترض الحصول على الامتيازات لإنشاء المحتويات ومشاركة المجموعات داخل المؤسسة. بمجرد القيام بإنشاء القالب ، يمكن جعله قابل للتكوين. تسمح القوالب القابلة للتكوين للمستخدمين بتخصيص مظهر التطبيق وسلوكه.
خرائط الويب
صُمّمت قوالب التطبيق للتعامل مع خريطة الويب المعروضة حاليًا في عارض الخرائط. تقوم القوالب بإنشاء الخريطة المستندة إلى خريطة الويب الموجودة في معلمات عنوان URL لخريطة الويب. كلا من API على الويب له وسيلة مساعدة تقوم بإنشاء الخريطة باستخدام المعلومات من الرقم التعريفي لخريطة الويب.
على سبيل المثال، يمكنك استخدام أسلوب ArcGIS API for JavaScript esri.arcgis.utils.createMap لإنشاء خريطة تستند على مُعرف الإدخال. يُمكنك أيضًا تضمين وظيفة الإرجاع التي يتم تنفيذها عند اكتمال طلب esri.arcgis.utils.createMap التزامن.esri.arcgis.utils.createMap(webmap,"map",{
mapOptions:{
slider:false
},
bingMapsKey:bingMapsKey
}).then(function(response){
map = response.map;
});
ملاحظة:
إذا تضمنت خرائط الويب خريطة أساس خرائط Bing، ستحتاج لتحديد مفتاح خرائط Bing عند استخدام طريقةcreateMap. هناك العديد من خيارات الخريطة الأخرى يمكن تعيينها مثل عرض المنزلق والتنقل والبيانات الجدولية والمزيد.
توفر الوظيفة callback وصولاً إلى كائن الاستجابة الذي يوفر وصولاً إلى كائن الخريطة والطبقات والمزيد.
تسجيل قوالب التطبيق
عند التعامل مع العناصر الآمنة في قالب التطبيق، ستقوم أولا بتسجيله مع النظام الأساسي. للقيام بذلك، أضف عنصر تطبيق تعيين ويب جديد وحدد عنوان URL لقالب التطبيق المستضاف على خادم الويب.
بعد إضافة العنصر، سيتعين تسجيل التطبيق. لأن هذا تطبيق ويب، اجعل النوع قيد التعيين على Browser مع Redirect URI الإشارة إلى عنوان URL لتطبيق القالب.
بمجرد تسجيل التطبيق، ينبغي الحصول على مُعرف تطبيق فريد.
التعامل مع مدير الهوية للتعرف على مُعرف التطبيق المُسجل. لمزيد من المعلومات، راجع موضوع OAuth الأساسي و العناصر المنبثقة OAuth ونماذج OAuth المُضمنة مع ArcGIS API for JavaScipt.
مجموعة
تعرض قوالب المجموعة المحتوى من المجموعة المحددة كتطبيق.
يوفر ArcGIS REST API الوصول إلى المحتوى من البوابة الإلكترونية. يمكنك استخدامه لاسترداد محتوى المجموعة المستند إلى الرقم التعريفي للمجموعة المدخلة.
في هذا المثال، تقوم بالاستعلام لإيجاد مجموعة ذات معرف إدخال.
var portal = new esri.arcgis.Portal('https://webadaptorhost.domain.com/webadaptorname/');
dojo.connect(portal, 'onLoad',function(){
portal.queryGroup(groupid).then(function(response){
var group = response.results[0];
});
});بمجرد عثورك على المجموعة، يمكنك الاستعلام لاسترداد العناصر من المجموعة. في هذا المثال، ستقوم بالاستعلام عن المجموعة لإيجاد خمس عناصر من نوع Web Map أو Web Mapping Application.var queryParams = {
q: 'type:"Web Map" -type:"Web Mapping Application"',
num: 5
};
group.queryItems(queryParams).then(function(response){
var groupItems = response.results;
});
اعتبارات إضافية
تم تصميم تطبيقات الويب للتعامل مع الأنواع المختلفة للمحتوى، لذلك يمكن أن تحتاج إلى إعداد القالب لمعالجة الخرائط مع خرائط أساس خريطة Bing، المحتوى غير العام، وهكذا. الاعتبارات المعينة مدرجة أدناه.
مفتاح خرائط Bing
إذا كان أي من خرائط الويب التي ترغب في عرضها تستخدم خريطة أساس خريطة Bing، ستحتاج إلى تضمين مفتاح خرائط Bing في التطبيق. يتم توفير مفتاح خرائط Bing كمعلمات في أسلوب createMap.
ملفات دعم Proxy و CORS
في حالة قيام التطبيق بإنشاء طلبات عبر المجال، ستحتاج إلى تمكين مشاركة موارد الأصل المتداخل أو إضافة الوكيل إلى التطبيق.
إضافة القالب إلى البوابة الإلكترونية
بمجرد إنشاء القالب واستضافته على خادم الويب إضافة القالب إلى البوابة الإلكترونية في شكل تطبيق ويب، وحدد عنوان URL الخاص بالتطبيق. للهدف، اختر قابل للتكوين. فيما يتعلق بواجهة برمجة التطبيقات، اختر JavaScript.
تأكد من تضمين ملخص وعنوان وصفي وذلك لأن هذه المعلومات يتم عرضها عند قيام المستخدمين بتحويم المؤشر حول عنصر القالب في معرض القوالب. اختياريًا، يمكنك إنشاء ملف ZIP يتضمن ملفات التطبيق وأرفقه بالعنصر لدعم إمكانية توافق التنزيل.
استخدم القالب في معرض تطبيق المؤسسة
إذا كنت ترغب في استخدام القالب في معرض تطبيق عارض خريطة المؤسسة أو معرض تطبيق المجموعة شارك العنصر مع المجموعة المُستخدمة لهذا المعرض. يُمكن لمسئول المنظمة بعد ذلك تكوين عارض الخرائط أو تكوين المجموعات لاستخدام المجموعة التي تتضمن القالب.