dataApi справка за жанеративни страници

Когато генерирате страница на естествен език, ИИ създава страница React в TypeScript. Генерираната страница обхваща както клиентската среда за работа на потребителите, като избира правилните компоненти и определя най-доброто оформление, така и съответната бизнес логика.

Можете да преглеждате и редактирате генерирания код, за да прецизирате резултата. Операциите с dataApi данни използват обект, който показва следните публични методи:

Метод	Описание
createRow	Създава нов ред в указаната таблица.
updateRow	Актуализира съществуващ ред в указаната таблица.
deleteRow	Изтрива ред от указаната таблица.
retrieveRow	Извлича ред от указаната таблица със зададените опции.
queryTable	Заявки към таблица с указаните опции.
getChoices	Извлича възможностите за избор за зададеното име на колона за избор.

createRow метод

Създава нов ред в указаната таблица.

Параметри

Задайте стойности за тези задължителни параметри.

Име	Тип	Описание
tableName	низ	Логическото име на таблицата, в която трябва да се създаде редът.
row	обект	Данните за реда, които трябва да се създадат.

Връщания

Обещание, съдържащо резултата от операцията. Когато операцията е успешна, резултатът е стойността на ИД (Guid) на създадения ред.

Пример

// 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 метод

Актуализира съществуващ ред в указаната таблица.

Параметри

Задайте стойности за тези задължителни параметри.

Име	Тип	Описание
tableName	низ	Логическото име на таблицата, в която да се актуализира редът.
rowId	низ	ИД на реда за актуализиране.
row	Обект	Данните за реда, които трябва да се актуализират.

Връщания

Обещание, съдържащо резултата от операцията. Когато операцията е успешна, тя не връща стойност.

Пример

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 метод

Изтрива ред от указаната таблица.

Параметри

Задайте стойности за тези задължителни параметри.

Име	Тип	Описание
tableName	низ	Логическото име на таблицата, в която да се изтрие редът.
rowId	низ	ИД на реда за изтриване.

Връщания

Обещание, съдържащо резултата от операцията. Когато операцията е успешна, тя не връща стойност.

Пример

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

retrieveRow метод

Извлича ред от указаната таблица с помощта на зададените опции.

Параметри

Задайте стойности за тези задължителни параметри.

Име	Тип	Описание
tableName	string	Логическото име на таблицата, от която да се извлече
options	RetrieveRowOptions	Опции за извличане на реда

RetrieveRowOptions

Име	Тип	Описание
id	string	ИД (Guid) на реда за извличане
select	string[]	(Препоръчва се) Масив от имена на колони за извличане. Ако е пропуснато, се връщат всички колони.

Връщания

Обещание, съдържащо резултата от операцията. Когато операцията е успешна, се връща обект, съдържащ данните на записа, включително всички избрани колони.

Пример

// 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 метод

Заявки към таблица с помощта на зададените опции.

Параметри

Задайте стойности за тези задължителни параметри.

Име	Тип	Описание
tableName	string	Логическото име на таблицата за заявка
query	Опции за таблица със заявки	Опции за заявка към таблицата

Опции за таблица със заявки

Име	Тип	Описание
select	string[]	(Препоръчва се) Масив от имена на колони за извличане.
filter	string	(По избор) Израз за филтър на OData (например statecode eq 0).
orderBy	string	(По избор) OData orderby израз (например , name asccreatedon desc).
pageSize	number	(По избор) Максимален брой редове за връщане на страница.

Връщания

Обещание, съдържащо резултата от операцията. Когато операцията е успешна, обещанието връща обект, съдържащ таблица с данни с резултатите със следните свойства:

Име	Тип	Описание
rows	Object[]	Масив от данни за ред
hasMoreRows	boolean	Показва дали има повече налични редове
loadMoreRows	function	Функция за зареждане на следващата страница с резултати. (По избор)

Пример

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

Забележки

Бележка

За най-добра производителност винаги ограничавайте броя на колоните, върнати с помощта на свойството QueryTableOptionsselect .

getChoices метод

Извлича възможностите за избор за зададеното име на колона за избор.

Параметри

Този параметър е задължителен.

Име	Тип	Описание
enumName	string	Името на колоната за избор във формата tablename-columnname

Връщания

Обещание, съдържащо резултата от операцията. Когато операцията е успешна, тя връща масив от опциите за избор. Всяка опция има следните свойства:

Име	Тип	Описание
label	низ	Стойността на локализирания етикет на опцията.
value	номер	Числовата стойност на опцията.

Пример

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