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

يعتبر إضافة إسناد عنوان 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. اختر مجلدًا في المحتوى الخاص بي والذي تريد حفظ العنصر فيه.
  9. إذا قامت مؤسستك بإعداد فئات المحتوى، فانقر فوق تعيين الفئات وحدد 20 فئة بحد أقصى لمساعدة الأشخاص في العثور على العنصر.

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

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

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

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

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

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

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

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

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

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

ملاحظة:‏

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

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

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

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

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

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

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

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

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

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

    وبدلاً من ذلك، يمكنك النقر فوق تخطي. إذا تخطيت تحديد العناصر التي يمكن لمستخدمي بيانات اعتماد OAuth 2.0 الوصول إليها، فيمكن استخدام بيانات الاعتماد للوصول إلى جميع العناصر التي تمتلكها.

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

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

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

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

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

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

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

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

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

ملاحظة:‏

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  14. اختياريًا، أضف ملخصًا يصف التطبيق.
  15. انقر فوق التالي.
  16. قم بمراجعة ملخص بيانات الاعتماد. لتغيير الإعدادات، استخدم النقر فوق السابق لإجراء التغييرات قبل إنشاء العنصر. إذا كانت إعدادات بيانات الاعتماد صحيحة، فانقر فوق إنشاء.

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

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

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

ملاحظة:‏

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

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

الموضوعات ذات الصلة