addNotification (การอ้างอิง Client API)

แสดงข้อผิดพลาดหรือการแจ้งเตือนคําแนะนําสําหรับตัวควบคุม และช่วยให้คุณระบุการดําเนินการเพื่อดําเนินการตามการแจ้งเตือน เมื่อคุณระบุชนิดการแจ้งเตือนข้อผิดพลาด ไอคอน "X" สีแดงจะปรากฏขึ้นถัดจากตัวควบคุม เมื่อคุณระบุชนิดการแจ้งเตือนคําแนะนํา ไอคอน "i" จะปรากฏขึ้นถัดจากตัวควบคุม บน Dynamics 365 mobile clients แตะบนไอคอนจะแสดงข้อความ และช่วยให้คุณดําเนินการกําหนดค่าโดยคลิกปุ่ม นําไปใช้ หรือยกเลิกข้อความ

ประเภทตัวควบคุมที่ได้รับการสนับสนุน

ทั้งหมด

ไวยากรณ์

formContext.getControl(arg).addNotification(notification);

พารามิเตอร์

ชื่อ	ประเภท	ต้องมี	คำอธิบาย
notification	ออบเจ็กต์	ใช่	การแจ้งเตือนที่จะเพิ่ม ดู notification พารามิเตอร์

notification พารามิเตอร์

พารามิเตอร์ notification ยอมรับวัตถุที่มีคุณสมบัติต่อไปนี้

ชื่อ	ประเภท	ต้องมี	คำอธิบาย
actions	อาร์เรย์ของวัตถุ	ไม่	ดู actions คุณสมบัติ
messages	อาร์เรย์ของสตริง	ใช่	ข้อความที่จะแสดงในการแจ้งเตือน ในการเผยแพร่ปัจจุบัน จะแสดงเฉพาะข้อความแรกที่ระบุในอาร์เรย์นี้เท่านั้น สตริงที่คุณระบุที่นี่จะปรากฏเป็นข้อความตัวหนาในการแจ้งเตือน และมักใช้สําหรับชื่อเรื่องหรือชื่อเรื่องของการแจ้งเตือน คุณควรจํากัดข้อความของคุณไว้ที่ 50 ตัวอักษรเพื่อให้ผู้ใช้ได้รับประสบการณ์การใช้งานที่เหมาะสม
notificationLevel	สตริง	ใช่	กําหนดชนิดของการแจ้งเตือน ค่าที่ใช้ได้คือ ERROR หรือ RECOMMENDATION
uniqueId	สตริง	ใช่	ID ที่ใช้เพื่อล้างการแจ้งเตือนนี้เมื่อใช้วิธีการ clearNotification

actions ทรัพย์สิน

คุณสมบัติ actions ประกอบด้วยอาร์เรย์ของออบเจ็กต์ที่มีคุณสมบัติต่อไปนี้:

ชื่อ	ประเภท	ต้องมี	คำอธิบาย
message	สตริง	ไม่	เนื้อความของการแจ้งเตือนที่จะแสดงให้ผู้ใช้ จํากัดข้อความของคุณไว้ที่ 100 ตัวอักษรเพื่อให้ผู้ใช้ได้รับประสบการณ์การใช้งานที่เหมาะสม
actions	อาร์เรย์ของฟังก์ชัน	ไม่	การดําเนินการที่สอดคล้องกันสําหรับข้อความ

ค่าส่งกลับ

ชนิด: บูลีน

คําอธิบาย: ระบุว่าวิธีการสําเร็จหรือไม่

หมายเหตุ

ในไคลเอ็นต์เว็บ เมธอด addNotification แสดงการแจ้งเตือนด้วยข้อความที่คุณระบุและปุ่มมาตรฐานสองปุ่ม: นําไปใช้และยกเลิก การคลิก นําไปใช้ จะดําเนินการตามที่คุณกําหนด; การคลิก ปิด ข้อความแจ้งเตือน

ในอินเทอร์เฟซแบบรวม:

• ไม่มีปุ่มปิด
• ปุ่ม นําไปใช้ จะปรากฏเฉพาะเมื่อระดับการแจ้งเตือนถูกตั้งค่าเป็น คําแนะนํา ไม่ใช่ ข้อผิดพลาด

ตัวอย่าง

รหัสตัวอย่างต่อไปนี้แสดงการแจ้งเตือนในคอลัมน์ ชื่อบัญชี ของฟอร์มบัญชีเพื่อตั้งค่า สัญลักษณ์ Ticker ถ้าคอลัมน์ ชื่อบัญชี ประกอบด้วย "Microsoft" และสัญลักษณ์เครื่องหมายไม่ได้ตั้งค่าเป็น "MSFT" การคลิก นําไปใช้ ในการแจ้งเตือนจะตั้งค่าคอลัมน์ สัญลักษณ์ Ticker เป็น "MSFT"

function addTickerSymbolRecommendation(executionContext) {
    var formContext = executionContext.getFormContext();
    var myControl = formContext.getControl('name');
    var accountName = formContext.data.entity.attributes.get('name');
    var tickerSymbol = formContext.data.entity.attributes.get('tickersymbol');

    if (accountName.getValue() == 'Microsoft' && tickerSymbol.getValue() != 'MSFT') {
        var actionCollection = {
            message: 'Set the Ticker Symbol to MSFT?',
            actions: null
        };

        actionCollection.actions = [function () {
            tickerSymbol.setValue('MSFT');
            myControl.clearNotification('my_unique_id');
        }];

        myControl.addNotification({
            messages: ['Set Ticker Symbol'],
            notificationLevel: 'RECOMMENDATION',
            uniqueId: 'my_unique_id',
            actions: [actionCollection]
        });
    }
    else
        console.log("Notification not set");
}

การแจ้งเตือนนี้ปรากฏในแอปแบบจําลองข้อมูล:

บทความที่เกี่ยวข้อง

clearNotification
setNotification