الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

Toggl.track إلى جيرا

إنه تطبيق صغير يمكن تنفيذه يدويًا أو عبر crontab. سيقوم هذا التطبيق بتصدير تقرير toggl.track الخاص بك لفترة زمنية محددة إلى سجلات العمل الخاصة بمشروع Jira الخاص بك. لقد كتبت هذا التطبيق لأنه، من وجهة نظري، فإن واجهة مستخدم سجل عمل Jira ليست مفيدة. يمكنك تثبيت ملحق متصفح toggl.track وسيكون هذا أفضل بكثير من نموذج إدخال "سجل العمل" من Jira.

متطلبات

كما هو الحال في كل تطبيق، يتطلب تطبيقي أيضًا القيام ببعض الأشياء قبل التنفيذ.

  1. يجب أن يكون لديك حساب في Jira، حتى تتمكن من إنشاء رمز مصادقة Jira. انقر هنا لترى كيف.
  2. قم بإنشاء رمز toggl.track API. انقر هنا لترى كيف.

تثبيت

  1. انتقل إلى صفحة الإصدارات
  2. قم بتنزيل الأرشيف المسمى release.zip ، وقم بفك ضغطه وحدد الملف الثنائي لنظام التشغيل الخاص بك من مجلد bin وانسخه إلى المجلد ~/toggl-to-jira في نظامك. بالطبع، الأمر متروك لك، ما هو نوع المجلد الذي تختاره.
  3. تأكد من تعيين كافة متغيرات البيئة المطلوبة في ملف .env
  4. باستخدام أداة سطر الأوامر، يرجى الانتقال إلى ~/toggl-to-jira (أو المسار الخاص بك) وتشغيل الأمر التالي: 
     ./toggl-to-jira-{system}
    يرجى ملاحظة أنه بعد بدء التشغيل، سيحاول التطبيق جلب إدخالات الوقت من toggl API وإرسالها إلى Jira API. في حالتي لم يكن هناك إدخالات زمنية لوضعها في جيرا، لذا إليك ما رأيته: تشغيل التطبيق الجاف منتهي.

تكوين البيئة

التوصية هي نسخ المحتويات من .env.example إلى ملف .env في المجلد ~/toggl-to-jira (أو المسار الخاص بك)

في هذه المحتويات الوهمية يمكنك رؤية المتغيرات التالية:

لToggle.track

  • TOGGL_API_TOKEN - راجع هنا كيفية إنشاء الرمز المميز
  • TOGGL_API_URL - عنوان URL لواجهة برمجة التطبيقات https://api.track.toggl.com
  • TOGGL_DEFAULT_WORKSPACE_ID - ما عليك سوى الانتقال إلى حساب toggl.track الخاص بك وزيارة صفحة التقارير، حيث ستجد المعرف في عنوان URL الخاص بالعنوان. إليك مثال https://track.toggl.com/reports/summary/{WORKSPACE_ID}/period/thisWeek

بالنسبة لجيرا

  • JIRA_APP_TOKEN - انقر هنا لمعرفة كيفية إنشاء الرمز المميز
  • JIRA_EMAIL - البريد الإلكتروني لحساب Jira الخاص بك
  • JIRA_BASE_URL - عنوان URL لمساحة العمل https://your-company.atlassian.net

كيف يعمل

النهج الرئيسي هو:

  1. نقوم بجلب البيانات من واجهة برمجة التطبيقات toggl.track باستخدام /reports/api/v2/details?workspace_id={workspace_id}&user_agent={user_agent}&since={date_from}&until={date_to}
  2. في كل مرة نحاول فيها الحصول على عدد الدقائق وإرسال سجل العمل

من فضلك، قم أيضًا بإلقاء نظرة على المخطط الانسيابي: مخطط انسيابي

الحجج المتاحة

  1. date_from - تاريخ البدء لتصدير الفلتر. الرجاء استخدام التنسيق التالي: YYYY-MM-DD (الافتراضي "2021-03-27")
  2. date_to - تاريخ انتهاء تصدير الفلتر. الرجاء استخدام التنسيق التالي: YYYY-MM-DD (الافتراضي "2021-03-27")
  3. workspace_id - معرف مساحة العمل الذي يجب استخدامه لإنشاء تقرير بيانات toggl.track. افتراضيًا، سيتم استخدام المعرف من متغير البيئة TOGGL_DEFAULT_WORKSPACE_ID.

الرجاء استخدام --help لمزيد من التفاصيل.

عندما يتجاهل التطبيق إدخالات الوقت من toggl.track؟

هناك شروط عندما يتجاهل التطبيق إدخال الوقت المستلم:

  1. قام التطبيق بالفعل بمعالجة إدخال الوقت
  2. في وصف إدخال الوقت لم نتمكن من العثور على مفتاح مهمة Jira. مثال مفتاح المهمة KEY-1100
  3. عدد الدقائق التي يقضيها أقل من 1

استكشاف الأخطاء وإصلاحها

لا يمكن تشغيل التطبيق في MacOS Big Sur

  1. تأكد من السماح بتنفيذ التطبيق في إعدادات Security & Privacy
  2. تأكد من نقل تطبيقك إلى المجلد الموجود خارج مجلدات النظام الأساسية. على سبيل المثال: ~/Downloads هو مجلد النظام. أنشئ مجلدًا جديدًا في مسار ~/ وقم بتشغيل التطبيق من هناك.

أتلقى الخطأ "يبدو أن هناك مشاكل في التكوين. توقف عن تشغيل البرنامج النصي" من فضلك، تأكد من تحديد كافة متغيرات البيئة المطلوبة. يمكنك العثور على قائمة بها في .env.example .

الإعداد الخاص بي

أوصي باستخدام هذا التطبيق مع مجموعة من ملحقات المتصفح toggl.track، والتي يمكنك العثور عليها هنا. وأوصي أيضًا بتعيين حدث crontab لتنفيذ تطبيقك، لذلك لن تهتم بمزامنة سجل العمل بعد الآن.

نفس الشيء الذي فعلته على جهاز الكمبيوتر الخاص بي. لقد قمت بتثبيت التطبيق في crontab لإرسال تقرير Jira كل ساعتين، لذلك لا أقصف واجهات برمجة تطبيقات Jira وToggl.track. بالإضافة إلى ذلك، قمت بتثبيت ملحق متصفح Toggl.track في متصفحي وتمكينه في إعدادات الامتداد التي يدعمها Jira كما في الصورة أدناه: تمكين جيرا في النهاية، بالنسبة لجميع المهام في Jira، لدي زر لبدء/إيقاف المؤقت وجميع ساعات العمل الخاصة بي متزامنة. إنه مجاني ومفيد للغاية.

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل