Skip to main content
حقل البحث ليس نوعًا محددًا من الحقول. يمكننا البحث عن أي نوع من الحقول في قاعدة بيانات مرتبطة. يتحدد نوع حقل البحث وفقًا للحقل الأصلي في قاعدة البيانات المرتبطة، وتكون لديه الخاصية isLookup. لا يمكن تحرير حقول البحث.
قد تحمل جميع قيم الإرجاع للحقول القيمة isMultipleCellValue: true في حالات معينة:
  1. يحدث ذلك عندما يكون الحقل حقل بحث. وعندما تسمح القيمة المرتبطة بتحديد خيارات متعددة، تكون قيمة حقل البحث مصفوفة بالضرورة.
  2. يمكن تهيئة الحقول؛ فعلى سبيل المثال، يمكن تهيئة حقول المستخدم وحقول الارتباط لتحديد خيار واحد أو خيارات متعددة. يمكنك استخدام field.isMultipleCellValue في شيفرتك لتحديد ما إذا كان الحقل يقبل قيمًا متعددة.
لا تستخدم نوع الحقل لتحديد أذونات الكتابة. استخدم بدلاً من ذلك الخاصية isComputed للحقل.

1. حقل الأرقام

  • النوع: number
  • نوع الكتابة: number
  • نوع الإرجاع:
    • isMultipleCellValue: false: number
    • isMultipleCellValue: true: number[]
مثال:

2. حقل النص أحادي السطر

  • النوع: singleLineText
  • نوع الكتابة: string
  • نوع الإرجاع:
    • isMultipleCellValue: false: string
    • isMultipleCellValue: true: string[]
مثال:

3. حقل النص الطويل

  • النوع: longText
  • نوع الكتابة: string
  • نوع الإرجاع:
    • isMultipleCellValue: false: string
    • isMultipleCellValue: true: string[]
مثال:

4. حقل التحديد الأحادي

  • النوع: singleSelect
  • نوع الكتابة: string (قيمة الخيار)
  • نوع الإرجاع:
    • isMultipleCellValue: false: string
    • isMultipleCellValue: 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: boolean
    • isMultipleCellValue: true: boolean[]
مثال:

13. حقل التجميع

  • النوع: rollup
  • نوع الكتابة: لا يمكن الكتابة فيه مباشرةً
  • نوع الإرجاع: يعتمد على تهيئة التجميع، ويمكن أن يكون number | string أو مصفوفة من أحد هذين النوعين
مثال:

14. حقل التقييم

  • النوع: rating
  • نوع الكتابة: number
  • نوع الإرجاع:
    • isMultipleCellValue: false: number
    • isMultipleCellValue: true: number[]
مثال:

15. حقل الترقيم التلقائي

  • النوع: autoNumber
  • نوع الكتابة: لا يمكن الكتابة فيه مباشرةً
  • نوع الإرجاع:
    • isMultipleCellValue: false: number
    • isMultipleCellValue: 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 }[]
مثال:
آخر تعديل في ٤ سبتمبر ٢٠٢٦