CA Agile Central の HP ALM (Quality Center)用コネクタのインストールおよびユーザ ガイド

 

注: HP Quality Center プロダクトは、12.0 リリース時点で HP ALM (アジャイル ライフサイクル管理)と名前変更されています。このドキュメントでは、HP QC、Quality Center、HP ALM、または ALM について言及している場合、すべて同じプロダクトを指しています。

CA Agile Central の Quality Center 用コネクタを使用すると、顧客は、CA Agile Central を使用してアジャイル ライフサイクル管理を行いながら、Quality Center (QC)を使用して、ディフェクト、要件、テスト、およびテスト実行を管理できます。コネクタは、ファイアウォールの背後にあるコンピュータ上で動作し、CA Agile Central Web サービス API を介して CA Agile Central にアクセスします。コネクタは、Quality Center と CA Agile Central の間でワーク アイテムを反映する機能を提供し、2 つのシステム間のほとんどのフィールドを同期させることができます。コネクタは、ポートフォリオ アイテムの同期をサポートしていません。ワーク アイテムを反映するには、通常、2 つのシステム間の少数のキー フィールドの値を照合する必要があります。これを行うには、以下のことを可能にする必要があります。

  • CA Agile Central の Quality Center ディフェクトをディフェクトとしてコピーする
  • CA Agile Central の Quality Center 要件をユーザ ストーリーとしてコピーする
  • CA Agile Central の Quality Center テストをテスト ケースとしてコピーする
  • Quality Center から CA Agile Central テスト ケース結果にテスト実行を更新する

考慮事項

注: CA Agile Central は、12.50 に続く HP ALM コネクタ バージョンに対してのみ REST API を使用します。HP REST API は、前進している主要な外部インターフェース テクノロジとして HP によって識別されています。これは、OTA.dll よりも安定しており、パフォーマンスの低下を示すことはありません。

このコネクタは、Unlimited Edition のお客様と HP の統合モジュールを使用するお客様に提供されています。

注: コネクタは、HP ALM 12.21、12.50 で使用される場合に完全にサポートされます。

コネクタは HP ALM バージョン 12.50 と互換性があり、HP ALM REST API を使用します。以前のバージョンの HP ALM (REST API を使用)でのこのコネクタの使用は正式にはサポートされていませんが、ご使用の環境で動作する可能性があります。レガシー OTA.dll テクノロジはサポートされていません。サポートされているバージョンの Ruby (現在は 2.2.6)のプラットフォームで実行されます。Technical Preview Includes コネクタ バージョン 4.8.x の分類で HP によってリリースされた HP ALM REST API を使用しています。

Quality Center 用 CA Agile Central コネクタは、ネットワーク内のマシン上で Ruby スクリプトとして実行されます。

コネクタは、XML ファイルによって設定され、CA Agile Central と Quality Center でコネクタによって行われた変更を追跡するために、ログ ファイルが作成されます。コネクタでは、他のシステムのリンクされたオブジェクトの一意の ID を格納するために、システムごとのカスタム フィールドが必要です。コネクタは、設定ファイルに指定されたフィールド マッピングに基づいて、CA Agile Central または Quality Center に対してフィールドをコピーします。2 つのシステム間で標準とカスタムの両方のフィールドをマップできます。

コネクタを実行するには、rallyeif-qc gem をインストールした結果の実行可能ファイルを使用します。この実行可能ファイルは、インストール ディレクトリには表示されません。これは、Ruby インストールに関連付けられているすべての Ruby gem にある gem の他のコンテンツと共に存在します。

コネクタは、CA Agile Central と Quality Center の間の反映に影響する 5 つのサービスを提供します。

  • Quality Center で作成されたエンティティを CA Agile Central のワーク アイテムにコピーする
  • CA Agile Central で作成されたワーク アイテムを Quality Center のエンティティにコピーする
  • Quality Center のエンティティに加えられた変更に基づいて CA Agile Central のワーク アイテムを更新する
  • CA Agile Central のワーク アイテムに対して加えられた変更に基づいて Quality Center のエンティティを更新する
  • CA Agile Central のフィールドおよび Quality Center のフィールドを更新する

設定ファイルは、上記のどのサービスをどの順序で実行するかを指定します。

代わりの更新サービス UPDATE_RALLYFIELDS_AND_OTHER は、CA Agile Central で最初に更新を検索し、最近変更され、マップされたフィールドのみを QC システムにプッシュします。次に QC システムで更新を検索し、見つかった場合は、マップされているすべてのフィールドを CA Agile Central にプッシュします。これにより、データの上書きが削減されます。上書きが発生するのは、ユーザ A が CA Agile Central で変更を行い、ユーザ B が同じフィールドについて QC システムで変更を行った場合のみです。この場合、CA Agile Central の情報は QC システムにコピーされ(おそらく QC システムのデータを上書きする)、すべてのデータが CA Agile Central システムにコピーされます。

CA Agile Central と Quality Center のデータ モデルは同一ではないため、これらは完全に互換性があるわけではないことを認識することは重要です。両方のシステムで追跡対象にする主要なデータ項目、および記録のための主システムという点においてポリシーがどのような役割を果たすべきかを慎重に特定することをお勧めします。このドキュメントの後半には、考慮すべきトレードオフ、および可能なアプローチについて説明している特定の情報があります。

このインストール & ユーザ ガイドには、以下が含まれます。

コネクタのダウンロード

コネクタをダウンロードするには、support.ca.com に移動し、[Open a case (ケースを開く)]を選択します。ログインまたは登録し、新しいケースを作成してコネクタを要求します。

サポート ケースを作成するのが初めての場合、またはプロセスに関する質問がある場合は、ここに役立つ情報があります。

基本的なインストール手順

  1. zip ファイルの内容を抽出します。**注 - このバージョンのコネクタには .exe ファイルが含まれていません。コネクタが ruby ファイルによって呼び出されるようになったので、今後期待されます。
  2. カスタム フィールドの作成など、CA Agile Central および他のシステムで設定を変更します。
  3. お使いの環境を反映するように qc_config.xml を編集します。
  4. install_gems.rb Ruby スクリプトを実行します。
  5. ca_agile_central2_hpalm_connector または ca_agile_central2_qc_connector.rb を実行して、同期プロセスを開始します。

サポートされているバージョン

バージョン サポートの終了
ALM 12.53 および 12.55 サポートされていません(問題報告済み)
ALM 12.50 N/A
ALM 12.21 N/A
ALM 12.0 および 12.01 2018 年 5 月 1 日
Quality Center 11.5 2017 年 8 月 31 日
Quality Center 11 2016 年 10 月 15 日
Quality Center 10 2015 年 5 月 10 日


システムのセットアップ

「CA Agile Central 統合機能に関する FAQ とベスト プラクティス」には、非常に有用な情報が含まれています。

ソフトウェアとハードウェアの要件

HP ALM 12.50 用 REST API に基づく CA Agile Central コネクタをインストールおよび実行するためのソフトウェア要件を以下に示します。

  • CA Agile Central サブスクリプション
  • HP ALM 12.50
  • Ruby 2.2.6 がインストールされている
    • Linux/Mac OS の場合、ruby 2.2.6 用の .gz をダウンロードする(rvm または rbenv を使用したインストールをお勧めします)。[Install Td/Tk support (Td/Tk のインストールのサポート)]を選択し、プロンプトが表示されたら、[Add Ruby executables to your Path (Ruby の実行ファイルをパスに追加)]および[Associate .rb and .rbw files with this Ruby installation (.rb と .rbw ファイルをこの Ruby インストールに関連付ける)]オプションを選択します。
    • Windows OS の場合、ruby 2.2.6 (x64)用の .exe をダウンロードする [Install Td/Tk support (Td/Tk のインストールのサポート)]を選択し、プロンプトが表示されたら、[Add Ruby executables to your Path (Ruby の実行ファイルをパスに追加)]および[Associate .rb and .rbw files with this Ruby installation (.rb と .rbw ファイルをこの Ruby インストールに関連付ける)]オプションを選択します。
    • ruby bin ディレクトリへのパスを環境パス変数に追加します
  • Ruby 2.0 ~ 2.3 用の Ruby Development Kit (Windows の場合のみ必須)(DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe をダウンロード)
    • devkit の bin ディレクトリへのパスを環境パス変数に追加
    • cd コマンドで、Ruby 開発キットのルート ディレクトリに移動します
      • 次のコマンドを実行します: ruby dk.rb init
      • 次のコマンドを実行します: ruby dk.rb install

ハードウェア

コネクタは、いくつかの方法でインストールできます。並行して実行できる同じマシン上に複数のインストール場所を指定することができ、その条件によって必要なハードウェアが決まります。以下のガイドラインに従うことを推奨します。

  • コネクタが実行されるコンピューティング プラットフォーム(Windows、Linux、Mac)
  • クアッドコア プロセッサ セットと最低 8 GB の RAM を備えた基本ハードウェア
  • インストール場所ごとに 20 ~ 25 個の設定ファイル
  • コネクタの実行で生成されたログ ファイルを保存するのに十分なディスク ストレージ容量。1 GB の空きディスク容量を推奨します。
  • 並行して実行するインストール場所をさらに追加する場合は、インストールされた場所ごとに、実行時に最大 200 MB の RAM を消費し、アイドル状態では 50 MB 未満の RAM を消費します。
  • 必要なハード ドライブの容量は最小限であり、ログ ファイルが増加した場合にのみ拡張する必要が生じるので、インストール場所あたり 200 ~ 250 MB の容量を推奨します。

コネクタのインストール

(オプション)お使いのサイトで CA Agile Central にアクセスするためにプロキシ サーバを使用する場合は、http://username:[email protected]:port の形式に続く値に HTTP_PROXY 環境変数を設定する必要があります。

set HTTP_PROXY=http://username:[email protected]:8000

インストール前のチェックリスト

  • QC のテスト環境へのプロジェクトおよびサイト管理アクセス。
  • セットアップには CA Agile Central の管理者権限が必要ですが、コネクタを実行するにはユーザ アクセス権のみが必要です。
  • プロキシ サーバの詳細(コネクタを実行するのに使用されるマシンがプロキシ サーバを使用している場合)。

以下のことを考慮してください。

  • CA Agile Central と QC の両方でフィールドを設定するには、以下のユーザが必要になります。
    • Quality Center 管理者ユーザ(CA Agile Central と同期する QC カスタム フィールドを作成)。
    • CA Agile Central 管理者ユーザ(QC と同期する CA Agile Central アーティファクトにカスタム フィールドを作成)。
  • CA Agile Central と QC の間でセットアップするプロセスを検討します。
    • オブジェクトはどこで開始し、そのライフサイクルはどこで終わりますか。
    • どのフィールドを更新する必要がありますか。
  • コネクタのテストに使用する Quality Center のテスト ドメインまたはプロジェクトを特定します。
  • コネクタのテストに使用する CA Agile Central のテスト ワークスペースまたはプロジェクトを特定します。

インストール

「書き込み権限がありません」のような出力が表示された場合は、システム管理者に問い合わせて必要な権限を取得します(通常は sudo または他の類似ソフトウェアを使用)。システム管理者に install_gems.rb コマンドの実行を依頼します。

  1. Ruby および Ruby 開発キットがシステムにインストールされていますか。そうでない場合は、手順についてこのドキュメントの「システムのセットアップ」セクションを参照してください。
  2. zip ファイル RallyConnectorforHPALM-x.y.z-master-bbb.zip をマシンのローカルの場所に解凍します(たとえば、Windows の場合は C:\rally、MAC の場合は /Users/username/Downloads/)。**注 - このバージョンのコネクタには .exe ファイルが含まれていません。コネクタが ruby ファイルによって呼び出されるようになったので、今後期待されます。
  3. ディレクトリをコネクタ インストールのルート ディレクトリに変更します。
     
    cd CAAgileCentralConnectorforHPALM-4.x.Y-master-z
  4. 環境変数 GEM_COMMAND を Ruby インストール ディレクトリにある gem 実行可能ファイルに設定します。Linux および Windows の場合の場所の例をそれぞれ以下に示します。
    • /myhome/.rvm/rubies/ruby-2.2.6/bin/gem
    • C:\Ruby226\bin\gem
  5. 配布アーカイブを展開すると、以下のファイルおよびフォルダが作成されます。

    • field_handlers — カスタム フィールド ハンドラ用のフォルダ
    •  qc_config.xml — ユーザ ストアおよびディフェクト用のサンプル設定ファイル
    •  qc_config_test_workflow.xml — テスト ケース用のサンプル設定ファイル
    •  qc_config_run.xml — テスト実行用のサンプル設定ファイル
    • install_gems.rb — このコネクタに必要な gem をインストールする Ruby スクリプト
    •  ca_agile_central2_hpalm_connector.rb — コネクタを実行する実行可能ファイル(rallyeif-qc gem と共に存在)
  6. install_gems.rb Ruby スクリプトを実行して、関連するすべての gem をインストールします。
    • コマンドをコンソールまたはターミナル ウィンドウのプロンプトで実行するには、ruby install_gems.rb と入力します。

install_ruby.rb コマンドの出力例を以下に示します。

ruby install_gems.rb 
rubygems-update installed
xml-simple installed
httpclient installed
multipart-post installed
faraday installed
mime-types installed
rally_api installed
rallyeif-wrk installed
rally_hp_alm_api installed
rallyeif-qc installed

Quality Center のセットアップ

Quality Center での外部 ID ユーザ フィールドの作成

HP ALM 12 のアクション:

  1. ALM Desktop Client を使用して、適切なドメインおよびプロジェクトに移動します。
  2. ページの右上付近のギア アイコンを選択し、[カスタマイズ]メニュー項目を選択します。
  3. ページの左側で、[プロジェクト エンティティ]アイテムを選択します。
  4. プロジェクト エンティティのリストで[ディフェクト]または[要件]を展開します。
  5. [ユーザ フィールド]フォルダを選択します。
  6. [新規フィールド]アイコン(プロジェクト エンティティのリストの上に緑色のプラス記号が付いた)を選択します。
  7. フィールドのフィールド ラベルを指定し、[フィールド タイプ]を 40 文字の制限の文字列で選択し、他のすべてのオプションのデフォルトのチェックボックスをそのままにします。
  8. [保存]を選択します。変更が正常に保存されたことを示すダイアログが表示されます。

