Odkaz na dataApi pre generatívne stránky

Keď vygenerujete stránku pomocou prirodzeného jazyka, umelá inteligencia vytvorí stránku React v jazyku TypeScript. Vygenerovaná stránka zahŕňa klientske používateľské prostredie tým, že vyberie správne súčasti, určí najlepšie rozloženie a zodpovedajúcu obchodnú logiku.

Vygenerovaný kód môžete zobraziť a upraviť a spresniť výstup. Operácie s údajmi používajú dataApi objekt, ktorý sprístupňuje nasledujúce verejné metódy:

Metóda	Popis
createRow	Vytvorí nový riadok v zadanej tabuľke.
updateRow	Aktualizuje existujúci riadok v zadanej tabuľke.
deleteRow	Odstráni riadok zo zadanej tabuľky.
retrieveRow	Načíta riadok zo zadanej tabuľky so zadanými možnosťami.
queryTable	Dotazuje tabuľku so zadanými možnosťami.
getChoices	Načíta možnosti pre zadaný názov stĺpca výberu.

createRow metóda

Vytvorí nový riadok v zadanej tabuľke.

Parametre

Nastavte hodnoty pre tieto povinné parametre.

Name	Typ	Popis
tableName	reťazec	Logický názov tabuľky, v prípade čoho sa má vytvoriť riadok.
row	objekt	Údaje riadka, ktoré sa majú vytvoriť.

Vrátené hodnoty

Sľub obsahujúci výsledok operácie. Po úspešnej operácii je výsledkom hodnota ID (Guid) vytvoreného riadka.

Príklad

// 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 metóda

Aktualizuje existujúci riadok v zadanej tabuľke.

Parametre

Nastavte hodnoty pre tieto povinné parametre.

Name	Typ	Popis
tableName	reťazec	Logický názov tabuľky, v ktorá sa má aktualizovať riadok.
rowId	reťazec	ID riadka, ktorý sa má aktualizovať.
row	Object	Údaje riadka, ktoré sa majú aktualizovať.

Vrátené hodnoty

Sľub obsahujúci výsledok operácie. Keď je operácia úspešná, nevráti žiadnu hodnotu.

Príklad

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 metóda

Odstráni riadok zo zadanej tabuľky.

Parametre

Nastavte hodnoty pre tieto povinné parametre.

Name	Typ	Popis
tableName	reťazec	Logický názov tabuľky na odstránenie riadka v.
rowId	reťazec	ID riadka, ktorý sa má odstrániť.

Vrátené hodnoty

Sľub obsahujúci výsledok operácie. Keď je operácia úspešná, nevráti žiadnu hodnotu.

Príklad

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

retrieveRow metóda

Načíta riadok zo zadanej tabuľky pomocou zadaných možností.

Parametre

Nastavte hodnoty pre tieto povinné parametre.

Name	Typ	Popis
tableName	string	Logický názov tabuľky, ktorá sa má načítať z
options	RetrieveRowOptions	Možnosti načítania riadka

RetrieveRowOptions

Name	Typ	Popis
id	string	ID (identifikátor GUID) riadka, ktorý sa má načítať
select	string[]	(Odporúča sa) Pole názvov stĺpcov, ktoré sa majú načítať. Ak je tento parameter vynechaný, vrátia sa všetky stĺpce.

Vrátené hodnoty

Sľub obsahujúci výsledok operácie. Po úspešnej operácii sa vráti objekt obsahujúci údaje záznamu vrátane všetkých vybratých stĺpcov.

Príklad

// 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 metóda

Dotazuje tabuľku pomocou zadaných možností.

Parametre

Nastavte hodnoty pre tieto povinné parametre.

Name	Typ	Popis
tableName	string	Logický názov tabuľky, ktorá sa má dotazovať
query	QueryTableMožnosti	Možnosti dotazovania tabuľky

QueryTableMožnosti

Name	Typ	Popis
select	string[]	(Odporúča sa) Pole názvov stĺpcov, ktoré sa majú načítať.
filter	string	(Voliteľné) Výraz filtra OData (napríklad statecode eq 0).
orderBy	string	(Voliteľné) Výraz OData orderby (napríklad name asc, createdon desc).
pageSize	number	(Voliteľné) Maximálny počet riadkov, ktoré sa majú vrátiť na stranu.

Vrátené hodnoty

Sľub obsahujúci výsledok operácie. Po úspešnej operácii vráti sľub objekt obsahujúci tabuľku údajov s výsledkami s týmito vlastnosťami:

Name	Typ	Popis
rows	Object[]	Pole údajov riadka
hasMoreRows	boolean	Udáva, či je k dispozícii viac riadkov
loadMoreRows	function	Funkcia na načítanie ďalšej stránky s výsledkami. (voliteľné)

Príklad

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

Poznámky

Poznámka

Na dosiahnutie najlepšieho výkonu vždy obmedzte počet stĺpcov vrátených pomocou vlastnosti QueryTableOptionsselect .

getChoices metóda

Načíta možnosti pre zadaný názov stĺpca výberu.

Parametre

Tento parameter je povinný.

Name	Typ	Popis
enumName	string	Názov stĺpca výberu vo formáte tablename-columnname

Vrátené hodnoty

Sľub obsahujúci výsledok operácie. Po úspešnej operácii sa vráti pole možností výberu. Každá možnosť má tieto vlastnosti:

Name	Typ	Popis
label	reťazec	Hodnota lokalizovaného označenia možnosti.
value	number	Číselná hodnota možnosti.

Príklad

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