レポートのローカライズのカスタマイズ

Windchill Business Reporting (WBR) ソリューションでは、Windchill と Cognos オブジェクトが使用されます。データソースオブジェクトとレポートオブジェクトの両方に、ローカライズ可能なテキストが含まれています。これらのオブジェクトのテキストをローカライズすることによって、テキストをクライアントのロケールで表示できます。

このマニュアルは、Windchill Business Reporting (WBR) ソリューション (つまり、Cognos) が正常にインストールおよび設定されていることを前提としています。Windchill のインスタンス名は <WindchillInstanceName> です。Cognos のルート URL は <WBR_ホーム_URL> です。通常、WBR ソリューションが <WBR_ホスト> にインストールされている場合、<WBR_ホーム_URL> は http://<WBR_ホスト>/cognos8/cgi-bin/cognos.cgi になります。<WBR_ホーム_URL> にログインでき、Windchill データソースオブジェクトを表示してレポートを作成する Cognos 権限があることを前提とします。

WBR 統合では、レポートメタモデルを更新するためのアクセス権限も必要です。このマニュアルでは、WBR システムで使用されるテキストを外部化するために、標準の Java リソースバンドルを使用する手順について説明します。ローカライズされたテキストをサポートするには、言語固有のリソースバンドルを作成し、テキストを適切な言語に翻訳する必要があります。複数の言語のサポートが必要で、サポート対象の言語にテキストを翻訳できることを前提とします。このマニュアルで言及されているテキスト要素は、レポート名、パラメータ、および列で構成されています。WBR レポートに表示される実際のデータは、データソースから返されます。このデータのローカライズについては、このマニュアルでは説明しません。

エレメント	タイプ	説明
<マイタスク>	Info*Engine タスク	Windchill データを読み込み、操作するための Info*Engine タスク。
<マイタスクリソース>	リソースバンドル情報プロパティファイル	Info*Engine タスクのテキストアイテムをローカライズするために使用されるリソースバンドル情報ファイル。
<マイレポートテンプレート> Windchill ReportTemplate	Windchill オブジェクト	Windchill データを取得するための照会を指定する Windchill オブジェクト。
<マイレポートテンプレートリソース>	リソースバンドル情報プロパティファイル	ReportTemplate のテキストアイテムをローカライズするために使用されるリソースバンドル情報ファイル。
<マイレポート> WindchillReport	Windchill オブジェクト	Windchill ユーザーインタフェースでエンドユーザーに表示される Windchill オブジェクト。対応する Cognos レポートオブジェクトのプロキシとして機能します。
<マイレポートリソース>	リソースバンドル情報プロパティファイル	レポートのテキストアイテムをローカライズするために使用されるリソースバンドル情報ファイル。
<マイ Cognos レポート> Cognos レポート	Cognos オブジェクト	照会の定義を含んでおり、表示のフォーマットを指定する、レポート用の Cognos オブジェクト。
<マイ Cognos レポートリソース>	リソースバンドル情報プロパティファイル	Cognos レポートの静的テキストをローカライズするために使用されるリソースバンドル情報ファイル。

1. ファイル <Windchill_ホーム>/src/<マイパッケージ>/<マイタスクリソース>.rbInfo を作成します。タスクメソッド名、パラメータ名、および列名として、必要に応じてエントリを追加します。言語固有のバージョンの <マイタスクリソース>.rbInfo を作成し、関連する Java ソースおよびコンパイル済みクラスファイルを生成します。

3. ローカライズされたテキストを組み込む Cognos モデルを更新します。インストールされている Windchill ショートカットから JConsole を起動します。PTC 組み込みサーブレットエンジン (Tomcat ベース) の JVM インスタンスに接続します。「MBeans」タブで「com.ptc」 > 「Monitors」 > 「ReportingSystem」の順に選択して、レポート管理ビーンを選択します。「Operations」タブで「updateModel」をクリックします。

1. ファイル <Windchill_ホーム>/src/<マイパッケージ>/<マイレポートテンプレートリソース>.rbInfo を作成します。タスクメソッド名、パラメータ名、および列名として、必要に応じてエントリを追加します。言語固有のバージョンの <マイレポートテンプレートリソース>.rbInfo を作成し、関連する Java ソースおよびコンパイル済みクラスファイルを生成します。

2. <マイレポートテンプレート> を更新して、リソースバンドルを指定します。Windchill の「サイト」 > 「ユーティリティ」に移動し、「レポート管理」ユーティリティを起動します。「レポート管理」の UI で <MyReportTemplate> を選択し、「更新」をクリックして、照会ビルダーを起動します。「レポート」 > 「プロパティ」メニューアイテムを選択し、「リソースバンドル」テキストフィールドに「<MyPackage>.<MyReportTemplateResource>」と入力します。「OK」をクリックして変更内容を保存します。

1. ファイル <Windchill_ホーム>/src/<マイパッケージ>/<マイレポート>.rbInfo を作成します。レポートオブジェクト名のエントリを追加します。言語固有のバージョンの <マイレポートリソース>.rbInfo を作成し、関連する Java ソースおよびコンパイル済みクラスファイルを生成します。

2. <マイレポート> を更新して、リソースバンドルを指定します。Windchill の「サイト」 > 「レポート」ページに移動し、<マイレポート> に対して「編集」操作を選択します。「リソースバンドル」テキストフィールドに「<マイパッケージ>.<マイレポートリソース>」と入力し、「OK」をクリックします。

1. Cognos メタモデルがローカライズされた後 (「手順 - Info*Engine タスクデータソースのローカライズ」および「手順 - ReportTemplate データソースのローカライズ」を参照)、レポートの名前、パラメータ、および列をローカライズするために必要なステップは 1 つのみです。Report Studio のロケールを、レポートを作成する前にローカライズされたレポートを表示する対象のロケールに設定する必要があります。

前述の「手順 - Cognos レポートのローカライズ」の後に、すべてのレポートパラメータ名および列名が、データソースのメタモデル情報に基づいて自動的にローカライズされます。バナーやラベルなど、レポートに追加されたその他のテキストは、自動的にローカライズされません。Windchill のユーティリティを使用して、これを行うことができます。

2. <マイ Cognos レポート> に基づいて、ファイル <Windchill_ホーム>/loadFiles/cognosReports/custom/<マイ Cognos レポート XML>.xml を作成します。Cognos Report Studio のメニューで「Tools」 > 「Copy Report to Clipboard」の順に選択して、XML 定義をシステムのクリップボードにコピーします。次に、クリップボードの内容をテキストエディタに貼り付けて、ファイルに保存します。

7. Cognos でレポートを確認します。「Public Folders」 > 「Windchill」フォルダを再表示すると、<マイ Cognos レポート> オブジェクトのリストが表示されます。「Run with options...」操作を使用してレポートを実行します。別のクライアントロケールを設定して、静的テキストが適切に翻訳されていることを確認してください。

Cognos レポートをローカライズするには、Report Studio のロケールを、レポートを作成する前に「en_ZW」に設定する必要があります。Cognos レポートでは、Report Studio のロケールに基づいて、ローカライズされたデータソースおよび列名が参照されます。このロケールのデータソースおよび列名を変更すると、別のロケールで翻訳済みテキストを検索できなくなります。正式な次善策として、特別なロケールでは不揮発性の名前を使用してください。ここで特別なロケールは「en_ZW」です。