Dataverse table methods for generative pages

Az objektum táblametódusainak dataApi használatával dataverse táblasorokat és lekérdezésválasztó oszlopokat hozhat létre, kérdezhet le, frissíthet és törölhet.

Method Description
createRow Új sort hoz létre a megadott táblában.
deleteRow Töröl egy sort a megadott táblából.
getChoices Lekéri a megadott választási lehetőségek oszlopának nevét.
queryTable Lekérdez egy táblát a megadott beállításokkal.
retrieveRow Beolvas egy sort a megadott táblából a megadott beállításokkal.
updateRow Frissíti a megadott tábla egy meglévő sorát.

createRow módszer

Új sort hoz létre a megadott táblában.

Parameters

Adja meg ezeknek a szükséges paramétereknek az értékeit.

Name Típus Description
tableName karakterlánc A sor létrehozásához a tábla logikai neve.
row objektum A létrehozandó soradatok.

Returns

A művelet eredményét tartalmazó ígéret . Ha a művelet sikeres, az eredmény a létrehozott sor azonosítójának (GUID) értéke.

createRow-példa

// 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 módszer

Töröl egy sort a megadott táblából.

Parameters

Adja meg ezeknek a szükséges paramétereknek az értékeit.

Name Típus Description
tableName karakterlánc A sor törlésére kijelölt tábla logikai neve.
rowId karakterlánc A törölni kívánt sor azonosítója.

Returns

A művelet eredményét tartalmazó ígéret . Ha a művelet sikeres, nem ad vissza értéket.

deleteRow-példa

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

getChoices módszer

Lekéri a megadott választási lehetőségek oszlopának nevét.

Parameters

Ez a paraméter kötelező.

Name Típus Description
enumName string A választott oszlop neve a formátumban tablename-columnname

Returns

A művelet eredményét tartalmazó ígéret . Ha a művelet sikeres, a választott lehetőségek tömbje lesz visszaadva. Mindegyik beállítás a következő tulajdonságokkal rendelkezik:

Name Típus Description
label karakterlánc A beállítás honosított címkeértéke.
value number A beállítás numerikus értéke.

getChoices példa

// 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 módszer

A megadott beállításokkal lekérdez egy táblát.

Parameters

Adja meg ezeknek a szükséges paramétereknek az értékeit.

Name Típus Description
tableName string A lekérdezendő tábla logikai neve
query QueryTableOptions A tábla lekérdezésének beállításai

QueryTableOptions

Name Típus Description
select string[] (Ajánlott) A lekérendő oszlopnevek tömbje.
filter string (Nem kötelező) OData szűrőkifejezés (például statecode eq 0).
orderBy string (Nem kötelező) OData orderby kifejezés (például name asc, createdon desc).
pageSize number (Nem kötelező) Az oldalonként visszaadandó sorok maximális száma.

Returns

A művelet eredményét tartalmazó ígéret . Ha a művelet sikeres, az ígéret egy adattáblát tartalmazó objektumot ad vissza az alábbi tulajdonságokkal:

Name Típus Description
rows Object[] Soradatok tömbje
hasMoreRows boolean Azt jelzi, hogy több sor áll-e rendelkezésre
loadMoreRows function Függvény az eredmények következő oldalának betöltéséhez. (Nem kötelező)

queryTable-példa

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

Megjegyzés

A legjobb teljesítmény érdekében mindig korlátozza a QueryTableOptionsselect tulajdonság használatával visszaadott oszlopok számát.

retrieveRow módszer

A megadott beállításokkal lekéri a sort a megadott táblából.

Parameters

Adja meg ezeknek a szükséges paramétereknek az értékeit.

Name Típus Description
tableName string A lekérni kívánt tábla logikai neve
options RetrieveRowOptions A sor beolvasásának lehetőségei

RetrieveRowOptions

Name Típus Description
id string A lekérendő sor azonosítója (Guid)
select string[] (Ajánlott) A lekérendő oszlopnevek tömbje. Ha nincs megadva, a rendszer az összes oszlopot visszaadja.

Returns

A művelet eredményét tartalmazó ígéret . Ha a művelet sikeres, egy objektumot ad vissza a rekordadatokkal, beleértve az összes kijelölt oszlopot is.

retrieveRow példa

// 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 módszer

Frissíti a megadott tábla egy meglévő sorát.

Parameters

Adja meg ezeknek a szükséges paramétereknek az értékeit.

Name Típus Description
tableName karakterlánc A tábla logikai neve a sor frissítéséhez.
rowId karakterlánc A frissíteni kívánt sor azonosítója.
row Object A frissíteni kívánt soradatok.

Returns

A művelet eredményét tartalmazó ígéret . Ha a művelet sikeres, nem ad vissza értéket.

updateRow példa

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