जनरेटिव पृष्ठों के लिए डेटावर्स तालिका विधियाँ

Dataverse तालिका पंक्तियों और क्वेरी विकल्प स्तंभ बनाने, पुनर्प्राप्त करने, अद्यतन करने और हटाने के लिए ऑब्जेक्ट की तालिका dataApi विधियों का उपयोग करें.

विधि	विवरण
createRow	निर्दिष्ट तालिका में एक नई पंक्ति बनाता है.
deleteRow	निर्दिष्ट तालिका से कोई पंक्ति हटाता है.
getChoices	निर्दिष्ट विकल्प स्तंभ नाम के लिए विकल्प पुनर्प्राप्त करता है.
queryTable	निर्दिष्ट विकल्पों के साथ एक तालिका क्वेरी करता है।
retrieveRow	निर्दिष्ट विकल्पों के साथ निर्दिष्ट तालिका से एक पंक्ति पुनर्प्राप्त करता है।
updateRow	निर्दिष्ट तालिका में किसी मौजूदा पंक्ति को अद्यतन करता है.

createRow विधि

निर्दिष्ट तालिका में एक नई पंक्ति बनाता है.

पैरामीटर

इन आवश्यक मापदंडों के लिए मान सेट करें.

नाम	प्रकार	विवरण
tableName	स्ट्रिंग	पंक्ति बनाने के लिए तालिका का तार्किक नाम.
row	वस्तु	बनाने के लिए पंक्ति डेटा.

वापस

ऑपरेशन के परिणाम वाला एक वादा। जब कार्रवाई सफल होती है, तो परिणाम बनाई गई पंक्ति का ID (Guid) मान होता है।

createRow उदाहरण

// 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 विधि

निर्दिष्ट तालिका से कोई पंक्ति हटाता है.

पैरामीटर

इन आवश्यक मापदंडों के लिए मान सेट करें.

नाम	प्रकार	विवरण
tableName	स्ट्रिंग	पंक्ति को हटाने के लिए तालिका का तार्किक नाम.
rowId	स्ट्रिंग	हटाने के लिए पंक्ति की आईडी.

वापस

ऑपरेशन के परिणाम वाला एक वादा। जब ऑपरेशन सफल होता है, तो यह कोई मान नहीं देता है।

deleteRow उदाहरण

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

getChoices विधि

निर्दिष्ट विकल्प स्तंभ नाम के लिए विकल्प पुनर्प्राप्त करता है.

पैरामीटर

यह पैरामीटर आवश्यक है।

नाम	प्रकार	विवरण
enumName	string	प्रारूप में पसंद स्तंभ का नाम tablename-columnname

वापस

ऑपरेशन के परिणाम वाला एक वादा। जब ऑपरेशन सफल होता है, तो यह पसंद विकल्पों की एक सरणी लौटाता है। प्रत्येक विकल्प में ये गुण होते हैं:

नाम	प्रकार	विवरण
label	स्ट्रिंग	विकल्प का स्थानीयकृत लेबल मान.
value	संख्या	विकल्प का संख्यात्मक मान।

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 विधि

निर्दिष्ट विकल्पों का उपयोग करके किसी तालिका को क्वेरी करता है.

पैरामीटर

इन आवश्यक मापदंडों के लिए मान सेट करें.

नाम	प्रकार	विवरण
tableName	string	क्वेरी करने के लिए तालिका का तार्किक नाम
query	QueryTableOptions	तालिका को क्वेरी करने के लिए विकल्प

QueryTableOptions

नाम	प्रकार	विवरण
select	string[]	(सिफारिश की) पुनः प्राप्त करने के लिए स्तंभ नामों की सरणी।
filter	string	(वैकल्पिक) OData फ़िल्टर व्यंजक (उदाहरण के लिए, ). statecode eq 0
orderBy	string	(वैकल्पिक) OData orderव्यंजक द्वारा (उदाहरण के लिए, name asc, )। createdon desc
pageSize	number	(वैकल्पिक) प्रति पृष्ठ लौटने के लिए पंक्तियों की अधिकतम संख्या।

वापस

ऑपरेशन के परिणाम वाला एक वादा। जब ऑपरेशन सफल होता है, तो वादा इन गुणों के परिणामों के साथ डेटा तालिका वाली ऑब्जेक्ट लौटाता है:

नाम	प्रकार	विवरण
rows	Object[]	पंक्ति डेटा की सरणी
hasMoreRows	boolean	इंगित करता है कि क्या अधिक पंक्तियाँ उपलब्ध हैं
loadMoreRows	function	परिणामों के अगले पृष्ठ को लोड करने के लिए फ़ंक्शन। (वैकल्पिक)

queryTable उदाहरण

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

टिप्पणी

नोट

श्रेष्ठ प्रदर्शन के लिए, हमेशा QueryTableOptionsselect गुण का उपयोग करके लौटाए गए स्तंभों की संख्या सीमित करें।

retrieveRow विधि

निर्दिष्ट विकल्पों का उपयोग करके निर्दिष्ट तालिका से कोई पंक्ति पुनर्प्राप्त करता है.

पैरामीटर

इन आवश्यक मापदंडों के लिए मान सेट करें.

नाम	प्रकार	विवरण
tableName	string	से पुनर्प्राप्त करने के लिए तालिका का तार्किक नाम
options	RetrieveRowOptions	पंक्ति को पुनः प्राप्त करने के विकल्प

RetrieveRowOptions

नाम	प्रकार	विवरण
id	string	पुनर्प्राप्त करने के लिए पंक्ति की ID (Guid)
select	string[]	(सिफारिश की) पुनः प्राप्त करने के लिए स्तंभ नामों की सरणी। यदि छोड़ा गया है, तो सभी कॉलम वापस कर दिए जाते हैं।

वापस

ऑपरेशन के परिणाम वाला एक वादा। जब ऑपरेशन सफल होता है, तो यह सभी चयनित कॉलम सहित रिकॉर्ड डेटा के साथ एक ऑब्जेक्ट लौटाता है।

retrieveRow उदाहरण

// 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 विधि

निर्दिष्ट तालिका में किसी मौजूदा पंक्ति को अद्यतन करता है.

पैरामीटर

इन आवश्यक मापदंडों के लिए मान सेट करें.

नाम	प्रकार	विवरण
tableName	स्ट्रिंग	पंक्ति को अद्यतन करने के लिए तालिका का तार्किक नाम.
rowId	स्ट्रिंग	अद्यतन करने के लिए पंक्ति की आईडी.
row	ऑब्जेक्ट	अद्यतन करने के लिए पंक्ति डेटा.

वापस

ऑपरेशन के परिणाम वाला एक वादा। जब ऑपरेशन सफल होता है, तो यह कोई मान नहीं देता है।

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