GitLab連携

GitLab連携

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

Zoho SprintsでGitLabリポジトリを管理できます。リポジトリを関連するプロジェクトに関連付け、作業項目の詳細ページでコミットやプルリクエストを添付できます。

Info
アクセス権限:ワークスペースの所有者がGitLabアカウントを認証
  1. 右上の歯車アイコンをクリックします。設定画面が表示されます。
  2. [マーケットプレイス]の下の[その他]をクリックします。
  3. GitLabアプリで[設定]をクリックします。
  4. 規約に同意します。
  5. [クラウド]または[セルフマネージド]を選択します。
  6. [クラウド]をクリックすると、GitLab.comにリダイレクトされます。
[セルフマネージド]をクリックした場合は、セルフマネージド版からURLとアクセストークンをコピーして貼り付け、[設定]をクリックします。

GitLabのセルフマネージド版からのアカウント設定

  1. GitLabのセルフマネージド版で、右上の[設定]に移動します。
  2. 左側のパネルで[アクセストークン]に移動します。
  3. apiとread_userのスコープを有効にして、新しいアクセストークンを作成します。
  4. GitLabからZoho Sprintsにアクセストークンをコピーして貼り付けます。

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

ワークスペースリポジトリ:ワークスペースリポジトリには、個人リポジトリから関連付けられたすべてのリポジトリが一覧表示されます。関連付けると、これらのリポジトリをプロジェクトに関連付けることができます。関連付け後、ワークスペースのメンバーは、クイックコマンドまたは作業項目の詳細ページから、コミットやプルリクエストを作業項目に追加または添付できます。

リポジトリのワークスペースリポジトリへの関連付け

  1. 右上の歯車アイコンをクリックします。設定画面が表示されます。
  2. [マーケットプレイス]の下の[その他]を選択します。
  3. [GitLab]を選択します。

マイリポジトリでのリポジトリ一覧の表示

  1. リポジトリ名にカーソルを合わせます。
  2. リポジトリ名の横にある矢印アイコンをクリックして、リポジトリをワークスペースに関連付けます。

プロジェクトのワークスペースリポジトリへの関連付け

プロジェクトをワークスペースリポジトリに関連付けることができます。

  1. GitLabに移動します。
  2. ワークスペースリポジトリ内のリポジトリ一覧を表示します。
  3. [プロジェクトの関連付け]ボタンをクリックします。プロジェクトの一覧が表示されます。
  4. プロジェクトを選択し、[更新]をクリックします。
1つのワークスペースリポジトリに関連付けられるプロジェクトは50件までです。

リポジトリの課題のプロジェクトへの同期

プロジェクトをリポジトリに関連付ける際に、「課題プロジェクト」として指定できます。これにより、リポジトリに今後追加されるすべての課題が自動的に同期されます。

  1. GitLabに移動します。
  2. リポジトリをワークスペースに関連付けます。
  3. [プロジェクトの関連付け]ボタンをクリックします。プロジェクトの一覧が表示されます。
  4. プロジェクトを選択します。
  5. トグルスイッチをクリックして、[バグのみ同期]を有効にします。(複数のプロジェクトをリポジトリに関連付けることができます。ただし、[バグのみ同期]に指定できるプロジェクトは1件のみです。)
  6. [更新]をクリックします。
GitLabで定義した見積もりポイントは、Zoho Sprintsで最も近いポイントに同期されます。

指定したプロジェクトにはバグのみが同期されるため、すべての作業項目は初期設定の作業項目タイプ「BUG」で作成されます。

作業項目のステータスは、Zoho Sprintsのオープンとクローズのステータスに対応付けられます。

作業項目のGitLabリポジトリへの同期

Sprintsで作業項目を作成する際に、GitLabにも同時にデータを作成できます。項目の作成画面では、その作業項目をGitLabアカウントに追加できます。これによりデータが同期され、Sprintsとの間で連携できます。

項目の双方向同期

  1. タイトル
  2. 説明
  3. コメント
  4. 重み(見積もりポイント)
  5. 開始日
  6. 終了日
  7. 担当者
Notes
  1. [バグのみ同期]が有効になっているリポジトリのみが、項目の作成画面に表示されます。
  2. Sprintsで定義した見積もりポイントは、GitLabで最も近いポイントに同期されます。
  3. 作業項目のステータスは、GitLabのオープンとクローズのステータスに対応付けられます。

Zoho Sprintsのクイックコマンド

リポジトリの関連付けと、リポジトリへのプロジェクトの関連付けが完了すると、コミットやプルリクエストを添付できるようになります。サポートされているコマンドは次のとおりです。

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

構文 
目的
#workitem #<Project Prefix>- <i/I><Item number>
例:#SP-i30
作業項目IDを表します。
#comment #workitemid #comment <message1> #comment <message2>
例:#SP-I15 #comment 本日中に最終ビルドを共有してください。 #comment 既存の課題を修正し、ローカルビルドを更新してください。

メモ
1つの作業項目に複数のコメントを追加できます。
作業項目にコメントを追加します。
#status #workitemid #status <status_name>
例1:#SP-i20 #status Done
例2:#SP-i20 #status To_be_Tested

メモ
1. ステータス名が複数の単語で構成される場合は、アンダースコアで区切ります。
2. ステータスでは大文字と小文字は区別されません。
作業項目のステータスを更新します。
#priority #workitemid #priority <priority_name>
例1:#SP-i40 #priority Critical
例2:#SP-i42 #priority Should_be

メモ
1. 優先度名が複数の単語で構成される場合は、アンダースコアで区切ります。
2. 優先度では大文字と小文字は区別されません。
作業項目の優先度を更新します。
#time #workitemid #time <hours>h <minutes>m
例:#SP-I52 #time 5h 30m
作業項目に作業時間を記録します。

