Skip To Content

معلمات عنوان URL

يمكن تعديل التطبيقات التي يتم إنشاؤها باستخدام 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. يُمكن استخدام الفواصل أو الفواصل المنقوطة كفواصل. استخدم الفواصل المنقوطة في حالة استخدام الأرقام للفواصل بصفتها علامات عشرية.

ما يلي الإحداثيات الجغرافية مثل:

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

العثور على الموقع أو المعلم لفتح الخريطة

للعثور على الموقع أو المعلم المستخدم لفتح الخريطة، استخدم 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 التي قمت بتحديدها. قم بإزالة واجهة المشاركة من التطبيق عند عدم الضرورة.

تنبيه:

تكون كل المعلمات حساسة لحالة الأحرف، ويجب تكويدها.

نظرًا لإمكانية تغيير اسم الطبقة، يُوصى بشدة استخدام مُعرّف الطبقة في الاستعلام. يمكنك استرداد معرف الطبقة من معرف خريطة الويب كما هو موضح أدناه: 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,1211537
http://<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,California
http://<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,1211537
http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_3217_3,POP2000=1211537

تبديل الإعدادات المحلية

لتغيير لغة التطبيق، استخدم 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

مصادقة المستخدم

لمصادقة المستخدم تلقائيًا في تطبيق غير عام، استخدم token=<token>. بهذه الطريقة، لا يجب على المستخدمين إدخال اسم المستخدم وكلمة المرور. فيما يلي أحد الأمثلة:

http://<your portal url>/apps/webappviewer/index.html?token=utmVcabc_LNyEQ7OuuHD73em0MErLR_cudJTeSIdMFTnL0poF3shVBeng5ieWHyZn0kAA8nhUg7jseQxz3bi5crnFMMpldDiJLrtzmO3jEM-ZNVIUEh5_qMms-YgXUwGgFbeQlM9WaI3jwraUqwah0yCceBAxEkEIAEWvlBEDfVsYs3LZydORRcs2QIcdLas

يمكنك التحكم عند تشغيل التخطيط الطباعي للجوال

يدعم التطبيق اثنين من أنماط التخطيط الطباعي المستند إلى حجم الشاشة. واحد لسطح المكتب والأخر لأجهزة الجوال. عندما يظهر ارتفاع أو عرض الشاشة أقل من 600 بيكسل، ينطبق التخطيط الطباعي للجوال تلقائيًا. ومع ذلك، فإن ذلك قد يكون ناتج عن سلوك غير متوقع عند تضمين التطبيق في شبكة الإنترنت، على سبيل المثال، عندما يكون العنصر المنبثق في شبكة الإنترنت هو أسلوب تخطيط المحمول. للتحكم في نمط التخطيط الطباعي، استخدم mobileBreakPoint=<pixel number>. على سبيل المثال، يمكنك أن تبقى في نمط سطح المكتب حتى يكون حجم الشاشة أقل من 300 بيكسل كما هو موضح أدناه:

http://<your portal url>/apps/webappviewer/index.html?mobileBreakPoint=300