HP ALM 12 の場合:

  1. [アプリケーション ライフサイクル管理]-[Project Customization (プロジェクトのカスタマイズ)]ページで、左側の[Requirement Types (要件タイプ)]を選択します。
  2. 要件タイプがリストされている列で、各エントリに対してタイプ名を選択し、要件テーブルに追加したフィールドの[In Type (タイプ)]列の下のチェックボックスをオンにします。
  3. [保存]を選択します。変更が正常に保存されたことを示すダイアログが表示されます。

QC の CrosslinkUrl フィールドの作成

対応する CA Agile Central アーティファクトに関連する参照情報を QC ワーク アイテムに含めると便利です。設定ファイルの セクションの エレメントに、この参照(文字列)が含まれるカスタム フィールドの名前を指定することができます。

  • フィールド名として RallyLink または RallyURL をお勧めします
  • 文字列フィールドにする必要があります
  • このフィールド名は、設定ファイルの セクション内の エレメントで使用されます
  • このフィールドはコピーの場合にのみ入力されます。
  • 注: この URL フィールドは QC 側でのみサポートされています

CA Agile Central のセットアップ

CA Agile Central では、名前ではなく表示名からフィールドにアクセスします。スペースとアンダースコアは削除されます。たとえば、Example Field は ExampleField になります。

CA Agile Central での外部 ID フィールドの作成

  1. ワークスペースまたはサブスクリプションの管理者として、CA Agile Central にログインします。
  2. [セットアップ]、[ワークスペースとプロジェクト]に移動します。
  3. Quality Center にマップするワークスペースを選択します。
  4. ワークスペースの詳細ページで、サイドバーの[フィールド]リンクを選択し、[ワーク アイテム タイプ]に[ディフェクト](マップするワーク アイテムに該当するタイプ)が選択されていることを確認します。
  5. [アクション][新規フィールド]を選択します。
  6. ExternalID の名前、ExternalID の表示名(名前と表示名は一致している必要があります)、および文字列のタイプ(注: このフィールドはテキスト タイプにすることはできません)を入力します。

    注: CA Agile Central のカスタム フィールドに別の名前(QualityCenterID など)を選択することができますが、選択した名前は以下のルールに準拠している必要があります。

    • 大文字で始まる
    • 41 文字より少ない(表示名の最大長は 40 文字)
    • アンダースコア、ハイフン、スペースが使用されていない
    注意: CA Agile Central / HPQC ワーク アイテム コネクタを、同じドメイン内の複数の CA Agile Central プロジェクトと複数の HPQC プロジェクトと共に使用する場合は、Project.Name = "Example Project" を設定の セクションで使用して、複数の QC アイテムが複数の QC プロジェクト全体で同じ ID を持つ状況の過度の警告メッセージを回避するようにすることをお勧めします。

このフィールドの名前をメモします。コネクタを使用して起動すると、このフィールドには、2 つのシステム間でマップしている Quality Center エンティティの外部 ID が含まれます。

ヒント: CA Agile Central は、テスト ケース結果に関するカスタム フィールドをサポートしていないため、階層要件、ディフェクト、およびテスト ケースのワーク アイテム タイプに対してのみこのステップを完了します。

更新サービスは、ワークスペース スコープです。つまり、コネクタは、外部 ID フィールドが null でない CA Agile Central のアーティファクトを検索します。同じワークスペースを複数の Quality Center プロジェクトにマップする場合は、一意の外部 ID フィールドを持つことが重要です。そのため、コネクタは Quality Center で正しいワーク アイテムを更新します。ワーク アイテム ID は、Quality Center プロジェクト全体で一意ではありません。

コネクタの設定

以下の 2 つの方法のいずれかで、コネクタを使用できます。

  • ワーク アイテム モード - CA Agile Central と QC の間でユーザ ストーリーおよびディフェクトをコピーして更新します。
  • テスト モード - QC テストをコピーして更新し、CA Agile Central テスト ケースとテスト ケース結果のアーティファクトにアーティファクトを実行します。

ワーク アイテム モード

設定ファイルは、実行するアクションについてコネクタに指示するために使用されます。サンプル設定ファイルは提供された zip ファイルの一部であり、Ruby gem の解凍先と同じディレクトリにあります。Quality Center の場合、デフォルトの設定ファイルの名前は qc_config.xml です。有効な設定ファイルを後で参照する必要がある場合に備えて、qc_config.xml のバックアップ コピーを作成し、qc_config.xml-origqc_config-pristine.xml のような名前を付けることをお勧めします。設定ファイルには任意の名前を付けることができます。このドキュメントでは、qc_config.xml の名前を保持しています。

設定ファイル(またはデフォルトの qc_config.xml)を編集し、それぞれの XML の開始タグと終了タグの間に適切な値を入力します。

rally1.rallydev.comWorkspace NameProject Name 1[email protected]passwordDefectExternalIDserver:portDomain NameProject NameqcusernamepasswordBUGBG_BUG_IDBG_USER_XXBG_USER_YYNameBG_SUMMARYFalseDebugUPDATE_RALLY_TO_QC,  COPY_QC_TO_RALLY

各セクションは、そのセクションの区切りがわかるようにタグ(XML エレメントと呼ばれる)で囲まれています。上記の例について、各セクションの説明を以下に示します。

  • RallyConnection
    CA Agile Central の接続情報(CA Agile Central の URL、ユーザ名、パスワードや APIKey など)を定義します。
  • QCConnection
    Quality Center への接続情報(ドメイン名、プロジェクト名、アーティファクト タイプ、ユーザなど)を定義します。
  • Connector
    2 つのシステム間でのフィールドのマッピングを定義します。一般的には、文字列は文字列に、整数は整数にというようにマップする必要があります。
  • ConnectorRunner
    コネクタが実行するサービスに関連するパラメータを指定します。

テスト モード

テスト追跡アプリケーションとの統合により、チーム メンバは現在のテストとディフェクト インフラストラクチャを活用しながら、CA Agile Central を使用して、アジャイル型プロジェクト管理を行うことができます。Quality Center と統合することも、お気に入りの開発言語で拡張可能な Web サービス API を使用して独自の統合を記述することもできます。

CA Agile Central の Quality Center 用コネクタを使用すると、CA Agile Central を使用してアジャイル ライフサイクル管理を行いながら、Quality Center を使用して、テストおよび実行を管理できます。コネクタにより、以下をマップすることができます。

  • Quality Center から CA Agile Central のテスト ケースへのテスト(または CA Agile Central のテスト ケースから Quality Center のテストへのテスト)
  • Quality Center から CA Agile Central のテスト ケース結果への実行

以下の図は、テスト管理に Quality Center を使用する場合の推奨されるワークフローを示しています。

 

ワークフロー

設定ファイルは提供された zip ファイルの一部であり、Ruby gem の解凍先と同じディレクトリにあります。Quality Center のテストおよび実行の場合、デフォルトの設定ファイルの名前は qc_config_test.xml および qc_config_run.xml です。コネクタをアンインストールすると、コネクタに付属のデフォルト ファイルが完全に削除されるため、これらのファイルの名前を変更し、バックアップを取ることは非常に重要です。

  1. テストの設定ファイル(qc_config_test.xml など)を編集し、それぞれの開始タグと終了タグの間に適切な値を入力します。
    rally1.rallydev.comWorkspace NameProject Name 1[email protected]passwordtestcaseExternalIDserver:portDomain NameProject NameqcusernamepasswordTESTMyTestFolderTS_TEST_IDTS_USER_xxNameTS_NAMEFalseDebugUPDATE_QC_TO_RALLY,  COPY_QC_TO_RALLY

     

  2. 実行の設定ファイル(qc_config_run.xml など)を編集し、それぞれの開始タグと終了タグの間に適切な値を入力します。

 

rally1.rallydev.comWorkspace NameProject Name 1[email protected]passwordTestCaseResultserver:portDomain NameProject NameqcusernamepasswordRUNMyTestRunFolderRN_RUN_IDRN_USER_xxTS_USER_xx2DateRN_EXECUTION_DATEBuildRN_RUN_NAMETestCaseRN_TEST_IDVerdictRN_STATUSTestCaseExternalIDRN_EXECUTION_DATERN_STATUSFailFailedPassPassedFalseDebugCOPY_QC_TO_RALLY


各セクションは、そのセクションの区切りがわかるようにタグ(XML エレメントと呼ばれる)で囲まれています。上記の例について、各セクションの説明を以下に示します。


  • CA Agile Central の接続情報(CA Agile Central の URL、ユーザ名、パスワードや APIKey など)を定義します。

  • CA Agile Central への接続情報(CA Agile Central の URL、ユーザ名、パスワードや APIKey など)を定義します。CA Agile Central のテスト結果のみをサポートします。

  • Quality Center への接続情報(ドメイン名、プロジェクト名、アーティファクト タイプ、ユーザなど)を定義します。バグおよび要件をマッピングするときに使用されます。

  • Quality Center への接続情報を定義します。テストなどマッピングするときに使用されます。

  • 2 つのシステム間でのフィールドのマッピングを定義します。一般的には、文字列は文字列に、整数は整数にというようにマップする必要があります。

  • コネクタが実行するサービスに関連するパラメータを指定します。

フィールド マッピング

フィールド マッピング セクションは、設定ファイルの  エレメント内にあります。2 つのシステム間でマップされるフィールドを定義します。

たとえば、以下の定義では、CA Agile Central の[名前]フィールドと他のシステムの[ヘッドライン]フィールドとの間のマッピングが設定されます。作成または更新では、コネクタは CA Agile Central の[名前]フィールドと他のシステムの[ヘッドライン]フィールドのみを更新します。


  ....
  NameHeadline
    ....


2 つのシステム間でマッピングを設定する場合、2 つのシステム間でフィールドに互換性があることを確認してください(整数フィールドは、もう一方のシステムの整数フィールドにマップする必要があり、リッチ テキスト フィールドは、もう一方のシステムのリッチ テキスト フィールドにマップする必要があります)。そうしないと、2 つのシステム間で情報が作成または更新されず、ログ ファイルにエラーが表示される可能性があります。たとえば、CA Agile Central の整数型のカスタム フィールドに文字列をポストしようとした場合、そのワーク アイテムに対してコネクタはエラーをポストします。

このリストに追加することで、後続のマッピングを追加できます。たとえば、CA Agile Central の名前から QC のヘッドラインへ、CA Agile Central の説明から QC の説明へ、CA Agile Central の優先順位から QC の優先順位へのマッピングを設定します。


    ....
    NameHeadlineDescriptionDescriptionPriorityPriority
        ....

CA Agile Central のドロップダウン値を他方のシステムにマップする場合、ドロップダウン値は一致すると見なされます。そうでない場合、コネクタは、リストで値が見つからなかったというエラーを生成します。ドロップダウンの値が 2 つのシステム間で異なる場合は、「ドロップダウン値のマップ」を参照してください。

注: 複数選択のドロップダウン リストはサポートされていません。

個々のフィールドには方向性が指定されることもあり、それにより、特定のフィールドが一方向のみにマップされます。この機能の詳細については、「フィールドの方向性」を参照してください。

CopySelector および UpdateSelector

FAQ には、以下の使用に関する一般情報のセクションがあります:   および .

QC コネクタは、同じフィールドで複数のテストを行うことはできません。より複雑なテストを可能にする、QC GUI 内で使用できる同じ構文をサポートしています。  (設定ファイルの セクション内) のいくつかの例を以下に示します。

BG_USER_02 = YBG_STATUS = (Not Closed And Not Fixed)

 

BG_USER_02 = YBG_PROJECT = (Not "")

 

BG_USER_02 = YBG_STATUS = (Open Or Reopen)

 


