إضافة تطبيق وتسجيله

يعتبر إضافة إسناد عنوان URL إلى تطبيق حالي طريقة فعالة لمشاركة عملك مع أعضاء مؤسستك والجميع (استنادًا إلى امتيازات المشاركة التي تتمتع بها). بالإضافة إلى عنوان URL، يمكنك مشاركة تفاصيل أخرى مثل نوع التطبيق والغرض منه وملخصًا ووصفًا وملف .zip يحتوي على التعليمات البرمجية التي استخدمتها لإنشاء التطبيق. تؤدي إضافة التطبيق إلى ArcGIS Online فقط إلى إضافة إسناد إلى عنوان URL للتطبيق؛ لا يخزن ArcGIS Online ملفات التطبيق.

بصفتك مطورًا لديه حساب في المؤسسة، يمكنك أيضًا تسجيل التطبيقات باستخدام النظام الأساسي. يتضمن ذلك تسجيل تطبيق OAuth بحيث يمكن لأعضاء المؤسسة والمستخدمين من خارج المؤسسة تسجيل الدخول إلى التطبيق. راجع قسم إضافة تطبيق وتسجيله باستخدام بيانات اعتماد المطور أدناه لمزيد من المعلومات.

إذا لم تكن بحاجة إلى تسجيل تطبيقك - على سبيل المثال، عند تحميل نموذج التعليمات البرمجية - فاتبع الخطوات الواردة في قسم إضافة تطبيق من عنوان URL أدناه.

تلميح:

هناك طريقة أخرى لمشاركة التطبيقات مع أعضاء المؤسسة والجميع وهي إنشاء تطبيقات مع خرائط و تطبيقات المعرض مع المجموعات.

إضافة تطبيق من عنوان URL

اتبع هذه الخطوات لإضافة عنصر يستخدم عنوان URL للوصول إلى تطبيق على الويب ولكن لا يحتاج إلى التسجيل (على سبيل المثال، نماذج التعليمات البرمجية):

ملاحظة:‏

لإضافة تطبيق مسجل، اتبع الخطوات لإضافة تطبيق وتسجيله باستخدام بيانات اعتماد المطور.

1. تحقق من تسجيل الدخول والحصول على امتياز إنشاء المحتوى وتحديثه وحذفه.
2. من علامة تبويب المحتوى الخاص بي في صفحة المحتوى، انقر فوق عنصر جديد ثم انقر فوق تطبيق.
3. اختر نوع التطبيق:
   • رسم الخرائط على الويب - تطبيق ويب متضمن مع واجهة برمجة تطبيقات الويب، مثل JavaScript.
   • سطح المكتب—تطبيق لأجهزة سطح المكتب مدمج مع نظام سطح المكتب مثل Java أو .NET (سطح مكتب Microsoft Windows).
   • المحمول—تطبيق قابل للتنزيل مدمج مع أجهزة المحمول مع SDK، مثل iOS أو Android.
   • تطبيق آخر—تطبيق سطح مكتب أو برنامج Python نصي أو أي نوع تطبيق عام لا تتوفر لديك تفاصيل عن الغرض منه أو عن API أو SDK أو عنوان URL.
4. بالنسبة إلى رسم الخرائط على الويب، أو سطح المكتب، أو الجوال، اكتب عنوان URL للتطبيق، على سبيل المثال، https://<myServer>/myWebMapApp.
5. بالنسبة إلى تطبيقات سطح المكتب، انقر فوق استعراض واختر ملف .zip الذي يحتوي على التطبيق.
6. انقر فوق التالي.
7. أدخل عنوانًا.
8. اختر مجلدًا في المحتوى الخاص بي والذي تريد حفظ العنصر فيه.

   وبدلاً من ذلك، يمكنك اختيار إنشاء مجلد جديد من القائمة وكتابة اسم المجلد لحفظ العنصر في مجلد جديد.

   لا يمكن أن تحتوي أسماء المجلدات على حروف Unicode مكونة من 4 بايت.

9. إذا قامت مؤسستك بإعداد فئات المحتوى، فانقر فوق تعيين الفئات وحدد 20 فئة بحد أقصى لمساعدة الأشخاص في العثور على العنصر.

   يمكنك أيضًا البدء في كتابة اسم الفئة لتضييق قائمة الفئات.

