dataApi atsauce ģeneratīvām lapām

Ģenerējot lapu, izmantojot dabisko valodu, AI izveido React lapu TypeScript. Ģenerētā lapa aptver gan priekšgala lietotāja pieredzi, atlasot pareizos komponentus un nosakot labāko izkārtojumu, gan atbilstošo biznesa loģiku.

Varat skatīt un rediģēt ģenerēto kodu, lai precizētu izvadi. Datu operācijās dataApi tiek izmantots objekts, kas atklāj šādas publiskās metodes:

Metode	Apraksts
createRow	Izveido jaunu rindu norādītajā tabulā.
updateRow	Atjaunina esošu rindu norādītajā tabulā.
deleteRow	Izdzēš rindu no norādītās tabulas.
retrieveRow	Izgūst rindu no norādītās tabulas ar norādītajām opcijām.
queryTable	Vaicā tabulā ar norādītajām opcijām.
getChoices	Izgūst norādītās izvēles kolonnas nosaukuma izvēles.

createRow metode

Izveido jaunu rindu norādītajā tabulā.

Parameters

Iestatiet šo nepieciešamo parametru vērtības.

Nosaukums	Tips	Apraksts
tableName	virkne	Tabulas loģiskais nosaukums, kurā jāizveido rinda.
row	objekts	Izveidojamie rindas dati.

Atgriešanas darbības

Solījums, kas satur operācijas rezultātu. Kad operācija ir veiksmīga, rezultāts ir izveidotās rindas ID (Guid) vērtība.

Piemērs

// 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 metode

Atjaunina esošu rindu norādītajā tabulā.

Parameters

Iestatiet šo nepieciešamo parametru vērtības.

Nosaukums	Tips	Apraksts
tableName	virkne	Tabulas loģiskais nosaukums, kurā jāatjaunina rinda.
rowId	virkne	Atjaunināmās rindas ID.
row	Objekts	Rindas dati, kas jāatjaunina.

Atgriešanas darbības

Solījums, kas satur operācijas rezultātu. Kad operācija ir veiksmīga, tā neatgriež vērtību.

Piemērs

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 metode

Izdzēš rindu no norādītās tabulas.

Parameters

Iestatiet šo nepieciešamo parametru vērtības.

Nosaukums	Tips	Apraksts
tableName	virkne	Tabulas loģiskais nosaukums, kurā jāizdzēš rinda.
rowId	virkne	Dzēšamās rindas ID.

Atgriešanas darbības

Solījums, kas satur operācijas rezultātu. Kad operācija ir veiksmīga, tā neatgriež vērtību.

Piemērs

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

retrieveRow metode

Izgūst rindu no norādītās tabulas, izmantojot norādītās opcijas.

Parameters

Iestatiet šo nepieciešamo parametru vērtības.

Nosaukums	Tips	Apraksts
tableName	string	Izgūstamās tabulas loģiskais nosaukums
options	Iegūt rindas opcijas	Rindas izgūšanas iespējas

Iegūt rindas opcijas

Nosaukums	Tips	Apraksts
id	string	Izgūstamās rindas ID (Guid)
select	string[]	(Ieteicams) Izgūstamo kolonnu nosaukumu masīvs. Ja tas ir izlaists, tiek atgrieztas visas kolonnas.

Atgriešanas darbības

Solījums, kas satur operācijas rezultātu. Kad operācija ir veiksmīga, tiek atgriezts objekts, kas satur ieraksta datus, ieskaitot visas atlasītās kolonnas.

Piemērs

// 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 metode

Vaicā tabulā, izmantojot norādītās opcijas.

Parameters

Iestatiet šo nepieciešamo parametru vērtības.

Nosaukums	Tips	Apraksts
tableName	string	Vaicājuma tabulas loģiskais nosaukums
query	QueryTableOptions	Tabulas vaicājuma opcijas

QueryTableOptions

Nosaukums	Tips	Apraksts
select	string[]	(Ieteicams) Izgūstamo kolonnu nosaukumu masīvs.
filter	string	(Pēc izvēles) OData filtra izteiksme (piemēram, statecode eq 0).
orderBy	string	(Pēc izvēles) OData orderby izteiksme (piemēram, name asc, createdon desc).
pageSize	number	(Pēc izvēles) Maksimālais atgriežamo rindu skaits vienā lappusē.

Atgriešanas darbības

Solījums, kas satur operācijas rezultātu. Kad operācija ir veiksmīga, solījums atgriež objektu, kas satur datu tabulu ar rezultātiem ar šādiem rekvizītiem:

Nosaukums	Tips	Apraksts
rows	Object[]	Rindu datu masīvs
hasMoreRows	boolean	Norāda, vai ir pieejamas citas rindas
loadMoreRows	function	Funkcija, lai ielādētu nākamo rezultātu lapu. (Pēc izvēles)

Piemērs

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

Piezīmes

Piezīmes

Lai nodrošinātu vislabāko veiktspēju, vienmēr ierobežojiet atgriezto kolonnu skaitu, izmantojot rekvizītu QueryTableOptionsselect .

getChoices metode

Izgūst norādītās izvēles kolonnas nosaukuma izvēles.

Parameters

Šis parametrs ir nepieciešams.

Nosaukums	Tips	Apraksts
enumName	string	Izvēles kolonnas nosaukums formātā tablename-columnname

Atgriešanas darbības

Solījums, kas satur operācijas rezultātu. Kad operācija ir veiksmīga, tiek atgriezts izvēles opciju masīvs. Katrai opcijai ir šādas īpašības:

Nosaukums	Tips	Apraksts
label	virkne	Opcijas lokalizētā etiķetes vērtība.
value	numurs	Opcijas skaitliskā vērtība.

Piemērs

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