アクセス制御: Workspace 担当者
Githubアカウントを認証する
- 右上のギアアイコンをクリックします。設定ウィンドウが表示されます。
- マーケットプレイス内の「その他」を選択します。
- GitHubアプリの設定するをクリックします。
- 条件に承認し、認証をクリックします。
My Repository: My repositoryには、GitHubアカウントで作成されたすべてのリポジトリが表示されます。
Workspace Repository: Workspace repositoryには、個人リポジトリからマッピングされたすべてのリポジトリが表示されます。マッピング後、これらのリポジトリはプロジェクトに関連付けできます。関連付け後は、ワークスペースメンバーがクイックコマンドやワーク商品の詳細ページからコミットやプルリクエストをワーク商品に追加・添付できます。
Zoho SprintsアプリはGitHubマーケットプレイスから直接連携することも可能です。
自分のリポジトリをワークスペースリポジトリにマッピングする
- 画面右上の歯車アイコンをクリックします。
- マーケットプレイス内の「その他」を選択します。
- GitHub を選択します。
- 「MyRepository」にリポジトリの一覧が表示されます。
- リポジトリ名にカーソルを合わせます。
- リポジトリ名の横にある矢印アイコンをクリックし、ワークスペースにリポジトリをマッピングします。
プロジェクトをワークスペースリポジトリに関連付ける
ワークスペース内のプロジェクトを、マッピング済みのリポジトリと関連付けることができます。
- GitHub に移動します。
- 「Workspace Repository」でリポジトリ一覧が表示されます。
- 「プロジェクトを関連付ける」ボタンをクリックします。
- 関連付けるプロジェクトを選択します。
- 更新するをクリックします。
1つのワークスペースリポジトリには最大50件までプロジェクトを関連付けることができます。
リポジトリの課題をプロジェクトに同期する
プロジェクトをリポジトリと関連付ける際、「Issue プロジェクト」として設定できます。これにより、今後追加される課題が自動的にリポジトリから同期されます。
- GitHubに移動します。
- 「プロジェクトを関連付ける」ボタンをクリックします。
- 関連付けるプロジェクトを選択します。
- 「Sync only 課題」を有効にするため、トグルをクリックします。
- 更新するをクリックします。
複数のプロジェクトをリポジトリに関連付けることができます。ただし、「Sync Only 課題」には1つのプロジェクトのみ設定可能です。
- ワーク商品の詳細ページから直接GitHubへのリンクにアクセスできます。
- GitHubアイコンをクリックすると、課題の詳細が表示され、「GitHubで表示」をクリックしてGitHubへ移動できます。
GitHubから同期された項目
件名、説明、タグ
メモ:
- 「Sync Only 課題」にマークされたプロジェクトのみ課題が同期されるため、すべてのワーク商品は初期設定のワーク商品種類「BUG」として作成されます。
- ワーク商品のステータスは、Zoho Sprintsの「開く」と「完了済み」ステータスにマッピングされます。
SprintsからGitHubへワーク商品を同期する
Sprints を利用すると、GitHub上のデータ管理が簡単になります。Sprintsでワーク商品を作成する際、同時にGitHubにもデータを作成できます。商品作成フォームでは、特定のワーク商品をGitHubアカウントへ追加することが可能です。これによりデータが同期され、SprintsとGitHub間の連携がスムーズに行えます。
Sprintsから同期された項目
件名、説明、およびタグ
メモ:
Zoho Sprints でのクイックコマンド
リポジトリのマッピングとプロジェクトのリポジトリへの関連付けが完了すると、コミットやプルリクエストの紐付けを開始する準備が整います。対応しているコマンドは以下の通りです。
プルリクエストのコメントでは、作業商品のタグ付けのみがサポートされています。
形式
|
構文
|
目的
|
#workitem
|
#<プロジェクト 接頭語>- <商品 番号>
例: #SP-i30
|
作業商品のIDを表します。
|
#コメント
|
#workitemid #コメント #コメント
例: #SP-I15 #コメント Please 共有する the final 作成 by EOD. #コメント Fix the 既存 issues and 更新する the local 作成.
メモ:
1つの作業商品に複数のコメントを追加できます。
|
作業商品にコメントを追加します。
|
#ステータス
|
#workitemid #ステータス
例 1: #SP-i20 #ステータス 完了
例 2: #SP-i20 #ステータス To_be_Tested
メモ:
1. ステータス名が複数の単語で構成されている場合は、単語の間をアンダースコアで区切ってください。
2. ステータスは大文字・小文字を区別しません。
|
ワーク商品のステータスを更新します。
|
#優先度
|
#workitemid #優先度
例 1: #SP-i40 #優先度 Critical
例 2: #SP-i42 #優先度 Should_be
メモ:
1. 優先度 名前が複数の単語からなる場合は、アンダースコアで区切ってください。
2. 優先度は大文字・小文字を区別しません。
|
work商品 の優先度を更新します。
|
#時間
|
#workitemid #時間 <時間>h <分>m
例: #SP-I52 #時間 5h 30m
|
work商品 のログ時間を追加します。
|
- commits および pull requests を商品に添付できるのは、プロジェクトがチームにマッピング済みのリポジトリに関連付けられている場合のみです。commit を添付する対象のワーク商品は、関連付け済みプロジェクトの一部である必要があります。
- GitHub ユーザーのメールアドレスは Zoho Sprints チームに登録されている必要があります。登録されていない場合、#コメント、#時間、#ステータス、#優先度 などの commit の処理はできません。
詳細コマンド
複数のワーク商品に対する単一コマンド
構文
|
#workitemid,#workitemid,#workitemid #コメント <メッセージ>
|
例
|
#SM-I25,#SM-I42,#SM-I98 #コメント Issues are 解決済み and updated in the local 作成.
|
どうなりますか?
|
3つのワーク商品すべてにコメントが追加されます。
|
1つのワーク商品に対する複数コマンド
構文
|
#workitemid #コメント <メッセージ> #優先度 #時間 < > h < > m #ステータス
|
例
|
#SM-I34 #コメント List 出力 the requirements #優先度 高い #時間 5h 3m 20s #ステータス In_progress
|
どうなりますか?
|
ワーク商品にコメントが追加され、時間が記録されます。また、ステータスと優先度も更新されます。
|
複数のwork 商品に対する複数コマンド
構文
|
#workitemid,#workitemid,#workitemid #コメント <メッセージ> #優先度 #時間 <>h <>m #ステータス
|
例
|
#SM-I34, #SM-I45, #SM-I54 #コメント List 出力 the requirements #優先度 高い #時間 5h 3m #ステータス In_progress
|
どうなりますか?
|
3つのwork 商品すべてにコメントが追加され、時間が記録され、ステータスと優先度が更新されます。
|
work 商品の詳細セクションからcommitを添付する
- work 商品の詳細ページへ移動します。
- Githubタブを選択します。
- 添付する Commitをクリックします。
- 必須の詳細を入力します。* 全ての項目が必須です。
- 添付するをクリックします。
work 商品の詳細セクションから pull requests を添付する
- work 商品の詳細ページへ移動します。
- Githubタブを選択します。
- 添付する Pull Requestをクリックします。
- 必須の詳細を入力します。* 全ての項目が必須です。
- 添付するをクリックします。
GitHubまたはwork 商品の詳細ページからコミットを追加すると、フィードメッセージと通知がwork 商品の担当者に送信されます。
work 商品IDのコピー方法
プロジェクト接頭語やIDを手動で指定するのは難しい場合があります。work 商品の詳細ページからwork 商品IDをコピーし、コミットメッセージやプルリクエストのコメントに貼り付けることができます。
コミットおよびプルリクエストの削除
作業商品の詳細ページから、コミットおよびプルリクエストを直接削除できます。添付されたコミットやプルリクエストにカーソルを合わせ、

