ईएमएम को ऐप्लिकेशन के बारे में अपने सुझाव भेजें

एंटरप्राइज़ मोबिलिटी मैनेजमेंट (ईएमएम) की सेवा देने वाली कंपनियां, संगठनों की मदद के लिए समाधान देती हैं Android डिवाइसों और उन पर इंस्टॉल किए गए ऐप्लिकेशन को मैनेज करने के लिए. ये समाधान हैं: आम तौर पर, यह वेब कंसोल के रूप में उपलब्ध होता है, जिन्हें EMM कंसोल कहा जाता है. ईएमएम का इस्तेमाल करना की अनुमति नहीं है, तो आईटी एडमिन अपनी तरफ़ से डिवाइस और ऐप्लिकेशन मैनेजमेंट के काम करते हैं संगठन.

एंटरप्राइज़ संगठनों को टारगेट करने वाले ऐप्लिकेशन, ईएमएम को इस तरह से सुझाव भेज सकते हैं: ऐप्लिकेशन की स्थिति के बारे में जानकारी. ईएमएम के लिए एपीआई उपलब्ध हैं, ताकि ऐप्लिकेशन की खास स्थिति वाला डेटा वापस पाया जा सके. जिसे वे अपने ईएमएम कंसोल में दिखा सकते हैं. बातचीत का यह चैनल आईटी एडमिन को, Android डिवाइसों पर इंस्टॉल किए गए ऐप्लिकेशन की स्थिति के बारे में सुझाव, शिकायत या राय भेजने की अनुमति मिलती है मैनेज करने में मदद करता है.

उदाहरण के लिए, कोई ईमेल क्लाइंट ऐप्लिकेशन, पासकोड की मदद से ऐप्लिकेशन की स्थिति का इस्तेमाल करके पुष्टि कर सकता है कि खाता सफलतापूर्वक कॉन्फ़िगर किया गया था, समन्वयन त्रुटियां होने पर रिपोर्ट करें, या कोई भेजें अन्य स्थिति के अपडेट जो ऐप्लिकेशन डेवलपर के हिसाब से उचित लगते हैं.

कुंजी की मदद से ऐप्लिकेशन की स्थिति के कॉम्पोनेंट

पासकोड की मदद से ऐप्लिकेशन की स्थिति में ये चीज़ें शामिल होती हैं:

  • कुंजी: ऐप्लिकेशन की स्थिति के लिए यूनीक आइडेंटिफ़ायर. ज़्यादा से ज़्यादा 100 वर्ण.
  • मैसेज: ऐप्लिकेशन की स्थिति के बारे में बताने वाला वैकल्पिक मैसेज. ज़्यादा से ज़्यादा 1,000 वर्ण ध्यान दें: आम तौर पर, मैसेज इससे छोटे होने चाहिए.
  • डेटा: ईएमएम के लिए डिज़ाइन की गई वैकल्पिक वैल्यू, जिसे मशीन से पढ़ा जा सकता है, ताकि आईटी एडमिन को अनुमति दी जा सके का इस्तेमाल किया जा सकता है. उदाहरण के लिए, एक आईटी एडमिन अगर डेटा फ़ील्ड battery_percentage < 10 है, तो सूचना सेट अप करें. ज़्यादा से ज़्यादा 1,000 वर्ण
  • गंभीरता: ऐप्लिकेशन की स्थिति की गंभीरता. इनमें ये वैल्यू शामिल हैं SEVERITY_ERROR और SEVERITY_INFO (डिफ़ॉल्ट). गंभीरता को सिर्फ़ SEVERITY_ERROR पर सेट करें का इस्तेमाल करें.
  • टाइमस्टैंप: जब कुंजी की मदद से ऐप्लिकेशन की स्थिति सेट की जाती है, तो वह अपने-आप Epoch के बाद से मिलीसेकंड में टाइमस्टैंप.

मैनेज किए जा रहे कॉन्फ़िगरेशन के बारे में सुझाव, शिकायत या राय भेजें

