このページを共有

# ALM同期の準備

ALM OctaneとALMの間でレコードを同期するには、同期要件とともに、一方のエンドポイントのデータを、もう一方のエンドポイントでサポートされているフィールドに合わせて調整する必要があります。

たとえば、ALM Octaneの不具合をフィーチャーに関連付けることもできます。このフィールドを同期するには、ALMで対応するユーザー定義フィールドを作成する必要があります。

ALM Octaneでは、ユーザーストーリーは、フィーチャーとエピックの下の階層によく並べられています。これらのレコードとその階層をALMと同期するには、対応する要件タイプの階層を作成する必要があります。

このトピックの内容:

## オプション: 両方のエンドポイントでの、対応するIDフィールドの作成

両方のエンドポイントに、他方のエンドポイントのレコードIDを表すユーザー定義フィールドまたはカスタムフィールドを作成することをお勧めします。これらのフィールドは、数値フィールドとして定義します。

- ALMで、ALM Octane IDという名前のフィールドを作成します。

- ALM Octaneで、ALMまたはQC IDという名前のフィールドを作成します。

後で、これらの対応するフィールドをリンクの [Field Mapping (フィールドマッピング)] タブでマッピングします。詳細については、フィールドマッピングの編集を参照してください。

トップに戻る

## 要件またはリリースのサブセットの作成

標準設定では、ALM Octane Synchronizerは以下を同期します。

- ALMの [要件] ルートフォルダー全体 (サブフォルダーを含む)。

- ALMの [リリース] ルートフォルダー内 (サブフォルダーを含む) の現在の (終了日を過ぎていない) すべてのリリース。

ALMプロジェクト内の要件またはリリースのサブセットのみを同期するには、同期リンクの代替ルートフォルダーを指定できます。

注: お気に入りと代替ルートフォルダーの両方を使用する場合、Synchronizerではお気に入りの前に代替ルートフォルダーが考慮されます。

ALMプロジェクトのツリーで、同期する要件またはリリースのみを含むサブフォルダーを作成します。このサブフォルダーには、追加のサブフォルダーを含めることもできます。

代替ルートフォルダーの例

下の図の内容を説明します。

- ALM Octane ワークスペース1のユーザーストーリーが、[要件] フォルダーではなく、ALMのAG_Project1フォルダーの要件に同期されます。

- ALM Octane ワークスペース2のユーザーストーリーが、[要件] フォルダーではなく、ALM AG_Project2フォルダーの要件に同期されます。

- どちらのALMプロジェクトでも、[要件] フォルダー内の他のフォルダーはALM Octane Synchronizerによって無視されます。AG_ProjectXフォルダーの下に追加のサブフォルダーがある場合、その中にあるマッピングされた要件タイプはすべて同期されます。

- 同様に、リリース用の代替ルートフォルダーをセットアップすることもできます。

同期リンクでの代替ルートフォルダーの定義の詳細については、オプション (ALMのみ): 代替ルートフォルダーの定義 (バックログおよびリリースリンク)を参照してください。

トップに戻る

## ALMでの、ALM Octaneに一致する要件タイプの準備 (要件の同期)

ALM Octaneのエピック、フィーチャー、およびユーザーストーリーを表すALMの要件タイプを決定し、それらをALM Octane内のものと一致する階層に並べます。

ALMとALM Octane階層を一致させるためのルール

- ALMの1つ以上の要件タイプをALM Octaneの各タイプ (ユーザーストーリー、フィーチャー) にマッピングできます。
- ALM OctaneのエピックにマッピングできるALMの要件タイプは1つだけです。

- マッピングしないALM要件タイプの要件は、同期されません。

- ALM Octaneの品質ストーリーは同期されません。

- ALMの階層がALM Octaneの階層と一致しない場合、Synchronizerは、要件をALM Octaneのバックログツリーのルートに直接同期させることができます。これは、エピックやユーザーストーリーにマッピングされた要件にのみ関係します。詳細については、オプション: 階層がバックログツリーと一致しない要件の処理方法の指定 (バックログリンク) を参照してください。

- 次の場合には、同期でエラーが発生する可能性があります。

  - 要件タイプ (エピック、フィーチャー、ユーザーストーリー) の中にマッピングされていないものがある場合。

  - 同期対象の要件が、ALM階層内の正しい場所にない場合。たとえば、フィーチャー要件が、ALM要件ツリーのユーザーストーリー要件の下にある場合です。

  - 同期後に要件タイプを変更した場合。

ALMで要件階層を作成するには

