Metódy tabuľky Dataverse pre generatívne stránky

Pomocou metód dataApi tabuľky objektu môžete vytvoriť, načítať, aktualizovať a odstrániť riadky tabuľky Dataverse a stĺpce výberu dotazu.

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

createRow metóda

Vytvorí nový riadok v zadanej tabuľke.

Parametre

Nastavte hodnoty pre tieto povinné parametre.

Name Type Description
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 vytvorenia

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

deleteRow metóda

Odstráni riadok zo zadanej tabuľky.

Parametre

Nastavte hodnoty pre tieto povinné parametre.

Name Type Description
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 odstránenia riadkov

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

getChoices metóda

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

Parametre

Tento parameter je povinný.

Name Type Description
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 Type Description
label reťazec Hodnota lokalizovaného označenia možnosti.
value číslo Číselná hodnota možnosti.

príklad getChoices

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

queryTable metóda

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

Parametre

Nastavte hodnoty pre tieto povinné parametre.

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

QueryTableMožnosti

Name Type Description
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 Type Description
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 tabuľky queryTable

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

Note

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

retrieveRow metóda

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

Parametre

Nastavte hodnoty pre tieto povinné parametre.

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

RetrieveRowOptions

Name Type Description
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 vráti objekt s údajmi záznamu vrátane všetkých vybratých stĺpcov.

príklad načítania riadkov

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

updateRow metóda

Aktualizuje existujúci riadok v zadanej tabuľke.

Parametre

Nastavte hodnoty pre tieto povinné parametre.

Name Type Description
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 updateRow

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