Zoho DeskのGitHub拡張機能

Zoho DeskのGitHub拡張機能

GitHubは、開発者がプログラムのソースコードをオンライン上で作成／保存／共有するためのサービスです。プロジェクトやチームの進捗状況を管理したり、仕様書や議事録などの文書を保存したりすることもできます。Zoho DeskでGitHubの拡張機能を利用すると、Zoho Deskの問い合わせとGitHubのイシュー（課題）を関連付けて、Zoho Deskの画面から簡単に参照、管理できるようになります。

拡張機能のインストール

GitHub拡張機能は Zoho Marketplace 、またはZoho Deskアカウントからインストールできます。

Zoho Deskから拡張機能をインストールするには：
  1. 管理者権限 のあるユーザーアカウントで、Zoho Deskにログインします。
  2. 上部のバーの 設定 アイコン（ ）をクリックし、［連携］ 欄から、 ［すべて］ をクリックします。
  3. 右上の検索欄で［GitHub］を検索します。
  4. ［GitHub Extension for Zoho Desk］ を選択して、 ［無料試用を開始する］／［購入する］ をクリックし、利用規約の同意欄にチェックを入れ、次の画面に進みます。
  5. GitHub連携機能の画面の ［一般設定］ タブに移動し、Zoho Deskでこの拡張機能の利用を許可する［部門］と［権限］を選択します。

  6. 利用規約 の同意欄にチェックを入れ、 ［インストール］ をクリックします。
  7. Zappsの認証画面で、 ［認証］ → ［承諾する］ をクリックします。
  8. Zoho OAuthの認証画面で、 ［認証］ → ［承諾する］ をクリックします。

  9. GitHubの認証画面で、 ［認証］ をクリックし、GitHubの認証情報を入力して認証を行います。
  10. ［設定］ タブに移動し、 ［githuborgname］ にGitHubの組織名を入力します。
  11. ［保存］ をクリックします。

インストール完了後は、問い合わせの詳細画面の右側のパネルから拡張機能を利用できます。

問い合わせへのイシュー（課題）の関連付け

GitHubの拡張機能では、GitHubの既存のイシューをZoho Deskの問い合わせに関連付けることが可能です。1つの問い合わせに対して、複数のイシューを関連付けることもできます。

イシュー（課題）を関連付けるには：
  1. ［問い合わせ］ タブに移動します。
  2. イシューを関連付けたい問い合わせをクリックします。
  3. GitHubのリポジトリ（保存場所）の設定画面が表示されます。
  4. ［Ok］ をクリックします。

  5. 選択リストから関連付けたいリポジトリを選択します。
  6. ［Save Changes］ （変更を保存する）をクリックします。

  7. 検索欄で対象のイシューを検索します。キーワードに合致するイシューが取得され、一覧表示されます。

  8. 必要に応じて、イシューに追加するラベルを選択します。

  9. ［Link issue］ （イシューを関連付ける）をクリックします。
    イシューが問い合わせと関連付けられます。また、関連付けに関する情報がコメントとして追加されます。

問い合わせにおけるイシュー（課題）管理

この拡張機能によって、Zoho Deskの画面から、問い合わせに関連する新しいイシューを作成できます。また、イシューと問い合わせとの関連付けを追加／削除することもできます。Zoho Deskで作成されたイシューはGitHubにも追加されます。一方、Zoho Deskでイシューを削除した場合、対象のイシューはGitHubから削除されません。

イシュー（課題）を作成するには：
  1. ［問い合わせ］ タブに移動します。
  2. イシューを作成したい問い合わせをクリックします。
  3. #［create issue］（イシューを作成する）アイコンをクリックします。
  4. 標準の ［GitHub repository］ （GitHubのリポジトリ）が表示されます。
  5. ［Issue Title］ （イシューの件名）を入力します。

  6. 問い合わせの ［Description］ （説明）を入力します。
  7. ［Issue Labels］ （イシューのラベル）を追加します。
  8. イシューの担当者を追加します。
  9. ［Submit］ （送信する）をクリックします。
    イシューが作成され、問い合わせに関連付けられます。説明は、コメントとして表示されます。

イシュー（課題）を関連付けるには：
  1. ［問い合わせ］ タブに移動します。
  2. イシューを関連付けたい問い合わせをクリックします。
  3. GitHub拡張機能の画面で リンク のアイコンをクリックします。

  4. 問い合わせに関連付けたいイシューを選択します。
  5. 必要に応じて、イシューに追加するラベルを選択します。
  6. ［Link issue］ （イシューを関連付ける）をクリックします。
    イシューが問い合わせと関連付けられます。また、関連付けに関する情報がコメントとして追加されます。

イシュー（課題）を削除するには：
  1. ［問い合わせ］ タブに移動します。
  2. イシューを削除したい問い合わせをクリックします。
  3. GitHub拡張機能の画面で編集アイコン（ ）をクリックします。
    問い合わせに関連付けられたイシューが一覧表示されます。

  4. イシューの件名の隣に表示されている ［Remove］ （削除する）をクリックします。
  5. ［Confirm］ （確定する）をクリックします。

拡張機能の設定管理

［設定］タブから、拡張機能の設定を管理できます。拡張機能の設定を管理するには、以下の手順を実行します。
  1. ウィジェットで設定アイコン（ ）をクリックします。
  2. ［Create Desk Ticket Comments］ （問い合わせのコメントの作成）では、問い合わせに対してコメントを追加する条件を選択します。また、各条件に基づいて追加されたコメントの公開／非公開の設定を選択します。
  3. ［Choose which list sections user can see］ （ユーザーが表示できるセクションの選択）では、ユーザーに対して表示したいセクションを選択します（コミット／関連ファイル／イシュー）。
  4. ［Display linked issue］ （関連イシューの表示項目）では、ウィジェット内でイシューを一覧表示する際に表示する項目を選択します。
  5. ［Save Changes］ （変更を保存する）をクリックします。

Notes
メモ： イシューに関するコミット（保存）ファイルの情報を表示するには、コミットの件名を以下の形式で入力する必要があります。
                   zd#<Deskの問い合わせの番号> <コミット名> (例：zd#577 commit 1)

拡張機能のアンインストール

  1. 上部のバーの 設定 アイコン（ ）をクリックし、［連携］ 欄から ［すべて］ をクリックします。
  2. マーケットプレイス の画面で、 ［インストール済みの拡張機能］ タブをクリックします。
  3. 拡張機能の一覧から、 ［GitHub Extension for Zoho Desk］ を選択します。
  4. ［GitHub Extension for Zoho Desk］ の設定画面で、右上の 三点マーク のアイコン（ ）をクリックします。
  5. ［拡張機能をアンインストールする］ を選択します。
  6. 確認画面で ［確定する］ をクリックします。