วิธีการตารางผกผันสําหรับหน้าที่สร้าง

ใช้วิธีการตารางของ dataApi วัตถุเพื่อสร้าง เรียกใช้ อัปเดต และลบแถวตาราง Dataverse และคอลัมน์ตัวเลือกคิวรี

createRow วิธี

สร้างแถวใหม่ในตารางที่ระบุ

พารามิเตอร์

ตั้งค่าสําหรับพารามิเตอร์ที่จําเป็นเหล่านี้

การคืนสินค้า

สัญญาที่ประกอบด้วยผลลัพธ์ของการดําเนินงาน เมื่อการดําเนินการสําเร็จ ผลลัพธ์คือค่า ID (Guid) ของแถวที่สร้างขึ้น

ตัวอย่าง createRow

// Define the row data to create new account
var row =
    {
        "name": "Sample Account",
        "creditonhold": false,
        "address1_latitude": 47.639583,
        "description": "This is the description of the sample account",
        "revenue": 5000000,
        "accountcategorycode": 1,
    }

try {
  // Create a new account record
  const newAccountId = await dataApi.createRow("account", row);
  console.log("Account created with ID: " + newAccountId);

  // Create a contact with a lookup to an account
  const newContactId = await dataApi.createRow('contact', {
    firstname: 'John',
    lastname: 'Doe',
    emailaddress1: 'john.doe@contoso.com',
    "parentcustomerid@odata.bind": `/account(${newAccountId})`, // Lookup format
  });
}
catch (error) {
  console.log(error.message);
}

deleteRow วิธี

ลบแถวจากตารางที่ระบุ

พารามิเตอร์

ตั้งค่าสําหรับพารามิเตอร์ที่จําเป็นเหล่านี้

การคืนสินค้า

สัญญาที่ประกอบด้วยผลลัพธ์ของการดําเนินงาน เมื่อการดําเนินการสําเร็จ จะไม่มีการคืนค่า

ตัวอย่าง deleteRow

let rowId = "5531d753-95af-e711-a94e-000d3a11e605";
try {
  await dataApi.deleteRow("account", rowId);
}
catch (error) {
  console.log(error.message);
}

getChoices วิธี

เรียกใช้ตัวเลือกสําหรับชื่อคอลัมน์ตัวเลือกที่ระบุ

พารามิเตอร์

พารามิเตอร์นี้จําเป็น

การคืนสินค้า

สัญญาที่ประกอบด้วยผลลัพธ์ของการดําเนินงาน เมื่อการดําเนินการสําเร็จ จะส่งกลับอาร์เรย์ของตัวเลือกตัวเลือก แต่ละตัวเลือกมีคุณสมบัติเหล่านี้:

ตัวอย่าง getChoices

// Returns the accountcategorycode column options from the account table
const categoryChoices = await dataApi.getChoices("account-accountcategorycode");
// Returns the statecode column options from the contact table
const stateChoices = await dataApi.getChoices('contact-statecode');
// Returns the statuscode column options from the account table
const statusChoices = await dataApi.getChoices('account-statuscode');

queryTable วิธี

คิวรีตารางโดยใช้ตัวเลือกที่ระบุ

พารามิเตอร์

ตั้งค่าสําหรับพารามิเตอร์ที่จําเป็นเหล่านี้

ตัวเลือก QueryTable

การคืนสินค้า

สัญญาที่ประกอบด้วยผลลัพธ์ของการดําเนินงาน เมื่อการดําเนินการสําเร็จ สัญญาจะส่งคืนออบเจ็กต์ที่มีตารางข้อมูลพร้อมผลลัพธ์ที่มีคุณสมบัติเหล่านี้:

ตัวอย่าง queryTable

// Query tasks with options
const result = await dataApi.queryTable("task", {
    select: ["activityid", "subject", "scheduledend", "prioritycode", "statecode"],
    orderBy: "scheduledend asc",
    pageSize: 50,
    filter: "statecode eq 0"
});

// Query accounts with pagination
const pagedAccounts = await dataApi.queryTable('account', {
  select: ['name'],
  pageSize: 50,
});

console.log(`Page 1: ${pagedAccounts.rows.length} accounts`);

if (pagedAccounts.hasMoreRows && pagedAccounts.loadMoreRows) {
  const nextPage = await pagedAccounts.loadMoreRows();
  console.log(`Page 2: ${nextPage.rows.length} accounts`);
}

หมายเหตุ

retrieveRow วิธี

ดึงข้อมูลแถวจากตารางที่ระบุโดยใช้ตัวเลือกที่ระบุ

พารามิเตอร์

ตั้งค่าสําหรับพารามิเตอร์ที่จําเป็นเหล่านี้

RetrieveRowOptions

การคืนสินค้า

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

ตัวอย่าง retrieveRow

// Retrieve an account with all columns
const account = await dataApi.retrieveRow('account', {
  id: '30dc51e9-947d-47d8-ad48-4fc48fba4a95',
});

// Retrieve specific columns only
const contact = await dataApi.retrieveRow('contact', {
  id: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
  select: ['firstname', 'lastname', '_parentcustomerid_value'],
});

updateRow วิธี

อัปเดตแถวที่มีอยู่ในตารางที่ระบุ

พารามิเตอร์

ตั้งค่าสําหรับพารามิเตอร์ที่จําเป็นเหล่านี้

การคืนสินค้า

สัญญาที่ประกอบด้วยผลลัพธ์ของการดําเนินงาน เมื่อการดําเนินการสําเร็จ จะไม่มีการคืนค่า

ตัวอย่าง updateRow

let rowId = "5531d753-95af-e711-a94e-000d3a11e605"

// Define the row to update a record
var row =
    {
        "name": "Updated Sample Account ",
        "creditonhold": true,
        "address1_latitude": 47.639583,
        "description": "This is the updated description of the sample account",
        "revenue": 6000000,
        "accountcategorycode": 2
    }

// update the record

try {
   await dataApi.updateRow("account", rowId, row);
}
catch (error){
  console.log(error.message);
}