toggl to jira

Jira로 Toggl.track

수동으로 또는 crontab을 통해 실행할 수 있는 작은 응용 프로그램입니다. 이 애플리케이션은 선택한 기간에 대한 toggl.track 보고서를 Jira 프로젝트의 작업 로그로 내보냅니다. 내 관점에서 Jira 작업 로그 UI가 유용하지 않기 때문에 이 앱을 작성했습니다. 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.example의 내용을 ~/toggl-to-jira (또는 경로) 폴더의 .env 파일로 복사하는 것입니다.

이 더미 콘텐츠에서는 다음 변수를 볼 수 있습니다.

Toggl.track의 경우

• TOGGL_API_TOKEN - 토큰 생성 방법은 여기를 참조하세요.
• TOGGL_API_URL - API URL https://api.track.toggl.com
• TOGGL_DEFAULT_WORKSPACE_ID - toggl.track 계정으로 이동하여 보고서 페이지를 방문하면 주소 URL에 ID가 표시됩니다. 다음은 https://track.toggl.com/reports/summary/{WORKSPACE_ID}/period/thisWeek 의 예입니다.

Jira의 경우

• JIRA_APP_TOKEN - 토큰 생성 방법을 보려면 여기를 클릭하세요.
• JIRA_EMAIL - Jira 계정 이메일
• JIRA_BASE_URL - 작업공간 URL https://your-company.atlassian.net

작동 원리

주요 접근 방식은 다음과 같습니다.

1. /reports/api/v2/details?workspace_id={workspace_id}&user_agent={user_agent}&since={date_from}&until={date_to} 사용하여 toggl.track API에서 데이터를 가져옵니다.
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 환경 변수의 ID가 사용됩니다.

자세한 내용을 보려면 --help 사용하세요.

앱이 toggl.track의 시간 항목을 무시할 때?

애플리케이션이 수신된 시간 항목을 무시하는 경우 다음과 같은 조건이 있습니다.

1. 앱이 이미 시간 입력을 처리했습니다.
2. 시간 항목 설명에서 Jira Task 키를 찾을 수 없습니다. 태스크 키 예시 KEY-1100
3. 소요된 시간이 1분보다 작습니다.

문제 해결

MacOS Big Sur에서 앱을 실행할 수 없습니다

1. Security & Privacy 설정에서 애플리케이션 실행을 허용했는지 확인하세요.
2. 애플리케이션을 기본 시스템 폴더 외부의 폴더로 이동했는지 확인하세요. 예: ~/Downloads 는 시스템 폴더입니다. ~/ 경로에 새 폴더를 만들고 거기에서 애플리케이션을 실행합니다.

"구성에 문제가 있는 것 같습니다. 스크립트 실행을 중지하세요." 오류가 발생합니다 . 필요한 모든 환경 변수를 정의했는지 확인하세요. .env.example 에서 해당 목록을 찾을 수 있습니다.

내 설정

여기에서 찾을 수 있는 toggl.track 브라우저 확장 기능과 함께 이 애플리케이션을 사용하는 것이 좋습니다. 또한 애플리케이션 실행을 위해 crontab 이벤트를 설정하는 것이 좋습니다. 그러면 더 이상 작업 로그 동기화에 신경 쓰지 않아도 됩니다.

내 PC에서 했던 것과 똑같은 일이다. 2시간마다 Jira 보고서를 보내기 위해 crontab에 앱을 설치했기 때문에 Jira 및 Toggl.track API를 폭격하지 않습니다. 또한 내 브라우저에 Toggl.track 브라우저 확장을 설치하고 아래 이미지와 같이 Jira 지원 확장 설정을 활성화했습니다. 마지막에는 Jira의 모든 작업에 대해 타이머를 시작/중지하는 버튼이 있고 모든 작업 시간이 동기화됩니다. 무료이며 매우 유용합니다.