अगर आपके ऐप्लिकेशन में मैनेज किए जा रहे कॉन्फ़िगरेशन काम करते हैं, तो पासकोड की मदद से ऐप्लिकेशन की स्थिति की जानकारी भेजने का सुझाव दिया जाता है, ताकि आईटी एडमिन को उनके सेट किए गए कॉन्फ़िगरेशन की स्थिति के बारे में ज़्यादा जानें. वर्कफ़्लो के उदाहरण में बताया गया है इसे कैसे किया जा सकता है.

मैनेज किए जा रहे कॉन्फ़िगरेशन के लिए, पासकोड वाले ऐप्लिकेशन की स्थितियां
  1. आईटी एडमिन अपने ईएमएम कंसोल का इस्तेमाल, मैनेज किए जा रहे कॉन्फ़िगरेशन सेट करने और भेजने के लिए करते हैं पूरी तरह से मैनेज किए जा रहे डिवाइस पर इंस्टॉल किया गया ऐप्लिकेशन या किसी वर्क प्रोफ़ाइल में. जैसे:
    • वॉल्यूम: '50%'
    • मुद्रा: 'USDD'
  2. ऐप्लिकेशन, कॉन्फ़िगरेशन लागू करने की कोशिश करता है. वॉल्यूम को सेट कर दिया गया है 50% तक कर दिया है, लेकिन मुद्रा कोड अमान्य है और उसे लागू नहीं किया जा सकता.
  3. हर कॉन्फ़िगरेशन की स्थिति के आधार पर, ऐप्लिकेशन, ऐप्लिकेशन की स्थिति सेट करता है. कुंजी वाले हर ऐप्लिकेशन की स्थिति में एक खास कुंजी और एक ऐसा मैसेज होता है जिसमें राज्य. हमारा सुझाव है कि जहां भी हो सके, मैनेज किए जा रहे कॉन्फ़िगरेशन की कुंजी का मिलान करें. उदाहरण के लिए:
    सुरक्षा कुंजी मैसेज गंभीरता टाइमस्टैंप
    volume 50% पर सेट करें SEVERITY_INFO 1554461130
    currency मुद्रा 'USDD' पहचान नहीं हो पाई SEVERITY_ERROR 1554461130
  4. ईएमएम सेवा देने वाली कंपनी, ऐप्लिकेशन से सेट की गई कुंजी की मदद से ऐप्लिकेशन की स्थिति को हासिल करती है और दिखाती है उन्हें अपने ईएमएम कंसोल में जोड़ सकते हैं. उदाहरण के लिए:
    कॉन्फ़िगरेशन स्थिति कार्रवाई ज़रूरी है समय
    वॉल्यूम 50% पर सेट करें नहीं 5 अप्रैल, 2019; सुबह 10:45:30 बजे
    मुद्रा गड़बड़ी: मुद्रा 'USDD' पहचाना नहीं गया. हां 5 अप्रैल, 2019; सुबह 10:45:30 बजे

    ईएमएम सेवा देने वाली कंपनी को किसी भी मिले हुए राज्य को साफ़ तौर पर फ़्लैग करना चाहिए SEVERITY_ERROR आईटी एडमिन से संपर्क करें. आईटी एडमिन, ईएमएम कंसोल में यह जानकारी देख सकते हैं और उनके सेट किए गए कॉन्फ़िगरेशन में किसी भी गड़बड़ी को ठीक करने के लिए कार्रवाई करना.

ठीक की गई गड़बड़ियों की शिकायत करना

गड़बड़ी के ठीक होने के बाद, ऐप्लिकेशन की स्थिति को तुरंत इस पर भेजें ईएमएम को गड़बड़ी का मैसेज हमेशा के लिए दिखाने से रोकें. यह फ़ॉलो-अप राज्य में यह शामिल होना चाहिए:

  • एक जैसी कुंजी डालें.
  • SEVERITY_INFO की गंभीरता, इससे पता चलता है कि स्थिति किसी गड़बड़ी की स्थिति में नहीं है और इस स्थिति में कोई गड़बड़ी नहीं है संगठन को कोई और कार्रवाई करनी होगी.

