إرسال ملاحظات التطبيق إلى مجموعات "إدارة الخدمات الجوّالة للمؤسسات"

يقدِّم موفِّرو إدارة الخدمات الجوّالة للمؤسسات (EMM) حلولاً للمؤسسات. لإدارة أجهزة Android والتطبيقات المثبّتة عليها. هذه الحلول متوفرة عادةً كوحدات تحكّم على الويب، تُسمى وحدات التحكّم في إدارة الخدمات الجوّالة للمؤسسات (EMM). استخدام إدارة الخدمات الجوّالة للمؤسسات (EMM) وحدة التحكّم، ينفّذ مشرفو تكنولوجيا المعلومات مهام إدارة الأجهزة والتطبيقات نيابةً عن التنظيم.

يمكن للتطبيقات التي تستهدف المؤسسات المؤسسية إرسال الملاحظات إلى موفِّري إدارة الخدمات الجوّالة للمؤسسات (EMM) في شكل حالات التطبيق الأساسية. تتوفر واجهات برمجة التطبيقات لـ EMM لاسترداد بيانات حالة التطبيق الأساسية، والتي يمكنهم عرضها بعد ذلك في وحدة التحكم في إدارة الخدمات الجوّالة للمؤسسات (EMM). قناة التواصل هذه تسمح لمشرفي تكنولوجيا المعلومات بتلقّي الملاحظات حول حالة التطبيقات المثبَّتة على الأجهزة التي يديرونها.

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

مكونات حالة التطبيق الأساسية

تتكوّن حالة التطبيق الأساسية مما يلي:

  • المفتاح: معرّف فريد لحالة التطبيق الحد الأقصى لعدد الأحرف هو 100 حرف.
  • الرسالة: رسالة اختيارية تصف حالة التطبيق. الحد الأقصى 1,000 الأحرف. ملاحظة: يجب أن تكون الرسائل أقصر بكثير من هذه المدة.
  • البيانات: قيمة اختيارية يمكن للآلة قراءتها، مخصّصة لإدارة الخدمات الجوّالة للمؤسسات (EMM) للسماح لمشرفي تكنولوجيا المعلومات لإعداد التنبيهات أو الفلاتر استنادًا إلى القيمة. على سبيل المثال، يمكن لمشرف تكنولوجيا المعلومات إعداد تنبيه إذا كان حقل البيانات battery_percentage < 10. الحد الأقصى 1,000 الأحرف.
  • درجة الخطورة: شدة حالة التطبيق. القيم المسموح بها هي SEVERITY_ERROR وSEVERITY_INFO (الخيار التلقائي). ضبط درجة الخطورة على SEVERITY_ERROR فقط عن حالات الخطأ الحقيقية التي تحتاج المؤسسة إلى اتخاذ إجراءات لإصلاحها.
  • الطابع الزمني: عند ضبط حالة تطبيق مرتبط بمفتاح، يتم إرساله تلقائيًا مع الطابع الزمني بالمللي ثانية منذ تاريخ بدء حساب الفترة.

إرسال ملاحظات حول الإعدادات المُدارة

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

حالات التطبيق الأساسية لعمليات الضبط المُدارة
  1. يستخدم مشرفو تكنولوجيا المعلومات وحدة تحكّم إدارة الخدمات الجوّالة للمؤسسات (EMM) لضبط عمليات الضبط المُدارة وإرسالها إلى تطبيق مثبَّت على جهاز مُدار بالكامل أو داخل ملف العمل. مثل:
    • مستوى الصوت: "50%"
    • العملة: "USDD"
  2. يحاول التطبيق تطبيق الإعدادات. تم ضبط مستوى الصوت بنجاح. إلى 50%، ولكن رمز العملة غير صالح ولا يمكن تطبيقه.
  3. استنادًا إلى حالة كل إعدادات، يضبط التطبيق حالة التطبيق الأساسية. تحتوي كل حالة تطبيق أساسية على مفتاح فريد ورسالة تحتوي على تفاصيل الولاية. وننصحك بمطابقة مفتاح الإعدادات المُدارة إن أمكن. مثلاً:
    المفتاح الرسالة درجة الخطورة الطابع الزمني
    volume ضبط على 50% SEVERITY_INFO 1554461130
    currency العملة "USDD" غير معروف SEVERITY_ERROR 1554461130
  4. يستردّ موفِّر إدارة الخدمات الجوّالة للمؤسسات حالات التطبيق الأساسية التي ضبطها التطبيق ويعرضها في وحدة التحكم في إدارة الخدمات الجوّالة للمؤسسات (EMM). مثلاً:
    الإعدادات الحالة مطلوب اتخاذ إجراء الوقت
    مستوى الصوت ضبط على 50% لا 5 نيسان (أبريل) 2019؛ 10:45:30 صباحًا
    العملة خطأ: العملة "دولار أمريكي" لم يتم التعرف عليها. نعم 5 نيسان (أبريل) 2019؛ 10:45:30 صباحًا

    وعلى موفِّر إدارة الخدمات الجوّالة للمؤسسات (EMM) أيضًا الإبلاغ صراحةً عن أي حالات تم استلامها باستخدام SEVERITY_ERROR لمشرف تكنولوجيا المعلومات. يمكن لمشرفي تكنولوجيا المعلومات عرض المعلومات في وحدة تحكّم إدارة الخدمات الجوّالة للمؤسسات (EMM) اتخاذ الإجراءات لتصحيح أي أخطاء في الإعدادات التي ضبطها.

