تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class DataSourceFormula

الوصول إلى صيغ مصدر البيانات الحالية وتعديلها. لإنشاء صيغة مصدر بيانات جديدة، استخدِم Range.setFormula(formula).

لا تستخدم هذه الفئة إلا مع البيانات التي ترتبط بقاعدة بيانات.

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`forceRefreshData()`	`DataSourceFormula`	إعادة تحميل بيانات هذا العنصر بغض النظر عن الحالة الحالية.
`getAnchorCell()`	`Range`	تعرض `Range` الخلية التي يتم فيها إرساء صيغة مصدر البيانات هذه.
`getDataSource()`	`DataSource`	الحصول على مصدر البيانات المرتبط به العنصر.
`getDisplayValue()`	`String`	تعرِض القيمة المعروضة لصيغة مصدر البيانات.
`getFormula()`	`String`	تعرِض صيغة صيغة مصدر البيانات هذه.
`getStatus()`	`DataExecutionStatus`	تحصل على حالة تنفيذ البيانات للعنصر.
`refreshData()`	`DataSourceFormula`	لإعادة تحميل بيانات العنصر.
`setFormula(formula)`	`DataSourceFormula`	يعدّل الصيغة.
`waitForCompletion(timeoutInSeconds)`	`DataExecutionStatus`	الانتظار حتى اكتمال عملية التنفيذ الحالية، وستنتهي المهلة بعد عدد الثواني المقدَّم.

المستندات التفصيلية

`forceRefreshData()`

إعادة تحميل بيانات هذا العنصر بغض النظر عن الحالة الحالية. لمزيد من التفاصيل، يمكنك الاطّلاع على refreshData().

عرض استثناء إذا لم يتم تفعيل نوع مصدر البيانات. استخدِم طرق SpreadsheetApp#enable...Execution() لتفعيل تنفيذ البيانات لنوع مصدر بيانات معيّن.

تذكرة ذهاب وعودة

DataSourceFormula — كائن البيانات.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getAnchorCell()`

تعرض Range الخلية التي يتم فيها إرساء صيغة مصدر البيانات هذه.

تذكرة ذهاب وعودة

Range — خلية الارتساء.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSource()`

الحصول على مصدر البيانات المرتبط به العنصر.

تذكرة ذهاب وعودة

DataSource — مصدر البيانات

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDisplayValue()`

تعرِض القيمة المعروضة لصيغة مصدر البيانات.

تذكرة ذهاب وعودة

String — قيمة العرض.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFormula()`

تعرِض صيغة صيغة مصدر البيانات هذه.

تذكرة ذهاب وعودة

String — الصيغة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getStatus()`

تحصل على حالة تنفيذ البيانات للعنصر.

تذكرة ذهاب وعودة

DataExecutionStatus - حالة تنفيذ البيانات.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`refreshData()`

لإعادة تحميل بيانات العنصر.

عرض استثناء إذا كان حاليًا في حالة error استخدِم DataSource#updateSpec() لتعديل المواصفات. ننصحك باستخدام الطريقة بدلاً من forceRefreshData() لمنع إجراء تعديلات غير متوقّعة على مصدر البيانات.

تذكرة ذهاب وعودة

DataSourceFormula — كائن البيانات.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFormula(formula)`

يعدّل الصيغة.

المَعلمات

الاسم	النوع	الوصف
`formula`	`String`	الصيغة الجديدة.

تذكرة ذهاب وعودة

DataSourceFormula - صيغة مصدر البيانات، للسلسلة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`waitForCompletion(timeoutInSeconds)`

الانتظار حتى اكتمال عملية التنفيذ الحالية، وستنتهي المهلة بعد عدد الثواني المقدَّم. عرض استثناء في حال عدم اكتمال التنفيذ عند انتهاء المهلة، مع عدم إلغاء تنفيذ البيانات

المَعلمات

الاسم	النوع	الوصف
`timeoutInSeconds`	`Integer`	وقت الانتظار لتنفيذ البيانات، بالثواني الحد الأقصى هو 300 ثانية.

تذكرة ذهاب وعودة

DataExecutionStatus - حالة تنفيذ البيانات.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets