รองรับการกําหนดค่าที่มีการจัดการ

บางแอปที่ออกแบบมาสำหรับองค์กรจะมีการตั้งค่าในตัวที่เรียกว่าการกำหนดค่าที่มีการจัดการ ซึ่งผู้ดูแลระบบไอทีสามารถกำหนดค่าจากระยะไกลได้ เช่น แอปอาจมีตัวเลือกให้ซิงค์ข้อมูลเมื่ออุปกรณ์เชื่อมต่อกับ Wi-Fi เท่านั้น การอนุญาตให้ผู้ดูแลระบบไอทีระบุการกำหนดค่าที่มีการจัดการและนำไปใช้กับอุปกรณ์เป็นสิ่งจำเป็นสำหรับชุดโซลูชันทั้งหมด คุณรองรับการกำหนดค่าที่มีการจัดการในคอนโซล EMM ได้ 2 วิธีดังนี้

• สร้าง UI ของคุณเองและใช้การตั้งค่าผ่าน managedConfiguration ใน ApplicationPolicy
• เพิ่ม iframe การกำหนดค่าที่มีการจัดการลงในคอนโซล (วิธีการโดยละเอียดด้านล่าง) และใช้การตั้งค่าผ่าน managedConfigurationTemplate ใน ApplicationPolicy

---

iframe การกำหนดค่าที่มีการจัดการคือ UI ที่ฝังได้ซึ่งช่วยให้ผู้ดูแลระบบไอทีบันทึก แก้ไข และลบการตั้งค่าการกำหนดค่าที่มีการจัดการของแอปได้ เช่น คุณสามารถแสดงปุ่ม (หรือองค์ประกอบ UI ที่คล้ายกัน) ในรายละเอียดหรือหน้าการตั้งค่าของแอปที่จะเปิด iframe นั้น

การดำเนินการที่ผู้ดูแลระบบไอทีทำได้จาก iframe

รูปที่ 1 ตัวอย่าง iframe การกำหนดค่าที่มีการจัดการสำหรับ Gmail

ตั้งค่าและบันทึกโปรไฟล์การกำหนดค่า

iframe จะเรียกข้อมูลและแสดงสคีมาการกำหนดค่าที่มีการจัดการสำหรับแอปที่ระบุ ผู้ดูแลระบบไอทีสามารถตั้งค่าการกำหนดค่าและบันทึกเป็นโปรไฟล์การกำหนดค่าภายใน iframe ได้ ทุกครั้งที่ผู้ดูแลระบบไอทีบันทึกโปรไฟล์การกำหนดค่าใหม่ iframe จะแสดงผลตัวระบุที่ไม่ซ้ำกันชื่อ mcmId ซึ่งช่วยให้ผู้ดูแลระบบไอทีสร้างโปรไฟล์หลายโปรไฟล์สำหรับแอปเดียวกันได้

แก้ไขโปรไฟล์การกำหนดค่า

iframe สามารถแสดงโปรไฟล์การกำหนดค่าที่บันทึกไว้ ผู้ดูแลระบบไอทีสามารถอัปเดตการตั้งค่าภายในโปรไฟล์และบันทึกการเปลี่ยนแปลงได้

ลบโปรไฟล์การกำหนดค่า

ผู้ดูแลระบบไอทีจะลบโปรไฟล์การกำหนดค่าออกจาก iframe ได้ ฟีเจอร์นี้ปิดใช้อยู่โดยค่าเริ่มต้น

เพิ่ม iframe ไปยังคอนโซลของคุณ

สร้างโทเค็นเว็บ

ใช้ enterprises.webTokens.create เพื่อสร้างโทเค็นเว็บที่ระบุองค์กร และตั้งค่า iframeFeature เป็น MANAGED_CONFIGURATIONS คุณต้องรวมโทเค็นที่ส่งกลับมาพร้อมกับพารามิเตอร์อื่นๆ เมื่อแสดงผล iframe ในคอนโซล

แสดงผล iframe

ตัวอย่างวิธีแสดงผล iframe การกำหนดค่าที่มีการจัดการ

<script src="https://apis.google.com/js/api.js"></script>
<div id="container" style="width: 1000px; height: 1000px"></div>
<script>
  gapi.load('gapi.iframes', function() {
    var options = {
      'url': 'https://play.google.com/managed/mcm?token=web_token&packageName=app_package_name',
      'where': document.getElementById('container'),
      'attributes': { style: 'height:1000px', scrolling: 'yes'}
    }

    var iframe = gapi.iframes.getContext().openChild(options);
  });
