الانتقال إلى المحتوى الرئيسي

الفصلالربط مع Sage

الفصل 2 — تثبيت الوكيل المحلي

الوكيل هو البرنامج الصغير الذي يقرأ قاعدة Sage لدى حريفك. تنشئه في IntegraSys، وتثبّته على حاسوب لدى الحريف، فيصبح متصلًا بمجرد أن تلصق فيه رمزه.

في هذا الفصل

  • إنشاء الوكيل ونسخ رمزه
  • تنزيل الوكيل وتشغيله لدى الحريف
  • نافذة الوكيل ومؤشّرها
  • متابعة الوكيل أو إلغاؤه أو حذفه
  1. إنشاء
  2. نسخ الرمز
  3. تنزيل
  4. Démarrer
  5. متصل
محتويات الكتاب

وكيل لكل شبكة

يخدم الوكيل شبكة واحدة، لا حريفًا واحدًا. إذا احتضن خادم Sage قواعد عدة شركات، قرأها وكيل واحد كلها. وحريفان على شبكتين مختلفتين يحتاجان وكيلين.

يجب أن يبقى حاسوب الوكيل مشغّلًا أثناء الاستخراج. والأبسط هو خادم Sage نفسه.

إنشاء الوكيل في IntegraSys

صفحة الوكلاء المحليون مع وكيل متصل (شاشة بالفرنسية)
  1. 1. ما هو الوكيل، مذكورًا في أعلى الصفحة: يقرأ خادم SQL في مكانه، قراءة فقط، ولا يرسل إلا نحو الخارج.
  2. 2. تنزيل الوكيل: البرنامج الذي يُثبَّت لدى الحريف، agent-setup.exe.
  3. 3. إضافة وكيل: ينشئ الوكيل ويعرض رمزه مرة واحدة.
  4. 4. متصل: اتصل الوكيل بـ IntegraSys منذ أقل من ثلاث دقائق.
  5. 5. Vu (آخر ظهور) والخوادم والإصدار: آخر اتصال، والخوادم التي تمر عبره، والإصدار المثبّت.
  1. انقر على إضافة وكيل.
  2. اكتب اسم الوكيل، مثلًا « Agent LUMEA DESIGN »، ثم انقر على إنشاء الوكيل.
  3. تُفتح نافذة تم إنشاء الوكيل — انسخ الرمز. انسخ، بالزر الموجود في آخر كل سطر، عنوان الخادم — أدخله في نافذة الوكيل ورمز الوكيل.
  4. احتفظ بهما طوال التثبيت، ثم انقر على تم.
نافذة « تم إنشاء الوكيل — انسخ الرمز »: التنبيه البرتقالي، والعنوان https://api.integrasys-erp.com، والرمز، وكتلة « إعداد الوكيل ».

تعرض النافذة نفسها كتلة إعداد الوكيل: سطرين يحملان العنوان والرمز. وهما لتقني يثبّت الوكيل دون نافذته. أما في التثبيت العادي، فيكفي العنوان والرمز.

تنزيل الوكيل وتشغيله لدى الحريف

  1. انقر على تنزيل الوكيل: يُنزَّل الملف agent-setup.exe.
  2. انسخه على حاسوب الحريف، في مجلد سيبقى في مكانه. يُحفظ إعداده بجانبه (config.ini)، وكذلك سجلّه (agent.log).
  3. انقر مرتين على agent-setup.exe. إن عرض Windows رسالة الحماية، فانقر على معلومات إضافية ثم التشغيل على أي حال (بحسب لغة Windows).
  4. في نافذة IntegraSys — Agent Connexion Externe، تحقّق من أن خانة URL IntegraSys تحمل العنوان المنسوخ، ثم الصق الرمز في Jeton de l'agent (رمز الوكيل). خانة Afficher (عرض) تجعل الرمز مقروءًا.
  5. ضع علامة على Démarrer automatiquement avec Windows (التشغيل مع Windows) ليُعاد تشغيل الوكيل عند كل فتح لجلسة Windows: بعد إعادة تشغيل الحاسوب، يجب إذن أن تُفتح جلسة.
  6. انقر على Démarrer (تشغيل). يصبح المؤشر أخضر: « En ligne — en attente de travail » (متصل، في انتظار العمل).
شاشة قادمةنافذة الوكيل على حاسوب تجريبي: URL IntegraSys، رمز مخفي، خانة التشغيل التلقائي، مؤشر أخضر « En ligne — en attente de travail » وبعض الأسطر في « Activité ».

نافذة الوكيل