RQ_REQ_ID = (>3 And 

 

BG_USER_03 = (Not (ABC or DDM))

 

BG_USER_03 = (Not ("ABC DEF" or "GHI JKL"))

既存のコピーおよび更新のセレクタに加えて、HPALM REST コネクタではサブセットと範囲の演算子を使用できるセレクタがサポートされています(in!in および between、および !between 演算子をそれぞれ使用)。

in および !in 演算子は、ドロップダウン フィールドの使用可能な値(たとえば HPALM の BG_STATUS や Agile Central の State)、または整数値(たとえば HPALM の BG_ESTIMATED_TIME)のサブセットを選択するために使用できます。

設定ファイルのセクションでのコピーと更新のセレクタの例を以下に示します。 これは、HP ALM から Agile Central へのコピーおよび更新のサービスを、許可された値の特定のサブセット内の BG_STATUS の ディフェクトに制限します。

BG_STATUS in New,Open,Reopen
BG_STATUS in New,Open,Reopen

以下の例では、!in 演算子を使用してディフェクトが選択されます。返されるサブセットは、上記の例で in 演算子によって絞り込まれているディフェクトのサブセットと実質同じです。空の値が許可されているドロップダウン フィールド(BG_PRIORITY など)で否定を使用する場合、対象となるワーク アイテムのサブセットには、このフィールドが空であるワーク アイテムも含まれることに注意してください。それらのワーク アイテムを含めたくない場合は、in 演算子を使用することを強くお勧めします。サブセットのセレクタでは、空のフィールド値はサポートされていません。

BG_STATUS !in Fixed,Closed,Rejected
BG_STATUS !in Fixed,Closed,Rejected

以下の例のように、カンマの後に続く空白だけでなく、空白を含むマルチワード値も許可されています。

RQ_REQ_PRIORITY in 3-High, 4-Very High, 5-Urgent

between および !between 演算子は、指定のフィールドが特定の範囲内であるワーク アイテムを選択します(範囲の両端の値を含む)。範囲セレクタは、日付フィールド(HP ALM の BG_DETECTION_DATE、Agile Central の CreationDate など)または整数値(HPALM の BG_ESTIMATED_TIME など)を操作するために使用できます。

設定ファイルのセクションでのコピーと更新のセレクタの例を以下に示します。 これは、Agile Central から HP ALM へのコピーおよび更新のサービスを、特定の日付範囲内に作成されたストーリーに制限します。

CreationDate between 2016-07-05 and  2016-07-06
CreationDate between 2016-07-05 and  2016-07-06

!between 演算子を使用する範囲セレクタのバリエーションは、日付範囲の開始日または終了日のいずれかで作成されたストーリーのみを選択します。

CreationDate !between 2016-07-05 and  2016-07-06
CreationDate !between 2016-07-05 AND 2016-07-06

特定の CA Agile Central タグを使用してアーティファクトをプルする CopySelector の例を以下に示します。

Tags.Name = "Loritag1"

 

セレクタおよび要件

CopySelectors で要件フォルダを使用する場合は、条件を ^ 文字で囲み、式全体をかっこで囲む必要があります。また、要件フォルダのパスを完全修飾する必要もあります。以下の例を参照してください。

フィルタの QC での定義方法および記述方法に慣れていない場合は、以下を考慮してください。QC でフィルタを開きます。条件を記述し、結果が目的のとおりであれば、[フィルタ要件]ダイアログの上部にある左から 2 番目の[フィルタのコピー]アイコンを選択します。これを好みのエディタのテキスト バッファに貼り付けます。以下のテキストのようになります。

[Filter][Keep_Hierarchical]{
TableName:REQ,
ColumnName:RQ_FATHER_NAME,
LogicalFilter:\0000001e\^Requirements\SubChannel\Basement^,
VisualFilter:\0000001e\^Requirements\SubChannel\Basement^,
NO_CASE:
}

気にする部分は ColumnName です。この例では、RQ_FATHER_NAME と LogicalFilter の値です。LogicalFilter では、アップキャレット記号(^)で囲まれた部分をコピーする必要があります。その部分をコピーする際には、必ずキャレット文字を含めるようにしてください。

フィールド名として RQ_FATHER_NAME を使用し、値としてコピーした LogicialFilter の部分を使用します。 でこれを指定したら、、キャレットで区切られた論理値をかっこで囲みます。以下の例はその最終成果物を示しています。


    ....
    
        ....
        RQ_FATHER_NAME = (^Requirements\SubChannel\Basement^)
        ....

 

 

 

QC マークアップ フィールドのマップ

QC の一部のフィールドには、太字、下線、箇条書きなどを実現するリッチ テキスト(基本的に HTML マークアップ メタデータ)が含まれています。このリッチ テキストは、通常、QC と CA Agile Central の間では異なります。これらのタイプのフィールドを CA Agile Central から QC にコピーする場合、 は、 このメタデータの大部分を変換するようにコネクタに指示するために使用できます。この は、 以下のようなフィールドのマッピングで使用できます。

  • BG_DESCRIPTION
  • BG_DEV_COMMENTS
  • RQ_REQ_COMMENT
  • TS_DESCRIPTION

BG_DESCRIPTION のマッピングの例:


    ....
    DescriptionBG_DESCRIPTION
            ....
        BG_DESCRIPTION
            ....
        

QCRtfFieldHandler の複数のフィールドをマップすると、以下のようにフィールドが分割されます。


    ....
    DescriptionBG_DESCRIPTIONNotesBG_DEV_COMMENTS
            ....
        BG_DEV_COMMENTSBG_DESCRIPTION
            ....
        

 

QC 添付ファイルのマップ

QC コネクタには、添付ファイルをマップする 2 つの異なる方法があります。

  • 方法 1: 実際の QC 添付ファイルを CA Agile Central に添付ファイルとしてコピーする。

    CA Agile Central と QC の間で実際の添付ファイルをコピーするため、設定ファイルで  オプションを以下のように設定します。 


    ....
    
        ....
        
        ....

CA Agile Central の添付ファイルは 50 MB に制限されています。QC の添付ファイルが 50 MB より大きい場合は、QC から CA Agile Central にコピーされません。このような場合、添付ファイルのマッピングに以下のいずれかの方法を使用することができます。QC システムの添付ファイルの場所を指す CA Agile Central のリンク(URL)を作成します(CA Agile Central システムでは添付ファイルは作成されず、URL のみが作成されます)。 は、 QC と CA Agile Central の間の双方向マッピングをサポートしています。URL マッピングは、QC から CA Agile Central への方向でのみサポートされています。

注: 添付ファイルを追加する場合、コネクタを実行するユーザは、CA Agile Central のルート プロジェクトに至るまで、設定ファイルの  タグ( セクションの下)で指定されたプロジェクト階層の すべてのプロジェクトへの、書き込みアクセス権を持っている必要があります。

  • 方法 2a: QC10 – URL リンクを作成する。

    CA Agile Central で対応するアーティファクト(ストーリー、ディフェクト、テスト)を表示しているときに Quality Center 添付ファイルにアクセスできるようにするには、QC システムの元の添付ファイルを指す CA Agile Central で URL を作成します。 このマッピングは、QC10 から CA Agile Central への方向でのみサポートされています。

    QC コネクタは、バグ、要件、およびテスト項目に対してのみ、この機能をサポートしています。

    HP QC10 では、各 Quality Center ドメインまたはプロジェクトのすべての添付ファイルが、Quality Center サーバのディスク上の固定された場所に格納されます。このフォルダの場所がわかっていて共有されている場合は、その内容を外部クライアントから表示することができます。Quality Center 管理者に連絡して、特定のドメインまたはプロジェクトの添付ファイル フォルダにアクセスできる共有ネットワーク ドライブを設定する必要があります。

    QC 添付ファイル(以下の例のカスタム フィールド名は QC10Attachments)への参照(URL リンク)を格納するために使用されるテキスト タイプのカスタム フィールドを CA Agile Central に作成する必要があります。設定ファイルで以下のような構文を使用します。

    
    ....
    QC10AttachmentsBG_ATTACHMENTTO_RALLY
    ....
    BG_ATTACHMENT\\sharedpath
    ....

    上記の例では、CA Agile Central フィールド ハンドラ  は、以下の形式でリンクを格納します(CA Agile Central リッチ テキスト フィールドの元のテキストを表示した場合)。

    file1

    フィールド ハンドラは、以下のように追加の添付ファイルを追加します。

    file1 file2

    QC サーバ上の QC10 プロジェクトへのパス(添付ファイルが保存されている場所)は、以下のようになります。

    E:\HP\repository\qc\Default\JPPROJECT\attach
  • 方法 2b: HP QC 11 および HP ALM 12 – URL リンクを作成する。

    CA Agile Central で対応するアーティファクト(ストーリー、ディフェクト、テスト)を表示しているときに Quality Center 添付ファイルにアクセスできるようにするには、QC システムの元の添付ファイルを指す CA Agile Central で URL を作成します。

    HP QC 11/HP ALM 12 は、添付ファイルを QC サーバ上の一連のフォルダに格納します。また、これらの添付ファイルを URL リンクとして参照する簡単で確定的な方法を可能にする REST API も提供します。

    注:

    • QC コネクタは、バグ、要件、およびテスト項目に対してのみ、この機能をサポートしています。
    • HP ALM 12 ユーザは、ユーザ グループが添付ファイルにアクセスするために Web クライアントを有効にする必要があります。これを行うには、ツール、カスタマイズ、グループ、および権限に移動し、ユーザ グループの Web クライアント アクセス オプションを選択します。
    • このマッピングは、QC 11 または HP ALM 12 から CA Agile Central への方向でのみサポートされています。

    注意: HP ALM は、MS Internet Explorer 11 または Edge からのクライアント アクセスをサポートしています。添付ファイルを表示するリンクは、MS IE 11 または MS Edge を使用して CA Agile Central にアクセスする場合にのみ機能します。

    この機能を使用するには、添付ファイル(以下の例のカスタム フィールド名は QC 11/ALM 12 attachments)への参照(URL リンク)を格納するために使用されるテキスト タイプのカスタム フィールドを CA Agile Central に作成します。その後、 を使用して、 QC 11/HP ALM 12 と CA Agile Central の間のマッピングを以下のように処理します。

          
          ....
          QCAttachmentsTextFieldBG_ATTACHMENTTO_RALLY
          ....
          BG_ATTACHMENT
          ....

    QCUrlAttachmentFieldHandler は、以下の形式でリンクを保存します。

    YourAttachedFile.docx

日付のマップ

Quality Center には、フォーマットは日付で構成された文字列であるが、CA Agile Central における同等のフィールドは日付と時刻で構成された文字列である、アーティファクトの日付フィールドのセットがあります。この日付フィールドの移動を容易にするフィールド ハンドラは、以下の 2 つです:  および .

このフィールド ハンドラは、以下の標準 Quality Center マッピング フィールドに使用することをお勧めします。

  • BG_CLOSING_DATE
  • BG_DETECTION_DATE
  • RQ_REQ_DATE
  • TS_CREATION_DATE

日付マッピングの設定ファイルの抜粋の例:


....
CreationDateBG_DETECTION_DATETO_OTHER
....
BG_DETECTION_DATE
....


CA Agile Central では、CreationDate は読み取り専用フィールドです。これはアーティファクト上にあり、基になるデータベースによって配置されます。したがって、ユーザはこのフィールドを変更することはできません。上記の例では、  タグを配置しています。このインスタンスではタグは実際には必要ありませんが、CA Agile Central でユーザがこのフィールドを決して変更できないという事実を強化するために使用しています。設定ファイルがこの CA Agile Central フィールドにマップされている場合、これは無視されます(CA Agile Central のこのフィールドではデータはコピーまたは更新されません)。

日付フィールドの双方向移動を行う場合は、以下の例のように両方のフィールド ハンドラを使用します。


....
NameBG_SUMMARYTargetDateBG_CLOSING_DATEBG_CLOSING_DATETargetDate%Y-%m-%dT%H:%M:%S.%LZ
....

TS_NAME のマップ

Quality Center には、テストの名前を作成するときに禁止されている一連の文字があります。CA Agile Central から QC への更新または作成をプッシュする際に、禁止された文字を削除する TS_NAME のフィールド ハンドラを使用します。

UPDATE_OTHER_TO_RALLY サービスも指定されている場合、QC から更新された新しい名前によって、CA Agile Central の名前が、禁止された文字を含まない QC の名前に変更されます。


    ....
    
    ....
        TS_NAME
            ....

TS_NAME の場合、以下の 11 の文字は削除されます。

文字
記号
円記号
\
スラッシュ
/
コロン
:
引用
"
疑問符
?
一重引用符
'
より小さい
より大きい
>
縦線
|
アスタリスク
*
パーセント
%

RQ_REQ_NAME のマップ

Quality Center には、要件の名前を作成するときに禁止されている一連の文字があります。CA Agile Central から QC への更新または作成をプッシュする際に、禁止された文字を削除する RQ_REQ_NAME のフィールド ハンドラを使用します。

UPDATE_OTHER_TO_RALLY サービスも指定されている場合、QC から更新された新しい名前によって、CA Agile Central の名前が、禁止された文字を含まない QC の名前に変更されます。


  ....
    
      ....
      RQ_REQ_NAME
      ....

RQ_REQ_NAME の場合、以下の 3 つの文字は削除されます。

文字
記号
円記号
\
キャレットまたは曲折アクセント記号
^
アスタリスク
*

TS_LINKED_REQ および BG_LINKED_REQ のマップ

Quality Center では、要件はバグおよびテスト ケースにリンクすることができます。CA Agile Central では、同様の関係が可能ですが、これらの関係はデフォルトでは保持されません。Quality Center は、要件とディフェクトの間の別のテーブルでリンケージを追跡します。CA Agile Central は、ディフェクトの[要件]フィールドおよびテスト ケースの[作業成果物]フィールドを使用して、関係を追跡します。したがって、Quality Center はテストまたはディフェクトを複数の要件にリンクできますが、CA Agile Central はテスト ケースまたはディフェクトのいずれかを 1 つのユーザ ストーリーにのみリンクします。

Quality Center から CA Agile Central のみにデータを移動するときに、テストまたはディフェクトの関係を保持するマッピングを設定することができます。CA Agile Central から Quality Center への関係はサポートされていません。

は、 要件がコネクタによって同期もされている場合に、バグまたはテストの要件へのリンケージを保持するのに役立ちます。このフィールド ハンドラは、リンクされた要件のバグやテストのリンク テーブルを検索します。CA Agile Central ID を持つ最初の要件は、CA Agile Central のディフェクトまたはテスト ケースをリンクするために使用されます。

現在の機能は、テスト ケースのディフェクトへのリンクをサポートしていません。

フィールド ハンドラを設定するには、フィールド マッピング セクションに TS_LINKED_REQ または BG_LINKED_REQ のいずれかをマップする必要があります。

テストからストーリーの場合:


  ....
  WorkProductTS_LINKED_REQTO_RALLY
  ....
  TS_LINKED_REQRQ_USER_NN
  ....
  WorkProductObjectID
  ....


上記の には、 CA Agile Central ユーザ ストーリー(上記の例では RQ_USER_nn)の ID を含めるために、Quality Center で作成したカスタム フィールドを指定します。これは、  フィールド(ユーザ ストーリーに要件をコピーするために以前に使用された設定ファイル内)と同じにする必要があります。

ディフェクトからストーリーの場合:


  ....
  RequirementBG_LINKED_REQTO_RALLY
  ....
  BG_LINKED_REQRQ_USER_NN
  ....
  RequirementObjectID
  ....


上記の には、 CA Agile Central ユーザ ストーリー(上記の例では RQ_USER_nn)の ID を含めるために、Quality Center で作成したカスタム フィールドを指定します。これは、  フィールド(ユーザ ストーリーに要件をコピーするために以前に使用された設定ファイル内)と同じにする必要があります。

注: このフィールド ハンドラの実行時に複数の要件がテストまたはディフェクトにリンクされる場合、コネクタは警告を記録します。

Quality Center からの参照フィールドのマップ

フィールド ハンドラ は、 Quality Center から CA Agile Central へのマッピングのみを可能にします。CA Agile Central から Quality Center へのマッピングは、このフィールド ハンドラではサポートされていません。このフィールド ハンドラは、CA Agile Central にマップされる以下の QC フィールドをサポートします。

  • BG_DETECTED_IN_RCYC
  • BG_DETECTED_IN_REL
  • BG_TARGET_RCYC
  • BG_TARGET_REL
  • RQ_TARGET_RCYC
  • RQ_TARGET_REL
  • RN_ASSIGN_RCYC
  • TC_ASSIGN_RCYC

以下の例では、  フィールド ハンドラを使用して、QC オブジェクトから名前を抽出します。


  ....
  ReleaseBG_DETECTED_IN_RELTO_RALLY
      ....
    BG_DETECTED_IN_REL
      ....

CA Agile Central テスト結果のテスト ケースへのマップ(実行で必須)

Quality Center 実行を CA Agile Central テスト ケース結果にコピーする場合、CA Agile Central テスト ケース結果は、テスト ケースに関連付けることで作成する必要があります。Quality Center で新しい実行が見つかると、フィールド マッピングが正しく設定されている場合、コネクタは Quality Center で関連付けられたテストの ID を検出します。以下に例を挙げます。

TestCaseRN_TEST_ID

次に、コネクタは、RN_TEST_ID 値を使用して、この ID に基づいて CA Agile Central でリンクされたテスト ケースを検索します。その結果、コネクタは、CA Agile Central テスト ケースのどのカスタム フィールドが、QC テストの一意の ID を保持しているかを知る必要があります。カスタム フィールド名がわかったら、テスト ケースの RallyReferenceFieldHandler を追加します。この例では、CA Agile Central のカスタム フィールド名に ExternalID を使用しています。


    ....
    TestCaseExternalID
          ....
      
    ....

実行日のマップ(実行で必須)

CA Agile Central テスト ケース結果オブジェクトの日付フィールドは、必須フィールドです(ISO 8601 UTC 準拠)。ただし、QC 実行オブジェクトでは、日付は RN_EXECUTION_DATE と RN_EXECUTION_TIME の 2 つのフィールドで表されます。QC 実行日の CA Agile Central テスト ケース結果日付へのマッピングをサポートするには、フィールド ハンドラ  (  セクション内)を使用します。以下に例を挙げます。

 ....
    TestCaseResult ....
    RUNRN_RUN_ID4DateRN_EXECUTION_DATETestCaseRN_TEST_ID
      ....
    TestCaseTCExternalIDRN_EXECUTION_DATE
      ....
    
    ....
  
    ....
  

CA Agile Central テスト ケースの CA Agile Central ストーリーへのマップ(テストでオプション)

CA Agile Central のストーリーの Quality Center テスト ステータスを追跡するために、Quality Center テスターは、Quality Center のテストに関する CA Agile Central ストーリーのフォーマット済み ID を入力できます。この機能をサポートするには、フィールド マッピングおよび RallyReferenceFieldhandler を追加します。

まず、テスト用の設定ファイルでは、CA Agile Central ストーリー(WorkItem)を、フォーマット済み ID を格納する QC ユーザ フィールドにマップする必要があります。

WorkItemTS_USER_xx

次に、  セクションに追加します。 このセクションは、フォーマット済み ID によってストーリーを検索するようコネクタに通知します。


  ....
  WorkItemFormattedID
  ....

フィールド ハンドラ

ドロップダウン値のマップ
日付のマップ
ユーザ名のマップ
CA Agile Central からの参照フィールドのマップ

複数の設定ファイル

複数の設定ファイルを設定することが必要な場合があります(マップするときなど)。

  • CA Agile Central の複数のワークスペース
  • 複数のアーティファクト タイプ
  • 他のシステムの複数のコンテナに対して(Quality Center のドメインやプロジェクトなど、使用されている各コンテナの ExternalID に固有の CA Agile Central カスタム フィールドが必要)

設定ファイルにわかりやすい名前を付けると、トラブルシューティングが簡単になります。

コネクタの複数のインスタンスを異なる設定ファイルに対して実行するには、以下のように毎回 1 つの設定ファイルを使用して複数回呼び出します。

ca_agile_central2_hpalm_connector.rb  alpha_project_config.xml the_omega_stories_config.xml -1

上記のコマンドは、呼び出しを容易にするために BAT ファイルに記述することができます。

XML タグ

セクションの  XML タグ

タグ名 説明 サンプル値
     
必須
このセクションを開始する親タグです。  
必須
CA Agile Central への接続に使用されるサーバ(http プレフィックスと /slm サフィックスは省きます。コネクタがこれらを指定された値に追加するためです)。 sandbox.rallydev.com
rally1.rallydev.com
myRally.mydomain.com
192.168.23.24
必須
ワーク アイテムをコピーまたは更新する CA Agile Central のワークスペース。このフィールドの特殊文字は、以下のようにエスケープする必要があります。& は & として入力する、> は > として入力する、 My Workspace
Dog & Pony WS
必須
プロジェクトのタグのリストが含まれます。各タグは、1 つの CA Agile Central プロジェクトを参照し、これは他のシステムにコピーする新しい CA Agile Central ワーク アイテムを検索するときに使用されます。CA Agile Central から他のシステムへワーク アイテムを更新する場合、 内のすべてのプロジェクトが 対象となります。このタグには、CA Agile Central プロジェクトを少なくとも 1 つは指定してください。このフィールドの特殊文字は、以下のようにエスケープする必要があります。& は & として入力する、> は > として入力する、 Rally1
Rally2
P3&4>
必須
CA Agile Central でワーク アイテムを作成および更新するための Web サービス リクエストを作成するユーザのログイン名。 [email protected]
必須
上記の に関連付けられたパスワード。. 注: クリア テキスト パスワードが格納されるのを回避するために、コネクタはこのパスワード文字列をエンコードし、設定ファイル内でそれを更新します。 mypassword
コネクタから CA Agile Central にアクセスするために使用されるアカウントの Rally APIKey (CA Agile Central Application Manager から)。これが指定されている場合、ユーザ名とパスワードを入力する必要はありません。値として使用される APIKey の値に関連付けられたユーザのホワイトリストは必要ありません。 ABC123plmokn43315...
必須
CA Agile Central で作成または更新するアーティファクトのタイプです。 (Defect, defect),
(story, user story, hierarchical requirement)、test case、test case result
必須
CA Agile Central のカスタム文字列フィールド(名前と表示名は同一である必要があります)で、他のシステムの一意の ID を格納します。「CA Agile Central での外部 ID フィールドの作成」を参照してください。 QCID
CA Agile Central WSAPI バージョン廃止に関する警告(WARN)メッセージを情報(INFO)メッセージに変更します。  

  
      
   /CopySelector>
   [....]
Quality Center にコピーする CA Agile Central の新しいイシューを検索するときに使用する条件。複数の条件は AND で結合されます。条件式ごとに、以下の形式を使用する必要があります。

各値は以下のとおりです。
は CA Agile Central のアーティファクト フィールドの名前で、
は =、!=、gt、lt、gte、lte のいずれかです
に対する有効な値です。
詳細については、「FAQ」セクションを参照してください。

Status = Open


Priority = Low

   
      
   /UpdateSelector>
   [....]
Quality Center で更新する CA Agile Central の既存のイシューを検索するときに使用する条件。複数の条件は AND で結合されます。条件式ごとに、以下の形式を使用する必要があります。

各値は以下のとおりです。
は CA Agile Central のアーティファクト フィールドの名前で、
は =、!=、gt、lt、gte、lte のいずれかです
に対する有効な値です。
詳細については、「FAQ」セクションを参照してください。

Release != alpha

   
      F1
      V1
   
   [....]
デスティネーション システムに必須フィールドがあり、そのフィールドが設定ファイルでマップされない場合に使用します。これによりフィールド F1V1 の値に設定されます。注*: アーティファクト COPY でのみ有効です。UPDATE サービスでは無効です。 詳細については、「必須フィールドのマップ」の FAQ を参照してください。
必須
このセクションを終了する親タグです。  

ヒント: CA Agile Central のワークスペースまたはプロジェクト名に含まれている特殊文字で、マークアップで意味を持つものは使用しないようにします。以下に例を挙げます。

& (アンパサンド)は &
に変換 > (より大きい)は >
に変換 (より小さい)は <
に変換
例: Research & Development → Research & Development

セクションの  XML タグ

タグ名 説明 サンプル値
     
必須
このセクションを開始する親タグです。  
必須
Quality Center サーバ名(または IP アドレス)とポート。構文: 通常、server:port のみが必要です。https (SaaS QC サーバへのアクセスなど)の場合、https://server:443/qcbin を使用します QCserverLocal:8080、
https://QCserverSaaS:443/qcbin
必須
Quality Center でエンティティを作成または更新するための API リクエストを作成するユーザのユーザ名。 myuser
必須
Quality Center でエンティティを作成または更新するための API リクエストを作成するユーザのパスワード。注: コネクタの最初の実行時に、プレーン テキスト パスワードが格納されるのを回避するために、コネクタはこのパスワードをエンコードし(暗号化とは異なります)、設定ファイルを書き換えます。 mypassword
必須
Quality Center で接続するドメインの名前です。 My Domain
必須
Quality Center で使用するプロジェクトの名前です。 My Project
必須
Quality Center で作成または更新するエンティティのエンティティ名。 BUG、
REQ、
TEST
Quality Center で作成された要件に設定する要件タイプ。  の値が REQ である場合のみ適用可能です。 Business、Folder、Functional、Group、Testing、Undefined またはご使用の
要件がコピーまたは更新される QC 要件ルート フォルダの下にあるフォルダの名前。これは、QC から CA Agile Central への要件のコピーには影響しません。  の値が REQ である場合のみ適用可能です。デフォルトでは、コピーした要件は要件ルート フォルダに直接配置されます。このフォルダは、コネクタを実行する前に存在していることが必要です(「RequirementFolderID」も参照)。 Release1
Southwest
Regulatory
要件がコピーまたは更新される QC 要件ルート フォルダの下にあるフォルダの ID。これは、QC から CA Agile Central への要件のコピーには影響しません。  の値が REQ である場合のみ適用可能です。デフォルトでは、コピーした要件は要件ルート フォルダに直接配置されます。このフォルダは、コネクタを実行する前に存在していることが必要です。これは、QC プロジェクトにフォルダ名が重複している場合に便利です(「RequirementFolder」も参照)。 123
456
必須
バグの一意の ID を格納する Quality Center フィールド(通常は BG_BUG_ID)。 BG_BUG_ID
必須
CA Agile Central ワーク アイテムの一意の ID (ObjectID)を格納するために使用される、文字列タイプの Quality Center のカスタム ユーザ フィールド。「Quality Center での外部 ID ユーザ フィールドの作成」を参照してください。 BG_USER_01
CA Agile Central ワーク アイテムのフォーマット済み ID (DExx)を格納するために使用される、文字列タイプの Quality Center のカスタム ユーザ フィールド。「Quality Center での外部 ID ユーザ フィールドの作成」を参照してください。 BG_USER_02
CA Agile Central の対応するアーティファクトへの html テキスト情報が含まれる QC のカスタム フィールド(文字列フィールド タイプ)。コピーの場合にのみ入力されます。 RallyURL

   
      
   /CopySelector>
   [....]
CA Agile Central にコピーする Quality Center の新しいイシューを検索するときに使用する条件。複数の条件は AND で結合されます。条件式ごとに、以下の形式を使用する必要があります。

各値は以下のとおりです。
は Quality Center のアイテム フィールドの名前です
は =、!=、gt、lt、gte、lte のいずれかです
に対する有効な値です。

BG_STATUS = Open


BG_PRIORITY = High

QC で許可されている CopySelectors の詳細については、「CopySelector および UpdateSelector」を参照してください。

   
      
   /UpdateSelector>
   [....]
CA Agile Central で更新する Quality Center の既存のイシューを検索するときに使用する条件。複数の条件は AND で結合されます。条件式ごとに、以下の形式を使用する必要があります。

各値は以下のとおりです。
は Quality Center のアイテム フィールドの名前です
は =、!=、gt、lt、gte、lte のいずれかです
に対する有効な値です。

BG_TARGET_REL != alpha

QC で許可されている UpdateSelectors の詳細については、「CopySelector および UpdateSelector」を参照してください。

   
      F1
      V1
   
   [....]
デスティネーション システムに必須フィールドがあり、そのフィールドが設定ファイルでマップされない場合に使用します。これによりフィールド F1V1 の値に設定されます。アーティファクト COPY でのみ有効です。UPDATE サービスでは無効です。 詳細については、「必須フィールドのマップ」の FAQ を参照してください。
必須
このセクションを終了する親タグです。  

セクションの  XML タグ


タグ名 説明 サンプル値
     
必須
このセクションを開始する親タグです。  
必須
2 つのシステム間でマップされるフィールドを指定します。 フィールド マッピング」を参照してください。
(開始タグ)  
   
      name-of-field
      CompanyName.com
   
システム間でユーザ名をマッピングします。 は、QC のフィールドの名前です。FAQ の「ユーザ名のマップ」セクションを参照してください。 Bug_Owner
   
      ....
   
2 つのシステム間で、異なるドロップダウン値のマッピングを可能にします。 ドロップダウン値のマップ」を参照してください。
   
      ....
   
と似ていますが、この場合は例外のみを宣言する必要があります。2 つのシステムのプルダウン リストの対応するエントリが同一の場合は宣言する必要がありません。
   
      
         Dest-field
      
      
         Src-field1
         Src-field2
         .....
      
   
Dest-field のコンテンツを最初の文字列として使用して、Src-fieldNDest-field に追加し、HTML の改行タグ(
)を使用して追加のフィールド値を区切ります。


BG_DEV_COMMENTS


BG_DESCRIPTION
BG_USER_02
.....
   
      name-of-field
   
CA Agile Central アーティファクト内のリンクを QC 11/HP ALM 12 添付ファイルに格納します。「QC 添付ファイルのマップ」を参照してください。 BG_ATTACHMENT
RQ_ATTACHMENT
   
      name-of-field
   
CA Agile Central フィールドのリッチ テキスト(html)メタデータの一部をより適切な QC バージョンに変換します。「QC マークアップ フィールドのマップ」を参照してください。 BG_DESCRIPTION
BG_DEV_COMMENTS
RQ_REQ_COMMENT
TS_DESCRIPTION
   
      
         name-of-field
      

   
と組み合わせて使用します。
QC ユーザ名が指定されると、その QC ユーザの電子メール アドレスが返されます。この電子メール アドレスは、 に渡されます(およびその逆も行われます)。
name-of-field の有効な値:
所有者タイプのフィールド(BG_RESPONSIBLE、RQ_REQ_AUTHOR、TS_RESPONSIBLE、RN_TESTER_NAME など)。
   
      name-of-field
   
  RN_EXECUTION_DATE
(終了タグ)  
(開始タグ)  
   
      
         name-of-field
      
      
         name-of-object
      
   
オブジェクトからフィールドをマップするために使用します。

ObjectID, FormattedID, Name


Project, Release, Iteration
   
      
         name-of-object
      
      
         name-of-field
      
   
ユーザ名をマップするために使用します。「ユーザ名のマップ」を参照してください。

User,Owner,Tester


Name,FormattedID
   
      
         name-of-field
      
   
と組み合わせて使用します。
CA Agile Central ユーザの電子メール アドレスが指定されると、CA Agile Central ユーザが返されます(およびその逆も行われます)。
name-of-field の有効な値:
User, Owner, SubmittedBy, Tester
   
      F1
      S1
   
双方向。
CA Agile Central から他のシステム: フィールド F1 内の CA Agile Central の ISO 日付を、文字列 S1 で指定されたとおりにフォーマットされた日付文字列に(Ruby の DateTime.strftime 関数に従って)変換し、この新しい日付文字列を F1 がマップされているフィールドに格納します。
他のシステムから CA Agile Central: F1 がマップされているフィールドに含まれる日付文字列が(Ruby の DateTime.parse に従って) CA Agile Central の ISO 日付に変換され、CA Agile Central の F1 フィールドに格納されます。この場合は文字列 S1 が使用されないことに注意してください。

TestDate
%m-%d-%Y%H:%M:%S
   
      ....
   
2 つのシステム間で、異なるドロップダウン値のマッピングを可能にします。 ドロップダウン値のマップ」を参照してください。
   
      
         Dest-field
      
      
         Src-field1
         Src-field2
         .....
      
   
Dest-field のコンテンツを最初の文字列として使用して、Src-fieldNDest-field に追加し、HTML の改行タグ(
)を使用して追加のフィールド値を区切ります。


カスタム フィールド


説明
その他のフィールド
.....
   
      
         name-of-field
      
      
         name-of-file
      
   
マップされているフィールドの名前(name-of-field)と、ユーザ マッピングが格納されている CSV ファイル(name-of-file)を指定します。CSV ファイルを使用して、その中に指定されたマッピングに基づいてユーザ名をルックアップおよび変換します。これは、大文字と小文字が区別されます。詳細については、「FAQ ページ」または「XML ファイルの例」を参照してください。

SubmittedBy


MyUserMappings.csv
   
      
         name-of-Rally-field
      
      
 false
HP-ALM-field-value

 true
HP-ALM-field-value

      
   
CA Agile Central ブール値フィールドの HP ALM フィールドへのマッピングを指定します。両方向で機能します。詳細については、「FAQ ページ」を参照してください。  

   
     name-of-Rally-field
   
受信した CA Agile Central データを 32000 文字に切り捨てることができます。これは、[説明]フィールドで適切に機能します。  
(終了タグ)  
(開始タグ)  
    QC と CA Agile Central の間で添付ファイルをコピーするために使用します(双方向)。添付ファイルをサポートしている任意のオブジェクトで使用できます(CA Agile Central のタスク、ディフェクト、ストーリー、テスト、および QC の要件、ディフェクト、テスト)。詳細については、「QC 添付ファイルのマップ」を参照してください。
   
      
         name-of-field
      
   
name-of-field は、要件/ストーリーの設定ファイルの CA Agile Central カスタム フィールドです。 QCReqID
(終了タグ)  
必須
このセクションを終了する親タグです。  

セクションの  XML タグ

タグ名 説明 サンプル値
     
必須
このセクションを開始する親タグです。  
テストのプレビュー モードを有効にできます。プレビューでは、どちらのシステムでもオブジェクトのコピーまたは更新は行われません。 False (デフォルト)
True
ログ ファイルに書き込まれるメッセージのタイプを指定します。最高レベルはデバッグ(Debug)で、すべてのメッセージが表示されます。 Fatal
Error
Warn
Info (デフォルト)
Debug
必須

コピー サービスを使用してシステム間で最初にアイテムを反映させ、次に更新サービスを使用してそれらの反映されたアイテムを最新の状態にします。

代わりの更新サービスは、最初に CA Agile Central で更新を検索し、新たに変更されたフィールドのみをもう一方のシステムにプッシュします。次にもう一方のシステムで更新を検索し、マップされているすべてのフィールドを CA Agile Central にプッシュします。これにより、両方のシステムで変更が加えられる際に、上書きの発生が少なくなります。

コピー サービス:

COPY_QC_TO_RALLY
COPY_RALLY_TO_QC

更新サービス:

UPDATE_QC_TO_RALLY
UPDATE_RALLY_TO_QC

代わりの更新サービス:

UPDATE_RALLYFIELDS_AND_OTHER (他の更新サービスとの連携では使用できない可能性があります)

詳細については、「FAQ」を参照してください。


   
CA Agile Central ユーザ ストーリー階層を QC 要件階層(一方向のみ)に移動するように、コネクタに指示します。 と同じ設定ファイルでは使用できません.

   
      number

QC 要件階層を CA Agile Central ユーザ ストーリー階層(一方向のみ)に移動するように、コネクタに指示します。 と同じ設定ファイルでは使用できません. この機能は、1) QC の要件アーティファクト、2) CA Agile Central のユーザ ストーリー アーティファクト、3)タスクを持たない親でのみ機能します。
デフォルトでは、CA Agile Central にコピーされた QC 要件には、完全な QC フォルダ パス名(要件から開始)があります。CA Agile Central フォルダに完全パス名のサブセットで名前を付けるには、 エレメント内の最上位のフォルダ ID を指定することで、開始点(フォルダ名) を指定します。

   value
   value
   value
   value
   value
   value
   value
   value
