> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# تحديث سجل

> عدّل حقول سجل موجود ضمن سير عمل

<Tip>
  نوصي بشدة باستخدام «تشغيل برنامج نصي» لإنشاء عمليات الأتمتة، لأنه يستطيع تغطية جميع سلوكيات الإجراءات، بما فيها الإجراءات التي كان يلزم إنشاؤها يدويًا لولا ذلك. ما عليك سوى وصف متطلباتك للذكاء الاصطناعي في الدردشة.

  يُرجى ملاحظة أنه إذا أضفت إجراءات يدويًا، فلن يتعرف عليها الذكاء الاصطناعي أو يعدّلها لاحقًا.
</Tip>

## الإنشاء بالذكاء الاصطناعي

افتح دردشة الذكاء الاصطناعي في الشريط الجانبي الأيمن للجدول وصِف ما تريده.

يتولى الذكاء الاصطناعي كل شيء: يختار المشغّل المناسب، وينتقي الإجراءات الملائمة، ويربط الحقول، ويهيئ سير العمل بالكامل تلقائيًا.

صِف الهدف مرة واحدة، وسيصبح سير العمل جاهزًا دون الحاجة إلى إعداد يدوي.

يحدّث حقلًا واحدًا أو أكثر في سجل موجود. لن تتغير إلا الحقول التي تربطها، ويظل كل ما عداها كما هو.

## التهيئة

| الإعداد     | مطلوب | الوصف                                                                                        |
| ----------- | ----- | -------------------------------------------------------------------------------------------- |
| الجدول      | نعم   | الجدول الذي يحتوي على السجل المطلوب تحديثه                                                   |
| معرّف السجل | نعم   | السجل المطلوب تحديثه. يدعم المتغيرات الديناميكية والمعرّفات المفصولة بفواصل لتحديث عدة سجلات |
| الحقول      | نعم   | اربط كل حقل بقيمته الجديدة، سواء كانت ثابتة أو ديناميكية                                     |

## كيفية الإعداد

1. أضف إجراء **تحديث سجل** إلى سير العمل.
2. اختر **الجدول** الذي يحتوي على السجل المطلوب تعديله.
3. اضبط **معرّف السجل**. انقر على **+** لإدراج متغير ديناميكي:
   * من **مشغّل سجل** (إنشاء أو تحديث أو نقر زر): يوفر المشغّل معرّف السجل مباشرةً.
   * من إجراء **جلب السجلات**: أشر إلى معرّف السجل من النتائج المستردة.
   * يمكنك أيضًا كتابة معرّف سجل ثابت أو استخدام قائمة مفصولة بفواصل لتحديث عدة سجلات دفعة واحدة (مثل `rec123,rec456,rec789`).
4. اربط الحقول التي تريد تغييرها. لكل حقل:
   * **قيمة ثابتة:** اكتب القيمة الجديدة مباشرةً.
   * **قيمة ديناميكية:** انقر على **+** لإدراج قيمة من خطوة سابقة.
5. اترك الحقول التي لا تريد تغييرها دون ربط، وستحتفظ بقيمها الحالية.
6. احفظ الإجراء.

## كيفية الحصول على معرّف السجل

معرّف السجل هو المعلومة الأساسية التي يحتاج إليها هذا الإجراء. إليك موضع العثور عليه بحسب المشغّل:

| المشغّل / الخطوة السابقة | كيفية الحصول على معرّف السجل                                                 |
| ------------------------ | ---------------------------------------------------------------------------- |
| عند إنشاء سجل            | متاح مباشرةً بوصفه متغيرًا في مخرجات المشغّل                                 |
| عند تحديث سجل            | متاح مباشرةً بوصفه متغيرًا في مخرجات المشغّل                                 |
| عند نقر زر               | متاح مباشرةً — وهو الصف الذي نُقر فيه الزر                                   |
| عند إرسال نموذج          | متاح مباشرةً — وهو السجل الذي أنشأه الإرسال                                  |
| إجراء جلب السجلات        | لكل سجل في النتائج معرّف. أشر داخل الحلقة إلى معرّف العنصر الحالي            |
| عند استلام خطاف ويب      | يجب تضمين معرّف السجل في حمولة خطاف الويب، أو البحث عنه باستخدام جلب السجلات |

<Tip>هل تحتاج إلى تحديث عدة سجلات دفعة واحدة؟ يمكنك تمرير معرّفات سجلات مفصولة بفواصل، أو استخدام [الحلقة (دفعة)](../logic/loop-run) مع نتيجة جلب السجلات لتحديثها دفعة واحدة.</Tip>

