toggl to jira

Toggl.track ไปที่จิรา

เป็นแอปพลิเคชั่นขนาดเล็กที่สามารถดำเนินการด้วยตนเองหรือผ่าน crontab แอปพลิเคชันนี้จะส่งออกรายงาน toggl.track ของคุณสำหรับช่วงเวลาที่เลือกไปยังบันทึกงานของโปรเจ็กต์ Jira ของคุณ ฉันเขียนแอพนี้เพราะจากมุมมองของฉัน UI บันทึกการทำงานของ 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 ในกรณีของฉันไม่มีเวลาใส่ Jira ดังนั้นนี่คือสิ่งที่ฉันเห็น: เสร็จแล้ว.

การกำหนดค่า Env

คำแนะนำคือการคัดลอกเนื้อหาจาก .env.example ไปยังไฟล์ .env ในโฟลเดอร์ ~/toggl-to-jira (หรือเส้นทางของคุณ)

ในเนื้อหาจำลองนี้ คุณสามารถดูตัวแปรต่อไปนี้:

สำหรับ Toggl.track

• TOGGL_API_TOKEN - ดูวิธีสร้างโทเค็นที่นี่
• TOGGL_API_URL - URL ของ API https://api.track.toggl.com
• TOGGL_DEFAULT_WORKSPACE_ID - เพียงไปที่บัญชี toggl.track ของคุณแล้วไปที่หน้ารายงาน คุณจะเห็น ID ใน 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 API โดยใช้ /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 โดยค่าเริ่มต้น จะใช้ ID จากตัวแปรสภาพแวดล้อม TOGGL_DEFAULT_WORKSPACE_ID

กรุณาใช้ --help เพื่อดูรายละเอียดเพิ่มเติม

เมื่อแอปเพิกเฉยต่อรายการเวลาจาก toggl.track

มีเงื่อนไขเมื่อแอปพลิเคชันละเว้นรายการเวลาที่ได้รับ:

1. แอปได้ประมวลผลรายการเวลาแล้ว
2. ในคำอธิบายของการป้อนเวลา เราไม่พบคีย์งาน Jira ตัวอย่างคีย์งาน KEY-1100
3. จำนวนนาทีที่ใช้น้อยกว่า 1

การแก้ไขปัญหา

ไม่สามารถเรียกใช้แอปใน MacOS Big Sur

1. ตรวจสอบให้แน่ใจว่าคุณอนุญาตให้เรียกใช้แอปพลิเคชันในการตั้ง Security & Privacy
2. ตรวจสอบให้แน่ใจว่าคุณย้ายแอปพลิเคชันของคุณไปยังโฟลเดอร์ที่อยู่นอกโฟลเดอร์ระบบฐาน เช่น ~/Downloads เป็นโฟลเดอร์ระบบ สร้างโฟลเดอร์ใหม่ใน ~/ path และเรียกใช้แอปพลิเคชันจากที่นั่น

ฉันได้รับข้อผิดพลาด "ดูเหมือนว่าจะมีปัญหากับการกำหนดค่า หยุดเรียกใช้สคริปต์" โปรดตรวจสอบให้แน่ใจว่าคุณได้กำหนดตัวแปรสภาพแวดล้อมที่จำเป็นทั้งหมด คุณสามารถดูรายชื่อได้ใน . .env.example

การตั้งค่าของฉัน

ฉันอยากจะแนะนำให้ใช้แอปพลิเคชันนี้ร่วมกับส่วนขยายเบราว์เซอร์ toggl.track ซึ่งคุณสามารถพบได้ที่นี่ นอกจากนี้ ฉันขอแนะนำให้ตั้งค่าเหตุการณ์ crontab สำหรับการทำงานของแอปพลิเคชันของคุณ ดังนั้น คุณจะไม่สนใจเรื่องการซิงค์บันทึกงานอีกต่อไป

สิ่งเดียวกับที่ฉันทำบนพีซีของฉัน ฉันติดตั้งแอปลงใน crontab เพื่อส่งรายงาน Jira ทุก 2 ชั่วโมง ดังนั้นฉันจึงไม่โจมตี API ของ Jira และ Toggl.track นอกจากนี้ ในเบราว์เซอร์ของฉัน ฉันติดตั้งส่วนขยายเบราว์เซอร์ Toggl.track และเปิดใช้งานในการตั้งค่าส่วนขยายที่สนับสนุน Jira เช่นเดียวกับในภาพด้านล่าง: ท้ายที่สุดแล้ว สำหรับงานทั้งหมดใน Jira ฉันมีปุ่มสำหรับเริ่ม/หยุดตัวจับเวลาและเวลาทำงานทั้งหมดของฉันก็ซิงค์กัน มันฟรีและมีประโยชน์มาก