Eclipse Oxygen IDEでの操作

ALM Octaneの作業は、NeonやMarsなどのEclipse Oxygen IDEパッケージから直接実行できます。これには、Eclipse用のALM Octaneプラグインのインストールが必要です。

概要

開発者はこのプラグインによって、ALM Octaneワークスペースへの接続、ALM Octane項目の表示、更新を実行できます。

このプラグインはオープンソースです。ソースコードへのアクセス方法については、https://github.com/MicroFocus/octane-eclipse-plugin を参照してください。

このプラグインは、双方向の統合をサポートしています。

  • このプラグインは、ホストのEclipseアプリケーション内のデータをすべて更新します。

  • Eclipseで行われた変更は、ALM Octaneのデータに影響を与えます。

トップに戻る

前提条件

  1. 使用するオペレーティングシステムがサポートされていることを確認してください。 

    • Windows 10、8、7

    • macOS 10.12

  2. 使用するソフトウェアがサポートされていることを確認してください。

    アプリケーション/プラグイン バージョン
    ALM Octane Eclipseプラグイン

    12.55.4以降

    ALM Octane 12.55.4以降
  3. 他のソフトウェアがサポートされていることを確認します。

    ソフトウェア バージョン
    Java

    1.8以降

トップに戻る

プラグインのダウンロードとインストール

このプラグインをダウンロードしてインストールするには、3つの方法があります。

Eclipse Marketplaceから

  1. Eclipse IDE内で、[Help] > [Eclipse Marketplace] を選択します。

  2. [Find] ボックスで、ALM Octaneプラグインを検索します。画面の指示に従ってインストールします。

Eclipse IDEの内部から

  1. Eclipse IDE内で、[Help] > [Install New Software] を選択します。

  2. [Work with] に、Eclipse用のALM Octane IDEプラグインにアクセスするためのURLを入力し、[Add] をクリックします。

  3. [Add Repository] ダイアログボックスが開いたら、ソフトウェアの名前を入力します。

  4. [Select All] をクリックし、[Next] を2回クリックします。

  5. 条件に同意し、[Finish] をクリックします。

  6. Eclipse IDEを再起動します。

  7. ALM Octaneに接続に続きます。

Eclipse IDEの内部から (リモートインストール)

インターネットにアクセスできない場所でプラグインをインストールするには、プラグインの圧縮アーカイブをストレージデバイスにダウンロードします。

  1. 次のURLにアクセスし、アーカイブをダウンロードします。 

    https://github.com/MicroFocus/octane-eclipse-plugin/tree/gh-pages

  2. [Clone or Download] をクリックします。

  3. [Download ZIP] を選択します。

  4. ストレージデバイスにプラグインを解凍します。

    例: F:/MyEclipse/octane-eclipse-plugin-gh-pages

  5. 各リモートコンピューターでEclipse IDEを起動し、[Help] > [Install New Software] を選択します。

  6. [Work with] に、Eclipse用のALM Octane IDEプラグインにアクセスするためのURLを入力します。

    これを行うには、[Local] をクリックし、update-siteフォルダーに移動します。

    <AnyName> - file:/F:/MyEclipse/octane-eclipse-plugin-gh-pages/update-site/

    [Add] をクリックします。

  7. [Select All] をクリックし、[Next] を2回クリックします。

  8. 条件に同意し、[Finish] をクリックします。

  9. Eclipse IDEを再起動します。

  10. ALM Octaneに接続に続きます。

トップに戻る

ALM Octaneへの接続

