Tempo

Tempo یک برنامه ثبت زمان برای Jira است. میترا worklogهای شما، یعنی ساعت‌هایی را که روی مسئله‌های Jira ثبت کرده‌اید، به‌صورت موارد زمان‌دار روی تقویمتان نشان می‌دهد، کنار جلسات و کارهایی که زمان صرف آن‌ها شده.

worklogها در هر دو جهت همگام می‌شوند. یک مورد را جابه‌جا یا تغییر اندازه دهید تا زمان و مدت کارتان عوض شود، توضیحاتش را ویرایش کنید تا یادداشت worklog عوض شود، حذفش کنید تا worklog حذف شود، یا موردی بسازید تا زمان تازه ثبت شود.

از داخل برنامه با دو توکن API وصل می‌شوید. چیزی روی سرور راه‌اندازی نمی‌شود.

اتصال برگه زمان

میترا به یک توکن از Tempo و یکی از Atlassian نیاز دارد: Tempo ساعت‌ها را نگه می‌دارد و Jira مسئله‌ها و هویت شما را می‌شناسد.

1. یک توکن API در Tempo بسازید. در Jira، Settings (آیکون چرخ‌دنده) Tempo ← Data Access ← API integration را باز کنید، New Token را انتخاب کنید، نامش را «Mitra» بگذارید و توکن را کپی کنید.
2. در id.atlassian.com/manage-profile/security/api-tokens با Create API token یک توکن API در Atlassian بسازید و کپی‌اش کنید. هر دو توکن را با همان کاربر Jira بسازید.
3. در میترا، در پایین نوار کناری افزودن یکپارچه‌سازی و سپس Tempo را انتخاب کنید و پر کنید:
   • نشانی اینترنتی سایت، نشانی Atlassian شما، مثل https://your-company.atlassian.net.
   • توکن API تمپو، توکن مرحله ۱.
   • ایمیل حساب اتلسین، نشانی ایمیل حساب Atlassian شما.
   • توکن API اتلسین، توکن مرحله ۲.
4. اتصال را بزنید. میترا یک تقویم فهرست می‌کند، My worklogs.
5. آن را روشن بگذارید و ذخیره را بزنید.

Tempo تعداد فراخوانی برنامه‌ها را محدود می‌کند، پس میترا آن را حدود یک بار در دقیقه همگام می‌کند (همگام‌سازی چگونه کار می‌کند را ببینید).

worklogها چگونه دیده می‌شوند

عنوان یک مورد همان مسئله Jira است که زمان روی آن ثبت شده، یعنی کلید و خلاصه‌اش:

ACME-1234 Code review for auth migration

یادداشت worklog توضیحات مورد است. برنامه خود Tempo هم آن‌ها را همین‌طور نشان می‌دهد، چون مسئله می‌گوید زمان درباره چه بوده، در حالی که یادداشت اغلب برچسب فعالیتی مثل «Review» است، یا متنی که Jira برایتان نوشته، مثل «Working on work item ACME-1234».

عنوان متعلق به مسئله است، پس روی worklog ذخیره‌شده نمی‌توانید ویرایشش کنید: میترا مسئله Jira را فقط چون مورد تقویم را ویرایش کرده‌اید تغییر نام نمی‌دهد. توضیحات را ویرایش کنید تا بگویید چه کرده‌اید. اگر Jira نتواند مسئله را نام ببرد، چون حذف شده یا دیگر نمی‌توانید آن را ببینید، عنوان # و شناسه مسئله را نشان می‌دهد و مورد همچنان کار می‌کند.

Tempo worklogها را به‌صورت ساعت ساده بدون منطقه زمانی ذخیره می‌کند. میترا آن‌ها را در منطقه زمانی نمایه Jira شما می‌خواند، پس در همان ساعت‌هایی که در Tempo هستند نشان داده می‌شوند.

