navigateTo (การอ้างอิง API ไคลเอ็นต์)

นําทางไปยังรายการตาราง ระเบียนตาราง ทรัพยากร HTML เว็บ หรือหน้าแบบกําหนดเองที่ระบุ

ไวยากรณ์

ใช้ไวยากรณ์ต่อไปนี้เพื่อเรียกXrm.Navigation.navigateTo()

Xrm.Navigation.navigateTo(pageInput,navigationOptions).then(successCallback,errorCallback);

พารามิเตอร์

เมธอด ยอมรับพารามิเตอร์ต่อไปนี้

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

การเปลี่ยนแปลงข้อกําหนดของวัตถุโดยขึ้นอยู่กับชนิดของหน้าเพื่อนําทางไปยัง: รายการเอนทิตีระเบียนเอนทิตีแดชบอร์ดทรัพยากรบนเว็บ HTMLหน้าแบบกําหนดเอง หรือหน้าสร้าง

รายการเอนทิตี

วัตถุรายการเอนทิตีประกอบด้วยค่าต่อไปนี้

ระเบียนเอนทิตี

วัตถุระเบียนเอนทิตีประกอบด้วยค่าต่อไปนี้

เรียนรู้วิธีการเปิดฟอร์มหลักในกล่องโต้ตอบโดยใช้ API ของไคลเอ็นต์

ออบเจ็กต์ความสัมพันธ์

วัตถุความสัมพันธ์ที่ใช้ใน ระเบียนเอนทิตีประกอบด้วยค่าต่อไปนี้

แดชบอร์ด

ใช้วัตถุpageInputนี้เป็นพารามิเตอร์เมื่อคุณต้องการเปิดแดชบอร์ด

ออบเจ็กต์แดชบอร์ดประกอบด้วยค่าต่อไปนี้

ทรัพยากรบนเว็บ HTML

ใช้วัตถุpageInputนี้เป็นพารามิเตอร์เมื่อคุณต้องการเปิดทรัพยากรบนเว็บ HTML

วัตถุทรัพยากรเว็บ HTML ประกอบด้วยค่าต่อไปนี้

หน้าแบบกําหนดเอง

ใช้วัตถุpageInputนี้เป็นพารามิเตอร์เมื่อคุณต้องการเปิดหน้าแบบกําหนดเอง

ออบเจ็กต์หน้าแบบกําหนดเองประกอบด้วยค่าต่อไปนี้

หน้าที่สร้าง

ใช้ออบเจ็กต์pageInputนี้เป็นพารามิเตอร์เมื่อคุณต้องการเปิดหน้าที่สร้าง

เมื่อต้องการใช้ recordIdentityName, หรือ dataต้องตั้งค่าหน้าการสร้างเป้าหมายเพื่อยอมรับพารามิเตอร์การป้อนข้อมูล

ออบเจ็กต์หน้าที่สร้างประกอบด้วยค่าต่อไปนี้

ดูตัวอย่างที่แสดงวิธีการนําทางไปยังและจากหน้าที่สร้างโดยใช้ API ของไคลเอ็นต์

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

วัตถุ navigationOptions ประกอบด้วยค่าต่อไปนี้

ค่าที่ส่งกลับ

ส่งกลับสัญญา ค่าที่ส่งผ่านเมื่อสัญญาคลี่คลายขึ้นอยู่กับประเภทเป้าหมายและหน้า:

• แบบอินไลน์: สัญญาจะแก้ไขเมื่อการนําทางเสร็จสมบูรณ์และไม่ส่งกลับค่า
• กล่องโต้ตอบ: สัญญาจะได้รับการแก้ไขเมื่อกล่องโต้ตอบปิด
  • สําหรับเรกคอร์ดเอนทิตีที่เปิดในโหมดสร้าง สัญญาจะแก้ไขด้วยออบเจ็กต์ที่มี savedEntityReference อาร์เรย์
  • สําหรับหน้าสร้าง สัญญาจะแก้ไขด้วยออบเจ็กต์ที่มีreturnValueคุณสมบัติที่มีค่าที่ส่งผ่านล่าสุดไปยังdataApi.setPageOutput(value) ถ้าหน้าที่สร้างไม่ได้ตั้งค่าเอาต์พุต ให้ปิดกล่องโต้ตอบโดยการเลือก ยกเลิก หรือปุ่มปิด จะส่งผลให้เกิด ที่ไม่ได้กําหนด returnValueไว้
  • หน้าชนิดอื่น ๆ จะไม่ส่งกลับค่าเมื่อปิดกล่องโต้ตอบ

