GitLab 統合

GitLab 統合Viva Goals使用すると、GitLab プロジェクトの問題の進行状況に基づいて、目標と主要な結果 (OKR) の進行状況を自動的に更新できます。

GitLab を使用してプロジェクトを追跡し、四半期ごとに 30 個の問題を解決Viva Goals目標があるとします。 この目標を GitLab の対応するプロジェクトにリンクすると、関連するプロジェクトの問題が解決されると、OKR の状態が更新されます。 また、ユーザー中心の目標について、特定のユーザーによって処理されている問題の進行状況を追跡することもできます。 Viva Goalsは自動的に値を同期し、目標に向かって進行状況をグラフ化し、OKR を最新の状態に保ちながら時間を節約します。

すべてのユーザーと管理者がこの機能を使用できます。 管理者は、管理者ダッシュボードから統合を管理できます。

GitLab 統合を有効にする

管理者は、次の手順に従って、この統合を有効にすることができます。

  1. サイドバーで [管理] に移動し、[統合] タブを選択します。

  2. GitLab を検索するか、[データ統合] セクションで見つけます。

  3. GitLab の横にある [有効にする] を選択します。 既に接続を作成している場合は、代わりに [統合の 管理 ] オプションがあります。

    統合を無効にするには、[変更>の管理>][統合の無効化] を選択します。

GitLab を管理者としてViva Goals アカウントに接続する

  1. 管理者として統合を有効にした後、[GitLab の構成] ページから GitLab 接続を構成する 必要があります。 このページにアクセスするには、管理>Integrations に移動し、GitLab の横にある [管理] を選択します。

  2. [ 新しい接続] を選択し、GitLab アカウントにサインインします。

  3. 接続の名前を入力します。

  4. この接続を組織内の他のユーザーと共有することは任意です。 [次へ] を選択し、この統合を使用して起動して実行します。 保存した接続はいつでも編集できます。

  5. Viva Goalsを使用すると、複数のプロジェクトに接続できます。 [ 新しい接続] を選択して、別のプロジェクトからデータをフェッチします。 これらの接続は名前で区別します。 名前は、OKR と GitLab データをリンクすると、他のユーザーに表示されます。

GitLab プロジェクトを OKR に接続する

接続を構成した後、次の手順は OKR を GitLab プロジェクトにリンクすることです。

  1. OKR を作成または編集するときに、[ 進行状況と状態] ドロップダウンを開きます。 "自動更新のためにデータ ソースに接続する" というテキストのセクションで、 GitLab のアイコンを見つけて選択します。

  2. 既に接続を作成している場合、または管理者が接続を共有している場合は、その接続が自動的に選択されます。 Viva Goalsは、既に作成または共有されている接続がない場合にのみ、新しい接続を作成するように求められます。

  3. 測定の進行状況を使用する方法 ( 達成率 または KPI (成功メトリック) を選択します。 KPI を選択した場合は、メトリック、開始値、およびターゲット値を指定します。

  4. 複数の接続がある場合は、1 つを選択します。 関連付けられているすべてのプロジェクトがドロップダウンで使用できます。 [プロジェクト] を選択し、[マイルストーン] を選択します

  5. [ 割り当て 先] フィールドでエントリを選択して、特定のユーザーによって処理された問題を追跡します。 必要に応じて [ラベル] を選択します。

  6. 適切な状態を選択して、閉じたり開いたりしている問題の状態を追跡します。 このオプションは、KPI タイプの OKR にのみ適用されます。

  7. 問題 ID または Issue タイトルを入力して、問題を直接検索できます。または、[Issue]\( 問題 \) フィールドのドロップダウンから選択することもできます。 複数の問題を選択し、OKR に接続することもできます。

OKR で行われた進行状況を計算する

KPI メトリックを使用して進行状況を追跡している場合は、問題の数に基づいて OKR の進行状況が計算されます。 進捗を追跡するために達成率を使用している場合、その割合は終了した問題の数に基づいて計算されます。

各問題の下にサブタスクが追加されている場合は、サブタスクの状態にも基づいて進行状況が計算されます。 たとえば、それぞれ 2 つのサブタスクがある 2 つの問題を OKR に接続した場合、問題 1 でサブタスク 1 を閉じると、進行状況は 25% に更新されます。 後で問題 1 でサブタスク 2 を閉じると、OKR の進行状況は 50% になります。

注:

進行状況を追跡するために [完了率] を選択した場合、進行状況は終了した問題の割合に基づいてのみ計算されます。 また、開いている問題を追跡する場合は、進行状況を追跡するために KPI メトリックを選択する必要があります。

進行状況バーの次の色は、目標の状態を示しています。

  • 進行状況が任意の時点で予想される進行状況より 0 ~ 25% 少ない場合は、OKR 状態が 遅れ、進行状況バーはオレンジ色になります。

  • 進行状況が任意の時点で予想より 25% 未満の場合、OKR の状態は 危険にさらされ、進行状況バーは赤になります。

GitLab 統合を無効にする

管理者はいつでも GitLab 統合を無効にすることができます。[統合] セクションの [GitLab] に移動し、[管理] を選択します。 [GitLab 構成] ページで、[統合の無効化の変更>] を選択します

注:

Gitlab のプロジェクトが完了としてマークされていない状態で閉じられた場合、Viva Goalsはプロジェクトが終了したために完了したと見なされます。