Notes
GitLabユーザーのメールアドレスがZoho Sprintsチームに登録されている必要があります。登録されている場合にのみ、#comment、#time、#status、#priorityのコミットを処理できます。

高度なコマンド

複数の作業項目に対する単一コマンド

構文
実行結果
#workitemid,#workitemid,#workitemid #comment <message>
#SM-I25,#SM-I42,#SM-I98 #comment 課題は解決され、ローカルビルドで更新されました。
3つすべての作業項目にコメントが追加されます。

1つの作業項目に対する複数のコマンド

構文 実行される内容
#workitemid #comment <message> #priority <priority_name> #time < > h < > m #status <status_name> #SM-I34 #comment 要件を一覧化 #priority High #time 5h 3m #status In_progress

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


複数の作業項目に対する複数のコマンド

構文 実行される内容
#workitemid,#workitemid,#workitemid #comment <message> #priority <priority_name> #time <>h <>m #status <status_name> #SM-I34, #SM-I45, #SM-I54 #comment 要件を一覧化 #priority High #time 5h 3m #status In_progress

3件すべての作業項目にコメントと記録時間が追加され、ステータスと優先度が更新されます。


作業項目の詳細セクションからのコミットの添付

  1. 作業項目の詳細ページに移動します。
  2. タブから[GitLab]を選択します。
  3. [コミットを添付]をクリックします。
  4. 必要な詳細を入力します。* すべての項目が必須です。
  5. [添付]をクリックします。

作業項目の詳細セクションからのプルリクエストの添付

  1. 作業項目の詳細ページに移動します。
  2. タブから[GitLab]を選択します。
  3. [プルリクエストを添付]をクリックします。
  4. 必要な詳細を入力します。* すべての項目が必須です。
  5. [添付]をクリックします。
GitLab経由または作業項目の詳細ページからコミットを添付すると、作業項目の担当者にフィードメッセージと通知が送信されます。

作業項目IDのコピー方法

プロジェクトの接頭辞とIDを手動で指定するのは手間がかかります。作業項目の詳細ページから作業項目IDをコピーし、コミットメッセージやプルリクエストのコメントに貼り付けることができます。

コミットとプルリクエストの削除

作業項目の詳細ページからコミットとプルリクエストを直接削除できます。添付されたコミットとプルリクエストにカーソルを合わせ、をクリックします。

コマンドのアクセス権限

コメントの追加

  1. コミット内で作業項目にコメントを追加するには、プロジェクトの有効なユーザーである必要があります。
  2. バックログ内の作業項目には、誰でもコメントを追加できます。
  3. コメントを追加するには、スプリントのメンバーであり、その作業項目が自分に割り当てられている必要があります。
  4. 未割り当ての作業項目にもコメントを追加できます。

記録時間の追加

  1. 作業項目に記録時間を追加するには、プロジェクトの有効なユーザーである必要があります。
  2. 作業項目の時間を記録できるのは、進行中のスプリント内のみです。
  3. スプリントのメンバーである必要があります。
  4. 記録時間を追加できるのは、未割り当ての作業項目と、自分に割り当てられている作業項目のみです。

優先度の更新

  1. 作業項目の優先度を更新するには、プロジェクトの有効なユーザーである必要があります。
  2. 作業項目の優先度を更新するには、管理者、共同管理者、またはプロジェクトマネージャーである必要があります。
  3. 指定する優先度名は、プロジェクト内に存在する優先度である必要があります。
  4. 作業項目の優先度を更新できるのは、進行中のスプリント、今後のスプリント、またはバックログ内の作業項目のみです。
  5. 作業項目がクローズステータスの場合、その優先度は更新できません。

ステータスの更新

  1. 作業項目のステータスを更新するには、プロジェクトの有効なユーザーである必要があります。
  2. 作業項目のステータスを更新するには、スプリント所有者、担当者、管理者、マネージャー、またはスプリント作成者である必要があります。
  3. 指定するステータス名は、プロジェクト内に存在するステータスである必要があります。
  4. 作業項目のステータスを更新できるのは、進行中のスプリント内のみです。

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. ワークスペースリポジトリーのリポジトリー一覧を表示します。
  3. リポジトリー名にカーソルを合わせます。
  4. リポジトリーとワークスペースの関連付けを解除するには、リポジトリー名の左端にある矢印アイコンをクリックします。

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

GitLab経由でも、作業項目の詳細ページから直接でも、作業項目にコミットやプルリクエストを添付できなくなります。

GitLab認証の削除
GitLabアカウントは、Zoho Sprintsからいつでも削除できます。手順は次のとおりです。
  1. [GitLab]に移動します。
  2. 自分のリポジトリーの下部をクリックします。確認ポップアップが表示されます。
  3. [削除]をクリックします。

認証を削除するとどうなりますか?

リポジトリーをワークスペースリポジトリーに関連付けると、両方のアプリケーション間にWebhookまたはサブスクリプションが作成されます。認証を削除すると、両方のアプリケーション間の連携が停止し、関連付け済みのすべてのリポジトリーとそれに関連するプロジェクトが削除されます。

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








              Zoho Campaigns Resources

                Zoho WorkDrive Resources




                  • Desk Community Learning Series


                  • Digest


                  • Functions


                  • Meetups


                  • Kbase


                  • Resources


                  • Glossary


                  • Desk Marketplace


                  • MVP Corner


                  • Word of the Day


                  • Ask the Experts









                                  Resources

                                  Videos

                                  Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                  eBooks

                                  Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                  Webinars

                                  Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                  CRM Tips

                                  Make the most of Zoho CRM with these useful tips.