1. 必要な場合は、ALMのカスタマイズで、ユーザー定義の要件タイプを新たに作成します。

   注: [フォルダ] タイプの要件を階層に含めることができます。これらは要件のサブフォルダーとみなされます。[フォルダ] タイプの要件は同期されませんが、それらに含まれる要件は同期されます。

   使用する階層をシンプルにするために、次の方法をお勧めします。

   - ALMに標準付属の [ビジネス] 要件タイプを使用して、エピックを表します。

   - ALMに標準付属の [フィーチャー] 要件タイプを使用して、フィーチャーを表します。

   - ALM内でユーザーストーリーを表す、新しい [ユーザーストーリー] 要件タイプを作成します。

2. 最大3階層 (エピック、フィーチャー、ユーザーストーリー) の要件ツリーを作成または変更します。

   - エピックと同期する要件は、階層の最上位になければなりません。

   - フィーチャーと同期する要件は、エピックの下になければなりません。

   - ユーザーストーリーと同期する要件は、フィーチャーの下または最上位に置くことはできますが、エピックの下に置くことはできません。

   同期の間、ALM Octane Synchronizerにより階層が保持されます。

   この3階層は、任意の要件フォルダーまたはサブフォルダーに格納できます。ALM Octaneでは、同期ツリーはバックログのルートの下に格納されます。

要件階層の例

要件タイプのマッピング:

- ALMグループ要件 >> ALM Octaneエピック。
- ALMフィーチャー要件 >> ALM Octaneフィーチャー。
- ALMのパフォーマンスおよびテスト要件 >> ALM Octaneのユーザーストーリー

同期後:

- ALM Octaneでは、要件「ALM Group 001 (epic)」と「ALM Group 002 (epic)」は、ALM Octaneのバックログツリーのルートの下に、2つの兄弟エピックとして作成されます。

- 要件「ALM Functional 002 (feature)」は、エピック「ALM Group 002 (epic)」の下にフィーチャーとして作成されます。

- 要件「ALM Testing 002 (userstory)」は、フィーチャー「ALM Functional 002 (feature)」の下にユーザーストーリーとして作成されます。

- 要件「ALM Performance 002 (userstory 2nd)」は、ALM Octaneのバックログツリーのルートの下にユーザーストーリーとして作成されます。

トップに戻る

## 両方のエンドポイントにすでに存在しているリリースのチェック (リリース同期)

ALMとALM Octaneの両方に、同じ名前のリリースまたはスプリント/サイクルが定義されているかどうかを確認してください。定義されている場合は、リリース同期リンクで、[Map pairs of new releases and sprints/cycles with identical names (同名の新規リリースまたはスプリント/サイクルのペアをマッピングする)] オプションを選択することをお勧めします。

優先エンドポイントのデータがすべてのリリースエンティティで使用され、他方のエンドポイントのデータをオーバーライドします。

このオプションを選択する理由

同じ名前を持つリリースまたはスプリントのペアが検出され、これらがマッピングされていない場合は、リリースまたはスプリントはまったく同期されず、実行レポートに "duplicate entities" エラーが生成されます。

これは、ALM Octane Synchronizerがリリースを新しいレコードと見なし、宛先エンドポイントで作成しようとするからです。

宛先エンドポイントには、同じ名前のリリースまたはスプリント/サイクルがすでに存在するため、同期は失敗します。

いずれかのリリースまたはスプリントの名前を後で変更すれば、重複が発生しないため、ALM Octane Synchronizerはそのリリースを宛先エンドポイントで再作成します。

マッピングオプションは現在のリリースに限定

マッピング時には、ALM Octane Synchronizerは、同期対象時間フレームに含まれているリリースのみをチェックします。同一の名前を持つリリースまたはスプリント/サイクルは、それらが過去のリリース (またはその終了日が同期用に指定した日付より古いリリース) にある場合、マッピングされません。

過去のリリースの同期の詳細については、過去のリリースの同期を参照してください。

例:

条件 | 結果
--- | ---
`Release_1.3`という名前の現在のALMリリースと、`Release_1.3`という名前の現在のALM Octaneリリースがある ALM Octaneをリリースリンクフィールドの優先エンドポイントとして定義している ([Field Mapping (フィールドマッピング)] タブ) [ルール] タブで [Map pairs of new releases or sprints found with identical names (同名の新規リリースまたはスプリントのペアのマッピング)] オプションを選択している | 2つのリリースがマッピングされます。 ALMリリース`Release_1.3`のすべてのデータがALM Octaneリリース`Release_1.3`のデータで上書きされます。
次のリリースがある: 終了日が2017年7月20日の`Release_1.3`という名前のALMリリース 終了日が2017年7月30日の`Release_1.3`という名前のALM Octaneリリース ALM Octaneをリリースリンクフィールドの優先エンドポイントとして定義している ([Field Mapping (フィールドマッピング)] タブ) 次のオプションを選択している。Synchronize past releases.End date can be this date or later (過去のリリースを同期します。終了日は次の日付以降です) : `2017年7月25日` [ルール] タブで [Map pairs of new releases or sprints found with identical names (同名の新規リリースまたはスプリントのペアのマッピング)] オプションを選択している。 | ALMリリースが古すぎるため、マッピングの対象にはなりません。 ただし、ALMに対する`Release_1.3`の同期は、ALM上にすでに名前が存在しているリリースを作成しようとするため、失敗します。