10. اختياريًا، اكتب العلامات التي تصف العنصر.

    افصل المصطلحات بفواصل (مثال، يتم اعتبار الأرض الفيدرالية علامة واحدة، والأرض، الفيدرالية علامتين).

    أثناء الكتابة، يمكنك تحديد أي من العلامات المقترحة التي تظهر؛ يتم إنشاء الاقتراحات من العلامات التي أضفتها مسبقًا.

11. اختياريًا، أضف ملخصًا يصف التطبيق.
12. انقر حفظ.

بمجرد إضافة التطبيق، يظهر في المحتوى الخاص بك. إذا كنت بحاجة إلى تسجيله لاحقًا، يمكنك القيام بذلك من علامة التبويب الإعدادات في صفحة عنصر التطبيق. راجع قسم إضافة تطبيق وتسجيله باستخدام بيانات اعتماد المطور أدناه لمزيد من المعلومات.

يمكنك تكوين تفاصيل العنصر وإرفاق التعليمات البرمجية إذا لزم الأمر ومشاركة التطبيق إذا كانت لديك امتيازات المشاركة.

إضافة تطبيق وتسجيله باستخدام بيانات اعتماد المطور

بصفتك مطورًا لديه حساب مؤسسي، يمكنك إضافة التطبيق وتسجيله باستخدام النظام الأساسي لإنشاء معرف التطبيق. استخدم مُعرف التطبيق في التطبيق لتجميع إحصائيات الاستخدام وللسماح للمستخدمين بتسجيل الدخول إلى النظام الأساسي باستخدام OAuth 2.0 وإطار عمل التخويل القياسي. في OAuth 2.0، ترشد التطبيقات المستخدم إلى تسجيل الدخول على النظام الأساسي من خلال صفحة تسجيل دخول مستضافة على النظام الأساسي. كما يسمح للتطبيق بالعمل مع محتوى المستخدم المرتبط بمؤسسته بالإضافة إلى العمل مع إمكانات ArcGIS Online الأخرى مثل التكويد الجغرافي والتوجيه وGeoEnrichment. لمعرفة المزيد عن المصادقة وOAuth 2.0، راجع Esri Developer.

وبدلاً من ذلك، يمكنك تضمين مفتاح واجهة برمجة التطبيقات (API) في التطبيق عند تسجيله.

يعتمد نوع بيانات اعتماد المطور التي يمكنك تضمينها مع التطبيق على امتيازاتك في المؤسسة. إذا كنت عضوًا في دور المسؤول الافتراضي أو عضوًا في دور مخصص يتمتع بامتياز إنشاء مفاتيح واجهة برمجة التطبيقات (API)، فيمكنك استخدام إما OAuth 2.0 أو بيانات اعتماد مفتاح واجهة برمجة التطبيقات (API) في تطبيقك. بخلاف ذلك، يمكنك استخدام بيانات اعتماد مطور OAuth 2.0 فقط في التطبيق.

ملاحظة:‏

يختلف نمط التنفيذ في تسجيلات دخول المستخدم اختلافًا طفيفًا اعتمادًا على ما إذا كنت تطور تطبيقًا مستندًا إلى الويب أو تطبيقًا أصليًا. تحتوي وثائق Esri Developer على تفاصيل ونماذج التعليمات البرمجية لكل من التطبيقات المستندة إلى الويب والتطبيقات الأصلية.

قم بإضافة وتسجيل تطبيق باستخدام بيانات اعتماد OAuth 2.0 المضمنة

عند استخدام بيانات اعتماد OAuth 2.0 مع التطبيقات التي تنشئها، يتم إنشاء رمز الوصول المميز ديناميكيًا عند الوصول إلى التطبيق. رمز الوصول المميز صالح لمدة أقصاها 14 يومًا.

اتبع الخطوات الموضحة أدناه إذا كان دورك لا يتضمن امتياز إنشاء مفاتيح واجهة برمجة التطبيقات (API).