この機能の開始タグ。
電子メールで送信するログ ファイル メッセージ。






この機能の終了タグ。
以下の例を参照してください
エラーまたは警告
[email protected]
[email protected]
smtp.acme.com
587
[email protected]
パスワード
TLS
 
必須
このセクションを終了する親タグです。  

 XML タグ

これらは、 セクションと同じです (親タグが である点を除く)。.

 XML タグ

タグ名 説明 サンプル値
     
必須
このセクションを開始する親タグです。  
必須
Quality Center サーバ名(または IP アドレス)とポート。構文は「server:port」です。 myqcserver:8080
必須
Quality Center でエンティティを作成および更新するための API リクエストを作成するユーザ。 myuser
必須
Quality Center でエンティティを作成および更新するための API リクエストを作成するユーザのパスワード。注: コネクタの最初の実行時に、パスワードはエンコードされるため、プレーン テキストでは保存されません。 mypassword
必須
Quality Center で接続するドメインです。 MyCompany.com
必須
Quality Center で接続するプロジェクトです。 My Project
必須
Quality Center で作成および更新するエンティティのエンティティ名。 TEST
Quality Center で新しくコピーされたテストを配置するサブジェクトの下にある[テスト計画]フォルダの名前。このフォルダは、コネクタを実行する前に存在していることが必要です。 Iteration1、UI-Responsiveness
必須
テストまたは他のエンティティの一意の ID を格納する Quality Center フィールド。 TS_TEST_ID
必須
CA Agile Central ワーク アイテムの一意の ID を格納する、文字列タイプの Quality Center のユーザ フィールド。「Quality Center での外部 ID ユーザ フィールドの作成」を参照してください。 TS_USER_01
必須
このセクションを終了する親タグです。  

 XML タグ

