dataApi referenca za generative stranice

Kada generirate stranicu pomoću prirodnog jezika, AI stvara stranicu React u programu TypeScript. Generirana stranica pokriva korisničko sučelje sučelja odabirom odgovarajućih komponenti i određivanjem najboljeg izgleda te odgovarajuće poslovne logike.

Generirani kod možete pregledati i urediti da biste suzili rezultat. Podatkovne operacije koriste dataApi objekt koji prikazuje sljedeće javne metode:

Metoda	Opis
createRow	Stvara novi redak u navedenoj tablici.
updateRow	Ažurira postojeći redak u navedenoj tablici.
deleteRow	Briše redak iz navedene tablice.
retrieveRow	Dohvaća redak iz navedene tablice s navedenim mogućnostima.
queryTable	Upiti u tablicu s navedenim mogućnostima.
getChoices	Dohvaća odabire za navedeni naziv stupca izbora.

createRow metoda

Stvara novi redak u navedenoj tablici.

Parametri

Postavite vrijednosti za te obavezne parametre.

Ime/naziv	Vrsta	Opis
tableName	niz	Logički naziv tablice za stvaranje retka u.
row	objekt	Podaci u retku koji će se stvoriti.

Vraćanja

Obećanje koje sadrži rezultat operacije. Kada operacija uspije, rezultat je ID (Guid) stvorenog retka.

Primjer

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

Ažurira postojeći redak u navedenoj tablici.

Parametri

Postavite vrijednosti za te obavezne parametre.

Ime/naziv	Vrsta	Opis
tableName	niz	Logički naziv tablice za ažuriranje retka u.
rowId	niz	ID retka koji će se ažurirati.
row	Objekt	Podaci u retku koji će se ažurirati.

Vraćanja

Obećanje koje sadrži rezultat operacije. Kada operacija uspije, ne vraća vrijednost.

Primjer

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 metoda

Briše redak iz navedene tablice.

Parametri

Postavite vrijednosti za te obavezne parametre.

Ime/naziv	Vrsta	Opis
tableName	niz	Logički naziv tablice za brisanje retka u.
rowId	niz	ID retka koji želite izbrisati.

Vraćanja

Obećanje koje sadrži rezultat operacije. Kada operacija uspije, ne vraća vrijednost.

Primjer

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

retrieveRow metoda

Dohvaća redak iz navedene tablice pomoću navedenih mogućnosti.

Parametri

Postavite vrijednosti za te obavezne parametre.

Ime/naziv	Vrsta	Opis
tableName	string	Logički naziv tablice iz koje se dohvaća
options	RetrieveRowOptions	Mogućnosti dohvaćanja retka

RetrieveRowOptions

Ime/naziv	Vrsta	Opis
id	string	ID (Guid) retka za dohvaćanje
select	string[]	(Preporučeno) Polje naziva stupaca za dohvaćanje. Ako se izostavi, vraćaju se svi stupci.

Vraćanja

Obećanje koje sadrži rezultat operacije. Kada operacija uspije, vraća se objekt koji sadrži podatke zapisa, uključujući sve odabrane stupce.

Primjer

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

Upiti u tablicu pomoću navedenih mogućnosti.

Parametri

Postavite vrijednosti za te obavezne parametre.

Ime/naziv	Vrsta	Opis
tableName	string	Logički naziv tablice za upit
query	Mogućnosti tablica upita	Mogućnosti za slanje upita tablici

Mogućnosti tablica upita

Ime/naziv	Vrsta	Opis
select	string[]	(Preporučeno) Polje naziva stupaca za dohvaćanje.
filter	string	(Neobavezno) Izraz OData filtra (na primjer, statecode eq 0).
orderBy	string	(Neobavezno) Izraz po redoslijedu OData (na primjer, name asc, createdon desc).
pageSize	number	(Neobavezno) Maksimalan broj redaka koji se vraćaju po stranici.

Vraćanja

Obećanje koje sadrži rezultat operacije. Kada operacija uspije, obećanje vraća objekt koji sadrži podatkovnu tablicu s rezultatima sa sljedećim svojstvima:

Ime/naziv	Vrsta	Opis
rows	Object[]	Polje podataka u retku
hasMoreRows	boolean	Označava je li dostupno više redaka
loadMoreRows	function	Funkcija za učitavanje sljedeće stranice rezultata. (Neobavezno)

Primjer

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

Napomene

Napomena

Da biste postigli najbolje performanse, uvijek ograničite broj vraćenih stupaca pomoću svojstva QueryTableOptionsselect .

getChoices metoda

Dohvaća odabire za navedeni naziv stupca izbora.

Parametri

Ovaj parametar je obavezan.

Ime/naziv	Vrsta	Opis
enumName	string	Naziv stupca s odabirom u obliku tablename-columnname

Vraćanja

Obećanje koje sadrži rezultat operacije. Kada operacija uspije, vraća polje mogućnosti odabira. Svaka mogućnost ima sljedeća svojstva:

Ime/naziv	Vrsta	Opis
label	niz	Lokalizirana vrijednost oznake mogućnosti.
value	Broj	Brojčana vrijednost mogućnosti.

Primjer

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