1. تأكد من تسجيل الدخول باستخدام حساب مؤسسي يمتلك امتيازات إنشاء المحتوى وتحديثه وحذفه.
2. انقر فوق علامة تبويب المحتوى الخاص بي في صفحة المحتوى وانقر فوق عنصر جديد.
3. في نافذة عنصر جديد، انقر فوق بيانات اعتماد المطور.
ستختلف النافذة الأولى المقدمة لك حسب امتيازاتك في المؤسسة. إذا كنت عضوًا في دور لا يتضمن امتياز إنشاء مفاتيح واجهة برمجة التطبيقات (API)، فانتقل إلى الخطوة 5. إذا كان دورك يتضمن امتيازات لإنشاء مفاتيح واجهة برمجة التطبيقات (API)، فانتقل إلى الخطوة 4.
4. اختر خيار بيانات اعتماد OAuth 2.0 ثم انقر فوق التالي.
5. ضمن عناوين 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

6. ضمن عناوين URL المرجعية، قم بتوفير عنوان URL أو عنوان IP المسموح له بالاتصال. انقر فوق إضافة لإضافة المزيد من عناوين URL المرجعية أو عناوين IP حسب الحاجة.
7. ضمن بيئة التطبيق، اختر بيئة التطبيق للتطبيق—متعدد أو أصلي أو مستعرض أو خادم.
8. في مربع عنوان URL، اكتب عنوان URL لتطبيقك بتنسيق https://<myServer>/myWebMapApp.
9. انقر فوق التالي.

   إذا كنت عضوًا في دور يتمتع بامتياز تعيين امتيازات لتطبيقات OAuth 2.0، فإن النقر فوق التالي ينقلك إلى نافذة يمكنك من خلالها تحديد ما يُسمح للتطبيق بالقيام به. إذا لم يكن لديك هذا الامتياز، انتقل إلى الخطوة 12.

10. اختر الإجراءات التي ستسمح بيانات الاعتماد للتطبيق بتنفيذها عن طريق تعيين الامتيازات، ثم انقر فوق التالي.

    ستختلف قائمة الامتيازات المتاحة لك بناءً على ما إذا كان لديك اشتراك ArcGIS Location Platform أم لا والامتيازات التي تتمتع بها في المؤسسة. لا يمكنك منح امتيازات لا يمتلكها حسابك.

    للحصول على معلومات عن أنواع الامتيازات، راجع دليل الأمان والمصادقة في تعليمات مطوري Esri.

11. انقر فوق استعراض العناصر واختر العناصر التي يمكن استخدام بيانات الاعتماد المضمنة للوصول إليها، ثم انقر فوق إضافة عناصر.

    وبدلاً من ذلك، يمكنك النقر فوق تخطي.

12. أدخل عنوانًا.
13. اختر مجلدًا في المحتوى الخاص بي والذي تريد حفظ العنصر فيه.

    وبدلاً من ذلك، يمكنك اختيار إنشاء مجلد جديد من القائمة وكتابة اسم المجلد لحفظ العنصر في مجلد جديد.

    لا يمكن أن تحتوي أسماء المجلدات على حروف Unicode مكونة من 4 بايت.

14. إذا قامت مؤسستك بإعداد فئات المحتوى، فانقر فوق تعيين الفئات وحدد 20 فئة بحد أقصى لمساعدة الأشخاص في العثور على العنصر.

    يمكنك أيضًا البدء في كتابة اسم الفئة لتضييق قائمة الفئات.

15. اختياريًا، اكتب العلامات التي تصف العنصر.

    افصل المصطلحات بفواصل (مثال، يتم اعتبار الأرض الفيدرالية علامة واحدة، والأرض، الفيدرالية علامتين).

    أثناء الكتابة، يمكنك تحديد أي من العلامات المقترحة التي تظهر؛ يتم إنشاء الاقتراحات من العلامات التي أضفتها مسبقًا.

16. اختياريًا، أضف ملخصًا يصف التطبيق.
17. انقر فوق التالي.
18. قم بمراجعة ملخص بيانات الاعتماد. لتغيير الإعدادات، استخدم النقر فوق السابق لإجراء التغييرات قبل إنشاء العنصر.
19. إذا منحت امتيازات شخصية فيما يتعلق ببيانات الاعتماد، فقم بالتأشير على المربع بجوار إقرار الأمان لتأكيد قراءتك له وموافقتك عليه، ثم انقر فوق إنشاء لإنشاء بيانات الاعتماد.