トップに戻る

## ALMでのフィールドの作成または変更

ALMで、次の表にあるフィールドを変更します。ALMフィールドがまだに存在していない場合は、ALM Octaneで、このデータに対応するユーザー定義フィールドを作成します。リンク設定後のフィールドのマッピングの詳細については、フィールドマッピングの編集を参照してください。

フィールド名 | 説明
--- | ---
アプリケーションモジュール | ルックアップリストフィールドとして定義します。 ALMで [複数値の選択を可能にする] を設定し、この値を検証しないようにします。 ヒント: または、リンクの編集時に、ALM Octaneの [アプリケーションモジュール] フィールドをALMの [製品] フィールドにマッピングします。
所有者 | ユーザーリストフィールドとして定義します。
ブロック | 文字列フィールドとして定義します。
フィーチャー | ルックアップリストフィールドとして定義します。 この値をALMで検証しないように設定します。
ランク | 数値フィールドとして定義します。
ストーリーポイント | 数値フィールドとして定義します。
フェーズ | ルックアップリストフィールドとして定義します。 この値をALMで検証しないように設定します。
チーム | ルックアップリストフィールドとして定義します。 この値をALMで検証しないように設定します。
エピック | ルックアップリストフィールドとして定義します。 この値をALMで検証しないように設定します。 注: フィーチャーとして同期する要件には必須です。

ヒント: 追加のユーザー定義フィールドを作成して、ALMで直接作成されたエンティティと、ALM Octaneから同期された不具合を区別できます。

これを行うには、ALMで [作成方法] という名前のフィールドを作成します。後で、フィールドをマッピングするときに、「ALM Octane Synchronizerにより作成」という定数値を割り当てます。定数値の割り当ての詳細については、フィールドマッピングの編集を参照してください。

トップに戻る

## ALMバージョン管理

バージョン管理を使用するALMプロジェクトと同期する場合、ALM Octane Synchronizerには、バージョン管理ルールが適用されます。同期プロセスによって行われる変更は、次のコメント付きでチェックインされます。`Modified by Synchronizer`

同期の間、ALM Octaneは、指定したALMユーザーの資格情報を使用してALMに接続します。

- そのユーザーがチェックアウトしたエンティティを同期する場合、そのエンティティは更新され、チェックインされます。

- 別のユーザーがチェックアウトしたエンティティを同期する場合、ALMエンティティは変更されません。

  - 同期がALM Octane側で制御されている場合、ALM上のエンティティがロックされるため、同期エラーが発生します。

  - 同期がALM側で制御されている場合、ALM Octaneエンティティは、上の最後にチェックインされたALMバージョンに基づいて更新されます。

トップに戻る

## 注意事項と制限事項

- エピックやフィーチャーの名前は、ALMとALM Octaneとの両方で一意である必要があります。また、チームの名前はALMで一意である必要があります。要件名が同じ親の下にある場合、要件名はALMで一意である必要があります。同期中に重複した値が検出された場合、その関連レコードは同期されません。

- ALM Octaneでは、レコードをフィーチャーに割り当てた場合、エピックも定義する必要があります。フィーチャーを同期する場合、エピックも同期する必要があります。このため、フィーチャーフィールドとエピックフィールドをマッピングする場合は、同期でエラーが発生しないように、それらのフィールドをALMで必須フィールドに設定することをお勧めします。

- Synchronizerは、画像タグを含むMEMOフィールドの同期をサポートしていません。このようなエンティティを同期できるようにする場合は、共有スペースパラメーターMEMO_FIELD_IMAGE_VALIDATIONをfalseに設定する必要があります。

- 添付ファイル名で特殊文字 (`~!@#$%()^&`) は使用しないようにしてください。同期中に予期しない動作を発生させる可能性があるためです。

- ALM OctaneからALMに同期する場合、行の高さは無視されます。ALMで説明を更新して同期を再度実行すると、行の高さはALM Octaneでも保持されません。

トップに戻る

参照情報:

- Synchronizer管理者ユーザーの定義
- 同期の準備

https://admhelp.microfocus.com ALM Octane 8942
検索結果を改善するためのヒント... ALM Octaneヘルプセンター ALM Octaneヘルプ 15.1.90 すべて ローカルヘルプセンターを表示 オンラインヘルプセンターを表示 戻る ブラウザーの履歴内を戻る 進む ブラウザーの履歴内を進む 検索のハイライトを削除する 次のトピック 次のトピックに進む 前のトピック 前のトピックに戻る 現在のトピックを印刷 バージョン: