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

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

ไวยากรณ์

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

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

พารามิเตอร์

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

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

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

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

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

เรกคอร์ดเอนทิตี

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

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

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

แดชบอร์ด

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

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

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

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

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

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

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

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

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

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

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

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

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

ค่าผลลัพธ์

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

• แบบอินไลน์: สัญญาจะแก้ทันทีและไม่ส่งกลับค่าใด ๆ

• กล่องโต้ตอบ: Promise จะแก้ปัญหาเมื่อปิดกล่องโต้ตอบ วัตถุจะถูกส่งผ่านก็ต่อเมื่อ pageType = entityRecord คุณเปิดฟอร์มในโหมดสร้างเท่านั้น ออบเจ็กต์ มี savedEntityReference อาร์เรย์ที่มีคุณสมบัติต่อไปนี้เพื่อระบุเรกคอร์ดตารางที่สร้างขึ้น:

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

ตัวอย่าง

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

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

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

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

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

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

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
    }
);

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

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

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
    }
);

ตัวอย่างที่ 4: เปิดทรัพยากรบนเว็บ 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
    }
);

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

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