> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ترحيل أسماء المستخدمين

## ترحيل أسماء المستخدمين

من منظور تسجيل الدخول، المعرّف الأساسي للمستخدم هو عنوان بريده الإلكتروني. إذا كنت تنتقل من المصادقة المحلية إلى SSO، أو تنتقل من مزوّد هوية (IdP) إلى آخر، فقد يلزمك تحديث عناوين البريد الإلكتروني للمستخدمين.

للمساعدة في ذلك، يتوفر سكربت يرحّل عناوين البريد الإلكتروني للمستخدمين باستخدام ملف CSV بالصيغة التالية:

`oldEmail,newEmail`

بعد إجراء بعض عمليات التحقق، سيمرّ السكربت على ملف CSV ويحدّث عناوين البريد الإلكتروني للمستخدمين من `oldEmail` إلى `newEmail`.

### **التحقق**

قبل تشغيل الترحيل، سيتم فحص `<csv_file>` للتأكد مما يلي:

* في كل صف، يكون كل من `oldEmail` و`newEmail` عنوان بريد إلكتروني صالحًا
* لا توجد إدخالات مكررة، على سبيل المثال، ألا تحاول تحديث مستخدمين مختلفين إلى عنوان البريد الإلكتروني الجديد نفسه، أو تحديث حساب المستخدم نفسه بعنوان بريد إلكتروني مستخدم مسبقًا

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

```bash wrap theme={null}
docker cp <csv_file> sharelatex:/overleaf/services/web/<csv_file> docker exec sharelatex /bin/bash -c "cd /overleaf/services/web;node ./modules/server-ce-scripts/scripts/migrate-user-emails.js [--commit] [--continue|--ignore-missing] [--admin-id=ADMIN_USER_ID] <csv_file>"
```

### **الخيارات**

| الاسم | الوصف |
| - | - |
| `--commit` | <p>يؤدي تضمين الخيار `--commit` إلى تنفيذ الترحيل فعليًا. عند حذفه، يتم الترحيل في وضع التشغيل التجريبي (dry-run) حيث لا تُجرى أي تغييرات، لكن عمليات التحقق تظل تُنفَّذ.<br /><br /><strong>الافتراضي</strong>:`false`</p> |
| `--continue` | يتيح الخيار `--continue` مواصلة عملية الترحيل إذا كان عنوان البريد الإلكتروني في حساب المستخدم قد تم تحديثه بالفعل |
| `--ignore-missing` | يتيح الخيار `--ignore-missing` مواصلة عملية الترحيل إذا لم يُعثر على حساب مستخدم |
| `--admin-id` | يجب تعيين `--admin-id` إلى معرّف المسؤول الذي يجري الترحيل، وسيُستخدم في إدخالات سجل التدقيق. انتقل إلى **Admin** > **Manage Users** وابحث عن عنوان بريدك الإلكتروني وانقر على النتيجة الأولى للعثور على معرّف المستخدم الخاص بك. |
| `<csv_file>` | `<csv_file>` هو الملف الذي يحتوي على عناوين البريد الإلكتروني القديمة والجديدة |

### **الإكمال**

أثناء تنفيذ سكربت الترحيل، تحدد الخيارات التي اخترتها ما إذا كان الخطأ سيُسجَّل في وحدة التحكم ثم يستمر التنفيذ، أو يُسجَّل في وحدة التحكم ثم يتوقف السكربت. إذا انتهى السكربت قبل الأوان بسبب خطأ، فسيخرج برمز 1 للدلالة على عدم نجاحه.

عند اكتمال الترحيل، سيسجّل السكربت في وحدة التحكم عدد التحديثات الناجحة والفاشلة والمتخطاة. إذا اكتمل الترحيل بنجاح، فسيخرج برمز 0.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.