## التحديثات الجزئية

ينفذ هذا الإجراء تحديثًا جزئيًا. وهذا يعني:

* تُستبدل **الحقول المرتبطة** بالقيم الجديدة التي تحددها.
* تظل **الحقول غير المرتبطة** كما هي تمامًا.

لا تحتاج إلى إعادة إرسال جميع قيم الحقول، بل القيم التي تريد تغييرها فقط. وهذا آمن وفعّال.

## تحذير: حلقات المشغّل

<Warning>إذا كان سير العمل يستخدم مشغّل "عند تحديث سجل" وكانت خطوة لاحقة تحدّث الحقول المراقبة نفسها في الجدول نفسه، فسيُشغّل سير العمل مجددًا، مما ينشئ حلقة لا نهائية.</Warning>

إذا كانت الأتمتة تُشغّل بواسطة **عند تحديث سجل** وكان إجراء تحديث السجل يكتب إلى **الجدول نفسه**، فقد تنشئ حلقة لا نهائية:

1. يتغير السجل ← يعمل المشغّل ← تحدّث الأتمتة السجل ← يعمل المشغّل مجددًا ← وهكذا.

**كيفية منع الحلقات:**

* **راقب حقولًا محددة** في المشغّل *تختلف* عن الحقول التي تحدّثها. على سبيل المثال، راقب "الحالة" لكن حدّث "تاريخ المعالجة".
* **أضف عامل تصفية** إلى المشغّل. على سبيل المثال، شغّله فقط عندما لا تساوي قيمة `تمت المعالجة` القيمة `true`، واضبط `تمت المعالجة` على `true` في الإجراء.
* فكّر في استخدام [عند مطابقة السجل للشروط](/ar/basic/automation/trigger/records/record-matches-conditions) بدلًا منه، إذ لا يعمل إلا عند انتقالات الحالة.

## حالات الاستخدام

* **تمييز مهمة بأنها مكتملة بعد الموافقة.** عند نقر زر، اضبط الحالة على "موافق عليه" واملأ تاريخ الموافقة.
* **تحديث حقل حالة استنادًا إلى أحداث خارجية.** عندما يبلغ خطاف ويب عن دفعة، ابحث عن سجل الطلب وحدّث حالته إلى "مدفوع".
* **كتابة طابع زمني عند حدوث تغيير.** عند تحديث سجل، اضبط حقل تاريخ "آخر تعديل بواسطة الأتمتة" على الوقت الحالي.
* **مزامنة البيانات العائدة من نظام خارجي.** بعد استدعاء واجهة API خارجية، اكتب بيانات الاستجابة (مثل رقم تتبع) في السجل.
* **تحديث سجلات دفعة واحدة.** ادمج جلب السجلات مع الحلقة لتحديث عدة سجلات دفعة واحدة، مثل تمييز جميع المهام المتأخرة بأنها "مصعّدة".

## نصائح

* قد يؤدي تحديث سجل إلى تشغيل عمليات أتمتة أخرى تراقب الجدول نفسه. انتبه إلى التأثيرات المتسلسلة.
* عند تحديث عدة سجلات بمعرّفات مفصولة بفواصل، تتلقى جميع السجلات قيم الحقول نفسها. استخدم خطوة [حلقة](../logic/loop-run) بدلًا من ذلك إذا كانت لكل سجل قيم مختلفة.
* إذا أردت مسح حقل، فاربطه بقيمة فارغة. أما تركه دون ربط فلن يمسحه.
* استخدم [الوصول عبر قواعد البيانات](/ar/basic/automation/actions/records/cross-base) لتحديث سجلات في جدول موجود بقاعدة بيانات مختلفة.

## موضوعات ذات صلة

* [إنشاء سجل](/ar/basic/automation/actions/records/create-record) — إضافة سجلات جديدة بدلًا من تعديل الموجودة
* [جلب السجلات](/ar/basic/automation/actions/records/get-records) — استرداد السجلات للعثور على معرّفاتها قبل التحديث
* [الوصول عبر قواعد البيانات](/ar/basic/automation/actions/records/cross-base) — تحديث سجلات في جداول خارج قاعدة البيانات الحالية
* [الحلقة (دفعة)](../logic/loop-run) — تحديث عدة سجلات بقيم مختلفة