Генеративті беттерге арналған dataApi анықтама

Табиғи тілмен бет жасағанда, жасанды интеллект TypeScript-те React бетін жасайды. Жасалған бет дұрыс компоненттерді таңдап, ең жақсы орналасуды анықтау арқылы алдыңғы интерфейс пайдаланушы тәжірибесін және сәйкес бизнес логикасын қамтиды.

Сіз генерацияланған кодты қарап, өңдеп, нәтижесін нақтылай аласыз. Деректер операциялары келесі қоғамдық әдістерді ашатын dataApi объектіні пайдаланады:

Әдіс	Сипаттама
createRow	Көрсетілген кестеде жаңа жол жасайды.
updateRow	Көрсетілген кестедегі бар жолды жаңартады.
deleteRow	Көрсетілген кестеден бір жолды өшіреді.
retrieveRow	Көрсетілген кестеден көрсетілген опциялар бар жолды алады.
queryTable	Көрсетілген опциялар бар кестеге сұрау жасайды.
getChoices	Көрсетілген таңдау бағанасының атауы үшін таңдауларды алады.

createRow әдіс

Көрсетілген кестеде жаңа жол жасайды.

Параметрлер

Қажетті параметрлерге мәндер орнатыңыз.

Аты	Түр	Сипаттама
tableName	жол	Кестенің логикалық атауы — қатар құру үшін.
row	нысан	Құру үшін қатар деректері.

Қайтару

Операцияның нәтижесін қамтитын уәде . Операция сәтті орындалғанда, нәтиже — жасалған жолдың ID (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	жол	Жолдың ID-ін жаңарту керек.
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	жол	Жоюға арналған жолдың ID-і.

Қайтару

Операцияның нәтижесін қамтитын уәде . Операция сәтті болғанда, ешқандай мән қайтарылмайды.

Мысал

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	Алу үшін қатардың ID (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	QueryTableOptions	Кестеге сұрау жасау опциялары

QueryTableOptions

Аты	Түр	Сипаттама
select	string[]	(Ұсынылады) Бағана атауларының жиынтығын алу керек.
filter	string	(Міндетті емес) OData сүзгі өрнесі (мысалы, statecode eq 0).
orderBy	string	(Міндетті емес) OData ретпен өрнек (мысалы, name asc, createdon 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');