تخطَّ إلى المحتوى

التكاملات22‏/10‏/2026مدة القراءة: 4 دقائق

Tempo

Tempo تطبيق لتتبع الوقت في Jira. يعرض Mitra سجلات العمل الخاصة بك، أي الساعات التي سجّلتها على تذاكر Jira، كعناصر بوقت محدد في تقويمك، بجانب الاجتماعات والمهام التي قضيت فيها ذلك الوقت.

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

يتم الربط من داخل التطبيق باستخدام رمزَي API، ولا يلزم إعداد أي شيء على الخادم.

يحتاج Mitra إلى رمز من Tempo وآخر من Atlassian: إذ يحتفظ Tempo بالساعات، ويعرف Jira التذاكر ويعرف من أنت.

  1. أنشئ رمز Tempo API. في Jira، افتح Settings في Tempo (رمز الترس) ← Data Access → API integration، واختر New Token، وسمّه «Mitra»، ثم انسخ الرمز.
  2. أنشئ رمز Atlassian API من id.atlassian.com/manage-profile/security/api-tokens بالنقر على Create API token، ثم انسخه. أنشئ الرمزين باستخدام مستخدم Jira نفسه.
  3. في Mitra، اختر إضافة تكامل أسفل الشريط الجانبي، ثم Tempo، واملأ الحقول التالية:
    • عنوان URL للموقع: عنوانك في Atlassian، مثل https://your-company.atlassian.net.
    • رمز API في Tempo: الرمز من الخطوة 1.
    • البريد الإلكتروني لحساب Atlassian: عنوان البريد الإلكتروني لحسابك في Atlassian.
    • رمز API في Atlassian: الرمز من الخطوة 2.
  4. انقر على ربط. يعرض Mitra تقويمًا واحدًا هو سجلات عملي.
  5. اتركه مفعّلًا وانقر على حفظ.

يحدّ Tempo من عدد المرات التي يمكن فيها للتطبيقات الاتصال به، لذلك يزامنه Mitra مرة واحدة في الدقيقة تقريبًا (راجع طريقة عمل المزامنة).

عنوان العنصر هو تذكرة Jira التي سُجّل عليها الوقت، أي مفتاحها وملخصها:

ACME-1234 Code review for auth migration

وملاحظة سجل العمل هي وصف العنصر. ويعرضها تطبيق Tempo نفسه بالطريقة ذاتها، لأن التذكرة هي التي تبيّن موضوع الوقت المسجّل، بينما تكون الملاحظة غالبًا مجرد تسمية لنشاط مثل «Review»، أو نصًا كتبه Jira نيابة عنك مثل «Working on work item ACME-1234».

العنوان ملك للتذكرة، لذلك لا يمكنك تعديله في سجل عمل محفوظ: فلن يعيد Mitra تسمية تذكرة Jira لأنك عدّلت عنصرًا في التقويم. عدّل الوصف لتكتب ما أنجزته. وإذا لم يتمكن Jira من تسمية التذكرة، لأنها حُذفت أو لم تعد لديك صلاحية رؤيتها، فيعرض العنوان # ومعرّف التذكرة، ويستمر العنصر في العمل.

يحفظ Tempo سجلات العمل كأوقات عادية دون منطقة زمنية. ويقرؤها Mitra في المنطقة الزمنية المحددة في ملفك الشخصي في Jira، فتظهر في الأوقات نفسها التي تظهر بها في Tempo.

بعض مواقع Tempo تعطّل أوقات البدء. وفيها تبدأ كل سجلات العمل في اليوم الواحد في الوقت نفسه، فتتراكم فوق بعضها، لكن مددها تبقى صحيحة.

أنشئ عنصرًا بوقت محدد في سجلات عملي، وضع مفتاح تذكرة Jira في أي مكان من عنوانه:

ما تكتبهيُسجَّل على
ACME-1234 Team standupACME-1234
Investigating ACME-1234 regressionACME-1234
ACME-1234ACME-1234

يتحقق Mitra من المفتاح في مشاريع Jira التي يمكنك رؤيتها. وإذا لم يحتوِ العنوان على مفتاح كهذا، أو لم توجد في Jira تذكرة بهذا المفتاح، فلا يسجّل Mitra شيئًا ويخبرك بالسبب.

ملاحظة سجل العمل هي ما كتبته في الوصف، أو العنوان كاملًا كما كتبته إن تركت الوصف فارغًا. وبعد تسجيل الوقت، يصبح العنوان مفتاح التذكرة وملخصها. ويحدث هذا الاستبدال مرة واحدة فقط عند التسجيل، ولهذا يمكنك تعديل العنوان أثناء كتابته وليس بعد ذلك.

TIP

لتسجيل وقت على تذكرة سجّلت عليها من قبل، أنشئ نسخة من أحد عناصرها: اضغط مع الاستمرار على Alt (⌥ على Mac) أثناء سحبه إلى الوقت الجديد، أو اختر إنشاء نسخة من قائمة ⋯ في محرره.

النقل وتغيير الحجم والحذف وتعديل الوصف تصل كلها إلى Tempo مباشرة. وإليك بعض الأمور التي ينبغي معرفتها:

  • يبقى سجل العمل على تذكرته. فلا يستطيع Tempo نقل سجل عمل إلى تذكرة أخرى، لذا لتسجيل الوقت على تذكرة أخرى، احذف العنصر وأنشئ عنصرًا جديدًا بالمفتاح الصحيح.
  • يحتفظ Mitra بتفاصيل Tempo الخاصة بسجل العمل، مثل الوقت القابل للفوترة وسمات العمل، عندما يغيّره.
  • عندما تُغلق فترة جدول الساعات أو تُعتمد في Tempo، يرفض Tempo إضافة سجلات عمل فيها أو تغييرها أو حذفها.

لفتح التذكرة في Jira، اختر فتح في Jira من قائمة ⋯ في المحرر.

ما لا يستطيع سجل العمل حفظه

Section titled “ما لا يستطيع سجل العمل حفظه”

سجل العمل فترة زمنية في يوم واحد، مسجّلة على تذكرة واحدة. لذلك لا يحتوي تقويم Tempo إلا على عناصر بوقت محدد: لا عناصر طوال اليوم، ولا تكرار، ولا تذكيرات، ولا موقع، ولا مشاركون، ولا مرفقات، ولا علاقات، ولا حالة مشغول أو متاح، ولا مستوى ظهور، ولا توفر. ويخفي Mitra هذه الحقول في سجلات العمل.

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

Section titled “استكشاف الأخطاء وإصلاحها”
  • إذا ظهرت رسالة «رفض Tempo رمز API»، فأنشئ رمز Tempo API جديدًا وأدخله من ⋯ ← تعديل للحساب.
  • إذا ظهرت رسالة «رفض Jira البريد الإلكتروني ورمز API»، فتحقق من أن عنوان البريد الإلكتروني يخص حساب Atlassian الذي أنشأ رمز API.
  • إذا ظهرت سجلات العمل في وقت خاطئ من اليوم، فتحقق من المنطقة الزمنية في ملفك الشخصي في Jira (Account settings → Time zone). وبعد تغييرها، استخدم إعادة استيراد العناصر من قائمة ⋯ في سجلات عملي، حتى تنتقل سجلات العمل الموجودة لديك أيضًا.
  • إذا تراكمت سجلات العمل في الوقت نفسه كل يوم، فهذا يعني أن موقع Tempo الخاص بك عطّل أوقات البدء. ومع ذلك تبقى الساعات صحيحة.