ملف CSV

يستخدم GAX ملفات قيم مفصولة بفواصل (CSV) لاستيراد\تصدير التحديثات المجمعة للوكلاء. ويصف هذا القسم تنسيق ملف CSV ويقدم بعض الأمثلة.

تنسيق الملف

الملف المصدر هو ملف نصي في تنسيق مفصول بفاصلة (CSV).

في الملف المصدر، كل سطر يمثل مستخدم أو وكيل واحد. ويمكن أن يظهر نفس المستخدم أو الوكيل في الملف المصدر مرة واحدة فقط. المعرّف الفريد للمستخدم في نطاق الملف المصدر هو حقل اسم المستخدم.

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

يحتوي الملف المصدر على الخصائص التالية لكل مستخدم/وكيل:

[+] عرض الخصائص

بنية ملف استيراد CSV

الاسم	النوع	إلزامي؟	الوصف
إجراء	إضافة، تحديث	نعم	تحديد الإجراء ليتم اتخاذه مع بيانات الوكيل هذه، سواء كان إنشاء وكيل جديد (إضافة) أو تعديل الوكيل الموجود (تحديث).
الاسم الأول	سلسلة	نعم	الاسم الأول للمستخدم/الوكيل
اسم العائلة	سلسلة	نعم	الاسم الأخير للمستخدم/الوكيل
معرف الموظف	سلسلة	نعم	معرف الموظف للمستخدم/الوكيل
اسم المستخدم	سلسلة	نعم	اسم المستخدم للمستخدم/الوكيل
كلمة المرور	سلسلة	لا	كلمة المرور التي يلزم استخدامها مع اسم المستخدم
تغيير كلمة المرور	منطقية (نعم أو لا)	لا	هل يحتاج المستخدم/الوكيل إلى تحديث كلمة مروره/مرورها عندما يسجل/تسجل الدخول؟
هل وكيل	منطقية	نعم	يحدد ما إذا كان السجل يمثل مستخدم أو وكيل؛ وتختلف وظيفة النص فيما بينهما.
المعرف الخارجي	سلسلة	لا	المعرف الخارجي
عنوان البريد الإلكتروني	سلسلة	لا	عنوان البريد الإلكتروني للمستخدم/الوكيل؛ وعادة ما تكون نفس اسم المستخدم.
ملحق	سلسلة رقمية	لا	الملحق الافتراضي للوكيل. في حالة وجود ملحق، يتم تشغيل إنشاء المكان الافتراضي.
مُمَكن	منطقية	لا	حالة المستخدم —نعم=مُمَكن، لا=معطل
مجلد	سلسلة	نعم	المجلد والمسار إلى المجلد الجذر (الأشخاص)، حيث سيتم إنشاء المستخدم/الوكيل؛ على سبيل المثال، الشركة/القسم/الفريق

الأعمدة الارتباطية

بالإضافة إلى الخصائص والمجلدات، فقد يحتوي كل صف على ارتباطات بين المستخدم / الوكيل مع كائنات التكوين الأخرى، وبخاصة المبدلات ومجموعات الوكيل والمهارات ومجموعات الوصول. سوف يكون لدي كل مثيل من المبدل أو مجموعة الوكيل أو مجموعة الوصول أو كائن المهارة عمودًا منفصلاً في الملف المصدر. على سبيل المثال، إذا كان هناك 10 مجموعات وكيل، و1 مبدل، و15 مهارة، و4 مجموعات وصول، سوف يكون هناك 30 عمودًا إضافيًا في الملف المصدر، ويمثل كل واحد كل كائن تكوين. جميع الأعمدة الارتباطية اختيارية.

يتكون كل رأس للعمود الارتباطي من نوع الكائن واسم الكائن والتي ستشكل اسم عمود فريد. لذا، على سبيل المثال، لا يمكن أن يكون هناك اثنين من المهارات التي لديها نفس الاسم، ولكن قد يكون لكائن المهارة نفس الاسم مثل بعض كائنات المبدل.

ويرد في الجدول التالي التسمية وقواعد القيمة للأعمدة الارتباطية:

الأعمدة الارتباطية

النوع	اسم العمود	القيم الصالحة
تحويل	تحويل:<switch name>	نعم – إنشاء دخول وكيل لهذا الوكيل على هذا المبدل لا – إزالة دخول الوكيل لهذا الوكيل من هذا المبدل <empty> - لا يوجد إجراء
مجموعة العملاء	AgentG:<agent group name>	نعم – إضافة هذا الوكيل إلى مجموعة الوكيل هذه لا – إزالة هذا الوكيل من مجموعة الوكيل هذه <empty> - لا يوجد إجراء
مجموعة الوصول	AccessG:<access group name>	نعم – إضافة هذا الوكيل/المستخدم إلى مجموعة الوصول هذه لا – إزالة هذا الوكيل/المستخدم من مجموعة الوصول هذه <empty> - لا يوجد إجراء Important لا تنطبق مجموعة الوصول الافتراضية المحددة في تفضيلات النظام عند استخدام التحميلات المجمعة، بمجرد أن يتم تحديد مجموعة الوصول للوكيل في ملف CSV.
المهارة	المهارة:<skill name>	<number> - تعيين هذه المهارة لهذا الوكيل مع مستوى المهارة هذا لا – إزالة هذه المهارة من هذا الوكيل <empty> - لا يوجد إجراء

عند تحميل الملف، يقوم GAX تلقائيًا بإضافة عمود جديد في بداية كل سجل، مع وجود رأس عمود الإجراء. لكل سجل، تقوم بتعيين أحد القيم التالية:

• إضافة - تمت إضافة الوكيل.
• تحديث - تم تعديل الوكيل الموجود طبقًا للخصائص المعدلة أو الارتباطات في الملف.

مثال

سيتم تحميل البيانات التالية إلى GAX لإنشاء ثلاثة وكلاء:

[+] عرض البيانات

الاسم الأول	اسم العائلة	معرف الموظف	اسم المستخدم	هل وكيل	المعرف الخارجي	ملحق	المهارة: إنجليزي	المبدل: سان فرانسيسكو	المبدل: لندن	AgentG: جيد	AccessG: فائق	إجراء	مجلد
سارة	لي	223344	sarahl@acme.com	N							Y	إضافة	Acme/الفرع/الفريق 1
جون	دولي	223465	johnd@acme.com	Y		2233	1	Y	N	Y		إضافة	Acme/الفرع/الفريق 2
روبرت	كوك	244456	bobc@acme.com	Y		2356	5	Y		Y		إضافة	Acme/الفرع/الفريق 3

تبدو محتويات ملف CSV لهذه البيانات كما يلي:

Sarah,Lee,223344,sarahl@acme.com,N,,,,,,,Y,ADD,Acme/Branch/Team 1
John,Doyle,223465,johnd@acme.com,Y,,2233,1,Y,N,Y,,ADD,Acme/Branch/Team 2
Robert,Cook,244456,bobc@acme.com,Y,,2356,5,Y,,Y,,ADD,Acme/Branch/Team 3