dataApi reference for generative pages

Ko ustvarite stran z naravnim jezikom, AI ustvari stran React v TypeScriptu. Ustvarjena stran zajema osnovno uporabniško izkušnjo tako, da izbere ustrezne komponente in določi najboljšo postavitev ter ustrezno poslovno logiko.

Ustvarjeno kodo si lahko ogledate in jo uredite, da natančneje določite rezultat. Podatkovne operacije uporabljajo predmet dataApi , ki razkriva te javne metode:

Način	Opis
createRow	Ustvari novo vrstico v določeni tabeli.
updateRow	Posodobi obstoječo vrstico v navedeni tabeli.
deleteRow	Izbriše vrstico iz določene tabele.
retrieveRow	Pridobi vrstico iz določene tabele z določenimi možnostmi.
queryTable	Poizvedba v tabeli z določenimi možnostmi.
getChoices	Pridobi izbire za navedeno ime stolpca izbire.

createRow metoda

Ustvari novo vrstico v določeni tabeli.

Parametri

Nastavite vrednosti za te zahtevane parametre.

Ime	Vrsta	Opis
tableName	niz	Logično ime tabele, v kateri želite ustvariti vrstico.
row	predmet	Podatki vrstice, ki jih želite ustvariti.

Vrnjeno

Obljuba, ki vsebuje rezultat operacije. Ko je operacija uspešna, je rezultat vrednost ID-ja (GUID) ustvarjene vrstice.

Primer

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

Posodobi obstoječo vrstico v navedeni tabeli.

Parametri

Nastavite vrednosti za te zahtevane parametre.

Ime	Vrsta	Opis
tableName	niz	Logično ime tabele, v kateri želite posodobiti vrstico.
rowId	niz	ID vrstice, ki jo želite posodobiti.
row	Predmet	Podatki vrstice, ki jih želite posodobiti.

Vrnjeno

Obljuba, ki vsebuje rezultat operacije. Ko je operacija uspešna, ne vrne nobene vrednosti.

Primer

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

Izbriše vrstico iz določene tabele.

Parametri

Nastavite vrednosti za te zahtevane parametre.

Ime	Vrsta	Opis
tableName	niz	Logično ime tabele, v kateri želite izbrisati vrstico.
rowId	niz	ID vrstice, ki jo želite izbrisati.

Vrnjeno

Obljuba, ki vsebuje rezultat operacije. Ko je operacija uspešna, ne vrne nobene vrednosti.

Primer

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

retrieveRow metoda

Pridobi vrstico iz določene tabele z določenimi možnostmi.

Parametri

Nastavite vrednosti za te zahtevane parametre.

Ime	Vrsta	Opis
tableName	string	Logično ime tabele, iz katero želite pridobiti
options	RetrieveRowOptions	Možnosti za pridobivanje vrstice

RetrieveRowOptions

Ime	Vrsta	Opis
id	string	ID (GUID) vrstice, ki jo želite pridobiti
select	string[]	(priporočeno) Matrika imen stolpcev, ki jih želite pridobiti. Če ga izpustite, so vrnjeni vsi stolpci.

Vrnjeno

Obljuba, ki vsebuje rezultat operacije. Ko je operacija uspešna, je vrnjen predmet s podatki zapisa, vključno z vsemi izbranimi stolpci.

Primer

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

Poizvedba za tabelo z uporabo navedenih možnosti.

Parametri

Nastavite vrednosti za te zahtevane parametre.

Ime	Vrsta	Opis
tableName	string	Logično ime tabele za poizvedbo
query	Možnosti tabele poizvedbe	Options for querying the table

Možnosti tabele poizvedbe

Ime	Vrsta	Opis
select	string[]	(priporočeno) Matrika imen stolpcev, ki jih želite pridobiti.
filter	string	(Izbirno) Izraz filtra OData (na primer statecode eq 0).
orderBy	string	(Izbirno) Izraz »orderby« OData (na primer , name asccreatedon desc).
pageSize	number	(Izbirno) Največje število vrstic, ki jih želite vrniti na stran.

Vrnjeno

Obljuba, ki vsebuje rezultat operacije. Ko je operacija uspešna, obljuba vrne predmet, ki vsebuje podatkovno tabelo z rezultati s temi lastnostmi:

Ime	Vrsta	Opis
rows	Object[]	Matrika podatkov vrstice
hasMoreRows	boolean	Označuje, ali je na voljo več vrstic
loadMoreRows	function	Funkcija za nalaganje naslednje strani rezultatov. (Izbirno)

Primer

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

Pripombe

opomba,

Za najboljšo učinkovitost delovanja vedno omejite število stolpcev, ki jih vrne lastnost QueryTableOptionsselect .

getChoices metoda

Pridobi izbire za navedeno ime stolpca izbire.

Parametri

Ta parameter je potreben.

Ime	Vrsta	Opis
enumName	string	Ime stolpca za izbiro v obliki tablename-columnname

Vrnjeno

Obljuba, ki vsebuje rezultat operacije. Ko je operacija uspešna, vrne polje z možnostmi izbire. Vsaka možnost ima te lastnosti:

Ime	Vrsta	Opis
label	niz	Lokalizirana vrednost oznake možnosti.
value	število	Številska vrednost možnosti.

Primer

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