الإعدادات المُدارة على الويب

بصفتك مطوّرًا، قد تحتاج إلى السماح لمشرفي ChromeOS Enterprise بضبط تطبيقك ديناميكيًا. تتيح لك Managed Configuration API طريقة فعّالة للسماح لهم بإدارة سلوك تطبيقك عند تثبيته. يمكنك تحديد واجهة للسماح للمشرفين بتمرير إعدادات إلى تطبيقك وتغيير سلوكه بشكل ديناميكي، بما في ذلك على سبيل المثال لا الحصر:

• ضبط حجم نافذة معيّن عند الفتح
• ملء عناوين الخادم أو إعدادات المصادقة مسبقًا
• تفعيل ميزات التطبيق أو إيقافها

إعداد Web Managed Configuration API

تتطلّب عمليات الضبط المُدارة اتّخاذ خطوات من قِبل كلّ من المطوّرين ومشرفي المؤسسة. على المطوّرين تنفيذ واجهة برمجة التطبيقات ونشر واجهتهم. على مشرفي المؤسسة ضبط إعدادات مثيلهم من "وحدة تحكّم المشرف". لتوضيح هذه الخطوات، سنستخدم ضبط خيارات تسجيل الدخول المختلفة كمثال. قد يريد مشرف المؤسسة السماح لبعض المستخدمين أو الوحدات التنظيمية بتسجيل الدخول باستخدام بيانات اعتماد معيّنة وإيقافها للآخرين.

تحديد واجهة قابلة للضبط ومشاركتها

كما هو الحال مع أي نوع آخر من الخدمات الخارجية، من الممارسات الجيدة البدء بتحديد واجهة يمكن مشاركتها خارجيًا مع أي عميل يريد ضبط تطبيقك. ترسل الإعدادات المُدارة قاموس JSON إلى تطبيقك، لذا ننصحك بتوثيق كل مَعلمة مع وصف ونوع وقيمة تلقائية وخيارات صالحة. في ما يلي مثال على كيفية تطبيق ذلك على مَعلمة لإيقاف خيارات تسجيل الدخول:

                                                                                   

المَعلمة	النوع	تلقائي	الخيارات	الوصف
DisableLoginOptions	String[]	[]	‫"email"، "google"	قائمة بخيارات تسجيل الدخول التي سيتم إيقافها

تساعد كتابة المستندات الخاصة بالواجهة بهذه الطريقة في التواصل مع الفِرق الخارجية والعملاء بشأن الخدمة، ويمكن أن تساعدك في الحفاظ عليها على المدى الطويل. باستخدام ما ورد أعلاه، يمكن لمشرف المؤسسة استخدام ملف JSON التالي لإيقاف تسجيل الدخول باستخدام "email":

{
  “DisableLoginOptions”: ["email"]
};

تحديد الإعدادات المُدارة

​​توفّر وحدة تحكّم المشرف في Google واجهة تتيح لمشرفي المؤسسة إعداد ضبط مُدار. في وقت كتابة هذه المقالة، يظهر الخيار على يسار التطبيق المحدّد، ضمن الاسم **الضبط المُدار**. يؤدي إدخال قيمة وحفظ الإعداد إلى إتاحتها تلقائيًا للتطبيق المُدار لاستخدامها.

واجهة مستخدم "وحدة تحكّم المشرف في Google" لإدراج حقول الإعدادات المُدارة

لإيقاف تسجيل الدخول، يمكن لمشرف المؤسسة مثلاً ضبط التطبيق باستخدام { "‘DisableLoginOptions’" : ["email"]} لجميع المستخدمين ضِمن الوحدة التنظيمية الأساسية. سيؤدي ذلك إلى إتاحة هذا الإعداد تلقائيًا للتطبيق المُدار بعد حفظ التغييرات.

استرداد الإعدادات من تطبيقك

بعد تحديد الواجهة وإرسال الإعدادات إلى تطبيقك، عليك الآن استردادها داخل تطبيقك. ولإجراء ذلك، استدعِ Managed Configuration API:

navigator.managed.getManagedConfiguration(['DisableLoginOptions']).then(function (result) {
  // result = { "‘DisableLoginOptions’" : ["email"]}
  // hide email login option
});

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

ملاحظة: إذا سبق لك استخدام مصفوفة التحويل في TextureView في الرمز البرمجي، قد لا تبدو المعاينة صحيحة على جهاز أفقي بشكل طبيعي مثل أجهزة Chromebook. من المحتمل أنّ مصفوفة التحويل تفترض بشكل غير صحيح أنّ اتجاه المستشعر هو 90 أو 270 درجة. يمكنك الرجوع إلى هذا التعديل على GitHub للحصول على حلّ بديل، ولكن ننصحك بشدة بنقل تطبيقك لاستخدام الطريقة الموضّحة هنا بدلاً من ذلك.

يمكن بعد ذلك استخدام النتيجة لتغيير سلوك تطبيقك، ما يتيح للمشرفين ضبط تطبيقك بشكل ديناميكي وتعديله ليناسب احتياجات جميع وحداتهم التنظيمية.