インストールが完了すると、新しい設定カテゴリがEclipseで利用可能になります。この領域を使用して、EclipseをALM Octaneに接続します。

  1. Eclipseで、[Window] > [Preferences] > [ALM Octane Settings] を選択し、ALM Octaneへの接続に進みます。

  2. ALM OctaneサーバーのURLを入力します。URLには、関連するスペースとワークスペースのクエリパラメーターを含めることができます。その場合、スペースフィールドとワークスペースフィールドに自動的に入力されます。次のいずれかの形式が有効です。 

    • https://<server>:<port>
    • https://<server>:<port>/ui/?p=<spaceID>/<workspaceID>
  3. ブラウザでログインするか、IDEから直接ログインします。

    • ブラウザを使用してログインALM Octaneログインウィンドウが表示され、あなたはALM Octaneにログインするための資格情報を入力することができます。このオプションは、非SSOとSSOの両方、フェデレーション環境、およびセッションタイムアウトに使用します。

      ヒント: ログインウィンドウで、ここをクリックしてシステムの標準設定ブラウザを使用リンクを使用して、ログイン用の認証ページを開くこともできます。資格情報を入力し、ブラウザを閉じると、ALM Octaneにログインします。

    • ユーザー名とパスワードでログインALM Octaneに直接ログインするためのクレデンシャルを入力します。このオプションは資格情報を保持するため、毎回資格情報を入力する必要はありません。

  4. [Test connection] をクリックします。

ヒント: Eclipseでプロンプトが表示されたら、パスワードの回復に使用するヒントを指定できます。

これで、Eclipse内からALM Octaneを操作できます。

トップに戻る

ALM Octane項目で作業する