</script>

พารามิเตอร์ของ URL

ตารางด้านล่างแสดงพารามิเตอร์ที่มีอยู่ทั้งหมดสำหรับ URL ของ iframe

พารามิเตอร์	จำเป็น	คำอธิบาย
token	ได้	แสดงโทเค็นจาก Enterprises.createWebToken
packageName	ได้	รหัสผลิตภัณฑ์ของแอป เช่น com.google.android.gm
mcmId	ไม่ได้	รหัสของโปรไฟล์การกำหนดค่าที่มีการจัดการ
canDelete	ไม่ได้	หากเป็น TRUE ให้เปิดใช้ปุ่มใน iframe เพื่อให้ผู้ดูแลระบบไอทีลบโปรไฟล์การกำหนดค่าที่มีการจัดการได้ หากเป็น FALSE (ค่าเริ่มต้น) ระบบจะปิดใช้ปุ่ม
locale	ไม่ได้	แท็กภาษา BCP 47 ที่มีการจัดรูปแบบเป็นอย่างดีซึ่งใช้ในการแปลเนื้อหาใน iframe หากไม่ได้ระบุไว้ ค่าเริ่มต้นจะเป็น en_US

เหตุการณ์ iframe

คุณควรจัดการเหตุการณ์ต่อไปนี้ในฐานะส่วนหนึ่งของการผสานรวมด้วย

เหตุการณ์	คำอธิบาย
onconfigupdated	ผู้ใช้อัปเดตโปรไฟล์การกำหนดค่าที่มีการจัดการที่มีอยู่แล้วหรือสร้างโปรไฟล์ใหม่ ซึ่งจะแสดงออบเจ็กต์ที่มีสิ่งต่อไปนี้ { "mcmId": The ID of the managed configurations profile. "name": The name of the updated or newly created managed configurations profile. }
onconfigdeleted	ผู้ใช้ลบโปรไฟล์การกำหนดค่าที่มีการจัดการซึ่งมีอยู่แล้ว ซึ่งจะแสดงผลออบเจ็กต์ที่มี { "mcmId": The ID of the managed configurations profile. }

ตัวอย่างด้านล่างแสดงวิธีฟัง onconfigupdated ดังตัวอย่างต่อไปนี้

iframe.register('onconfigupdated', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);

การอัปเดตสคีมาการกำหนดค่าที่มีการจัดการของแอป

หากนักพัฒนาซอฟต์แวร์อัปเดตสคีมาการกำหนดค่าที่มีการจัดการของแอป ระบบจะอัปเดตโปรไฟล์การกำหนดค่าที่บันทึกไว้โดยอัตโนมัติ ตัวอย่างเช่น หากนักพัฒนาซอฟต์แวร์นำตัวเลือกออก ระบบจะนำตัวเลือกนั้นออกจากโปรไฟล์การกำหนดค่าที่มีอยู่ทั้งหมดของแอป หากนักพัฒนาซอฟต์แวร์เพิ่มตัวเลือก ระบบจะเพิ่มค่าเริ่มต้นของตัวเลือกดังกล่าว (กำหนดโดยนักพัฒนาซอฟต์แวร์) ลงในโปรไฟล์การกำหนดค่าที่มีอยู่ทั้งหมดของแอป

ใช้โปรไฟล์การกำหนดค่ากับนโยบาย

ระบบจะบันทึกโปรไฟล์การกำหนดค่าแต่ละรายการเป็น mcmId ที่ไม่ซ้ำกัน หากต้องการใช้โปรไฟล์การกำหนดค่ากับนโยบาย ให้ระบุ mcmId ใน managedConfigurationTemplate

คำเตือน: ApplicationPolicy แสดงผลข้อผิดพลาดหากมีการตั้งค่าทั้ง managedConfigurations และ managedConfigurationTemplate ในนโยบายเดียว โปรดตั้งค่าแค่อันเดียว

---

ทำความเข้าใจลักษณะการทำงานของการเลือก/ยกเลิกการเลือก