الإبلاغ عن الأخطاء التي تم حلّها

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

  • المفتاح نفسه باعتباره رسالة الخطأ الأولية.
  • تشير إلى خطورة SEVERITY_INFO، مما يشير إلى أن الحالة ليست في شرط خطأ تتطلب من المؤسسة اتخاذ أي إجراءات أخرى.

إتاحة استخدام حالات التطبيق الرئيسية في تطبيقك

توضِّح الخطوات أدناه كيفية دمج حالات التطبيق الأساسية في تطبيقك.

الخطوة 1: إضافة مستودع Maven من Google إلى ملف settings.gradle

إضافة مستودع Maven من Google كموقع مستودع في settings.gradle لمشروعك كما هو موضح أدناه:

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
       google()
  }
}

الخطوة 2: إضافة مكتبة تعليقات المؤسسة إلى ملف build.gradle على مستوى الوحدة

أضف التبعية التالية إلى build.gradle على مستوى الوحدة. الملف:

dependencies {
    implementation 'androidx.enterprise:enterprise-feedback:1.0.0'
}

الخطوة 3: الحصول على نسخة افتراضية من KeyedAppStatesReporter

في طريقة onCreate()، يمكنك الحصول على مثيل لـ وتخزينه. KeyedAppStatesReporter ويفعِّل ذلك قناة اتصال بين تطبيقك وموفِّري إدارة الخدمات الجوّالة للمؤسسات (EMM).

Kotlin

val reporter = KeyedAppStatesReporter.create(context)

Java

KeyedAppStatesReporter reporter = KeyedAppStatesReporter.create(context);

الخطوة 4: إنشاء مجموعة من حالات التطبيقات الأساسية

يُرجى اتّباع أفضل الممارسات الموضّحة أدناه عند إنشاء حالات التطبيق الأساسية:

  • لا تُدرِج معلومات تحديد الهوية الشخصية (PII) مطلقًا في أي حالة، لأنّ حالات التطبيقات المستندة إلى المفاتيح لا يتم تضمينها. مناسبة للبيانات الحساسة.
  • عليك إبقاء حالات التطبيقات الرئيسية ضمن الحدود المسموح بها في MAX_KEY_LENGTH، MAX_MESSAGE_LENGTH, وMAX_DATA_LENGTH.
  • يمكن أن يبلغ إجمالي حجم المكالمة الواحدة من setStates أو setStatesImmediate 300 كيلوبايت (حوالي 1/3 إجمالي المساحة التي يمكن تخزينها في اليوم). سيؤدي تجاوز هذا الحدّ إلى سلوك غير محدَّد.
  • قم فقط بتعيين درجة أهمية الحالة إلى SEVERITY_ERROR في حالة وجود شرط تحتاج المؤسسة إلى اتخاذ إجراء لإصلاحه.
  • عند إرسال حالة تطبيق تحتوي على أخطاء، يُرجى التأكد أيضًا من إرسال حالة المتابعة عند حلّ الأخطاء حتى تتمكن إدارة الخدمات الجوّالة للمؤسسات (EMM) من إيقاف وضع علامة على الأخطاء في وحدة التحكم الخاصة بهم.
  • لحالة المتابعة، استخدم نفس key الحالة الأولية التي عرضت الخطأ وتعيين درجة الخطورة على SEVERITY_INFO

ينشئ المقتطف أدناه مجموعة من حالات التطبيق الأساسية:

Kotlin

    val states = hashSetOf(KeyedAppState.builder()
             .setKey("key")
             .setSeverity(KeyedAppState.SEVERITY_INFO)
             .setMessage("message")
             .setData("data")
             .build())

Java

    Collection states = new HashSet<>();
    states.add(KeyedAppState.builder()
     .setKey("key")
     .setSeverity(KeyedAppState.SEVERITY_INFO)
     .setMessage("message")
     .setData("data")
     .build());

الخطوة 5: ضبط حالات التطبيق الأساسية

setStates() على الفور إرسال حالات التطبيق الرئيسية إلى تطبيق "متجر Play" (اسم الحزمة: com.android.vending) إذا كان مثبَّتًا على الجهاز، وعلى أي من المشرفين على الجهاز أو ملف العمل.

Kotlin

keyedAppStatesReporter.setStates(states)

Java

keyedAppStatesReporter.setStates(states);

اختبار حالات التطبيقات الأساسية

للحصول على تعليمات تفصيلية للاختبار، يُرجى الاطّلاع على مقالة اختبار ملاحظات التطبيق.