お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

Zoho Sprints で GitLab リポジトリを管理します。リポジトリを該当するプロジェクトにマッピングし、コミットやプルリクエストを作業アイテムの詳細ページに添付できます。

アクセス権限: ワークスペース担当者

GitLab アカウントの認証

1. 右上のギアアイコンをクリックします。設定ウィンドウが表示されます。
   
2. マーケットプレイスの下のその他をクリックします。
   
3. GitLabアプリで「設定する」をクリックします。
   
4. 条件に同意します。
   
5. CloudまたはSelf-Managedを選択します。
   
6. Cloudをクリックすると、GitLab.comにリダイレクトされます。
   

Self-Managedをクリックした場合、

1. 自己管理バージョンのURLとアクセストークンをコピーして貼り付け、「設定する」をクリックします。
   

  

GitLabのSelf-Managedバージョンでアカウントを設定する

1. GitLabの自己管理バージョンで、右上の「設定」に移動します。
   
2. 左側パネルのAccess Tokenに移動します。
   
3. apiとread_userのスコープを有効にし、新しいアクセストークンを作成します。
   
4. GitLabからZoho SprintsにAccess Tokenをコピー＆ペーストします。

1. My Repository: 個人リポジトリには、GitLabで管理者権限を持つすべてのリポジトリが一覧表示されます。
   

1. Workspace Repository: ワークスペースリポジトリには、個人リポジトリからマッピングされたすべてのリポジトリが表示されます。マッピング後は、プロジェクトに関連付けることができます。関連付け済みの場合、ワークスペースメンバーはクイックコマンドやワーク商品の詳細ページから、コミットやプルリクエストをワーク商品に追加・添付できます。
   

リポジトリをワークスペースリポジトリにマッピングする

1. 右上の歯車アイコンをクリックします。設定ウィンドウが表示されます。
   
2. マーケットプレイスの下にあるその他を選択します。
   
3. GitLabを選択します。
   
4. My Repositoryでリポジトリ一覧を表示します。
   
5. リポジトリ名にカーソルを合わせます。
   
6. リポジトリ名の横にある矢印アイコンをクリックし、リポジトリをワークスペースにマッピングします。
   

1つのワークスペースリポジトリには最大50件までプロジェクトを関連付けることができます。

リポジトリの課題をプロジェクトと同期する

プロジェクトをリポジトリにマッピングする際、「Issue プロジェクト」として設定することができます。これにより、リポジトリに追加された今後の課題が自動的に同期されます。

1. GitLabへ移動します。
   
2. リポジトリをワークスペースにマッピングします。
   
3. 関連付ける プロジェクトボタンをクリックします。プロジェクトリストが表示されます。
   
4. プロジェクトを選択します。
   
5. トグルをクリックしてSync Only 課題を有効にします。（1つのリポジトリに複数のプロジェクトを関連付けることは可能ですが、「Sync Only 課題」に設定できるプロジェクトは1つだけです。）
6. 更新するをクリックします。

1. GitLabで定義した見積もりポイントは、Zoho Sprintsの最も近いポイントに同期されます。
   
2. 同期されるのは課題のみで、指定されたプロジェクトに対してすべての作業商品は初期設定の作業商品の種類「BUG」で作成されます。
   
3. 作業商品のステータスは、Zoho Sprintsの「開く」と「完了済み」のステータスにマッピングされます。

Sprintsから同期される項目

件名、説明、コメント、および重さ（見積もりポイント）

1. 「Sync Only 課題」が有効なリポジトリのみが作業商品作成ウィンドウに表示されます。
2. Sprintsで定義した見積もりポイントは、GitLabの最も近いポイントに同期されます。
   
3. 作業商品のステータスは、GitLabの「開く」と「完了済み」のステータスにマッピングされます。
   

作業商品のタグ付けは、プルリクエストの「説明」項目のみでサポートされています。

形式

構文

目的

#workitem

work 商品IDを表します。

#コメント