ตอนนี้ iframe ของการกำหนดค่าที่มีการจัดการช่วยให้ผู้ดูแลระบบไอทียกเลิกการเลือกข้อจำกัดแอปของการกำหนดค่าที่มีการจัดการได้อย่างชัดเจนเมื่อไม่จำเป็นต้องใช้ ซึ่งเป็นการเปลี่ยนแปลงจากลักษณะการทำงานก่อนหน้าและอาจมีผลกระทบต่อข้อจำกัดที่ส่งไปยังแอปของคุณตามการเลือกของผู้ดูแลระบบ

ส่วนด้านล่างนี้สรุปลักษณะการทำงานของ iframe การกำหนดค่าที่มีการจัดการด้วยรูปแบบการยกเลิกการเลือกใหม่นี้ และสิ่งที่นักพัฒนาซอฟต์แวร์คาดว่าจะส่งไปเป็นส่วนหนึ่งของการกำหนดค่าที่มีการจัดการของตน

กำลังใช้ค่าเริ่มต้นสำหรับการจำกัดแอป

หากการจำกัดประเภท bool, choice, integer, multi-select หรือ string ของแอปมีค่าเริ่มต้น ค่าเริ่มต้นจะใช้เป็นค่าของการจำกัดแอปเมื่อผู้ดูแลระบบบันทึกการกำหนดค่าที่มีการจัดการโดยที่ไม่ได้ใช้การเปลี่ยนแปลงใดๆ กับข้อจำกัดของแอป

ตัวอย่างเช่น พร้อมกับสคีมาข้อจำกัดของแอปต่อไปนี้

"restrictions": [{
    "key": "bool_key",
    "restrictionType": "bool",
    "defaultValue": {
        "type": "bool",
        "valueBool": false
    }
}]

ข้อจำกัดของแอปที่ส่งไปยังอุปกรณ์จะเป็นดังนี้

"restrictions": [{
    "key": "bool_key",
    "restrictionType": "bool",
    "value": {
        "type": "bool",
        "valueBool": false
    }
}]

ไม่ใช้ค่าเริ่มต้นกับการจำกัดแอป

หากการจำกัดประเภท bool, choice, integer, multi-select หรือ string ไม่ได้ให้ค่าเริ่มต้นไว้ ข้อจำกัดแอปเหล่านี้จะไม่รวมเมื่อผู้ดูแลระบบบันทึกการกำหนดค่าที่มีการจัดการโดยที่ไม่ได้ใช้การเปลี่ยนแปลงใดๆ กับข้อจำกัดของแอปนั้น

ตัวอย่างเช่น พร้อมกับสคีมาข้อจำกัดของแอปต่อไปนี้

"restrictions": [{
    "key": "bool_key",
    "restrictionType": "bool"
    // defaultValue absent.
}]

ข้อจำกัดของแอปที่ส่งไปยังอุปกรณ์จะเป็นดังนี้

"restrictions": [
    // Empty
]

การใช้แพ็กเกจภายในสคีมา

ส่วนนี้จะมีผลกับข้อจำกัดของแอปแพ็กเกจ

มีข้อจำกัดแอปย่อยอย่างน้อย 1 รายการที่มีค่าเริ่มต้นในการจำกัดแอป Bundle

หากภายในการจำกัดแอปแพ็กเกจ อย่างน้อย 1 รายการมีค่าเริ่มต้นเป็นการจำกัดแอปย่อยที่มีประเภท bool, choice, integer, multi-select หรือ string

"restrictions": [{
    "key": "bundle_key",
    "restrictionType": "bundle",
    "nestedRestriction": [{
            "key": "bool_key_1",
            "restrictionType": "bool",
            "defaultValue": {
                "type": "bool",
                "valueBool": false
            }
        },
        {
            "key": "bool_key_2",
            "restrictionType": "bool"
            // defaultValue absent.
        }
    ]
}]

ข้อจำกัดของแอปที่ส่งไปยังอุปกรณ์จะเป็นดังนี้

"restrictions": [{
    "key": "bundle_key",
    "restrictionType": "bundle",
    "nestedRestriction": [{
            "key": "bool_key_1",
            "restrictionType": "bool",
            "value": {
                "type": "bool",
                "valueBool": false
            }
        },
        // The bool_key_2 child app restriction is not included.
    ]
}]

การจำกัดแอปย่อยทั้งหมดที่ไม่มีค่าเริ่มต้น