をクリックします。
コマンドのアクセス権
- コミット内の作業商品にコメントをタグ付けするには、有効なプロジェクトユーザーである必要があります。
- プロジェクトに所属していれば、誰でもバックログ内の作業商品にコメントを追加できます。
- スプリントのメンバーであり、かつ作業商品の担当者である必要があります。それによってコメントの追加が可能です。
- 未割り当ての作業商品にもコメントを追加できます。
作業時間の記録追加
- 作業商品の作業時間を追加するには、プロジェクトの有効ユーザーである必要があります。
- 有効なスプリント内の作業商品のみ、作業時間を記録できます。
- スプリントのメンバーである必要があります。
- 未割り当ての作業商品や、自身が担当者となっている作業商品にも作業時間を記録できます。
優先度の更新
- 作業商品の優先度を更新するには、プロジェクトの有効ユーザーである必要があります。
- 指定する優先度名は、プロジェクト内で既存の優先度でなければなりません。
- 有効または今後のスプリント、およびバックログ内の作業商品の優先度のみ更新できます。
- 作業商品の優先度を更新するには、管理者、共同管理者、またはプロジェクトマネージャーである必要があります。
- 完了済みステータスの作業商品の優先度は更新できません。
ステータスの更新
- 作業商品のステータスを更新するには、プロジェクトの有効ユーザーである必要があります。
- 指定するステータス名は、プロジェクト内の既存ステータスでなければなりません。
- 有効なスプリント内の作業商品のみステータスを更新できます。
- スプリント担当者、担当者、管理者、マネージャー、またはスプリント作成者として、作業商品のステータスを更新できます。
GitHubや作業商品の詳細ページからコミットを追加すると、該当する作業商品の担当ユーザーにフィードメッセージと通知が送信されます。
プロジェクトをリポジトリから関連解除する
プロジェクトをリポジトリから関連解除する方法は2通りあります。
「関連付け済みプロジェクト」セクションから
- GitHubおよびワークスペースリポジトリセクションへ移動します。
- 「プロジェクトを関連付ける」ボタンをクリックします。プロジェクトの一覧が表示されます。
- 「関連付けるプロジェクト」フォームで、解除したいプロジェクトの選択を外します。
- 「更新する」をクリックします。
ワークスペースリポジトリから直接
- GitHubおよびワークスペースリポジトリに移動します。
- リポジトリ横の件数をクリックします。
- 関連解除したいプロジェクトにカーソルを合わせます。
- 「プロジェクトを削除する」をクリックします。
プロジェクトをリポジトリから関連解除するとどうなりますか?
GitHubまたはZoho Sprintsの作業商品詳細セクションから、プロジェクト内の作業商品にクイックコミットやプルリクエストを添付できます。
ワークスペースからリポジトリを削除する
- GitHubに移動します。
- WorkspaceのRepositoryでリポジトリの一覧を表示します。
- リポジトリ名にカーソルを合わせます。
- リポジトリ名の左端にある矢印アイコンをクリックして、そのリポジトリをチームから解除します。
リポジトリをチームから削除した場合はどうなりますか?
以後、GitHub または作業商品の詳細ページから、コミットやプルリクエストを作業商品に添付できなくなります。
GitHubの認証を削除する
Zoho SprintsからいつでもGitHubアカウントを削除できます。手順は以下の通りです。
- GitHubに移動します。
- My Repositoryの一番下にある
をクリックします。確認のポップアップが表示されます。
- 削除をクリックします。
認証を解除するとどうなりますか?
リポジトリがWorkspace Repositoryにマッピングされると、Webhookまたはサブスクリプションが両方のアプリケーション間で作成されます。認証が解除されると、両方のアプリケーション間の連携は停止され、マッピング済みのすべてのリポジトリおよびそれらに関連付けられているプロジェクトが削除されます。
ただし、Webhookやサブスクリプション自体は削除されません。認証時に作成されたWebhookまたはサブスクリプションを削除したい場合は、GitHubの設定に移動し、該当するワークスペースのWebhookを無効にしてください。