imawork
つなぎ方ガイド

GitHubのつなぎ方

自分の担当Issue・レビュー依頼を集める個人連携と、選んだリポジトリをワークスペースに集める連携があります。

個人連携

担当のIssue・レビュー依頼を集める

自分に割り当てられたIssueとレビュー依頼のPRを、全org・全リポ横断で「やること」に集めます。 リポジトリを1つずつ指定する必要はありません。

  1. 1
    「設定」を開き、「連携」を選ぶ (URL: 設定 > 連携)。
  2. 2
    連携一覧から「GitHub」のカードを選ぶ。
  3. 3
    「GitHubで接続」ボタンを押す。GitHubの認可画面で「承認」すると接続完了。
  4. 4
    GitHubユーザー名を申告する欄が表示されるので、自分のGitHubユーザー名を入力して保存する。 このユーザー名が、担当Issueを自分の「やること」に届けるための紐付けキーになる。
  • 個人の公開リポは自動で取り込まれますが、組織のプライベートリポは、その組織側の承認(Grant)が一度だけ必要です。連携カードの案内から、GitHubの「接続済みアプリ」設定でOrganization accessを承認できます。
  • 担当ではないIssueや、リポジトリ丸ごとの取り込みはこの個人連携には含まれません。チーム全体で集めたい場合はワークスペース連携を使います。
  • GitHub側が正で、読み取り専用です。GitHubでcloseすると、imawork側でも自動で完了になります。

ワークスペース連携

選んだリポジトリをワークスペースに集める

担当関係なく、選んだリポジトリのIssueをこのワークスペースへ集めます。GitHub側の変更は数秒で反映されます(読み取り専用)。

  1. 1
    ワークスペースの「設定」を開き、「連携」へ進む (URL: ワークスペースの設定 > 連携)。
  2. 2
    連携一覧から「GitHub」のカードを選び、「GitHub Appをインストール」ボタンを押す。GitHubの画面に移るので、 組織(または個人アカウント)と、このワークスペースに集めたいリポジトリをそこで選ぶ。
  3. 3
    imaworkに戻ると、接続した組織ごとにリポジトリの一覧が表示される。 取り込みたいリポジトリをオンにすると、そのリポのIssueが取り込まれ始める。
  4. 4
    複数の組織を接続したい場合は、同じ画面の「組織を追加」から 検知済みの未接続組織を追加できる。見られるリポジトリの範囲を変えたい場合は、 組織セクションの「見られるリポジトリをGitHubで変更」からGitHub側の設定を開く。
  • 取り込まれるのは選んだリポジトリのIssueで、担当者は問いません。
  • 組織のポリシーでGitHub Appを承認できない場合は、連携カードに代替のOAuth接続手段が案内されます。
  • GitHub側が正で、読み取り専用です。GitHubでcloseすると、imawork側でも自動で完了になります。
  • 組織をワークスペースから外しても、これまで取り込んだタスクは残ります。GitHub側のAppインストールもそのまま残ります。

他のサービスのつなぎ方はつなぎ方ガイド一覧へ。