หากภายในแพ็กเกจ การจำกัดการจำกัดแอปย่อยทั้งหมดด้วยประเภท bool ตัวเลือก จำนวนเต็ม การเลือกหลายรายการ หรือสตริงไม่ได้ให้ค่าเริ่มต้นไว้ ระบบจะไม่รวมข้อจำกัดแอป แพ็กเกจ เมื่อผู้ดูแลระบบบันทึกการกำหนดค่าที่มีการจัดการโดยไม่ใช้การเปลี่ยนแปลงใดๆ กับการจำกัดแอปนั้น

ตัวอย่างเช่น พร้อมกับสคีมาข้อจำกัดของแอปต่อไปนี้

"restrictions": [{
    "key": "bundle_key",
    "restrictionType": "bundle",
    "nestedRestriction": [{
            "key": "bool_key_1",
            "restrictionType": "bool",
            // defaultValue absent.
        },
        {
            "key": "bool_key_2",
            "restrictionType": "bool"
            // defaultValue absent.
        }
    ]
}]

ข้อจำกัดของแอปที่ส่งไปยังอุปกรณ์จะเป็นดังนี้

"restrictions": [
    // Empty
]

หมายเหตุ: การดำเนินการนี้จะไม่มีผลหากข้อจำกัดรวมอยู่ใน bundle_array โปรดดูรายละเอียดในส่วนต่อไปนี้

การใช้ Bundle_array ภายในสคีมาของคุณ

ส่วนนี้จะมีผลกับข้อจำกัดของแอป bundle_array ซึ่งจะไม่มีประโยชน์หากการจำกัดแอปย่อยที่มีประเภท bool, choice, integer, multi-select หรือ string มีค่าเริ่มต้น

ตัวอย่างเช่น พร้อมกับสคีมาข้อจำกัดของแอปต่อไปนี้

"restrictions": [{
    "key": "bundle_array_key",
    "restrictionType": "bundleArray",
    "nestedRestriction": [{
        "key": "bundle_key",
        "restrictionType": "bundle",
        "nestedRestriction": [{
            "key": "bool_key",
            "restrictionType": "bool",
            "defaultValue": {
                "type": "bool",
                "valueBool": true
            }
        }]
    }]
}]

มีกลุ่มชุดอย่างน้อย 1 กลุ่มในการจำกัดแอป Bundle_array

หากตั้งค่ากลุ่ม bundle ไว้อย่างน้อย 1 กลุ่ม ระบบจะรวมข้อจำกัดแอป bundle_array เมื่อผู้ดูแลระบบบันทึกการกำหนดค่าที่มีการจัดการ

ข้อจำกัดของแอปที่ส่งไปยังอุปกรณ์จะเป็นดังนี้

"restrictions": [{
    "key": "bundle_array_key",
    "restrictionType": "bundleArray",
    "nestedRestriction": [{
        "key": "bundle_key",
        "restrictionType": "bundle",
        "nestedRestriction": [{
            "key": "bool_key",
            "restrictionType": "bool",
            "value": {
                "type": "bool",
                "valueBool": true
            }
        }]
    }]
}]

หากบันทึกข้อจำกัดหรือกลุ่มแพ็กเกจไว้ 1 รายการ ระบบจะกำหนดข้อจำกัด/แพ็กเกจทั้งหมดภายใน bundle_array ทั้งหมดตามลำดับความสำคัญต่อไปนี้

• ค่าที่ผู้ดูแลระบบเลือก
• ค่าเริ่มต้นที่ระบุไว้สำหรับแพ็กเกจ/ข้อจำกัดนั้น
• ค่าที่แสดงใน iFrame หากไม่มีค่าเริ่มต้น

หมายเหตุ: เราขอแนะนำอย่างยิ่งให้ระบุค่าเริ่มต้นสำหรับข้อจำกัด/แพ็กเกจที่รวมอยู่ใน bundle_array มิเช่นนั้นแพ็กเกจจะใช้ค่าที่แสดงใน iframe (ค่าแรกที่แสดงในรายการสำหรับคีย์ดังกล่าว)

ไม่มีกลุ่มชุดในข้อจำกัดของแอปbundle_array

จะไม่มีการรวมข้อจำกัดแอป bundle_array เมื่อผู้ดูแลระบบบันทึกการกำหนดค่าที่มีการจัดการโดยไม่เพิ่มกลุ่ม bundle ข้อจำกัดของแอปที่ส่งไปยังอุปกรณ์จะเป็นดังนี้

"restrictions": [
    // Empty
]