work 商品にコメントを追加します。

#ステータス

work 商品のステータスを更新します。

#優先度

work 商品の優先度を更新します。

#時間

work 商品の作業時間を追加します。

#<プロジェクト 接頭語>- <商品 番号> 例:#SP-i30

#workitemid #コメント #コメント 例:#SP-I15 #コメント Please 共有する the final 作成 by EOD. #コメント Fix the 既存 issues and 更新する the local 作成. メモ: 1つのwork 商品に対して複数のコメントを追加できます。

#workitemid #ステータス 例 1:#SP-i20 #ステータス 完了 例 2:#SP-i20 #ステータス To_be_Tested メモ: 1. ステータス名が複数の単語で構成されている場合は、アンダースコアで区切ってください。 2. ステータスは大文字・小文字を区別しません。

#workitemid #優先度 例 1:#SP-i40 #優先度 Critical 例 2: #SP-i42 #優先度 Should_be メモ: 1. 優先度名が複数の単語で構成されている場合は、アンダースコアで区切ってください。 2. 優先度は大文字・小文字を区別しません。

#workitemid #時間 <時間>h <分>m 例:#SP-I52 #時間 5h 30m

    

• GitLab ユーザーのメールアドレスは Zoho Sprints チームに登録されている必要があります。登録されていない場合、#コメント、#時間、#ステータス、#優先度 のコミット処理ができません。
  

詳細コマンド

複数の作業商品に対する単一コマンド

構文

#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 #ステータス In_progress

どうなりますか？

work 商品にコメントが追加され、時間が記録されます。また、ステータスと優先度も更新されます。

複数の work 商品に対する複数コマンド

構文

#workitemid,#workitemid,#workitemid #コメント <メッセージ> #優先度 #時間 <>h <>m #ステータス

例

#SM-I34, #SM-I45, #SM-I54 #コメント List 出力 the requirements #優先度 高い #時間 5h 3m #ステータス In_progress

どうなりますか？

3つの work 商品すべてにコメントが追加され、時間が記録され、ステータスと優先度が更新されます。

work 商品の詳細セクションから commits を添付する

1. work商品の詳細ページへ移動します。
   
2. タブからGitLabを選択します。
   
3. 「添付する Commit」をクリックします。
   
4. 必須の詳細を入力します。* すべての項目が必須です。
   
5. 「添付する」をクリックします。
   

    

work商品の詳細セクションからpull requestsを添付する

1. work商品の詳細ページへ移動します。
   
2. タブからGitLabを選択します。
   
3. 「添付する Pull Request」をクリックします。
   
4. 必須の詳細を入力します。* すべての項目が必須です。
   
5. 「添付する」をクリックします。
   

GitLabや作業商品の詳細ページからコミットを添付すると、フィードメッセージおよび通知が作業商品担当者に送信されます。  

作業商品IDをコピーする方法

プロジェクト接頭語やIDを手動で入力するのは手間がかかります。作業商品の詳細ページから作業商品IDをコピーし、そのままコミットメッセージやプルリクエストのコメントに貼り付けてください。

コミットおよびプルリクエストの削除

作業商品の詳細ページから、コミットおよびプルリクエストを直接削除できます。添付されたコミットやプルリクエストにカーソルを合わせてクリックしてください.

コマンドの権限について

コメントの追加

• コミットで作業商品にコメントをタグ付けするには、プロジェクトの有効ユーザーである必要があります。
  
• 誰でもバックログ内の作業商品にコメントを追加できます。
  
• スプリントのメンバーであり、作業商品担当者である場合のみ、その作業商品にコメントを追加できます。
  
• 未割り当ての作業商品にもコメントを追加できます。
  

ログ時間の追加

• プロジェクトの有効ユーザーである必要があり、作業商品のログ時間を追加できます。
  
• 作業商品のログ時間は有効なスプリント内でのみ記録できます。
  
• スプリントのメンバーである必要があります。
  
