toggl to jiraダウンロード - toggl to jiraソースコードのダウンロード

toggl to jira

その他のソースコード

ダウンロード

Jira への Toggl.track

これは、手動または crontab 経由で実行できる小さなアプリケーションです。このアプリケーションは、選択した期間の toggl.track レポートを Jira プロジェクトの作業ログにエクスポートします。このアプリを作成したのは、私の観点からは、Jira 作業ログ UI が役に立たないからです。 toggl.track ブラウザ拡張機能をインストールすると、Jira の「作業ログ」入力フォームよりもはるかに優れた機能になります。

要件

各アプリケーションと同様に、私のアプリも実行前にいくつかの作業を行う必要があります。

Jira 認証トークンを作成するには、Jira にアカウントが必要です。ここをクリックして方法を確認してください。
toggl.track API トークンを作成します。ここをクリックして方法を確認してください。

インストール

リリースページに移動
release.zipというアーカイブをダウンロードして解凍し、 binフォルダーからオペレーティングシステム用のバイナリを選択して、システムの~/toggl-to-jiraフォルダーにコピーします。もちろん、どのようなフォルダーを選択するかはあなた次第です。
必要な環境変数がすべて.envファイルに設定されていることを確認してください。
コマンドラインツールを使用して、 ~/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_APP_TOKEN - ここをクリックしてトークンの生成方法を確認します
JIRA_EMAIL - Jira アカウントのメールアドレス
JIRA_BASE_URL - ワークスペース URL https://your-company.atlassian.net

仕組み

主なアプローチは次のとおりです。

/reports/api/v2/details?workspace_id={workspace_id}&user_agent={user_agent}&since={date_from}&until={date_to}を使用して、toggl.track API からデータを取得します。
エントリごとに分数を取得し、作業ログを送信しようとします。

フローチャート図もご覧ください。

利用可能な引数

date_from - フィルターのエクスポートの開始日。次の形式を使用してください: YYYY-MM-DD (デフォルトは「2021-03-27」)
date_to - フィルターのエクスポートの終了日。次の形式を使用してください: YYYY-MM-DD (デフォルトは「2021-03-27」)
workspace_id - toggl.track データレポートの生成に使用するワークスペース ID。デフォルトでは、TOGGL_DEFAULT_WORKSPACE_ID 環境変数の ID が使用されます。

詳細については--help使用してください。

アプリが toggl.track からの時間エントリを無視するとき?

アプリケーションが受信した時刻エントリを無視する場合には、次のような条件があります。

アプリはすでに時間入力を処理しています
時間エントリの説明で、Jira タスクキーが見つかりませんでした。タスクキーの例KEY-1100
費やした分数は 1 未満です

トラブルシューティング

MacOS Big Sur でアプリを実行できない

Security & Privacy設定でアプリケーションの実行を許可していることを確認してください
必ずアプリケーションを基本システムフォルダーの外のフォルダーに移動してください。例: ~/Downloadsこれはシステムフォルダーです。 ~/パスに新しいフォルダーを作成し、そこからアプリケーションを実行します。

「設定に問題があるようです。スクリプトの実行を停止してください」というエラーが表示されます。必要な環境変数がすべて定義されていることを確認してください。それらのリストは.env.exampleにあります。

私のセットアップ

このアプリケーションを、ここにある toggl.track ブラウザ拡張機能と組み合わせて使用することをお勧めします。また、アプリケーションの実行に crontab イベントを設定することをお勧めします。これにより、作業ログの同期を気にしなくなります。

PCでも同じことをしました。 Jira レポートを 2 時間ごとに送信するためにアプリを crontab にインストールしました。そのため、Jira と Toggl.track API を攻撃しませんでした。さらに、ブラウザに Toggl.track ブラウザ拡張機能をインストールし、以下の画像のように拡張機能設定で Jira サポートを有効にしました。 jira を有効にする最後に、Jira のすべてのタスクに対してタイマーを開始/停止するボタンがあり、すべての作業時間が同期されます。無料でとても便利です。