Script to Bulk Insert Taiga Tasks

Script untuk melakukan bulk insert tasks/worklogs ke Taiga berdasarkan data backlog yang disimpan dalam file CSV.

How to Use

1. Prepare Backlog CSV

Buat file CSV yang berisi daftar backlog yang ingin di-insert ke Taiga.

Gunakan format header berikut:

Hari,Tanggal,Start,End,Category,ID User Story,Keterangan

Contoh:

Hari,Tanggal,Start,End,Category,ID User Story,Keterangan
Kamis,2026-08-20,08:00,12:00,Support,1833,Daily Activity Pagi 20 Agustus 2026
Kamis,2026-08-20,13:00,17:00,Support,1833,Daily Activity Siang 20 Agustus 2026
Jumat,2026-08-21,08:00,16:00,Support,1833,Daily Activity 21 Agustus 2026
Senin,2026-08-24,08:00,16:00,Support,1833,Daily Activity 24 Agustus 2026

Format Kolom

| Kolom | Deskripsi | Wajib Diisi | |---|---|---| | Hari | Nama hari dari aktivitas | - | | Tanggal | Tanggal aktivitas dengan format YYYY-MM-DD | Ya | | Start | Waktu mulai aktivitas dengan format HH:mm | Ya | | End | Waktu selesai aktivitas dengan format HH:mm | Ya | | Category | Kategori aktivitas | - | | ID User Story | Nomor referensi User Story pada Taiga | Ya | | Keterangan | Deskripsi atau judul aktivitas | Ya |

2. Prepare Environment File

Buat file .env di root directory project dengan konfigurasi berikut:

WORKLOG_DATA=

TAIGA_API_URL=
TAIGA_PROJECT_ID=
TAIGA_USER_ID=
TAIGA_TOKEN=

Sesuaikan setiap value dengan konfigurasi Taiga yang digunakan.

Contoh:

WORKLOG_DATA=./backlog.csv

TAIGA_API_URL=https://taiga.example.com
TAIGA_PROJECT_ID=123
TAIGA_USER_ID=456
TAIGA_TOKEN=your-taiga-token

Environment Variables

| Variable | Deskripsi | |---|---| | WORKLOG_DATA | Path ke file CSV backlog | | TAIGA_API_URL | URL Taiga API | | TAIGA_PROJECT_ID | ID project Taiga | | TAIGA_USER_ID | ID user Taiga | | TAIGA_TOKEN | Authentication token untuk mengakses Taiga API |

3. Run the Script

Setelah file CSV dan .env selesai dipersiapkan, jalankan command berikut:

npx @arwanfiles/insert-taiga-tasks

Script akan membaca data dari file CSV yang ditentukan pada WORKLOG_DATA dan melakukan insert task/worklog ke Taiga Project yang telah dikonfigurasi.

Example Project Structure

.
├── .env
├── backlog.csv
└── ...

Dengan konfigurasi:

WORKLOG_DATA=./backlog.csv

kemudian jalankan:

npx @arwanfiles/insert-taiga-tasks