النافذة بالفرنسية، مهما كانت لغة IntegraSys. فيها ثلاث مناطق: Connexion (الاتصال: العنوان، الرمز، التشغيل التلقائي)، وسطر حالة بمؤشره، وActivité (النشاط) التي تسجّل كل حدث بوقته.

المؤشر والنصمعناه
برتقالي — « Connexion à IntegraSys… »الوكيل يبدأ ويقدّم نفسه
أخضر — « En ligne — en attente de travail »كل شيء على ما يرام: ينتظر استخراجًا
أزرق — « Extraction en cours… »يقرأ قاعدة Sage ويرسل النتيجة
برتقالي — « IntegraSys injoignable — nouvelle tentative… »لا إنترنت، أو IntegraSys لا يجيب: يعيد المحاولة وحده
رمادي — « Arrêté » (متوقف)، ومعه في Activité السطر الأحمر « Jeton refusé (401). Vérifiez le jeton de l'agent. » (رمز مرفوض)الرمز منسوخ بخطأ، أو الوكيل ملغى: توقف الوكيل وحده. الصق الرمز من جديد، ثم انقر على Démarrer
  • يصحَّح العنوان وحده. إن كتب أحدهم عنوان الموقع (integrasys-erp.com)، يستبدله الوكيل بعنوان الخادم ويكتب في Activité: « Adresse corrigée : … » (تم تصحيح العنوان).
  • إغلاق النافذة يوقف الوكيل. يسأل الوكيل أولًا: « L'agent est en cours d'exécution. Le fermer arrêtera la synchronisation avec IntegraSys. Quitter quand même ? » (الوكيل يعمل؛ إغلاقه يوقف المزامنة مع IntegraSys؛ الخروج رغم ذلك؟). أجب بـ Non (لا): تُصغَّر النافذة ويواصل الوكيل.
  • بعد ضبطه، يتصل الوكيل وحده في كل تشغيل: لا حاجة بعدها للنقر على Démarrer.
  • التشغيل التلقائي يعيد تشغيل الوكيل، بنافذة مصغّرة، عند كل فتح لجلسة Windows. يتطلب صلاحيات المسؤول: إن عرضت Activité « Échec de l'activation du démarrage automatique » (فشل تفعيل التشغيل التلقائي)، أغلق الوكيل، وانقر بالزر الأيمن على agent-setup.exe، واختر التشغيل كمسؤول. يبدأ الوكيل المضبوط وحده: انقر على Arrêter (إيقاف)، وأعد وضع العلامة على Démarrer automatiquement avec Windows، ثم انقر على Démarrer. تؤكد Activité: « Démarrage automatique activé (tâche « ConnexionExterneAgent ») » (تفعيل التشغيل التلقائي).

متابعة الوكيل في IntegraSys

لكل وكيل بطاقته في صفحة الوكلاء المحليون: اسمه، وبداية رمزه، وحالته.

  • متصل: اتصل بـ IntegraSys منذ أقل من ثلاث دقائق.
  • غير متصل: لم يتصل منذ مدة أطول. الحاسوب مطفأ، أو النافذة مغلقة، أو الإنترنت مقطوع.
  • ملغى: رمزه لم يعد يعمل.

ما دام الوكيل غير متصل، يبقى الاستخراج الذي يمر عبره قيد الانتظار.

إلغاء وكيل أو حذفه

مرّر الفأرة على بطاقة الوكيل: يظهر زرّان.

  • إلغاء يقطع رمزه فورًا: « سيتوقف الرمز عن العمل فورًا، ولن يتمكن الوكيل من استلام مهام بعد ذلك. ». تبقى البطاقة باهتة، مع إشارة ملغى. ولا يُقترح الوكيل الملغى بعد ذلك في استمارة أي خادم.
  • سلة المهملات تحذف الوكيل نهائيًا. تفقد الخوادم التي كانت تمر عبره وكيلها وتعود إلى الوصول المباشر: اختر لها وكيلًا آخر أولًا في خوادم SQL.

تحديث الوكيل

يأتي الوكيل الحديث بالجديد: يلزم الإصدار 1.12 أو أحدث لمراقبة القيود (الفصل 7) ولـ Sage Paie (الفصل 11). تعرض بطاقة الوكيل إصداره.

لتحديثه، انقر على Arrêter في نافذته ثم أغلقها، ونزّل agent-setup.exe من جديد، واستبدل الملف القديم في المجلد نفسه، ثم شغّله. يُحتفظ بإعداده المحفوظ بجانبه كما هو.