このタグは、QC のテストを処理する場合に使用されます。 セクションのすべてのタグ、 および以下のタグをサポートしています。
タグ名 説明 サンプル値
     
必須
このセクションを開始する親タグです。  
Url>
必須
Quality Center サーバ名(または IP アドレス)とポート。 server.port
必須
Quality Center で接続するドメインの名前です。 My Domain
必須
Quality Center で使用するプロジェクトの名前です。 My Project
必須
Quality Center のユーザ名。 [email protected]
必須
上記のユーザ名に関連付けられているパスワード。 mypassword
必須
QC で作成または更新するアーティファクトのタイプです。 BUG、REQ、TEST
Quality Center で新しくコピーされたテストを配置するサブジェクトの下にある[テスト計画]フォルダの名前。このフォルダは、コネクタを実行する前に存在していることが必要です。 Iteration1、UI-Responsiveness
必須
テスト実行の一意の ID を格納する Quality Center フィールド。 RN_RUN_ID
必須
テストまたは他のエンティティの一意の ID を格納する、文字列タイプの Quality Center のユーザ フィールド。 TS_User_01
コネクタが新しい QC 実行の過去を検索して CA Agile Central テスト ケース結果にコピーし、(CA Agile Central テスト ケースに関連付ける)期間。日数で指定します。デフォルトは 1 日です。 1 (デフォルト)
2
必須
このセクションを終了する親タグです。  

 XML タグ

タグ名 説明 サンプル値
     
必須
このセクションを開始する親タグです。  
必須
2 つのシステム間でマップされるフィールドを指定します。 フィールド マッピング」を参照してください。
開始タグ。  
   
      ....
   
2 つのシステム間で、異なるドロップダウン値のマッピングを可能にします。 ドロップダウン値のマップ」を参照してください。
   
      
         name-of-field
      
   


TS_SUBJECT
終了タグ。  
より複雑なフィールドのマッピングに使用されます。  
    CA Agile Central のテスト ケースおよびステップから QC のテストおよびテスト ステップへのコピーに使用されます(注: 更新はサポートされていません)。  
      
         positional-name
      
QC テスト ステップのリストで CA Agile Central の入力の検証または検証の予期される結果を配置する場所をコネクタに指示します。HP ALM のデザイン テスト ステップのリストに余分な空のステップを必要としない場合は、このタグを完全に省略します。
Last
First
      
         
            
               name-of-field
            
            
               name-of-field
            
         
         ....
      
QC-config-test-steps-01.pxml の例を参照してください


ExpectedResult


DS_EXPECTED
     終了タグ。 設定ファイル QC-config-test-steps-01.pxml の例を参照してください
     QC のテストおよびテスト ステップから CA Agile Central のテスト ケースおよびステップへのコピーに使用されます(注: 更新はサポートされていません)。 設定ファイル QC-config-test-steps-02.pxml の例を参照してください
終了タグ。  
開始タグ。  
   
      
         name-of-field
      
      
         name-of-object
      
   
オブジェクトからフィールドをマップするために使用します。

ObjectID, FormattedID, Name

Project, Release, Iteration
   
      
         ObjectName
      
      
         name-of-field
      
   
ユーザ名をマップするために使用します。「ユーザ名のマップ」を参照してください。

User, Owner, Tester, ...


Name, FormattedID, ...
   
      ObjectName
   
オブジェクト ObjectName の電子メール アドレスを使用します。 User, Owner, Tester, ...
   
      F1
      S1
   
双方向。
CA Agile Central から他のシステム: フィールド F1 内の CA Agile Central の ISO 日付を、文字列 S1 で指定されたとおりにフォーマットされた日付文字列に(Ruby の DateTime.strftime 関数に従って)変換し、この新しい日付文字列を F1 がマップされているフィールドに格納します。
他のシステムから CA Agile Central: F1 がマップされているフィールドに含まれる日付文字列が(Ruby の DateTime.parse に従って) CA Agile Central の ISO 日付に変換され、CA Agile Central の F1 フィールドに格納されます。この場合は文字列 S1 が使用されないことに注意してください。

TestDate
%m-%d-%Y%H:%M:%S
   
      ....
   
2 つのシステム間で、異なるドロップダウン値のマッピングを可能にします。 「ドロップダウン値のマッピング」を参照してください。
    
        
           name-of-folder
        
    
QC-config-CopyTests2test cases.pxml の例を参照してください。

TestFolder
終了タグ。  
必須
このセクションを終了する親タグです。  

 

 XML タグ

タグ名 説明 サンプル値
     
このセクションを開始する親タグです。  
テストのプレビュー モードを有効にできます。プレビューでは、どちらのシステムでもオブジェクトのコピーまたは更新は行われません。 False (デフォルト)
True
ログ ファイルに書き込まれるメッセージのタイプを指定します。最高レベルはデバッグ(Debug)で、すべてのメッセージが表示されます。 Fatal
Error
Warn
Info (デフォルト)
Debug
必須

コピー サービスを使用してシステム間で最初にアイテムを反映させ、次に更新サービスを使用してそれらの反映されたアイテムを最新の状態にします。

代わりの更新サービスは、最初に CA Agile Central で更新を検索し、新たに変更されたフィールドのみをもう一方のシステムにプッシュします。次にもう一方のシステムで更新を検索し、マップされているすべてのフィールドを CA Agile Central にプッシュします。

コピー サービス:

COPY_QC_TO_RALLY
COPY_RALLY_TO_QC

更新サービス:

UPDATE_QC_TO_RALLY
UPDATE_RALLY_TO_QC

代わりの更新サービス:

UPDATE_RALLYFIELDS_AND_OTHER (他の更新サービスとの連携では使用できない可能性があります)

詳細については、「FAQ」を参照してください。

このセクションを終了する親タグです。  

ヒント: コネクタは徐々にセットアップするようにします。基本的な設定ファイルで開始し、テスト環境で Quality Center および CA Agile Central に接続できることをテストしてください。接続が正しく設定されていることを確認したら、フィールドのマッピングとハンドラのセクションのカスタマイズを開始します。

コネクタの実行

ワーク アイテム モード

コネクタは以下のコマンド ライン フラグを受け入れます。

ca_agile_central2_hpalm_connector.rb -h

使用方法: C:/Users/hflygare/Ruby22-x64/bin/ca_agile_central2_hpalm_connector.rb 
 の意味:
    --version, -v: コネクタのリビジョン番号を出力します。
    --preview, -p: コネクタをプレビュー モードで実行し、実際にはアイテムをコピーまたは更新しません。
    --log-file-size, -s : ログ ファイルの最大サイズを  メガバイトに設定します。
    --max-log-files, -m : ログ ファイルのローテーションでのファイルの最大数を  に設定します。
    --help, -h: この使用方法メッセージを出力します。
    --cleartext, -c: 認証情報がすでにクリア テキストで保存されている場合、暗号化を省略します。

 の意味
  コネクタ設定を指定する XML ファイルを参照するファイル システム。
  通常の拡張子は .xml です。

 の意味
  最初のコマンドを実行した後、コネクタが次に実行されるまでの間隔(分数)です。
  -1 の場合は、コネクタを 1 度だけ実行してその後終了します。

環境を反映するように qc_config.xml ファイルを編集したら、コネクタの実行を開始できます。コマンド プロンプトまたは端末を開き、以下のコマンドを入力します。

ca_agile_central2_hpalm_connector.rb  alpha_project_config.xml -1

