toggl to jira

Alihkan.track ke Jira

Ini adalah aplikasi kecil yang dapat dijalankan secara manual atau melalui crontab. Aplikasi ini akan mengekspor laporan toggl.track Anda untuk jangka waktu yang dipilih ke log kerja proyek Jira Anda. Saya menulis aplikasi ini karena, dari sudut pandang saya, UI log kerja Jira tidak berguna. Anda dapat menginstal ekstensi browser toggl.track dan ini akan jauh lebih baik daripada formulir input "log kerja" dari Jira.

Persyaratan

Seperti setiap aplikasi, aplikasi saya juga memerlukan beberapa hal yang harus dilakukan, sebelum dieksekusi.

1. Anda harus memiliki akun di Jira agar dapat membuat token autentikasi Jira. Klik di sini untuk melihat caranya.
2. Buat token API toggl.track. Klik di sini untuk melihat caranya.

Instalasi

1. Buka halaman rilis
2. Unduh arsip bernama release.zip , unzip dan pilih biner untuk sistem operasi Anda dari folder bin dan salin ke folder ~/toggl-to-jira di sistem Anda. Tentu saja, terserah Anda, jenis folder apa yang dipilih.
3. Pastikan semua variabel lingkungan yang diperlukan telah diatur di .env
4. Menggunakan alat baris perintah, silakan buka ~/toggl-to-jira (atau jalur Anda) dan jalankan perintah berikut:

    ./toggl-to-jira-{system}
   

   Harap dicatat, bahwa setelah memulai aplikasi akan mencoba mengambil entri waktu dari toggl API dan mengirimkannya ke Jira API. Dalam kasus saya tidak ada entri waktu untuk dimasukkan ke dalam Jira, jadi inilah yang saya lihat: Selesai.

Konfigurasi env

Rekomendasinya adalah menyalin konten dari .env.example ke file .env di folder ~/toggl-to-jira (atau jalur Anda)

Dalam isi dummy ini Anda dapat melihat variabel berikut:

Untuk Toggl.track

• TOGGL_API_TOKEN - lihat di sini cara membuat token
• TOGGL_API_URL - URL API https://api.track.toggl.com
• TOGGL_DEFAULT_WORKSPACE_ID - cukup buka akun toggl.track Anda dan kunjungi halaman Laporan, di sana di URL alamat Anda akan melihat ID. Berikut ini contohnya https://track.toggl.com/reports/summary/{WORKSPACE_ID}/period/thisWeek

Untuk Jira

• JIRA_APP_TOKEN - klik di sini untuk melihat cara menghasilkan token
• JIRA_EMAIL - email akun Jira Anda
• JIRA_BASE_URL - URL ruang kerja https://perusahaan-anda.atlassian.net

Bagaimana cara kerjanya

Pendekatan utamanya adalah:

1. Kami mengambil data dari toggl.track API menggunakan /reports/api/v2/details?workspace_id={workspace_id}&user_agent={user_agent}&since={date_from}&until={date_to}
2. Untuk setiap entri waktu kami mencoba mendapatkan jumlah menit dan mengirimkan log kerja

Silakan lihat juga diagram alurnya:

Argumen yang tersedia

1. date_from - Tanggal mulai ekspor filter. Silakan gunakan format berikutnya: YYYY-MM-DD (default "27-03-2021")
2. date_to - Tanggal berakhirnya ekspor filter. Silakan gunakan format berikutnya: YYYY-MM-DD (default "27-03-2021")
3. workspace_id - ID ruang kerja yang harus digunakan untuk pembuatan laporan data toggl.track. Secara default, akan digunakan ID dari variabel lingkungan TOGGL_DEFAULT_WORKSPACE_ID.

Silakan gunakan --help untuk lebih jelasnya.

Kapan aplikasi mengabaikan entri waktu dari toggl.track?

Ada kondisi ketika aplikasi mengabaikan entri waktu yang diterima:

1. Aplikasi sudah memproses entri waktu
2. Dalam deskripsi entri waktu kami tidak dapat menemukan kunci Tugas Jira. Contoh kunci tugas KEY-1100
3. Jumlah menit yang dihabiskan kurang dari 1

Pemecahan masalah

Tidak dapat menjalankan aplikasi di MacOS Big Sur

1. Pastikan Anda mengizinkan eksekusi aplikasi di pengaturan Security & Privacy
2. Pastikan Anda memindahkan aplikasi Anda ke folder di luar folder sistem dasar. Misalnya: ~/Downloads itu adalah folder sistem. Buat folder baru di ~/ path dan jalankan aplikasi dari sana.

Saya menerima kesalahan "Sepertinya ada masalah dengan konfigurasi. Berhenti menjalankan skrip" Harap pastikan Anda mendefinisikan semua variabel lingkungan yang diperlukan. Anda dapat menemukan daftarnya di .env.example .

Pengaturan saya

Saya akan merekomendasikan menggunakan aplikasi ini dengan kombinasi ekstensi browser toggl.track, yang dapat Anda temukan di sini. Dan saya juga akan merekomendasikan untuk mengatur acara crontab untuk eksekusi aplikasi Anda, sehingga Anda tidak akan peduli lagi dengan sinkronisasi log kerja.

Hal yang sama saya lakukan pada PC saya. Saya menginstal aplikasi ke crontab untuk mengirim laporan Jira setiap 2 jam, jadi saya tidak membombardir API Jira dan Toggl.track. Plus, di browser saya, saya menginstal ekstensi browser Toggl.track dan mengaktifkan dukungan Jira di pengaturan ekstensi seperti pada gambar di bawah ini: Pada akhirnya, untuk semua tugas di Jira saya memiliki tombol untuk memulai/menghentikan pengatur waktu dan semua jam kerja saya sinkron. Ini gratis dan sangat berguna.