Oracle® Fusion Middleware Oracle Team Productivity Centerユーザーズ・ガイド

11g リリース2(11.1.2.4.0)

B66155-04(原本部品番号:E17914-05)

目次

タイトルおよび著作権情報

はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

リリース11.1.2.4.0のこのガイドでの新機能

1 Oracleチーム・プロダクティビティ・センターの概要

- 1.1 Oracleチーム・プロダクティビティ・センターについて

- 1.1.1 前のバージョンからの移行方法

- 1.2 Oracleチーム・プロダクティビティ・センターへの接続

- 1.2.1 チーム・プロダクティビティ・センターへのログイン方法

- 1.2.2 Oracleチーム・プロダクティビティ・センターからの切断方法

- 1.2.3 ユーザー・プロファイルの管理方法

- 1.2.4 リポジトリ・アカウントの管理方法

- 1.3 Oracleチーム・プロダクティビティ・センターのナビゲート

- 1.3.1 ユーザーのチーム・プロダクティビティ・センター・チームの選択方法

- 1.3.2 チーム・プロダクティビティ・センターのチャットの使用方法

- 1.3.2.1 チャット・サーバーへのログイン

- 1.4 ビルド・ダッシュボードおよびビルド・サマリーの理解

- 1.4.1 ビルド・ダッシュボードを開いて使用する方法

- 1.4.2 ビルド・ダッシュボードおよびビルド・サマリーの使用方法

2 Oracleチーム・プロダクティビティ・センターの使用

- 2.1 Oracleチーム・プロダクティビティ・センターの使用について

- 2.1.1 Oracleチーム・プロダクティビティ・センターの情報リポジトリのサポート方法

- 2.2 作業アイテムの使用

- 2.2.1 作業アイテムの作成方法および使用方法

- 2.2.2 変更リストでの作業アイテムの使用方法

- 2.2.3 アクティブな作業アイテムの設定方法および表示方法

- 2.2.4 チーム・プロダクティビティ・センターからリポジトリへの接続方法

- 2.2.5 チーム問合せを介した作業アイテムのアクセス方法

- 2.2.6 プロジェクト・ファイルに作業アイテムを関連付ける方法

- 2.2.7 コンテキストの保存方法およびリストア方法

- 2.3 タスク・リポジトリの使用

- 2.3.1 タスク・リポジトリのタスクの検索方法

- 2.3.2 タスク作業アイテムの作成方法

- 2.3.3 タスク作業アイテムの編集方法

- 2.4 添付ファイルの使用

- 2.4.1 添付ファイルの追加方法

- 2.4.2 添付ファイルのダウンロード方法

- 2.4.3 添付ファイルの更新方法

- 2.4.4 添付ファイルの名前の変更方法

- 2.5 問合せの使用

- 2.5.1 問合せの作成方法

- 2.5.2 問合せの実行方法

- 2.5.3 問合せのカスタマイズ方法

- 2.5.4 問合せの名前の変更方法

- 2.5.5 変更した問合せの保存方法

- 2.5.6 チーム問合せの作成方法

- 2.5.7 問合せの削除方法

- 2.6 タグの使用

- 2.6.1 タグの作成、変更および削除方法

- 2.6.2 タグの使用方法

- 2.7 関連の使用

- 2.7.1 作業アイテムへの関連の追加方法

- 2.7.2 関連の削除方法

- 2.7.3 関連と作業アイテムとの関連付け方法

3 Oracleチーム・プロダクティビティ・センターの管理の使用

- 3.1 Oracleチーム・プロダクティビティ・センターの管理の使用について

- 3.1.1 リポジトリ、ユーザーおよびチームの理解

- 3.1.2 ユーザー権限の理解

- 3.1.3 ユーザー・ロールの理解

- 3.2 Oracleチーム・プロダクティビティ・センターへのリポジトリの追加

- 3.2.1 リポジトリの追加方法

- 3.2.2 リポジトリの削除方法

- 3.3 Oracleチーム・プロダクティビティ・センターでのリポジトリの有効化

- 3.3.1 チーム・プロダクティビティ・センターのリポジトリのアクセス方法および選択方法

- 3.3.2 「チーム管理」ダイアログでのリポジトリの検索方法

- 3.3.3 リポジトリの割当て方法

- 3.3.4 バージョニング・リポジトリの作成方法および使用方法

- 3.4 ユーザー、チームおよびロールの使用

- 3.4.1 チーム・プロダクティビティ・センターのユーザー・アカウントの作成方法

- 3.4.2 チーム・プロダクティビティ・センターへのユーザーの追加方法

- 3.4.3 ユーザー情報の変更方法

- 3.4.4 チーム・プロダクティビティ・センターからのユーザーの削除方法

- 3.4.5 「チーム管理」ダイアログでのユーザーまたはチームの検索方法

- 3.4.6 Oracleチーム・プロダクティビティ・センターに対するチームの追加方法および削除方法

- 3.4.7 チーム・メンバー・ロールの設定方法および変更方法

4 Oracleチーム・プロダクティビティ・センター・コネクタの使用

- 4.1 Oracleチーム・プロダクティビティ・センター・コネクタの使用について

- 4.1.1 リポジトリからのデータのフェッチ

- 4.1.2 コンポーネントUIツリーの生成

- 4.1.3 作業アイテム・エディタ

- 4.1.4 動的な作業アイテム・モデルおよびUI

- 4.1.5 拡張コネクタのダウンロード方法

- 4.1.6 チーム・プロダクティビティ・センター・コネクタの実行フローの例

- 4.1.7 チーム・プロダクティビティ・センターのリポジトリ・データの定義方法

- 4.1.8 コネクタへのリスナーの追加方法

- 4.2 Oracleチーム・プロダクティビティ・センター・コネクタの作成

- 4.2.1 Oracleチーム・プロダクティビティ・センター・コネクタの作成方法

- 4.2.2 Oracleチーム・プロダクティビティ・センター・コネクタ構成ファイルの作成方法

- 4.2.3 カスタマイズしたリスナーおよびマネージドBeanの使用方法

- 4.2.4 ファイアウォールを介したコネクタ・データへのアクセス方法

- 4.2.5 チーム・プロダクティビティ・センターUIを使用してデータを宣言的に表示する方法

- 4.2.6 Oracleチーム・プロダクティビティ・センター・リポジトリからのデータの取得方法

- 4.2.6.1 WorkItemConnectorインタフェースの実装

- 4.2.7 カスタム・アクションに基づいた作業アイテム詳細のリフレッシュ方法

- 4.2.7.1 UIコントロールおよびリスナー属性の決定

- 4.2.7.2 UIメタデータ・ファイルでの新規リージョンの定義

- 4.2.7.3 マネージドBeanでの対応するリスナーの実装方法

- 4.2.7.4 マネージドBeanを実装するためのガイドライン

- 4.2.7.5 tpc-config.xmlへのBeanクラスの登録

- 4.2.8 JDeveloper内で新規エディタを開く方法

- 4.2.9 Oracleチーム・プロダクティビティ・センター・コネクタのデバッグ方法

- 4.3 Oracleチーム・プロダクティビティ・センター・コネクタ・エラーの処理

- 4.4 Oracleチーム・プロダクティビティ・センター・コネクタへのヘルプの追加

- 4.4.1 チーム・プロダクティビティ・センター・コネクタへのヘルプの追加方法

- 4.4.2 チーム・プロダクティビティ・センター・コネクタのヘルプを外部ビューアで表示する方法

- 4.5 コネクタのパッケージ化

- 4.5.1 コネクタのパッケージ化方法

- 4.5.2 コネクタJARファイルの生成方法

- 4.5.3 コネクタのヘルプJARファイルの生成方法

- 4.5.4 コネクタ・バンドル・ファイルの生成方法

- 4.5.5 コネクタ・バンドル・ファイルの依存性の定義方法

- 4.6 チーム・プロダクティビティ・センター・コネクタの国際化

Oracle® Fusion Middleware

Oracle Team Productivity Centerユーザーズ・ガイド

11g リリース2(11.1.2.4.0)

B66155-04(原本部品番号:E17914-05)

2013年3月

IDEで使用可能なOracleチーム・プロダクティビティ・センターの機能について、チーム・プロダクティビティ・センターの管理、およびチーム・プロダクティビティ・センター・リポジトリとともに使用するコネクタの作成に関して説明した、開発者のためのドキュメント。

Oracle Fusion Middleware Oracle Team Productivity Centerユーザーズ・ガイド, 11g リリース2 (11.1.2.4.0)

B66155-04

Copyright © 2011, 2013,  Oracle and/or its affiliates.All rights reserved.

原本著者: Scott Fisher

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントが、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供される場合は、次のNoticeが適用されます。

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007).Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

このソフトウェアまたはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアまたはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用する際、このソフトウェアまたはハードウェアを安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle およびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXはThe Open Groupの登録商標です。

このソフトウェアまたはハードウェアおよびドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

はじめに

『Oracle Team Productivity Centerユーザーズ・ガイド』へようこそ。

対象読者

このドキュメントは、Oracle JDeveloperでOracleチーム・プロダクティビティ・センターを使用する開発者を対象とし、IDEで使用可能な機能、Oracleチーム・プロダクティビティ・センターの管理、およびOracleチーム・プロダクティビティ・センター・リポジトリで使用するコネクタの作成に関する詳細な情報を提供します。

ドキュメントのアクセシビリティについて

オラクル社のアクセシビリティへの取組みの詳細は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

Oracleサポートへのアクセス

Oracleのお客様は、My Oracle Supportにアクセスして電子サポートを受けることができます。詳細は、http://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoまたはhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs (聴覚障害者向け)を参照してください。

関連ドキュメント

- Oracle Fusion Middleware Oracle Team Productivity Center Serverインストレーション・ガイド

- Oracle Fusion Middleware Oracle Team Productivity Center Java APIリファレンス

- Oracle Fusion Middleware Oracle Team Productivity Center Connectorsタグ・リファレンス

- Oracle Fusion Middleware Oracle JDeveloperインストレーション・ガイド

- Oracle Fusion Middleware Oracle JDeveloperユーザーズ・ガイド

- Oracle Fusion Middleware Oracle JDeveloper Extensions開発者ガイド

- Oracle JDeveloper 11gオンライン・ヘルプ

- Oracle JDeveloper 11g リリース・ノート(Oracle JDeveloper 11gインストール内のリンクおよびOracle Technology Networkから入手)

表記規則

このマニュアルでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック体

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

リリース11.1.2.4.0のこのガイドでの新機能

リリース11.1.2.4.0の『Oracle Fusion Middleware Oracle Team Productivity Centerユーザーズ・ガイド』は、以前のリリースのOracleチーム・プロダクティビティ・センターで使用可能な非状況依存のオンライン・ヘルプに換わるものです。Oracleチーム・プロダクティビティ・センターの使用、Oracleチーム・プロダクティビティ・センターの管理およびOracleチーム・プロダクティビティ・センター・コネクタの使用に関する情報が含まれています。

