يمكن تعديل التطبيقات التي يتم إنشاؤها باستخدام Web AppBuilder بمعلمات عنوان URL مباشرةً. دائمًا ما يبدأ عنوان URL بـ <your portal url>/apps/webappviewer/index.html? ويشمل معلمًا واحدًا أو أكثر من معلمات الاستعلامات المُدرجة أدناه. لتضمين أكثر من معطى، قم باستخدام علامة العطف (&) لفصل المعطيات عن بعضها. فيما يلي أحد الأمثلة:
http://<your portal url>/apps/webappviewer/index.html?id=6815e148ff1c4aee8dc7159816380a4d&webmap=9cf053ea602345ddae060010c470e615تلميح:
يوجد الآن طريقة سهلة لإنشاء معلمات عنوان URL. أضف عنصر واجهة استخدام مشاركة في التطبيق وانقر فوق خيارات الارتباط. معاينة الارتباط تعرض المعلمات التي قمت بتحديدها ورابط مفتاح الاختصار يتضمن معلمات عنوان URL يتم إنشاؤه تلقائيًا لك. كن على دراية بإن عنصر واجهة البحث يجب أن يكون قابل في التطبيق لإستخدام find المُعلم.
ملاحظة:
لا تدعم التطبيقات ثلاثية الأبعاد الحالية معلمات URL.
ترميز جميع معلمات الاستعلام
يجب ترميز جميع معطيات الاستعلام. يستبدل الترميز الحروف غير الصحيحة بـ % متبوعة بشكل سدادسي مكافئ لها.
على سبيل المثال، فيما يلي معطيات عنوان URL التي لم يتم ترميزها:http://<your portal url>/apps/webappviewer/index.html?find=380 new york street, redlands, ca
فيما يلي نفس المعطيات التي تم ترميزها:http://<your portal url>/apps/webappviewer/index.html?find=380%20new%20york%20street,%20redlands,%20ca
يحتوي الويب على العديد من المواقع والأدوات المتوفرة لإنشاء عناوين URL المكودة. على سبيل المثال، شركة Albion Research المحدودة، لديها صفحة لترميز عنوان URL وفك ترميز عنوان URL. من أجل سهولة القراءة، لا يتم ترميز بقية الأمثلة في هذا الموضوع.
افتح التطبيق المحفوظ
لفتح تطبيق محفوظ تم إنشاؤه بـ Web AppBuilder، استخدم id= والمُعرف الفريد للتطبيق كالمثال التالي:
http://<your portal url>/apps/webappviewer/index.html?id=6815e148ff1c4aee8dc7159816380a4dتعريف خريطة الويب
لتعريف خريطة الويب، استخدام webmap= الرقم التعريفي الفريد لخريطة الويب.
http://<your portal url>/apps/webappviewer/index.html?webmap=9cf053ea602345ddae060010c470e615مركز تعيين الخريطة
لتمركز الخريطة في موقع محدد، قم بتعيين center= باستخدام الإحداثيات الجغرافية (س، ص) أو الإحداثيات المُسقطة (س، ص، WKID).
تنبيه:
يُمكن استخدام الفواصل أو الفواصل المنقوطة كفواصل. استخدم الفواصل المنقوطة في حالة استخدام الأرقام للفواصل بصفتها علامات عشرية.
ما يلي الإحداثيات الجغرافية مثل:
http://<your portal url>/apps/webappviewer/index.html?center=34,-50ما يلي الإحداثيات المتوقعة مثل:
http://<your portal url>/apps/webappviewer/index.html?center=500000,5500000,102100تعريف مستوى المقياس
لتعريف مستوى مقياس رسم الخريطة، استخدم center= و level=معلمات. تقبل level معلمة مُعرّف مستوى مقياس رسم ذاكرة التخزين المؤقت كما هو مدرج في REST نقطة نهاية خدمة الخريطة. فيما يلي أحد الأمثلة:
http://<your portal url>/apps/webappviewer/index.html?center=20,45&level=4عرف مستوى المقياس
لتعريف مقياس رسم الخريطة، استخدم center= وscale=معلمات. تقبل scale معلمة مستوى مقياس رسم ذاكرة التخزين المؤقت كما هو مدرج في REST في نقطة نهاية خدمة الخريطة. فيما يلي أحد الأمثلة:
http://<your portal url>/apps/webappviewer/index.html?center=20,45&scale=4622324تعريف المدى
لتعريف مدى الخريطة، استخدم extent=. تقبل معلمة extent الإحداثيات الجغرافية (GCS) مثل MinX,MinY,MaxX,MaxY أو الإحداثيات المسقطة (PCS) مثل MinX,MinY,MaxX,MaxY,WKID, أو سلسلة نصية معروفة (WKT) مثل MinX,MinY,MaxX,MaxY,WKT. يُمكن استخدام الفواصل أو الفواصل المنقوطة كفواصل. استخدم الفواصل المنقوطة في حالة استخدام الأرقام للفواصل بصفتها علامات عشرية.
ما يلي الإحداثيات الجغرافية مثل:
http://<your portal url>/apps/webappviewer/index.html?extent=-117.20,34.055,-117.19,34.06ما يلي الإحداثيات المتوقعة مثل:
http://<your portal url>/apps/webappviewer/index.html?extent=-13079253.954115,3959110.38566837,-12918205.318785,4086639.70193162,102113فيما يلي مثال على "سلسلة نصية معروفة":
http://<your portal url>/apps/webappviewer/index.html?extent=1008562.1255,1847133.031,1060087.7901,1877230.7859,wkt=PROJCS["NAD_1983_HARN_StatePlane_Illinois_East_FIPS_1201",GEOGCS["GCS_North_American_1983_HARN",DATUM["D_North_American_1983_HARN",SPHEROID["GRS_1980",6378137.0,298.257222101]]العثور على الموقع أو المعلم لفتح الخريطة
للعثور على الموقع أو المعلم المستخدم لفتح الخريطة، استخدم find=. يتم تكبير/تصغير الخريطة تلقائيًا إلى أقرب حالة مطابقة وتم إضافة محدد وسيلة الشرح إلى الخريطة. تقبل معلمة find العناوين أحادية الخط والعناوين الجزئية (مثل مدينة فقط أو دولة فقط) وأسماء الأماكن وإحداثيات خط الطول-دائرة العرض وكذلك المعالم في الطبقات التي يمكن البحث فيها (مثل 1916352001 لرقم تعريف قطعة الأرض (PIN)). فيما يلي أحد الأمثلة:
http://<your portal url>/apps/webappviewer/index.html?find=380 new york street, redlands, caتنبيه:
يجب أن يتم ترميز معلمات الأستفسار و يجب ان تكون ,واجهة البحث مقبولة في التطبيق لاستخدام المعلم.
إضافة نُقطة
لإضافة نقطة إلى الخريطة، استخدم marker=<x>,<y>. يتم إضافة النقطة إلى الخريطة في موقع x وy المُحدد. يُمكن أيضًا تضمين الخصائص الاختيارية التالية:
- <wkid>- الإسناد المكاني لإحداثيات x وy المُضافة إلى الخريطة. إذا لم تقم بتضمين WDLD، سيتم استخدام إحداثيات GCS.
- <العنوان المُكوّد>-عنوان العنصر المنبثق للنقطة. إذا لم تقم بتضمين العنوان، ستصبح العناصر المنبثقة فارغة.
- <عنوان URL للأيقونة المكودة>-رمز النقطة. إذا كنت لا ترغب في تضمين الرمز، سيتم استخدام رمز علامة زرقاء.
- <التسمية المكودة-التسمية المجاورة لرمز النقطة.
يجب ملاحظة ما يلي:
- <x>,<y> مطلوبة.
- تأكد من تكويد معلمات العنوان والأيقونة والتسمية.
- يجب إضافة الخصائص بهذا الترتيب: marker=<x>,<y>,<wkid>,<عنوان URL للأيقونة المكودة>,<التسمية المكودة>.
- يُمكن استخدام الفواصل أو الفواصل المنقوطة كفواصل. استخدم الفواصل المنقوطة في حالة استخدام الأرقام للفواصل بصفتها علامات عشرية.
- استخدم القيم الفارغة. لا تستخدم الفواصل. مثال، إذا كنت ترغب في تحديد تسمية ولا شيء من الخصائص الاختيارية الأخرى، أضف التسمية كالمعلمة السادسة بقيم فارغة للأخريات (x;y;;;;label).
- إذا كنت ترغب في تكبير الخريطة (إضافةً إلى التمركز على النقطة)، قم بتضمين معلمة level=.
فيما يلي أحد الأمثلة:
http://<your portal url>/apps/webappviewer/index.html?marker=-79.234826;38.147884;;Race start and finish;;Grindstone 100 Ultra Marathon&level=7معلمة الاستعلام
للاستعلام عن المعلم تكبيره/تصغيره، يمكنك استخدام أحد الخيارات التالية:
- query=<layer name>,<field name>,<field value>
- query=<layer name>, <where clause>
- query=<layer id>,<field name>,<field value>
- query=<layer id>, <where clause>
تلميح:
يوجد الآن طريقة لإنشاء معلمات عنوان URL بشكل تفاعلي. أضف عنصر واجهة استخدام مشاركة في التطبيق وانقر فوق خيارات الارتباط. اختر خيار الاستعلام عن معلم وتكبيره/تصغيره وحدد الطبقة والحقل وقيمة الحقل التي ترغب في الاستعلام عنها. انسخ عنوان URL فيمعاينة الرابط التي تحتوي على معلمات URL التي قمت بتحديدها. قم بإزالة واجهة المشاركة من التطبيق عند عدم الضرورة.
تنبيه:
تكون كل المعلمات حساسة لحالة الأحرف، ويجب تكويدها.
تتبع "عبارة أين" معايير SQL. عندما يكون لدى "عبارة أين" عملية IN، استخدم الفاصلة المنقوطة بدلاً من فصل اسم الطبقة أو المعرف من "عبارة أين" بفاصلات كما هو معروض أدناه. يكمن السبب في استخدام فاصلة في "عبارة أين"، خصوصًا لإنشاء قائمة القيم، مثل ('A11', 'A12', 'A13) أو ('Charlotte', 'Chicago'). يتيح ذلك تحليل معلمة الاستعلام بشكل مناسب لتمييز ماهية الطبقة و"عبارة أين".
- query=<layer name>; <where clause>
- query=<layer id>; <where clause>
نظرًا لإمكانية تغيير اسم الطبقة، يُوصى بشدة استخدام مُعرّف الطبقة في الاستعلام. يمكنك استرداد معرف الطبقة من معرف خريطة الويب كما هو موضح أدناه: http://<your portal url>/sharing/rest/content/items/32a83775654249dcae6b8f2eff5d4072/data/?f=pjson
تنبيه:
تأكد من مشاركة خريطة الويب علنًا عند استرداد معرف الطبقة
على سبيل المثال، يتم إضافة الطبقة في الخريطة فرديًا كما هو موضح أدناه في تنسيق JSON. معرف الطبقة هو Census_8491، واسم الحقل هو POP2000، وقيمة الحقل هي 1211537. يمكنك إجراء الاستعلامات التالية:id: "Census_8491",
layerType: "ArcGISFeatureLayer",
url: "http://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer/3",
visibility: true,
opacity: 1,
mode: 1,
title: "Census - states",
http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_8491,POP2000,1211537http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_8491,POP2000=1211537يمكنك أيضًا الاستعلام عن سلسلة أو حقول ObjectID.
http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_8491,STATE_NAME,Californiahttp://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_8491,STATE_NAME='California'http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_8491,OBJECTID,1يتم غالبًا إضافة الطبقة في صورة مجموعة لخدمة الخريطة. للاستعلام عن طبقة فرعية في مجموعة، استخدم <layer id_sublayer id> في صورة معرف الطبقة بدلاً من ذلك. يمكنك اتخاذ الطبقة التالية كمثال، يكون معرف الطبقة Census_3217 وفهرس معرف الطبقة الفرعية هو 3. معرف الطبقة للطبقة الفرعية ينبغي أن يكون Census_3217_3. يمكنك إجراء الاستعلامات التالية:
id: "Census_3217", layerType: "ArcGISMapServiceLayer", url: "http://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer", visibility: true, opacity: 1,
title: "Census"
http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_3217_3,POP2000,1211537http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_3217_3,POP2000=1211537http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_8491;STATE_NAME in ('California', '')
تبديل الإعدادات المحلية
لتغيير لغة التطبيق، استخدم locale=<language code>. أكواد اللغة المدعومة هي: ar وcs وda وde وen وel وes وet وfi وfr وhe وit وja وko وlt وlv وnb وnl وpl وpt-br وpt-pt وro وru وsv وth وtr وzh-cn وvi وzh-hk وzh-tw.
فيما يلي أحد الأمثلة:
http://<your portal url>/apps/webappviewer/index.html?locale=frيمكنك التحكم عند تشغيل التخطيط الطباعي للجوال
يدعم التطبيق اثنين من أنماط التخطيط الطباعي المستند إلى حجم الشاشة. واحد لسطح المكتب والأخر لأجهزة الجوال. عندما يظهر ارتفاع أو عرض الشاشة أقل من 600 بيكسل، ينطبق التخطيط الطباعي للجوال تلقائيًا. ومع ذلك، فإن ذلك قد يكون ناتج عن سلوك غير متوقع عند تضمين التطبيق في شبكة الإنترنت، على سبيل المثال، عندما يكون العنصر المنبثق في شبكة الإنترنت هو أسلوب تخطيط المحمول. للتحكم في نمط التخطيط الطباعي، استخدم mobileBreakPoint=<pixel number>. على سبيل المثال، يمكنك أن تبقى في نمط سطح المكتب حتى يكون حجم الشاشة أقل من 300 بيكسل كما هو موضح أدناه:
http://<your portal url>/apps/webappviewer/index.html?mobileBreakPoint=300