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

# اتصالات الأتمتة

> اختر واحكم اتصال KayanOS على مستوى المؤسسة المطلوب لكل أتمتة صادرة قبل ضبط المشغلات أو الإجراءات.

## اتصال KayanOS مطلوب أولاً

يتطلب كل مشغّل وإجراء صادر في أتمتة KayanOS **اتصال KayanOS** مختاراً. وهو حد تفويض على مستوى المؤسسة للأتمتة، لا مجرد خانة لبيانات اعتماد خارجية. اختره قبل اختيار مشغّل أو ربط حقول أو اختبار إجراء.

قد لا تحتاج نتيجة داخلية—مثل إنشاء سجل KayanOS أو بدء مهمة أو تصيير مستند أو إرجاع استجابة لوحة أو إرسال إشعار KayanOS داخلي—إلى حساب خارجي. لكنها ما زالت تحتاج اتصال KayanOS المختار للمسار. أضف تفويضاً خارجياً فقط عندما تعبر نتيجة الخدمة المعتمدة فعلاً إلى نظام خارجي.

لذلك السؤال العملي ذو جزأين:

1. ما اتصال KayanOS المعتمد الذي يفوض هذه الأتمتة داخل المؤسسة؟
2. هل تحتاج هذه النتيجة المحددة أيضاً إلى نظام/حساب خارجي، وما أصغر تفويض إضافي معتمد إن لزم؟

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

## نموذج ملكية الاتصال

يحتاج كل اتصال إلى مالك مؤسسي مسؤول. يجب ألا يعتمد أبداً على حساب شخصي لموظف واحد أو بيانات اعتماد غير موثقة.

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

## وافق على الاتصال قبل البناء به

1. **حدد النتيجة.** صف ما يجب على الأتمتة تحقيقه، واذكر هل تبقى داخل KayanOS أو تحتاج أيضاً إلى نظام خارجي معتمد.
2. **ارسم حقول البيانات.** اذكر القيم الدقيقة التي تعبر الحد. استبعد بيانات المواطنين أو الموظفين أو المرفقات أو الملاحظات الداخلية إلا إذا كانت مشاركتها معتمدة صراحةً.
3. **اختر أقل صلاحية.** اطلب فقط نطاق المؤسسة أو المشروع أو الخدمة أو الجدول أو نقطة النهاية اللازمة. فضّل القراءة على الكتابة حيث أمكن.
4. **عيّن المالكين.** سجل مالك العمل والمالك التقني ومالك تدوير بيانات الاعتماد قبل التفويض.
5. **خطط للإلغاء.** اعرف كيف سيعطل الاتصال وكيف تتصرف الأتمتة بعد ذلك.
6. **استخدم مساراً غير إنتاجي.** تحقّق منه بسجلات ومستلمين غير إنتاجيين معتمدين قبل لمس نطاق خدمة إنتاجي.
7. **وثق المراجعة.** احتفظ بالغرض والنطاق وأدلة الاختبار وتاريخ الانتهاء أو المراجعة مع سجل تشغيل الأتمتة.

## الضبط الآمن في KayanOS

عند إنشاء اتصال أو اختياره في محرر الأتمتة:

* اختر الاتصال المملوك للمؤسسة والمتوافق مع الغرض المعتمد؛ ولا تنشئ نسخة شخصية مكررة.
* أكد التسمية والمالك والصلاحية الحالية والنطاق المسموح قبل ربط الحقول. أعد الاتصال/التفويض عبر مسار المالك المعتمد عندما يبلغ المحرر أن الاتصال لم يعد صالحاً.
* اربط فقط القيم المعتمدة لهذا الاتصال. تجنب تمرير سجل كامل عندما تحتاج الوجهة إلى معرّف أو حالة واحدة.
* أبق إجراءات الكتابة خلف الشروط الصريحة نفسها التي ستستخدمها لإجراء KayanOS مدمج.
* تأكد من أن فشل الاتصال ينشئ نتيجة داخلية قابلة للمراجعة بدلاً من إسقاط طلب الخدمة بصمت.

## خطة اختبار لمسار يعتمد على اتصال

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

## شخّص اتصالاً قبل تغيير المسار

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

## حواجز الحماية

* لا تلصق أبداً أسراراً أو رموز وصول أو مفاتيح خاصة أو بيانات اعتماد اتصال في تعبير أو حقل سجل أو ملاحظة مهمة أو قالب مستند أو لقطة شاشة.
* لا تستخدم اتصالاً لتجاوز صلاحيات KayanOS أو موافقة بشرية مطلوبة.
* لا تمكّن كتابات خارجية واسعة أثناء الاختبار الأولي.
* أعد مراجعة الاتصال عند تغير مالكه أو نطاقه أو نقطة نهايته أو تصنيف بياناته أو غرض خدمته.

<Info>قد لا تحتاج نتائج السجل أو النموذج أو المهمة أو المستند أو استجابة اللوحة أو الإشعار الداخلية إلى حساب خارجي، لكن كل أتمتة KayanOS صادرة تبدأ باتصال KayanOS المختار.</Info>

![محدد اتصال أتمتة KayanOS لاتصال معتمد ومملوك للمؤسسة.](https://kayanos.app/docs-images/ar/build/automations-connections.png)

## متابعة البناء

* اختر حدثاً في [مشغلات أتمتة KayanOS](/ar/build/automations-triggers).
* اربط النتيجة في [إجراءات أتمتة KayanOS](/ar/build/automations-actions).
* راجع [الصلاحيات والإتاحة](/ar/reference/permissions-and-availability) قبل تفويض أي نطاق اتصال أو توسيعه.