لإنشاء قالب تطبيق ويب مخصص، يمكنك تنزيل أحد القوالب الحالية وتعديلها أو تحديث تطبيق ويب حالي للتعامل مع المحتوى من البوابة الإلكترونية أو إنشاء تطبيق ويب جديد باستخدام أحد 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، لأن هذه الملفات مدارة بواسطة المدخل، وأي تبديل ستقوم به يمكن أن يؤثر بدوره على المدخل. إذا أردت تخصيص القوالب، قم بما يلي:
- قم بعمل نسخة من ملف القالب الحالي والذي ترغب في تخصيصه.
- ضع النسخة في موقع مختلف على القرص
- قم بتخصيص نسخة من القالب.
- اضفها إلى البوابة الإلكترونية بصفتها قالب جديد.
يشمل هذا الموضوع كيفية إنشاء قالب تطبيق الويب. يُفترض الحصول على الامتيازات لإنشاء المحتويات ومشاركة المجموعات داخل المؤسسة.
خرائط الويب
صُمّمت قوالب التطبيق للتعامل مع خريطة الويب المعروضة حاليًا في Map Viewer. تقوم القوالب بإنشاء الخريطة المستندة إلى خريطة الويب الموجودة في معلمات عنوان 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 Basic و OAuth Popup المتضمنة مع ArcGIS API for JavaScript.
مجموعة
تعرض قوالب المجموعة المحتوى من المجموعة المحددة كتطبيق.
يوفر 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
لأن التطبيق سيقوم بعمل طلبات المجال المتعامد، ستحتاج إلى تمكين CORS أو إضافة وكيل إلى التطبيق.
إضافة القالب إلى البوابة الإلكترونية
بمجرد إنشاء القالب واستضافته على خادم الويب إضافة القالب إلى البوابة الإلكترونية في شكل تطبيق ويب، وحدد عنوان URL الخاص بالتطبيق. للهدف، اختر قابل للتكوين. فيما يتعلق بواجهة برمجة التطبيقات، اختر JavaScript.
تأكد من تضمين ملخص وعنوان وصفي وذلك لأن هذه المعلومات يتم عرضها عند قيام المستخدمين بتحويم المؤشر حول عنصر القالب في معرض القوالب. اختياريًا، يمكنك إنشاء ملف ZIP يتضمن ملفات التطبيق وأرفقه بالعنصر لدعم إمكانية توافق التنزيل.
استخدم القالب في معرض تطبيق المؤسسة
إذا كنت ترغب في استخدام القالب في معرض تطبيق معرض تطبيقات مجموعة Map Viewer الخاص بالمؤسسة، قم بمشاركة العنصر في المجموعة التي هي قيد الاستخدام لذلك المعرض. بعد ذلك، يمكن لمسئول المنظمة تكوين الخريطة أو تكوين المجموعات لاستخدام المجموعة التي تتضمن القالب الخاص بك.