このセクションでは、ALM Octaneの [My Work] タブからALM Octaneを操作する方法について説明します。

  1. ALM Octaneの [My Work] タブを開く

    [Window] > [Show View] > [Other] を選択します。次に [Octane: My Work] を展開し、接続を選択します。[My Work] タブが開き、自分に割り当てられている作業が表示されます。[My Work] タブにあるチェックボックスを使用して、表示する項目をフィルターします。 

    別のセッションを開始すると、ALM Octane Eclipseプラグインは前回の作業内容に基づいて、[ALM Octane] ペインでタブを開きます。

    ほとんどのALM Octane項目は、IDEから利用できます。

    自分がメンションされているコメントを確認できます。コメントから、コメントが追加された項目に移動できます。これを行うには、ダブルクリックしてください。

    ヒント: 特定の項目の作業中であることを示し、コード変更をその項目に関連付けるには、[自分の作業] ペインの項目を右クリックし、[Start work] を選択します。項目アイコンには緑色の三角形が表示され、自分が「作業中」であることを示します。作業が完了したら、項目を右クリックして [Stop work] を選択します。

  2. 詳細を表示する

    項目をダブルクリックすると、別のペインが開き、詳細が表示されます。 

    をクリックし、表示するフィールドを選択します。[None] または [All] も選択できます。設定内容が適用される範囲は、自分のみに限定されます。別のセッションを開始すると、選択しているフィールドがALM Octane Eclipseプラグインに記憶されます。

    ヒント: 項目は、ブラウザーを使用してALM Octaneで直接開くこともできます。[My Work] ペインで項目を右クリックし、次の項目を選択します。

    • View in Browser (System): ブラウザーの新しいウィンドウで項目が開きます。

    • View in Browser (Eclipse). 現在のEclipse IDEの新しいペインで項目が開きます。

    通常のEclipse IDEビューに戻るには、項目を右クリックして [Details View] を選択します。

  3. 項目を検索する

    [My Work] ペインで項目のリストを検索し、検索条件に基づいて関連する項目を新しいタブに表示できます。検索ボックスに検索文字列を入力します。検索結果が新しいペインで開きます。

    プラグインは、最後に実行した5つの検索を記憶しています。をクリックして1つを選択し、検索を再実行します。

    検索の範囲は、現在のEclipseプロジェクト内に限定されます。

    ヒント: 検索では、割り当てられた項目だけでなく、すべてのALM Octane項目が検索されます。検索を使用して項目を自分に割り当てるか、コンテキストメニューから [Add to My Work] をクリックすることができます。

  4. 自分の項目を更新する

    Eclipseでストーリーを実装して不具合を修正したら、ALM Octane項目を更新します。

    • 定義されたALM Octaneワークフローに従って、項目のステータスをあるフェーズから別のフェーズに移動します。

    • フィールド値を更新します。

      制限事項:  フィーチャーフィールドは編集できません。

      フィールドを読み取り専用にするルールが存在し、その値を変更すると、プラグインは項目を保存したときに通知します。

    • [Comments] をクリックして、コメントの表示と追加を行います。

    必ず保存 してください。

  5. Gherkinテストスクリプトをダウンロードして自動化する

    ALM Octaneで作成したGherkinテストは、Eclipseで自動化することができます。

    1. [My Work] ペインでGherkinテストを右クリックし、[Download Script] を選択します。

    2. Gherkinテストをダウンロードするフォルダーを選択します。[OK] をクリックします。

      ダウンロードされるスクリプト名の形式は、次のとおりです。 

      <TestName>-<TestID>.feature

      ファイルがすでに存在する場合は、ファイルの上書きを確認するメッセージが表示されます。キャンセルし、元のスクリプトの名前を変更することもできます。

  6. 自動化を実装するためのBDDシナリオをダウンロードする

    Cucumber-JVMフレームワークを使用して、Gherkinシナリオを使用して、ALM OctaneでBDD (ビヘイビアー駆動開発) テストを作成および実行できます。

    1. [My Work] ペインで、BDDシナリオを右クリックし、[Download Script] を選択します。

    2. BDDテストをダウンロードするフォルダーを選択します。[OK] をクリックします。

      ダウンロードされるスクリプト名の形式は、次のとおりです。 

      <BDD Name>_<BDD ID>

      ファイルがすでに存在する場合は、ファイルの上書きを確認するメッセージが表示されます。キャンセルし、元のスクリプトの名前を変更することもできます。

  7. 生成されたメッセージを使用して変更をコミットする

    GitなどのSCMシステムに対して、Eclipseプロジェクトで項目の作業を開始したことを宣言することができます。これによって、項目の変更をコミットしたときに、自動生成されたテキストをコピーし、その項目のコミットメッセージに貼り付けることができます。

    ユーザーストーリー、品質ストーリー、不具合、アクティブなタスクの変更をコミットできます。

    1. [My Work] ペインで、ユーザーストーリー、品質ストーリー、不具合、アクティブなタスクを右クリックします。

    2. [Start work] を選択します。項目のアイコンに「再生ボタン」が表示されます。

      また、Eclipseのツールバーに項目がボタン として表示されます。このボタンをクリックすると、項目の詳細がタブで開きます。

    3. コミットメッセージのテキストを生成してクリップボードにコピーするには、項目を右クリックして [Commit Message to Clipboard] を選択します。または、Eclipseツールバーの対応するボタンをクリックすることもできます。

      ヒント: コミットメッセージをコピーするには、「作業を開始」する必要があります。

    4. 変更をコミットします。Gitのステージング領域で、クリップボードの内容を [Commit Message] 領域に貼り付けます。

      コミットメッセージの形式には、タイプと項目IDが含まれ、その後にコロン (: ) が続きます。コロンの後に、コミットメッセージの詳細を入力します。

      タスクの場合は、タスクに関連する項目 (ストーリーや不具合など) も含まれます。

    コミットメッセージをキャンセルするには、[My Work] ペインで項目を右クリックし、[Stop work] を選択します。または、ツールバーの [Stop work] ボタンをクリックします。

    コミットメッセージは、手動で編集することもできます。詳細については、ソースコントロール管理システムにコミットされた変更の追跡を参照してください。

  8. 項目を破棄する

    関連性がなくなった項目を自分の作業リストから削除します。右クリックして、[Dismiss] を選択します。項目はMy Workから削除されますが、ALM Octaneでは削除されません。

トップに戻る

参照情報: