Dataverse table methods for generative pages

Utilizați metodele de tabel ale obiectului dataApi pentru a crea, a regăsi, a actualiza și a șterge rânduri de tabel Dataverse și coloane de alegere a interogărilor.

Metodă Descriere
createRow Creează un rând nou în tabelul specificat.
deleteRow Șterge un rând din tabelul specificat.
getChoices Regăsește opțiunile pentru numele coloanei de alegere specificate.
queryTable Interoghează un tabel cu opțiunile specificate.
retrieveRow Regăsește un rând din tabelul specificat cu opțiunile specificate.
updateRow Actualizează un rând existent din tabelul specificat.

createRow metodă

Creează un rând nou în tabelul specificat.

Parametri

Setați valorile pentru acești parametri necesari.

Nume Tip Descriere
tableName șir Numele logic al tabelului în care se creează rândul.
row obiect Datele de rând de creat.

Retururi

O promisiune care conține rezultatul operațiunii. Atunci când operațiunea reușește, rezultatul este valoarea ID (GUID) a rândului creat.

createRow example

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

Șterge un rând din tabelul specificat.

Parametri

Setați valorile pentru acești parametri necesari.

Nume Tip Descriere
tableName șir Numele logic al tabelului în care se șterge rândul.
rowId șir ID-ul rândului de șters.

Retururi

O promisiune care conține rezultatul operațiunii. Atunci când operațiunea reușește, nu returnează nicio valoare.

deleteRow example

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

getChoices metodă

Regăsește opțiunile pentru numele coloanei de alegere specificate.

Parametri

Acest parametru este necesar.

Nume Tip Descriere
enumName string Numele coloanei de alegere în format tablename-columnname

Retururi

O promisiune care conține rezultatul operațiunii. Atunci când operațiunea reușește, returnează o matrice cu opțiunile de alegere. Fiecare opțiune are aceste proprietăți:

Nume Tip Descriere
label șir Valoarea etichetei localizate a opțiunii.
value număr Valoarea numerică a opțiunii.

getChoices example

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

Interoghează un tabel utilizând opțiunile specificate.

Parametri

Setați valorile pentru acești parametri necesari.

Nume Tip Descriere
tableName string Numele logic al tabelului de interogat
query InterogăriTableOptions Opțiuni pentru interogarea tabelului

InterogăriTableOptions

Nume Tip Descriere
select string[] (Recomandat) Matrice de nume de coloane de regăsit.
filter string (Opțional) Expresie filtru OData (de exemplu, statecode eq 0).
orderBy string (Opțional) OData orderby expresie (de exemplu, name asc, createdon desc).
pageSize number (Opțional) Numărul maxim de rânduri de returnat pe pagină.

Retururi

O promisiune care conține rezultatul operațiunii. Atunci când operațiunea reușește, promisiunea returnează un obiect care conține un tabel de date cu rezultatele cu aceste proprietăți:

Nume Tip Descriere
rows Object[] Matrice de date de rând
hasMoreRows boolean Indică dacă sunt disponibile mai multe rânduri
loadMoreRows function Funcția pentru a încărca următoarea pagină de rezultate. (Opțional)

queryTable example

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

Observații

Notă

Pentru o performanță optimă, limitați întotdeauna numărul de coloane returnate utilizând proprietatea QueryTableOptionsselect .

retrieveRow metodă

Regăsește un rând din tabelul specificat, utilizând opțiunile specificate.

Parametri

Setați valorile pentru acești parametri necesari.

Nume Tip Descriere
tableName string Numele logic al tabelului de regăsit din
options RetrieveRowOptions Opțiuni pentru regăsirea rândului

RetrieveRowOptions

Nume Tip Descriere
id string ID-ul (GUID) al rândului de regăsit
select string[] (Recomandat) Matrice de nume de coloane de regăsit. Dacă este omisă, se returnează toate coloanele.

Retururi

O promisiune care conține rezultatul operațiunii. Atunci când operațiunea reușește, returnează un obiect cu datele înregistrării, inclusiv toate coloanele selectate.

retrieveRow example

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

Actualizează un rând existent din tabelul specificat.

Parametri

Setați valorile pentru acești parametri necesari.

Nume Tip Descriere
tableName șir Numele logic al tabelului în care se actualizează rândul.
rowId șir ID-ul rândului de actualizat.
row Obiect Datele de rând de actualizat.

Retururi

O promisiune care conține rezultatul operațiunii. Atunci când operațiunea reușește, nu returnează nicio valoare.

updateRow example

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