Üretken sayfalar için Dataverse tablo yöntemleri

Dataverse tablo satırlarını ve sorgu seçimi sütunlarını dataApi oluşturmak, almak, güncelleştirmek ve silmek için nesnesinin tablo yöntemlerini kullanın.

Method	Description
createRow	Belirtilen tabloda yeni bir satır oluşturur.
deleteRow	Belirtilen tablodan bir satırı siler.
getChoices	Belirtilen seçim sütun adı için seçimleri alır.
queryTable	Bir tabloyu belirtilen seçeneklerle sorgular.
retrieveRow	Belirtilen tablodan belirtilen seçenekleri içeren bir satır alır.
updateRow	Belirtilen tabloda var olan bir satırı güncelleştirir.

createRow yöntemi

Belirtilen tabloda yeni bir satır oluşturur.

Parameters

Bu gerekli parametreler için değerleri ayarlayın.

Name	Type	Description
tableName	string	Satırın oluşturulacağı tablonun mantıksal adı.
row	Obje	Oluşturulacak satır verileri.

Returns

İşlemin sonucunu içeren bir söz . İşlem başarılı olduğunda, sonuç oluşturulan satırın ID (Guid) değeridir.

createRow örneği

// 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 yöntemi

Belirtilen tablodan bir satırı siler.

Parameters

Bu gerekli parametreler için değerleri ayarlayın.

Name	Type	Description
tableName	string	Satırın silineceği tablonun mantıksal adı.
rowId	string	Silinecek satırın kimliği.

Returns

İşlemin sonucunu içeren bir söz . İşlem başarılı olduğunda değer döndürmez.

deleteRow örneği

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

getChoices yöntemi

Belirtilen seçim sütun adı için seçimleri alır.

Parameters

Bu parametre gereklidir.

Name	Type	Description
enumName	string	Biçimdeki seçim sütununun adı tablename-columnname

Returns

İşlemin sonucunu içeren bir söz . İşlem başarılı olduğunda, seçim seçeneklerinden oluşan bir dizi döndürür. Her seçenek şu özelliklere sahiptir:

Name	Type	Description
label	string	Seçeneğin yerelleştirilmiş etiket değeri.
value	number	Seçeneğinin sayısal değeri.

getChoices örneği

// 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 yöntemi

Belirtilen seçenekleri kullanarak bir tabloyu sorgular.

Parameters

Bu gerekli parametreler için değerleri ayarlayın.

Name	Type	Description
tableName	string	Sorguya almak istediğiniz tablonun mantıksal adı
query	QueryTableOptions	Tabloyu sorgulama seçenekleri

QueryTableOptions

Name	Type	Description
select	string[]	(Önerilen) Alınacak sütun adları dizisi.
filter	string	(İsteğe bağlı) OData filtre ifadesi (örneğin, statecode eq 0).
orderBy	string	(İsteğe bağlı) OData orderby ifadesi (örneğin, name asc, createdon desc).
pageSize	number	(İsteğe bağlı) Sayfa başına döndürülecek en fazla satır sayısı.

Returns

İşlemin sonucunu içeren bir söz . İşlem başarılı olduğunda, promise şu özelliklere sahip sonuçları içeren bir veri tablosu içeren bir nesne döndürür:

Name	Type	Description
rows	Object[]	Satır verileri dizisi
hasMoreRows	boolean	Kullanılabilir daha fazla satır olup olmadığını gösterir
loadMoreRows	function	Sonuçların sonraki sayfasını yüklemek için işlev. (İsteğe bağlı)

queryTable örneği

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

Uyarı

En iyi performans için QueryTableOptions özelliğini kullanarak döndürülen sütun sayısını her zaman sınırlayınselect.

retrieveRow yöntemi

Belirtilen seçenekleri kullanarak belirtilen tablodan bir satır alır.

Parameters

Bu gerekli parametreler için değerleri ayarlayın.

Name	Type	Description
tableName	string	Alınacak tablonun mantıksal adı
options	RetrieveRowOptions	Satırı alma seçenekleri

RetrieveRowOptions

Name	Type	Description
id	string	Alınacak satırın kimliği (Guid)
select	string[]	(Önerilen) Alınacak sütun adları dizisi. Atlanırsa, tüm sütunlar döndürülür.

Returns

İşlemin sonucunu içeren bir söz . İşlem başarılı olduğunda, seçilen tüm sütunlar dahil olmak üzere kayıt verilerini içeren bir nesne döndürür.

retrieveRow örneği

// 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 yöntemi

Belirtilen tabloda var olan bir satırı güncelleştirir.

Parameters

Bu gerekli parametreler için değerleri ayarlayın.

Name	Type	Description
tableName	string	satırı güncelleştirilecek tablonun mantıksal adı.
rowId	string	Güncelleştirilecek satırın kimliği.
row	Object	Güncelleştirilecek satır verileri.

Returns

İşlemin sonucunu içeren bir söz . İşlem başarılı olduğunda değer döndürmez.

updateRow örneği

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