بعضی سایت‌های Tempo زمان شروع را خاموش کرده‌اند. آنجا هر worklog یک روز در یک زمان شروع می‌شود و روی هم می‌افتند، اما مدت‌هایشان درست است.

ثبت زمان از میترا

یک مورد زمان‌دار در My worklogs بسازید و کلید مسئله Jira را در هر جای عنوانش بگذارید:

می‌نویسید	ثبت می‌شود روی
ACME-1234 Team standup	ACME-1234
Investigating ACME-1234 regression	ACME-1234
ACME-1234	ACME-1234

میترا کلید را با پروژه‌های Jira که می‌توانید ببینید بررسی می‌کند. اگر عنوان چنین کلیدی ندارد، یا Jira چنین مسئله‌ای ندارد، میترا چیزی ثبت نمی‌کند و دلیلش را می‌گوید.

یادداشت worklog همان است که در توضیحات نوشته‌اید، یا اگر خالی گذاشته‌اید، کل عنوان همان‌طور که تایپ کرده‌اید. وقتی زمان ثبت شد، عنوان به کلید و خلاصه مسئله تبدیل می‌شود. این تعویض یک بار و هنگام ثبت انجام می‌شود، برای همین هنگام نوشتن می‌توانید عنوان را ویرایش کنید و بعد از آن نه.

TIP

برای ثبت زمان روی مسئله‌ای که قبلاً ثبت کرده‌اید، یکی از مواردش را تکثیر کنید: هنگام کشیدنش به زمان تازه Alt (روی Mac ⌥) را نگه دارید، یا تکثیر را در منوی ⋯ ویرایشگرش انتخاب کنید.

تغییر یک worklog

جابه‌جایی، تغییر اندازه، حذف و ویرایش توضیحات مستقیم به Tempo می‌روند. چند نکته:

• یک worklog روی مسئله‌اش می‌ماند. Tempo نمی‌تواند worklog را به مسئله دیگری منتقل کند، پس برای ثبت زمان جای دیگر، مورد را حذف کنید و موردی تازه با کلید درست بسازید.
• میترا وقتی worklog را تغییر می‌دهد جزئیات خود Tempo از آن، مثل زمان قابل‌صورتحساب و ویژگی‌های کار، را نگه می‌دارد.
• وقتی دوره‌ای از برگه زمان در Tempo بسته یا تأیید شده باشد، Tempo افزودن، تغییر یا حذف worklog را در آن نمی‌پذیرد.

برای باز کردن مسئله در Jira، باز کردن در Jira را در منوی ⋯ ویرایشگر انتخاب کنید.

آنچه یک worklog نمی‌تواند نگه دارد

worklog بازه‌ای از زمان در یک روز است که روی یک مسئله ثبت شده. پس تقویم Tempo فقط موارد زمان‌دار نگه می‌دارد: نه موارد تمام‌روز، نه تکرار، یادآور، مکان، شرکت‌کننده، ارتباط، مشغول یا آزاد بودن، قابلیت مشاهده یا در دسترس بودن. میترا این فیلدها را روی worklogها پنهان می‌کند.

عیب‌یابی

• اگر میترا می‌گوید “Tempo rejected the API token”، یک توکن API تازه در Tempo بسازید و آن را در ⋯ ← ویرایش حساب وارد کنید.
• اگر میترا می‌گوید “Jira rejected the e-mail and API token”، بررسی کنید نشانی ایمیل به حساب Atlassian‌ای تعلق دارد که توکن API را ساخته است.
• اگر worklogها در ساعت نادرست روز نشان داده می‌شوند، منطقه زمانی نمایه Jira را بررسی کنید (Account settings ← Time zone). پس از تغییرش، درون‌ریزی مجدد موارد را در منوی ⋯ مربوط به My worklogs بزنید، تا worklogهایی که از قبل دارید هم جابه‌جا شوند.
• اگر worklogها هر روز در یک زمان روی هم می‌افتند، سایت Tempo شما زمان شروع را خاموش کرده است. ساعت‌ها همچنان درست‌اند.