tham chiếu dataApi cho các trang tạo

Khi bạn tạo một trang bằng ngôn ngữ tự nhiên, AI sẽ tạo một trang React trong TypeScript. Trang được tạo bao gồm cả trải nghiệm người dùng phía trước bằng cách chọn các cấu phần phù hợp và xác định bố cục tốt nhất cũng như lô-gic kinh doanh tương ứng.

Bạn có thể xem và chỉnh sửa mã đã tạo để tinh chỉnh đầu ra. Thao tác dữ liệu sử dụng dataApi đối tượng hiển thị các phương pháp công cộng sau đây:

Phương pháp	Description
`createRow`	Tạo một hàng mới trong bảng đã xác định.
`updateRow`	Cập nhật hàng hiện có trong bảng đã xác định.
`deleteRow`	Xóa một hàng khỏi bảng đã xác định.
`retrieveRow`	Truy xuất một hàng từ bảng đã xác định với các tùy chọn đã xác định.
`queryTable`	Truy vấn bảng với các tùy chọn đã xác định.
`getChoices`	Truy xuất các lựa chọn cho tên cột lựa chọn đã xác định.

`createRow` phương pháp

Tạo một hàng mới trong bảng đã xác định.

Tham số

Đặt giá trị cho các tham số bắt buộc này.

Tên	Loại	Description
`tableName`	chuỗi	Tên lô-gic của bảng để tạo hàng trong đó.
`row`	đối tượng	Dữ liệu hàng cần tạo.

Trả về

Một lời hứa có chứa kết quả của hoạt động. Khi thao tác thành công, kết quả là giá trị ID (Guid) của hàng đã tạo.

Ví dụ

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

`updateRow` phương pháp

Cập nhật hàng hiện có trong bảng đã xác định.

Tham số

Đặt giá trị cho các tham số bắt buộc này.

Tên	Loại	Description
`tableName`	chuỗi	Tên lô-gic của bảng để cập nhật hàng trong đó.
`rowId`	chuỗi	ID của hàng cần cập nhật.
`row`	Đối tượng	Dữ liệu hàng cần cập nhật.

Trả về

Một lời hứa có chứa kết quả của hoạt động. Khi thao tác thành công, nó không trả về giá trị nào.

Ví dụ

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

`deleteRow` phương pháp

Xóa một hàng khỏi bảng đã xác định.

Tham số

Đặt giá trị cho các tham số bắt buộc này.

Tên	Loại	Description
`tableName`	chuỗi	Tên lô-gic của bảng để xóa hàng trong đó.
`rowId`	chuỗi	ID của hàng cần xóa.

Trả về

Một lời hứa có chứa kết quả của hoạt động. Khi thao tác thành công, nó không trả về giá trị nào.

Ví dụ

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

`retrieveRow` phương pháp

Truy xuất một hàng từ bảng đã xác định bằng cách dùng các tùy chọn đã xác định.

Tham số

Đặt giá trị cho các tham số bắt buộc này.

Tên	Loại	Description
`tableName`	`string`	Tên lô-gic của bảng cần truy xuất từ
`options`	RetrieveRowOptions	Các tùy chọn để truy xuất hàng

RetrieveRowOptions

Tên	Loại	Description
`id`	`string`	ID (Guid) của hàng cần truy xuất
`select`	`string[]`	(Được đề xuất) Mảng tên cột cần truy xuất. Nếu bỏ qua, tất cả các cột sẽ được trả về.

Trả về

Một lời hứa có chứa kết quả của hoạt động. Khi thao tác thành công, một đối tượng chứa dữ liệu của bản ghi sẽ được trả về, bao gồm tất cả các cột đã chọn.

Ví dụ

// 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'],
});

`queryTable` phương pháp

Truy vấn bảng bằng cách sử dụng các tùy chọn đã xác định.

Tham số

Đặt giá trị cho các tham số bắt buộc này.

Tên	Loại	Description
`tableName`	`string`	Tên lô-gic của bảng cần truy vấn
`query`	QueryTableOptions	Tùy chọn để truy vấn bảng

QueryTableOptions

Tên	Loại	Description
`select`	`string[]`	(Được đề xuất) Mảng tên cột cần truy xuất.
`filter`	`string`	(Tùy chọn) Biểu thức lọc OData (ví dụ: `statecode eq 0`).
`orderBy`	`string`	(Tùy chọn) Biểu thức OData orderby (ví dụ, `name asc`, `createdon desc`).
`pageSize`	`number`	(Tùy chọn) Số hàng tối đa để trả về trên mỗi trang.

Trả về

Một lời hứa có chứa kết quả của hoạt động. Khi thao tác thành công, promise sẽ trả về một đối tượng có chứa một bảng dữ liệu với kết quả với các thuộc tính này:

Tên	Loại	Description
`rows`	`Object[]`	Mảng dữ liệu hàng
`hasMoreRows`	`boolean`	Cho biết có nhiều hàng hơn không
`loadMoreRows`	`function`	Hàm để tải trang kết quả tiếp theo. (Tùy chọn)

Ví dụ

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

Nhận xét

Lưu ý

Để có hiệu suất tốt nhất, luôn giới hạn số cột được trả về bằng cách sử dụng thuộc tính QueryTableOptionsselect .

`getChoices` phương pháp

Truy xuất các lựa chọn cho tên cột lựa chọn đã xác định.

Tham số

Tham số này là bắt buộc.

Tên	Loại	Description
`enumName`	`string`	Tên của cột lựa chọn trong định dạng `tablename-columnname`

Trả về

Một lời hứa có chứa kết quả của hoạt động. Khi thao tác thành công, nó trả về một mảng các tùy chọn lựa chọn. Mỗi tùy chọn có các thuộc tính sau:

Tên	Loại	Description
`label`	chuỗi	Giá trị nhãn bản địa hóa của tùy chọn.
`value`	Số	Giá trị số của tùy chọn.

Ví dụ

// 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');

Phản hồi

Trang này có hữu ích không?

Last updated on 2026-01-29

tham chiếu dataApi cho các trang tạo

createRow phương pháp

Tham số

Trả về

Ví dụ

updateRow phương pháp

Tham số

Trả về

Ví dụ

deleteRow phương pháp

Tham số

Trả về

Ví dụ

retrieveRow phương pháp

Tham số

RetrieveRowOptions

Trả về

Ví dụ

queryTable phương pháp

Tham số

QueryTableOptions

Trả về

Ví dụ

Nhận xét

getChoices phương pháp

Tham số

Trả về

Ví dụ

Phản hồi

Tài nguyên bổ sung

`createRow` phương pháp

`updateRow` phương pháp

`deleteRow` phương pháp

`retrieveRow` phương pháp

`queryTable` phương pháp

`getChoices` phương pháp