حقل البحث ليس نوعًا محددًا من الحقول. يمكننا البحث عن أي نوع من الحقول في قاعدة بيانات مرتبطة. يتحدد نوع حقل البحث وفقًا للحقل الأصلي في قاعدة البيانات المرتبطة، وتكون لديه الخاصية isLookup. لا يمكن تحرير حقول البحث.
قد تحمل جميع قيم الإرجاع للحقول القيمة
isMultipleCellValue: true في حالات معينة:- يحدث ذلك عندما يكون الحقل حقل بحث. وعندما تسمح القيمة المرتبطة بتحديد خيارات متعددة، تكون قيمة حقل البحث مصفوفة بالضرورة.
-
يمكن تهيئة الحقول؛ فعلى سبيل المثال، يمكن تهيئة حقول المستخدم وحقول الارتباط لتحديد خيار واحد أو خيارات متعددة. يمكنك استخدام
field.isMultipleCellValueفي شيفرتك لتحديد ما إذا كان الحقل يقبل قيمًا متعددة.
لا تستخدم نوع الحقل لتحديد أذونات الكتابة. استخدم بدلاً من ذلك الخاصية isComputed للحقل.
1. حقل الأرقام
- النوع: number
- نوع الكتابة:
number - نوع الإرجاع:
isMultipleCellValue: false:numberisMultipleCellValue: true:number[]
2. حقل النص أحادي السطر
- النوع: singleLineText
- نوع الكتابة:
string - نوع الإرجاع:
isMultipleCellValue: false:stringisMultipleCellValue: true:string[]
3. حقل النص الطويل
- النوع: longText
- نوع الكتابة:
string - نوع الإرجاع:
isMultipleCellValue: false:stringisMultipleCellValue: true:string[]
4. حقل التحديد الأحادي
- النوع: singleSelect
- نوع الكتابة:
string(قيمة الخيار) - نوع الإرجاع:
isMultipleCellValue: false:stringisMultipleCellValue: true:string[]
5. حقل التحديد المتعدد
- النوع: multipleSelect
- نوع الكتابة:
string[](مصفوفة قيم الخيارات) - نوع الإرجاع:
string[]
6. حقل الارتباط
- النوع: link
- نوع الكتابة:
isMultipleCellValue: false:{ id: string }isMultipleCellValue: true:{ id: string }[]
- نوع الإرجاع:
isMultipleCellValue: false:{ id: string, title?: string }isMultipleCellValue: true:{ id: string, title?: string }[]
7. حقل الصيغة
- النوع: formula
- نوع الكتابة: لا يمكن الكتابة فيه مباشرةً
- نوع الإرجاع: يعتمد على نتيجة الصيغة، ويمكن أن يكون
string | number | booleanأو مصفوفة من أحد هذه الأنواع
8. حقل المرفقات
لرفع مرفق إلى حقل مرفقات، استخدم واجهة API المخصصة لذلك. للاطلاع على التفاصيل، راجع قسم رفع مرفق.- النوع: attachment
-
نوع الكتابة:
- نوع الإرجاع:
9. حقل التاريخ
- النوع: date
- نوع الكتابة:
string(بتنسيق ISO 8601) - نوع الإرجاع:
isMultipleCellValue: false:string(بتنسيق ISO 8601)isMultipleCellValue: true:string[](بتنسيق ISO 8601) يمكنك استخدامnew Date().toISOString()للحصول على تنسيق الوقت ISO 8601
10. حقل وقت الإنشاء
- النوع: createdTime
- نوع الكتابة: لا يمكن الكتابة فيه مباشرةً
- نوع الإرجاع:
isMultipleCellValue: false:string(بتنسيق ISO 8601)isMultipleCellValue: true:string[](بتنسيق ISO 8601)
11. حقل وقت آخر تعديل
- النوع: lastModifiedTime
- نوع الكتابة: لا يمكن الكتابة فيه مباشرةً
- نوع الإرجاع:
isMultipleCellValue: false:string(بتنسيق ISO 8601)isMultipleCellValue: true:string[](بتنسيق ISO 8601)
12. حقل مربع الاختيار
- النوع: checkbox
- نوع الكتابة:
boolean - نوع الإرجاع:
isMultipleCellValue: false:booleanisMultipleCellValue: true:boolean[]
13. حقل التجميع
- النوع: rollup
- نوع الكتابة: لا يمكن الكتابة فيه مباشرةً
- نوع الإرجاع: يعتمد على تهيئة التجميع، ويمكن أن يكون
number | stringأو مصفوفة من أحد هذين النوعين
14. حقل التقييم
- النوع: rating
- نوع الكتابة:
number - نوع الإرجاع:
isMultipleCellValue: false:numberisMultipleCellValue: true:number[]
15. حقل الترقيم التلقائي
- النوع: autoNumber
- نوع الكتابة: لا يمكن الكتابة فيه مباشرةً
- نوع الإرجاع:
isMultipleCellValue: false:numberisMultipleCellValue: true:number[]
16. حقل المستخدم
- النوع: user
- نوع الكتابة:
isMultipleCellValue: false:{ id: string, title: string }isMultipleCellValue: true:{ id: string, title: string }[]
- نوع الإرجاع:
isMultipleCellValue: false:{ id: string, title: string, email?: string, avatar?: string }isMultipleCellValue: true:{ id: string, title: string, email?: string, avatar?: string }[]
17. حقل المنشئ
- نوع الكتابة: لا يمكن الكتابة فيه مباشرةً
- نوع الإرجاع:
isMultipleCellValue: false:{ id: string, title: string, email?: string, avatar?: string }isMultipleCellValue: true:{ id: string, title: string, email?: string, avatar?: string }[]مثال:
18. حقل آخر من أجرى تعديلًا
- نوع الكتابة: لا يمكن الكتابة فيه مباشرةً
- نوع الإرجاع:
isMultipleCellValue: false:{ id: string, title: string, email?: string, avatar?: string }isMultipleCellValue: true:{ id: string, title: string, email?: string, avatar?: string }[]