تتم إضافة التطبيق إلى محتواك وتظهر صفحة العنصر الخاصة به. تظهر شارة التي تشير إلى استخدام بيانات اعتماد OAuth 2.0 مع التطبيق على صفحة العنصر وعند عرض العنصر من صفحة المحتوى أو أجزاء معاينة العنصر. في علامة التبويب نظرة عامة في صفحة العنصر، تشير الشارة إلى ما إذا كانت الامتيازات الشخصية مضمنة أم أن الامتيازات القياسية فقط مضمنة في بيانات الاعتماد.

يمكنك تكوين تفاصيل العنصر للتطبيق.

انقر فوق عرض الاستخدام في علامة التبويب الإعدادات للوصول إلى معلومات حول الأشخاص الذين قاموا بتسجيل الدخول إلى التطبيق وعدد الأرصدة التي استهلكوها.

ملاحظة:‏

لا يتوفر قسم عرض الاستخدام عند تسجيل الدخول عبر اشتراك ArcGIS Location Platform.

يمكنك أيضًا إدارة الإعدادات الخاصة ببيانات الاعتماد المضمنة مع التطبيق.

قم بإضافة وتسجيل تطبيق باستخدام بيانات اعتماد مفتاح واجهة برمجة التطبيقات (API) المضمنة

استخدم بيانات اعتماد مفتاح واجهة برمجة التطبيقات (API) عندما تحتاج إلى تضمين بيانات الاعتماد في التطبيق، وتحتاج إلى أن يكون المفتاح صالحًا لأكثر من 14 يومًا.

اتبع الخطوات الموضحة أدناه لإضافة تطبيق وإنشاء مفتاح واجهة برمجة التطبيقات (API) مضمن معه لاستخدامه لأغراض المصادقة.

1. تأكد من تسجيل الدخول باستخدام حساب مؤسسي يمتلك امتيازات إنشاء مفاتيح API بالإضافة إلى امتيازات إنشاء المحتوى وتحديثه وحذفه.
2. انقر فوق علامة تبويب المحتوى الخاص بي في صفحة المحتوى وانقر فوق عنصر جديد.
3. في نافذة عنصر جديد، انقر فوق بيانات اعتماد المطور.
4. اختر خيار بيانات اعتماد مفتاح واجهة برمجة التطبيقات (API) وانقر فوق التالي.
5. استخدم التقويم لتحديد تاريخ انتهاء صلاحية بيانات الاعتماد.

   يمكن أن تنتهي صلاحية بيانات الاعتماد في اليوم التالي (الحد الأدنى) أو بعد 365 يومًا (الحد الأقصى). تنتهي صلاحيتها الساعة 11:59 مساءً في التاريخ الذي تختاره لانتهاء الصلاحية. يتم تخزين الوقت بناءً على وقت المستعرض الخاص بك عند إضافة التطبيق وإنشاء بيانات الاعتماد.

6. ضمن عناوين URL المرجعية، قم بتوفير عنوان URL أو عنوان IP المسموح له بالاتصال بالتطبيق. انقر فوق إضافة لإضافة المزيد من عناوين URL المرجعية أو عناوين IP المطلوبة.

   يجب أن تتطابق عناوين URL المحددة أثناء التخويل مع أحد عناوين URL المسجلة، وإلا فسيتم رفض التخويل.

   فيما يلي أمثلة على تنسيقات عناوين URL المدعومة للمرجع:

   • https://www.example.com/pages
   • https://www.example.com/pages/index.html

7. انقر فوق التالي.
8. اختر الإجراءات التي ستسمح بيانات الاعتماد للتطبيق بتنفيذها عن طريق تعيين الامتيازات، ثم انقر فوق التالي.

   ستختلف قائمة الامتيازات المتاحة لك بناءً على ما إذا كان لديك اشتراك ArcGIS Location Platform أم لا والامتيازات التي تتمتع بها في المؤسسة. لا يمكنك منح امتيازات لا يمتلكها حسابك.

   للحصول على معلومات عن أنواع الامتيازات، راجع دليل الأمان والمصادقة في تعليمات مطوري Esri.

9. انقر فوق استعراض العناصر واختر العناصر التي يمكن استخدام بيانات الاعتماد المضمنة للوصول إليها، ثم انقر فوق إضافة عناصر.

   وبدلاً من ذلك، يمكنك النقر فوق تخطي.

