ユーザーリストフィールドのマッピング

ALM OctaneとALMまたはJiraでは、ユーザーリストフィールドのリストが個別に管理されています ([所有者] フィールドなど)。

これらのリスト内のユーザーは、エンドポイントの各ペアに対して一度にマッピングされます。つまり、要件リンクの作成時にALM OctaneワークスペースとALMまたはJiraプロジェクト間でユーザーをマッピングした場合、同じ2つのエンドポイント間で不具合リンクを作成する場合にも、同じマッピングが使用されます。

手動または自動マッピング方法に基づいて、マッピングされたユーザーがALM Octane Synchronizerで認識される仕組みを次のフローチャートに示します。

自動ユーザーマッピング

ALMまたはJiraユーザーに設定されている電子メールアドレスが、ALM Octaneへのログインに使用するユーザーの電子メールアドレスと同じ場合、すべてのユーザーリストフィールドでユーザーが自動的にマッピングされます。

ユーザーに複数の電子メールアドレスがALMまたはJiraで定義されている場合、ALM Octaneと同期されるのは最初の電子メールアドレスに限定されます。

ALM Octaneユーザーリストに、ALMまたはJiraユーザーに一致するユーザーが含まれていない場合、次のようになります。

  1. ALM Octaneエンドポイントに対してDefault user (標準設定のユーザー) を定義した場合、このユーザーはALMまたはJiraユーザーにマッピングされます。

  2. 標準設定が定義されていない場合、同期は失敗します。このALMまたはJiraユーザーを既存のALM Octaneユーザーに手動でマッピングするか、またはALMまたはJiraで定義された電子メールアドレスを使用して新しいユーザー (アクティブまたは非アクティブ) を作成できます。ALM Octaneでのユーザーの追加とアクティブ化の詳細については、ロールと権限の割り当てを参照してください。

    完了したら、同期を再実行します。

手動ユーザーマッピング

ALMまたはJiraユーザーとALM Octaneユーザーの電子メールアドレスが異なる場合や、ALMまたはJiraユーザーに電子メールアドレスが指定されていない場合、手動でマッピングします。

  1. [Link Configuration (リンク設定)] ページで、リンクを選択してユーザーマッピングを編集します。[Link Configuration (リンク設定)] ページを開く方法

    [More Actions (その他のアクション)] メニューから [More Actions (その他のアクション)] > [Edit User Mapping (ユーザーマッピングの編集)] を選択します。
    ユーザーリストフィールドから

    [Field Mapping (フィールドマッピング)] タブで、ユーザーリストフィールドを選択します ([Assigned To (責任者)] など)。選択したフィールドは、もう一方のエンドポイントのユーザーリストフィールドにマッピングする必要があります。

    右側で、[User Mapping (ユーザーマッピング)] ノードを展開して、[edit (編集)] をクリックします。

    [User Mapping (ユーザーマッピング)] ダイアログボックスには、手動マッピングされたユーザーのみが表示されます。自動マッピングされたユーザーは表示されません。

    ヒント:  

    • 定期的にこのダイアログボックスの上部にある [Refresh (更新)] ボタンを使用して、最新のALM OctaneおよびALMまたはJiraユーザーリストを使用していることを確認してください。

  2. このマッピングが必要になる場合には、あるエンドポイントのユーザーリストに存在し、ユーザーリスト値としてリストされていたユーザーが、他方のエンドポイントのユーザーリストから削除されたケースなどがあります。

    [Default user (標準設定のユーザー)] 領域を展開して、ALM OctaneとALMまたはJiraの両方の宛先エンドポイントに標準設定のユーザーを定義します。

    注意: ユーザーフィールドを双方向でマッピングする場合、標準設定値によってユーザーリスト内に存在しない値が上書きされます。

    例:

    peter@domain.comは、ALM Octane内の不具合の所有者としてリストされますが、ALM内のユーザーリストにはありません。

    この不具合を同期する場合、ALM Octaneのpeter@domain.comは、ALM内のdefault@alm.comにマッピングされます。

    双方向同期の後、ALM Octane内のこの不具合は、defualt@alm.comを不具合の所有者としてリストします。

    このような状況での別のソリューションについては、以下の手順4を参照してください。

  3. エンドポイントごとにドロップダウンメニューから対応するユーザーを選択し、方向を設定して、[Add Mapping (マッピングの追加)] をクリックします。

    ヒント:  

    • [Show unmapped only (マップされていないユーザーだけを表示)] を選択して、まだマッピングされていないユーザーのみをドロップダウンリストに表示します。
    1. [Manual Mapping (手動マッピング)] 領域で、ALM Octaneのユーザー名を選択します。
    2. [ALM/Jira Users (ALM/Jiraユーザー)] ボックスに、ALMまたはJiraユーザーリストに存在しないユーザーの名前を入力して、[map to non-existing user (存在しないユーザーにマップ)] エントリを選択します。

    同期時に、マッピングしたユーザー名が関連するユーザーフィールドに入力されますが、ALMまたはJiraユーザーリストには追加されません。

    注意: ALMでは、ユーザーフィールドは [値の検証] に設定できます。つまり、このフィールドでは、ALMはユーザーリストに存在するユーザーのみを許可します。このようなユーザーフィールドを双方向で同期する場合、存在しないALMユーザーを使用すると、同期でエラーが発生する可能性があります。

