إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
عند إنشاء صفحة باستخدام اللغة الطبيعية، يقوم الذكاء الاصطناعي بإنشاء صفحة React في TypeScript. تغطي الصفحة التي تم إنشاؤها تجربة المستخدم الأمامية عن طريق تحديد المكونات الصحيحة وتحديد أفضل تخطيط ومنطق العمل المقابل.
يمكنك عرض التعليمات البرمجية التي تم إنشاؤها وتحريرها لتحسين الإخراج. تستخدم عمليات البيانات كائنا dataApi يعرض الأساليب العامة التالية:
| Method | الوصف |
|---|---|
createRow |
إنشاء صف جديد في الجدول المحدد. |
updateRow |
تحديث صف موجود في الجدول المحدد. |
deleteRow |
حذف صف من الجدول المحدد. |
retrieveRow |
استرداد صف من الجدول المحدد بالخيارات المحددة. |
queryTable |
الاستعلام عن جدول بالخيارات المحددة. |
getChoices |
استرداد الخيارات لاسم عمود الاختيار المحدد. |
طريقة createRow
إنشاء صف جديد في الجدول المحدد.
المعلمات
تعيين قيم لهذه المعلمات المطلوبة.
| الاسم | نوع | الوصف |
|---|---|---|
tableName |
خيط | الاسم المنطقي للجدول لإنشاء الصف فيه. |
row |
كائن | بيانات الصف المراد إنشاؤها. |
مرتجعات
وعد يحتوي على نتيجة العملية. عند نجاح العملية، تكون النتيجة هي قيمة المعرف (Guid) للصف الذي تم إنشاؤه.
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
تحديث صف موجود في الجدول المحدد.
المعلمات
تعيين قيم لهذه المعلمات المطلوبة.
| الاسم | نوع | الوصف |
|---|---|---|
tableName |
خيط | الاسم المنطقي للجدول لتحديث الصف فيه. |
rowId |
خيط | معرف الصف المراد تحديثه. |
row |
الكائن | بيانات الصف المراد تحديثها. |
مرتجعات
وعد يحتوي على نتيجة العملية. عند نجاح العملية، لا ترجع أي قيمة.
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
حذف صف من الجدول المحدد.
المعلمات
تعيين قيم لهذه المعلمات المطلوبة.
| الاسم | نوع | الوصف |
|---|---|---|
tableName |
خيط | الاسم المنطقي للجدول لحذف الصف فيه. |
rowId |
خيط | معرف الصف المراد حذفه. |
مرتجعات
وعد يحتوي على نتيجة العملية. عند نجاح العملية، لا ترجع أي قيمة.
Example
let rowId = "5531d753-95af-e711-a94e-000d3a11e605";
try {
await dataApi.deleteRow("account", rowId);
}
catch (error) {
console.log(error.message);
}
طريقة retrieveRow
استرداد صف من الجدول المحدد باستخدام الخيارات المحددة.
المعلمات
تعيين قيم لهذه المعلمات المطلوبة.
| الاسم | نوع | الوصف |
|---|---|---|
tableName |
string |
الاسم المنطقي للجدول المراد استرداده منه |
options |
استرداد عمليات الاسترداد | خيارات استرداد الصف |
استرداد عمليات الاسترداد
| الاسم | نوع | الوصف |
|---|---|---|
id |
string |
معرف (Guid) للصف المراد استرداده |
select |
string[] |
(مستحسن) صفيف أسماء الأعمدة المراد استردادها. إذا تم حذفها، يتم إرجاع كافة الأعمدة. |
مرتجعات
وعد يحتوي على نتيجة العملية. عند نجاح العملية، يتم إرجاع كائن يحتوي على بيانات السجل، بما في ذلك كافة الأعمدة المحددة.
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
الاستعلام عن جدول باستخدام الخيارات المحددة.
المعلمات
تعيين قيم لهذه المعلمات المطلوبة.
| الاسم | نوع | الوصف |
|---|---|---|
tableName |
string |
الاسم المنطقي للجدول للاستعلام |
query |
QueryTableOptions | خيارات للاستعلام عن الجدول |
QueryTableOptions
| الاسم | نوع | الوصف |
|---|---|---|
select |
string[] |
(مستحسن) صفيف أسماء الأعمدة المراد استردادها. |
filter |
string |
(اختياري) تعبير عامل تصفية OData (على سبيل المثال، statecode eq 0). |
orderBy |
string |
(اختياري) تعبير OData orderby (على سبيل المثال، name asc، ). createdon desc |
pageSize |
number |
(اختياري) الحد الأقصى لعدد الصفوف التي يتم إرجاعها لكل صفحة. |
مرتجعات
وعد يحتوي على نتيجة العملية. عند نجاح العملية، يقوم الوعد بإرجاع كائن يحتوي على جدول بيانات مع النتائج مع هذه الخصائص:
| الاسم | نوع | الوصف |
|---|---|---|
rows |
Object[] |
صفيف بيانات الصف |
hasMoreRows |
boolean |
يشير إلى ما إذا كان هناك المزيد من الصفوف المتوفرة |
loadMoreRows |
function |
دالة لتحميل الصفحة التالية من النتائج. (اختياري) |
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`);
}
ملاحظات
ملاحظة
للحصول على أفضل أداء، حدد دائما عدد الأعمدة التي يتم إرجاعها باستخدام الخاصية QueryTableOptionsselect .
طريقة getChoices
استرداد الخيارات لاسم عمود الاختيار المحدد.
المعلمات
هذه المعلمة مطلوبة.
| الاسم | نوع | الوصف |
|---|---|---|
enumName |
string |
اسم عمود الاختيار بالتنسيق tablename-columnname |
مرتجعات
وعد يحتوي على نتيجة العملية. عند نجاح العملية، تقوم بإرجاع صفيف من خيارات الاختيار. يحتوي كل خيار على هذه الخصائص:
| الاسم | نوع | الوصف |
|---|---|---|
label |
خيط | قيمة التسمية المترجمة للخيار. |
value |
number | القيمة الرقمية للخيار. |
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');