上記でコネクタが実行されない場合、または「ruby: そのようなファイルまたはディレクトリはありません -- ca_agile_central2__connector.rb (LoadError)」というエラーが表示される場合、コマンドの先頭に「ruby」を追加してみてください。

ruby ca_agile_central2_hpalm_connector.rb  alpha_project_config.xml -1

これにより、サービスが開始されます。設定ファイルの名前を qc_config.xml 以外にした場合は、コマンド ラインでその名前を使用します。最後の引数である -1 は、1 回実行してから終了するようコネクタに指示します。

注: 以前は、最後の引数に 10 などの正の整数値の使用を推奨していたことがありました。これは、コネクタを実行し、10 分間のスリープの後、このプロセスを繰り返すということを指示しています。現在では、このように使用すると、環境によっては問題が発生する可能性がある(および、問題の切り分けが難しい)と助言しています。最後の引数に -1 を使用し、コネクタを定期的に実行する場合は cron を設定することを強くお勧めします。

ファイル rallylog.log は、コネクタによって生成され、ログイン情報が含まれています。コネクタが正しく動作している証拠をログ ファイルに表示します。

ヒント: CA Agile Central には、テストを容易にするための startqc.bat ファイルが付属しています。使用する設定ファイルの名前が qc_config.xml ではない場合、設定ファイル名を参照するように startqc.bat ファイルを編集する必要があります。

サービスを停止するには、コマンド シェルで Ctrl + C キーを使用します。

テスト モード

qc_config*.xml ファイルがセットアップされたら、コネクタの実行を開始できます。

コネクタを起動するには、コマンド プロンプトまたは端末を開き、以下のように入力します。

 ca_agile_central2_hpalm_connector.rb  alpha_project_config.xml -1

認証情報の暗号化(2015 年 5 月に追加)

コネクタのバージョン 4.6.0 以降、設定ファイルの *Connection セクションでクリア テキストで指定されている認証情報は、その設定ファイルを使用してコネクタを最初に実行したときに暗号化されます。認証情報は、*Connection セクションで、名前が *User または *Password や APIKey である設定アイテム タグとして認識されます。

Emailer セクションの認証情報(SMTPUser および SMTPPassword)も引き続きエンコードされます。認証情報の暗号化は、コネクタのインストールおよび設定ファイルのさまざまな側面に対してローカライズされています。

実際には、インストールと実行のフォルダが定数として指定されており、CA Agile Central の主な設定パラメータを変更しない限り、認証情報をクリア テキスト値にリセットしなくても、設定ファイルのほとんどのコンテンツを変更することができます。ただし、そのような安定した環境で実行していない場合は注意してください。その場合は、ログ ファイルを頻繁にチェックして、コネクタの実行時に使用される暗号化された値の復号化が環境の変更によって妨げられていることを示すエントリがないか確認するようにしてください。

注: -c オプションを使用すると、パスワードを暗号化せずにクリア テキストのままにすることができます。コネクタを実行するためのコマンド ラインは ca_agile_central2_qc_connector.exe -c configfile.xml です。必要に応じて、コマンドの最後に -1 オプションを使用することもできます。

ログ記録パラメータの変更

コネクタは、処理の過程で生じるログ メッセージを、現在の作業ディレクトリ内の rallylog.log ファイルに記録します。デフォルトでは、ログ ファイルの最大サイズは 5 MB で、ログ ローテーションは 10 個のファイルに制限されています。コマンド ライン引数を指定することにより、ログ ファイルの最大サイズと、ログ ローテーション内のログ ファイルの最大数を調整することができます。

-s オプションを使用して、ログ ファイルの最大サイズを MB の単位で指定できます(最大 100 MB まで)。これは --max-log-file-size としても指定できます。

-m オプションを使用して、ログ ファイルのローテーション スキーマ内のファイルの最大数を指定できます。これは --max-log-files-count としても指定できます。

例: コネクタの 1 回の呼び出しに対してログ ファイルの最大サイズを 50 MB に設定し、ログ ファイル ローテーションの最大数を 20 ファイルに設定するには、以下のように指定します。

ca_agile_central2_qc_connector.rb -s 50 -m 20 xxx_config.xml -1 

または 

ca_agile_central2_qc_connector.rb --max-log-file-size 50 --max-log-files-count 20 xxx_config.xml -1

テストおよびテスト ケースの管理

CA Agile Central と Quality Center のコネクタを使用する場合、以下のことを実行できます。

Quality Center でのテスト実行の作成

新規テスト新規テスト セットテストの選択

[Execution Grid (実行グリッド)]タブに、テスト インスタンスが表示されます。

[Execution Grid (実行グリッド)]タブのテスト インスタンス

ステップを追加することができます。

ステップを成功または失敗にします。

  1. [テスト計画]でテストを作成します。
  2. [テスト ラボ]でテスト セットを作成します。
  3. [Execution Grid (実行グリッド)]タブから、[テストの選択]を選択します。[Test Plan Tree (テスト計画ツリー)]が表示されます。
  4. [Test Plan Tree (テスト計画ツリー)]からテストを選択し、緑の矢印を選択してテスト インスタンスを作成します。
  5. [実行]を選択し、[Begin Run (実行の開始)]を選択します。
  6. テスト実行を保存します。

Quality Center から CA Agile Central へのテストおよび実行のコピー

以下のスクリーンショットは、テスト ケースと実行のアーティファクト タイプ用の Quality Center で作成されたカスタム フィールド、およびテスト ケースのワーク アイテム タイプ用の CA Agile Central で作成されたカスタム フィールドを示しています。これらのフィールドは、他のシステムの対応するアーティファクトの ID を格納するためのものです。

以下に、対応する CA Agile Central テスト ケースのオブジェクト ID を保持するための Quality Center のテスト用に作成されたカスタム フィールドを示します。

ObjectID のカスタム フィールド

以下に、対応する CA Agile Central テスト ケース結果のオブジェクト ID を保持するための Quality Center の実行用に作成されたカスタム フィールドを示します。

テスト ケース結果の ObjectID のカスタム フィールド

以下に、対応する Quality Center テストの ID を保持するための CA Agile Central のテスト ケース用に作成されたカスタム フィールドを示します。

Quality Center テストの ID のカスタム フィールド

これは対称となっていないことに注意してください。CA Agile Central の TestCaseResult ワーク アイテム タイプでは、カスタム フィールドを作成することはできません。CA Agile Central のテスト ケース結果への Quality Center の実行のマッピングのサポートでは、1 方向(Quality Center から CA Agile Central へ)のコピー サービスのみをサポートしています。

ファイルの関連する抜粋を以下に示します。

テストおよびテスト ケースの設定ファイルの では、以下のようになります。

TestCaseTCExternalID

テスト ケースの同じ設定ファイルの では、以下のようになります。

MyTestFolderTS_TEST_IDTS_USER_01

実行およびテスト ケース結果の設定ファイルの では、アーティファクト タイプが TestCaseResult によって指定されていますが、CA Agile Central 側には ExternalIDField がありません。

実行およびテスト ケース結果の同じ設定ファイルの では、以下のようになります。

RN_RUN_IDRN_USER_01TS_USER_01

には、テストおよびテスト ケースの設定ファイルの と同じ値があることに注意してください。これは、実行とテスト(テスト ケース結果とテスト ケース)の間のリンクがどのように維持されるかということです。

両方の設定ファイルでコネクタを実行します

以下に、CA Agile Central テスト ケースへの Quality Center テストのコピーに関連する rallylog エントリのスクリーンショットを示します。

CA Agile Central テスト ケースへの Quality Center テストのコピー

以下に、CA Agile Central テスト ケース結果への Quality Center 実行のコピーに関連する rallylog エントリのスクリーンショットを示します。

CA Agile Central テスト ケース結果への Quality Center 実行のコピー

以下に、新しく作成された CA Agile Central テスト ケースの詳細ページのスクリーンショットを示します。左の[結果]リンクでは、このテスト ケースに関連付けられたテスト ケース結果もあることを示していることに注意してください。

テスト ケース
テスト ケース結果
  1. インストール ガイドで説明されている手順に従って、コネクタを設定します。
  2. テスト実行を作成したら、両方の設定ファイルでコネクタを実行します。

CA Agile Central から Quality Center へのテスト ケースのコピー

コネクタの実行

テストが Quality Center で作成されます。TS_USER_01 というラベルが付いた CA Agile Central ID フィールドに、対応する CA Agile Central テスト ケースのオブジェクト ID が入力されていることに注意してください。

Quality Center で作成されたテスト

CA Agile Central 側では、元のテスト ケースに、対応する Quality Center テストの ID が入力されたカスタム フィールド TCExternalID があります。

このテストのテスト インスタンスをテスト ラボで作成し、Quality Center から CA Agile Central に実行をコピーする必要がある場合は、このドキュメントで以前に説明した手順に従います。実行は、Quality Center から CA Agile Central にのみコピーできることに注意してください。コネクタは、CA Agile Central から Quality Center へのテスト ケース結果のコピー サービスをサポートしていません。

  1. CA Agile Central でテスト ケースを作成します。
  2. セクションのテストおよびテスト ケースの xml 設定ファイルには、以下を指定して、(テスト計画の)既存の Quality Center テスト フォルダが存在している必要があります。
    MyTestFolder

    テスト ケースを CA Agile Central から Quality Center にコピーする場合、このフォルダに移動する必要があります。

  3. コネクタを実行します。

CA Agile Central から Quality Center へのテスト ケースの更新

コネクタの実行
Quality Center のテスト ケース
  1. CA Agile Central でテスト ケースを更新します。
  2. コネクタを実行します。

Quality Center から CA Agile Central へのテスト ケースの更新

Quality Center でテスト ケースを更新しますコネクタの実行
更新されたテスト ケース
  1. Quality Center でテスト ケースを更新します。
  2. コネクタを実行します。CA Agile Central の対応するテスト ケースが更新されます。

CA Agile Central ストーリーの CA Agile Central テスト ケースへのリンク

CA Agile Central ストーリーにリンクされて、CA Agile Central にテスト ケースが作成されます。

Quality Center でテストを作成します

CA Agile Central WorkProduct フィールドの CA Agile Central ユーザ ストーリー US93 のフォーマット済み ID。このフィールドは、設定ファイルに示されている同じ CA Agile Central ワークスペースとプロジェクト内の CA Agile Central で実際のストーリーを参照します。

このセットアップの目的は、テストが Quality Center から CA Agile Central にコピーされるときに、CA Agile Central の既存のユーザ ストーリーに以下の手順に従ってリンクされていることを確認することです。CA Agile Central 側では、TestCase オブジェクトの WorkProduct フィールドを通じてリンクが行われます。

コネクタの実行
ストーリーにリンクされたテスト ケース
  1. Quality Center でテストを作成します。CA Agile Central フォーマット済み ID のユーザ フィールドを作成します
    WorkProductTS_USER_02
    WorkProductFormattedID

xml 設定ファイルの Connector セクションのコンテキストの構文の例:

