Dataverse-tabelmethoden voor generatieve pagina's

Gebruik de tabelmethoden van het dataApi object om Dataverse-tabelrijen en querykolommen te maken, op te halen, bij te werken en te verwijderen.

Method	Description
createRow	Hiermee maakt u een nieuwe rij in de opgegeven tabel.
deleteRow	Hiermee verwijdert u een rij uit de opgegeven tabel.
getChoices	Hiermee worden de opties opgehaald voor de opgegeven naam van de keuzekolom.
queryTable	Query's uitvoeren op een tabel met de opgegeven opties.
retrieveRow	Haalt een rij op uit de opgegeven tabel met de opgegeven opties.
updateRow	Hiermee wordt een bestaande rij in de opgegeven tabel bijgewerkt.

createRow methode

Hiermee maakt u een nieuwe rij in de opgegeven tabel.

Parameters

Stel waarden in voor deze vereiste parameters.

Name	Type	Description
tableName	string	De logische naam van de tabel waarin de rij moet worden gemaakt.
row	Object	De rijgegevens die moeten worden gemaakt.

Returns

Een belofte die het resultaat van de bewerking bevat. Wanneer de bewerking is geslaagd, is het resultaat de id-waarde (Guid) van de gemaakte rij.

createRow-voorbeeld

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

Hiermee verwijdert u een rij uit de opgegeven tabel.

Parameters

Stel waarden in voor deze vereiste parameters.

Name	Type	Description
tableName	string	De logische naam van de tabel waarin u de rij wilt verwijderen.
rowId	string	De id van de rij die u wilt verwijderen.

Returns

Een belofte die het resultaat van de bewerking bevat. Wanneer de bewerking is voltooid, wordt er geen waarde geretourneerd.

voorbeeld deleteRow

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

getChoices methode

Hiermee worden de opties opgehaald voor de opgegeven naam van de keuzekolom.

Parameters

Deze parameter is vereist.

Name	Type	Description
enumName	string	De naam van de keuzekolom in de notatie tablename-columnname

Returns

Een belofte die het resultaat van de bewerking bevat. Wanneer de bewerking is geslaagd, wordt een matrix van de keuzeopties geretourneerd. Elke optie heeft deze eigenschappen:

Name	Type	Description
label	string	De gelokaliseerde labelwaarde van de optie.
value	Nummer	De numerieke waarde van de optie.

voorbeeld 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 methode

Query's uitvoeren op een tabel met behulp van de opgegeven opties.

Parameters

Stel waarden in voor deze vereiste parameters.

Name	Type	Description
tableName	string	De logische naam van de tabel die u wilt opvragen
query	QueryTableOptions	Opties voor het uitvoeren van query's op de tabel

QueryTableOptions

Name	Type	Description
select	string[]	(Aanbevolen) Matrix met kolomnamen die moeten worden opgehaald.
filter	string	(Optioneel) OData-filterexpressie (bijvoorbeeld statecode eq 0).
orderBy	string	(Optioneel) OData orderby-expressie (bijvoorbeeld name asc, createdon desc).
pageSize	number	(Optioneel) Maximum aantal rijen dat per pagina moet worden geretourneerd.

Returns

Een belofte die het resultaat van de bewerking bevat. Wanneer de bewerking is voltooid, retourneert de belofte een object met een gegevenstabel met de resultaten met de volgende eigenschappen:

Name	Type	Description
rows	Object[]	Matrix met rijgegevens
hasMoreRows	boolean	Geeft aan of er meer rijen beschikbaar zijn
loadMoreRows	function	Functie om de volgende pagina met resultaten te laden. (Optioneel)

queryTable-voorbeeld

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

Remarks

Notitie

Beperk voor de beste prestaties altijd het aantal kolommen dat wordt geretourneerd met behulp van de eigenschap QueryTableOptionsselect .

retrieveRow methode

Haalt een rij op uit de opgegeven tabel met behulp van de opgegeven opties.

Parameters

Stel waarden in voor deze vereiste parameters.

Name	Type	Description
tableName	string	De logische naam van de tabel waaruit moet worden opgehaald
options	RetrieveRowOptions	Opties voor het ophalen van de rij

RetrieveRowOptions

Name	Type	Description
id	string	De id (GUID) van de rij die moet worden opgehaald
select	string[]	(Aanbevolen) Matrix met kolomnamen die moeten worden opgehaald. Als u dit weglaat, worden alle kolommen geretourneerd.

Returns

Een belofte die het resultaat van de bewerking bevat. Wanneer de bewerking is voltooid, wordt een object geretourneerd met de recordgegevens, inclusief alle geselecteerde kolommen.

retrieveRow-voorbeeld

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

Hiermee wordt een bestaande rij in de opgegeven tabel bijgewerkt.

Parameters

Stel waarden in voor deze vereiste parameters.

Name	Type	Description
tableName	string	De logische naam van de tabel waarin de rij moet worden bijgewerkt.
rowId	string	De id van de rij die moet worden bijgewerkt.
row	Object	De rijgegevens die moeten worden bijgewerkt.

Returns

Een belofte die het resultaat van de bewerking bevat. Wanneer de bewerking is voltooid, wordt er geen waarde geretourneerd.

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