Notă
Accesul la această pagină necesită autorizare. Puteți încerca să vă conectați sau să modificați directoarele.
Accesul la această pagină necesită autorizare. Puteți încerca să modificați directoarele.
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);
}