oluşturan sayfalar için dataApi başvurusu

Doğal dil kullanarak bir sayfa oluşturduğunuzda, yapay zeka TypeScript'te bir React sayfası oluşturur. Oluşturulan sayfa, doğru bileşenleri seçip en iyi düzeni ve buna karşılık gelen iş mantığını belirleyerek hem ön uç kullanıcı deneyimini kapsar.

Çıktıyı daraltmak için oluşturulan kodu görüntüleyebilir ve düzenleyebilirsiniz. Veri işlemleri aşağıdaki genel yöntemleri kullanıma sunan bir dataApi nesne kullanır:

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

createRow yöntemi

Belirtilen tabloda yeni bir satır oluşturur.

Parametreler

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

İsim	Türü	Description
tableName	String	Satırın oluşturulacağı tablonun mantıksal adı.
row	object	Oluşturulacak satır verileri.

İade

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

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

updateRow yöntemi

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

Parametreler

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

İsim	Türü	Description
tableName	String	satırı güncelleştirilecek tablonun mantıksal adı.
rowId	String	Güncelleştirilecek satırın kimliği.
row	Nesne	Güncelleştirilecek satır verileri.

İade

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

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

deleteRow yöntemi

Belirtilen tablodan bir satırı siler.

Parametreler

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

İsim	Türü	Description
tableName	String	Satırın silineceği tablonun mantıksal adı.
rowId	String	Silinecek satırın kimliği.

İade

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

Example

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

retrieveRow yöntemi

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

Parametreler

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

İsim	Türü	Description
tableName	string	Alınacak tablonun mantıksal adı
options	RetrieveRowOptions	Satırı alma seçenekleri

RetrieveRowOptions

İsim	Türü	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.

İade

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

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'],
});

queryTable yöntemi

Belirtilen seçenekleri kullanarak bir tabloyu sorgular.

Parametreler

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

İsim	Türü	Description
tableName	string	Sorguya almak istediğiniz tablonun mantıksal adı
query	QueryTableOptions	Tabloyu sorgulama seçenekleri

QueryTableOptions

İsim	Türü	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ı.

İade

İş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:

İsim	Türü	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ı)

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

Açıklamalar

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.

getChoices yöntemi

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

Parametreler

Bu parametre gereklidir.

İsim	Türü	Description
enumName	string	Biçimdeki seçim sütununun adı tablename-columnname

İade

İş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:

İsim	Türü	Description
label	String	Seçeneğin yerelleştirilmiş etiket değeri.
value	Numara	Seçeneğinin sayısal değeri.

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