• 未割り当ての作業商品および自分が担当している作業商品のみ、ログ時間を追加できます。
  

優先度の更新

• プロジェクトの有効ユーザーである必要があり、作業商品の優先度を更新できます。
  
• 作業商品の優先度を更新するには管理者、共同管理者、またはプロジェクトマネージャーである必要があります。
  
• 指定する優先度名は、プロジェクト内の既存の優先度でなければなりません。
  
• 有効および今後のスプリント、またはバックログの作業商品のみ、優先度を更新できます。
  
• 完了済みステータスの作業商品の優先度は更新できません。
  

ステータスの更新

• プロジェクトの有効ユーザーである必要があり、作業商品のステータスを更新できます。
  
• 作業商品のステータスを更新するにはスプリント担当者、担当者、管理者、マネージャー、またはスプリント作成者である必要があります。
  
• 指定するステータス名は、プロジェクト内の既存のステータスでなければなりません。
  
• 有効なスプリント内でのみ作業商品のステータスを更新できます。
  

CI/CD

GitLab用のCI/CDオプションがあります。これはマッピングされたリポジトリのみで利用可能です。すべての作成した更新がここで利用できます。パイプライン、ブランチ、そのステージやジョブを表示できます。

CI/CDでGitLabにアクセスするには：

1. Zoho Sprints にサインインします。
   
2. 左側のナビゲーションパネルで CI/CD オプションを選択します。CI/CD のタブが表示されます。
   
3. GitLab タブを選択します。
   
4. マッピングされたリポジトリを選択します。リポジトリ内のパイプラインとコミットが表示されます。
   
5. パイプラインの上にカーソルを合わせると、詳細やステージが表示されます。
   
6. リンクをクリックすると、それぞれの詳細を確認できます。

特定のコミットをクリックすると、マッピングされた作業商品の表示も可能です。

リポジトリからプロジェクトの関連付けを解除する

プロジェクトとリポジトリの関連付けは、2通りの方法で解除できます。

プロジェクトを関連付けるフォームから

1. GitLab に移動します。
2. ワークスペースリポジトリ内のプロジェクトを関連付けるボタンをクリックします。   
   
3. 「関連付けるプロジェクト」フォームで、プロジェクトの選択を解除します。
   
4. 「更新する」をクリックします。
   

ワークスペースリポジトリから直接操作する場合

1. GitLab に移動します。
2. 表示されているプロジェクト件数をクリックします。
   
3. 関連付けを解除したいプロジェクトの上にカーソルを合わせます。
   
4. 「削除するプロジェクト」をクリックします。
   

チームからリポジトリを削除する

1. 「GitLab」に移動します。
2. 「Workspace Repository」内のリポジトリ一覧を表示します。
   
3. リポジトリ名にカーソルを合わせます。
   
4. リポジトリ名の左端にある矢印アイコンをクリックして、ワークスペースからリポジトリの関連付けを解除します。
   

リポジトリをワークスペースから削除するとどうなりますか？

   

今後は GitLab やワーク商品の詳細ページから、コミットやプルリクエストをワーク商品に添付できなくなります。

GitLab認証の削除

GitLabアカウントはいつでもZoho Sprintsから削除できます。手順は以下の通りです。

1. 「GitLab」に移動します。
2. 「My repository」の下部にあるをクリックします。確認用のポップアップが表示されます。
   
3. 「削除」をクリックします。
   

認証を解除するとどうなりますか？

リポジトリがワークスペースリポジトリにマッピングされると、Webhookまたはサブスクリプションが両方のアプリケーション間で作成されます。認証が解除されると、統合は両方のアプリケーション間で停止され、すべてのマッピング済みリポジトリおよびそれに関連付けられているプロジェクトは削除されます。

ただし、Webhookまたはサブスクリプションは削除されません。認証時に作成されたWebhookまたはサブスクリプションを削除したい場合は、GitLabの設定に移動し、該当するワークスペースまたはリポジトリのWebhook作成を無効にしてください。