อาร์เรย์ savedEntityReference ที่ส่งกลับสําหรับเรกคอร์ดเอนทิตีประกอบด้วยคุณสมบัติเหล่านี้:

• entityType: ชื่อตรรกะของตาราง
• id: การแสดงสตริงของ GUID ของระเบียน
• ชื่อ: ค่าคอลัมน์หลักของระเบียน

ตัวอย่างเช่น

ตัวอย่างต่อไปนี้สาธิตการนําทางไปยังหน้าชนิดต่าง ๆ แบบอินไลน์และในกล่องโต้ตอบ

ตัวอย่างรายการบัญชีที่เปิด

เปิดรายการบัญชีหลักแบบอินไลน์

var pageInput = {
    pageType: "entitylist",
    entityName: "account"
};
Xrm.Navigation.navigateTo(pageInput).then(
    function success() {
            // Run code on success
    },
    function error() {
            // Handle errors
    }
);

เปิดเรกคอร์ดบัญชีที่มีอยู่ภายในตัวอย่างกล่องโต้ตอบ

เปิดฟอร์มบัญชีที่มีอยู่ภายในกล่องโต้ตอบ

var pageInput = {
    pageType: "entityrecord",
    entityName: "account",
    entityId: "00aa00aa-bb11-cc22-dd33-44ee44ee44ee" //replace with actual ID
};
var navigationOptions = {
    target: 2,
    height: {value: 80, unit:"%"},
    width: {value: 70, unit:"%"},
    position: 1
};
Xrm.Navigation.navigateTo(pageInput, navigationOptions).then(
    function success() {
            // Run code on success
    },
    function error() {
            // Handle errors
    }
);

เรียนรู้วิธีการเปิดฟอร์มหลักในกล่องโต้ตอบโดยใช้ API ของไคลเอ็นต์

เปิดฟอร์มบัญชีในโหมดสร้างภายในตัวอย่างกล่องโต้ตอบ

เปิดฟอร์มบัญชีในโหมดสร้างภายในกล่องโต้ตอบและส่งกลับการอ้างอิงระเบียนที่สร้างขึ้นเมื่อบันทึก

var pageInput = {
    pageType: "entityrecord",
    entityName: "account"    
};
var navigationOptions = {
    target: 2,
    height: {value: 80, unit:"%"},
    width: {value: 70, unit:"%"},
    position: 1
};
Xrm.Navigation.navigateTo(pageInput, navigationOptions).then(
    function success(result) {
            console.log("Record created with ID: " + result.savedEntityReference[0].id + 
            " Name: " + result.savedEntityReference[0].name)
            // Handle dialog closed
    },
    function error() {
            // Handle errors
    }
);

เรียนรู้วิธีการเปิดฟอร์มหลักในกล่องโต้ตอบโดยใช้ API ของไคลเอ็นต์

เปิดทรัพยากรเว็บ HTML ในตัวอย่างกล่องโต้ตอบ

เปิดทรัพยากรบนเว็บ HTML ในกล่องโต้ตอบ

var pageInput = {
    pageType: "webresource",
    webresourceName: "new_sample_webresource.htm"
};
var navigationOptions = {
    target: 2,
    width: 500, // value specified in pixel
    height: 400, // value specified in pixel
    position: 1
};
Xrm.Navigation.navigateTo(pageInput, navigationOptions).then(
    function success() {
            // Run code on success
    },
    function error() {
            // Handle errors
    }
);

เปิดหน้าสร้างที่มีพารามิเตอร์การป้อนข้อมูลในตัวอย่างกล่องโต้ตอบ

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

var pageInput = {
    pageType: "generative",
    pageId: "<genPageID>", // replace with the ID of your generative page
    recordId: "00aa00aa-bb11-cc22-dd33-44ee44ee44ee", // replace with actual record GUID
    entityName: "account",
    data: { status: "active", category: "premium" }
};
var navigationOptions = {
    target: 2,
    height: {value: 80, unit: "%"},
    width: {value: 70, unit: "%"},
    position: 1
};
Xrm.Navigation.navigateTo(pageInput, navigationOptions).then(
    function success(result) {
        const output = result?.returnValue;
        if (output) {
            console.log("Value returned by generative page:", output);
        }
    },
    function error(error) {
        console.log(error.message);
    }
);

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

Xrm.Navigation
นําทางไปยังและจากหน้าที่สร้าง
การนําทางไปยังและจากหน้าแบบกําหนดเอง (ตัวอย่าง)