このリリースのOracleチーム・プロダクティビティ・センターの詳細は、Oracle Technology NetworkのOracleチーム・プロダクティビティ・センターに関するページ(http://www.oracle.com/technetwork/developer-tools/tpc/overview/index.html)を参照してください。

このリリースでOracle JDeveloperおよびOracle Application Development Framework(Oracle ADF)に加えられた変更については、Oracle Technology Networkの新機能に関するページ(http://www.oracle.com/technetwork/developer-tools/jdev/documentation/index.html)を参照してください。

1 Oracleチーム・プロダクティビティ・センターの概要

この章では、ログイン、接続と切断、チームの選択、ビルド・サマリーの使用と解析を含む、Oracleチーム・プロダクティビティ・センターの基本操作について説明します。

この章には、次の項があります。

- 第1.1項「Oracleチーム・プロダクティビティ・センターについて」

- 第1.2項「Oracleチーム・プロダクティビティ・センターへの接続」

- 第1.3項「Oracleチーム・プロダクティビティ・センターのナビゲート」

- 第1.4項「ビルド・ダッシュボードおよびビルド・サマリーの理解」

1.1 Oracleチーム・プロダクティビティ・センターについて

Oracleチーム・プロダクティビティ・センターはOracle JDeveloperの1機能で、一連のアプリケーション・ライフサイクル管理(ALM)ツールおよびテクノロジへのアクセスを提供します。

製品開発組織が製品のライフサイクル全体で使用するデータ追跡ツールやデータ・リポジトリ・ツールは増え続けており、ALMツールはこれらのツールを統合する必要性に対応しています。たとえば、製品開発の初期段階では、製品の定義や仕様を追跡すると同時に、初期テストで検出された欠陥も追跡するのが一般的です。製品がリリースされると、カスタマのリクエストや拡張機能は第三者のリポジトリで追跡されます。その後、開発者がある開発ブランチでカスタマがリリースした製品を保守しながら、別のブランチで次のリリースに向けた新機能の開発を行う必要がある場合は、リクエストや欠陥を追跡するリポジトリを、チームのバージョン・コントロール・システムの適切な開発ブランチ(保守または新機能)にリンクする必要があります。Oracleチーム・プロダクティビティ・センターを使用すると、チームは、これらすべてのリポジトリに加えて、チームが使用する他のすべてを統合開発環境に直接統合できます。

外部データ・リポジトリをIDEに組み込むのに加えて、Oracleチーム・プロダクティビティ・センターでは、ローカル・チーム管理者が構成および保守できる、チームおよびサブチームの高度に柔軟な階層をサポートしています。Oracleチーム・プロダクティビティ・センターは次の目的で設計されています。

- 現在のアーティファクト・リポジトリ(バグ・データベース、バージョン・リポジトリ、その他のコンテンツ・ライブラリを含む)への統一アクセスを提供し、リポジトリ間の統合を実現して、既存の投資の価値を高めます。

- チームおよびサブチームを迅速かつ柔軟に編成できます。

- チャットを通じて他のチーム・メンバーと共同作業を行います。

- コラボレーション、ラベルの共有および円滑な情報フローを通じて、開発プロセスにおける異なるチーム間の障壁を削減し、ハードウェアによる多くの境界を取り除きます。

- スキル、プロセスおよびテクノロジに対する現在の投資を最大化します。

- 開発チーム環境への新しいアプリケーションの統合に必要な時間を削減して、柔軟性を向上させます。

また、Oracleチーム・プロダクティビティ・センターでは、開発中の最新ビルドに関する情報も表示されます。ビルド・ダッシュボードおよびビルド・サマリーには、開発ビルドのステータスに関する要約情報が表示され、最新ビルドに関する問題の詳細をすばやく確認できるリンクも表示されます。

1.1.1 前のバージョンからの移行方法

Oracleチーム・プロダクティビティ・センターを含む最新バージョンのOracle JDeveloperをインストールするときは、前のバージョンからファイルを移行できます。すでにチーム・プロダクティビティ・センターを使用しており、新しいバージョンにアップグレードする場合は、インストール指示に従って最新バージョンに移行してください。特に、使用するコネクタについては、最新バージョンをインストールして移行してください。これによって、最新機能を使用でき、使用するコネクタが最新のチーム・プロダクティビティ・センター・クライアントと完全に互換性があることが保証されます。

1.2 Oracleチーム・プロダクティビティ・センターへの接続

Oracleチーム・プロダクティビティ・センターは3つの部分で構成されています。

- Oracleチーム・プロダクティビティ・センター・クライアント・ソフトウェア。

- Oracleチーム・プロダクティビティ・センター・サーバー・ソフトウェア(Oracle Technology Networkから入手可能)。サーバー・ソフトウェアにはスタンドアロン・インストール・ガイドが含まれ、このガイドもOracle Technology Networkから入手でき、Oracleチーム・プロダクティビティ・センターのサーバーやコネクタのインストールに関するヘルプを閲覧できます。

- Oracleチーム・プロダクティビティ・センター・コネクタ(「ヘルプ」→「更新の確認」を選択して使用可能)。コネクタによって、JDeveloper内で稼働するOracleチーム・プロダクティビティ・センター・クライアント・ソフトウェアは、バグ追跡システム、機能データベースなどのデータ・リポジトリとの相互作用が可能になります。

Oracleチーム・プロダクティビティ・センター・サーバーに接続する手順は、次のとおりです。

- 「表示」→「チーム・ナビゲータ」

これによって、チーム・ナビゲータが開きます。「チーム・サーバーに接続」をクリックして続行します。

「更新の確認」からコネクタをインストールする方法の詳細は、Oracle Fusion Middleware Oracle JDeveloperユーザー・ガイドの「更新の確認」を使用した拡張機能のインストール方法」に関する項を参照してください。

1.2.1 チーム・プロダクティビティ・センターへのログイン方法

チーム・プロダクティビティ・センターに初めてログインするときは、管理者が提供するいくつかの情報が必要です。

表1-1 プロダクティビティ・センターのログイン・オプション

オプション

説明

チーム・サーバー

Oracleチーム・プロダクティビティ・センター・サーバーのマシン名またはIPアドレス。

ポート

チーム・サーバーが使用する専用ポート。

SSLの使用

チーム・サーバー接続にSecure Socket Layer接続が必要な場合はこれを選択します。

ユーザー名

Oracleチーム・プロダクティビティ・センター管理者によって割り当てられたユーザー名。

パスワード

Oracleチーム・プロダクティビティ・センター管理者によって割り当てられたパスワード。このパスワードを変更するには、既存のパスワードでログインした後に「プロファイルの管理」を選択します。

接続情報の保存

このオプションを選択すると、今後のログインに必要なのは、パスワードの入力のみです。チーム・プロダクティビティ・センターでは、接続に関する他のすべての情報(サーバー、ポートおよびユーザー名)が保持されます。

自動的に接続

このオプションを選択すると、JDeveloperを開くたびにOracleチーム・プロダクティビティ・センターに接続されます。

1.2.2 Oracleチーム・プロダクティビティ・センターからの切断方法

チーム・プロダクティビティ・センターからはいつでも切断できます。

チーム・プロダクティビティ・センターから切断する手順は、次のとおりです。

1. 現在選択されているチームの右側にあるドロップダウンをクリックします。

2. チーム・サーバーから「切断」を選択します。

注意:

チーム・プロダクティビティ・センターは、JDeveloperを終了すると自動的に切断されます。

1.2.3 ユーザー・プロファイルの管理方法

Oracleチーム・プロダクティビティ・センターのユーザー・プロファイルには、ユーザーの氏名、電子メール、およびOracleチーム・プロダクティビティ・センターのパスワードが格納されます。「ユーザー・プロファイルの管理」ダイアログで、今後の接続用にパスワードが保存されるようにOracleチーム・プロダクティビティ・センターを設定することもできます。

ユーザー・プロファイルに値を設定する手順は、次のとおりです。

1. 「チーム・ナビゲータ」メニューから「プロファイルの管理」を選択します。

2. ダイアログの上部にある「名前」および「電子メール」フィールドで、任意のユーザー情報を更新します。

3. パスワードを変更するには、古いパスワードを入力し、新しいパスワードを1回目は「新規パスワード」フィールドに入力し、2回目は確認のために「パスワードの再入力」フィールドに入力します。

4. 今後の接続用にOracleチーム・プロダクティビティ・センターでパスワードを保存する場合は、「パスワードを保存する」を選択します。

5. 「OK」をクリックします。

1.2.4 リポジトリ・アカウントの管理方法

Oracleチーム・プロダクティビティ・センターを使用しているときは、データ・リポジトリに格納されている情報にアクセスする機会が多くありますが、多くの場合、アクセスするにはユーザー・アカウントが必要です。たとえば、組織のバグ追跡データベースにアカウントがある場合、Oracleチーム・プロダクティビティ・センター内でバグ・レポート情報を表示、編集および保存するには、このアカウント情報をOracleチーム・プロダクティビティ・センターに提供する必要があります。

Oracleチーム・プロダクティビティ・センターでは、アカウント情報(ユーザーIDとパスワード)を格納して、作業中におけるこれらのアカウントへのアクセスを簡略化できます。作業アイテム・リポジトリの詳細は、第2.2項「作業アイテムの使用」を参照してください。

リポジトリ・アカウントを管理する手順は、次のとおりです。

1. 「チーム・ナビゲータ」メニューから「アカウントの管理」を選択します。

2. ダイアログの左ペインから、アカウント情報の変更が必要な作業アイテム・リポジトリを選択します。

3. ダイアログの右ペインに、選択したリポジトリに関連付けられたアカウントの最新情報を入力します。

4. オプションで、編集しているアカウントに対してユーザーIDとパスワードが正しいことを確認できます。これを行うには、「接続のテスト」をクリックします。テストの結果は「ステータス」ボックスに表示されます。

5. 情報が正しいことを確認してから、「OK」をクリックします。

1.3 Oracleチーム・プロダクティビティ・センターのナビゲート

Oracleチーム・プロダクティビティ・センターのナビゲートには、チーム・メンバーの表示、バージョニング・リポジトリの参照、作業アイテムの表示や問合せが含まれます。また、ユーザーのチームを選択して、チーム・メンバーとチャットすることもできます。

チーム・ナビゲータからチーム・プロダクティビティ・センターをナビゲートします。

チーム・ナビゲータを使用する手順は、次のとおりです。

- 「表示」→「チーム」→「チーム・ナビゲータ」の順に選択します。

チーム・ナビゲータ内にある追加のアコーディオンには、チーム・プロダクティビティ・センターの各種コンポーネントやインタフェースが表示されます。

Oracleチーム・プロダクティビティ・センターでは、「チーム・ナビゲータ」アコーディオンの最上部に、チームのドロップダウン・リストが表示されます。このリストからチームを選択すると、次の3つのアコーディオン・パネルに、選択したチームとそのメンバーのデータが表示されます。

チーム・メンバー

特定のチームを選択すると、そのメンバーが表示されます。

作業アイテム

選択したチームに接続している作業アイテム・リポジトリが表示されます。リポジトリに接続すると、そのリポジトリへの問合せを作成できます。作業アイテムおよびリポジトリの詳細は、第2.2項「作業アイテムの使用」を参照してください。

バージョニング

チームに接続しているバージョニング・リポジトリが表示されます。バージョニング・リポジトリからユーザーのプロジェクトまたはアプリケーション(バージョニング・システムに応じて)に、ファイルをチェックアウトできます。バージョニングされたファイルは読取り専用書式で表示できます。バージョニング・システムに応じて、いくつかのリポジトリ管理タスク(新規ディレクトリの作成など)を実行できます。

1.3.1 ユーザーのチーム・プロダクティビティ・センター・チームの選択方法

チーム・プロダクティビティ・センター・サーバーに接続すると、Oracleチーム・プロダクティビティ・センターでは、管理者がユーザーを追加したチームのリストが表示されます。

チーム・プロダクティビティ・センターにサインインした後は、使用可能なチームからチームを選択できます。(ユーザーが1つのチームのみのメンバーの場合、選択オプションは表示されません。)

チームを選択する手順は、次のとおりです。

1. 「チーム・ナビゲータ」タイトルの下にあるドロップダウン・リストをクリックします。

2. チームを選択します。

図1-1 チーム・ナビゲータを使用したチームの選択

ユーザー自身も含めたチーム・メンバーのリストが表示されます。「チーム・メンバー」アコーディオンの下に、「バージョニング」および「作業アイテム」アコーディオンが表示されます。それぞれから、チームで必要な情報リポジトリにアクセスできます。

Oracleチーム・プロダクティビティ・センターでは、チーム・メンバーのオンラインおよびチャット・ステータスが表示されます。さらに、チーム・メンバーの名前の上にカーソルを置くと、そのメンバーのデータ(氏名、現在表示されているチームでのロール、および電子メール・アドレス)が表示されます。チーム・メンバーの名前の上でマウス・ボタンを右クリックすると、次のオプションが表示されます。

電子メールの送信

システムのデフォルトのメール・ツールにメッセージが開きます。

チャット

メンバーとのチャットを開始します。チャット・アプリケーションまたはチャット・サーバーが未選択の場合、Oracleチーム・プロダクティビティ・センターでは「チャット・サーバーに接続」ダイアログが表示されます。

1.3.2 チーム・プロダクティビティ・センターのチャットの使用方法

チーム・プロダクティビティ・センターをインストールした後は、チームのメンバーとチャットできます。

Oracleチーム・プロダクティビティ・センターのチャットに接続する手順は、次のとおりです。

- 「表示」→「チーム」→「チャット」の順に選択します。

チャット・セッションは、次の2つの方法で開始できます。

- 「チーム・メンバー」アコーディオン・ヘッダーの横にあるチャット記号をクリックします。

- 任意のチーム・メンバーの名前をダブルクリックします。

Oracleチーム・プロダクティビティ・センターでチャットを開始するときのチャット対象には、2つのグループがあります。

- アクティブなXMPP/Jabberプロトコルからの友人

- 現在選択されているチームからのチームメート(メンバー・アコーディオンにのみ表示)

接続できるのは一度に1つのチャット・サーバーのみですが、別のチャット・サーバーへの新しい接続を作成し、それをアクティブなサーバーとして選択することもできます。

チーム・プロダクティビティ・センターをインストールした後は、「表示」→「チーム」→「チャット」の順に選択していつでもチャットを使用できます。このために、チーム・プロダクティビティ・センターに接続する必要はなく、チーム・プロダクティビティ・センターに接続しているかどうかに関係なく、チャット・ウィンドウはいつでもを開くことができます。ただし、接続していない場合、チーム・プロダクティビティ・センターのナビゲータからはチャットを開始できません。

新しいチャット・サーバー接続を作成する手順は、次のとおりです。

1. 現在のサーバーから切断します。「切断」ボタンを使用するか、または、リストから接続を選択し、マウス・ボタンを右クリックして「切断」を選択します。

2. 空の「友人」ノードを右クリックし、「接続」を選択します。
または、「接続プロパティの編集」ボタンをクリックするか、「接続」ツールバー・ボタンをクリックします。いずれの場合も接続プロパティ・ダイアログが開き、このダイアログから「接続」ボタンをクリックできます。

3. 新しいチャット・サーバーの設定を入力します。

1.3.2.1 チャット・サーバーへのログイン

Oracleチーム・プロダクティビティ・センターはXMPP/Jabberプロトコルのみをサポートしており、複数の接続はサポートしていません。「チーム・メンバー」チャット・パネルに初めてログインすると、Oracleチーム・プロダクティビティ・センターに必要な構成情報の入力を求められる場合があります。表1-2に、一般的に表示される情報を示します。

表1-2 構成オプション

オプション

説明

ホスト

ホスト・チャット・サーバーURLの名前。

ポート

割り当てられたポート番号。

ドメイン

割り当てられたドメイン。

リソース

JDeveloper。

ユーザー名

チャット・サーバーのユーザー名。

パスワード

チャット・サーバーのパスワード。

パスワードを保存する

(チャット・サーバー構成に依存)

JDeveloperの起動時に接続

(チャット・サーバー構成に依存)

これら2つのオプションは、チャット・サーバーの構成に応じて自動的に機能する場合とそうでない場合があります。

さらに、「チャット」ペインのツールバーには、接続または接続プロパティの編集へのショートカットになる2つのボタンがあります。

接続

チャット・サーバーに接続します。「接続プロパティの編集」と同じフィールドを使用します。

接続すると、「チャット」ウィンドウには、進行中のチャットのツールバーに「送信」(チャット・メッセージの送信)および「クリア」(すべてのテキストの削除)の2つのボタンが表示されます。

接続プロパティの編集

「チャット・サーバーに接続」ダイアログが表示され、チャット接続に関する次のプロパティを指定してサーバーに接続できます。

ホスト

選択したチャット・サーバーのURL。すでに接続しているサーバーから切断してから、「接続」または「接続プロパティの編集」のいずれかでこのプロパティを選択してください。

ポート

チャット専用のチャット・サーバーのポート。

ドメイン

チャット・サーバーをホストするために使用する最上位ドメイン(例: mycompany.com)。

リソース

JDeveloper。

ユーザー名

選択または指定したチャット・サーバーのユーザー名。

パスワード

前のフィールドのユーザー名に関連付けられているパスワード。

パスワードを保存する

今後のチャット・セッション用にこのパスワードを保存します。「JDeveloperの起動時に接続」を選択した場合は、自動的に選択されます。

JDeveloperの起動時に接続

JDeveloperを起動するたびに、このチャット・サーバーに自動的に接続します。これを使用して、デフォルトのチャット・サーバーを指定します。

これ以外に、「チャット」ウィンドウには、チャットを制御するためのボタンが4つあります。

表1-3 「チャット」ウィンドウの制御ボタン

ボタン

説明

切断/接続

接続しているときは、このボタンをクリックして現在のチャット・サーバーから切断します。切断しているときは、このボタンをクリックして「チャット・サーバーに接続」ダイアログを開きます。

表示

次のオプションを含むドロップダウン・メニューが表示されます。

オフラインの友人の表示

空のグループの表示

詳細の表示

グループの追加

友人の追加

ステータス

ドロップダウン・メニューが表示され、サーバーのステータス・メッセージの選択可能リストからステータスを選択できます(チャット・サーバーに応じて、「退席中」、「連絡可」、「会議中」などが表示されます)。ユーザーが選択したメッセージは、そのユーザーのアイコンをチャット・ウィンドウに表示している他のチーム・メンバーに対して表示されます。

接続プロパティの編集

「接続プロパティの編集」ダイアログが開きます。

1.4 ビルド・ダッシュボードおよびビルド・サマリーの理解

ビルド・ダッシュボードおよびビルド・サマリーには、組織がチーム・プロダクティビティ・センターを使用して追跡しているプロジェクトのビルドの要約が表示されます。ユーザーがチーム・プロダクティビティ・センターに初めてログインすると、JDeveloperにビルド・サマリーの一時的なスナップショットが表示され、ユーザーのチームが属する開発/ビルド・ブランチに関する情報、最新ビルド、およびその他の結果へのリンクが表示されます。

ビルド・ダッシュボードには、組織がチーム・プロダクティビティ・センターを使用して追跡しているプロジェクトのビルドに関する詳細な統計が表示されます。サマリーの上部には、ビルドに表示されるビルド情報、テスト結果および合計作業アイテムの概要が示されます。Oracleチーム・プロダクティビティ・センターを使用してソース管理システムにコミットした場合は、使用しているソース管理システムの関連トランザクションが下部に表示されます。ビルド・ダッシュボードにリストされている特定のビルドのビルド・サマリーを開くと、その特定のビルドの追加詳細を表示できます。

1.4.1 ビルド・ダッシュボードを開いて使用する方法

ビルド・ダッシュボードが表示されていない場合は、「表示」メニューからアクセスできます。

ビルド・ダッシュボードを開く手順は、次のとおりです。

- 「表示」→「チーム」→「ビルド・ダッシュボード」

Oracleチーム・プロダクティビティ・センターにログインする前にビルド・ダッシュボードを選択すると、最初にOracleチーム・プロダクティビティ・センターにログインするように求められます。

ビルド・ダッシュボードを使用する手順は、次のとおりです。

ビルド・ダッシュボードで行のブランチ名または「合計トランザクション」リンクをクリックすると、ビルド・サマリー・ウィンドウが表示されます。ここには、組織がチーム・プロダクティビティ・センターを使用して追跡しているプロジェクトのビルドに関する統計が表示されます。

ビルド・ダッシュボードを表示した後は、最新ビルドから選択して、表1-4に示す情報を表示できます。

表1-4 ビルド・ダッシュボードのオプション

オプション

説明

ブランチ

ドロップダウンをクリックして、関心がある開発ブランチを選択します。

ビルド

選択したブランチ内のビルドの順次リスト。関心があるビルドをクリックすると、選択したビルドのビルド・サマリーが表示されます。

ブランチのビルド・リストの下にあるビルド・ダッシュボードには、選択したブランチ内の選択したビルドに対する関連トランザクションのリストが表示されます。

関連トランザクション

ビルド・ダッシュボードには、選択したブランチの「変更セット」、変更セット所有者、「リポジトリ」、「タイプ」および「キー」が表示されます。この中で「変更セット」および「キー」は選択可能ですが、他の表示要素は読取り専用です。

変更セット

選択したバージョニング・システムの変更セット。個々の変更セットを選択すると、その内容が「ログ」ウィンドウにロードされ、選択した変更セットに割り当てられた要素が表示されます。

キー

表示されている変更セットに関連付けられた作業アイテムが表示されます。作業アイテムを選択して、表示および変更します。

1.4.2 ビルド・ダッシュボードおよびビルド・サマリーの使用方法

すべてのビルド/テスト・システムは、プラグインがビルド/テスト環境にインストールされたとき(通常はOracleチーム・プロダクティビティ・センターが最初にインストールされたとき)に構成されます。インストールおよび構成の後に、ビルド/テスト・システムの結果がチーム・プロダクティビティ・センター・クライアントに返され、ビルド・ダッシュボードで使用可能になります。ダッシュボードは、関心がある結果を表示するようにカスタマイズできます。

ビルド・ダッシュボードの表示をカスタマイズする手順は、次のとおりです。

- ビルド・ダッシュボードから「ブランチ」ドロップダウンをクリックし、「カスタマイズ」を選択します。

これによって、「モジュール表示および通知の管理」ダイアログが開きます。このダイアログから、ダッシュボードに表示するモジュールを選択でき、いずれかのモジュールが更新された場合の通知をJDeveloperでサブスクライブするかどうかも選択できます。「モジュール表示および通知の管理」ダイアログの使用中に詳細を参照する場合はいつでも、[F1]を押すか、または「ヘルプ」をクリックします。

ビルド・ダッシュボードから、詳細の確認に使用可能なビルドを1つ選択します。これによって、選択したビルドのビルド・サマリーが表示されます。

ビルド・ダッシュボードからビルドを選択する手順は、次のとおりです。

- ビルド・ダッシュボードから「ブランチ」ドロップダウンをクリックし、関心があるビルドを選択します。

ビルド・サマリーには、組織がチーム・プロダクティビティ・センターを使用して追跡している特定の1つのビルドに関する統計が表示されます。サマリーの上部には、ビルドに表示されるビルド情報およびテスト結果の概要が表示されます。表1-5に、ビルド・サマリーのオプション(作業アイテムや所有者情報を含む特定のビルドに関する詳細情報など)を示します。

表1-5 ビルド・サマリーのオプション

オプション

説明

表示

ビルド・サマリーに表示する統計を選択します。

すべてのテスト

すべてのテストの結果(パスと失敗の結果を含む)を表示します。

エラーのみ

エラーが発生したテストの結果のみ表示します。

失敗のみ

失敗したテストの結果のみ表示します。

エラーおよび失敗

エラーが発生したテストおよび失敗したテストの両方の結果を表示します。

成功のみ

成功したテストの結果のみ表示します。

ビルド・サマリーの統計ドロップダウン・リストの横には、表示する情報を変更するために次のいくつかの方法が用意されています。

未割当てのみ

このボックスを選択すると、ビルド・サマリーには、所有者が未割当ての選択された結果(「表示」ボックスで選択した統計によって決まります)のみが表示されます。このボックスを選択しないと、すべての結果が表示されます。

フィルタ

カテゴリおよび文字列でフィルタ処理された、選択した結果が表示されます。双眼鏡ドロップダウンをクリックし、結果をフィルタ処理する領域を選択します。結果をフィルタ処理するカテゴリとして、「モジュール」、「クラス」、「テスト・ケース」、「所有者」または「作業アイテム」のいずれかを選択できます。

たとえば、カテゴリを選択した場合は、ビルド・サマリーで検索フィルタとして使用する文字列を入力します。ビルド・サマリーには、フィルタ文字列に一致する結果のみが表示されます。

展開/縮小

ビルド・サマリーでは、「クラス」列の結果の左側にあるノード・アイコンをクリックして、個々の結果を展開したり縮小できます。「フィルタ」フィールドの横にある「すべて展開」(二重のプラス記号アイコン)および「すべて縮小」(二重のマイナス記号アイコン)をクリックして、すべての結果を展開したり縮小することもできます。

ビルド・サマリーには、概要の下に、モジュール、クラスおよび実行したテストに関する詳細情報が表示され、チームがバグ情報を追跡するために使用しているリポジトリへのリンクも表示されます。サマリーには次の列があります。

テスト

ビルドに対して実行されたテスト・クラスの名前。クラス名の左側にある+または-記号をクリックすると、このクラス内のメンバーの階層表示を展開したり縮小でき、画面の上部にある「すべて展開」および「すべて縮小」アイコンを使用すると、すべてのクラスを展開したり縮小できます。

テスト実行

各クラスでのテスト実行の回数。クラスを展開すると、サマリーに、クラスのメンバーごとのテスト実行回数、およびクラスでのテスト実行の合計回数が表示されます。

失敗

各クラスでの結果が失敗だったテストの回数。

パス率(%)

成功したテストの割合。各行の割合は、クラスの各メンバーの失敗に対するパスの割合を反映しているため、行を縮小(そのクラス・メンバーの要素の表示を抑制)した場合は、その行を展開するまで、表示されている数値にパス率が反映されない場合があります。

ステータス

各テストのステータス(成功、注意または失敗)を表すグラフィック表示。

結果

「結果」列には、テストの結果を要約した情報(特定のエラー・メッセージ、そのテストで作成された出力を含む)の詳細画面へのリンクが表示されます。失敗したテストの場合、この列には、通常、完全なスタック・トレースなどの詳細データが表示されます。リンクをクリックすると、読取り専用ダイアログに完全データが表示されます。

所有者

選択した行のテストを担当するように割り当てられたチーム・メンバー。所有者には電子メールを送信したり、所有者の名前を右クリックしてその所有者とのチャット・セッションを開くことができます。

所有者がテストに割り当てられていない場合、「所有者」フィールドには、ユーザー自身を所有者として割り当てるためのボタンが表示されます。所有者が割り当てられていないテストは、「未割当てのみ」チェック・ボックスを選択した場合のみ表示されるアイテムです。

さらに、このセルには、「自分を所有者として追加」および「所有者として削除します」という切替えボタンが表示されます。失敗したテストの所有権を取得するには、「自分を所有者として追加」をクリックします。所有権を放棄するには、「所有者として削除します」をクリックします。

作業アイテム

テストに割り当てられたOracleチーム・プロダクティビティ・センターの作業アイテムの数。作業アイテム番号をクリックすると、その作業アイテムの詳細が表示されます。

チームがアクセス可能なすべてのリポジトリを表示するには、「作業アイテムの作成」をクリックします。これによって、そのチームで使用可能なすべての作業アイテム・リポジトリのリストが表示されます。次に、そのテストに適した作業アイテムを作成できます。

新しい作業アイテムが保存されると、ビルド・サマリー・ページは新しい作業アイテム番号で更新されます。

2 Oracleチーム・プロダクティビティ・センターの使用

作業アイテムは、個人が作業を実行できるチーム・プロダクティビティ・センター・アーティファクトの表現です。典型的な例には、プログラム欠陥レコード、要件データベース・エントリ、テスト・ケース、プロジェクト・タスク、ユースケースなどがありますが、作業アイテムはこれらに限定されません。チーム・プロダクティビティ・センター・アーティファクトは、適切なコネクタが存在する場合に表現および表示されます。

この章には、次の項があります。

- 第2.1項「Oracleチーム・プロダクティビティ・センターの使用について」

- 第2.2項「作業アイテムの使用」

- 第2.3項「タスク・リポジトリの使用」

- 第2.4項「添付ファイルの使用」

- 第2.5項「問合せの使用」

- 第2.6項「タグの使用」

- 第2.7項「関連の使用」

2.1 Oracleチーム・プロダクティビティ・センターの使用について

Oracleチーム・プロダクティビティ・センターの「作業アイテム」アコーディオンには、バグ追跡データベース、機能リクエストの記録システム、プロジェクト追跡情報、および主要なプロジェクトの追跡に使用するその他多様なタイプの共有テクノロジなど、チームを情報リポジトリに接続するノードが表示されます。

作業アイテムは、情報リポジトリの個々の要素を表現するためにチーム・プロダクティビティ・センターが使用するメカニズムです。たとえば、バグ追跡データベースの作業アイテムは個々のバグ・レポートで、機能リポジトリの作業アイテムはそのリポジトリで追跡される個々の機能リクエストです。

通常、作業アイテムのノードには、次のような製品開発ツールが含まれています。

- 機能リクエスト追跡リポジトリ(AtlassianのJIRA®など)

- バグ追跡データベース(Bugzillaなど)

- プロジェクト追跡ソフトウェア(Microsoft Project Server®など)

- チーム・プロダクティビティ・センター内のプロジェクトのステータス、優先度および所有権を追跡するためのOracleチーム・プロダクティビティ・センター独自のタスク・リポジトリ

Oracleチーム・プロダクティビティ・センターでは、コンテキストを保存し、アクティブなアイテムを作成し、ソース管理システムのチェックインの詳細を追加できます。これらのリポジトリに対する問合せとそれに続くこの情報は、開発プロセスの現在の部分にとって重要な様々な作業アイテム要素に対して関連を作成し、タグを割り当てることで作成できます。

さらに、各作業アイテムには独自の関連セットがあり、これによって、作業アイテムは、独自のリポジトリ(つまり、独自のタイプのリポジトリ)内の他の作業アイテムと、必要な場合は他のタイプの作業アイテムとの関連を保持します。たとえば、バグ・データベース・エントリは要件追跡システムに、機能拡張リクエストはチーム・マイルストン・チャートにリンクできます。これらの関連は、チーム・プロダクティビティ・センターで使用する作業や特定のリポジトリの性質によって異なります。

2.1.1 Oracleチーム・プロダクティビティ・センターの情報リポジトリのサポート方法

特定の情報リポジトリが作業アイテム・ノードとして使用可能になるための要件は、次のとおりです。

1. 管理者は、チーム・プロダクティビティ・センター・コネクタをサーバーに追加する必要があります。

2. エンド・ユーザーは、同じチーム・プロダクティビティ・センター・コネクタをインストールし、JDeveloperのコピーに拡張機能として追加する必要があります。

3. チームに対してリポジトリへのアクセス権を設定しておく必要があります。

4. リポジトリはオンライン状態である必要があります。

5. ログインしていない場合は、権限の要件に従ってOracleチーム・プロダクティビティ・センターの「アカウントの管理」ダイアログを使用してリポジトリにログインする必要があります。リポジトリへの接続の詳細は、第3.3項「Oracleチーム・プロダクティビティ・センターでのリポジトリの有効化」を参照してください。

作業アイテムは、Oracleチーム・プロダクティビティ・センターの問合せに対するレスポンスでリポジトリから戻される情報のレコード、フィールドまたは単にアイテムとみなすことができます。

通常、問合せから戻る作業アイテムは、Oracleチーム・プロダクティビティ・センター・コネクタによって決定された選択可能な表形式で表現されます。

基礎となるリポジトリから戻された情報を使用して実行できる操作の範囲は、各リポジトリのコネクタの設計によって決まります。通常のユースケースでは、ダブルクリックして作業アイテムを編集し、コネクタ作成者が定義した方法でその作業アイテムと相互作用できます。JDeveloper内で使用するコネクタを開発し、チームが希望するリポジトリ内での一貫したユーザー操作性と機能を提供するために、コネクタ開発者はリポジトリの機能とユーザー・インタフェースを可能なかぎり複製することをお薦めします。

2.2 作業アイテムの使用

作業アイテムは、該当するリポジトリで追跡するデータをカプセル化するデータ・リポジトリの要素です(バグの説明、バージョン番号、および製品ライフサイクル管理方法論に重要なその他の情報をカプセル化するバグ・レポートなど)。

作業アイテムのもう1つの側面は、作業アイテムをデータ・リポジトリに対して実行した問合せの結果とみなすことです。チーム・プロダクティビティ・センターから戻された作業アイテムとは、様々な方法で相互作用できます。

2.2.1 作業アイテムの作成方法および使用方法

作業アイテムにアクセスするには、その前に、「アカウントの管理」ダイアログを介して、関連するリポジトリにログインする必要があります。リポジトリにログインした後は、問合せを実行してそのリポジトリから特定のレコードを戻すことができます。個々のレコードをダブルクリックすると、JDeveloperではそのレコードが作業アイテムとして開きます。詳細は、第2.5.2項「問合せの実行方法」を参照してください。

リポジトリから1つ以上の作業アイテムを選択した後は、実行しているタスクの一環としてその作業アイテムに対して次の操作を実行できます。

1. チームが使用するバージョン・コントロール・システムにファイルをチェックインする場合は、変更リストを作業アイテムにリンクします。これにより、同じ作業アイテムにアクセスする他のチーム・メンバーは、この変更リストを参照して、実行された変更内容とコメントを確認できます。詳細は、第2.2.2項「変更リストでの作業アイテムの使用方法」を参照してください。

2. 作業アイテムをアクティブな作業アイテムとして保存します。これにより、JDeveloperを終了し、その後再起動したときに、同じ作業アイテム(現在解決に取り組んでいるバグなど)に簡単にアクセスできます。詳細は、第2.2.3項「アクティブな作業アイテムの設定方法および表示方法」を参照してください。

3. この作業アイテムのコンテキスト(開いているすべてのファイルなど)を保存します。これにより、アプリケーション、ファイルおよび作業中の作業アイテムに関連付けられている他の階層要素が格納されます。
アクティブな作業アイテムのみでなく、任意の作業アイテムからコンテキストを保存およびリストアできます。最後にアクティブな作業アイテムを使用してJDeveloperを閉じた場合、次の再起動時には、すべてのエディタが、閉じたときの状態で開きます。別の作業アイテムに移動する場合(または、JDeveloperを閉じる前の最後の作業でアクティブな作業アイテムを使用しなかった場合)は、コンテキストをリストアして、目的の作業アイテムについて最後に作業した時点のJDeveloperにすばやく戻ることができます。

4. 作成した作業アイテムを通じて作業しているプロジェクトに関連付けられている要素をJDeveloperに簡単に再移入するには、特定の作業アイテム(アクティブな作業アイテムまたはコンテキストを保存した別の作業アイテムのいずれか)に対して「コンテキストのリストア」を選択します。詳細は、第2.2.7項「コンテキストの保存方法およびリストア方法」を参照してください。

5. 作業アイテムをタグ・リストに追加します。詳細は、第2.6項「タグの使用」を参照してください。

6. 別の作業アイテムに対する関連を作成します。第2.7項「関連の使用」。

2.2.2 変更リストでの作業アイテムの使用方法

ファイルをバージョン・コントロール・システムにコミットすると、ファイルを1つ以上の作業アイテムにリンクすることで、そのファイルをバージョン・リポジトリに関連付けることができます。あるいは、ファイルを関連付ける1つ以上の別の作業アイテムを選択できます。各作業アイテムの「変更」タブには、その作業アイテムに関連付けられている1つ以上のファイルのリストが表示されます。

開いた作業アイテムには、チェックイン情報が格納されている場合があります。これにより、そのアイテムに対して行われたすべてのチェックイン(時間の経過によって複数の場合があります)のリスト、チェックインに含まれている各ファイルの詳細およびチェックインのコメントを参照できます。

ファイルを変更リストとして作業アイテムに追加する手順は、次のとおりです。

1. 「変更リスト」タブで、チェックインするファイルのリストを選択し、選択したバージョン・コントロール・システムのチェックイン・ダイアログを開きます。

2. これらのファイルを関連付ける作業アイテムを選択します。

3. 選択したバージョン・コントロール・システムに、これらのファイルをチェックインします。
ファイルは、Oracleチーム・プロダクティビティ・センターの選択した作業アイテムの「変更リスト」タブにリスト表示されます。

JDeveloperでは、ファイルのリストが、チェックイン・バージョンID、チェックイン日付および選択した各作業アイテムに対して開発者が記述したチェックインのコメントとともに、適切なリポジトリに格納されます。

2.2.3 アクティブな作業アイテムの設定方法および表示方法

JDeveloperのアクティブな作業アイテムは、作業アイテムのツールバーにある「アクティブにする」コマンドをクリックして選択した作業アイテムです。問合せで戻された作業アイテムのリストで、作業アイテムを右クリックすることもできます。作業アイテムはいつでもアクティブとして選択できます。1度にアクティブにできる作業アイテムは1つのみであるため、新しい作業アイテムをアクティブにすると、以前に選択したアクティブな作業アイテムと置き換わります。

リポジトリのリストの上にある「作業アイテム」アコーディオンには、選択した作業アイテムへのリンクが表示されます。このリンクはJDeveloperを閉じ後もそのままです。JDeveloperをシャットダウンした場合は、後でIDEを再起動すると、アクティブな作業アイテムのリンクが「作業アイテム」アコーディオンの上に表示されます。これにより、高い優先度で作業する予定のアイテムに戻るための、ブックマークとよく似た簡単な手段が提供されます。

JDeveloperでアクティブな作業アイテムを表示する手順は、次のとおりです。

- 「作業アイテム」アコーディオンの上部にあるリンクを選択し、アクティブな作業アイテムを開きます。問合せ結果リストでエントリを選択するには、マウスの右ボタンをクリックして「アクティブにする」を選択し、作業アイテムをアクティブとしてマークします。

JDeveloperでは、適切なリポジトリから作業アイテムが取得され、以前に設定した作業アイテムがアクティブな作業アイテムとして表示されます。

2.2.4 チーム・プロダクティビティ・センターからリポジトリへの接続方法

チームには、同じリポジトリに対して、パラメータの値が異なる1つ以上のリポジトリ・サーバーが指定される可能性があることに注意してください。たとえば、地理的なプリファレンスに基づいて、リポジトリに2つのミラー・サイトが指定される場合があります。ユーザーは、ログイン時に「アカウントの管理」ダイアログで接続先のサーバーを選択できますが、同じデータ・リポジトリへのアクセスは引き続き維持されます。

リポジトリに接続する手順は、次のとおりです。

1. 「チーム・ナビゲータ・メニュー」→「アカウントの管理」の順に選択します。

2. 「アカウント」列の下でいずれかのリポジトリを選択します。

3. 「リポジトリ・サーバー」ドロップダウンから、前のステップで選択したリポジトリに対する優先サーバーを選択します。

4. このリポジトリに関連付けられているサーバーのログイン資格証明(ユーザー名とパスワード)を入力し、「OK」をクリックします。
「テスト」をクリックして、リポジトリへの接続を確認することもできます。これにより、接続データを検証し、必要に応じて変更できます。

2.2.5 チーム問合せを介した作業アイテムのアクセス方法

チーム・プロダクティビティ・センターでは、問合せを使用して、選択したリポジトリの作業アイテムにアクセスします。問合せを使用すると、作業アイテムの要素(たとえば、バグ・ステータスやバグ・データベース・リポジトリのID番号の範囲)を指定して、作業アイテムのみ、または関心のある作業アイテムの範囲を戻すことができます。

チーム問合せは、チームのメンバーすべてが使用できるように管理者が設定した問合せです。チーム問合せに加え、チーム・プロダクティビティ・センターでは、ユーザー問合せも作成できます。詳細は、第2.5項「問合せの使用」を参照してください。

ログインした後は、これらの問合せを使用して、使用可能なリポジトリから個々の作業アイテムにアクセスします。チーム・プロダクティビティ・センターで初めて作業を開始するときは、ユーザー問合せはほとんど作成されていませんが、チーム問合せは使用できる可能性があります。次の手順では、チーム管理者により、1つ以上のリポジトリに複数のチーム問合せが保存されていると仮定します。

特定の作業アイテム・ノードを使用するには、その前に、「アカウントの管理」ダイアログを介してリポジトリにログインする必要があります。ログインしていない場合は、作業アイテムにアクセスしようとすると、「アカウントの管理」ダイアログにアクセスするように指示されます。

チーム問合せを介して作業アイテムにアクセスする手順は、次のとおりです。

1. 「作業アイテム」アコーディオンで、リポジトリの名前の横にある「+」をクリックし、リストを展開します。

2. 「チーム問合せ」の横にある「+」をクリックし、リストを展開します。

3. いずれかのチーム問合せをダブルクリックします。JDeveloperでは、この問合せの結果が中央のペインに表示されます。

問合せの構造によっては、大量の作業アイテムが中央のペインに表示される可能性があります。上下にスクロールして、選択した問合せで戻される作業アイテムの範囲を確認します。戻される作業アイテムの数は、この問合せの結果を後で調整して、制限(または拡大)できます。また、プロジェクト・チームの一部を反映する特定種類の作業アイテムへの絞込みに役立つユーザー独自の問合せも作成できます。

作業アイテムを右クリックして、作業アイテムの問合せに使用できる操作のリストから選択することもできます。JDeveloperには、該当する問合せに固有の操作のメニューが表示されます。

2.2.6 プロジェクト・ファイルに作業アイテムを関連付ける方法

選択したバージョン・コントロール・システムでファイルをコミットするときは、プロジェクトで作業しているファイルに作業アイテムを関連付けることができます。Oracleチーム・プロダクティビティ・センターがアクティブな場合、「コミット」ダイアログ(一部のシステムでは「チェックイン」ダイアログ)には、変更をコミットする際にファイルに関連付ける作業アイテムを指定できる追加のフィールドが表示されます。

Oracleチーム・プロダクティビティ・センターを使用している場合は、選択したバージョン・コントロール・システムの「コミット」ダイアログに、Oracleチーム・プロダクティビティ・センターの作業アイテムをサポートするために設計されたオプションの機能(後述)が表示されます。ソフトウェアの「コミット」ダイアログに関するヘルプが必要な場合は、「ヘルプ」をクリックするか、[F1]を押します。

作業アイテムをプロジェクト・ファイルに関連付ける手順は、次のとおりです。

1. 選択したソース管理システムで、作業しているプロジェクト・ファイルからの変更をコミットします。たとえば、「チーム」→「Subversion」→「コミット」の順に選択します。

2. 「コミット」ダイアログから「作業アイテムとの関連付け」を選択します。
コミットするファイルに対して、Oracleチーム・プロダクティビティ・センターの作業アイテムを関連付けるには、「コミット」ダイアログの「作業アイテムとの関連付け」パネルの上にある緑色の「+」記号をクリックします。「作業アイテムの選択」ダイアログから作業アイテムを選択できるようになります。

「コミット」または「チェックイン」ダイアログの「作業アイテムとの関連付け」パネルに、追加する各作業アイテムに関する情報の4つの列が表示されます。

表2-1 チーム・プロダクティビティ・センターの作業アイテムに関する「コミット」ダイアログのオプション

列

説明

リポジトリ

作業アイテムが格納されているリポジトリ。作業アイテムにアクセスするためには、リポジトリのコネクタをインストールしておく必要があります。

タイプ

作業アイテムのタイプ。作業アイテムが格納されているリポジトリに依存します。たとえば、タスク・リポジトリの作業アイテムのタイプは「タスク」で、その他のリポジトリには別のタイプが指定される可能性があります。詳細は、特定のリポジトリまたはコネクタのドキュメントを参照してください。

ID

作業アイテムのID(たとえば、バグ番号や機能リクエストID)。

サブジェクト

作業アイテムのサブジェクトで、作業アイテムが格納されているリポジトリからインポートされます。

コミットするファイルに複数の作業アイテムを関連付ける場合は、作業アイテムを選択して「上へ移動」アイコン(二重の上矢印)をクリックすることで、選択した作業アイテムをリスト内で上下に移動できます。

コミットするファイルに複数の作業アイテムを関連付ける場合は、作業アイテムを選択して「上へ移動」アイコン(二重の上矢印)をクリックすることで、選択した作業アイテムをリスト内で上下に移動できます。

3. 終了後、「コミット」をクリックします。

ファイルから作業アイテムの関連付けを削除する手順は、次のとおりです。

1. 選択したソース管理システムで、作業しているプロジェクト・ファイルからの変更をコミットします。たとえば、「チーム」→「Subversion」→「コミット」の順に選択します。

2. リストから作業アイテムを選択し、赤色の「X」をクリックします。
「コミット」ダイアログから作業アイテムが即時に削除されます。作業アイテムを誤って削除した場合は、戻って追加します。

3. 終了後、「コミット」をクリックします。

2.2.7 コンテキストの保存方法およびリストア方法

開発プロセスでは、JDeveloperに多数のファイルやウィンドウを開く場合(たとえば、Javaクラスを開発しながら、それらのクラスをダイアグラムに視覚化する場合)があります。特に、JDeveloperを閉じたり、独自のファイル・セットの別のプロジェクトに切り替える必要がある場合など、特定のタスクに対して開くファイルやウィンドウを覚えておくことは簡単ではありません。

チーム・プロダクティビティ・センターでは、作業アイテムのコンテキストを保存してリストアする機能により、この問題に対応しています。チーム・プロダクティビティ・センターにログインし、作業アイテムを通じてタスクを追跡している場合は、「コンテキストの保存」を使用して、そのファイルのコンテキストおよびその作業アイテムに対するIDEレイアウトを保存できます。保存したコンテキストは、最終的にそのプロジェクトのフェーズが終了したときに削除できます。

後で「コンテキストのリストア」を使用して、そのファイル・セットとレイアウト(たとえば、複数のタスクを同時に作業している場合)に戻ることができます。

作業アイテムのコンテキストを保存する手順は、次のとおりです。

1. 作業アイテムを開きます。

2. 「コンテキストの保存」アイコンを選択します。編集している特定の作業アイテムに対してJDeveloperの状態が保存されます。

以前に保存したコンテキストをリストアする手順は、次のとおりです。

1. 作業アイテムを開きます。

2. 「コンテキストのリストア」アイコンを選択します。IDEがその作業アイテムについて保存された状態に戻されます。
問合せ結果リストのエントリをマウスの右ボタンでクリックし、「コンテキストのリストア」を選択することもできます。

保存したコンテキストを削除する手順は、次のとおりです。

1. 作業アイテムを開きます。

2. 「コンテキストの削除」アイコンを選択します。保存したコンテキストが作業アイテムから削除されます。

2.3 タスク・リポジトリの使用

Oracleチーム・プロダクティビティ・センターのタスク・リポジトリには、Oracleチーム・プロダクティビティ・センターのチーム用に共有To-Doリストを意図した作業アイテムが含まれています。このタスク・リポジトリは、チーム・プロダクティビティ・センター・サーバーのインストール時にインストールされます。チーム・プロダクティビティ・センターにタスク作業アイテムのリストがある場合は、次の列が表示されます。

表2-2 タスク作業アイテムのフィールド

列ヘッダー

説明

タスクID

タスク・リポジトリのこの作業アイテムに対する一意の識別子。

タスク名

このタスクに指定されている名前。

割当て先

このタスクの所有者。

優先度

このタスクに割り当てられている相対的な重要性。値は「高」、「標準」、「低」または「なし」です。

ステータス

このタスクの現在のステータス。値は「割当済」、「ブロック」、「完了」または「処理中」です。

開始日

このタスクの開始日。

終了日

このタスクの終了予定日。

タスク作業アイテムを作成または編集するときは、各列に表示する値を指定または変更します。第2.3.2項「タスク作業アイテムの作成方法」を参照してください。

2.3.1 タスク・リポジトリのタスクの検索方法

他の作業アイテムのリポジトリと同様にタスク・リポジトリを問い合せ、問合せ条件に一致する1つ以上の作業アイテムを取得します。

タスク・リポジトリを問い合せる手順は、次のとおりです。

1. 「タスク」→「問合せ」(または「タスク」→「チーム問合せ」)の順に選択します。

2. 実行する問合せをダブルクリックします。

Oracleチーム・プロダクティビティ・センターに、入力した問合せに一致する作業アイテムが表示されます。たとえば、リポジトリ内のタスク作業アイテムすべてのリストを表示するには、タスクIDが1以上のタスク作業アイテムを戻す問合せを作成します。

問合せの作成と操作の詳細は、第2.5項「問合せの使用」を参照してください。

2.3.2 タスク作業アイテムの作成方法

タスク作業アイテムは、「作業アイテム」アコーディオンから作成します。

タスク作業アイテムを作成する手順は、次のとおりです。

1. 「作業アイテム」アコーディオンで、「タスク」を右クリックし、「新規タスク」を選択します。タスク作業アイテム・エディタが開きます。

2. フィールドにタスクの情報を入力します。タスク作業アイテムのフィールドに関する情報を表示する場合は、[F1]を押します。

3. 終了後、「ファイル」→「保存」の順に選択します。

次回、使用可能なすべてのタスク作業アイテムを表示すると、新規に作成したタスクが「作業アイテム」ペインに表示されます。詳細は、第2.2項「作業アイテムの使用」を参照してください。

2.3.3 タスク作業アイテムの編集方法

関心のあるタスク作業アイテムを戻す問合せを実行した後は、「作業アイテム」ペインに表示されたタスク作業アイテムを編集できます。たとえば、タスク作業アイテムに最近完了した作業がある場合は、「ステータス」フィールドを「完了」に変更できます。

タスク作業アイテムを編集する手順は、次のとおりです。

1. 「作業アイテム」ペインで、編集するタスク作業アイテムを検索します。

2. 選択した作業アイテムをダブルクリックします。タスク作業アイテム・エディタが開きます。

3. フィールドにタスクの情報を入力します。タスク作業アイテムのフィールドに関する情報を表示する場合は、[F1]を押すか、「ヘルプ」アイコンをクリックします。

4. 終了後、「ファイル」→「保存」の順に選択します。

次回、使用可能なすべてのタスク作業アイテムを表示すると、更新したタスクが「作業アイテム」ペインに表示されます。詳細は、第2.2項「作業アイテムの使用」を参照してください。

2.4 添付ファイルの使用

チーム・プロダクティビティ・センターでは、作業アイテムのコネクタが添付ファイルをサポートしているかぎり、作業アイテムに添付ファイルを追加できます。たとえば、バグ修正をテストする一環としてローカル・システムにjarファイルを作成する場合は、ローカルjarをバグ・レポートに添付できます。これにより、QAスタッフは添付ファイルをダウンロードして、修正内容をテストできます。ユーザー操作性チームがアプリケーションの画面とダイアログのレイアウト設計を示す画像を添付することで、JDeveloperでは、さらに簡単にインタフェースを設計できます。さらに、これらの添付ファイルはあらゆる種類の作業アイテムに使用できるため、作業アイテムにタグを設定したり、関連を定義して作業を簡単に追跡できます。

一部のリポジトリ・コネクタは、任意のタイプのドキュメント(テスト・ケース、コード・スニペット、スクリーンショット、仕様など)の添付や作業アイテムへのWebリンクをサポートしています。添付ファイルをサポートしているかどうかを示し、サポートしている場合に、ドキュメントをドキュメント・リポジトリに格納してチーム・プロダクティビティ・センターに返す処理は、コネクタ作成者が担当します。詳細は、第4章「Oracleチーム・プロダクティビティ・センター・コネクタの使用」を参照してください。

作業アイテム・リポジトリが添付ファイルをサポートしている場合、作業アイテムには「添付ファイル」タブが表示されます。このタブをクリックすると、作業アイテムにすでに添付されているすべての添付ファイルが表示されます。添付ファイルをダブルクリックして、その添付ファイルに関連付けられているデフォルトのアプリケーションを起動するか、ファイルをローカルで保存します。ユーザーは、アップロードするシステム上のローカル・ファイルを選択して、作業アイテムに新しい添付ファイルを追加することもできます。ドキュメント・ストアの権限設定によっては、作業アイテムに添付されたドキュメントを削除することもできます。これらのドキュメントは作業アイテムに添付されるため、これは、作業アイテムにアクセスするチーム・プロダクティビティ・センターのすべてのユーザーが添付ファイルを表示できることを意味します。

添付ファイルはローカル・ファイル・システムまたはローカル・ネットワークからのファイルである可能性があり、この場合、ファイルの内容はコネクタ作成者が指定したドキュメント・リポジトリにアップロードされます。これらの参照は作業アイテムに添付されるため、これは、作業アイテムにアクセスするチーム・プロダクティビティ・センターのすべてのユーザーが添付ファイルを表示してダウンロードできることを意味します。アップロードとダウンロードの詳細は、コネクタの定義方法によって異なります。コネクタ作成者は、添付ファイルのアップロードとダウンロードに標準的なファイル・ブラウザ・インタフェースを使用することをお薦めします。

また、作業アイテムの添付ファイルは、Web上のコンテンツへのリンクにできます。このタイプの添付ファイルを追加すると、作業アイテムにURLが追加されます、表示している作業アイテムにURLのリンク先を表示するには、「添付ファイルのダウンロード」をクリックします。

2.4.1 添付ファイルの追加方法

選択した作業アイテムに添付ファイルを追加します。

添付ファイルを作業アイテムに追加する手順は、次のとおりです。

- 「作業アイテム」ビュー→「添付ファイル」タブ→「添付ファイルの追加」アイコンの順に選択します。

「添付ファイルの追加」ダイアログが開き、このダイアログでファイルまたは作業アイテムへのリンクを保存できます。添付ファイルは次のいずれかです。

ドキュメント・ファイル

「ファイル」アイコンを選択し、ファイル・システム・ブラウザを開きます。目的のファイルを参照し、「保存」を選択します。

Webリンク

URLをこの作業アイテムに添付します。添付ファイルとして保存するURLについて、次の情報を入力します。

- 名前: チーム・プロダクティビティ・センターの作業アイテムに表示する名前

- リンク: この名前に関連付けるURL

ファイルまたはURLをこの作業アイテムへの添付ファイルとして使用するように指定した場合は、「追加」を選択します。

2.4.2 添付ファイルのダウンロード方法

添付ファイルは、チーム・プロダクティビティ・センターの作業アイテムからローカル・ワークステーションにダウンロードできます。その後は、保存して、関連付けられているプログラム(テキスト・エディタやPDFビューアなど)で開くことができます。

添付ファイルをダウンロードする手順は、次のとおりです。

- 「作業アイテム」ビュー→「添付ファイル」タブ→「添付ファイルのダウンロード」アイコンの順に選択します。

「添付ファイルのダウンロード」ダイアログが開き、このダイアログで添付ファイルをローカルで表示または編集できるようにします。このダイアログでは、いずれかのオプションを選択します。

添付ファイルを開く

添付ファイルを適切なエディタまたはアプリケーションで開きます。たとえば、テキスト・ファイルをダウンロードすると、JDeveloperでは、現在のデフォルト・テキスト・エディタ(WordPadなど)が開きます。

添付ファイルの保存

添付ファイルをローカル・ファイル・システムにコピーします。このオプションを選択した後は、「ファイル」アイコンを選択して、添付ファイルを保存するローカル・ファイル・システムの場所を参照します。

2.4.3 添付ファイルの更新方法

チームと共有可能な新しい内容がある場合は、既存の添付ファイルを更新できます。

添付ファイルを新しい内容で更新する手順は、次のとおりです。

- 「作業アイテム」ビュー→「添付ファイル」タブ→「添付ファイルの更新」アイコンの順に選択します。

「添付ファイルの更新」ダイアログが開きます。このダイアログは、最後のアクセス以降に添付ファイルの内容が変更されている場合に使用できます。たとえば、添付ファイルが、問題に関する会議の議事録が記載されているテキスト・ファイルである場合は、「添付ファイルの更新」を使用して作業アイテムに最新の議事録をコピーします。

「添付ファイルの更新」を選択すると、JDeveloperでは、更新するファイルを選択できるファイル・ブラウザ・ダイアログが開きます。ファイルを参照し、「保存」を選択します。

注意:

ファイルは同じ名前でのみ更新できます。たとえば、設計会議の議事録に月と日の日付が使用されている場合(minutes_jan_15.txtなど)は、次の週の議事録(この例ではminutes_jan_22.txt)で添付ファイルを更新することはできません。

2.4.4 添付ファイルの名前の変更方法

すでにアップロードされている添付の名前は変更できます。

添付ファイルの名前を変更する手順は、次のとおりです。

- 「作業アイテム」ビュー→「添付ファイル」タブ→「添付ファイルの名前変更」アイコンの順に選択します。

「添付ファイルの名前変更」ダイアログが開き、このダイアログで作業アイテムに関連付けられている添付ファイル名を変更できます。

このダイアログには次のフィールドがあります。

タイプ

選択した添付ファイルが示す添付ファイルのタイプ(ファイルまたはURL)

古い名前

選択した添付ファイルの既存の名前

新規の名前

添付ファイルの変更後の名前

終了したら、「OK」をクリックします。

2.5 問合せの使用

問合せは、チーム・プロダクティビティ・センターで、接続されているリポジトリから作業アイテムを取得する手段です。チーム・プロダクティビティ・センターを使用する際は、管理者(または別のチーム・メンバー)が作成したチーム問合せを使用して、一般的な状況に対応する場合があります。たとえば、バグ・データベースを検索してチームが取り組んでいるプロジェクトまたは製品に割り当てられたすべての未解決事項を戻すチーム問合せは、そのチーム全体にメリットがあります。

ユーザーの作業に特に当てはまるカスタム問合せを作成することもできます。たとえば、同じバグ・データベースを検索し、ユーザーに割り当てられたすべての未解決事項を戻す問合せは、作業量の効果的な管理に役立ちます。

いずれの場合も、これらの例の問合せ結果はバグ・データベースから抽出されたレコードのリストになり、チーム・プロダクティビティ・センターに作業アイテムのリストとして表示されます。異なるリポジトリからの他の問合せでは、機能追跡リスト、スケジュール管理プログラム、またはユーザーとユーザーのチームが使用する他のリポジトリからレコードが戻される可能性があります。問合せでこれらの作業アイテムが戻された後は、チーム・プロダクティビティ・センターが提供する様々な方法でこれらの作業アイテムと相互作用できます。

2.5.1 問合せの作成方法

Oracleチーム・プロダクティビティ・センターでは、ユーザー問合せとチーム問合せの2つのタイプの問合せを作成できます。ユーザー問合せは、直面している特定の問題を解決するために本人が作成する問合せで、たとえば、特定の日付範囲に該当するバグや、別のメンバーのタスクを引き継いだ場合に個別のチーム・メンバーが保存したバグを検索します。特定のユーザー問合せは、これらの問題や他の差し迫ったニーズを解決するために簡単に作成できます。

同じ種類の作業アイテムを定期的に検索していることに気付いた場合は、既存の問合せを変更するかわりに、ユーザー独自の問合せを保存できます。たとえば、同じ製品の異なるブランチでバグを追跡している場合は、必要に応じて各ブランチのユーザー問合せを個別に保存し、各問合せに一致する作業アイテムを取得できます。

さらに、一部の問合せは、複数のチーム・メンバーが使用できるように一般化できます。たとえば、ユーザビリティ・セッションまたはベータ・プログラムの結果として保存されたバグをチーム全体で表示できます。複数のユーザーに適用される、このような広範なアプリケーションでの問合せは、チーム問合せとして保存およびアクセスされます。チーム問合せは、付与されているチーム・プロダクティビティ・センター管理権限に従って保存できます。

問合せを作成するには:

1. リポジトリを選択して問合せを作成し、関心のあるフィールドおよび情報を戻します。

2. 問合せの結果を確認し、必要に応じて設定を編集します。

3. 後で使用できるように問合せを保存します。この問合せを再度使用すると、同じフィールドがリポジトリから戻りますが、情報は更新されています。

4. 管理権限があり、問合せがチーム全体で使用できる十分な汎用性を備えている場合は、その問合せをチーム問合せとして保存します。

2.5.2 問合せの実行方法

チーム・プロダクティビティ・センターから問合せを実行すると、JDeveloper内では、問合せで結果が戻されるリソースへのアクセス権が付与されます。たとえば、バグ・データベースで、Oracleチーム・プロダクティビティ・センターの問合せを実行すると、実行した問合せの基準に一致するすべてのバグを戻すことができます。これにより、複数のウィンドウで個別のアプリケーションを使用することに比べて、バグ、修正および機能の追跡が簡略化されます。

既存の問合せを実行する手順は、次のとおりです。

1. 実行する問合せが格納されている作業アイテム・ノードをダブルクリックします。(または、ノードの左側の「+」をクリックします。)

2. 「チーム問合せ」または「問合せ」が開きます(「問合せ」アイコンの横に「+」が表示されない場合、その問合せは使用可能でないことを意味します)。

3. 使用可能な問合せをダブルクリックします(「未解決のバグ」など)。(または、「問合せ」を右クリックして「実行」を選択します。)問合せの名前が付いたタブ・パネルに、問合せ結果が表示されます。

注意:

戻された結果については、戻された行をダブルクリックし、詳細を表示して変更し、アクセスしている特定のリポジトリに対するOracleチーム・プロダクティビティ・センター・コネクタがサポートしているエクステントにコメントを追加できます。

2.5.3 問合せのカスタマイズ方法

Oracleチーム・プロダクティビティ・センターでは、既存のチーム問合せで開始した場合でも、問合せのカスタマイズは簡単です。このカスタマイズを可能にするキーは、基礎となるリポジトリから使用できるデータ・フィールドを2つの方法で使用できることです。

- 基礎となる情報への追加フィールドの適用。

- 画面上の結果レポートのカスタマイズ。

たとえば、チーム問合せには次のフィールドが用意されています。

- 製品

- タイプ

- ステータス

開発プロセスが終盤になると、「優先度」をフィルタリング要素として追加することの便利さに気付くことがあります。

ここでは、追加の問合せフィールド・フィルタを追加して既存の問合せを拡張する方法について簡単な例を示します。この例では、欠陥リポジトリに対する問合せ(具体的には、優先度が「ブロッカ」以外の欠陥を戻す問合せ)を作成します。

追加の問合せフィールド・フィルタを追加する手順は、次のとおりです。

1. 緑色の「+」アイコンをクリックして、新しい基準行を追加します。

2. 「問合せ結果」タブを開いた状態で、問合せの最も左側のドロップダウンをクリックし、使用可能なフィールドのリストを表示します。

注意:

すでに使用されているフィールド要素を選択できます。たとえば、2つのプロジェクトのレポートを取得するために、第2の「プロジェクト」フィールドを追加できます。

3. 最も左側のフィールド・ドロップダウンで、「優先度」を選択します。

4. 「次と等しくない」ドロップダウンを「次と等しい」に変更します。

5. 最も右側のドロップダウンで「ブロッカ」を選択します。

6. 「検索」をクリックします。

問合せを保存する前に、実行したフィールド・オプションの選択をクリアするには、「その他のアクション」ドロップダウン・メニューから「クリア」を選択します。すべての入力をクリアするには、「リストア」を選択します。

この問合せによって、入力した基準に一致する結果が戻ります。

ヒント:

結果は、単に列名をクリックすることで、列に従ってソートできます。また、問合せを保存すると、列の幅およびソートされた現在の列が保存されます。

カスタム問合せを作成した後は、その問合せを保存できます。

2.5.4 問合せの名前の変更方法

問合せの名前は、他の変更や適用したカスタマイズを反映するように変更できます。

問合せの名前を変更する手順は、次のとおりです。

1. 「その他のアクション」→「別名保存」の順にクリックします。

2. 「名前」フィールドに問合せの新しい名前を入力します。

3. 必要に応じて、問合せの可視性を変更します。
問合せをチーム全体に表示するには、「チーム」を選択します。

問合せを本人のみに表示するには、「ユーザー」を選択します。

4. 「OK」をクリックします。

入力した名前で問合せが使用可能になります。

2.5.5 変更した問合せの保存方法

チーム・プロダクティビティ・センターの一部の問合せは、1回のみ使用されます。たとえば、誤って保存された1つのバグ・レコードについてリポジトリを問い合せて、そのレコードを修正できます。バグ・エントリを修正した後は、その問合せを再度実行する必要はありません。

ただし、他の問合せは、本人またはチーム・メンバーにとって定期的に役立つ可能性があります。たとえば、製品領域の特定の組合せを対象に、ユーザーの名前が記載され、発生順と逆の順序でソートされた未解決のすべてのバグについて、バグ・データベースを検索する問合せがあるとします。これは、毎日使用する可能性がある問合せです。このような場合は、問合せを保存することで、後でその問合せを再度選択できます。

新規または変更した問合せを保存する手順は、次のとおりです。

1. 画面レポートの右側にある「その他のアクション」ボタンをクリックします。

2. 「別名保存」を選択します。

3. 問合せの名前を選択します(「未解決ブロッカ・バグ」など)。

4. チーム管理権限がある場合は、チーム問合せまたはユーザー問合せの作成の選択肢があります。ない場合は、ユーザー問合せの作成のみが許可されます。この例では、いずれの場合も「ユーザー問合せ」を選択して「OK」をクリックします。

チーム管理権限があり、保存しようとしている問合せがチームのメンバーすべてに役立つ場合は、「チーム問合せ」として保存することもできます。

すべての問合せが現在のチームに対して保存されることに注意してください。このリポジトリに複数のチームからアクセスするとしても、問合せは現在のチームの範囲で保存されます。

2.5.6 チーム問合せの作成方法

チーム管理権限がある場合は、チームが作業しているプロジェクトおよびそのプロジェクトのステータスに基づいて、チーム問合せを作成できます。たとえば、プロジェクトの終盤には、「出荷停止」という語が説明に含まれている優先度1前後のバグに関する問合せを作成し、チームが使用できる問合せのセットに追加すると便利です。

チーム問合せを保存するためのオプションは、チーム権限がある場合にのみ表示されます。チームの他のメンバーに役立つ問合せを頻繁に作成していることに気付いた場合は、チーム・プロダクティビティ・センターの管理者にチーム権限の付与を依頼してください。詳細は、第3章「Oracleチーム・プロダクティビティ・センターの管理の使用」を参照してください。

新しいチーム問合せを保存する手順は、次のとおりです。

1. 画面レポートの右側にある「その他のアクション」ボタンをクリックします。

2. 「別名保存」を選択します。

3. 問合せの名前を選択します(「未解決ブロッカ・バグ」など)。

4. チーム管理権限がある場合は、「チーム問合せ」を選択して「OK」をクリックします。

2.5.7 問合せの削除方法

チーム問合せを削除できるのは、チーム問合せの変更が許容されているロールに割り当てられているユーザーのみです。チーム・プロダクティビティ・センターで使用されるデフォルトのロールでは、チーム管理者とグループ管理者のロールに割り当てられているユーザーが該当します。

作成した問合せを削除する手順は、次のとおりです。

1. 「Oracleチーム・プロダクティビティ・センター」パネルで、削除する問合せを右クリックします。

2. 「削除」オプションを選択し、確認ダイアログに「はい」で回答します。

2.6 タグの使用

個々の作業アイテム・リポジトリへの接続に加え、Oracleチーム・プロダクティビティ・センターには、追加の統合のために複数のリポジトリの作業アイテムにタグを設定できるタグ付けメカニズムが用意されています。作業アイテムに設定したタグについてリポジトリを問い合せることで、リポジトリ全体のアイテムを表示できます。チーム・プロダクティビティ・センターには、作業アイテムが属するリポジトリに関係なく、指定のタグが設定されている作業アイテムが表示されます。

タグ付けされた作業アイテムと問合せで戻された作業アイテムとの主な相違は、問合せで戻る作業アイテムでは、問合せによってリポジトリ全体が検索され、問合せ条件(たとえば、バグIDの範囲や機能拡張リクエストの所有者)に一致するアイテムが検索され、戻されます。一方、タグ付けされた作業アイテムは、すでに識別されて特定の目的のために特にタグが設定された作業アイテムです。機能的には次のように考えられます。問合せを使用して特定の検索条件に一致する作業アイテムのリストを取得し、そのリストを入手した後は、特に関心のある個々の作業アイテムにタグを設定できます。

チーム・プロダクティビティ・センターでは、2種類のタグが使用されます。

- チーム・タグは、チーム管理者またはグループ管理者が設定し、チームのすべてのメンバーが使用できます。各チームのタグはそのチームに固有で、他のチームとは共有されません。複数のチームで作業する場合は、様々なチームの管理者が異なるタグを使用する可能性があります(ただし、特に組織でバグ追跡、機能リクエストなどに企業全体のタグを使用する場合など、管理者が同じタグを使用するように選択する可能性もあります)。

- プライベート・タグは、作業アイテムの検索、ソートおよびグループ化(プロジェクト別、緊急度別または特定のコード・セクション別)に役立つように、ユーザーが独自に定義します。たとえば、コードの修正とチェックインは完了しているが、製品ビルドでの修正が未確認のバグについては、バグ・データベースで使用するタグを設定できます。該当する作業アイテムの問題の修正をチェックインする度に、このプライベート・タグを使用して、適切な作業アイテム(この例ではバグ追跡データベースのエントリ)にタグを設定できます。

様々な作業アイテムにタグを付けた後は、特定のタグで識別された作業アイテムのリストを戻すことができます。ここで説明されているように、修正はしたが未確認のアイテムにタグを作成すると、このタグを使用するすべてのアイテムについて、作業アイテム・リポジトリを問い合せることができるため、次回の製品ビルドが使用可能になった場合は、割り当てられているバグの確認が大幅に簡略化されます。

2.6.1 タグの作成、変更および削除方法

タグは、「タグの管理」ダイアログを使用して作成できます。チーム管理者には、チーム・タグまたはユーザー・タグを作成する選択肢があり、管理権限がない場合に作成できるのは、ユーザー・タグのみです。管理者も管理者以外も同様に作業アイテムにタグを適用できます。

新しいタグを作成する手順は、次のとおりです。

1. チーム・ナビゲータの「作業アイテム」アコーディオン・ツールバーから「タグ」アイコンを選択します。

2. 「タグの管理」を選択します。

3. 「タグの管理」ダイアログで、緑色の「+」ボタンをクリックします。

4. タグの名前と説明を入力します。

5. チーム管理者またはグループ管理者である場合は、このタグの可視性を選択します。

- チーム: チームのすべてのメンバーがこのタグで表示および問合せできます。(管理者のみが使用できるオプション。)

- ユーザー: 本人のみがこのタグで表示および問合せできます。

6. 「OK」をクリックします。

タグを変更する手順は、次のとおりです。

アクセス権があるタグを変更し、タグの名前、説明および(十分な権限がある場合は)可視性の範囲を変更できます。

1. チーム・プロダクティビティ・センターの「作業アイテム」アコーディオンを検索します。

2. 「タグ」アイコンをクリックし、「タグの管理」を選択します。

3. 「タグの管理」ダイアログで、変更するタグを選択します。

4. 変更するフィールドをダブルクリックし、必要な変更を実行します。

5. 「OK」をクリックします。

タグを削除するには、次のようにします。

1. チーム・プロダクティビティ・センターの「作業アイテム」アコーディオンを検索します。

2. 「タグ」アイコンをクリックし、「タグの管理」を選択します。

3. 「タグの管理」ダイアログで、削除するタグを選択します。

4. 赤色の「X」をクリックし、選択したタグを削除します。

5. 「はい」をクリックして削除を確認します。

2.6.2 タグの使用方法

作業アイテム・アーティファクトには、既存のキーワードを使用してタグを設定できます。たとえば、プロジェクト・マネージャは、開発中の製品のバグに「ホット」、「ウォーム」、「EOD」(日末)または「遅延可能」のタグを設定できます。

注意:

これらのタグ名は単なる例です。ユーザーとユーザーのチームは、タスクと作業スタイルに最も適したタグ命名スキームを考案できます。

さらに、他の作業アイテムのアーティファクトに同じ語句のタグを設定することもできます。たとえば、Jira機能に「ホット」タグを設定したとします。この場合は、「ホット」タグの作業アイテムのリストを参照すると、バグと機能リクエストの両方が表示されます。

タグは、作業アイテムに適用して使用します。

タグを作業アイテムに適用する手順は、次のとおりです。

1. タグを付ける作業アイテムが格納されているリポジトリ(たとえば、バグ・データベース)を開きます。

2. タグを付ける作業アイテムをダブルクリックし、「タグ」タブを選択します。

3. 緑色の「+」アイコンをクリックしてタグを追加します。「タグの適用」ダイアログが開きます。

4. この作業アイテムに適用するタグを選択し、「OK」をクリックします。

作業アイテムにタグを適用した後は、適用したタグに基づいて作業アイテムを表示できます。

適用するタグが「タグの適用」ダイアログにない場合は、「タグの管理」をクリックして「タグの管理」ダイアログを開き、新しいタグを作成します。第2.6.1項「タグの作成、変更および削除方法」を参照してください。

特定のタグに関連付けられている作業アイテムを表示する手順は、次のとおりです。

1. チーム・ナビゲータの「作業アイテム」アコーディオン・ツールバーから「タグ」アイコンを選択します。

2. 「マイ・タグによる問合せ」を選択してプライベート・タグを選択するか、「チーム・タグによる問合せ」を選択してチーム・タグを選択します。

3. ドロップダウン・リストからタグ名を選択します。

JDeveloperのウィンドウが開き、タグが選択した名前と一致するアイテムが表示されます。このウィンドウには、タグが付いた作業アイテムのリポジトリ間での検索結果が表示され、原則的には、問合せ対象にユーザーまたは別のチーム・メンバー(チーム・タグの場合)がタグを割り当てたすべての作業アイテムが戻ります。単一のリポジトリのみを対象として、タグが付いたアイテムのリストを取得するには、リポジトリを右クリックします。

特定のリポジトリのタグ付き作業アイテムを検索する手順は、次のとおりです。

- 検索するリポジトリでマウスの右ボタンをクリックします。ポップアップ・メニューに次のオプションが表示されます。

表2-3 タグ付き作業アイテムの検索時のオプション

オプション

説明

IDによる問合せ

このリポジトリを参照し、検索対象の単一のIDを持つ作業アイテムを戻します。問合せにより、指定の作業アイテムが戻ります。その作業アイテムに関連付けられているタグを表示するには、作業アイテム表示の「タグ」タブをクリックします。

マイ・タグによる問合せ

問合せに使用するタグを選択できるタグのリストを表示します。

チーム・タグによる問合せ

問合せに使用するタグを選択できるチーム・タグのリストを表示します。

新規問合せ

JDeveloperに「新規問合せ」ペインを開きます。第2.5.1項「問合せの作成方法」を参照してください。

新規<作業アイテム>

選択したリポジトリに関連付けられているタイプの新規作業アイテムを作成できるJDeveloperのペインを開きます。たとえば、「タスク」リポジトリの場合、このメニュー選択は「新規タスク」と表示されます。特定のリポジトリに関する詳細情報を取得するには、「新規作業アイテム」ペインのいずれかのフィールド内で[F1]を押します。

リフレッシュ

「作業アイテム」アコーディオンで選択したリポジトリの表示を更新します。

2.7 関連の使用

関連は、同じリポジトリまたは異なるリポジトリにある作業アイテム間の関係です。これは、2つの作業アイテムを関係付ける手段を提供します。現在の作業アイテムに関連する作業アイテムにナビゲートし、さらに、作業アイテムに関連する要素から作業アイテムにナビゲートできます。

関連は複数のリポジトリにまたがるため、たとえば、欠陥追跡システムとカスタマ・リクエスト・データベースの間に関連を作成できます。関連は、2つのリポジトリの作業アイテムが相互に参照することを意味し、これにより、欠陥追跡エントリを表示しているチーム・メンバーは、カスタマ・リクエストも調査できます。

関連はチーム全体にまたがります。たとえば、Atlassian Jira機能リクエストを追跡するリポジトリには、バグとアイテム間の関連を作成できます。関連を作成した後は、該当するバグを開くチームの誰もがJira作業アイテムとの関連を確認するようになります。ただし、コネクタにJiraリポジトリがないチーム・メンバーは、その作業アイテムを開けません。

2.7.1 作業アイテムへの関連の追加方法

関連を作業アイテムに追加するには、「作業アイテム関連の追加」ダイアログを使用します。このダイアログには作業アイテムのリストが表示され、選択した作業アイテムとの関連を作成する作業アイテムを選択できます。

関連を作業アイテムに追加する手順は、次のとおりです。

1. 関連を追加する作業アイテムを選択します。

2. 「追加」ドロップダウン(緑色の「+」)をクリックします。これによって、作業アイテム関連のポップアップ・メニューが表示され、ここで、追加する関連に使用可能な作業アイテムのソートおよび表示方法を決定できます。第2.7.3項「関連と作業アイテムとの関連付け方法」を参照してください。

3. ポップアップ・メニューからオプションを選択します。「作業アイテム関連の追加」ダイアログが表示されます。

4. 選択したアイテムとの関連を作成する1つまたは複数の作業アイテムをクリックし、「OK」をクリックします。

2.7.2 関連の削除方法

「作業アイテム」ツールバーの「削除」ボタン(赤色の「X」)で、作業アイテムから関連を削除します。

作業アイテムから関連を削除する手順は、次のとおりです。

1. リポジトリから作業アイテムを選択します。

2. 「関連」タブをクリックします。

3. 削除する関連を選択し、「削除」(赤色の「X」)をクリックします。

4. 「作業アイテムからのタグの削除」ダイアログに確認メッセージが表示された場合は、「はい」をクリックします。

関連が削除されます。

関連による参照がある作業アイテムは変更されません。この作業アイテムを使用すると、必要に応じて他の関連を追加できます。

2.7.3 関連と作業アイテムとの関連付け方法

関連を作業アイテムに追加すると、「作成」ボタン(緑色の「+」)では、ポップアップ・メニューが表示され、関連に対して他の作業アイテムをソート、表示および選択する方法を選択できます。このポップアップ・メニューには、次の選択肢があります。

マイ・タグ別

ユーザー・タグのリストを表示します。リストからタグを選択すると、選択したユーザー・タグが付いたすべての作業アイテムが「作業アイテム関連の追加」に表示されます。

タグが設定されているこれらの作業アイテムの1つを関連に対して選択するには、「作業アイテム関連の追加」で作業アイテムをクリックし、「OK」をクリックします。

タグが設定されている作業アイテムを複数選択するには、[Ctrl]キーを押しながら追加の作業アイテムをクリックします([Ctrl]+クリック)。

チーム・タグ別

使用可能なチーム・タグのリストを表示します。リストからタグを選択すると、選択したチーム・タグが付いたすべての作業アイテムが「作業アイテム関連の追加」に表示されます。

タグが設定されているこれらの作業アイテムの1つを関連に対して選択するには、「作業アイテム関連の追加」で作業アイテムをクリックし、「OK」をクリックします。

タグが設定されている作業アイテムを複数選択するには、[Ctrl]キーを押しながら追加の作業アイテムをクリックします([Ctrl]+クリック)。

開いている作業アイテム別

JDeveloperに現在開いている作業アイテムすべてのリストを表示します。関連に使用するために、開いているこれらの作業アイテムの1つを選択するには、「作業アイテム関連の追加」で作業アイテムをクリックし、「OK」をクリックします。

開いている作業アイテムを複数選択するには、[Ctrl]キーを押しながら追加の作業アイテムをクリックします([Ctrl]+クリック)。

アクティブな作業アイテム別

選択した作業アイテムとアクティブな作業アイテムとの間に関連を作成します。第2.2.3項「アクティブな作業アイテムの設定方法および表示方法」を参照してください。

選択した作業アイテムがアクティブな作業アイテムである場合、このメニュー・オプションは使用できません。

3 Oracleチーム・プロダクティビティ・センターの管理の使用

この章では、Oracleチーム・プロダクティビティ・センターでのユーザー、チームおよびリポジトリの管理方法について説明します。

この章には、次の項があります。

- 第3.1項「Oracleチーム・プロダクティビティ・センターの管理の使用について」

- 第3.2項「Oracleチーム・プロダクティビティ・センターへのリポジトリの追加」

- 第3.3項「Oracleチーム・プロダクティビティ・センターでのリポジトリの有効化」

- 第3.4項「ユーザー、チームおよびロールの使用」

3.1 Oracleチーム・プロダクティビティ・センターの管理の使用について

Oracleチーム・プロダクティビティ・センターでは、一定の管理が初期設定時に、および継続的にも必要です。Oracleチーム・プロダクティビティ・センターの管理は、リポジトリ、ユーザー、チームおよびロールの4つの領域に関する管理で構成されています。

リポジトリには、製品の問題、機能およびその他の要素をそのライフサイクル全体で追跡、管理およびフォローアップするためにチームが使用する情報が格納されます。Oracleチーム・プロダクティビティ・センターに追加したリポジトリは、チーム・メンバーが使用できるようにする必要があります。チーム・メンバーがこれらのリポジトリの情報にアクセスして相互作用できる方法は、リポジトリとその情報の性質(バグ追跡データベースやタスク・リポジトリなど)と、各個人ユーザーまたはそのユーザーが属するチームに割り当てられている権限の2つの状況によって決まります。

新しいユーザーを追加した場合は、そのユーザーにチーム・プロダクティビティ・センターの様々なコンテンツ要素を変更できる権限を割り当てたり、そのユーザーを1つ以上のチームに割り当てます。チームに割り当てられたユーザーは、チーム・プロダクティビティ・センターのコンテンツの様々な側面を変更する機能をまとめてグループ化したメカニズムであるロールを取得します。個々のロールは、個人単位で変更することも、組織のニーズを処理する特定の権限が付与された新しいロールを作成して変更することもできます。

3.1.1 リポジトリ、ユーザーおよびチームの理解

組織で使用するリポジトリを管理することによって、製品のライフサイクルを通じて使用する機能、バグ、進行状況およびその他の追跡メカニズムのレコードに、ユーザーおよびチームがアクセスできるようになります。これらのリポジトリには、開発時に個々の問題を追跡する作業アイテムが格納されます。

Oracleチーム・プロダクティビティ・センターでリポジトリを使用できるようにするには、最初にネットワーク上のリポジトリにアクセスできる必要があり、次にそのリポジトリとユーザーをリンクするOracleチーム・プロダクティビティ・センター・コネクタをインストールする必要があります。

リポジトリへのコネクタのインストールの詳細は、『Oracle Fusion Middleware Oracle Team Productivity Center Serverインストレーション・ガイド』を参照してください。

管理者は通常、次のタスクを実行します。

- ユーザーおよびチームが作業アイテムにアクセスできるように、リポジトリをチーム・プロダクティビティ・センターに接続します。詳細は、第3.2項「Oracleチーム・プロダクティビティ・センターへのリポジトリの追加」を参照してください。

- チームおよびユーザーへのリポジトリ(Subversionなどのソース管理ソフトウェアで使用するバージョニング・リポジトリを含む)の割当て。詳細は、第3.3項「Oracleチーム・プロダクティビティ・センターでのリポジトリの有効化」を参照してください。

- 製品の成熟度に従ってユーザーを作成し、チームを管理します。詳細は、第3.4項「ユーザー、チームおよびロールの使用」を参照してください。

- ユーザーおよびチームに割り当てたロールを管理し、適切なチーム・メンバーに、アクセスするリポジトリの適切な要素を変更する機能が付与されていることを確認します。詳細は、第3.4項「ユーザー、チームおよびロールの使用」を参照してください。

これらのタスクにはおおまかな順序がありますが(つまり、リポジトリを追加し、有効にしてから、それらのリポジトリにユーザーおよびチームを割り当てる必要があるなど)、多くの場合、製品の成熟度やチーム・メンバーシップ変更に従って、様々な時期にこれらのタスクに戻って作業を実行します。

3.1.2 ユーザー権限の理解

チーム・プロダクティビティ・センターでは、権限によって、新しいユーザーやチームの作成に対する制御を定義します。各ユーザーには様々な権限を付与でき、そのユーザーが属するチームに関係なく適用されます。各権限は次のとおりです。

- 新規チームの作成: この権限が付与されたユーザーは、新しいチームを作成できます。ユーザーは自分自身も新しいチームのメンバーとして追加しないと、この管理ダイアログを終了した後、作成したチームを編集できなくなります。

- ユーザー・アカウントの作成: このユーザーは、新しいユーザー・アカウントを作成できます。この新しいユーザー・アカウントは、この管理ダイアログを終了した後は編集できません。それ以降もユーザーを編集できるのは管理者のみです。

- 管理者: 「管理者」権限のあるユーザーは、チーム・プロダクティビティ・センターのすべての機能を使用できます。ユーザーの編集、リポジトリの追加/編集およびチーム・メンバーのロールの変更を実行できるのは管理者のみです。

3.1.3 ユーザー・ロールの理解

ロールは、作業アイテム、問合せ、タグ、ドキュメントなどのチーム・プロダクティビティ・センターの要素を変更する権限をユーザーに付与するために、チーム・プロダクティビティ・センターで使用するメカニズムです。すべてのユーザーには、デフォルトで定義されているロールまたは管理者が定義したロールがあり、各ユーザーのロールには、そのユーザーに付与される機能と権限が定義されています。デフォルトでは、チーム・プロダクティビティ・センターには、次の3つのロールが含まれています。

- 「チーム・メンバー」は、作業アイテムにアクセスして編集したり、各自が使用する問合せ、タグおよびドキュメントを作成して管理することもできます。

- 「チーム管理者」にもこれらの権限がありますが、さらにチームのメンバーすべてが使用する問合せ、タグ、ドキュメントおよびソースを作成して管理できます。

- 「グループ管理者」にもこれらすべての権限がありますが、チームとそのチーム内に含まれる子チームの問合せ、タグ、ドキュメントおよびソースを作成して管理することもできます。

管理者は、これらのデフォルトのロールおよび権限を受け入れることも、ロールごとに選択されている権限を変更して調整することもできます。また、管理者は、「チーム管理」ダイアログの「ロール」タブにある使用可能なリストから権限を選択して、様々な組合せで新しいロールを作成することもできます。

3.2 Oracleチーム・プロダクティビティ・センターへのリポジトリの追加

チーム・プロダクティビティ・センターへのリポジトリの追加は通常、リポジトリごとに1度のみですが、重要な管理タスクです。リポジトリの追加によって、チーム・メンバーは、特定のリポジトリのアーティファクトである作業アイテムにアクセスできるようになります。チーム管理者はリポジトリをチーム・プロダクティビティ・センターのチームの実装に追加し、個々のチーム・メンバーは製品開発ライフサイクルの一環として作業アイテムを確認、追跡および編集するときにこれらのリポジトリにアクセスします。

リポジトリを追加する際の重要な前提条件の1つとして、ユーザー(任意のチーム・プロダクティビティ・センター管理者)はそのリポジトリに対するコネクタをチーム・プロダクティビティ・センター・サーバーにインストールしておく必要があります。コネクタは、Oracle Technology Networkからダウンロードして入手できるチーム・プロダクティビティ・センターのインストール・ツールを使用してインストールします。これは、チーム・プロダクティビティ・センター・ユーザーが「ヘルプ」→「更新の確認」からダウンロードするコネクタ拡張機能とは異なることに注意してください。該当するコネクタがチーム・プロダクティビティ・センターのインストール・ツールを使用してリポジトリにJDeveloper拡張機能としてインストールされている場合、ユーザー(任意の管理者)はそのリポジトリをチーム・プロダクティビティ・センターに追加するのみで済みます。

リポジトリへのコネクタのインストールの詳細は、『Oracle Fusion Middleware Oracle Team Productivity Center Serverインストレーション・ガイド』を参照してください。

3.2.1 リポジトリの追加方法

リポジトリを追加する前に、サーバー名やURL、ポート番号、認証資格証明(名前やパスワードなど)、追加するリポジトリへの接続に必要な他のデータなど、必要なすべての接続情報があることを確認してください。

チーム・プロダクティビティ・センターにリポジトリを追加する手順は、次のとおりです。

1. 「チーム・ナビゲータ・メニュー」→「チーム管理」→「リポジトリ」タブの順に選択します。

2. 「リポジトリ・サーバー」領域で、緑色の「+」アイコンをクリックします。

3. 「コネクタ」ドロップダウンから、追加するリポジトリに対して適切なコネクタを選択します。選択できるコネクタは、インストールしたコネクタによって異なります。

4. 名前と説明を入力します。これは、特定のチームで使用可能なリポジトリのリストに表示される名前です。

5. リポジトリ・サーバーのフィールドに、リポジトリのローカルの別名と説明を入力します。

6. 名前/値ペアのセットであるリポジトリ・パラメータを入力します。これらは、リポジトリにアクセスするためにコネクタで必要なデータによって異なります。Atlassian JIRA ®などの一部のコネクタでは、「名前」フィールドはサーバーURLで、「値」フィールドは、このリポジトリを提供するJIRAサーバーのURLである必要があります。他のコネクタでは、追加の名前の入力が必要になる場合があります。このリポジトリの追加時に入力する必要がある特定のデータの詳細は、コネクタ作成者に問い合せるか、コネクタのオンライン・ヘルプを確認してください。いずれの場合も、コネクタがインストールされるとパラメータ名が指定されるため、管理者が入力する必要があるのは、名前のパラメータに対する値のみです。

新しく作成したリポジトリをチームで使用できるようにするには、そのリポジトリをチームに割り当てる必要があることにも注意してください。詳細は、第3.3項「Oracleチーム・プロダクティビティ・センターでのリポジトリの有効化」を参照してください。

3.2.2 リポジトリの削除方法

リポジトリを削除する前に、今後のある時点でシステムにそのリポジトリを再度追加することが必要になることに備えて、様々なURLとそれに関連付けられているパラメータを書き留めてください。

チームが使用しているリポジトリは削除できないことに注意してください。これによって、チームのリポジトリとの関連付けの削除が防止されます。

リポジトリを削除する手順は、次のとおりです。

1. 「チーム・ナビゲータ・メニュー」→「チーム管理」→「リポジトリ」の順に選択します。

2. 削除するリポジトリをクリックします。

3. 赤色の「X」ボタンをクリックします。

リポジトリとその関連付けがチームから削除されます。

3.3 Oracleチーム・プロダクティビティ・センターでのリポジトリの有効化

追加したリポジトリは、Oracleチーム・プロダクティビティ・センターのユーザーとチームが使用できるようにする必要があります。これによって、追加したリポジトリの作業アイテムにチームとユーザーがアクセスできるようになります。さらに、バージョニング・リポジトリを作成すると、Oracleチーム・プロダクティビティ・センターの「リポジトリ」タブを介して選択したソース管理システムにすばやくアクセスする方法をチーム・メンバーに提供できます。

3.3.1 チーム・プロダクティビティ・センターのリポジトリのアクセス方法および選択方法

Oracleチーム・プロダクティビティ・センターは、JDeveloperユーザーを外部リポジトリにリンクします。これらのリポジトリには、欠陥追跡データベース、カスタマ・リクエスト・ツール、およびバージョニング・システムなどのその他のデータのコレクションが含まれている場合があります。

管理者は、チーム・プロダクティビティ・センターにリポジトリを追加できます。そのためには、特定のリポジトリに対するOracleチーム・プロダクティビティ・センター・コネクタをOracleチーム・プロダクティビティ・センターのサーバーに事前にインストールしておく必要があります。詳細は、『Oracle Fusion Middleware Oracle Team Productivity Center Serverインストレーション・ガイド』を参照してください。

リポジトリに関連する管理タスクは通常、「チーム管理」ダイアログから開始します。

「チーム管理」ダイアログの「リポジトリ」タブにアクセスする手順は、次のとおりです。

- 「チーム・ナビゲータ」→「チーム管理」→「リポジトリ」

「チーム管理」ダイアログを使用すると、インストールされているコネクタに基づいてリポジトリを追加、削除および変更できます。チームが世界中に分散しているのが通常の状況では、同じリポジトリを指し示す異なるサーバーを追加すると便利な場合があります。組織の複数のブランチにローカル・サーバーを追加することで、組織のパフォーマンスおよび効率を上げることができます。

チーム管理者がリポジトリを設定した後、管理権限のあるユーザーは、チームが使用するリポジトリを選択できます。

チームが使用するリポジトリを選択する手順は、次のとおりです。

- 「チーム・ナビゲータ」→「チーム管理」→「チーム」→「チーム・リポジトリ」

さらに、チーム・プロダクティビティ・センター・ユーザーは、チームが使用するリポジトリに対するコネクタをダウンロードしていることを確認する必要があります。これらは、「ヘルプ」→「更新の確認」からダウンロードできます。

チーム管理者は、インストールされているコネクタに基づいてリポジトリを追加できます。チームが世界中に分散しているのが通常の状況では、同じリポジトリを指し示す異なるサーバーを追加すると便利な場合があります。組織の複数のブランチにローカル・サーバーを追加することで、組織のパフォーマンスおよび効率を上げることができます。

リポジトリに関連するほとんどの管理タスクは、「チーム管理」ダイアログから開始します。このダイアログにアクセスするには、「チーム・ナビゲータ」→「チーム管理」→「リポジトリ」の順に選択します。「チーム管理」ダイアログを使用すると、リポジトリを追加、削除および変更できます。

3.3.2 「チーム管理」ダイアログでのリポジトリの検索方法

多数のリポジトリが存在する場合は、「チーム管理」メニューのクイック・フィルタ機能を使用して表示されるリポジトリを絞り込むことで、適切なリポジトリをすばやく簡単に識別できます。

クイック・フィルタ機能を使用してリポジトリを検索する手順は、次のとおりです。

1. 「チーム管理」ダイアログの「リポジトリ」タブをクリックします。

2. 「リポジトリ」列の上部にある「フィルタ」フィールドに、リポジトリの名前の最初の数文字を入力します。
JDeveloperによって、入力した文字を名前に含むすべてのリポジトリがリスト表示されます。

各文字を入力するたびに、フィルタによってプログレッシブに検索されます。フィルタでは大/小文字が区別されないため、小文字で入力でき、JDeveloperでは大/小文字に関係なくリポジトリ名が表示されます。

3.3.3 リポジトリの割当て方法

リポジトリを割り当てるには、インストールされているコネクタに基づいて使用可能なリポジトリのリストからリポジトリを選択します。チーム管理者はリポジトリをチーム・プロダクティビティ・センターのチームの実装に追加し、個々のチーム・メンバーは製品開発ライフサイクルの一環として作業アイテムを確認、追跡および変更するときにこれらのリポジトリにアクセスします。

このチームがアクセスできるリポジトリを決定する手順は、次のとおりです。

- 「チーム・ナビゲータ」→「チーム管理」→「チーム」→「チーム・リポジトリ」タブ

これによって、チーム・プロダクティビティ・センターのインストールで使用可能なすべてのリポジトリのリストが表示されます。一部のリポジトリでは、パラメータ(URLやポート番号など)の入力が必要になる場合があります。

チームによるリポジトリのアクセスを有効または無効にする手順は、次のとおりです。

1. 新しいチームがリポジトリにアクセスできるようにするには、各リポジトリの横にあるボックスを選択します。

2. チームがリポジトリにアクセスできないようにするには、選択を解除します。

3. すべてのボックスを設定または設定解除するには、最も上にあるボックス(「名前」フィールドの横)をクリックします。

3.3.4 バージョニング・リポジトリの作成方法および使用方法

バージョニング・リポジトリを作成すると、「リポジトリ」タブを介してバージョニング・システムにすばやく移動する方法がチームに提供されます。

バージョニング・リポジトリを作成する手順は、次のとおりです。

1. 「チーム管理」→「リポジトリ」の順に選択します。

2. 緑色の「+」記号をクリックして、新しいリポジトリを作成します。

注意:

特定のバージョン・コントロール・システムに対する既存リポジトリが存在しないことを確認するために、「リポジトリ」ノードの横にある「+」記号をクリックします。これによって、Oracleチーム・プロダクティビティ・センターで現在使用できる、使用可能バージョン・コントロール・リポジトリのリストが表示されます。同じバージョン・コントロール・システムに新しいリポジトリを作成する必要がある場合は、リポジトリに新しい名前を指定できます。

3. 「コネクタ」ドロップダウンをクリックし、該当のバージョン・コントロール・システムに対するコネクタを選択します。

4. 「名前」フィールドに、作成するリポジトリの名前を入力します。これが、すでにリポジトリがあるバージョン・コントロール・システムに対する新しいリポジトリ(プロジェクトの異なるブランチやバージョンに対するリポジトリなど)の場合は、簡単に識別できる名前にしてください。

5. 「説明」フィールドに、作成するバージョニング・リポジトリの説明を入力します。

6. 「OK」をクリックします。

バージョニング・リポジトリを作成した後は、「チーム管理」ダイアログの「チーム」タブから、そのリポジトリにアクセスできるチームを制御できます。

バージョニング・リポジトリに対するアクセス権をチームに付与する手順は、次のとおりです。

1. 「チーム管理」→「リポジトリ」→「チーム・リポジトリ」タブの順に選択します。

2. ダイアログの左ペインにあるチーム・リストをスクロールして、新しいリポジトリへのアクセス権を付与するチームを検索します。

3. ダイアログの右ペインにあるリポジトリ・リストをスクロールして、選択したチームに対して使用可能にするリポジトリを検索します。

4. 選択したチームに対してアクセス可能にするリポジトリの横にあるボックスをそれぞれ選択します。

5. 「OK」をクリックします。

各チームは個々に選択する必要がありますが、そのチームに対して適切なすべてのリポジトリは、該当するすべてのリポジトリを選択して「OK」をクリックすることにより、1回の操作で指定できます。

3.4 ユーザー、チームおよびロールの使用

管理者のジョブの主要部分はチーム・メンバーの管理に関係します。つまり、ユーザー・アカウントを保守し、ユーザーを適切なチームに保持し、すべてのユーザーに各自のジョブの実行に必要な機能が付与されていることを確認します。これは、製品の成熟度に従って新しいメンバーが製品開発グループに参加する動的環境では特に重要です。チーム・プロダクティビティ・センターの管理では、ユーザーの追加と削除、ユーザー情報の変更、およびチームの管理に対して様々な方法が提供されます。

Oracleチーム・プロダクティビティ・センターでは、ロールを使用して各チーム・メンバーの機能を定義します。管理者は、機能の一意の組合せが含まれたロールを定義し、組織のニーズに基づいて個々のメンバーにそれぞれのロールを割り当てることができます。各ロールには権限の独自の組合せがあり、これによって、Oracleチーム・プロダクティビティ・センター内の様々な要素(問合せ、タグ、ドキュメントなど)の作成および変更をチーム・メンバーに対して許可できます。

ロールの管理の詳細は、第3.4.7項「チーム・メンバー・ロールの設定方法および変更方法」を参照してください。

3.4.1 チーム・プロダクティビティ・センターのユーザー・アカウントの作成方法

Oracleチーム・プロダクティビティ・センター管理者が実行する継続的なタスクの1つは、チーム・メンバー用のアカウントを作成することです。これには、チームに参加した個人を追加することに加え、チーム・プロダクティビティ・センターの様々な機能に対するアクセス権がチーム・メンバーに適切に付与されていることを確認する作業も含まれます。

Oracleチーム・プロダクティビティ・センター管理者のタスクには次の作業が含まれ、製品ライフサイクルの開始時または開発中に、チーム・メンバーやリポジトリが追加されたときに任意の順序で実行できます。

- ユーザーの追加。チームを最初に設定したとき、または後で他のユーザーがチームに参加したときに実行できます。

- 既存ユーザーの情報の変更。連絡先情報、権限およびその他の情報が対象となる場合があります。

- チーム・メンバー・ロールの変更。チーム・メンバーには、チーム内のロールが割り当てられます。問合せの変更および他のチーム全体との相互作用に関しては、これらのロールは、チーム・メンバーに付与されている権限の中で重要な役割を果たします。

- リポジトリの管理。ユーザー・アカウントでは、チームが使用する様々なリポジトリへのアクセス権を個々のチーム・メンバーに付与するため、個々のリポジトリで必要なアカウントと権限がチーム・メンバーに付与されていることを確認するなど、一部のリポジトリ情報の管理を求められる場合もあります。

3.4.2 チーム・プロダクティビティ・センターへのユーザーの追加方法

通常の本番環境では、チームは製品の成熟度に従って増大し、発展します。Oracleチーム・プロダクティビティ・センター管理者は、チーム・プロダクティビティ・センターの管理ダイアログを使用して新しいユーザーを追加できます。

チーム・プロダクティビティ・センターの管理ダイアログを使用して、チーム・プロダクティビティ・センターに新しいユーザーを追加する手順は、次のとおりです。

1. 「チーム・ナビゲータ」メニューにあるチーム・サーバー管理のアイコンをクリックして開きます。

2. 「ユーザー」タブをクリックします。

3. 緑色の「+」記号をクリックして、新しいユーザー・ダイアログを開きます。

4. パスワードの設定やステータスの「アクティブ」または「非アクティブ」への設定を含む、ユーザー登録情報を完了します。

5. 次のユーザー権限オプションを設定します。

- 新規チームの作成: ユーザーが新しいチームを作成できるようにする場合は、このオプションを選択します。

- 新規ユーザーの作成: ユーザーが追加のユーザーをシステムに追加できるようにする場合は、このオプションを選択します。

- 管理者: このユーザーをOracleチーム・プロダクティビティ・センター管理者にする場合は、このオプションを選択します。管理者であるユーザーには、ユーザーおよびチームを作成する機能が自動的に付与されます。

6. 「OK」をクリックします。

ユーザーが「ユーザー」登録に表示されます。これは、新しいユーザーをチームに割り当てることができることも意味します。

チーム・プロダクティビティ・センターの管理ダイアログを使用して、チーム・メンバーを既存のチームに追加したり、既存のチームから削除できます。

既存のチームにチーム・メンバーを追加する手順は、次のとおりです。

1. 「チーム・ナビゲータ」メニューにあるチーム・サーバー管理のアイコンをクリックして開きます。

2. 「チーム」タブをクリックします。

3. 調整するメンバーシップのチーム名をクリックします。

4. 「チーム・メンバー」パネルに関連する緑色の「+」記号をクリックします。

5. 選択可能なユーザーからメンバーを1人以上選択します。

6. 複数のユーザーを選択するには、[Ctrl]-[Shift]キーを使用し、一定範囲のユーザーを選択するには、[Shift]キーを使用します。すべてのユーザーを選択するには、右向きの二重矢印記号を使用します。

7. チームにユーザーを追加した場合は、新しいメンバーのロールをクリックし、適切なロールを選択します。このステップは、チームでこのユーザーに付与される管理権限が決定されるため重要です。

8. 「OK」をクリックします。

既存のチームからチーム・メンバーを削除する手順は、次のとおりです。

1. 「チーム・ナビゲータ」メニューにあるチーム・サーバー管理のアイコンをクリックして開きます。

2. 「チーム」タブをクリックします。システム内のチームのリストが表示されます。

3. ユーザーを削除するチームの名前をクリックします。

4. チーム・メンバーの領域にあるユーザーの名前をクリックします。

5. 「チーム・メンバー」パネルの横にある赤色の「X」をクリックします。

ユーザーがチーム登録から削除されます。

注意:

チームからユーザーを削除するかわりに、ユーザーのステータスを「非アクティブ」に設定する方法もあります。詳細は、第3.4.4項「チーム・プロダクティビティ・センターからのユーザーの削除方法」を参照してください。

3.4.3 ユーザー情報の変更方法

管理権限が付与されている場合は、システム内のユーザーに関連する情報を変更できます。

ユーザー情報を変更する手順は、次のとおりです。

1. Oracleチーム・プロダクティビティ・センター・マストヘッドにあるチーム・サーバー管理のアイコンをクリックして開きます。

2. 「ユーザー」タブをクリックします。

3. ユーザー登録の名前をクリックします。

4. 必要に応じて、情報を変更します。

5. 「OK」をクリックします。

ヒント:

ユーザーが1つ以上のチームに割り当てられると、ユーザー構成情報の下に、そのチームが読取り専用書式でリスト表示されます。チームの割当ては、チーム管理タブを介して変更できます。

3.4.4 チーム・プロダクティビティ・センターからのユーザーの削除方法

Oracleチーム・プロダクティビティ・センターからユーザーを削除できるのは、ユーザーを追加した初期セッション中のみです。ユーザーがデータベースに追加された後は削除できなくなります。これは、ユーザーのアカウントに関連付けられているOracleチーム・プロダクティビティ・センターのユーザー情報(チーム・メンバーシップ、タグ、問合せなど)を削除できないためです。

チーム・プロダクティビティ・センターに現在は参加していないユーザーが存在する場合、解決方法は、そのユーザーのステータスを「アクティブ」から「非アクティブ」に変更することです。

ユーザーのステータスを「非アクティブ」に変更する手順は、次のとおりです。

1. 「チーム・ナビゲータ」→「チーム・ナビゲータ・メニュー」→「チーム管理」の順に選択します。

2. 「ユーザー」タブをクリックします。

3. ユーザー登録にあるユーザーの名前をクリックします。

4. 「ステータス」ドロップダウン・リストをクリックし、「非アクティブ」を選択します。

5. 「OK」をクリックします。

この手順を実行するには、管理者権限が必要です。

同じ手順を使用して、ユーザーのステータスを「アクティブ」に変更できます。「チーム管理」メニューからユーザーの名前を選択した後は、「ステータス」ドロップダウン・リストから「アクティブ」をクリックし、「OK」をクリックします。

また、アクティブまたは非アクティブのユーザーを表示する設定を変更するには、「非アクティブ・ユーザーの表示」チェック・ボックスを選択します。

非アクティブ・ユーザーを表示する手順は、次のとおりです。

- 「非アクティブ・ユーザーの表示」というラベルのチェック・ボックスをクリックします。

3.4.5 「チーム管理」ダイアログでのユーザーまたはチームの検索方法

多数のメンバーがいる大規模チームが存在する場合は、「チーム管理」メニューのクイック・フィルタ機能を使用して、個々のメンバーの検索が容易になるように検索を絞り込むことができます。

クイック・フィルタ機能を使用してユーザーを検索する手順は、次のとおりです。

1. 「チーム管理」ダイアログの「ユーザー」タブをクリックします。

2. 「ユーザー」列の上部にある「フィルタ」フィールドに、ユーザーの名前の最初の数文字を入力します。
JDeveloperによって、入力した文字を名前に含むすべてのユーザーが表示されます。

各文字を入力するたびに、フィルタによってプログレッシブに検索されます。フィルタでは大/小文字が区別されないため、小文字で入力でき、JDeveloperでは大/小文字に関係なくユーザー名が表示されます。クイック・フィルタでは、チーム全体のリストの検索も機能します。

クイック・フィルタ機能を使用してチームを検索する手順は、次のとおりです。

1. 「チーム管理」ダイアログの「チーム」タブをクリックします。

2. 「チーム」列の上部にある「フィルタ」フィールドに、チームの名前の最初の数文字を入力します。
JDeveloperによって、入力した文字から名前が始まるすべてのチームが表示されます。

ユーザーのフィルタと同様に、チームのフィルタはプログレッシブです。たとえば、T、EおよびSの文字を入力すると、名前に「Test」という語を含むすべてのチームのリストが表示されます。

フィルタでは大/小文字が区別されず、「Test」の例では、JDeveloperによって、名前にTEST、Testおよびtestという語を含むチームが返されます。

3.4.6 Oracleチーム・プロダクティビティ・センターに対するチームの追加方法および削除方法

チーム・プロダクティビティ・センターでは、ユーザーをグループ化してチームおよびサブチームに自由に配置し、各チームのメンバーを事前定義のロールのいずれかに割り当てたり、作業環境で必要な場合は新しいロールを作成して割り当てることもできます。

Oracleチーム・プロダクティビティ・センターからチームを削除できるのは、チームを追加した初期セッション中のみです。チームがデータベースに追加された後は削除できなくなります。

管理権限が付与されている場合は、チーム・プロダクティビティ・センターの管理ダイアログを使用してチームを追加できます。Oracleチーム・プロダクティビティ・センター管理者は、チーム階層を調整できます。チーム管理者は、作成したチームを含むチーム管理ロールが割り当てられているチームに制限されます。グループ管理者は、その管理者が属するチーム、およびそのグループ管理者のチームの子チームを変更できます。

ヒント:

チーム登録は別のチーム名の下位で重複できますが、チームを複数の親チームに含めることはできません。

Oracleチーム・プロダクティビティ・センターにチームを追加する手順は、次のとおりです。

1. 「チーム・ナビゲータ・メニュー」→「チーム管理」の順に選択します。

2. 「チーム」タブをクリックします。チームおよびサブチーム(存在する場合)のリストが表示されます。

3. チーム名をクリックします。階層内の最上位エントリを選択すると、そのチームが最上位レベルのチームになります。それ以外の場合は、既存チームの名前をクリックし、新しいチームをその子として作成します。(作成したチームのチーム階層内での場所は簡単に調整できます。)

4. 緑色の「+」記号をクリックします。「無題」というチームが表示されます。

5. 次の情報を入力します。

- チーム名。(システム内の他のチームのネーミング・スタイルと一貫性のある名前を使用してください。)

- 親。作成するチームが既存チームのサブチームである場合は、親を選択します。それ以外の場合は、空白のオプションを選択して、システム内の主要チームのピアであるチームを作成します。

- ステータス(アクティブまたは非アクティブ)。

- オプションの説明。

6. 「OK」をクリックして、チームを作成します。

チームにメンバーを追加すると、そのメンバーの名前が「チーム・メンバー」パネルに表示されます。チームにチーム・メンバーを追加する際は、各チーム・メンバーのロールを必ず選択してください。

Oracleチーム・プロダクティビティ・センターのチームは、そのアカウントに関連付けられているデータ(チーム・メンバー、タグ、問合せなど)があるため、削除できません。Oracleチーム・プロダクティビティ・センターに現在は参加していないチームが存在する場合、解決方法は、そのチームのステータスを「アクティブ」から「非アクティブ」に変更することです。

チームを非アクティブにする手順は、次のとおりです。

1. 「チーム・ナビゲータ・メニュー」→「チーム管理」の順に選択します。

2. 「ステータス」ドロップダウン・リストをクリックし、「非アクティブ」を選択します。

3. 「OK」をクリックします。

非アクティブ・チームを表示する手順は、次のとおりです。

- 「非アクティブ・チームの表示」というラベルのボックスをクリックします。

3.4.7 チーム・メンバー・ロールの設定方法および変更方法

ロールは、チームの作業環境内で様々な要素(作業アイテム、問合せ、タグおよびドキュメント)を作成および変更するユーザーの権限を管理するために、Oracleチーム・プロダクティビティ・センターで使用するメカニズムです。Oracleチーム・プロダクティビティ・センターにはデフォルトのロールがありますが、管理者は、表3-1にリストされている権限から選択して、新しいロールを作成および定義することもできます。

Oracleチーム・プロダクティビティ・センターで提供される3つのロールは、次のとおりです。

- チーム・メンバー(すべてのユーザーのデフォルト)。「チーム・メンバー」は、作業アイテムにアクセスして編集したり、各自が使用する問合せ、タグおよびドキュメントを作成して管理することもできます。

- チーム管理者。「チーム管理者」には、「チーム・メンバー」のすべての権限がありますが、さらにチームのメンバーすべてが使用する問合せ、タグ、ドキュメントおよびソースを作成して管理できます。

- グループ管理者。「グループ管理者」には、「チーム・メンバー」および「チーム管理者」のすべての権限がありますが、チームとそのチーム内に含まれる子チームの問合せ、タグ、ドキュメントおよびソースを作成して管理することもできます。

Oracleチーム・プロダクティビティ・センターに含まれるこれらのロールに加えて、管理者は、使用可能な権限の組合せが含まれた新しいロールを作成できます。これによって、チーム・メンバーが必要な機能、権限および職責と一致する特定のロールを作成する柔軟性が提供されます。

表3-1に、新しいロールの作成時に使用できる権限を示します。

表3-1 ロールの作成で使用可能な権限

権限

説明

チームの管理

担当チームに関するすべての管理職務を実行します。デフォルトでは、「チーム管理者」ロールと「グループ管理者」ロールに対して使用できます。

チーム問合せの管理

担当チームのすべてのメンバーが使用するデータ・リポジトリに対する問合せを作成、管理および削除します。デフォルトでは、「チーム管理者」ロールと「グループ管理者」ロールに対して使用できます。

チーム・タグの管理

担当チームのメンバーが使用するタグを作成、管理および削除します。デフォルトでは、「チーム管理者」ロールと「グループ管理者」ロールに対して使用できます。

チーム・ドキュメントの管理

担当チームのメンバーが使用するドキュメントを作成、管理および削除します。デフォルトでは、「チーム管理者」ロールと「グループ管理者」ロールに対して使用できます。

チーム・ソースの管理

担当チームのメンバーが使用するソースを作成、管理および削除します。デフォルトでは、「チーム管理者」ロールと「グループ管理者」ロールに対して使用できます。

子チームの権限を取得

この権限が含まれるロールが割り当てられているユーザーには、階層内で現在のチームの下位にあるすべてのチームに対して、ユーザーがそれらのチームの明示的なメンバーかどうかに関係なく、同じロールが付与されます。この権限は、特定のユーザーが、階層内のすべてのチームをすべてのチームのメンバーでなくても管理できるようにすることを目的としています。

チーム・プロダクティビティ・センター管理者は、これら3つのロール間での権限の割当てを変更し、必要に応じて、様々な権限を混在した新しいロールを作成することもできます。

新しいロールを作成するには:

1. 「チーム・ナビゲータ・メニュー」→「チーム管理」の順に選択します。

2. 「ロール」タブをクリックし、次に緑色のプラス記号をクリックします。これによって、新しいロールが作成されます。

3. 作成する新しいロールの名前と説明を入力します。

4. 新しいロールに関連付ける権限の組合せを選択し、「OK」をクリックします。

作成した新しいロールは、割り当てるチーム・メンバーのユーザー設定を変更することで、個々に割り当てることができます。詳細は、第3.4.3項「ユーザー情報の変更方法」を参照してください。

新しいロール(後でユーザーがチームに参加したときにそのユーザーに割り当てることができるロール)の作成に加えて、チームの任意のメンバーのロールをデフォルトのロールまたは作成した新しいロールから選択して変更することもできます。

チーム・メンバーのロールを変更する手順は、次のとおりです。

1. 「チーム・ナビゲータ・メニュー」→「チーム管理」の順に選択します。

2. 「チーム」タブをクリックします。システム内のチームのリストが表示されます。

3. ロールを変更する1ユーザーまたは複数のユーザーを含むチームの名前をクリックします。

4. ユーザーの名前をクリックします。

5. ユーザーの現在のロールをクリックして、ドロップダウン・リストから新しいロールを選択し、「OK」をクリックします。

チーム・メンバーのロールは、いつでも変更できます。変更すると、そのメンバーには、管理者が割り当てた新しいロールの機能が付与されます。

4 Oracleチーム・プロダクティビティ・センター・コネクタの使用

この章では、Oracleチーム・プロダクティビティ・センターと外部データ・リポジトリ(バグ・データベース、機能追跡システム、およびチームで開発に使用するデータのその他のリポジトリなど)間のコネクタを開発する方法について説明します。また、Oracleチーム・プロダクティビティ・センター・コネクタを作成した後の使用方法についても説明します。これには、エラー処理、ヘルプの追加、配布用のコネクタのパッケージ化および国際化があります。

Oracleチーム・プロダクティビティ・センター・コネクタでは、サードパーティ・リポジトリをJDeveloperと統合するためのフレームワークが提供されます。標準の作業アイテム・インタフェースを使用して、サードパーティ・コネクタでそのバックエンド・リポジトリからデータをフェッチし、そのデータを標準書式で表示できます。宣言ユーザー・インタフェース・アプローチによって、コネクタ作成者は、大量のコードを作成することなく、多数の柔軟な方法でUIコントロールを自由にレイアウトできます。この結果、JDeveloperではデータとUI要素が実行時に結合され、JDeveloperユーザーがすでに理解している一貫性のある方法でリポジトリ・オブジェクトが表示されます。

この章には、次の項があります。

- 第4.1項「Oracleチーム・プロダクティビティ・センター・コネクタの使用について」

- 第4.2項「Oracleチーム・プロダクティビティ・センター・コネクタの作成」

- 第4.3項「Oracleチーム・プロダクティビティ・センター・コネクタ・エラーの処理」

- 第4.4項「Oracleチーム・プロダクティビティ・センター・コネクタへのヘルプの追加」

- 第4.5項「コネクタのパッケージ化」

- 第4.6項「チーム・プロダクティビティ・センター・コネクタの国際化」

4.1 Oracleチーム・プロダクティビティ・センター・コネクタの使用について

チーム・プロダクティビティ・センターに対する独自のコネクタの開発は、コネクタのアーキテクチャを理解することから開始します。Oracleチーム・プロダクティビティ・センター・コネクタのアーキテクチャは、3つの主要機能を提供するように編成されています。

- コネクタによって処理される作業アイテム・リポジトリからのデータ・フェッチ

- チーム・プロダクティビティ・センター・クライアント内でのランタイムUIコンポーネント・ツリーの生成

- リポジトリ・データをUIコンポーネントに結合する作業アイテム・エディタでのUIコントロールとデータの表示

4.1.1 リポジトリからのデータのフェッチ

各作業アイテム・コネクタによってWorkitemConnectorインタフェースが実装され、このコネクタで使用されるリポジトリで添付ファイルがサポートされている場合は、オプションでWorkitemAttachmentインタフェースが実装されます。WorkitemConnectorインタフェースでは、エンド・ユーザーによるリポジトリへのログインとリポジトリからのログ・アウト、作業アイテムに対する基本的な作成、読取り、更新および削除(CRUD)操作、および問合せ結果の取得のためのメソッドが指定されます。バックエンド・リポジトリの機能に基づいて、コネクタ作成者は、バックエンド・リポジトリの機能を公開するために実装するWorkitemConnectorのメソッドを決定します。これらの選択したメソッドの実装時に、コネクタ作成者は、バックエンド・リポジトリから使用できる適切なAPI(またはWebサービス)を使用します。データは、APIを介して収集した後、コネクタ作成者が定義する作業アイテム・データ構造に変換する必要があります。

4.1.2 コンポーネントUIツリーの生成

コネクタでリポジトリから作業アイテム・データが取得された後は、Oracleチーム・プロダクティビティ・センターの宣言UIフレームワークによって、コネクタ作成者が定義した作業アイテムUI定義が読み取られ、対応するUIコントロールにデータがバインドされます。Oracleプロダクティビティ・センターではメタデータドリブンUIフレームワークが提供され、このフレームワークで、コネクタ作成者は、事前定義のUIタグを使用して作業アイテムUIレイアウトのXMLファイルを開発できます。可能な場合、コネクタ作成者は、できるかぎりそのネイティブ・アプリケーションの動作を保持しながら、JDeveloperのルック・アンド・フィールに準拠するUIレイアウトを作成します。この方法によって、エンド・ユーザーは、JDeveloperでのUIのナビゲート時にも、ネイティブ・アプリケーションと同様に操作できます。

4.1.3 作業アイテム・エディタ

作業アイテム・データとそのUIコンポーネント・ツリーの両方が使用可能な場合は、JDeveloper内の特別なエディタであるWorkitemEditorによって、データがUIコントロールにバインドされ、エディタ内に表示されます。

4.1.4 動的な作業アイテム・モデルおよびUI

Oracleチーム・プロダクティビティ・センターでは、実行時に動的な作業アイテム・モデルとUIがサポートされます。特定のリポジトリの場合、作業アイテム・モデルまたはUI(あるいはその両方)は、一部の作業アイテム・インスタンス・フィールドの値または事前定義の条件によって決定されます。Oracleチーム・プロダクティビティ・センターでは、WorkitemConnectorインタフェースのメソッドを公開することによって、実行時に様々なUIレイアウトを柔軟に表示できます。

4.1.5 拡張コネクタのダウンロード方法

Oracleチーム・プロダクティビティ・センターには、タスク・リポジトリ・コネクタがデフォルトで用意されています。他のコネクタはすべて、JDeveloper更新センターから更新の確認ウィザードを使用してダウンロードする必要があります。

コネクタ拡張機能をダウンロードする手順は、次のとおりです。

1. 「ヘルプ」→「更新の確認」の順に選択します。

2. 更新の確認ウィザードで、「更新センターの検索」を選択します。

3. オープン・ソースとパートナ拡張機能センターが選択されていることを確認し、「次へ」をクリックします。

4. 「更新」ページで、リストをスクロールし、ダウンロードするOracleチーム・プロダクティビティ・センター・コネクタを選択して、「次へ」をクリックします。

5. 「終了」をクリックします。

これらの各コネクタのオンライン・ヘルプは、ダウンロードとインストールを完了すると使用できるようになります。また、独自のコネクタの開発時に、これらのコネクタの内容および構造をサンプルとして参照することもできます。

詳細は、Oracle Fusion Middleware Oracle JDeveloperユーザーズ・ガイドの「更新の確認」を使用した拡張機能のインストール方法に関する項を参照してください。

4.1.6 チーム・プロダクティビティ・センター・コネクタの実行フローの例

前述の情報を実際に適合する方法を理解するために、JIRAリポジトリを使用する次の例を考えてみます。

My P1 Issuesという問合せを表す作業アイテムをダブルクリックします。JDeveloperで問合せが開き、問合せ基準が表示され、問合せが実行されて結果がリストに表示されます。この後は、結果リストの特定の問題をダブルクリックできます。JDeveloperで新しい作業アイテム・エディタが開き、選択した問題の詳細が表示されます。次に、この例で表されるコール順を示します。

1. UIフレームワークで、My P1 Issuesに対する問合せ情報がTPCデータベースから取得されます。

2. UIフレームワークで、JIRAコネクタ・インスタンスが検索され、JIRAコネクタ上のメソッドgetQueryResultsがコールされ、問合せ基準が送信されます。

3. JIRAコネクタによって、JIRA作業アイテム・オブジェクト定義と一致する作業アイテム・オブジェクトのリストが返されます。

4. TPCフレームワークによって、作業アイテムのリストが問合せの結果リストに表示されます。

5. ユーザーが特定の作業アイテムをダブルクリックすると、UIフレームワークでJIRAコネクタ上のgetWorkitem()メソッドがコールされ、問題IDが渡されます。

6. JIRAコネクタ・インスタンス内で、getWorkitem()によって、JIRA SOAPインタフェースを使用して問題データが取得されます。

7. SOAPインタフェースからデータが返されると、getWorkitem()によってJIRA作業アイテム・オブジェクトに変換されます。

8. UIフレームワークで作業アイテム・エディタが作成されます。

9. 次に、getUIRegionName()のコールおよびUIコンポーネント・ツリーの生成によって、作業アイテム・エディタに問題UIページがロードされます。

10. その後、作業アイテム・エディタによって、データがそのUIコントロールにバインドされます。

11. 作業アイテム・エディタに、様々なレンダラを介して、問題データとそれらに関連付けられたUIコントロールが表示されます。

4.1.7 チーム・プロダクティビティ・センターのリポジトリ・データの定義方法

この例では、リポジトリ内に様々なタイプのオブジェクトを格納するためのXMLデータ・オブジェクトを定義します。このファイルの名前は、connector.xmlファイルにmodelFileNameとして指定する必要があります。このモデル・ファイルを作成し、プロジェクトの下のsrc/META-INFフォルダ内に格納します。

workitem-object.xsd内のタグを使用して、この定義ファイルに作業アイテム・データを記述できます。このファイルには、チーム・プロダクティビティ・センターに公開するフィールド、問合せ結果リストに表示するデフォルト列、およびそれらのデータを取得するために使用する値リストの定義とデータ・ソースを指定します。

workitem-object.xsdは、ファイルalmcommon-api.jarにあります。このファイルは、Oracleチーム・プロダクティビティ・センター・コネクタ・タグ・ガイドのtpctagdoc.zipとともに、ディレクトリjdeveloper\jdev\extensions\oracle.teamproductivitycenter\docの下に配布されます。

例4-1は、作業アイテム定義ファイル(SampleDef.xml)の例です。

例4-1 サンプルの作業定義ファイル

<?xml version="1.0" encoding="windows-1252"?>
<RepositoryModel resName="res" resFile="/META-INF/res/modelresource.xml">
<WorkItem data-source="rpthead" id-def="TASKID" id-label="${res.TASK_ID}" label-def="TASKID"
name="${res.TASK_NAME}" type="Task" subject-def="DESC"
webURLHandler="oracle.sampleconnector.model.TaskWebReferenceImpl"
supportSearchByID = "true"
xmlns="http://www.oracle.com/alm" version="1.1.1.1">
<Fields>
<Field name="TASKID" label="${res.TASK_ID}" type="number"
readOnly="true"/>
<Field name="DESC" label="${res.TASK_DESC}" required="true"
maxLength="80" type="string"/>
<Field name="OWNER" label="${res.TASK_OWNER}"
defaultValue="" controlType="lov" type="string"
lovDef="owner_lov"/>
<Field name="STATUS" label="${res.TASK_STATUS}" type="number"
required="true" controlType="choice"
lovDef="statusLookUp"/>
<Field name="DUEDATE" label="${res.TASK_DUEDATE}" type="date"
readOnly="true"/>
<Field name="URL" label="${res.TASK_URL}" maxLength="255"
type="string"/>
</Fields>
<QueryListColumns>
<FieldRef name="TASKID"/>
<FieldRef name="DESC"/>
<FieldRef name="OWNER"/>
<FieldRef name="STATUS"/>

</QueryListColumns>
<WebResource>
<URLDef name="URL" archorOn="label"/>
<URLDef name="TASKID" archorOn="field"/>
</WebResource>
<LovDefs>
<LovDef name="owner_lov" list-source="users">
<CriteriaMap>
<Map listFieldRef="USERID"
fieldRef="OWNER"/>
</CriteriaMap>
<FieldMap>
<Map listFieldRef="USERNAME"
fieldRef="OWNER"/>
</FieldMap>
<DisplayList>
<FieldRef name="USERID"/>
<FieldRef name="USERNAME"/>
</DisplayList>
</LovDef>
<LovDef name="statusLookUp" list-source="status">
<FieldMap>
<Map listFieldRef="SID"
fieldRef="STATUS"/>
</FieldMap>
<DisplayList>
<FieldRef name="SID"/>
<FieldRef name="SDESC"/>
</DisplayList>
</LovDef>
</LovDefs>
<DataSources>
<DataSource name="users" id-def="USERID">
<Field name="USERID" label="${res.USER_ID}"
type="string"/>
<Field name="USERNAME" label="${res.USER_NAME}"
type="string"/>
</DataSource>
<DataSource name="priority" id-def="PID">
<Field name="PID" type="number"/>
<Field name="PDESC" type="string"/>
</DataSource>
<DataSource name="status" id-def="SID">
<Field name="SID" type="number"/>
<Field name="SDESC" type="string"/>
</DataSource>
</DataSources>
</WorkItem>
</RepositoryModel>

表4-1に、使用されているタグとその説明を示します。

表4-1 リポジトリ・データ構成タグ

構成タグ

属性

説明

RepositoryModel

このコネクタに対して使用されるすべてのタイプの作業アイテムを囲みます。

resName

リソース・バンドルの名前。これは、指定されている記号に基づいてランタイム・ラベルを識別するためのネームスペースとして使用されます。たとえば、label="${res.ISSUE_PROJECT}"は、ISSUE_PROJECTがENでProjectとして定義されていると、現在のJDeveloperロケールがENの場合は実行時にProjectに解決されます。

resFile

コネクタのリソース・バンドル・ファイルのパス。

Workitem

data-source

バックエンド・リポジトリ・ソースを表します。データベース表を使用できます。

id-def

作業アイテムを一意に識別するために使用するフィールド。ほとんどの場合、作業アイテムのIDまたは番号です。

subject-def

作業アイテムのタグ付け時または作業アイテム間の関連の作成時にサブジェクト・フィールドとして使用されるフィールド。

Type

作業アイテムのタイプまたはカテゴリ。異なるタイプの複数の作業アイテムをコネクタ・モデル定義ファイルに指定できるため、実行時には、作業アイテム用のURLエディタを作成するために作業アイテムのタイプが使用されます。タイプは、様々な作業アイテムのページでマウスを右クリックして表示されるメニュー項目など、特定のUI要素にも表示されます。

xmlns

XMLネームスペース。

version

モデル定義ファイルのバージョン。

Fields

リポジトリ・オブジェクトに使用されるすべてのフィールドを囲みます。

Field

name

フィールドの名前。

label

詳細UIや問合せUIなど、様々な作業アイテムのページのフィールドに使用される表示ラベル。

type

フィールドのデータ型。有効な値は"number"、"string"、"date"です。デフォルトはstringです。

required

trueに設定すると、そのフィールドが必須フィールドであることを示すために、フィールド・ラベルの前に(*)が表示されます。デフォルトはfalseです。

controlType

使用するUIコントロールの詳細は、第4.2.5項「チーム・プロダクティビティ・センターUIを使用してデータを宣言的に表示する方法」を参照してください。

lovDef

controlTypeが"lov"の場合に使用するLOV定義の名前。「LovDefs」を参照してください。

readonly

trueに設定すると、対応するコントロールがグレー表示され、フィールド値が読取り専用モードになります。デフォルトはfalseです。

queryable

trueに設定すると、このフィールドは、問合せフォームのフィールド・コンボ・ボックス内に表示されます。デフォルトはtrueです。

maxLength

フィールドに入力できる最大文字数を設定します。

LovDefs

リポジトリ・フィールドに使用されるすべての値リスト(LOV)定義を囲みます。

LovDef

LOVの定義。

name

LOVの名前。

list-source

そのデータを取得するために使用するデータ・ソースの名前。「DataSource」を参照してください。

DataSources

LOVで使用されるすべてのデータ・ソースを囲みます。

DataSource

データ・ソースの定義。

name

データ・ソースの名前。

id-def

バックエンド・リポジトリ内のオブジェクト・タイプまたは表名。

QueryListColumns

問合せ結果リストに表示するデフォルト列のリスト。

WebResource

ハイパーリンクされるフィールドを説明するセクション。

URLDef

WebResourceの子。ハイパーリンク可能な各フィールドを説明します。

name

フィールド・リストからのフィールドの名前。

archorOn

下線付きのハイパーリンクをラベル上に表示するか、実際の値上に表示するかを指定します。有効な値は"label"または"field"です。デフォルトはfieldです。

4.1.8 コネクタへのリスナーの追加方法

workitem.propertiesファイルは、チーム・プロダクティビティ・センターでリスナー(作業アイテムに関するイベントが発生したときに起動するjavaクラス)の保存に使用されるファイルです。このファイルを編集して、ユーザー入力に関してコネクタが依存する特定のリスナーを含めます。

コネクタ拡張機能を作成するときは、workitem.propertiesファイルがコネクタ・バンドルに含まれていることを確認してください。

4.2 Oracleチーム・プロダクティビティ・センター・コネクタの作成

チーム・プロダクティビティ・センター・コネクタは、JDeveloper拡張機能プロジェクトとして開始します。(XMLの)構成ファイルを使用して、コネクタ・インスタンスを作成するためのパラメータを保存して管理します。また、コネクタは、リポジトリによって使用されるデータをJDeveloperが解析できるように定義し、リポジトリからデータを取得し、JDeveloper内でデータを表示するためのチーム・プロダクティビティ・センターUIを使用します。後続の各項では、各タスクについてさらに詳細に説明し、WorkItemConnectorインタフェースを実装するためのサンプル・コードを示します。

4.2.1 Oracleチーム・プロダクティビティ・センター・コネクタの作成方法

チーム・プロダクティビティ・センター・コネクタは、JDeveloper拡張機能として作成されます。この結果、JDeveloperとの統合が可能であり、コネクタ開発の完了後には、JDeveloperの「更新の確認」機能を使用して、コネクタをパッケージ化および配布するためのフレームワークも提供されます。これによって、コネクタを開発チームに配布するための既知のメカニズムが提供されます。

次の手順は、Oracleチーム・プロダクティビティ・センター・コネクタの作成プロセスの概要を示しています。ここに示されている多くの手順の詳細は、Oracle® Fusion Middleware Oracle JDeveloperユーザーズ・ガイドに記載されています。

Oracleチーム・プロダクティビティ・センター・コネクタを作成する手順は、次のとおりです。

1. コネクタを作成するためのJDeveloper拡張機能プロジェクトを作成します。「ファイル」→「新規」→「すべての機能」→「クライアント層」→「拡張機能の開発」の順に選択します。

2. コネクタ構成XMLファイルを作成します。チーム・プロダクティビティ・センター・インストーラで使用されるコネクタ構成パラメータを提供する必要があります。パラメータはシード・データとして処理され、チーム・プロダクティビティ・センター・データベースに格納されます。これらは、コネクタのインスタンスを作成する際、実行時に使用されます。
詳細は、第4.2.2項「Oracleチーム・プロダクティビティ・センター・コネクタ構成ファイルの作成方法」を参照してください。

3. Oracleチーム・プロダクティビティ・センターに公開するオブジェクト・タイプを決定します。たとえば、MSプロジェクト・サーバー・コネクタの作成者が、タスク、プロジェクトおよびリソース・データを表示するように決定すると、3つのオブジェクト・タイプが存在することになります。

4. リポジトリ・オブジェクト定義XMLファイルを作成します。このファイルでは、各オブジェクト・タイプのフィールド詳細、デフォルト・ラベル、使用するデフォルトUIコントロール・タイプ、必須かどうかなどが提供されます。
詳細は、第4.1.7項「チーム・プロダクティビティ・センターのリポジトリ・データの定義方法」を参照してください。

5. 特定のリスナーを使用している場合は、workitem.propertiesファイルに追加して、ファイルがコネクタ・バンドルに含まれていることを確認します。
詳細は、第4.1.8項「コネクタへのリスナーの追加方法」を参照してください。

6. コネクタUIレイアウトXMLファイルを作成します。これによって、チーム・プロダクティビティ・センター宣言UIフレームワークで提供されるUIタグを使用して、UIをレイアウトできます。

7. WorkItemConnectorおよび(オプションで)WorkItemAttachmentインタフェース・メソッドを実装するクラスを作成します。このクラスでは、バックエンド・リポジトリから使用できる適切なAPIを使用して、接続の確立、リポジトリ・データの送受信、チーム・プロダクティビティ・センターで使用される作業アイテム書式へのデータの変換が実行されます。

8. 状況依存ヘルプ・ファイルを提供します。ヘルプ・ファイルは、ユーザーが作業アイテム詳細UIをフォーカスしている状態で[F1]を押すと、JDeveloperヘルプ・センターによってロードされます。
詳細は、第4.4.1項「チーム・プロダクティビティ・センター・コネクタへのヘルプの追加方法」を参照してください。

9. 複数言語サポート用のリソース・バンドル・ファイルを提供します。
詳細は、第4.5.4項「コネクタ・バンドル・ファイルの生成方法」を参照してください。

10. コネクタをデプロイメント用の適切なZIP形式にパッケージ化します。

後続の各項では、各タスクについてさらに詳細に説明し、WorkItemConnectorインタフェースを実装するためのサンプル・コードを示します。

4.2.2 Oracleチーム・プロダクティビティ・センター・コネクタ構成ファイルの作成方法

コネクタ構成XMLファイルには、ランタイム・コネクタ・インスタンスの作成時に使用されるパラメータが含まれています。パラメータは、チーム・レベルまたはサーバー・レベルで設定できます。この構成ファイルは、インストール時に、Oracleチーム・プロダクティビティ・センター・インストーラによって読み込まれ、シード・データがチーム・プロダクティビティ・センター・データベース表に移入されます。

connector.xmlファイルは、コネクタのパラメータを追加できるように作成する必要があり、これらのパラメータには、チーム・リーダーまたは管理者が値を定義できます。

connector.xmlファイルを作成する手順は、次のとおりです。

1. アプリケーション・ナビゲータで拡張機能プロジェクトを右クリックします。

2. 「新規」→「XML」→「XMLドキュメント」の順に選択します。

3. このファイルにconnector.xmlという名前を付け、プロジェクトの下のsrc/META-INFフォルダ内に保存します。

この構成ファイルでは、almcommon-api.jarファイルにあるconnector.xsdファイルに定義されたタグが使用されます。このJARファイルは、JDeveloperインストール・フォルダ\jdeveloper\jdev\extensions\oracle.teamproductivitycenter\libにあります。

例4-2は、構成ファイルの例を示しています。

例4-2 構成ファイル・サンプル・コード

<?xml version="1.0" encoding="UTF-8"?>
<ConnectorDefinition xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.oracle.com/alm connector.xsd"
xmlns="http://www.oracle.com/alm">
<configuration id="Sample"
className="oracle.sampleconnector.model.SampleConnectorService"
repositoryType="Work Item"
uiFileName="/META-INF/SampleUI.xml"
modelFileName="/META-INF/SampleDef.xml"
version="1.0">
<parameter>
<name>SampleParam1</name>
<defaultValue>Default value 1</defaultValue>
<label>
<locale>US</locale>
<value>Sample Param 1</value>
</label>
<description>This is the sample admin param one</description>
<accessLevel>ALM-Admin</accessLevel>
</parameter>
<parameter>
<name>SampleParam2</name>
<defaultValue>Default value 2</defaultValue>
<label>
<locale>US</locale>
<value>Sample Param 2</value>
</label>
<description>This is the sample admin param two</description>
<accessLevel>ALM-Admin</accessLevel>
</parameter>
<parameter>
<name>SampleTeamParam</name>
<defaultValue>Sample Team Param</defaultValue>
<label>
<locale>US</locale>
<value>Sample Team Param</value>
</label>
<description>This is a sample team parameter</description>
<accessLevel>Team-Admin</accessLevel>
</parameter>
</configuration>
</ConnectorDefinition>

表4-2に、使用されているタグとその説明を示します。

表4-2 connector.xmlで使用されているタグ

構成タグ

属性

説明

configuration

id

コネクタの名前

className

実行時にコネクタ・インスタンスを作成する際にロードするコネクタ・クラス。

uiFileName

コネクタUI定義を含む、コネクタjarファイル内のファイルへのパス。

modelFileName

コネクタ・モデル定義を含む、コネクタjarファイル内のファイルへのパス。

version

現在のコネクタのバージョン。新規/アップグレードのコネクタ・パッケージでは、新規バージョンを使用する必要があります。

parameter

各構成可能パラメータを指定します。

name

パラメータ名。

label

チーム管理UI(または管理UI)で使用する表示テキスト。

locale

ローカライズ・サポート。

value

指定したロケールの値。

description

このパラメータの内容の簡単な説明。これは、管理UIに表示されます。

accessLevel

ALM-Admin: TPC管理者のみが、管理UI→「リポジトリ」タブでこのパラメータを構成できることを示します。

Team-Admin: チーム管理者のみが、管理UI→「チーム」→「リポジトリ」タブでこのパラメータを構成できることを示します。

4.2.3 カスタマイズしたリスナーおよびマネージドBeanの使用方法

チーム・プロダクティビティ・センターに対するコネクタの開発者は、作業アイテムのUIコントロールの動作をカスタマイズすることによって、コネクタ固有の機能を提供できます。

チーム・プロダクティビティ・センターには、すべてのメタデータ・リソースを登録するためのコネクタ・レベルの構成ファイルtpc-config.xmlが用意されています。このファイルは、src/META-INF/の下のコネクタ・ソース・コード・ディレクトリに格納する必要があります。

構成ファイルでサポートされるタグおよび属性の詳細は、Oracle Fusion Middleware Oracle Team Productivity Center Connectorsタグ・リファレンスを参照してください。

カスタム・マネージドBeanを作成する手順は、次のとおりです。

チーム・プロダクティビティ・センターに対するコネクタを作成する場合は、次の手順に示すように、値バインディング・サポート用にカスタマイズしたマネージドBeanを作成できます。

1. 例4-3に示すように、ファイルtpc-config.xmlにマネージドBeanエンティティを登録します。

例4-3 マネージドBeanエンティティの登録

<managed-bean>
<name>labelBean</name>
<impl-class>oracle.alm.sample.resbean.LabelBean</impl-class>
<lifecycle>page</lifecycle>
</managed-bean>

2. 例4-4に示すように、LabelBeanを実装します。

例4-4 LabelBeanの実装

public class LabelBean
{
public LabelBean(){}
public String getLabel()
{
return _label;
}
public  void setLabel(String label)
{
_label = label;
}
String _label = "test label";
}

3. 作業アイテム定義メタデータ・ファイル(たとえば、作業アイテム・フィールド用)、またはUIメタデータ・ファイルのUIコントロールに対するラベル属性のいずれかで、マネージドBeanを使用します。
label="${labelBean.label}"

カスタマイズしたUIリスナーを作成する手順は、次のとおりです。

また、カスタマイズしたUIリスナーを作成し、作業アイテムUIメタデータのコントロールに登録するには、次の手順を実行します。

1. 例4-5に示すように、tpc-config.xmlにリスナーを登録します。

例4-5 リスナーの登録

<managed-bean>
<name>opentask </name>
<impl-class>oracle.alm.sample.view.OpenTaskListener </impl-class>
<lifecycle>page </lifecycle>
</managed-bean>

2. OpenTaskListenerクラスを実装します。

例4-6 クラスOpenTaskListenerの実装

package oracle.alm.sample.view;

import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;

import java.util.List;

import oracle.alm.connector.data.WorkItem;
import oracle.alm.view.application.ViewManager;
import oracle.alm.view.context.AlmELContext;
import oracle.alm.view.model.AlmDataTableModel;
import oracle.alm.view.uicomponents.AlmComponent;
import oracle.alm.view.uicomponents.AlmContextMenuComponent;
import oracle.alm.view.uicomponents.AlmTableComponent;
import oracle.alm.view.uicomponents.RenderingContext;

public class OpenTaskListener
implements ActionListener, AlmScope
{
public OpenTaskListener(RenderingContext rcontext, AlmComponent component)
{
super();
_rcontext = rcontext;
_component = component;
}

public void actionPerformed(ActionEvent e)
{
if (_component instanceof AlmContextMenuComponent)
{
AlmComponent parent = _component.getParent();
if (parent instanceof AlmTableComponent)
{
AlmTableComponent tableComp = (AlmTableComponent) parent;
List<Integer> rows = tableComp.getSelectedRows();
if (rows != null)
{
ViewManager vmanger = ViewManager.getInstance();
for (int row: rows)
{
AlmELContext elcontext = vmanger.getELContext(_rcontext);
AlmDataTableModel dataModel = tableComp.getValue(elcontext);
Object selectedValue = dataModel.getSelectedItem(row);
if (selectedValue instanceof WorkItem)
{
String wiType = _rcontext.getCurrentWorkItemType();
String reposName = _rcontext.getCurrentReposName();
String reposId = _rcontext.getCurrentReposId();
vmanger.OpenWorkItemInEditor(((WorkItem) selectedValue),
wiType, reposName, reposId);
}
}
}
}
}
}
public void setRenderingContext(RenderingContext rc){_rcontext = rc};
public RenderingContext getRenderingContext(){return _rcontext};
public void setSourceComponent(AlmComponent component) {_component = component};
public AlmComponent getSourceComponent() {return _component};
private RenderingContext _rcontext;
private AlmComponent _component;}

3. カスタマイズしたリスナーを作業アイテムUIメタデータで使用します。

例4-7 カスタマイズしたリスナーの作業アイテム内での使用

<?xml version="1.0" encoding="windows-1252" ?>
<regions resFile="/META-INF/res/uiresources.xml">
<region id="Default" helpTopicId="f1_connector_sample_htm">
<formLayout columns="1" blockSize="10" fieldWidth="400">
<inputText label="#{workitemmodel.labels.TASKID}"
value="#{workitemmodel.values.TASKID}" readOnly="true"/>
<inputText label="#{workitemmodel.labels.DESC}"
value="#{workitemmodel.values.DESC}"/>
<listOfValues label="#{workitemmodel.labels.OWNER}"
value="#{workitemmodel.values.OWNER}"
source="OWNER" pprTargets="statusID"/>
<comboBox label="#{workitemmodel.labels.STATUS}"
value="#{workitemmodel.values.STATUS}"
valueSet="#{workitemmodel.listItems.STATUS}"
readOnly="true" id="statusID"/>
<inputDate label="#{workitemmodel.labels.DUEDATE}"
value="#{workitemmodel.values.DUEDATE}"/>
<inputText label="#{workitemmodel.labels.URL}"
value="#{workitemmodel.values.URL}"/>
</formLayout>
<panelLayout>
<action text="Open Task" actionListener="${opentask}"/>
</panelLayout>
</region>
</regions>

ポップアップ・メニュー・アクションをカスタマイズする手順は、次のとおりです。

ユーザーが問合せ結果表でマウスの右ボタンをクリックしたときに表示される、カスタマイズ・メニュー項目を追加できます。この手順は次のとおりです。

1. リスナーをtpc-config.xmlに登録し、メニュー項目の詳細を指定します。

例4-8 詳細を指定したリスナーの登録

<managed-bean>
<name>savetask</name>
<impl-class>oracle.alm.sample.model.SaveTaskListener</impl-class>
<lifecycle>page</lifecycle>
</managed-bean>
<contextMenuDef>
<menuItemDef label="Save" listenerRef="savetask"/>
</contextMenuDef>

2. SaveTaskListenerクラスを実装します。

例4-9 クラスSaveTaskListenerの実装

package oracle.alm.sample.model;

import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.util.List;
import javax.swing.JOptionPane;
import oracle.alm.connector.data.WorkItem;
import oracle.alm.view.application.ViewManager;
import oracle.alm.view.context.AlmELContext;
import oracle.alm.view.model.AlmDataTableModel;
import oracle.alm.view.uicomponents.AlmComponent;
import oracle.alm.view.uicomponents.AlmContextMenuComponent;
import oracle.alm.view.uicomponents.AlmTableComponent;
import oracle.alm.view.uicomponents.RenderingContext;

public class SaveTaskListener implements ActionListener, AlmScope
{
public SaveTaskListener(RenderingContext rcontext, AlmComponent component)
{
super();
if (component instanceof AlmContextMenuComponent)
_almComponent = (AlmContextMenuComponent) component;
_renderingContext = rcontext;
}

public void actionPerformed(ActionEvent e)
{
ViewManager vmgr = ViewManager.getInstance();

//First get the corresponding AlmTableComponent
AlmComponent parent = _almComponent.getParent();
if (parent instanceof AlmTableComponent)
{
AlmTableComponent tableComp = (AlmTableComponent) parent;
//Then call public API on tableComp to get selected rows
List&l;Integer> rows = tableComp.getSelectedRows();

if (rows != null)
{
int row = rows.size();
String cs = "";
if (row == 1)
{
//show the ID and subject of the selected item
//Then get the selected value object throw the tableComp's UI model.
ViewManager vmanger = ViewManager.getInstance();
AlmELContext elcontext = vmanger.getELContext(_renderingContext);
AlmDataTableModel dataModel = tableComp.getValue(elcontext);
Object selectedValue = dataModel.getSelectedItem(row);
if (selectedValue instanceof WorkItem)
{
cs = "Save Task listener: work item ";
WorkItem wi = (WorkItem)selectedValue;
cs += wi.getRowKey() + " with subject \'";
cs += wi.getSubject() + "\' has been selected.";
}
}
else if (row > 1)
{
//show the number of rows selected
cs = "Save Task listener: " + Integer.toString(row) + " rows selected";
}
JOptionPane.showMessageDialog(vmgr.getIDEMain(), cs);
}
}
}
public void setRenderingContext(RenderingContext rc){_ renderingContext = rc};
public RenderingContext getRenderingContext(){return _ renderingContext };
public void setSourceComponent(AlmComponent component) {_almComponent = component};
public AlmComponent getSourceComponent() {return _almComponent };

AlmContextMenuComponent _almComponent;
RenderingContext _renderingContext;
}

4.2.4 ファイアウォールを介したコネクタ・データへのアクセス方法

JDeveloperが背後で実行されているファイアウォールを介したデータのフェッチのために、コネクタでHTTPプロトコルを使用する必要がある場合は、次の特別な変更が必要です。

1. JDeveloperで、「ツール」→「プリファレンス」の順に選択します。

2. 「プリファレンス」ダイアログで、「Webブラウザとプロキシ」ノードを開きます。

3. 「プロキシの使用」チェック・ボックスを選択し、「ホスト名」、「ポート」および「例外」の値を入力します。

4. コネクタ作成者は、HttpClientに対するプロキシ構成を、データをフェッチする必要があるコネクタ・コード内(例: getQueryResult() API内)に設定する必要があります。

例4-10 コネクタ・コード内のプロキシ構成の設定

HttpClient httpclient = new HttpClient();
String proxyHost = System.getProperty("http.proxyHost");
String proxyPort = System.getProperty("http.proxyPort");
Boolean useProxy = null;

if (proxyHost != null && !proxyHost.isEmpty()&&
proxyPort != null && !proxyPort.isEmpty())
{
String proxyExceptions = System.getProperty("http.nonProxyHosts");
useProxy = (proxyExceptions == null);
if (!useProxy)
{
String host = "";
try
{
URL url = new URL(getServerURL());
host = url.getHost();
useProxy = true;
}
catch (Exception e)
{
e.printStackTrace();
}

proxyExceptions = proxyExceptions.replace("*", ".*");
useProxy = (Pattern.matches(proxyExceptions, host) == false);
}
}

if (useProxy != null && useProxy.equals(Boolean.TRUE))
httpclient.getHostConfiguration().setProxy(proxyHost, Integer.parseInt(proxyPort));

4.2.5 チーム・プロダクティビティ・センターUIを使用してデータを宣言的に表示する方法

Oracleチーム・プロダクティビティ・センターには、すべてのコネクタに対する宣言UIをサポートするフレームワークが用意されています。コネクタ作成者は、workitem-ui.xsdに定義されているUIタグを使用して、作業アイテムUIをレイアウトできます。入力テキスト、ラジオ・ボタン、コンボ・ボックス、チェック・ボックス、選択リスト、値リスト(LOV)などの基本的なUI要素はすべてサポートされています。

この手順では、リポジトリ・オブジェクトをユーザーに示すために、UI定義を格納するXMLデータ・オブジェクトを定義します。このファイルの名前は、connector.xmlファイルにuiFileNameとして指定する必要があります。このUIファイルを作成し、プロジェクトの下のsrc/META-INFフォルダ内に格納します。

workitem-ui.xsdは、ファイルalmcommon-api.jarにあります。

事前定義のcontrolTypeのデフォルトをモデル定義で使用すると、モデルからコントロール・タグを自動的に取得するformLayoutコンポーネントを使用するのみで、UIを簡単にレイアウトできます。この項では、これを実行できる方法の例をいくつか示します。

例4-11 作業アイテムUIページを表示するための簡単な方法

<?xml version="1.0" encoding="windows-1252" ?>
<regions resFile="/META-INF/res/uiresources.xml">
<region name="Easy" helpTopicId="f1_connector_sample_htm">
<formLayout value="${workitemmodel}" columns="1" blockSize="10"/>
</region>
</regions>

表4-3 前述の例で使用されているUIタグ

UIタグ

属性

説明

Regions

使用されているすべてのUIリージョンのカプセル化。

resFile

複数言語サポート用に使用するリソース・バンドル・ファイルを指定します。

Region

その名前属性で識別される1ページのレイアウト。

helpTopicId

(コネクタjarファイル内から)使用するヘルプ・ファイル名をJDeveloperに通知します。

formLayout

value

値は"${workitemmodel}"であり、これは、実行時に適切なコネクタ・モデルに解決されます。

columns

フォームをレイアウトする列数を設定します。

blockSize

各blockSize行の後に、行セパレータが追加されることを示します。

rowToSpan

モデルのどの行がページの行全体にわたって表示されるかを示します。"1, 3, 5"の場合、1番目、3番目および5番目の行がページの行全体にわたって表示されます。

明示的なレイアウトを使用してUIページを表示する手順は、次のとおりです。

この例は、例4-11と同じUIを示していますが、かわりに明示的なレイアウトを使用しています。これは、同じデータ・モデルの複数のUIビューがある場合に必要です。たとえば、オブジェクトの新規インスタンスの作成時にはフィールドのサブセットのみが表示されるようにするが、保存後はすぐに、すべてのフィールドが表示されるようにする場合があります。

例4-12 UIページの明示的なレイアウト

<?xml version="1.0" encoding="windows-1252" ?>
<regions resFile="/META-INF/res/uiresources.xml">
<region name="Default" helpTopicId="f1_connector_sample_htm">
<formLayout columns="1" blockSize="10" >
<inputText label="#{workitemmodel.labels.TASKID}"
value="#{workitemmodel.values.TASKID}"
readOnly="true"/>
<inputText label="#{workitemmodel.labels.DESC}"
value="#{workitemmodel.values.DESC}"/>
<listOfValues label="#{workitemmodel.labels.OWNER}"
value="#{workitemmodel.values.OWNER}"
srcAttr="OWNER"
lovDef="#{workitemmodel.lovDefs.OWNER}"/>
<comboxBox label="#{workitemmodel.labels.STATUS}"
value="#{workitemmodel.values.STATUS}"
valueSet="#{workitemmodel.listItems.STATUS}"/>
<inputDate label="#{workitemmodel.labels.DUEDATE}"
value="#{workitemmodel.values.DUEDATE}"/>
<inputText label="#{workitemmodel.labels.URL}"
value="#{workitemmodel.values.URL}"/>
</formLayout>
</region>
</regions>

表4-4 コントロール・タイプ

UIタグ

属性

説明

inputText

label

UIに表示するフィールド・ラベル。

value

ランタイム・フィールド値。

required

必須かどうかを示します。

readOnly

データを編集できるかどうかを示します。

inputDate

label

UIに表示するフィールド・ラベル。

value

ランタイム・フィールド値。

required

必須かどうかを示します。

readOnly

データを編集できるかどうかを示します。

comboBox

label

UIに表示するフィールド・ラベル。

value

ランタイム・フィールド値。

required

必須かどうかを示します。

readOnly

データを編集できるかどうかを示します。

checkBox

label

UIに表示するフィールド・ラベル。

value

ランタイム・フィールド値。

required

必須かどうかを示します。

readOnly

データを編集できるかどうかを示します。

radio

label

UIに表示するフィールド・ラベル。

value

ランタイム・フィールド値。

required

必須かどうかを示します。

readOnly

データを編集できるかどうかを示します。

valueSet

値リストの取得場所を定義します。

listOfValues

label

UIに表示するフィールド・ラベル。

value

ランタイム・フィールド値。

required

必須かどうかを示します。

readOnly

データを編集できるかどうかを示します。

srcAttr

使用するソース・フィールドを定義します。

lovDef

ソース・フィールドのlovDefを定義します。

textEditor

label

UIに表示するフィールド・ラベル。

value

ランタイム・フィールド値。

required

必須かどうかを示します。

readOnly

データを編集できるかどうかを示します。

rows

表示する行数。

required

必須かどうかを示します。

list

label

UIに表示するフィールド・ラベル。

value

ランタイム・フィールド値。

valueSet

値リストの取得場所を定義します。

パネルを使用してより複雑なUIをレイアウトする手順は、次のとおりです。

より複雑なUIレイアウトの場合は、パネルを使用してコントロールをレイアウトすることもできます。パネルには、水平方向または垂直方向にするプロパティがあります。パネルはネストすることもできます。

例4-13 パネルを使用したコントロール・レイアウト

<?xml version="1.0" encoding="windows-1252" ?>
<regions resFile="/META-INF/res/uiresources.xml">
<region name="Default" helpTopicId="f1_connector_sample_htm">
<panelLayout layout=”horizontal”>
<formLayout columns="1" blockSize="10" >
<inputText label="#{workitemmodel.labels.TASKID}"
value="#{workitemmodel.values.TASKID}"
readOnly="true"/>
<inputText label="#{workitemmodel.labels.DESC}"
value="#{workitemmodel.values.DESC}"/>
<listOfValues label="#{workitemmodel.labels.OWNER}"
value="#{workitemmodel.values.OWNER}"
srcAttr="OWNER"
lovDef="#{workitemmodel.lovDefs.OWNER}"/>
<comboxBox label="#{workitemmodel.labels.STATUS}"
value="#{workitemmodel.values.STATUS}"
valueSet="#{workitemmodel.listItems.STATUS}"/>
<inputDate label="#{workitemmodel.labels.DUEDATE}"
value="#{workitemmodel.values.DUEDATE}"/>
<inputText label="#{workitemmodel.labels.URL}"
value="#{workitemmodel.values.URL}"/>
</formLayout>
<textEditor value="#{workitemmodel.values.BIGDESC}"/>
</region>
</regions>

表4-5 パネルの例で使用されているUIタグ

UIタグ

属性

説明

panelLayout

layout

グループ化コントロールのレイアウトの方向を指定します。有効な値はverticalおよびhorizontalです。

4.2.6 Oracleチーム・プロダクティビティ・センター・リポジトリからのデータの取得方法

様々な作業アイテム・タイプに対するモデルおよびUIレイアウトを定義した後、次のステップは、WorkItemConnectorインタフェース上のメソッド、およびWorkItemAttachmentインタフェース上のメソッド(コネクタで添付ファイルがサポートされている場合)の実装です。このトピックでは、これらのメソッドの詳細を説明します。

これらのメソッドを実装するには、チーム・プロダクティビティ・センターのJARファイルの場所をプロジェクトに追加して、WorkItemConnectorおよびWorkItemAttachmentインタフェースの適切なクラスを取得できるようにする必要があります。

チーム・プロダクティビティ・センターのJARファイルの場所をプロジェクトに追加する手順は、次のとおりです。

1. 拡張機能プロジェクトをダブルクリックして、「プロジェクト・プロパティ」→「ライブラリとクラスパス」の順に選択します。

2. 右側で、「JAR/ディレクトリの追加」を選択します。

3. JDeveloperをインストールした場所にナビゲートします。JDev/Extensions/oracle.teamproductivitycenter/libフォルダの下で、almcommon-ip.jarファイルを検索して含めます。

4.2.6.1 WorkItemConnectorインタフェースの実装

JARが追加されたので、WorkitemConnectorに対するインタフェースを実装できます。

インタフェースを実装する手順は、次のとおりです。

1. 「ファイル」→「新規」の順に選択します。

2. 「一般」→「Java」→「Javaクラス」の順に選択します。

3. Javaクラスの作成ウィザードで、クラスおよびパッケージ名を入力します。

4. 「オプション属性」セクションで、プラス記号をクリックして、インタフェースを実装します。

5. 「クラスおよびパッケージ・ブラウザ」で、「階層」タブを選択し、クラスoracle/alm/connector/WorkItemConnectorを検索します。WorkItemAttachmentインタフェースを実装する予定の場合は、[CTRL]キーを使用してそのインタフェースも選択します。

6. 「OK」をクリックします。

この結果、実装する必要があるすべてのメソッドが含まれたスケルトン・ファイルが提供されます。

表4-6 メソッドの要約

API

説明

void

init(Map sessionContext)

クライアント側のコネクタ・インスタンスを初期化し、その対応するリポジトリに対して、コネクタの物理的な接続パラメータを作成します。

void

login(Map sessionContext, String userID, String password)

クライアント側のコネクタ・インスタンスとバックエンド・リポジトリ間のユーザー接続を確立します。

void

logout(Map sessionContext)

ユーザーをバックエンド・リポジトリから切断します。データ・ハッシュ構造を使用して状態を保存できます。

Void

setWorkItemDefs(Map sesion, Map<String, WorkItemDef> wiDefs)

フレームワークによって、コネクタ・モデル定義に定義されている作業アイテム・タイプに対するランタイム・データ構造が構築されます。

List<WorkItem>

getQueryResult(Map sessionContext, String wiType, QueryInfo query)

QueryInfoで定義される問合せ基準を満たす問合せ結果セットを取得します。

WorkItem

getWorkItem(Map sessionContext, String wiType, WorkItem workItem)

特定の作業アイテムを、そのタイプと一意の識別子によって取得します。

void

updateWorkItem(Map sessionContext, String wiType, WorkItem workItem)

既存の作業アイテムを、そのタイプと一意の識別子によって更新します。

void

createWorkItem(Map sessionContext, String wiType, WorkItem workItem)

指定したタイプの新規作業アイテムをそのバックエンド・リポジトリに作成します。

deleteWorkItem(Map sessionContext, String wiType, WorkItem workItem)

作業アイテムをそのバックエンド・リポジトリから削除します。

List<Row>

getLOVQueryResult(Map sessionContext, QueryInfo query, String fieldName)

事前定義のLOV(値リスト)に対する値セットを取得します。

boolean

IsAttachmentSupported (Map sessionContext, WorkItem wi)

指定した作業アイテムに対して添付ファイルがサポートされているかどうかを判断します。yesの場合は、作業アイテム・モデルでWorkItemAttachmentインタフェースを実装する必要があります。

String

getUIRegionName(Map sessionContext, String wiType, WorkItem wi)

コネクタUI XMLで定義されているリージョン名を取得します。

boolean

hasDynamicUI(Map session)

コネクタで動的UIがサポートされている場合は、trueを返します。

String

getDynamicUI(Map session, String currentUI)

新規作業アイテムUI定義のXML文字列を取得します。

boolean

hasDynamicModel(Map session)

コネクタで動的モデルがサポートされている場合は、trueを返します。

String

getDynamicModel (Map session, String currentModel)

新規作業アイテム・モデル定義のXML文字列を取得します。

4.2.7 カスタム・アクションに基づいた作業アイテム詳細のリフレッシュ方法

特定のシナリオでは、既存のレイアウトにおけるなんらかのカスタム・アクションに基づいて、作業アイテム詳細ページを新しいレイアウトにリフレッシュする必要があります。たとえば、ユーザーによるコンボ・ボックスからの新しい値の選択、日時ピッカーからの日付変更、ページ内のボタンの単純なクリックなどがあります。

タスクがその詳細エディタに表示されるとき、そのベースUIには「Status」コンビネーション・ボックスがあります。

図4-1 UIの「Status」コンビネーション・ボックス

ステータスの値が「New」から「In-Progress」に変わると、ユーザーがステータスの進行状況に関する情報を提供できるリッチ・テキスト・コントロールを含む新規レイアウトが表示されます。

図4-2 ステータスUIに対する新規リッチ・テキスト・コントロール

ユーザーが作業アイテムの編集を終了し、「Submit」をクリックすると、成功または失敗メッセージを含んだ確認ページが表示されます。

図4-3 リッチ・テキスト・コントロール使用後の確認ページ

更新したタスク詳細ページを表示するには、「Return to Home」をクリックします。

機能を実装する手順は、次のとおりです。

1. 動的なUI変更をトリガーするためのアクション・ソースとして使用するUIコントロール、およびUI相互作用を制御するリスナーを決定します。

2. 作業アイテムUIレイアウト・メタデータ・ファイルに、新規UIリージョンを定義します。

3. 対応するリスナーをマネージドBeanで実装します。

4. 様々な条件に基づいて様々なUIリージョンを返すためのAPI getUIRegionName()を実装します。

5. マネージドBeanをコネクタのtpc-config.xmlファイルに登録します。

6. EL式を介して、UIメタデータでBeanを使用します。

後続の各項では、サンプル・コネクタを使用してさらに詳細に説明します。

4.2.7.1 UIコントロールおよびリスナー属性の決定

サンプル・コネクタでは、アクション・ソースとしてステータス・フィールドに対するコンビネーション・ボックス・コントロールを使用します。また、コンボ・ボックス・コントロール上でPopupMenuListenerを使用して、選択の変更をリスニングし、UIの動的更新作業を実行します。また、「Submit」ボタンを使用して、タスク詳細ページと確認ページ・レイアウト間をナビゲートします。

構成の詳細は、SampleDef.xmlファイルにあります。次の例では、ステータス・コンビネーション・ボックスと送信アクションが、それぞれ対応する属性名と値のペアでどのように定義されているかに注意してください。

例4-14 UIコントロールおよびリスナー属性の選択

<?xml version="1.0" encoding="windows-1252" ?>
<region id="Homepage">
<formLayout columns="1" blockSize="10" fieldWidth="400" labelWidth="60">
<inputText label="#{workitemmodel.labels.PARENT_TASKID}"
value="#{workitemmodel.values.PARENT_TASKID}" readOnly="true"/>
<inputText label="#{workitemmodel.labels.TASKID}"
value="#{workitemmodel.values.TASKID}" readOnly="true"/>
<inputText label="#{workitemmodel.labels.DESC}"
value="#{workitemmodel.values.DESC}"/>
<listOfValues label="#{workitemmodel.labels.OWNER}"
value="#{workitemmodel.values.OWNER}" source="OWNER"
pprTargets="statusID"/>
<comboBox label="#{workitemmodel.labels.STATUS}"
value="#{workitemmodel.values.STATUS}" id="statusID"
valueSet="#{workitemmodel.listItems.STATUS}" readOnly="true"
popupMenuListener="#{mainBean.statusListener}"/>
<inputDate label="#{workitemmodel.labels.DUEDATE}"
value="#{workitemmodel.values.DUEDATE}"/>
<inputText label="#{workitemmodel.labels.URL}"
value="#{workitemmodel.values.URL}"/>
<panelLayout>
<action text="Submit" actionCommand="gotoc                 actionListener="${dynamicBean.actionListener}"/>onfirmpage"
</panelLayout>
</formLayout>
<separator/>
</region>

4.2.7.2 UIメタデータ・ファイルでの新規リージョンの定義

デフォルトのHomePageリージョンに加え、このコードでは、リージョンDemo(ステータスが「in-progress」に変わると表示)とリージョンconfirmation(ユーザーが「Submit」をクリックすると表示)の2つの新規リージョンが作成されます。

例4-15 新規リージョンの定義

<region id="Demo" helpTopicId="f1_connector_sample_htm">
<formLayout columns="1" blockSize="10" fieldWidth="400" labelWidth="60">
<inputText label="#{workitemmodel.labels.PARENT_TASKID}"
value="#{workitemmodel.values.PARENT_TASKID}" readOnly="true"/>
<inputText label="#{workitemmodel.labels.TASKID}"
value="#{workitemmodel.values.TASKID}" readOnly="true"/>
<inputText label="#{workitemmodel.labels.DESC}" value="#{workitemmodel.values.DESC}"/>
<listOfValues label="#{workitemmodel.labels.OWNER}"
pprTargets="statusID" value="#{workitemmodel.values.OWNER}" source="OWNER"/>
<comboBox label="#{workitemmodel.labels.STATUS}"
value="#{workitemmodel.values.STATUS}"
popupMenuListener="#{mainBean.statusListener}"
valueSet="#{workitemmodel.listItems.STATUS}" readOnly="true"
id="statusID"/>
<inputDate label="#{workitemmodel.labels.DUEDATE}"
value="#{workitemmodel.values.DUEDATE}"/>
<inputText label="#{workitemmodel.labels.URL}" value="#{workitemmodel.values.URL}"/>
<textEditor label="#{workitemmodel.labels.STATUS_REPORT}"
value="#{workitemmodel.values.STATUS_REPORT}" contentType="html"/>
<panelLayout>
<action text="Submit" actionCommand="gotoconfirmpage"
actionListener="${dynamicBean.actionListener}"/>
</panelLayout>
</formLayout>
</region>

<region id="confirmation">
<panelLayout layout="vertical">
<inputText value="Task has been updated successfully." readOnly="true"/>
<action text="Return to Home" actionCommand="gotohomepage"
actionListener="${dynamicBean.actionListener}"/>
</panelLayout>
</region>

4.2.7.3 マネージドBeanでの対応するリスナーの実装方法

ステータス・コンボ・ボックスのリスナー・オブジェクト(popupMenuListener)は、HomePageBean.javaに次のように実装されます。

例4-16 マネージドBeanでのリスナーの実装

public PopupMenuListener getStatusListener()
{
if (statusListener == null)
{
statusListener = new PopupMenuListener()
{
public void popupMenuWillBecomeInvisible(PopupMenuEvent e)
{
JComboBox src = (JComboBox) e.getSource();
Object[] selected = (Object[])src.getSelectedItem();
if(selected == null)
return;

String value = (String)selected[1];
if (value != null && value.contains("Progress"))
{
_rcontext.getConnectorParams().put("navigatorpage", "D");
}
else
_rcontext.getConnectorParams().put("navigatorpage", "H");
//we just need to refresh the current page;
ViewManager vm = ViewManager.getInstance();
if(vm != null)
vm.refreshWorkItemDetailUI(_rcontext);
}
public void popupMenuCanceled(PopupMenuEvent e)
{
}
public void popupMenuWillBecomeVisible(PopupMenuEvent e)
{
}
};
}
return statusListener;
}

「Submit」ボタンのリスナー・オブジェクト(actionListener)は、DynamicRegionBeanに次のように実装されます。

例4-17 「Submit」ボタンのリスナーの実装

public ActionListener getActionListener()
{
if (actionListener == null)
{
actionListener = new ActionListener()
{
public void actionPerformed(ActionEvent event)
{
String command = event.getActionCommand();
ViewManager vm = ViewManager.getInstance();
if (command != null && command.equals("gotohomepage"))
{
_rcontext.getConnectorParams().put("navigatorpage", "H");
}
else if (command != null && command.equals("gotowelcomepage"))
{
_rcontext.getConnectorParams().put("navigatorpage", "W");
}
else if (command != null && command.equals("gotodemopage"))
{
_rcontext.getConnectorParams().put("navigatorpage", "D");
}

vm.refreshWorkItemDetailUI(_rcontext);
}
};
}

4.2.7.4 マネージドBeanを実装するためのガイドライン

すべてのマネージドBeanでAlmScopeインタフェースを実装する必要があります。Oracleチーム・プロダクティビティ・センターでは、AlmScopeを使用して、マネージドBeanを使用するUIコントロールに対するrenderingContextと対応するAlmComponentが同期化されます。

コネクタのマネージドBeanレイヤーからの情報を渡して、他のコネクタ・クラスで使用できるようにする方法は2通りあります。

- RenderingContextを使用する方法
パラメータ名と値のペアをコネクタ・セッション・レベルで含めることができます。前述の例で示したコードを確認する方法は、次のとおりです。

例4-18 コネクタ・セッション・レベルでのパラメータ名と値のペア

_rcontext.getConnectorParams().put("navigatorpage", "H");

この情報は、次に示すように、他のコネクタ・クラス内で取得できます。

例4-19 他のコネクタ・クラス内での情報の取得

Map params = (Map) session.get(WorkItemConnector.SESSION_PARAMS_KEY);

- 現在の作業アイテム・オブジェクトを使用する方法
ViewManagerクラスを使用して、現在の作業アイテム・オブジェクトにアクセスできます。

例4-20 ViewManagerクラスを使用した作業アイテムへのアクセス

public   WorkItem getCurrentWorkItem(RenderingContext rcontext);

マネージドBeanクラス内で、作業アイテムの発行値を変更できます。次に、他のコネクタ・クラスでそれを使用して、異なるフィールド値に基づいてロジックを処理できます。

ViewManager APIを使用して、作業アイテム詳細ページをリフレッシュします。

例4-21 作業アイテム詳細ページのリフレッシュ

public void refreshWorkItemDetailUI(RenderingContext rcontext);

このAPIによって、getUIRegionName()へのコールがトリガーされ、コネクタ・パラメータまたは作業アイテムのフィールド値に基づいて新規リージョン名が返されます。たとえば、サンプル・コネクタでは、パラメータを使用して新規リージョン名が返されます。

例4-22 パラメータを使用して新規リージョン名を返す方法

public String getUIRegionName(Map session, String wiType, WorkItem workItem)
throws ALMException
{
String region = "";

Map params = (Map)
session.get(WorkItemConnector.SESSION_PARAMS_KEY);
if (params != null)
{
Object val = params.get("navigatorpage");
if (val == null || val.equals("H"))
region = "Homepage";
else if (val != null && val.equals("W"))
region = "Confirmation";
else if (val != null && val.equals("D"))
region = "Demo";
}

return region;
}

4.2.7.5 tpc-config.xmlへのBeanクラスの登録

次のように、マネージドBean DynamicRegionBeanを、ファイルtpc-config.xmlに名前UIBeanで登録します。

例4-23 tpc-config.xmlへのBeanクラスの登録

<?xml version="1.0" encoding="windows-1252" ?>
<!-- TPC Configuration file -->
<tpc-config version="11.1.1.1.0" xmlns="http://fusion.oracle.com/tpc">
<managed-bean>
<name>mainBean</name>
<impl-class>oracle.sampleconnector.view.mbean.HomePageBean</impl-class>
<lifecycle>page</lifecycle>
</managed-bean>
<managed-bean>
<name>dynamicBean</name>
<impl-class>oracle.sampleconnector.view.mbean.DynamicRegionBean</impl-class>
<lifecycle>page</lifecycle>
</managed-bean>
<managed-bean>
<name>compBean</name>
<impl-class>oracle.sampleconnector.view.mbean.ComponentBean</impl-class>
<lifecycle>page</lifecycle>
</managed-bean>
</tpc-config>

4.2.8 JDeveloper内で新規エディタを開く方法

作業アイテム詳細ページで、コネクタ作成者は、クリックしたときにチーム・プロダクティビティ・センター固有の新しいエディタを開くリンクを作成できます。たとえば、Bugzillaのバグには、依存先フィールドがあり、別のバグのバグ番号を保持できます。Bugzillaのコネクタ作成者は、ラベルにリンクを作成できます。クリックすると、そのバグの詳細を示す新規エディタがJDeveloper内に開きます。

チーム・プロダクティビティ・センターでは、リソース・プロトコルとしてalmが使用され、これらのURL書式がサポートされます。

- 作業アイテム
alm:/reposName/workitemType/workitemId.wid

- チーム問合せ
alm:/reposName/workitemType/Team Queries/queryName.wiq

- ユーザー問合せ
alm:/reposName/workitemType/My Queries/queryName.wiq

- 一般ページ
alm:/path/filename.tpcx?repository=reposName&…..

一般ページの場合は、コネクタ作成者が次の処理を実行する必要があることに注意してください。

1. UIページのファイルを、コネクタ・ソース・コード・ツリーの/META-INF/pagesフォルダの下に直接格納します。これは、/META-INF/pagesがTPCフレームワークでデフォルトのDOC_HOMEとして設定されているためです。

2. repository=reposNameをパラメータとしてURLに添付します。

たとえば、サンプル・コネクタで使用されるURLはalm:/component/component.tpcx?repository=SampleConnector&component=inputDateであるため、/META-INF/pages/componentフォルダの下にcomponent.xmlファイルが存在する必要があります。

新規エディタを開く手順は、次のとおりです。

これらのURLを使用して、チーム・プロダクティビティ・センター固有のエディタを開く異なる2つの方法があります。

1. ViewManagerでOpenTPCPageInEditor () APIを使用します。

例4-24 OpenTPCPageInEditor() APIの使用

ViewManager vm = ViewManager.getInstance();
vm.OpenTPCPageInEditor("/component/component.tpcx?
repository=SampleConnector&component=inputDate");

同様に、次のコードで特定の作業アイテム・エディタを開きます。

例4-25 特定の作業アイテム・エディタを開く方法

ViewManager.getInstance().OpenTPCPageInEditor
("reposName/workitemType/workitemId.wid");

2. WebResourceタグを使用します。
例としてサンプル・コネクタを使用すると、その値の部分がリンクであるフィールド「Parent ID」があります。クリックすると、親タスクに対する作業アイテム・エディタが開きます。これを実行するには、次の手順を実行します。

- WebResourceタグを使用して、URLを生成できるフィールドをコネクタ定義ファイルに定義します。

例4-26

<RepositoryModel resName="res" resFile="/META-INF/res/modelresource.xml">
<WorkItem type="Task"
webURLHandler="oracle.sampleconnector.SampleConnectorService">
<Fields>
<Field name="PARENT_TASKID" label="${res.PARENT_TASK_ID}" type="number"
readOnly="true"/>
<Field name="TASKID" label="${res.TASK_ID}" type="number" readOnly="true"/>
<Field name="DESC" label="${res.TASK_DESC}" required="true"
maxLength="80" type="string"/>
……
<Fields/>
<WebResource>
<URLDef name="PARENT_TASKID" archorOn="label"/>
……
</WebResource>
……
<WorkItem/>
<RepositoryModel/>

属性archorOnの有効な値は、"label"および"value"です。属性値が"label"の場合は、フィールド・ラベルがハイパーリンクになります。それ以外の場合は、値がハイパーリンクとして機能します。

- WorkItemFieldFeatureインタフェースにgetURL() APIを実装します。
クラスSampleConnectorServiceによって、このインタフェースにメソッドが実装されます。getURL()メソッドによって、親タスク・フィールドのURLが作成されます。

例4-27

public URL getURL(Map session, String attrName, Object attrValue, WorkItem wi)
{
String urlString = "";
if (attrName.equalsIgnoreCase("PARENT_TASKID"))
{
Integer taskid = (Integer) attrValue;
String reposName = (String)session.get("repositoryName");
String wiType = (String)session.get("wiType");

if(reposName != null && wiType != null)
urlString = "alm:/" + reposName + "/" + wiType + "/" + taskid + ".wid";
}

try
{
return new URL(urlString);
}
catch (MalformedURLException e)
{
System.out.println(e);
}
return null;
}

- コネクタ定義ファイルで、作業アイテム・セクションを検索し、属性webURLHandlerの値としてクラス名を含めます。最初の箇条書きのサンプル・コードを参照してください。
anchorOnの値を"label"に設定している場合は、対応する作業アイテム・フィールドのUIメタデータをinputText、inputDate、ListOfValuesなどの入力フィールドに設定する必要があります。

anchorOnの値を"value"に設定している場合は、対応する作業アイテム・フィールドのUIメタデータを読取り専用のinputTextに設定する必要があります。

4.2.9 Oracleチーム・プロダクティビティ・センター・コネクタのデバッグ方法

コネクタを開発した後は、実行時にデバッガ内でそのコネクタを実行できる必要があります。この機能は、プロジェクトにすでに組み込まれています。

JDeveloperデバッガ内でコネクタを実行する手順は、次のとおりです。

- 作成/デプロイしたプロジェクトを右クリックし、「拡張機能のデバッグ」を選択します。

この結果、JDeveloperの別のコピーが起動され、そこからチーム・プロダクティビティ・センターを開いて、コネクタが定義されているOracleチーム・プロダクティビティ・センター・サーバーに接続できます。次に、Javaコードにブレークポイントを設定して、変数に対する監視ウィンドウを使用しながらコードをステップ実行し、標準のデバッグ・ユーティリティを使用できます。

4.3 Oracleチーム・プロダクティビティ・センター・コネクタ・エラーの処理

Oracleチーム・プロダクティビティ・センターで使用するためのコネクタを開発した後には、実行するタスクが多数あります。重要なタスクの1つは、コネクタの使用時に発生するエラーの処理です。Oracleチーム・プロダクティビティ・センターには、クライアントにエラーおよびメッセージを伝播する方法が2通りあります。ここでは、これらについて説明します。

開発したコネクタを使用するチーム・メンバーを支援するために、そのコネクタに関するヘルプ・ファイルを組み込むことができます。ヘルプは、JDeveloperのオンライン・ヘルプ・ブラウザまたは外部ヘルプ・ビューアに表示できます。

また、他のチーム・メンバーがダウンロードできるように、Oracleチーム・プロダクティビティ・センター・コネクタをパッケージ化する必要があります。これには、JARファイルおよびバンドル・ファイルへのコネクタの圧縮が含まれます。さらに、コネクタ用に作成したヘルプ・ファイルをJARファイルに組み込む必要があります。

Oracleチーム・プロダクティビティ・センターには、チーム・プロダクティビティ・センター・クライアントにエラーおよびメッセージを伝播する方法が2通りあります。

- インタフェース・メソッドで使用されるALMExceptionの使用

- ALMMessageFactoryへのキューイングに使用されるALMMessageの使用

コネクタ内で何か重大な事象が発生した場合は、すべてのインタフェース・メソッドでALMExceptionがスローされます。ALMExceptionのランタイム・インスタンスを使用して、適切な警告またはメッセージを配置できます。これは、クライアント・フレームワークによって、エンド・ユーザーに表示されます。

例4-28 エラー処理

try
{
connector.hasDynamicUI(session);
}
catch(ALMException e)
{
setLastError(e);
}

また、パッケージoracle.alm.common.messageで提供されているクラスを使用して、エラー・メッセージをクライアントに伝播することもできます。このパッケージには2つのクラスが定義されています。

表4-7 クラスの要約

AlmMessage

AlmMessageFactory

バックエンド・リポジトリへの接続を管理します。

AlmMessageFactoryはメッセージ登録用のクラスで、チーム・プロダクティビティ・センターを介してアクセスします。このクラスおよびAlmMessageを使用して、クライアントに報告するすべてのメッセージを、UIフレームワークを介してログに記録します。

AlmMessageFactoryは、シングルトンとして実装されます。AlmMessageFactoryを取得するには、次をコールします。

AlmMessageFactory msgFactory = AlmMessageFactory.getInstance()

メッセージを追加するには、messageIDおよび関連するメッセージ文字列を渡すことによって、AlmMessageFactory.addMessage()をコールします。

4.4 Oracleチーム・プロダクティビティ・センター・コネクタへのヘルプの追加

Oracleチーム・プロダクティビティ・センター・コネクタには、状況依存ヘルプなどのカスタム・ヘルプ・ファイルを追加できます。この結果、ユーザーは、コネクタの設定操作のヘルプに必要な情報にアクセスできます。

コネクタ固有のヘルプ・ページをコネクタのユーザーに表示する方法は2通りあります。最初の方法は、これらのヘルプ・ページをJDeveloperヘルプ・センター内に表示することです。2番目の方法は、これらのページをクライアントのデスクトップ上の独自フレームまたはWebブラウザに表示することです。

拡張ヘルプは、チーム・プロダクティビティ・センター・コネクタなどのJDeveloper拡張機能に対するヘルプの作成者が、ヘルプ拡張機能の開発に関するトピック内で使用できます。

4.4.1 チーム・プロダクティビティ・センター・コネクタへのヘルプの追加方法

コネクタ固有のヘルプを作成し、ユーザーが参照するJDeveloperヘルプ・センター内に表示できます。JDeveloperヘルプをJDeveloperヘルプ拡張機能として実装した場合、ユーザーは、コネクタでダイアログを表示している間に[F1]キーを押すことによって、このヘルプにアクセスできます。

チーム・プロダクティビティ・センター・コネクタに対するヘルプを組み込む手順は、次のとおりです。

1. JDeveloperで表示される各ページに対するF1ヘルプ・ファイルをHTML形式で提供します。これらは、フォルダ/Helpのパッケージ化されたコネクタJARファイル内に格納する必要があります。

2. これらのヘルプ・ファイルのみを含む新しいJDeveloper拡張機能を作成します。

3. コネクタのヘルプIDをコネクタUI定義XMLファイルに追加します。

例4-29 コネクタのヘルプID

<region name=”Edit” helpTopicId="f1_connector_htm" >
<formLayout value="${workitemmodel}"
columns="2"
blockSize="6"
id="wiFormId"
rowToSpan="1"/>
</region>

4.4.2 チーム・プロダクティビティ・センター・コネクタのヘルプを外部ビューアで表示する方法

コネクタに対するヘルプは、ユーザーのデフォルトのWebブラウザまたはPDFビューアなどの外部ビューアに表示できます。

コネクタのヘルプを外部ビューアで表示する手順は、次のとおりです。

1. 表示される各ページに対するF1ヘルプ・ファイルをHTML形式で提供します。これらは、/Helpというフォルダのパッケージ化されたコネクタJARファイル内に格納する必要があります。

2. これらのヘルプ・ファイルのみを含む新しいJDeveloper拡張機能を作成します。

3. 作業アイテム詳細UIに「Help」ボタンを追加します。これを実行するには、コネクタUI定義XMLファイルにツールバーを追加し、このツールバー上に1つのヘルプ・ボタンを追加します。

例4-30 ツールバーへの「Help」ボタンの追加

<region name=”Edit”>
<toolbar title="Actions">
<action text="Help"
actionCommand="showHelp"
icon="HELP"
actionListener="${showHelp}"/>
<toolbar/>
<formLayout value="${workitemmodel}"
columns="2"
blockSize="6"
id="wiFormId"
rowToSpan="1"/>
</region>

4. リスナー・オブジェクト・クラスを実装します。

4.5 コネクタのパッケージ化

Oracleチーム・プロダクティビティ・センター・コネクタの準備の最終フェーズは、JDeveloper拡張機能としてインストールするために、コネクタをJARファイルにパッケージ化することです。この結果、チーム・プロダクティビティ・センター・サーバーにコネクタをインストールでき、このコネクタが適用されるリポジトリにチーム・メンバーが接続できるようになります。

4.5.1 コネクタのパッケージ化方法

コネクタをサーバーにインストールして、拡張機能としてJDeveloperにインストールできるようにするには、正しくパッケージ化する必要があります。パッケージ化には、3つの部分があります。

1. コネクタとそれに必要なファイルをすべて含むJARファイル。

2. ヘルプ・ファイルとそれに必要なファイルを含む個別のJARファイル。

3. 前述の2つのJARファイルと、これをJDeveloperで拡張機能としてインストールできる方法を説明するためのbundle.xmlファイルを含むZIP形式のバンドル。

プロジェクト内にデプロイメント・プロファイルを作成すると、これらのファイルをすべて生成できます。

デプロイメント・プロファイルを作成する前に、プロジェクトを正常に作成していること、およびすべての出力ファイルが正しいディレクトリに作成されていることを確認してください。

4.5.2 コネクタJARファイルの生成方法

コネクタJARファイルには、コネクタ専用の拡張機能に組み込まれる、コネクタのすべてのコンポーネントが含まれます。

コネクタJARファイルを生成する手順は、次のとおりです。

1. アプリケーション・ナビゲータでプロジェクトをダブルクリックし、「プロジェクト・プロパティ」→「デプロイメント」の順に選択します。

2. 「新規」をクリックします。

3. アーカイブ・タイプとして「JARファイル」を選択し、JARファイルの名前を入力します。通常、これはConnector<your connector name>.JARです。

4. 「JARデプロイメント・プロファイルのプロパティの編集」ダイアログで、「フィルタ」を選択します。META-INFディレクトリ内のすべてのファイル(この後すぐに定義されるBundle.xmlを除く)およびパッケージ・ディレクトリ内のすべてのファイルを選択します。

5. 「OK」をクリックします。

コネクタJARデプロイメントをテストするには、プロジェクトを右クリックし、「デプロイ」→「<your deploy profile>」→「JARファイルへ」の順に選択します。

4.5.3 コネクタのヘルプJARファイルの生成方法

ヘルプJARファイルには、コネクタ拡張機能にヘルプを組み込むために必要なすべてのものが含まれます。JDeveloper拡張機能ツールには、コネクタのヘルプJARファイルを生成するための統合プロセスが用意されています。

コネクタのヘルプJARファイルを生成する手順は、次のとおりです。

1. アプリケーション・ナビゲータでプロジェクトをダブルクリックし、「プロジェクト・プロパティ」→「デプロイメント」の順に選択します。

2. 「新規」をクリックします。

3. アーカイブ・タイプとして「JARファイル」を選択し、ヘルプJARファイルの名前を入力します。通常、これはConnector<your connector name>Help.JARです。

4. 「JARデプロイメント・プロファイルのプロパティの編集」ダイアログで、「フィルタ」を選択します。すべてのヘルプ関連ファイルまたはそれらが格納されているディレクトリを選択します。他のすべてのファイルの選択を解除します。

5. 「OK」をクリックします。

コネクタJARデプロイメントをテストするには、プロジェクトを右クリックし、「デプロイ」→「<your help deploy profile>」→「JARファイルへ」の順に選択します。

4.5.4 コネクタ・バンドル・ファイルの生成方法

コネクタJARファイルが作成されると、バンドル・ファイルを生成することによってそれをデプロイする準備ができます。これは、コネクタ拡張機能のインストールに使用できるZIPファイルです。

コネクタ・バンドル・ファイルを生成する手順は、次のとおりです。

1. プロジェクトをダブルクリックし、「プロジェクト・プロパティ」→「デプロイメント」の順に選択します。

2. 「新規」をクリックします。

3. アーカイブ・タイプとして「JARファイル」を選択します。

4. manifestを含めるの選択を解除します。

5. バンドルZIPファイルの名前を入力します。
これは通常、「デプロイ」フォルダと同じレベルにある「バンドル」フォルダ内にあり、Connector<your connector name>Bundle.ZIPという名前になります。必ず、.JARではなく.ZIPという名前にしてください。

6. 「JARデプロイメント・プロファイルのプロパティの編集」ダイアログで、「プロジェクトの出力」ノードを展開し、「フィルタ」を選択します。

7. このファイル・グループの名前を「JAR Output」に変更します。「アーカイブのターゲット・ディレクトリ」をoracle.teamproductivitycenter/connectors/<your connector name>に変更します。末尾に.JARを指定しないでください。これは、このファイルの解凍先となるZIPファイル内のパスです。

注意:

インストーラでは大/小文字が区別されるため、ファイル・パスの大/小文字が正しいことを確認してください。

8. 「JAR Output」ファイル・グループの下の「コントリビュータ」ノードに移動します。「追加」をクリックし、コネクタJARファイルおよびヘルプJARファイルが生成される場所を追加します。

9. 「JAR Output」ファイル・グループの下の「フィルタ」ノードに移動します。すでに生成したコネクタJARファイルおよびコネクタのヘルプJARファイルを選択します。

10. 「ファイル・グループ」ノードを選択し、「新規」をクリックします。「Bundle Output」という新しいファイル・グループを作成します。

11. 「Bundle Output」ファイル・グループの下の「フィルタ」に移動し、bundle.xmlファイルを除いてすべての選択を解除します。「アーカイブのターゲット・ディレクトリ」編集ボックスが空白であることを確認してください。

12. 「プロファイルの依存性」ノードに移動し、依存性としてコネクタおよびヘルプのデプロイ・プロファイルを追加します。

13. 「OK」をクリックします。

コネクタ・バンドルZIPデプロイメントをテストするには、プロジェクトを右クリックし、「デプロイ」→「<your bundle profile>」→「JARファイルへ」の順に選択します。この結果、コネクタJAR、ヘルプJARおよびbundle.xmlファイルを含む新しいZIPファイルが作成されます。

4.5.5 コネクタ・バンドル・ファイルの依存性の定義方法

bundle.xmlファイルには、拡張機能の内容およびその依存性の内容が記述されます。また、バージョン情報および作成者に関する情報も格納されます。

例4-31 コネクタ・バンドル・ファイルbundle.xml

<update-bundle version="1.0"
xmlns="http://xmlns.oracle.com/jdeveloper/updatebundle"
xmlns:u="http://xmlns.oracle.com/jdeveloper/update">

<u:update id="oracle.teamproductivitycenter.sampleconnector">
<u:name>Oracle Sample Connector</u:name>
<u:version>1.0</u:version>
<u:author>Oracle Corporation</u:author>
<u:author-url>http://www.oracle.com</u:author-url>

<u:description>
Sample connector for Oracle Team Productivity Center
</u:description>

<u:requirements>
<u:requires-extension id="oracle.jdeveloper"
minVersion="11.1.1.1.00"
maxVersion="11.1.1.1.99" />
<u:requires-extension id="oracle.teamproductivitycenter"
minVersion="11.1.1.1.00"
maxVersion="11.1.1.1.99" />
</u:requirements>
</u:update>
</update-bundle>

すべてのチーム・プロダクティビティ・センター・コネクタには、JDeveloperとチーム・プロダクティビティ・センター両方に対する依存性があります。これらは必ず含まれている必要があります。

4.6 チーム・プロダクティビティ・センター・コネクタの国際化

Oracleチーム・プロダクティビティ・センターでは、実行中のJDeveloperロケール基づいた、コネクタによる適切なUIの表示がサポートされています。作業アイテムUIおよびモデル定義XMLファイルに表示されるように、ローカライズ文字列の格納にリソース・ファイルを使用できます。たとえば、JDeveloperがJPNロケールで実行されている場合、ユーザーは同じロケールでコネクタ詳細ページを表示できます。これをサポートするために、言語固有のリソース・バンドル・ファイルを作成できます。例4-32は、modelresource.xmlの例です。

例4-32 国際化ファイルmodelresource.xml

<?xml version="1.0" encoding="ISO8859-1" ?>
<resources xmlns="http://xmlns.oracle.com/bali/rts/tpc" package="company.bugzilla.res">
<resource key="MSG_SAVEBUG_TITLE">BugDB: Save A Bug</resource>
<resource key="MSG_NEWBUG_TITLE">BugDB: Create A Bug</resource>
<resource key="MSG_BUGAPI_ERROR">Bug API Error: </resource>
<resource key="DESCRIPTION">Description</resource>
<resource key="BUG_NAME">Bug </resource>
<resource key="BUG_NO">Bug Number</resource>
<resource key="BUG_BASEBUG_NO">Base Bug No</resource>
<resource key="BUG_STATUS">Status</resource>
<resource key="BUG_SUBJECT">Subject</resource>
<resource key="BUG_PRODUCT">Product</resource>
<resource key="BUG_PRIORITY">Severity</resource>
<resource key="BUG_COMPONENT">Component</resource>
<resource key="BUG_SUBCOMPONENT">Sub Component</resource>
<resource key="BUG_ASSIGNEE">Assigned</resource>
</resources>

次は、ファイルuiresource.xmlの例です。

例4-33 国際化ファイルuiresource.xml

<?xml version="1.0" encoding="ISO8859-1" ?>
<resources xmlns="http://xmlns.oracle.com/bali/rts/tpc"
package="company.bugzilla.res">
<resource key="COMMMENTS">Comments</resource>
<resource key="ADD_COMMENTS">Add Comments</resource>
<resource key="UPDATE_COMMENTS">Update Comments</resource>
</resources>

JDeveloperが日本語で実行されている場合は、フレームワークによってmodelresource_jp.xmlおよびuiresource_jp.xmlというリソース・バンドル・ファイルが検索され、日本語のラベルが検出されて表示されます。これらのファイルを作成し、中央の場所に格納できます。これらのリソース・バンドル・ファイルを、フォルダMETA_INF\resの下のコネクタjarファイルに格納します。

Copyright © 2011, 2013, Oracle and/or its affiliates. All rights reserved.