NameTS_NAMEWorkProductTS_USER_02DescriptionTS_DESCRIPTIONWorkProductFormattedID
  1. CA Agile Central フォーマット済み ID を保持するテスト アーティファクトのユーザ フィールドを Quality Center に作成します。フィールドは文字列タイプにする必要があります。
  2. このマッピングを、テストおよびテスト ケースの設定ファイルの FieldMapping セクションに追加します。
  3. RallyReferenceFieldHandler を同じ設定ファイルの RallyFieldHandlers セクションに追加します。
  • コネクタを実行します。

  • CA Agile Central ストーリーにリンクされて、CA Agile Central にテスト ケースが作成されます。
    ストーリーにリンクされたテスト ケース
  • コネクタのトラブルシューティング

  • rallylog.log ファイル
    コネクタが実行されると、すべてのエラーは、ca_agile_central2_qc_connector.exe が起動された作業ディレクトリ内の rallylog.log に書き込まれます。情報メッセージ、警告、およびエラーは、設定ファイルの セクションの タグの値に応じて、 ログ ファイルに書き込まれます。
  • .bat (バッチ)ジョブとしてコネクタを実行する場合にログ ファイルが書き込まれない
    コネクタがバッチ ジョブとして実行されている場合は、バッチ ジョブを所有および実行するユーザに、ログ ファイル ディレクトリへのアクセス権があることを確認します。
  • コネクタの検証
    コネクタは、2 つのシステム間のオブジェクトの同期を開始する前に、以下の検証を実行します。
    • CA Agile Central への接続が成功したこと
    • QC システムへの接続が成功したこと
    • フィールド マッピング セクションの CA Agile Central フィールドが CA Agile Central に存在すること
    • フィールド マッピング セクションの QC フィールドが他のシステムに存在すること
    • 指定された各フィールド ハンドラの対応するフィールド マッピング セクションが設定ファイルに含まれていること

    2 つのシステム間でオブジェクトを移動せずに検証が正常に行われたことを確認するには、設定ファイルの  タグを true に設定します。これは、問題をデバッグするために異なる設定オプションを試す場合に役立ちます。

  • 日時フィールド ハンドラ
    日付フィールドをマップする場合、フィールドの変換方法をコネクタに指示するためにフィールド ハンドラが必要です。適切な設定は以下のようになります。 
  • .....
              TargetDateBG_CLOSING_DATE
            .....
            BG_CLOSING_DATE

       

    上記の fieldhandler が指定されていない場合、以下のようなエラーが表示されることがあります。

    DEBUG : Connector.block in map_fields_to_rally - Mapping
                    BG_CLOSING_DATE(2013-03-05 00:00:00 +0000)
                            - to -
                    TargetDate(2013-03-05 00:00:00 +0000)
      WARN : RallyConnection.initialize - 
                            解析できませんでした: "null" を日付に変換できません。
                            ISO8601 日付 + 時刻形式を使用する必要があります。
  • EnvironmentalKey の ident_vector が有効でないエラー

    以下のエラーは、QC コネクタ バージョン 4.6.0 以降で発生する可能性があります。このエラーが発生したら、QC と CA Agile Central の両方のユーザ ID とパスワードを再入力します。 

     

    .....
              ERROR : Class.initialize - EnvironmentalKey ident_vector not valid for decryption target value

     

  • カスタム フィールドのハンドラの調整

    カスタム フィールド ハンドラを使用している場合、read_config メソッドを編集し、主要引数が fh_info (Ruby Hash インスタンス)であり、それを検証して @field_name を割り当てるコードが以下のようになるようにします。

    fh_info.each do |name, value|
              if name == 'FieldName'
                  @field_name= value
              end
           end
  • ベスト プラクティス

    探しているものがこのセクションで見つからない場合は、一般的なワーク アイテム コネクタのベスト プラクティスをここで確認してください。

  • CA Agile Central プロジェクトのマップ

    Quality Center から CA Agile Central にディフェクトをコピーし、QC フィールドを CA Agile Central プロジェクト フィールドにマップしている場合、コネクタ ユーザが CA Agile Central でそのプロジェクトに対して編集権限を持っていない場合、ログ ファイルに「... という名前の CA Agile Central プロジェクトが見つからない」 という内容のメッセージが示されることがあります。

    RallyReferenceFieldHandlers は、ほとんど廃止されています。 4.4.2 より前のリリースでは、複数のプロジェクトが設定ファイルに指定されていた場合、リリースまたはイテレーションの値が正しくマップされないことがありました。一部のロジックを再配置することによって、この問題に対応し、設定ファイルに明示的に記載しなくても、最も一般的な CA Agile Central の参照フィールド(プロジェクト、リリース、イテレーション)を自動的に処理できるようになりました。設定ファイルで、前述のフィールドのうちの 1 つに RallyReferenceFieldHandler を指定した場合、コネクタは廃止を警告するメッセージをログ ファイルに出力します。そのロジックは自動的に処理できるようになったためフィールド ハンドラの登録は行われません。一部のエッジ ケースで RallyReferenceFieldHandler の使用が必要になる可能性もあります(たとえば、親、子、ワークプロジェクト、所有者、その他同様のフィールド)。
  • Quality Center でのペシミスティック ロック

    ブラウザを使用して QC でエンティティが選択されると、QC はレコードを編集しているとみなすため、エンティティをロックします。レコードをロックしている場合、UPDATE_RALLY_TO_QC サービスは CA Agile Central アーティファクトを QC のエンティティに更新しません(ログ ファイルのエラーには、これがいつ発生したかが示されます)。


  • 1 つの CA Agile Central ワークスペースへの複数の Quality Center プロジェクトのマップ

    複数の Quality Center プロジェクトを 1 つの CA Agile Central ワークスペースにマップする場合、これを正常に実行するための重要な考慮事項があります。

    • QC アーティファクトの ID は複数の QC プロジェクト間で一意ではないため、QC ID に対応する外部 ID フィールドに同じ値を持つ複数の CA Agile Central アーティファクトが作成される可能性があります。
    • CA Agile Central から QC に更新する場合、更新はデフォルトで CA Agile Central ワークスペースでスコープされ、CA Agile Central プロジェクトでスコープされません。複数の QC プロジェクトが同じ CA Agile Central ワークスペースにマップされるシナリオでは、このワークスペース内の CA Agile Central プロジェクトをそれぞれの QC プロジェクトに直接対応するようにすることをお勧めします。各 CA Agile Central プロジェクト/QC プロジェクトのペアごとに個別の設定ファイルを作成する必要があります。
    • 各設定ファイルは、CA Agile Central の範囲を、RallyConnection のプロジェクト タグで現在参照されている CA Agile Central プロジェクトへの QC の更新に絞り込む必要があります。

  • QC 要件にマップされた CA Agile Central ストーリーのコピーまたは分割

    すでに QC に対応する要件を持つ CA Agile Central ストーリーをコピーまたは分割する場合は、必ず ExternalID フィールドの値を削除してください。そうしないと、元のストーリーのコピーには、元のストーリーの ExternalID フィールドが入ったままになります。これは、CA Agile Central と QC のアーティファクトの間に多対 1 のマッピングを作成し、データの整合性に影響するため、望ましくありません。

  • 既知の問題

    win32com がインストールされていないときのエラー

    • 解決策: win32com モジュールのダウンロード リンクおよびインストール手順については、このドキュメントの「システム セットアップ」セクションを参照してください。

      
      ....
      C:\Connectors\bldeif-1.1.3>python ac_build_connector sample_jenkins.yml
      ERROR: ac_build_connector encountered an ERROR condition.
        File "ac_build_connector", line 31, in main
          connector_runner.run()
        File "C:\Connectors\bldeif-1.1.3\bldeif\bld_connector_runner.py", line 137, in run
          self.proclaim_existence(build_system_name)
        File "C:\Connectors\bldeif-1.1.3\bldeif\bld_connector_runner.py", line 103, in proclaim_existence
          proc = ProcTable.targetProcess(os.getpid())
        File "C:\Connectors\bldeif-1.1.3\bldeif\utils\proctbl.py", line 96, in targetProcess
          aps = ProcTable.allProcesses()
        File "C:\Connectors\bldeif-1.1.3\bldeif\utils\proctbl.py", line 29, in allProcesses
          all_procs = ProcTable.posixProcesses()
        File "C:\Connectors\bldeif-1.1.3\bldeif\utils\proctbl.py", line 44, in posixProcesses
          ps_output = subprocess.Popen(command_vector, stdout=subprocess.PIPE).communicate()[0]
        File "C:\Users\user01\AppData\Local\Programs\Python\Python36\lib\subprocess.py", line 709, in __init__
          restore_signals, start_new_session)
        File "C:\Users\user01\AppData\Local\Programs\Python\Python36\lib\subprocess.py", line 997, in _execute_child
          startupinfo)
      FileNotFoundError: [WinError 2] 指定されたファイルが見つかりません
      

    ExternalID のフィールド長が正しくないときのエラー

    • 解決策: ExternalID のフィールド長を 40 に変更します

      
      ....
      ERROR : RallyEIF::WRK::QCConnection.rescue in update_external_id_fields - Could not update external id (or external end user id) field 
      ERROR : RallyEIF::WRK::QCConnection.initialize - Error updating defect-7787. QCAPI - HTTP-400 on request - http://qcserver:8080/qcbin/rest/domains/CRM/projects/MAINTENANCE/defects/7787. 
      Response was: {"Id":"qccore.invalid-value-type-for-field","Title":"Failed to convert the 'user-23' field of a 'defect'. The object 555555895972 cannot be converted to type Integer","ExceptionProperties":[{"Name":"entity-name","StringValue":"defect"},{"Name":"field-name","StringValue":"user-23"}],"StackTrace":null}. 
      WARN : RallyEIF::WRK::Connector.initialize - Copy of ALM defect 7787 to Rally skipped due to inability to update the ALM external_id field (BG_USER_23) 
      

    HP ALM バージョン 12.53 でコネクタを使用した場合の問題の報告があります

    • 既知の解決策はありません。

    HP ALM バージョン 12.20 でコネクタを使用した場合の以下のエラーの報告があります

    • 既知の解決策はありません。HP ALM のこのバージョンはサポートされていません。ログ ファイルは以下のように表示されます。 
       

      ....
      WARN -- : RallyEIF::WRK::QCConnection.initialize - QCAPI - HTTP-500 on request - http://hpqc.perceptive.com/qcbin/rest/domains/test/projects/test/defects?query=%7Buser-01[(%20%22%22%20or%20NULL)];id[=%22784%22]%7D&page-size=500&limit=99999. 
      Response was: {"Id":"qccore.general-error","Title":"Ambiguous pagination settings. Please dont use page-size and start-index parameters together with limit and offset parameters.","ExceptionProperties":null,"StackTrace":null} 
      ERROR -- : RallyEIF::WRK::ConnectorRunner.rescue in run_services - Unexpected exception occurred 
      WARN -- : RallyEIF::WRK::ConnectorRunner.exception - Message QCAPI - HTTP-500 on request - http://hpqc.test.com/qcbin/rest/domains/test/projects/test/defects?query=%7Buser-01[(%20%22%22%20or%20NULL)];id[=%22784%22]%7D&page-size=500&limit=99999. 
      Response was: {"Id":"qccore.general-error","Title":"Ambiguous pagination settings. Please dont use page-size and start-index parameters together with limit and offset parameters.","ExceptionProperties":null,"StackTrace":null}

       

    HP ALM から Agile Central に同期されたテスト ケースは、Agile Central で絶えず追加/削除されています

    • これが発生するのは、HP ALM のテストを含むフォルダは削除されたが、テストは削除されなかったときです。その結果、テストは ALM の未接続領域に移動されます。

      解決策: HP ALM のテストをテスト フォルダに移動します。

    複数のプロジェクトを持つリリースまたはイテレーションのマップ

    • リリースまたはイテレーション値をマップし、リリースおよびイテレーション名が CA Agile Central プロジェクト全体で同一である複数の CA Agile Central プロジェクトが存在する場合、ディフェクトについて更新中のリリースまたはイテレーションが参照しているプロジェクトが、指定したディフェクトの割り当て先のプロジェクトと異なっていると、エラーが返されることがあります。コネクタは、CA Agile Central 内の一致する名前を持つ最初のリリースまたはイテレーションのみを返します。そのため、異なるプロジェクトのリリースまたはイテレーションを参照している可能性があります。

    null のリリースまたはイテレーションのマップ

    • を使用して リリースまたはイテレーションをマップする場合、null に設定することも、スケジュール未設定に設定することもできません。異なるシステムでは、所定のフィールド タイプの null 値または空値の扱い方が異なります。したがって、このような違いのために更新中に値が無効にならないようにしました。ユーザが一方のシステム内の 1 つのタイプのフィールドを他方のシステム内の別のタイプのフィールドにマップできるという点で、null 値の考察はさらに複雑になります。

    エラーの場合の電子メール機能

    • リビジョン 2.8.8 より前は、  機能では、 Error (DE15642)に設定された場合、電子メールは送信されませんでした。

    QC サーバのアップグレード

    • アップグレードされたが、QC クライアント PC が適切な QC DLL で更新されなかった QC サーバに接続しようとしたときに、コネクタがフリーズしました。ログ ファイルは以下のように表示されます。 
       

      ....
         ANY : ConnectorRunner.block in run - processing to commence using content from Simple-Test-01.xml
         ANY : Class.read_config_file - Simple-Test-01.xml last modified 2013-08-15 19:12:59 UTC, size: 1336 chars
         ANY : RallyConnection.initialize - Initializing CA Agile Central connection version 2.8.8
        INFO : RallyConnection.initialize - CA Agile Central Web Services version 1.16
         ANY : QCConnection.initialize - Initializing Quality Center connection version 2.8.8
        INFO : Connector.initialize - Ruby platform i386-mingw32
        INFO : Connector.initialize - Ruby version 1.9.2
        INFO : QCConnection.connect - Connecting to Quality Center at http://vmwin2008qc11.f4tech.com:8080/qcbin as user jpqc11
       DEBUG : QCConnection.block in identify_qc_version - Preparing to open Registry to examine: Software\Classes\CLSID\{C5CBD7B2-490C-45f5-8C40-B8C3D108E6D7}\InprocServer32
       DEBUG : QCConnection.block in identify_qc_version - Registry Software\Classes\CLSID\{C5CBD7B2-490C-45f5-8C40-B8C3D108E6D7}\InprocServer32 opened...
       DEBUG : QCConnection.block (2 levels) in identify_qc_version - Registry path to HPQC OTAClient.dll ==> C:\PROGRA~2\HP\QUALIT~1\OTACLI~1.DLL
       DEBUG : QCConnection.win_path_expanded - expanded Registry path to DLL target: C:/Program Files (x86)/HP/Quality Center Client Side/OTAClient.dll

       

    その時点で、コネクタは Ctrl + C で中断できず、Ruby プロセスは CPU の 100% を消費していました。

    重複した QC の要件名

    • CA Agile Central では、名前フィールドで、2 つの要件に同じ値を指定することができます。これは、QC システムでは許可されていません。重複した RQ_REQ_NAME の要件が QC にコピーされると、エラーが発生します。設定ファイルが  または  タグを使用している場合、以下のエラーが発生します(そうでない場合、エラーは OLE 80040556 になります)。 
       

      INFO : Connector.copy_to_other - Copy US447 to Quality Center
       DEBUG : Connector.block in map_fields_to_other -   Mapping Name(test dup req name) - to - RQ_REQ_NAME(test dup req name)
       DEBUG : Connector.block in map_fields_to_other -   Mapping Description(US447 desc) - to - RQ_REQ_COMMENT(US447 desc)
       DEBUG : QCConnection.create_internal - set all artifact fields
       ERROR : QCConnection.rescue in create_internal - failed on attempt to move Requirement item to target folder
       ERROR : QCConnection.rescue in create_internal - failed on attempt to create QC Req item from src item 
       ERROR : QCConnection.cleanup_shell_artifact - Attempting to delete the shell req item due to error.
        INFO : QCConnection.delete - Deleted QC req with id 22
       ERROR : QCConnection.cleanup_shell_artifact - The shell req was deleted successfully.
        WARN : QCConnection.initialize - Could not create req - failed on attempt to move Requirement item to target folder -

       

    32768 文字を超える QC のコメントまたは説明が CA Agile Central 文字列フィールドにコピーされたときのコネクタ エラー(DE22249)

    • 解決策: "RallyTruncateFieldHandler" を追加して、説明を自動的に切り捨てます。
    [2015-01-15 17:39:20 Z]  WARN : RallyEIF::WRK::RallyConnection.initialize -
    Error on request - https://rally1.rallydev.com/slm/webservice/1.42/testcase/create.js?/workspace=/workspace/658223893a -
    {:errors=>["Validation error: TestCase.Description length is greater than the maximum length of 32768"]}

    install_gems.rb を実行するときのエラー

    • ./install_gems.rb: line 2: BASE_GEMS: command not found
      ./install_gems.rb: line 3: syntax error near unexpected token `('
      ./install_gems.rb: line 3: `CORE_GEMS = %w(rally_api rallyeif-wrk)'
       

      スクリプトには、Ruby 2.2 がインストールされている必要があります。さらに、スクリプトには、インタープリタの場所が先頭行として含まれていないため、ruby コマンドのパラメータとして呼び出す必要があります。

      スクリプトを正常に起動するには、以下のコマンドを実行します。 
       

      # ruby install_gems.rb

       

    ruby dk.rb install を実行するときのエラー

    • ERROR: Invalid configuration or no Rubies listed. Please fix 'config.yml' and rerun 'ruby dk.rb install'
       

      解決策: DevKit ディレクトリ内の config.yml ファイルを、Ruby ベース ディレクトリをインクルードするように変更します。

      config.xml の最後に以下を追加しますが、下記のディレクトリをご使用の Ruby ディレクトリに変更します(ダッシュはすべて必要です)。 
       

      ---
      -G:\Ruby22-x64

       

    ca_agile_central2_hpalm_connector.rb config.xml -1 を実行するときのエラー

    • ERROR: ruby: No such file or directory -- ca_agile_central2_hpalm_connector.rb (LoadError)

       

    • ruby ca_agile_central2_hpalm_connector.rb config.xml -1
       
      解決策: コマンドの先頭に ruby を追加します。

    リビジョン履歴

    • 4.8.3-master --- 2018 年 6 月
      • ディフェクトの修正:
        • QCUrlAttachmentFieldHandler Fieldhandler エラーが修正されました
        • QCReqLinkFieldHandler Fieldhandler エラーが修正されました
    • 4.8.2-master --- 2018 年 6 月
      • ディフェクトの修正:
        • nil:NilClass の未定義のメソッド gsub' のメッセージ
    • 4.8.1-master --- 2018 年 5 月
      • ディフェクトの修正:
        • HPALM 12.01 への接続時の nil:NilClass の未定義のメソッド `[]'
    • 4.8.0-master --- 2018 年 5 月
      • 機能強化:
        • 統合ディストリビューション、TLS V1.2 のサポートに Ruby 2.2.6 の使用が必要です。
      • 変更点:
        • Nokogiri への依存を排除するには、すべてのカスタム フィールド ハンドラについて read_config メソッドでの変更が必要です。
        • 認証情報エンコード/デコード オプションが削除されました。
    • 4.7.4-master-14 --- 2017 年 7 月 11 日 (REST バージョン)
      • 修正:
        • [最終変更]フィールドを含めるようにコードが更新さました。
        •  (  セクション内)を使用するときに、かっこを説明するようにロジックを更新しました。
        • ポスト サービスを使用するときに、ラベルではなく親 ID 名を使用するように ロジックを更新しました。
    • 4.7.2-master-11 --- 2016 年 11 月 14 日 (REST バージョン)
      • 修正:
        • Agile Central の[ターゲット日]フィールドが HP ALM の[日付]フィールドに適切にマップされるようにタイム ゾーンの変換を調整しました。
        • BG_DETECTED_IN_REL のリリースへのマッピングを修正しました: コネクタはリリースを検出できなかったことを示すエラーを生成します。
    • 4.7.1-master --- 2016 年 10 月 17 日 (REST バージョン)
      • 修正:
        • & を含む CopySelector で発生するエラーを処理しました。
    • 4.7.0-master-8 --- 2016 年 8 月 26 日 (REST バージョン)
      • 機能強化:
        • HP ALM REST に基づいています。HP ALM 12.50 で使用するために認定されました
        • 範囲およびサブセット セレクタをサポートするようになりました
    • 4.6.7-master-96 --- 2016 年 11 月 8 日 (OTA.dll バージョン/HP REST API と互換性がない)
      • 修正:
        • Agile Central の[ターゲット日]フィールドが HP ALM の[日付]フィールドに適切にマップされるようにタイム ゾーンの変換を調整しました
        • BG_DETECTED_IN_REL のリリースへのマッピングを修正しました: コネクタはリリースを検出できなかったことを示すエラーを生成します
    • 4.6.6-master-103 --- 2016 年 6 月 10 日 (OTA.dll バージョン/HP REST API と互換性がない)
      • 機能強化:
        • HP ALM 12.21 および 12.50 で使用するために認定されました。
        • CA Agile Central の添付ファイル サイズ制限が増加し、50 MB までサポートされています(5 MB からアップグレード)。
      • 修正:
        • 増加している添付ファイルの問題が修正されました。
          • 名前が重複したファイルが作成されてしまう場合は、コネクタは、CA Agile Central から HP ALM への添付ファイルのコピーを試みません。
          • 以前は、CA Agile Central の同じ名前の添付ファイルが HP ALM の新しい一意の名前に書き込まれ、CA Agile Central にコピーされた場合、同じ内容の添付ファイルが多数作成されていました。
    • 4.6.5-master-94 --- 2015 年 11 月 24 日
      • 機能強化:
        • 重複する CA Agile Central プロジェクト名を検出すると、エラー ログが作成され、終了するようになりました。
        • 電子メールの機能は、後続の設定検証が失敗した場合でもアラート電子メールを送信できるように優先順位付けられたプロセスになりました。
        • 認証情報値の暗号化が強化されました。
    • 4.6.4-master-93 --- 2015 年 11 月 16 日
      • 機能強化:
        • ブランドの再設計。
    • 4.6.3-master-92 --- 2015 年 8 月 14 日
      • 修正:
        • copy_to_rally で呼び出された pre_copy メソッドが、通常 Null/ブランク値を持つ必須フィールドの欠落に関する必要な条件を満たしていない場合のログ エラーがクリーンアップされました。
        • XML には、CA Agile Central の URL、ワークスペース、またはプロジェクトを含むファイルが含まれ、認証情報の暗号化の前後に適切に処理されます。
        • QCUrlAttachmentFieldHandler は、HP ALM 12 添付ファイルへの添付リンクを正しく構築するようになりました。
    • 4.6.1-master-86 --- 2015 年 7 月 18 日
      • 修正:
        • TestStep の内容が 2048 バイトを超えると、その TestStep の作成が失敗し、ターゲット テスト ケースの後続の TestStep の作成が試行されないエラーが発生するという問題が修正されました。この問題は、2048 バイトを超える TestStep の内容を切り捨て、ログ ファイルに警告メッセージを書き込んで通知することによって解決されました。
    • 4.6.0-master-84 --- 2015 年 5 月 28 日
      • 機能強化:
        • RallyConnection、QCConnection、QCRunConnection セクション内の認証情報が暗号化されるようになりました。
      • 既知の問題:
        • (なし)
    • 4.5.5-master-81 --- 2015 年 4 月 21 日
      • 機能強化:
        • CA Agile Central のユーザ名とパスワードの代わりに APIKey を使用するためのサポート。
        • FieldDefaults と値の処理が改善されました。
        • 別のシステムから CA Agile Central へのアイテムのコピー/更新の試行が失敗した場合のログ記録が改善されました。
    • 4.5.4-master-79 --- 2015 年 4 月 2 日
      • 機能強化:
        • エラー状態が発生した場合の作成/更新操作のログ記録が改善されました。
        • 非 ASCII 文字が含まれる CA Agile Central の名前、説明、ノートにマップされる文字列フィールドの処理が改善されました。
    • 4.5.3-master-78 --- 2015 年 3 月 7 日
      • 機能強化:
        • RallyBooleanFieldHandler が追加されました。
      • 修正:
        • YetiEmailer で、ヘッダ アイテムに一部の電子メール サーバで受け入れられない先頭のスペースが含まれていた問題が修正されました。
    • 4.5.2-master-74 --- 2015 年 1 月 28 日
      • 機能強化:
        • HP ALM 12 のサポートが追加されました。
        • CA Agile Central WSAPI v2.0 (1.42 ではない)を使用するように更新されました。
    • 4.4.12-maintenance-47 --- 2015 年 1 月 5 日
      • 修正:
        • 構成エレメントを導入し、 [プロジェクト]、[リリース]、および[イテレーション]フィールドに 'Name' 以外の  を使用できるようにしました。 [プロジェクト]、[リリース]、および[イテレーション]フィールドへの使用は廃止されました。ルックアップ フィールドを 'Name' 以外の属性にする場合、このフィールド ハンドラの導入により同様の機能が可能になりました。
    • 4.4.11-maintenance-40 --- 2014 年 11 月 19 日
      • 修正:
        • コネクタが添付ファイルをコピーできない CA Agile Central ALM に対する変更が修正されました。
    • 4.4.10-master-72 --- 2014 年 10 月 16 日
      • 機能強化:
        • rally_api への rallyeif-wrk のコア依存を 1.1.2 に修正し(httpclient 2.4.0 に応じて)、SSLv3 セキュリティの問題に対応しました。
      • 既知の問題:
        •  フィールド ハンドラが破損しています - DE23409 が提出されました
    • 4.4.4-master-67 --- 2014 年 9 月 18 日
      • 機能強化:
        • CA Agile Central のブール値と文字列(「true」/「false」)のセマンティック比較を改善することにより、不要な更新の回数を減らします。
        • CA Agile Central の小数値と整数/文字列(1.0 は、1 または「1」)のセマンティック比較を改善することにより、不要な更新の回数を減らします。
        • OtherUserFieldHandler で HPQC ユーザ名をすべて大文字で入力できるようにし、CA Agile Central UserName の値を大/小文字を区別せずに比較する機能が追加されました。
        • CA Agile Central ユーザと HPQC のユーザ識別子の比較を改善することにより、不要な更新の回数を減らします。
      • 既知の問題:
        •  フィールド ハンドラでは、フィールド ハンドラごとに 1 フィールドしか処理されません - DE22728 が提出されました。(複数フィールドの使用方法については、「QCRtfFieldHandler」セクションを参照してください。)
    • 4.4.3-master-66 --- 2014 年 8 月 29 日
      • 機能強化:
        • RevisionHistory Revision レコード(特に[ノート]フィールド)の解析を強化しました。
    • 4.4.2 --- 2014 年 7 月 30 日
      • 機能強化:
        • 共通の CA Agile Central 参照フィールド([プロジェクト]、[リリース]、[イテレーション])について RallyReferenceFieldHandler をコネクタで設定する必要がなくなりました(設定ファイルの RallyFieldHandlers セクション)。
        • [リリース]および[イテレーション]などの CA Agile Central 参照フィールドのマッピングが完全にプロジェクト スコープに含まれ、複数のリリース アイテムの表示名が同じ場合に、アーティファクトのプロジェクト設定に関連付けられているアイテムへのリンクがアーティファクトに含まれるようになりました。
    • 4.3.2 --- 2014 年 2 月 5 日
      • 修正:
        • プレビュー モードでの QC テスト実行コネクタのバグが修正されました
    • 4.3.0 --- 2014 年 1 月 16 日
      • 機能強化:
        • Ruby 1.9.2-p290 から Ruby 2.0.0-p247 にアップグレードされました。
        • rally_rest_api ではなく rally_api を使用することによってパフォーマンスが向上しました。
        • ビルド テストがさらに追加されました
        • TargetDate を BG_CLOSING_DATE にマッピングすると、QC コネクタで後方のタイム ドリフトが発生します(DE18750)。
        • CA Agile Central QC 電子メール ユーザ フィールド ハンドラが更新されました(DE18583)。
        •  が破損しました(DE18850)。
        • コネクタでコマンド ラインの最初の設定ファイルのみが検証されます(DE17492)。
        •  XML タグが追加されました。
        • WSAPI がバージョン 1.42 にアップグレードされました。
        • 注: このコネクタの 4.3.0 バージョンについては、すべてのカスタム コード(カスタム フィールド ハンドラなど)で変更が必要になります。QC コネクタを使用する実際の例は、ここを参照してください。

          以前のメソッドでは以下が必要です。
          require 'yeti/field_handlers/other_field_handler'
          require 'rexml/document'
          
          class MyCustomFieldHandler 

          新しい方法では以下が必要です。 
          require 'rallyeif/wrk/field_handlers/field_handler'
          
          module RallyEIF
            module WRK
              module FieldHandlers
          
                class MyCustomFieldHandler 

           

    • 2.10.0-513 --- 2013 年 10 月 14 日
      • 機能強化:
        • 更新された値を誤ってログ ファイルに表示する問題が修正されました(DE18019)。
        • QC バージョンのログ メッセージが WARNING から INFO に更新されました(DE18378)。
        • HPQC フェーズ 1 のユーザビリティおよび信頼性のアップグレード(F3823)。
        • csv を使用してユーザをマップするためのフィールド ハンドラが作成されました(S53878)。
        • 既存以外のユーザの QC から CA Agile Central へのディフェクト マッピングが適切に処理されました(S50159)。
        • ログ ファイルにリリース/イテレーション参照が誤って表示され、実際の名前が表示されません(S50389)。
        • コネクタは、複数のフォーマットの QC の日付/時間の CA Agile Central の日付/時間フィールドへのマッピングを処理します(S50391)。
        • QC から CA Agile Central へのコピー中に RequirementFolder が CopySelector のように機能しませんでした(S50265)。
        •  セクションでのみ、CrosslinkUrlField の存在を確認します(S51204)。
        • rally_rest_api インターフェースが rally_api に置き換えられ、コードがより簡潔になり、パフォーマンスが向上しました(S38419)。
        • テスト ケースおよびテスト ケース結果の場合: 新しいテスト ケース結果がコネクタを介して作成された場合、[イテレーションのステータス]ページで前回の判定が変更されません(S50262)。
        • 上書きを防止するためにフィールド レベルにコア同期がリファクタリングされました(F4214)。
        • EIF コネクタに WSAPI 2.0 が追加されました(F3097)。
      • 修正:
        • CA Agile Central などでの大文字と小文字を区別するユーザ名の管理(DE18025)。
        • アーティファクトをコピー/更新するルックバック時間が無効です(DE17865)。
        • EIF コネクタでコマンド ラインの設定ファイルが検証されるようになりました(DE17492)。
        • [変更あり]で日付フィールドが正しく比較されませんでした(DE15628)。
      • 既知の問題:
        •  は正しく値を返しません(DE18850)。
    • 2.8.8-225 --- 2012 年 12 月 14 日
      • 機能強化:
        • ログの小規模な改善。
      • 修正:
      • 既知の問題:
        • QC の Date/Time フィールドと CA Agile Central の Date/Time フィールドとの間でマップすると、コネクタが次のエラーで失敗する場合があります。
              解析できませんでした: "null" を日付に変換できません。ISO8601 日付 + 時刻形式を使用する必要があります。
          これは、通常、 を使用して解決します。.
        • SubmittedBy または Owner フィールドがマップされていて、これら 2 つのフィールドのいずれかで以前に削除されたユーザへの参照がアーティファクトにある場合、アーティファクトを取得しようとすると、コネクタは、「#0x149be48>

    フィードバック

    ヘルプをお求めですか?CA Agile Central コミュニティは、セルフサービスとサポートのワンストップ ショップです。CA Agile Central サポートにフィードバックを送信したり、答を見つけたり、他のユーザとのコラボレーションには CA Agile Central コミュニティ にご参加ください。