ユーザーマッピングファイルをエクスポートする

ALM Octaneでユーザーマッピングを作成したら、ユーザーマッピングをcsvとしてエクスポートをクリックして、ユーザーマッピングファイルをダウンロードします。

エクスポートされるマッピングは、標準設定のマッピングを含め、[ユーザーマッピング] ダイアログで手動でマッピングされたものです。エクスポートする前に、変更が保存されていることを確認してください。

次に、次のセクションで説明するように、マッピングを変更またはインポートできます。

ユーザーマッピングファイルをインポートする

ユーザーマッピングペアのリストを含む.csvファイルを準備するか、以前にエクスポートしたユーザーマッピングファイルを使用して、それをALM Octaneにインポートできます。

  1. 次の形式を使用して、ユーザーマッピングペアのリストを含む.csvファイルを準備します。

    <ALM/Jiraユーザー名>、<direction>、<ALM Octaneユーザーアドレス>

    <、>、または<>を使用して、マッピングの方向を指定します。マッピングペアの左側で常にリモートユーザーを指定します。

  2. (オプション) 一致するユーザーが宛先エンドポイントに存在しない場合のために、標準設定のユーザーを定義します。

    例: 例: 

    Default,>,OctaneUser1@acme.com
    ALMUser1,<,Default
    ALMUser2,<>,OctaneUser2@acme.com

    これは、Jira内の不具合をジョン・ドウという名前の所有者と同期し、このユーザーのマッピングがALM Octaneに存在しない場合、ALM Octaneの不具合の所有者はOctaneUser1@acme.comになることを意味します。

  3. [その他のアクション] > [ユーザーマッピングファイルのインポート] を選択します。

  4. ファイルを参照し、インポートをクリックします。

    .csvファイルからインポートされたユーザーの数を示すメッセージが表示されます。

ユーザーがファイルに明示的にマップされていない場合、Synchronizerは電子メールアドレスを使用してユーザーを自動的にマップしようとします。

マッピングの競合を解決する方法

インポートされたマッピングは、既存のすべてのマッピングを削除します。データの損失を防ぐために、インポートする前に、バックアップ用にすべてのユーザーマッピングを最初にエクスポートすることをお勧めします。

インポートファイルに競合するマッピングが含まれている場合は、次のルールが適用されます。

ルール 例:
双方向マッピング (<>) は、同じユーザー間の単方向マッピングを上書きします。

ファイルにbob <bob @ octaneが含まれ、bob <> bob @ octaneも含まれている場合、結果はbob <> bob @octane。になります。
双方向マッピングがマージされます。 ファイルにbob <bob @ octaneが含まれ、bob > bob @ octaneも含まれている場合、結果はbob < > bob @ octaneになります。

インポートファイルに競合するマッピングが含まれている場合、ファイルに最初に表示されたマッピングのみがインポートされます。

ファイルにbob <> bob @ octaneが含まれ、ファイルの後半にbob <> john @ octaneが含まれている場合、結果はbob <> bob @ octaneになります。