10. أدخل عنوانًا.
11. اختر مجلدًا في المحتوى الخاص بي والذي تريد حفظ العنصر فيه.

    وبدلاً من ذلك، يمكنك اختيار إنشاء مجلد جديد من القائمة وكتابة اسم المجلد لحفظ العنصر في مجلد جديد.

    لا يمكن أن تحتوي أسماء المجلدات على حروف Unicode مكونة من 4 بايت.

12. إذا قامت مؤسستك بإعداد فئات المحتوى، فانقر فوق تعيين الفئات وحدد 20 فئة بحد أقصى لمساعدة الأشخاص في العثور على العنصر.

    يمكنك أيضًا البدء في كتابة اسم الفئة لتضييق قائمة الفئات.

13. اختياريًا، اكتب العلامات التي تصف العنصر.

    افصل المصطلحات بفواصل (مثال، يتم اعتبار الأرض الفيدرالية علامة واحدة، والأرض، الفيدرالية علامتين).

    أثناء الكتابة، يمكنك تحديد أي من العلامات المقترحة التي تظهر؛ يتم إنشاء الاقتراحات من العلامات التي أضفتها مسبقًا.

14. اختياريًا، أضف ملخصًا يصف التطبيق.
15. انقر فوق التالي.
16. قم بمراجعة ملخص بيانات الاعتماد. لتغيير الإعدادات، استخدم النقر فوق السابق لإجراء التغييرات قبل إنشاء العنصر.
17. إذا منحت امتيازات شخصية فيما يتعلق ببيانات الاعتماد، فقم بالتأشير على المربع بجوار إقرار الأمان لتأكيد قراءتك له وموافقتك عليه، ثم انقر فوق التالي.
18. اختر ما إذا كنت تريد إنشاء مفتاح واجهة برمجة التطبيقات (API) على الفور أم لاحقًا، ثم انقر فوق التالي.

    يجب عليك نسخ مفتاح واجهة برمجة التطبيقات بمجرد إنشائه.

    • إذا نقرت فوق إنشاء مفتاح واجهة برمجة التطبيقات وانتقلت إلى صفحة تفاصيل العنصر. أنا مستعد لنسخ المفتاح وحفظه. عند تحديد خيار ، تظهر النافذة المنبثقة إنشاء مفتاح واجهة برمجة التطبيقات عند النقر فوق التالي. انقر فوق الزر نسخ لنسخ المفتاح. الصق المفتاح في مستند آمن. أغلق النافذة المنبثقة عند الانتهاء.
    • إذا قمت بالنقر فوق انتقال إلى صفحة تفاصيل العنصر. سأقوم بإنشاء مفتاح واجهة برمجة التطبيقات لاحقًا. عند تحديد خيار ، تظهر صفحة عنصر بيانات الاعتماد. تظهر صفحة العنصر عند النقر فوق التالي. يمكنك إنشاء مفتاح واجهة برمجة التطبيقات من علامة التبويب الإعدادات في صفحة العنصر.

تتم إضافة التطبيق إلى محتواك وتظهر صفحة العنصر الخاصة به. تظهر شارة تشير إلى أن مفتاح واجهة برمجة التطبيقات (API) مضمن مع التطبيق على صفحة العنصر وعند عرض العنصر من صفحة المحتوى أو أجزاء معاينة العنصر. في علامة التبويب نظرة عامة في صفحة العنصر، تشير الشارة إلى ما إذا كانت الامتيازات الشخصية مضمنة أم أن الامتيازات القياسية فقط مضمنة في بيانات الاعتماد.

يمكنك تكوين تفاصيل العنصر للتطبيق.

انقر فوق عرض الاستخدام في علامة التبويب الإعدادات للوصول إلى معلومات حول الأشخاص الذين قاموا بتسجيل الدخول إلى التطبيق وعدد الأرصدة التي استهلكوها.

ملاحظة:‏

لا يتوفر قسم عرض الاستخدام عند تسجيل الدخول عبر اشتراك ArcGIS Location Platform.

يمكنك أيضًا إدارة الإعدادات الخاصة ببيانات الاعتماد المضمنة مع التطبيق.