अपने ऐप्लिकेशन की कुंजी वाले ऐप्लिकेशन की स्थितियों के लिए सहायता जोड़ना

यहां दिए गए तरीके से, आपके ऐप्लिकेशन में पासकोड वाले ऐप्लिकेशन की स्थितियों को इंटिग्रेट करने का तरीका बताया गया है.

पहला चरण: अपनी settings.gradle फ़ाइल में Google की Maven रिपॉज़िटरी जोड़ना

अपने प्रोजेक्ट के settings.gradle में, Google की Maven रिपॉज़िटरी को रिपॉज़िटरी के तौर पर जोड़ें फ़ाइल, जैसा कि नीचे दिखाया गया है:

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

दूसरा चरण: मॉड्यूल-लेवल की build.gradle फ़ाइल में एंटरप्राइज़ सुझाव लाइब्रेरी जोड़ना

अपने मॉड्यूल-लेवल build.gradle में इस डिपेंडेंसी जोड़ें फ़ाइल:

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

तीसरा चरण: KeyedAppStatesReporter का इंस्टेंस पाना

अपने onCreate() तरीके में, इसका एक इंस्टेंस पाएं और सेव करें KeyedAppStatesReporter. इससे आपके ऐप्लिकेशन और ईएमएम की सेवा देने वाली कंपनियों के बीच बातचीत का तरीका चालू हो जाता है.

Kotlin

val reporter = KeyedAppStatesReporter.create(context)

Java

KeyedAppStatesReporter reporter = KeyedAppStatesReporter.create(context);

चौथा चरण: ऐप्लिकेशन की खास स्थितियों का कलेक्शन बनाना

ऐप्लिकेशन की कुंजियों की स्थिति तय करते समय, नीचे बताए गए सबसे सही तरीके अपनाएं:

  • किसी भी राज्य में व्यक्तिगत पहचान से जुड़ी जानकारी (पीआईआई) शामिल न करें—खास ऐप्लिकेशन की स्थितियां संवेदनशील जानकारी के लिए सही है.
  • ऐप्लिकेशन की खास बातों को यहां बताई गई सीमाओं के अंदर रखें MAX_KEY_LENGTH MAX_MESSAGE_LENGTH, और MAX_DATA_LENGTH.
  • एक setStates या setStatesImmediate कॉल का कुल इस्तेमाल 300 केबी तक हो सकता है. इस कुल डेटा का करीब एक तिहाई, हर दिन सेव किया जा सकता है. इससे ज़्यादा व्यवहार का नतीजा तय नहीं होगा.
  • किसी स्थिति की गंभीरता को सिर्फ़ इस SEVERITY_ERROR अगर कोई ऐसी शर्त मौजूद है जिसे ठीक करने के लिए किसी संगठन को कार्रवाई करनी होगी.
  • गड़बड़ियों वाली ऐप्लिकेशन स्थिति भेजते समय, पक्का करें कि आपने गड़बड़ियां ठीक होने के बाद फ़ॉलो-अप की स्थिति देखें, ताकि ईएमएम, गड़बड़ियां ठीक की गई हैं.
  • फ़ॉलो-अप की स्थिति के लिए, उसी का इस्तेमाल करें 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());

पांचवां चरण: ऐप्लिकेशन की उन स्थितियों को सेट करना जिनके लिए यह सुविधा काम करती है

setStates() तरीका, Play Store ऐप्लिकेशन को पासकोड की मदद से ऐप्लिकेशन की स्थिति तुरंत भेज देता है (पैकेज का नाम: com.android.vending) और मैसेज, दोनों डिवाइस पर इंस्टॉल किए गए हों, डिवाइस या वर्क प्रोफ़ाइल पर जाएं.

Kotlin

keyedAppStatesReporter.setStates(states)

Java

keyedAppStatesReporter.setStates(states);

ऐप्लिकेशन की खास स्थितियों की जांच करें

टेस्ट से जुड़े निर्देशों की ज़्यादा जानकारी के लिए, टेस्ट ऐप्लिकेशन के सुझाव देखें.