يعتبر إضافة إسناد عنوان URL إلى تطبيق حالي طريقة فعالة لمشاركة عملك مع أعضاء مؤسستك والجميع (استنادًا إلى امتيازات المشاركة التي تتمتع بها). بالإضافة إلى عنوان URL، يمكنك مشاركة تفاصيل أخرى مثل نوع التطبيق والغرض منه وملخصًا ووصفًا وملف .zip يحتوي على التعليمات البرمجية التي استخدمتها لإنشاء التطبيق. تؤدي إضافة التطبيق إلى ArcGIS Online فقط إلى إضافة إسناد إلى عنوان URL للتطبيق؛ لا يخزن ArcGIS Online ملفات التطبيق.
بصفتك مطورًا لديه حساب في المؤسسة، يمكنك أيضًا تسجيل التطبيقات باستخدام النظام الأساسي. يتضمن ذلك تسجيل تطبيق OAuth بحيث يمكن لأعضاء المؤسسة والمستخدمين من خارج المؤسسة تسجيل الدخول إلى التطبيق. راجع قسم إضافة تطبيق وتسجيله باستخدام بيانات اعتماد المطور أدناه لمزيد من المعلومات.
إذا لم تكن بحاجة إلى تسجيل تطبيقك - على سبيل المثال، عند تحميل نموذج التعليمات البرمجية - فاتبع الخطوات الواردة في قسم إضافة تطبيق من عنوان URL أدناه.
تلميح:
هناك طريقة أخرى لمشاركة التطبيقات مع أعضاء المؤسسة والجميع وهي إنشاء تطبيقات مع خرائط و تطبيقات المعرض مع المجموعات.
إضافة تطبيق من عنوان URL
اتبع هذه الخطوات لإضافة عنصر يستخدم عنوان URL للوصول إلى تطبيق على الويب ولكن لا يحتاج إلى التسجيل (على سبيل المثال، نماذج التعليمات البرمجية):
ملاحظة:
لإضافة تطبيق مسجل، اتبع الخطوات لإضافة تطبيق وتسجيله باستخدام بيانات اعتماد المطور.
- تحقق من تسجيل الدخول والحصول على امتياز إنشاء المحتوى وتحديثه وحذفه.
- من علامة تبويب المحتوى الخاص بي في صفحة المحتوى، انقر فوق عنصر جديد ثم انقر فوق تطبيق.
- اختر نوع التطبيق:
- رسم الخرائط على الويب - تطبيق ويب متضمن مع واجهة برمجة تطبيقات الويب، مثل JavaScript.
- سطح المكتب—تطبيق لأجهزة سطح المكتب مدمج مع نظام سطح المكتب مثل Java أو .NET (سطح مكتب Microsoft Windows).
- المحمول—تطبيق قابل للتنزيل مدمج مع أجهزة المحمول مع SDK، مثل iOS أو Android.
- تطبيق آخر—تطبيق سطح مكتب أو برنامج Python نصي أو أي نوع تطبيق عام لا تتوفر لديك تفاصيل عن الغرض منه أو عن API أو SDK أو عنوان URL.
- بالنسبة إلى رسم الخرائط على الويب، أو سطح المكتب، أو الجوال، اكتب عنوان URL للتطبيق، على سبيل المثال، https://<myServer>/myWebMapApp.
- بالنسبة إلى تطبيقات سطح المكتب، انقر فوق استعراض واختر ملف .zip الذي يحتوي على التطبيق.
- انقر فوق التالي.
- أدخل عنوانًا.
- اختر مجلدًا في المحتوى الخاص بي والذي تريد حفظ العنصر فيه.
وبدلاً من ذلك، يمكنك اختيار إنشاء مجلد جديد من القائمة وكتابة اسم المجلد لحفظ العنصر في مجلد جديد.
لا يمكن أن تحتوي أسماء المجلدات على حروف Unicode مكونة من 4 بايت.
- إذا قامت مؤسستك بإعداد فئات المحتوى، فانقر فوق تعيين الفئات وحدد 20 فئة بحد أقصى لمساعدة المستخدمين في العثور على العنصر.
يمكنك أيضًا البدء في كتابة اسم الفئة لتضييق قائمة الفئات.
- اختياريًا، اكتب العلامات التي تصف العنصر.
افصل المصطلحات بفواصل (مثال، يتم اعتبار الأرض الفيدرالية علامة واحدة، والأرض، الفيدرالية علامتين).
أثناء الكتابة، يمكنك اختيار أي من العلامات المقترحة التي تظهر؛ يتم إنشاء الاقتراحات من العلامات التي أضفتها مسبقًا.
- اختياريًا، أضف ملخصًا يصف التطبيق.
- انقر حفظ.
بمجرد إضافة التطبيق، يظهر في المحتوى الخاص بك. إذا كنت بحاجة إلى تسجيله لاحقًا، يمكنك القيام بذلك من علامة التبويب الإعدادات في صفحة عنصر التطبيق. راجع قسم إضافة تطبيق وتسجيله باستخدام بيانات اعتماد المطور أدناه لمزيد من المعلومات.
يمكنك تكوين تفاصيل العنصر وإرفاق التعليمات البرمجية إذا لزم الأمر ومشاركة التطبيق إذا كانت لديك امتيازات المشاركة.
إنشاء عناصر بيانات اعتماد المطور
بصفتك مُطورًا يمتلك حسابًا مؤسسيًا، قم بإنشاء عنصر بيانات اعتماد المطور لتوليد مُعرِف تطبيق. استخدم مُعرف التطبيق في التطبيق لتجميع إحصائيات الاستخدام وللسماح للمستخدمين بتسجيل الدخول إلى النظام الأساسي باستخدام OAuth 2.0 وإطار عمل التخويل القياسي. في OAuth 2.0، ترشد التطبيقات المستخدم إلى تسجيل الدخول على النظام الأساسي من خلال صفحة تسجيل دخول مستضافة على النظام الأساسي. كما يسمح للتطبيق بالعمل مع محتوى المستخدم المرتبط بمؤسسته بالإضافة إلى العمل مع إمكانات ArcGIS Online الأخرى مثل التكويد الجغرافي والتوجيه وGeoEnrichment. لمعرفة المزيد عن المصادقة وOAuth 2.0، راجع Esri Developer.
يمكنك أيضًا إنشاء بيانات اعتماد المطور لمصادقة التطبيق وللحصول على مفاتيح واجهة برمجة التطبيقات (API).
يعتمد نوع بيانات اعتماد المطور التي يمكنك إنشاؤها على امتيازاتك في المؤسسة. إذا كنت عضوًا في دور المسؤول الافتراضي أو عضوًا في دور مخصص يتمتع بامتياز إنشاء مفاتيح واجهة برمجة التطبيقات (API)، يمكنك استخدام إما OAuth 2.0 أو بيانات اعتماد مفاتيح واجهة برمجة التطبيقات (API). وخلاف ذلك، يمكنك استخدام بيانات اعتماد المطور OAuth 2.0 فقط.
بمجرد إنشاء بيانات اعتماد المطور، انقر فوق عرض الاستخدام في علامة التبويب الإعدادات في صفحة عنصر التطبيق للوصول إلى معلومات عن الأشخاص الذين قاموا بتسجيل الدخول إلى التطبيق وعدد الأرصدة التي استهلكوها. يمكنك أيضًا إدارة الإعدادات الخاصة ببيانات الاعتماد المضمنة في التطبيق.
ملاحظة:
لا يتوفر قسم عرض الاستخدام عند تسجيل الدخول عبر اشتراك ArcGIS Location Platform.
يختلف نمط التنفيذ في تسجيلات دخول المستخدم اختلافًا طفيفًا اعتمادًا على ما إذا كنت تطور تطبيقًا مستندًا إلى الويب أو تطبيقًا أصليًا. تحتوي وثائق Esri Developer على تفاصيل ونماذج التعليمات البرمجية لكل من التطبيقات المستندة إلى الويب والتطبيقات الأصلية.
إنشاء بيانات اعتماد OAuth 2.0 لمصادقة المستخدم
أكمل الخطوات التالية إذا كان تطبيقك يُلزم المستخدمين بتسجيل الدخول باستخدام حساب ArcGIS Online.
- تأكد من تسجيل الدخول باستخدام حساب مؤسسي يمتلك امتيازات إنشاء المحتوى وتحديثه وحذفه.
- انقر فوق علامة تبويب المحتوى الخاص بي في صفحة المحتوى وانقر فوق عنصر جديد.
- في نافذة عنصر جديد، انقر فوق بيانات اعتماد المطور.
ستختلف النافذة الأولى المقدمة لك حسب امتيازاتك في المؤسسة. إذا كنت عضوًا في دور لا يتضمن امتياز إنشاء مفاتيح واجهة برمجة التطبيقات (API)، فانتقل إلى الخطوة 5. إذا كان دورك يتضمن امتيازات لإنشاء مفاتيح واجهة برمجة التطبيقات (API)، فانتقل إلى الخطوة 4.
- اختر خيار بيانات اعتماد OAuth 2.0—لمصادقة المستخدم ثم انقر فوق التالي.
- ضمن عناوين URL لإعادة التوجيه، أدخل عنوان URL لصفحة ويب أو نقطة نهاية الخادم التي سيتم استخدامها لإعادة توجيه المستخدمين بعد تسجيل الدخول بنجاح. انقر فوق إضافة لإضافة المزيد من عناوين URL لإعادة التوجيه حسب الحاجة.
يجب أن تتطابق عناوين URL لإعادة التوجيه المحددة أثناء التخويل مع أحد عناوين URL المسجلة، وإلا فسيتم رفض التخويل.
يمكن تحديد قيمة خاصة لـ urn:ietf:wg:oauth:2.0:oob لعمليات منح التخويل. يؤدي ذلك إلى تسليم رمز التخويل إلى عنوان URL للبوابة الإلكترونية (/oauth2/approval). عادة ما تُستخدم هذه القيمة بواسطة التطبيقات التي لا تحتوي على خادم ويب أو مخطط URL مخصص حيث يمكن تسليم الرمز.
فيما يلي أمثلة على تنسيقات عناوين URL المدعومة لإعادة التوجيه:
- https://app.foo.com
- urn:ietf:wg:oauth:2.0:oob
- في مربع عنوان URL، اكتب عنوان URL لتطبيقك بتنسيق https://<myServer>/myWebMapApp.
- انقر فوق التالي.
- أدخل عنوانًا.
- اختر مجلدًا في المحتوى الخاص بي والذي تريد حفظ العنصر فيه.
وبدلاً من ذلك، يمكنك اختيار إنشاء مجلد جديد من القائمة وكتابة اسم المجلد لحفظ العنصر في مجلد جديد.
لا يمكن أن تحتوي أسماء المجلدات على حروف Unicode مكونة من 4 بايت.
- إذا قامت مؤسستك بإعداد فئات المحتوى، فانقر فوق تعيين الفئات وحدد 20 فئة بحد أقصى لمساعدة المستخدمين في العثور على العنصر.
يمكنك أيضًا البدء في كتابة اسم الفئة لتضييق قائمة الفئات.
- اختياريًا، اكتب العلامات التي تصف العنصر.
افصل المصطلحات بفواصل (مثال، يتم اعتبار الأرض الفيدرالية علامة واحدة، والأرض، الفيدرالية علامتين).
أثناء الكتابة، يمكنك اختيار أي من العلامات المقترحة التي تظهر؛ يتم إنشاء الاقتراحات من العلامات التي أضفتها مسبقًا.
- اختياريًا، أضف ملخصًا يصف التطبيق.
- انقر فوق التالي.
يتم عرض ملخص بيانات الاعتماد.
- قم بمراجعة ملخص بيانات الاعتماد. لتغيير الإعدادات، استخدم النقر فوق السابق لإجراء التغييرات قبل إنشاء العنصر.
- انقر على إنشاء.
تتم إضافة التطبيق إلى محتواك وتظهر صفحة العنصر الخاصة به. تظهر شارة 
التي تشير إلى استخدام بيانات اعتماد OAuth 2.0 مع التطبيق على صفحة العنصر وعند عرض العنصر من صفحة المحتوى أو أجزاء معاينة العنصر. في علامة التبويب نظرة عامة في صفحة العنصر، تشير الشارة إلى ما إذا كانت الامتيازات الشخصية مضمنة أم أن الامتيازات القياسية فقط مضمنة في بيانات الاعتماد.
إنشاء بيانات اعتماد OAuth 2.0 لمصادقة التطبيق
أكمل الخطوات التالية إذا كان تطبيقك العام لا يتطلب تسجيل دخول المستخدمين ويقوم بإنشاء رموز وصول على جانب الخادم.
- تأكد من تسجيل الدخول باستخدام حساب مؤسسي يمتلك امتيازات إنشاء المحتوى وتحديثه وحذفه.
- انقر فوق علامة تبويب المحتوى الخاص بي في صفحة المحتوى وانقر فوق عنصر جديد.
- في نافذة عنصر جديد، انقر فوق بيانات اعتماد المطور.
ستختلف النافذة الأولى المقدمة لك حسب امتيازاتك في المؤسسة. إذا كنت عضوًا في دور لا يتضمن امتياز إنشاء مفاتيح واجهة برمجة التطبيقات (API)، فانتقل إلى الخطوة 5. إذا كان دورك يتضمن امتيازات لإنشاء مفاتيح واجهة برمجة التطبيقات (API)، فانتقل إلى الخطوة 4.
- اختر خيار بيانات اعتماد OAuth 2.0—لمصادقة التطبيق ثم انقر فوق التالي.
- ضمن أين ستستخدم بيانات الاعتماد هذه، اختر أحد الخيارات التالية:
- تطبيق خاص بامتيازات وإمكانية وصول محددة—حدد هذا الخيار لمنح إمكانية الوصول لأي مجموعة من العناصر والامتيازات الخاصة بك. يمكنك تضمين ذلك في تطبيق خاص أو في مكون يعمل من جهة الخادم يُستخدم بواسطة تطبيق عام.
- تطبيق خاص ينتحل شخصيتكحدد هذا الخيار لمنح جميع امتيازاتك الحالية، بالإضافة إلى حق الوصول إلى محتوى المؤسسة وأعضائها وإعداداتها.
- انقر فوق التالي.
- اختياريًا، إذا حددت تطبيق عام، فاختر أحد الخيارات التالية:
- عدم الوصول إلى العنصر—لا تتطلب بيانات الاعتماد هذه الوصول إلى أي عناصر. انقر فوق التالي.
- منح حق الوصول للعنصر باستخدام الامتيازات—امتيازات Select مطلوبة للسماح بالوصول إلى العناصر لبيانات الاعتماد هذه. انقر فوق التالي.
- منح حق الوصول لعناصر محددة—يجب عليك أولاً تحديد العناصر التي تمتلكها وترغب في منح حق الوصول إليها. انقر فوق التالي.
- اختياريًا، إذا حددت تطبيق خاص بالامتيازات وإمكانية الوصول المحددة، فاختر الإجراءات التي ستسمح بيانات الاعتماد للتطبيق بتنفيذها عن طريق تعيين امتيازات. انقر فوق التالي.
ستختلف قائمة الامتيازات المتاحة لك بناءً على ما إذا كان لديك اشتراك في ArcGIS Location Platform أم لا والامتيازات التي تتمتع بها في المؤسسة. لا يمكنك منح امتيازات لا يمتلكها حسابك.
للحصول على معلومات عن أنواع الامتيازات، راجع دليل الأمان والمصادقة في تعليمات مطوري Esri.
- انقر فوق التالي.
- ضمن عناوين URL المرجعية، قم بتوفير عنوان URL أو عنوان IP المسموح له بالاتصال بالتطبيق. انقر فوق إضافة لإضافة المزيد من عناوين URL المرجعية أو عناوين IP المطلوبة.
يجب أن تتطابق عناوين URL المحددة في أثناء التخويل مع أحد عناوين URL المسجلة، وإلا فسيتم رفض التخويل.
فيما يلي أمثلة على تنسيقات عناوين URL المدعومة للمرجع:
- https://www.example.com/pages
- https://www.example.com/pages/index.html
- انقر فوق التالي.
- أدخل عنوانًا.
- اختر مجلدًا في المحتوى الخاص بي والذي تريد حفظ العنصر فيه.
وبدلاً من ذلك، يمكنك اختيار إنشاء مجلد جديد من القائمة وكتابة اسم المجلد لحفظ العنصر في مجلد جديد.
لا يمكن أن تحتوي أسماء المجلدات على حروف Unicode مكونة من 4 بايت.
- إذا قامت مؤسستك بإعداد فئات المحتوى، فانقر فوق تعيين الفئات وحدد 20 فئة بحد أقصى لمساعدة المستخدمين في العثور على العنصر.
يمكنك أيضًا البدء في كتابة اسم الفئة لتضييق قائمة الفئات.
- اختياريًا، اكتب العلامات التي تصف العنصر.
افصل المصطلحات بفواصل (مثال، يتم اعتبار الأرض الفيدرالية علامة واحدة، والأرض، الفيدرالية علامتين).
أثناء الكتابة، يمكنك اختيار أي من العلامات المقترحة التي تظهر؛ يتم إنشاء الاقتراحات من العلامات التي أضفتها مسبقًا.
- اختياريًا، أضف ملخصًا يصف التطبيق.
- انقر فوق التالي.
يتم عرض ملخص بيانات الاعتماد.
- قم بمراجعة ملخص بيانات الاعتماد. لتغيير الإعدادات، استخدم النقر فوق السابق لإجراء التغييرات قبل إنشاء العنصر.
- إذا حددت تطبيقاً خاصاً ينتحل صفتك، فانقر فوق المربع الموجود بجوار أقر وأوافق على متطلبات الأمان المرتبطة بالامتيازات المحددة.
- انقر على إنشاء.
تتم إضافة التطبيق إلى محتواك وتظهر صفحة العنصر الخاصة به. تظهر شارة التي تشير إلى بيانات اعتماد OAuth 2.0 عند عرض العنصر من صفحة المحتوى أو أجزاء معاينة العنصر. في علامة تبويب نظرة عامة في صفحة العنصر، تظهر شارة بيانات اعتماد OAuth 2.0 - تنتحل شخصية مالك العنصر إذا اخترت تطبيق خاص ينتحل شخصيتك ضمن خيار أين ستستخدم بيانات الاعتماد هذه.
إنشاء بيانات اعتماد مفتاح واجهة برمجة التطبيقات (API)
أكمل الخطوات التالية لإنشاء بيانات اعتماد مفتاح واجهة برمجة التطبيقات (API).
- تأكد من تسجيل الدخول باستخدام حساب مؤسسي يمتلك امتيازات إنشاء مفاتيح API بالإضافة إلى امتيازات إنشاء المحتوى وتحديثه وحذفه.
- انقر فوق علامة تبويب المحتوى الخاص بي في صفحة المحتوى وانقر فوق عنصر جديد.
- في نافذة عنصر جديد، انقر فوق بيانات اعتماد المطور.
- اختر خيار بيانات اعتماد مفتاح واجهة برمجة التطبيقات (API) وانقر فوق التالي.
- ضمن أين ستستخدم بيانات الاعتماد هذه، اختر أحد الخيارات التالية:
- تطبيق عام—حدد هذا الخيار لمنح حق الوصول إلى عناصر محددة وامتيازات خدمة.
- تطبيق خاص بامتيازات وإمكانية وصول محددة—حدد هذا الخيار لمنح إمكانية الوصول لأي مجموعة من العناصر والامتيازات. يمكنك تضمين ذلك في تطبيق خاص أو في مكون يعمل من جهة الخادم يُستخدم بواسطة تطبيق عام.
- تطبيق خاص ينتحل شخصيتكحدد هذا الخيار لمنح جميع امتيازاتك الحالية، بالإضافة إلى حق الوصول إلى محتوى المؤسسة وأعضائها وإعداداتها.
- انقر فوق التالي.
- اختياريًا، إذا حددت تطبيق خاص، يُرجى تحديد أحد الخيارات التالية:
- عدم الوصول إلى العنصر—لا تتطلب بيانات الاعتماد هذه الوصول إلى أي عناصر. انقر فوق التالي.
- منح حق الوصول لعناصر محددة—عليك أولاً تحديد عناصر تمتلكها ثم النقر فوق التالي.
- اختياريًا، إذا حددت تطبيق خاص بالامتيازات وإمكانية الوصول المحددة، فحدد أحد الخيارات التالية:
- عدم الوصول إلى العنصر—لا تتطلب بيانات الاعتماد هذه الوصول إلى أي عناصر. انقر فوق التالي.
- منح حق الوصول للعنصر باستخدام الامتيازات—يجب توفر امتيازات معيّنة للسماح لبيانات الاعتماد هذه بالوصول إلى العناصر. انقر فوق التالي.
- منح حق الوصول لعناصر محددة—عليك أولاً تحديد عناصر تمتلكها ثم النقر فوق التالي.
- اختياريًا، إذا حددت تطبيق عام أو تطبيق خاص بالامتيازات وإمكانية الوصول المحددة، فحدد الإجراءات التي ستسمح بيانات الاعتماد للتطبيق بتنفيذها عن طريق تعيين امتيازات. انقر فوق التالي.
ستختلف قائمة الامتيازات المتاحة لك بناءً على ما إذا كان لديك اشتراك ArcGIS Location Platform أم لا والامتيازات التي تتمتع بها في المؤسسة. لا يمكنك منح امتيازات لا يمتلكها حسابك.
للحصول على معلومات عن أنواع الامتيازات، راجع دليل الأمان والمصادقة في تعليمات مطوري Esri.
- اختياريًا إذا حددت تطبيق خاص ينتحل شخصيتك، فاستخدم التقويم لتحديد تاريخ انتهاء صلاحية لبيانات الاعتماد.
يمكن أن تنتهي صلاحية بيانات الاعتماد في اليوم التالي (الحد الأدنى) أو بعد 365 يومًا (الحد الأقصى). تنتهي صلاحيتها الساعة 23:59 في التاريخ الذي تختاره لانتهاء الصلاحية. يتم تخزين الوقت بناءً على وقت المستعرض الخاص بك عند إضافة التطبيق وإنشاء بيانات الاعتماد.
- ضمن عناوين URL لجهة الإحالة، أدخل عنوان URL أو عنوان IP المسموح له بالاتصال بالتطبيق. انقر فوق إضافة لإضافة المزيد من عناوين URL لجهات الإحالة أو عناوين IP إذا لزم الأمر.
يجب أن تتطابق عناوين URL المحددة في أثناء التخويل مع أحد عناوين URL المسجلة، وإلا فسيتم رفض التخويل.
فيما يلي أمثلة على تنسيقات عناوين URL المدعومة للمرجع:
- https://www.example.com/pages
- https://www.example.com/pages/index.html
- انقر فوق التالي.
- أدخل عنوانًا.
- اختر مجلدًا في المحتوى الخاص بي والذي تريد حفظ العنصر فيه.
وبدلاً من ذلك، يمكنك اختيار إنشاء مجلد جديد من القائمة وكتابة اسم المجلد لحفظ العنصر في مجلد جديد.
لا يمكن أن تحتوي أسماء المجلدات على حروف Unicode مكونة من 4 بايت.
- إذا قامت مؤسستك بإعداد فئات المحتوى، فانقر فوق تعيين الفئات وحدد 20 فئة بحد أقصى لمساعدة المستخدمين في العثور على العنصر.
يمكنك أيضًا البدء في كتابة اسم الفئة لتضييق قائمة الفئات.
- اختياريًا، اكتب العلامات التي تصف العنصر.
افصل المصطلحات بفواصل (مثال، يتم اعتبار الأرض الفيدرالية علامة واحدة، والأرض، الفيدرالية علامتين).
أثناء الكتابة، يمكنك اختيار أي من العلامات المقترحة التي تظهر؛ يتم إنشاء الاقتراحات من العلامات التي أضفتها مسبقًا.
- اختياريًا، أضف ملخصًا يصف التطبيق.
- انقر فوق التالي.
يتم عرض ملخص بيانات الاعتماد.
- قم بمراجعة ملخص بيانات الاعتماد. لتغيير الإعدادات، استخدم النقر فوق السابق لإجراء التغييرات قبل إنشاء العنصر.
- إذا حددت تطبيقاً خاصاً ينتحل صفتك، فانقر فوق المربع الموجود بجوار أقر وأوافق على متطلبات الأمان المرتبطة بالامتيازات المحددة.
- انقر على إنشاء.
تتم إضافة التطبيق إلى محتواك وتظهر صفحة العنصر الخاصة به. تظهر شارة 
تشير إلى أن مفتاح واجهة برمجة التطبيقات (API) مضمن مع التطبيق على صفحة العنصر وعند عرض العنصر من صفحة المحتوى أو أجزاء معاينة العنصر. في علامة التبويب نظرة عامة في صفحة العنصر، تشير الشارة إلى ما إذا كانت الامتيازات الشخصية مضمنة أم أن الامتيازات القياسية فقط مضمنة في بيانات الاعتماد.