Oracle® Fusion Middleware

Oracle WebCenterアプリケーション・アダプタの管理

11g リリース1 (11.1.1)

B72423-02(原本部品番号:E17953-04)

2013年7月

Oracle E-Business Suite、Oracle PeopleSoftおよびその他のビジネス・アプリケーションに対応するOracle WebCenterアプリケーション・アダプタを使用した、イメージングおよび管理対象添付ファイル・ソリューションの構成方法について説明する管理者用のドキュメントです。

Oracle Fusion Middleware Oracle WebCenterアプリケーション・アダプタの管理, 11gリリース1 (11.1.1)

B72423-02

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

原本著者: Sarah Howland

原本協力者:  Oracle WebCenterの開発、製品管理および品質保証チーム

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

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

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

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

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

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

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

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

目次

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

はじめに

- 対象読者

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

- 関連ドキュメント

- 表記規則

このガイドで説明する新機能

- 11gリリース1 (11.1.1.8)の新機能と変更された機能

- 11gリリース1 (11.1.1.7)の新機能と変更された機能

- 11gリリース1 (11.1.1.6)の新機能と変更された機能

1 アプリケーション・アダプタ・ソリューションの概要

- 1.1 Application Extension Framework (AXF)について

- 1.2 BPMイメージング・ソリューションについて

- 1.2.1 ビジネス・ユーザーから見たBPMイメージング・ソリューション

- 1.2.1.1 イメージングのシナリオ1: 売上見積りの入力

- 1.2.2 ビジネス層アジリティ管理者ロールについて

- 1.2.3 BPMイメージング・ソリューションで使用されるAXFコマンドについて

- 1.2.4 BPMイメージング・ユーザー・インタフェース・コンポーネントについて

- 1.2.4.1 ソリューション・ワークスペースについて

- 1.2.4.2 ソリューション・アプリケーションについて

- 1.3 BPELイメージング・ソリューションについて

- 1.3.1 ビジネス・ユーザーから見たBPELイメージング・ソリューション

- 1.3.1.1 イメージングのシナリオ1: 請求書の処理

- 1.3.1.2 イメージングのシナリオ2: 従業員サポート・ドキュメントの取込み

- 1.3.1.3 イメージングのシナリオ3: 従業員サポート・ドキュメントの表示

- 1.3.2 BPELイメージング・ソリューションで使用されるAXFコマンドについて

- 1.3.3 BPELイメージング・ユーザー・インタフェース・コンポーネントについて

- 1.3.3.1 タスク・リストについて

- 1.3.3.2 タスク・ビューアについて

- 1.3.3.3 列挙ピッカーについて

- 1.3.3.4 アイデンティティ・ピッカーについて

- 1.3.3.5 コメントについて

- 1.4 管理対象添付ファイル・ソリューションについて

- 1.4.1 ビジネス・ユーザーから見た管理対象添付ファイル・ソリューション

- 1.4.1.1 添付ファイル・シナリオ1: アイデンティティ・ドキュメントの取込み

- 1.4.1.2 添付ファイル・シナリオ2: アイデンティティ・ドキュメントの表示および編集

- 1.4.2 添付ファイル・ソリューションで使用されるAXFコマンドおよびサービスについて

- 1.5 アダプタ・コンポーネントについて

- 1.5.1 ビジネス・アプリケーション・プラグイン

- 1.5.2 AXFインフラストラクチャ

- 1.5.2.1 ソリューション・メディエータ

- 1.5.2.2 AXFリクエスト/レスポンス

- 1.5.2.3 コマンド・メディエータ

- 1.5.2.4 AXFコマンド

- 1.5.2.5 対話

- 1.5.3 AXFユーザー・インタフェース・コンポーネント

- 1.5.4 コンテンツ・サーバー・コンポーネント(管理対象添付ファイル)

- 1.5.5 AXFソリューション・アクセラレータ

- 1.6 アダプタのセキュリティと認証について

- 1.7 アダプタのシステム要件

- 1.7.1 Oracle E-Business Suite

- 1.7.2 Oracle PeopleSoft Enterprise

- 1.7.3 SOA 11g(イメージング・ソリューションの場合のみ)

- 1.7.4 Oracle BPM Suite (BPMイメージング・ソリューションの場合のみ)

- 1.7.5 管理対象添付ファイルの追加要件

- 1.8 アダプタの構成ロードマップ

2 Oracle E-Business Suiteプラグインの構成

- 2.1 Oracle E-Business Suiteデータベースの構成

- 2.1.1 AXF用Oracle E-Business Suite構成スキーマ・ユーザー(AXF)の作成

- 2.1.2 提供されているPL/SQLプロシージャ

- 2.1.3 PL/SQLスクリプトの実行

- 2.2 Oracle E-Business Suite Formsのコンパイル

- 2.2.1 コマンドラインを使用したAXF_CUSTOM.pllのコンパイル

- 2.3 パーソナライズによるOracle Application Framework (OAF)ページの構成

- 2.3.1 Javaファイルのコンパイル、クラス・ファイルのコピーおよびXMLファイルのインポート

- 2.3.2 管理対象添付ファイルを追加するためのOAFページのパーソナライズ

- 2.3.3 OAFページのその他のサービスの構成(オプション)

- 2.4 Oracle E-Business Suiteのアダプタ通信の保護

- 2.4.1 SOAPセキュリティを使用した通信の保護

- 2.4.2 SSLを使用した通信の保護(Oracle E-Business Suite)

- 2.4.2.1 Oracle Walletの構成

- 2.4.2.2 SSLの統合の構成

- 2.5 Oracle E-Business Suiteロギングの構成

- 2.5.1 Formsアプリケーションのロギングの構成

- 2.5.2 OAFアプリケーションのロギングの構成

- 2.6 ユーザー・ロケールの設定

- 2.7 Oracle E-Business Suiteのソリューションの構成

- 2.8 Oracle E-Business SuiteからのAXFのアンインストール

- 2.8.1 Oracle E-Business Suite Formsからのアンインストール

- 2.8.2 Oracle E-Business Suite OAFからのアンインストール

3 Oracle PeopleSoftプラグインの構成

- 3.1 Oracle PeopleSoftプロジェクトのインポート

- 3.2 Oracle PeopleSoftのアダプタ通信の構成および保護

- 3.2.1 SSLを使用した通信の保護(Oracle PeopleSoft)

- 3.2.2 AXFと通信するためのIntegration Brokerの構成

- 3.2.2.1 11g AXFサーバーとの通信の構成

- 3.2.2.2 10g AXFサーバーとの通信の構成

- 3.2.2.3 ゲートウェイ・パスワードの暗号化

- 3.2.2.4 サービス操作ルーティングの設定

- 3.2.2.5 ドメイン・ステータスの確認

- 3.2.3 Oracle PeopleSoftユーザーのAXFアクセスの構成

- 3.2.3.1 Oracle PeopleSoftユーザーのAXF_ROLEの確認

- 3.2.3.2 ユーザーへのAXF_ROLEの割当て

- 3.3 Oracle PeopleSoftページへのAXFコンポーネントの配置

- 3.4 Oracle PeopleSoftロギングの構成

- 3.5 Oracle PeopleSoftのソリューションの構成

- 3.6 Oracle PeopleSoftからのAXFのアンインストール

4 AXF設定の構成

- 4.1 ロギングの構成

- 4.1.1 BPM用AXFのロギングの構成

- 4.1.1.1 詳細構成

- 4.1.1.2 DMSロギングの構成

- 4.1.2 BPEL用AXFのロギングの構成

- 4.1.2.1 Enterprise Managerの使用

- 4.1.2.2 Application Serverの使用

- 4.2 Coherenceの構成

5 BPMイメージング・ソリューションの構成

- 5.1 ソリューション・アプリケーション管理について

- 5.1.1 動的ページ・テンプレートおよびページ・コンポーネントについて

- 5.1.1.1 アクション・コントロールについて

- 5.1.1.2 「ステータスの更新」アイコンについて

- 5.1.1.3 動的タブについて

- 5.1.1.4 ページ・コンポーネントについて

- 5.1.2 ビジネス・ルールおよびディクショナリについて

- 5.1.2.1 ディクショナリの編集について

- 5.1.2.2 ルールセットおよびバケットセット

- 5.1.2.3 入力について

- 5.1.3 機能ブロックについて

- 5.1.4 コントロール・ページについて

- 5.1.4.1 データ・コントロール・ページについて

- 5.1.4.2 「アイデンティティ・ブラウザ」コントロール・ページについて

- 5.1.4.3 「コメント」コントロール・ページについて

- 5.1.5 プロンプトおよび検証について

- 5.1.6 パッケージについて

- 5.1.7 コンテキストについて

- 5.1.8 データ・フィールド、テーブルおよび参照について

- 5.1.8.1 データ・フィールドについて

- 5.1.8.2 表について

- 5.1.8.3 参照について

- 5.1.9 ビジネス・ルール変更の無効化または破棄について

- 5.2 ソリューション・アプリケーションの構成に関するスタート・ガイド

- 5.2.1 BPMイメージング・ソリューションの実行または適用

- 5.2.2 ソリューション管理の起動

- 5.2.3 「コマンド・ドライバ」ページからのユーザーとしてのソリューションのテスト

- 5.2.3.1 コマンド・エグゼキュータの使用

- 5.2.4 HelloBPMソリューションで使用するタスクの挿入

- 5.2.5 ビジネス・ルールの管理

- 5.2.6 コンテキストの管理

- 5.2.6.1 コンテキストの作成

- 5.2.6.2 コンテキストの更新

- 5.2.6.3 コンテキストの削除

- 5.2.7 ディクショナリのカスタム・ルールの製品設定へのリセット

- 5.3 HelloBPMソリューションについて

- 5.3.1 HelloBPMソリューションとは

- 5.3.2 HelloBPM営業見積システムの概要

- 5.3.3 HelloBPMユーザー・ロールおよびワークフロー

- 5.3.4 HelloBPMソリューションでのコンテキストの使用方法

- 5.3.5 営業見積入力コンテキストのビジネス・ルール

- 5.3.5.1 SalesQuoteEntryコンテキストのアクション・ルールセット

- 5.3.5.2 SalesQuoteEntryコンテキストのデータ・ルールセット

- 5.3.5.3 SalesQuoteEntryコンテキストのDynamicTabルールセット

- 5.3.5.4 SalesQuoteEntry_AccountManagerReasonコンテキストのデータ・ルールセット

- 5.3.5.5 SalesQuoteEntry_ProductItemコンテキストの表ルールセット

- 5.3.5.6 SalesQuoteEntry_LicenseTermコンテキストの表ルールセット

- 5.3.6 ベース・コンテキストのビジネス・ルール

- 5.3.6.1 ベース・コンテキストのFunctionalBlockルールセット

- 5.3.6.2 ベース・コンテキストのLookupAndValidatorルールセット

- 5.4 HelloBPMソリューションのユースケース

- 5.4.1 ユースケース: アクション・リンクの追加および構成

- 5.4.2 ユースケース: データ・コントロール・ページへの移動

- 5.4.3 ユースケース: 新規コンテキストの追加

- 5.4.4 ユースケース: 新規セクションへのデータ・フィールドの追加

- 5.4.5 ユースケース: データ・フィールドの背景色の設定

- 5.4.6 ユースケース: データ・アイテムまたはセクションの表示順序の変更

- 5.4.7 ユースケース: 折りたたまれた初期表示へのセクションの設定

- 5.4.8 ユースケース: すべての表の行ボタンの非表示

- 5.4.9 ユースケース: 静的参照の構成表示

- 5.4.10 ユースケース: 動的参照の構成表示

- 5.5 BPMビューの構成

- 5.6 Oracle Fusion Middleware Controlを使用したBPMのAXF管理

- 5.6.1 BPMのAXFライブラリおよびアプリケーションの再デプロイ

- 5.6.2 ビジネス・ルールの変更の一時取消し

- 5.6.3 BPMのAXFテスト環境から本番環境への移行

6 BPELイメージング・ソリューションの構成

- 6.1 BPEL接続の構成

- 6.1.1 CSF資格証明別名の作成

- 6.1.2 Imaging接続での接続の作成

- 6.1.3 AXF_SOLUTION_ATTRIBUTES表での接続の参照

- 6.2 AXF表の構成またはソリューション・アクセラレータの適用

- 6.3 AXFドライバ・ページの使用による機能のテスト

- 6.4 イメージング・ソリューションのオプションの構成

- 6.4.1 Imagingビューアの自動ログインの構成

- 6.4.2 Oracle WebLogic Server/ビジネス・アプリケーション・ユーザーへのタスクの実行の許可

- 6.4.3 Imaging管理対象サーバーにおけるAXFのためのクラスタ化の構成

- 6.4.4 自動タスク・ロックの構成

- 6.4.5 XPATHの使用によるタスク・ペイロードの更新

- 6.4.5.1 タスク・ペイロードを更新するPL/SQLプロシージャの例

- 6.4.6 複数のウィンドウ・インスタンスの表示による単一の対話のターゲット設定

- 6.4.7 検証の追加

- 6.4.8 カスタム・コマンドのデプロイ

- 6.4.9 連鎖コマンドとユーザー・インタフェース・コンポーネントの構成

- 6.4.10 動的データ表の構成または無効化

- 6.4.10 動的データ表の構成または無効化

- 6.4.10.2 「タスク・ビューア」の「下部パネル」の非表示

- 6.4.11 紙クリップ添付ファイルの再有効化(Oracle E-Business SuiteおよびImagingのみ)

- 6.4.12 Oracle PeopleSoftポップアップ・ソリューション・ウィンドウのサイズ変更

7 管理対象添付ファイル・ソリューションの構成

- 7.1 管理対象添付ファイル・ソリューションのシステム要件

- 7.1 管理対象添付ファイル・ソリューションのシステム要件

- 7.1 管理対象添付ファイル・ソリューションのシステム要件

- 7.2.2 Oracle E-Business Suite Formsアプリケーションのための管理対象添付ファイルの有効化

- 7.2.3 Oracle E-Business Suite OAFアプリケーションのための管理対象添付ファイルの有効化

- 7.2.3.1 サンプル・キー値があるOAF AXFデータベース表の移入

- 7.2.3.2 OAFページのためのキー値の識別

- 7.2.4 Oracle PeopleSoftのための管理対象添付ファイルの有効化

- 7.3 コンテンツ・サーバー・コンポーネントの構成

- 7.3.1 コンテンツ・サーバー・コンポーネントの有効化

- 7.3.1.1 アップグレード前のカスタマイズのバックアップ

- 7.3.2 必要なコンテンツ・サーバー・コンポーネントおよび構成の確認

- 7.3.3 管理対象添付ファイル・ソリューションのテスト

- 7.4 Enterprise Application Adapter Frameworkの構成

- 7.4.1 コンテンツ・サーバーでのAppAdapterUniversalコンポーネントのデプロイ

- 7.4.1.1 任意でのコンポーネント・ファイルの名前変更

- 7.4.1.2 任意でのフレームワーク・レイアウト、イメージおよびプロファイルのカスタマイズ

- 7.4.2 SOAPサービス・コールおよび管理対象添付ファイルURL表示の構成

- 7.4.2.1 SSLを介した通信の保護(他のビジネス・アプリケーション)

- 7.5 管理対象添付ファイルの設定の構成

- 7.5.1 グローバル構成変数での作業

- 7.5.2 代替方法としてのPreferences.hdaファイル内の設定の編集

- 7.6 管理対象添付ファイル・ソリューションのカスタマイズ

- 7.6.1 ユーザーの割当て済ロールに基づいた設定のカスタマイズ

- 7.6.2 ユーザーのビジネス・コンテキストに基づいた設定のカスタマイズ

- 7.6.3 ビジネス・エンティティまたはアプリケーション・レベルでの設定のカスタマイズ

- 7.6.4 新しい添付ファイルのために使用されるドキュメント・タイプのカスタマイズ

- 7.6.5 使用されるコンテンツ・サーバー・プロファイルのカスタマイズ

- 7.6.5.1 プロファイルのグローバルな変更

- 7.6.5.2 特定のビジネス・エンティティまたはアプリケーションのためのプロファイルの指定

- 7.6.6 管理対象添付ファイル・ページのボタンの非表示または表示

- 7.6.7 スキャンのカスタマイズ

- 7.6.7.1 スキャンの有効化または無効化

- 7.6.7.2 ビジネス・エンティティのための代替スキャン・プロファイルの構成

- 7.6.7.3 使用されるドキュメント分類の変更

- 7.6.8 管理対象添付ファイル・ページのイメージのカスタマイズ

- 7.6.9 使用されるスタイル・シート(CSS)のカスタマイズ

- 7.6.10 添付リレーションシップ属性の構成

- 7.6.11 リビジョン固有モードの構成

- 7.6.12 結果数の変更

- 7.6.13 結果テンプレートの変更

- 7.6.14 デフォルト列の設定

- 7.6.15 添付ファイルでの紙クリップの有効化(Oracle E-Business Suite Formsのみ)

- 7.6.16 ビジネス・アプリケーションからコンテンツ・サーバーへの追加のメタデータ値の引渡し

- 7.6.16.1 Enterprise Application Adapter Frameworkを介した値の引渡し

- 7.6.17 Oracle PeopleSoftポップアップ・ソリューション・ウィンドウのサイズ変更

- 7.6.18 エンティティのプライベート添付ファイル・セキュリティ・グループの構成

- 7.6.19 管理対象添付ファイルのためのビジネス・アプリケーション・ユーザーのパス・スルーの復元

- 7.6.20 OAFエンティティのための管理対象添付ファイル・ボタンの名前変更

- 7.7 認証およびセキュリティの構成

- 7.7.1 管理対象添付ファイルのためのCSF資格証明の構成

- 7.7.1.1 Enterprise Managerの使用による資格証明の作成

- 7.7.1.2 WLSTの使用による資格証明の作成

- 7.7.2 ユーザー認証の構成

- 7.7.3 ドキュメント・セキュリティの構成

- 7.7.4 AXFとコンテンツ・サーバーの間の通信の保護

- 7.7.4.1 コンテンツ・サーバーのSystem Propertiesアプリケーションの使用

- 7.7.4.2 コンテンツ・サーバーのConfig.cfgファイルの編集

- 7.7.5 ビジネス・アプリケーションおよびコンテンツ・サーバー・ユーザーの管理

- 7.8 Oracle AutoVue Document Viewingの構成

- 7.8.1 Oracle AutoVueの構成について

- 7.8.2 Oracle VueLink for Content Serverのための要件

- 7.8.3 アダプタのためのAutoVueの有効化

- 7.9 Oracle WebCenter Captureの構成

- 7.9.1 Oracle WebCenter Captureの使用によるドキュメント・スキャンについて

- 7.9.2 Oracle WebCenter Captureおよび関連するコンポーネントの要件

- 7.9.3 アダプタのためのOracle WebCenter Captureの構成

- 7.9.4 アダプタを介したWebCenter Captureのためのコンテンツ・サーバーの構成

- 7.9.5 アダプタ構成を介したOracle WebCenter Captureのテスト

- 7.10 Oracle Distributed Document Captureの構成

- 7.10.1 Oracle Distributed Document Captureの使用によるドキュメント・スキャンについて

- 7.10.2 Oracle Distributed Document Captureおよび関連するコンポーネントの要件

- 7.10.3 アダプタのためのOracle Distributed Document Captureの構成

- 7.10.4 アダプタを介したDistributed Document Captureのためのコンテンツ・サーバーの構成

- 7.10.5 アダプタ構成を介したOracle Distributed Document Captureのテスト

- 7.11 管理対象添付ファイル・ソリューションのテスト

- 7.12 コンテンツ・サーバーのロギングの構成

- 7.13 コンテンツ・サーバー上のアダプタ・コンポーネントのアンインストール

A BPMイメージング・ソリューション・リファレンス

- A.1 BPM用AXFビジネス・ルール・リファレンス

- A.1.1 ページ・コンポーネントのパラメータ

- A.1.1.1イメージ・ページ・コンポーネントのパラメータ

- A.1.1.2 イメージ・データ・ページ・コンポーネントのパラメータ

- A.1.1.3 データ・ページ・コンポーネントのパラメータ

- A.1.1.4 表データ・ページ・コンポーネントのパラメータ

- A.1.1.5 マスター/ディテール・ページ・コンポーネントのパラメータ

- A.1.1.6 アイデンティティ・ブラウザ・ページ・コンポーネントのパラメータ

- A.1.1.7 コメント・ページ・コンポーネントのパラメータ

- A.1.2 コントロール・ページのパラメータ

- A.1.2.1 データ・コントロール・ページのパラメータ

- A.1.2.2 アイデンティティ・ブラウザ・コントロール・ページのパラメータ

- A.1.2.3 コメント・コントロール・ページのパラメータ

- A.1.3 Actionディクショナリ

- A.1.3.1 Action

- A.1.3.2 Section

- A.1.3.3 ActionEnableModeException

- A.1.3.4 SectionEnableModeException

- A.1.3.5 ActionParameter

- A.1.3.6 SectionParameter

- A.1.4 Dataディクショナリ

- A.1.4.1 Data

- A.1.4.2 Section

- A.1.4.3 DataParameter

- A.1.4.4 SectionParameter

- A.1.4.5 DataComponentAttribute

- A.1.4.6 DataValidator

- A.1.5 DynamicTab Dictionary

- A.1.5.1 Tab

- A.1.5.2 TabParameter

- A.1.6 FunctionalBlock Dictionary

- A.1.6.1 NamedFunctionalBlock

- A.1.6.2 NamedFunctionalBlockSequence

- A.1.6.3 NamedFunctionalBlockParameter

- A.1.6.4 NamedFunctionalBlockPrompt

- A.1.6.5 NamedFunctionalBlockValidator

- A.1.7 LookupAndValidator Dictionary

- A.1.7.1 StaticLookup

- A.1.7.2 DynamicLookup

- A.1.7.3 DynamicLookupBindVariable

- A.1.7.4 LookupParameter

- A.1.7.5 DynamicLookupRelatedBinding

- A.1.7.6 Validator

- A.1.7.7 ValidatorParameter

- A.1.8 TableData Dictionary

- A.1.8.1 Table

- A.1.8.2 Column

- A.1.8.3 TableParameter

- A.1.8.4 ColumnParameter

- A.1.8.5 ColumnComponentAttribute

- A.1.8.6 ColumnValidator

- A.1.9 ビジネス・ルールのエンティティ関係

- A.2 BPMイメージング・ソリューションのためのAXFの表

- A.2.1 AXF_SOLUTIONS表

- A.2.1.1 列の説明

- A.2.1.2 実装例

- A.2.2 AXF_SOLUTION_ATTRIBUTES表

- A.2.2.1 列の説明

- A.2.2.2 実装例

- A.2.3 AXF_COMMANDS表

- A.2.3.1 列の説明

- A.2.3.2 実装例

- A.2.4 AXF_SOLUTION_PARAMETERS表

- A.2.4.1 列の説明

- A.2.4.2 実装例

- A.2.5 AXF_XPATH_ATTRIBUTES表

- A.2.5.1 列の説明

- A.2.5.2 実装例

- A.2.6 AXF_XPATH_NAMESPACES表

- A.2.6.1 列の説明

- A.2.6.2 実装例

- A.3 BPMイメージング・ソリューションのためのAXFのコマンド

- A.3.1 Open Solution Workspaceコマンド

- A.3.1.1 Open Solution Workspaceコマンドのパラメータ

- A.3.1.2 実装例

- A.3.2 Update Taskコマンド

- A.3.2.1 Update Taskコマンドのパラメータ

- A.3.2.2 システム属性

- A.3.2.3 実装例

- A.3.3 Document Searchコマンド

- A.3.3.1 Document Searchコマンドのパラメータ

- A.3.3.2 実装例

- A.4 BPMイメージング・ソリューションのためのOracle E-Business Suite Formsの表

- A.4.1 BPMイメージング・ソリューションのためのOracle E-Business Suite AXFの表について

- A.4.2 AXF_CONFIGS表(Oracle E-Business Suite)

- A.4.2.1 列の説明

- A.4.3 AXF_COMMANDS表(Oracle E-Business Suite)

- A.4.3.1 列の説明

- A.4.4 AXF_COMMAND_PARAMETERS表(Oracle E-Business Suite)

- A.4.4.1 列の説明

- A.4.5 AXF_PROPERTIES表(Oracle E-Business Suite)

- A.4.5.1 列の説明

- A.5 BPMイメージング・ソリューションのためのOracle PeopleSoftの表

- A.5.1 BPMイメージング・ソリューションのためのOracle PeopleSoft AXFの表について

- A.5.2 PS_AXF_CONFIG表

- A.5.2.1 列の説明

- A.5.3 PS_AXF_COMMANDS表

- A.5.3.1 列の説明

- A.5.4 PS_AXF_COMMAND_PARAMS表

- A.5.4.1 列の説明

- A.5.5 PS_AXF_PROPERTIES表

- A.5.5.1 列の説明

B BPELイメージング・ソリューション・リファレンス

- B.1 BPELイメージング・ソリューションのためのAXFの表

- B.1.1 AXF_SOLUTIONS表

- B.1.1.1 列の説明

- B.1.1.2 実装例

- B.1.2 AXF_SOLUTION_ATTRIBUTES表

- B.1.2.1 列の説明

- B.1.2.2 実装例

- B.1.3 AXF_COMMANDS表

- B.1.3.1 列の説明

- B.1.3.2 実装例

- B.1.4 AXF_SOLUTION_PARAMETERS表

- B.1.4.1 列の説明

- B.1.4.2 実装例

- B.1.5 AXF_ACTION_MENU表

- B.1.5.1 列の説明

- B.1.5.2 実装例

- B.1.6 AXF_ACTIONS表

- B.1.6.1 列の説明

- B.1.6.2 実装例

- B.1.7 AXF_XPATH_ATTRIBUTES表

- B.1.7.1 列の説明

- B.1.7.2 実装例

- B.1.8 AXF_XPATH_NAMESPACES表

- B.1.8.1 列の説明

- B.1.8.2 実装例

- B.2 BPELイメージング・ソリューションのためのAXFのユーザー・コンポーネント

- B.2.1 ソリューション・エディタ

- B.2.2 タスク・リストWebツール

- B.2.2.1 タスク・リストのパラメータ

- B.2.2.2 実装例

- B.2.3 タスク・ビューアWebツール

- B.2.3.1 AXF_METADATA_BLOCKS表

- B.2.3.2 AXF_METADATA_ATTRIBUTES表

- B.2.3.3 コメント

- B.2.4 列挙ピッカーWebツール

- B.2.4.1 列挙ピッカーのパラメータ

- B.2.4.2 AXF_ENUM_TYPES表

- B.2.4.3 AXF_ENUM_ITEMS表

- B.2.5 アイデンティティ・ピッカーWebツール

- B.2.5.1 アイデンティティ・ピッカーのパラメータ

- B.2.5.2 実装例

- B.2.6 アカウント配布コーディング・フォーム(Oracle E-Business Suiteのみ)

- B.2.6.1 コーディング・フォームのルックアップ要素のためのAXF_LOOKUPSスクリプト

- B.2.6.2 アカウント配布コーディング・フォーム・ソリューションの例

- B.2.6.3 アカウント配布コーディング・フォームのサポート・コマンドの例

- B.2.6.4 OpenTaskコマンドおよびAutoOpenTaskコマンドの例

- B.3 BPELイメージング・ソリューションのためのAXFのコマンド

- B.3.1 Open Taskコマンド

- B.3.1.1 Open Taskコマンドのパラメータ

- B.3.1.2 実装例

- B.3.2 Autotaskコマンド

- B.3.2.1 Autotaskコマンドのパラメータ

- B.3.2.2 実装例

- B.3.3 Release Taskコマンド

- B.3.3.1 Release Taskコマンドのパラメータ

- B.3.3.2 実装例

- B.3.4 Complete Taskコマンド

- B.3.4.1 Complete Taskコマンドのパラメータ

- B.3.4.2 実装例

- B.3.5 Redirectコマンド

- B.3.5.1 Redirectコマンドのパラメータ

- B.3.5.2 実装例

- B.3.6 Update Taskコマンド(BPEL)

- B.3.6.1 Update Taskコマンドのパラメータ

- B.3.6.2 システム属性

- B.3.6.3 実装例

- B.3.7 Update Task From Procedureコマンド

- B.3.7.1 Update Task From Procedureコマンドのパラメータ

- B.3.7.2 実装例

- B.3.7.3 タスク・ペイロードを更新するPL/SQLプロシージャの例

- B.3.8 Terminate Conversationコマンド

- B.3.9 Validate Taskコマンド

- B.3.9.1 Validate Taskコマンドのパラメータ

- B.3.9.2 実装例

- B.4 BPELイメージング・ソリューションのためのOracle E-Business Suite Formsの表

- B.4.1 BPELイメージング・ソリューションのためのOracle E-Business Suite AXFの表について

- B.4.2 AXF_CONFIGS表(Oracle E-Business Suite)

- B.4.2.1 列の説明

- B.4.2.2 実装例

- B.4.3 AXF_COMMANDS表(Oracle E-Business Suite)

- B.4.3.1 列の説明

- B.4.3.2 実装例

- B.4.4 AXF_COMMAND_PARAMETERS表(Oracle E-Business Suite)

- B.4.4.1 列の説明

- B.4.4.2 実装例

- B.4.5 AXF_PROPERTIES表(Oracle E-Business Suite)

- B.4.5.1 列の説明

- B.4.5.2 実装例

- B.5 BPELイメージング・ソリューションのためのOracle PeopleSoftの表

- B.5.1 BPELイメージング・ソリューションのためのOracle PeopleSoft AXFの表について

- B.5.2 PS_AXF_CONFIG表

- B.5.2.1 列の説明

- B.5.2.2 実装例

- B.5.3 PS_AXF_COMMANDS表

- B.5.3.1 列の説明

- B.5.3.2 実装例

- B.5.4 PS_AXF_COMMAND_PARAMS表

- B.5.4.1 列の説明

- B.5.4.2 実装例

- B.5.5 PS_AXF_PROPERTIES表

- B.5.5.1 列の説明

- B.5.5.2 実装例

C 管理対象添付ファイル・ソリューション・リファレンス

- C.1 管理対象添付ファイル・ソリューションのためのAXFの表

- C.1.1 AXF_SOLUTIONS表

- C.1.1.1 列の説明

- C.1.1.2 実装例

- C.1.2 AXF_SOLUTION_ATTRIBUTES表

- C.1.2.1 列の説明

- C.1.2.2 実装例

- C.1.3 AXF_COMMANDS表

- C.1.3.1 列の説明

- C.1.3.2 実装例

- C.1.4 AXF_SOLUTION_PARAMETERS表

- C.1.4.1 列の説明

- C.1.4.2 実装例

- C.2 管理対象添付ファイル・ソリューションのためのOracle E-Business Suite Formsの表

- C.2.1 AXF_CONFIGS表(Oracle E-Business Suite Forms)

- C.2.1.1 列の説明

- C.2.1.2 実装例

- C.2.2 AXF_PROPERTIES表(Oracle E-Business Suite Forms)

- C.2.2.1 列の説明

- C.2.2.2 実装例

- C.2.3 AXF_FND_MAP表(Oracle E-Business Suite Forms)

- C.2.3.1 列の説明

- C.2.3.2 実装例

- C.2.4 AXF_COMMANDS表(Oracle E-Business Suite Forms)

- C.2.4.1 列の説明

- C.2.4.2 実装例

- C.2.5 AXF_COMMAND_PARAMETERS表(Oracle E-Business Suite Forms)

- C.2.5.1 列の説明

- C.2.5.2 実装例

- C.2.6 AXF_MA_PARAMETERS表(Oracle E-Business Suite Forms)

- C.2.6.1 列の説明

- C.2.6.2 実装例

- C.3 管理対象添付ファイル・ソリューションのためのOracle E-Business Suite OAFの表

- C.3.1 OAF_AXF_CONFIGS表(Oracle E-Business Suite OAF)

- C.3.1.1 列の説明

- C.3.1.2 実装例

- C.3.2 OAF_AXF_PROPERTIES表(Oracle E-Business Suite OAF)

- C.3.2.1 列の説明

- C.3.2.2 実装例

- C.3.3 OAF_AXF_COMMANDS表(Oracle E-Business Suite OAF)

- C.3.3.1 列の説明

- C.3.3.2 実装例

- C.3.4 OAF_AXF_CMD_PARAMS表(Oracle E-Business Suite OAF)

- C.3.4.1 列の説明

- C.3.4.2 実装例

- C.4 管理対象添付ファイル・ソリューションのためのOracle PeopleSoftの表

- C.4.1 PS_AXF_CONFIG表

- C.4.1.1 列の説明

- C.4.1.2 実装例

- C.4.2 PS_AXF_COMMANDS表

- C.4.2.1 列の説明

- C.4.2.2 実装例

- C.4.3 PS_AXF_CMD_PARAMS表

- C.4.3.1 列の説明

- C.4.3.2 実装例

- C.4.4 PS_AXF_PROPERTIES表

- C.4.4.1 列の説明

- C.4.4.2 実装例

- C.5 管理対象添付ファイル・ソリューションのためのコンテンツ・サーバーの表

- C.5.1 AFGrants表

- C.5.1.1 列の説明

- C.5.2 AFObjects表

- C.5.2.1 列の説明

- C.5.3 AFRelationshipAttributes表

- C.5.3.1 列の説明

- C.5.4 AFKeys表

- C.5.4.1 列の説明

はじめに

このマニュアルでは、Oracle WebCenterシステム用のOracleビジネス・アプリケーションの構成について説明します。

対象読者

このマニュアルは、Oracleビジネス・アプリケーションとOracle WebCenterシステム間の統合ソリューションを構成する管理者を対象としています。

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

Oracleのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWeb サイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)を参照してください。

Oracle Supportへのアクセス

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 WebCenterアプリケーション・アダプタの使用』を参照してください。

表記規則

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

規則

意味

太字

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

イタリック体

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

固定幅フォント

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

このガイドで説明する新機能

この項では、Oracle WebCenterアプリケーション・アダプタの新機能について説明します。内容は次のとおりです。

- 11gリリース1 (11.1.1.8)の新機能と変更された機能

- 11gリリース1 (11.1.1.7)の新機能と変更された機能

- 11gリリース1 (11.1.1.6)の新機能と変更された機能

11gリリース1 (11.1.1.8)の新機能と変更された機能

このセクションの内容は次のとおりです。

- Oracle WebCenter Capture 11g (11.1.1.8)との管理対象添付ファイルの統合

Oracle WebCenter Capture 11g (11.1.1.8)との管理対象添付ファイルの統合

Oracle WebCenter Captureアプリケーションにドキュメントをスキャンさせ、ドキュメント・メタデータ値に渡すように、アダプタを構成することができます。これにより、ユーザーは、ドキュメントをスキャンしたり、ファイルを「管理対象添付ファイル」ページからインポートして、選択したビジネス・アプリケーション・レコードにそれらを添付することができます。

以前のリリースでは、Oracle Distributed Document Capture 10gアプリケーションに、管理対象添付ファイルをスキャンさせたりインポートさせることができました。このリリースでは、管理対象添付ファイルをCapture 11gまたは10gアプリケーションと統合できます。管理対象添付ファイルのCapture 11gとの統合の詳細は、第7.9項を参照してください。

11gリリース1 (11.1.1.7)の新機能と変更された機能

このセクションの内容は次のとおりです。

- 管理対象添付ファイル・ソリューション機能の追加(11.1.1.7)

管理対象添付ファイル・ソリューション機能の追加(11.1.1.7)

次の表は、アプリケーション・アダプタに組み込まれている管理対象添付ファイル・ソリューション新機能について説明しています。

管理対象添付ファイル・ソリューション機能

説明

参照先

ロール固有構成

ロール固有構成エントリが管理対象添付ファイルの「管理」ページに追加されています。このページでは、構成可能な機能およびボタン表示をユーザーに割り当てられているロールに基づいて制御できます。

第7.6.1項

ビジネス・コンテキスト固有構成

ビジネス・コンテキスト固有構成が管理対象添付ファイルの「管理」ページに追加されています。このページでは、構成可能な機能およびボタン表示をビジネス・アプリケーションからbusinessObjectContextを渡すことによって制御できます。

第7.6.2項

構成設定の優先順位

構成設定の優先順位は、高いものから低いものへ、ロール固有、ビジネス・コンテキスト固有、アプリケーション・エンティティ固有、アプリケーション・インスタンス固有およびグローバルとなっています。

第7.6.1項

新規検索エンジンのサポート

DATABASE.METADATA.AFLIST.STANDARDという名前の新規検索エンジンが追加されており、ドキュメントのリスト表示に柔軟性がもたらされました。

リリースされたドキュメントとリリースされていないドキュメントを表示するDATABASE.METADATA.AFLISTエンジンとは異なり、DATABASE.METADATA.AFLIST.STANDARDは、リリースされたドキュメントのみを表示します。

第7.5.1項

11gリリース1 (11.1.1.6)の新機能と変更された機能

この項の内容は次のとおりです。

- BPELイメージング・ソリューション機能の追加(11.1.1.6)

- 管理対象添付ファイル・ソリューション機能の追加(11.1.1.6)

BPELイメージング・ソリューション機能の追加(11.1.1.6)

次の表は、アプリケーション・アダプタに組み込まれているBPELイメージング・ソリューションの新機能について説明しています。

BPELイメージング・ソリューション機能

説明

参照先

Webツールの変更を行うための管理インタフェース(ソリューション・エディタ)

ソリューションの構成後、Imagingのソリューション・エディタを使用して、基本となっている表を直接変更することなく、ユーザー・インタフェース・コンポーネントに迅速に変更を加えることができます。たとえば、「タスク・リスト」で使用可能なBPELビュー、「タスク・ビューア」にリスト表示されるタスク・アクションまたは列挙ピッカーのページで使用可能な列挙値を変更できます。

第B.2.1項

アカウント配布コーディング・フォーム

このAXF Webインタフェースでは、明細項目レベルの値を含めて、ドキュメントの詳細情報の入力および選択が可能になります。請求書処理ソリューション・アクセラレータでは、コーディング・フォームを使用して、資格のあるユーザーがPO以外の請求書にコードを入力できるアカウント配布入力フォームが提供されます。

第B.2.6項

OAFアプリケーションとのImagingの使用

オプションで、OAF (Oracle Application Framework)ページ上で、管理対象添付ファイル・ソリューションのかわりに、イメージング・ソリューションへのアクセスを提供できます。たとえば、イメージング・ソリューションで使用可能な仕入先の保守機能にユーザーがアクセスできるようにするボタンを組み込むことができます。

第2.3.3項

タスク・リストでのタスクの検索

タスク・リストに多くのタスクを表示する場合、ユーザーは特定のタスクをキー識別子で検索できます。たとえば、ユーザーは請求書タスクをその請求書番号で検索できます。

『Oracle Fusion Middleware Oracle WebCenterアプリケーション・アダプタの使用』のタスクの検索に関する項

タスク・リストでのタスクのソート

エンド・ユーザーは、列ヘッダーをクリックすることによって、タスク・リストを昇順または降順にソートできます。

『Oracle Fusion Middleware Oracle WebCenterアプリケーション・アダプタの使用』のタスクのソートに関する項

管理対象添付ファイル・ソリューション機能の追加(11.1.1.6)

次の表は、アプリケーション・アダプタに組み込まれている管理対象添付ファイル・ソリューション新機能について説明しています。

注意:

Oracle E-Business SuiteプラグインやOracle PeopleSoftプラグインなどの、その他の動作保証の詳細は、次のWebページにあるサポートされる構成および動作保証の情報を参照してください。

http://www.oracle.com/technetwork/middleware/webcenter/content/documentation/documentation-155348.html

管理対象添付ファイル・ソリューション機能

説明

参照先

Oracle E-Business Suite OAFアプリケーションのサポート

ページのパーソナライズおよび構成を使用して管理対象添付ファイルのボタンを追加することによって、管理対象添付ファイル機能をOAF (Oracle Application Framework)ページに統合します。

第2.3項

管理対象添付ファイルの他のビジネス・アプリケーションへの構成のサポート

Enterprise Application Adapter Frameworkコンポーネントを使用して、管理対象添付ファイル機能をOracle E-Business SuiteまたはOracle PeopleSoft以外のビジネス・アプリケーションに統合できます。

第7.4項

管理対象添付ファイル機能のカスタマイズ用の管理インタフェース

preferences.hdaファイルを編集するかわりに、このインタフェースを使用して、グローバル変数の構成および添付リレーションシップとエンティティ固有構成の追加を実行できます。

第7.5.1項

カスタマイズ変数の追加

- AppAdapterCheckinPrivate: ユーザーがドキュメントにチェックインするときに、共有ではなく、プライベート・ドキュメント・チェックインをデフォルトに指定できます。

- AppAdapterExtraCheckinMetadataおよびAppAdapterExtraScanMetadata: 追加メタデータの受渡しに関して、この表内の後述の項目を参照してください。

- AppAdapterHelpIconVisible: 「管理対象添付ファイル」ページ上のユーザーの「ヘルプ」アイコンの表示と非表示を切り替えることができます。

- AppAdapterViewUnreleased: 添付ファイル・リスト内のドキュメントの表示と非表示を、それらがリリースされる前に切り替えることができます。

また、ResultCount (1ページに表示する添付ファイルの数)およびSearchEngineName(使用する検索エンジン)も、「管理対象添付ファイルの構成」ページで変数として設定および変更できるようになりました。

第7.5.1項

コンテンツ・サーバーで使用するための追加メタデータの受渡し

AXF付与コールで、チェックイン時に事前移入されるメタデータを渡すことができます。

第7.6.16項

エンド・ユーザーに表示される簡略化されたURL

チケット・メカニズムによって、管理対象添付ファイルURL上のビジネス・オブジェクトIDなどの詳細が、エンド・ユーザーに対して非表示になりました。

管理対象添付ファイル・セキュリティ・モデルのCSF拡張機能

構成可能なキー名を使用して、管理者資格証明を資格証明ストア・フレームワーク(CSF)に格納する必要があります。

管理対象添付ファイル・ソリューションでは、Oracle E-Business SuiteまたはOracle PeopleSoftから送信されたWebサービス・コール内のユーザー名が、CSFに格納されているユーザー名と比較されます。管理者ユーザー名が一致しない場合、「管理対象添付ファイル」ページにアクセスできないようにする例外が発生します。

第7.7.1項

Oracle PeopleSoftポップアップ・ソリューション・ウィンドウのサイズ変更

ソリューションの一部として表示されるOracle PeopleSoftポップアップ・ウィンドウすべてのデフォルトのシステム全体のサイズを変更または削除できます。

第6.4.12項および第7.6.17項

特定のビジネス・エンティティについて構成可能なプライベート添付ファイル・セキュリティ・グループ

エンティティごとに、プライベート添付ファイルのデフォルトのセキュリティ・グループをオーバーライドして、別のプライベート添付ファイル・セキュリティ・グループにドキュメントを割り当てることができます。

第7.6.18項

ユーザーは添付ファイル・リスト内で検索可能

「管理対象添付ファイル」ページで多くの添付ファイルを表示する場合、ユーザーは添付ファイル・リスト内で検索を実行できます(たとえば、名前でのドキュメントの検索)。

『Oracle Fusion Middleware Oracle WebCenterアプリケーション・アダプタの使用』の添付ファイル・リスト内での検索に関する項

1 アプリケーション・アダプタ・ソリューションの概要

この章では、Oracle WebCenterのアプリケーション・アダプタについて説明します。アダプタには、Oracle WebCenter Content: Imagingを使用してイメージング、取得およびワークフローの各機能を提供するイメージング・ソリューション、およびOracle WebCenter Content Server(コンテンツ・サーバー)リポジトリに格納されているドキュメント添付ファイルをビジネス・ユーザーが添付、スキャンおよび取得できるようにする管理対象添付ファイル・ソリューションがあります。

この章の内容は、次のとおりです。

- 第1.1項「Application Extension Framework (AXF)について」

- 第1.2項「BPMイメージング・ソリューションについて」

- 第1.3項「BPELイメージング・ソリューションについて」

- 第1.4項「管理対象添付ファイル・ソリューションについて」

- 第1.5項「アダプタ・コンポーネントについて」

- 第1.6項「アダプタのセキュリティと認証について」

- 第1.7項「アダプタのシステム要件」

- 第1.8項「アダプタの構成ロードマップ」

1.1 Application Extension Framework (AXF)について

Oracle WebCenter Contentビジネス・アプリケーション統合ソリューションでは、Oracle E-Business SuiteやOracle PeopleSoftなどのビジネス・アプリケーションをImagingやContentなどのコンテンツ管理アプリケーションと統合する際に、Application Extension Framework (AXF)インフラストラクチャというコマンド駆動型のWebサービス統合が使用されます。AXFのJavaベースのオープン・アーキテクチャによって、インテグレータはOracle WebCenter Contentビジネス・アプリケーションの複数の統合ソリューションをビジネス・アプリケーションから独立して構成および変更できるようになります。

BPEL用のAXFインフラストラクチャでは、ソリューション開発者やソリューション・アクセラレータは、AXFデータベース表(WebCenter Imaging表)を基にAXFソリューション、コマンドおよびWebツールを構成し、実装およびカスタマイズします。

AXFソリューションとは、いずれかのAXFインフラストラクチャを使用してコンポーネントを作成するマイクロアプリケーションです。ソリューションは、基本構造のコアAXFの上位にインストールし、ビジネス・アプリケーションのファイルがAXFの機能を使用するソリューションの標準になります。

イメージング・ソリューションは、ユーザー・インタフェース・コンポーネントを提供します。このコンポーネントは、割当て済ヒューマン・ワークフロー・タスクがリスト表示されるタスク・リストと、ユーザーがヒューマン・ワークフロー・タスクを取得、完了およびリリースするタスク詳細領域で構成されています。

どちらのAXF構造も、管理対象添付ファイル・ソリューションとともに使用できます。(両方のソリューションを使用する場合は、同じAXFバージョンを使用することをお薦めします。)

1.2 BPMイメージング・ソリューションについて

この項の内容は次のとおりです。

- 第1.2.1項「ビジネス・ユーザーから見たBPMイメージング・ソリューション」

- 第1.2.2項「ビジネス層アジリティ管理者ロールについて」

- 第1.2.3項「BPMイメージング・ソリューションで使用されるAXFコマンドについて」

- 第1.2.4項「BPMイメージング・ユーザー・インタフェース・コンポーネントについて」

1.2.1 ビジネス・ユーザーから見たBPMイメージング・ソリューション

ビジネス・ユーザーの観点からは、統合は実質的にシームレスです。エンドユーザーは、BPMイメージング・ソリューションを次の目的で使用します。

- ビジネス・アプリケーションからBPMイメージング・ソリューションを起動して(または割り当てられたタスクの電子メール通知よって)、ワークフロー・タスクを選択および実行します。たとえば、タスクを処理しているユーザーは、ビジネス・アプリケーションに統合されているカスタムのボタン、リンクまたはメニュー・コマンドを選択して、次のプロセスを開始します。

- SOAPリクエストが生成されてAXFに送信されます。選択したコマンドがAXFソリューション(SalesQuoteEntry)、AXFコマンド(StartSalesQuoteEntry)、ユーザー名などの追加パラメータとともに渡されます。

- AXFが、OPEN_BROWSERコマンドとAXFソリューション・ワークスペースを起動するURLを返します。

- ビジネス・アプリケーションによって、新しいブラウザ・ウィンドウのAXFソリューション・ワークスペース・ページにBPMビュー、タスク・リストおよびタスクの詳細が表示されます。

- ユーザーがタスク・リストからタスクを選択すると、そのタスクの詳細がソリューション・アプリケーション領域に表示されます。ユーザーは、ビジネス・アプリケーションまたはタスクの詳細領域(あるいはその両方)で、イメージおよび関連する値を表示しながらエントリを確認したり入力したりします。

- ビジネス・ユーザーは、タスクのルーティング、取消し、更新、完了など、ワークフロー・タスクに関連したアクションを実行します。

1.2.1.1 イメージングのシナリオ1: 売上見積りの入力

AXFとともにインストールされるHelloBPMソリューションには、売上見積りの入力をベースにしたイメージング参照ソリューションの例が含まれています。このような例は非本番用のもので、インストールおよびシステム操作の確認に使用でき、ドキュメントの一部分の叩き台として使用できます。これは次のように機能します。

1. ワークフロー・プロセスによって自動的にユーザー・ タスクが生成されます。
売上見積りがアップロードされ、データ値が割り当てられ、見積りを処理するタスクが生成されます。通常、タスクは、ユーザー・グループが選択するときの選択元となるビューにプールされます。1人のユーザーが複数のビューのタスクにアクセスできます。

2. ビジネス・アプリケーションから、ユーザーはStartSalesQuoteEntryというコマンドを選択するか、この名前のボタンまたはリンクをクリックすることによって、イメージング・ソリューションを起動します。

3. ユーザーは、選択した割当て先についてリストされているタスクから、タスクを1つ選択します。タスクが選択(取得)されると、他のユーザーはそのタスクを使用できなくなります。

4. ソリューション・アプリケーションで、ユーザーは、タスクのイメージの表示、そのイメージに基づいたエントリの入力および関連コマンドの実行を行います。
追加のアクション・コマンドが、ソリューション・アプリケーションの上部に用意されています。ユーザーは、別のユーザーまたはユーザー・グループに承認を得るためにタスクをルーティングしたり、他のユーザーが確認できるようにコメントを追加したり、アカウント管理用にタスクをルーティングしたりします。

5. ユーザーはタスクを完了し、必要に応じて別のタスクを開始します。

注意:

イメージング・ソリューションのユーザー・タスクの詳細は、『Oracle Fusion Middleware Oracle WebCenterアプリケーション・アダプタの使用』を参照してください。

1.2.2 ビジネス層アジリティ管理者ロールについて

この管理者は、ソリューション管理でビジネス・ルールに変更を加えることによって、特定のビジネス・ニーズを満たすようソリューションを構成します。たとえば、この管理者は、タスク・アクションの追加または変更、ページを制御するためのナビゲーションの構成、ページ・コンポーネントの構成、データおよび表の表示と編集の変更、検証とプロンプトの追加およびタブの追加または変更を実行できます。変更を保存すると、それらの変更はユーザー・インタフェースですぐに表示可能になります(第5.2.3項)。

ビジネス層アジリティ管理者には、ビジネス・ルール・エディタへのアクセスを提供するWebCenter Contentソリューション管理へのアクセスが必要です。(これらの管理者をOracle WebLogic Serverのaxfadminグループに割り当てる必要があります。)これらの管理者は、Oracle Business Rules、BPMプロセスおよびそのペイロードについて理解しておくことも必要です。詳細は、第5章を参照してください。

1.2.3 BPMイメージング・ソリューションで使用されるAXFコマンドについて

再使用可能なAXFコマンドを使用して、次に示した機能を実装できます。これらのコマンドの詳細は、コマンドのパラメータおよび実装例を含めて、第A.3項を参照してください。

BPM AXFコマンド

説明

ソリューション・ワークスペースを開く

AXFソリューション・ワークスペースへのURLでブラウザを開く指示をリクエスタに返します。第A.3.1項を参照してください。

タスクの更新

AXFリクエストに関連付けられたAXF対話で参照されるBPMタスクを更新します。リクエストで渡された引数が指定されたBPMタスク・ペイロード・データを更新し、AXFソリューション・アプリケーションにシグナルを送ります。第A.3.2項を参照してください。

ドキュメント検索

ビューアに表示するために、ドキュメント・リポジトリ・システムに格納されているドキュメントを取得します。ビジネス・アプリケーションから渡して検索URL文字列に追加することができるオプションのパラメータとともに検索URLを指定するURLがAXF構成で構成されます。第A.3.3項を参照してください。

1.2.4 BPMイメージング・ユーザー・インタフェース・コンポーネントについて

この項の内容は次のとおりです。

- 第1.2.4.1項「ソリューション・ワークスペースについて」

- 第1.2.4.2項「ソリューション・アプリケーションについて」

1.2.4.1 ソリューション・ワークスペースについて

BPM用AXFインフラストラクチャでは、構成可能なユーザー・インタフェースをソリューション・ワークスペースから使用できます。このワークスペースは、図1-1に示しているようなウィンドウ全体から成り、BPMタスクのリスト、ビューおよびその他のインタフェース・コンポーネントが表示され、ユーザーはこれらを使用して割当てタスクを管理および完了できます。

- ソリューション・ワークスペースは、すべてのソリューションへのプライマリ・エントリ・ポイントを提供します。
ユーザーは通常、ビジネス統合に使用しているアプリケーション(たとえば、Oracle E-Business SuiteやOracle PeopleSoft)から、またはBPMから送信される電子メール・リンクからワークスペースにアクセスします。

- ソリューション・ワークスペースでは、図1-1に示されているように、次のペインが含まれるインタフェース内に、ユーザーに割り当てられているヒューマン・タスクが表示されます。

- ビュー。ユーザーの作業コンテキストのBPMビューが表示されます。

- タスクリスト。割り当てられているBPMタスクのリストが表示され、ユーザーはここからタスクを選択できます。構成の詳細は、第5.5項を参照してください。

- ソリューション・アプリケーション。特定のヒューマン・タスクの詳細を表すユーザー・インタフェースが表示されます。詳細は、第1.2.4.2項を参照してください。

図1-1 ソリューション・ワークスペース

1.2.4.2 ソリューション・アプリケーションについて

ソリューション・アプリケーションでは、すべてのページに共通の動的ページ・テンプレートが使用されます。このテンプレートには、次に説明している、図1-2に示された要素が含まれています。ユーザー・インタフェースおよびテンプレート機能は、ディクショナリに含まれるビジネス・ルールによって駆動されます。

- アクション・コントロール(またはメニュー・バー)。ソリューション・アプリケーションの上部に全幅にわたって配置されます。これには、ユーザーが選択したタスクに対して実行できるアクションが含まれます。たとえば、アクションのリンクを使用することによって、ユーザーは、タスクを承認、却下、ルーティングまたは終了できます。
この領域に表示されるアクションは、特定のアクションを一部のユーザー・ロールに表示して、その他のユーザー・ロールには表示しないコンテキストを使用するかどうかなどの構成によって異なります。

- 動的タブ。アクション・コントロールの下に配置され、ビジネス・ユーザーがほとんどのタスクを実行する領域です。
この領域に表示されるタブは、コンテキストが使用されるかどうかや、実装されるページ・コンポーネントなどの構成によって異なります。

管理者は、第5章で説明しているように、Oracle Business Rulesを使用してソリューション・アプリケーションを編集します。ソリューションの機能ブロックによって、ソリューションの作業の機能単位が定義されます。

図1-2 ソリューション・アプリケーション

1.3 BPELイメージング・ソリューションについて

ワークフロー・イメージング・ソリューションは、Imagingをイメージング・ソースとして使用した、ビジネス・アプリケーションとBPEL (Oracle BPELプロセス・マネージャ)との統合です。AXF構成を使用して、ビジネス・ユーザーは、ビジネス・アプリケーション・ユーザー・インタフェースから関連イメージを処理したり、ドキュメント中心のワークフロー・タスクを実行したりできます。

この項の内容は次のとおりです。

- 第1.3.1項「ビジネス・ユーザーから見たBPELイメージング・ソリューション」

- 第1.3.2項「BPELイメージング・ソリューションで使用されるAXFコマンドについて」

- 第1.3.3項「BPELイメージング・ユーザー・インタフェース・コンポーネントについて」

1.3.1 ビジネス・ユーザーから見たBPELイメージング・ソリューション

ビジネス・ユーザーの観点からは、統合は実質的にシームレスです。エンドユーザーは、BPELイメージング・ソリューションを次の目的で使用します。

- 添付されているイメージおよびメタデータ値を表示します。権限で許可されている内容に応じて、イメージの表示、注釈付けおよび編集に、Imagingのツールを使用します。

- イメージおよび関連値をイメージング・ビューアで表示しながら、ビジネス・アプリケーションでエントリを入力します。

- タスクのルーティング、取消し、更新、完了など、ワークフロー・タスクに関連するアクションを実行します。

- 選択されたビジネス・アプリケーション・レコードのサポートするドキュメントをスキャンまたはアップロードします。

- ビジネス・アプリケーションから移動することなく、ビジネス・アプリケーション・レコードのサポートするイメージを表示します。

1.3.1.1 イメージングのシナリオ1: 請求書の処理

請求書の処理用に構成されたBPELイメージング・ソリューションは次のように動作します。

1. ワークフロー・プロセスによって自動的にユーザー・ タスクが生成されます。
請求書がアップロードされると、メタデータ値が割り当てられ、請求書を処理するタスクが生成されます。通常、タスクは、 プロファイルにプールされ、ユーザー・グループはここから選択を行います。1人のユーザーが複数のプロファイルのタスクにアクセスできます。

2. ビジネス・アプリケーションから、ユーザーはProcess Invoices (請求書の処理)というコマンドを選択するか、この名前のボタンまたはリンクをクリックすることによって、イメージング・ソリューションを起動します。

3. ユーザーは、選択したプロファイルについてリストされているタスクから、タスクを1つ選択します。タスクが選択(取得)されると、他のユーザーはそのタスクを使用できなくなります。

4. 「タスク・ビューア」では、ユーザーはタスクの請求書のイメージを表示し、そのイメージに基づいてビジネス・アプリケーションでエントリを入力し、関連コマンドを実行します。
その他の アクション・コマンドは、通常、サイド・パネルに表示されます。承認のためにタスクを他のユーザーまたはユーザー・グループにルーティングしたり、他のユーザーが確認できるようにコメントを追加できます。また、タスクのスキップや、タスクのドキュメントの再スキャンまたは削除を行うこともできます。

5. ユーザーはタスクを完了し、必要に応じて別のタスクを開始します。
通常、ビジネス・アプリケーションで変更した内容は、Imagingとの間で同期されます(その逆も同様です)。

注意:

イメージング・ソリューションのユーザー・タスクの詳細は、『Oracle Fusion Middleware Oracle WebCenterアプリケーション・アダプタの使用』を参照してください。

1.3.1.2 イメージングのシナリオ2: 従業員サポート・ドキュメントの取込み

サポートするドキュメントの取込み用に構成されたイメージング・ソリューションは次のように動作します。

1. ユーザーは、ビジネス・アプリケーションから、従業員レコードなどのレコードを取得します。

2. ユーザーは、Scan Employee Document(従業員ドキュメントのスキャン)というコマンドを選択するか、この名前のリンクまたはボタンをクリックして、ドキュメント・イメージング・ソリューションを起動します。

3. Oracle WebCenter Captureが起動され、自動的にスキャンが開始される(デスクトップにスキャナが接続されている場合)か、またはデスクトップから電子イメージをアップロードできます。

4. ユーザーはOracle WebCenter Captureで、イメージとともに保存するメタデータ(索引)値を入力します。

5. ユーザーは、「リリース」をクリックして、取り込んだドキュメント・イメージおよびそのメタデータをOracle WebCenter CaptureからImagingに送信します。

1.3.1.3 イメージングのシナリオ3: 従業員サポート・ドキュメントの表示

サポートするドキュメントの表示用に構成されたイメージング・ソリューションは次のように動作します。

1. ユーザーは、ビジネス・アプリケーションから、従業員レコードなどのレコードを取得します。

2. ユーザーは、View Employee Document(従業員ドキュメントの表示)というコマンドを選択するか、この名前のボタンまたはリンクをクリックして、ドキュメント・イメージング・ソリューションを起動します。

3. ユーザーは、従業員レコードに関連付けられているドキュメントおよびそのメタデータ値のリストから、ドキュメントを選択します。

4. ドキュメントがイメージング・ビューアに表示されます。ここでは、ドキュメントのイメージを表示したり、適切な権限がある場合には、注釈や表示編集を適用できます。

1.3.2 BPELイメージング・ソリューションで使用されるAXFコマンドについて

再使用可能なAXFコマンドを使用して、次に示した機能を実装できます。これらのコマンドの詳細は、コマンドのパラメータおよび実装例を含めて、第B.3項を参照してください。

BPEL AXFコマンド

説明

タスクを開く

AXFタスク・ビューアのWebページを表示し、ヒューマン・ワークフロー・タスクを取得します。第B.3.1項を参照してください。

自動タスク

自動タスク・モードで表示します。このモードでは、新規ヒューマン・ワークフロー・タスクが、タスク・リストに表示されずに自動的にAXFタスク・ビューアに取得されます。第B.3.2項を参照してください。

タスクのリリース

ヒューマン・ワークフロー・タスクをリリースし、構成されている場合は、追加アクションを実行します。第B.3.3項を参照してください。

タスクの完了

ヒューマン・ワークフロー・タスクを完了し、構成されている場合は、BPELペイロード属性値を更新して、追加アクションを実行します。第B.3.4項を参照してください。

リダイレクト

現在のAXF Webページを、構成に指定されているURLまたはAXF Webページにリダイレクトします。第B.3.5項を参照してください。

対話の終了

AXFとの対話を終了するために外部クライアントによって使用されます。(このコマンドには、パラメータは含まれません。)

タスクの更新

XPATHを使用して、指定されたヒューマン・タスクのBPELペイロード・フィールドの値、またはXMLペイロードの値を更新します。第B.3.6項を参照してください。

プロシージャからのタスクの更新

指定したデータ・ソースを使用してストアド・プロシージャをコールし、XPATHを使用してBPELペイロードの値を更新します。第B.3.7項を参照してください。

タスクの検証

BPELシステム属性データまたはBPELペイロード・データを正規表現言語を使用して検証し、検証結果に基づいて、後続のコマンドを実行します。第B.3.9項を参照してください。

注意:

AXFを使用して実行するために、カスタム・コマンドおよび連鎖コマンドをデプロイすることもできます。6.4.8項および6.4.9項を参照してください。

1.3.3 BPELイメージング・ユーザー・インタフェース・コンポーネントについて

BPELイメージング・ソリューションには、次のユーザー・インタフェース・コンポーネントが用意されています。これらは、ユーザーに対して表示されるWebインタフェース・コンポーネントであり、AXF表を使用して構成されます。移入後は、第B.2.1項で説明しているように、Imagingのソリューション・エディタを使用してコンポーネントを変更できます。

- 第1.3.3.1項「タスク・リストについて」

- 第1.3.3.2項「タスク・ビューアについて」

- 第1.3.3.3項「列挙ピッカーについて」

- 第1.3.3.4項「アイデンティティ・ピッカーについて」

- 第1.3.3.5項「コメントについて」

1.3.3.1 タスク・リストについて

図1-3に示している「タスク・リスト」Webページには、ユーザーが使用可能なタスクのリストが表示されます。これは、AXFインフラストラクチャおよびBPELと相互に作用し、BPEL Worklistアプリケーションで構成されているビューを使用してリストを表示します。

注意:

ビューを作成したり、ビューを他のユーザーまたはグループと共有するには、BPM Worklistアプリケーションを使用します。

構成の詳細は、第B.2.2項を参照してください。

図1-3 「タスク・リスト」Webツール

「タスク・リスト」Webツールには、AXFアクション・コマンドを使用するAXFアクションのリストも表示できます。

1.3.3.2 タスク・ビューアについて

図1-4に示している「タスク・ビューア」Webページには、AXFインフラストラクチャ、BPEL、Imagingおよびビジネス・アプリケーションとの相互作用を通した、イメージとメタデータ値が表示されます。これには通常、AXFアクション・コマンドが含まれるサイド・メニューも表示されます。メタデータ値が含まれるサマリー・セクション、コメント・セクションおよび動的データ表も表示される場合があります。

構成の詳細は、第B.2.3項を参照してください。

図1-4 「タスク・ビューア」Webツール

1.3.3.3 列挙ピッカーについて

図1-5に示している列挙ピッカーWebページでは、ユーザーは列挙値のリストから選択できます。

構成の詳細は、第B.2.4項を参照してください。

図1-5 列挙ピッカーWebツール

1.3.3.4 アイデンティティ・ピッカーについて

図1-6に示している「アイデンティティ・ピッカー」Webページでは、ユーザーはBPELに構成されているアイデンティティ・ストアから1つ以上のユーザーまたはグループを選択できます。ユーザーがアイデンティティを選択すると、AXFでは通常、関連する構成可能アクションが実行されます。多くの場合、AXFによって、選択されたユーザーまたはユーザー・グループにタスクが割り当てられるか、委任されます。たとえば、トランザクションで問題が発生したビジネス・ユーザーは、問題を記述したコメントの入力後に、トランザクションの送信先とする例外ハンドラを選択します。

構成の詳細は、第B.2.5項を参照してください。

図1-6 「アイデンティティ・ピッカー」Webツール

1.3.3.5 コメントについて

図1-8に示している「コメント」Webページでは、ユーザーは、トランザクションの処理中にヒューマン・タスクに関連したコメントを入力できます。管理者は、図1-4に示している「タスク・ビューア」のように、単一タスクからのデータを表示する任意のAXF Webページにコメントを表示できます。コメントは、プロセス全体にわたって存続し、ユーザーはコメントを表示したり追加したりできます。BPELワークフロー・タスクでは、ネイティブのコメント機能を使用してコメントが保存されます。

コメントを表示するには、ユーザーは次の図および図1-4で示しているAXF Webページの「コメントの表示」アイコンをクリックします。コメントを追加するには、ユーザーは「コメントの追加」アイコンをクリックします。

図1-7 「コメントの表示」アイコン(左)、「コメントの追加」アイコン(右)

構成の詳細は、第B.2.3.3項および第B.2.3.1.2項を参照してください。

図1-8 「コメント」Webツール

1.4 管理対象添付ファイル・ソリューションについて

このソリューションでは、コンテンツ・サーバーのドキュメントが、ビジネス・アプリケーションの構成に応じてリンク、ボタンまたはメニューから起動されるカスタマイズ可能ウィンドウに、ビジネス・アプリケーション・エンティティの管理対象添付ファイルとしてリストされます。たとえば、ビジネス・アプリケーションのユーザーは、従業員レコードを表示して、ボタンをクリックすることによって管理対象添付ファイル機能を起動し、パスポートのイメージとサポートしているアイデンティティ・ドキュメントを添付します。

注意:

第7.4項で示しているように、Oracle E-Business Suite Forms、Oracle Applications Framework (OAF)およびPeopleSoftを使用して作成したアプリケーション以外にも、管理対象添付ファイル・ソリューションを、エンタープライズ・アプリケーション・アダプタ・フレームワークを使用してその他のビジネス・アプリケーションと統合できます。

図1-9に示しているように、管理対象添付ファイル・ソリューションを使用すると、ビジネス・ユーザーは、コンテンツ・サーバー・リポジトリに格納されている添付ファイルを添付したり、スキャンしたり、取得したりできます。Oracle WebCenterコンテンツ・サーバー・リポジトリを使用すると、ユーザーは企業全体を通して、コンテンツを安全で正確かつ最新の状態で表示、共同処理およびリタイアできるようになります。

図1-9 「管理対象添付ファイル」ページ

この項の内容は次のとおりです。

- 第1.4.1項「ビジネス・ユーザーから見た管理対象添付ファイル・ソリューション」

- 第1.4.2項「添付ファイル・ソリューションで使用されるAXFコマンドおよびサービスについて」

1.4.1 ビジネス・ユーザーから見た管理対象添付ファイル・ソリューション

ビジネス・ユーザーは、ビジネス・アプリケーション環境の拡張機能として、次のタスクを管理対象添付ファイル・ソリューションで実行できます。

- 新規ドキュメントをContent Serverにチェックインし、選択したビジネス・アプリケーション・エンティティに添付します

- Oracle WebCenter Captureを使用して、ドキュメントを選択したビジネス・アプリケーションに添付しながらスキャンおよびインポートします。

- ネイティブ・アプリケーション、Web表示可能フォーマットまたはAutoVueビューア(構成されている場合)でドキュメントを開きます

- 選択したビジネス・アプリケーション・エンティティからドキュメントを添付解除します

- コンテンツ・サーバーを検索し、ドキュメントをコンテンツ・サーバー・リポジトリから選択したビジネス・アプリケーション・エンティティに添付します

- ドキュメントをチェックアウトし、他のユーザーが変更しないようにロックします

- ドキュメントのメタデータ値を変更します

- 構成されている場合は、以前に添付されたリビジョンを表示して添付ファイル・リビジョンを更新します

- 添付ドキュメントの情報を表示します

注意:

管理対象添付ファイル・ソリューションのユーザー・タスクの詳細は、『Oracle Fusion Middleware Oracle WebCenterアプリケーション・アダプタの使用』を参照してください。

1.4.1.1 添付ファイル・シナリオ1: アイデンティティ・ドキュメントの取込み

パスポートなどの従業員アイデンティティ・ドキュメントの取込み用に構成された管理対象添付ファイル・ソリューションは、次のように動作します。

1. ユーザーは、ビジネス・アプリケーションから、従業員レコードなどのレコードを取得します。

2. ユーザーは、Scan Employee Document(従業員ドキュメントのスキャン)というコマンドを選択するか、この名前のリンクまたはボタンをクリックして、管理対象添付ファイル・ソリューションを起動します。

3. Oracle WebCenter Captureが起動され、自動的にスキャンが開始される(デスクトップにスキャナが接続されている場合)か、またはデスクトップから電子イメージをアップロードできます。

4. ユーザーは、添付ファイル設定を選択します。「ドキュメントのスキャン」をクリックしてから、Oracle WebCenter Captureでイメージとともに格納するメタデータ(索引)値を入力します。

5. ユーザーは、「リリース」をクリックして、取り込んだドキュメント・イメージおよびそのメタデータをOracle WebCenter Captureからコンテンツ・サーバーに送信します。

6. ユーザーは、「リフレッシュ」ボタンをクリックし、選択した従業員レコードの添付としてリストされた、新規スキャン済またはインポート済ドキュメントを表示します。

1.4.1.2 添付ファイル・シナリオ2: アイデンティティ・ドキュメントの表示および編集

従業員アイデンティティ・ドキュメントの表示用に構成された管理対象添付ファイル・ソリューションは、次のように動作します。

1. ユーザーは、ビジネス・アプリケーションから従業員レコードを取得します。

2. ユーザーは、View Employee Documents(従業員ドキュメントの表示)というコマンドを選択するか、この名前のリンクまたはボタンをクリックして、管理対象添付ファイル・ソリューションを起動します。

3. 従業員レコードの添付ファイルをリストした「管理対象添付ファイル」ページが表示されます。

4. 添付ファイルがユーザーまたは他のユーザーによりチェックアウトされた場合、添付ファイルにリビジョン番号が表示される場合があります。リビジョン固有モードが構成されており、旧リビジョンが添付されている場合、旧添付リビジョンを表示するか、新規リビジョンを表示してそれを新規添付バージョンにするかのいずれかを実行できます。

5. ユーザーは、添付ファイル・ドキュメントの「編集」アイコンを選択します。ユーザーがドキュメントを更新したため、ドキュメントはユーザーに対してチェックアウトされており、他のユーザーは編集できません。ユーザーが改訂済ドキュメントをチェックインすると、ドキュメントのリビジョン番号が増加します。

6. ドキュメントがコンテンツ・サーバー(またはAutoVueビューア)に表示されます。ここでは、ユーザーはドキュメントのイメージを表示したり、適切な権限がある場合には、注釈や表示編集を適用できます。

1.4.2 添付ファイル・ソリューションで使用されるAXFコマンドおよびサービスについて

管理対象添付ファイル・ソリューションでは、UCM_Managed_AttachmentsというAXFソリューション・ネームスペースを使用して、ビジネス・アプリケーションからのユーザー・リクエストがオーケストレートされ、コンテンツ・サーバー・リポジトリの管理対象添付ファイル・ユーザー・インタフェースが表示されます。

- ビジネス・アプリケーション・ユーザーがビジネス・アプリケーション・エントリから「管理対象添付ファイル」コマンドをアクティブにすると、アダプタはAXFリクエストを作成します。ソリューションでは、UCM_Managed_Attachmentsという単一AXFコマンド・ネームスペースがサポートされます。これは、AF_GRANT_ACCESSコマンドを起動します。

- AF_GRANT_ACCESSコマンドは、AF_GRANT_ACCESSサービスを実装します。このコンテンツ・サーバー・サービスは、ビジネス・アプリケーションにログインしたユーザーに、選択したビジネス・アプリケーション・エンティティに関連付けられていて、ユーザーがセキュリティ・グループ・アクセス権を持っているすべてのコンテンツ・サーバー・ドキュメントへのアクセスを一時的に付与します。また、このサービスは、コンテンツ・サーバーの添付ファイル・フレームワーク検索を起動するための、管理対象添付ファイルのURLが含まれるAXFレスポンスを返します。このフレームワーク検索では、ビジネス・アプリケーション・エンティティに関連付けられているすべてのドキュメントがリストされます。

- 返されたURLを使用して、アダプタではビジネス・アプリケーション・ユーザーに対して管理対象添付ファイルのブラウザ・ウィンドウが開かれ、添付ファイル・リストが関連付けられている、ビジネス・アプリケーション・エンティティのキー値(AFLabel)が表示され、オプションでビジネス・アプリケーションからコンテンツ・サーバーにメタデータ値が渡されます。

コンテンツ・サーバーへのアクセス権がビジネス・アプリケーション・ユーザーに付与されるしくみ

アダプタでは、管理対象添付ファイルへのアクセスに対して、一時認可メカニズムが使用されます。AXFは、信頼できるRIDCメカニズムを使用して通信し、認可を必要とするアプリケーション・エンティティおよびユーザー情報があるAF_GRANT_ACCESSサービスを呼び出します。AF_GRANT_ACCESSサービスは、指定された期間のアクセス権をユーザーに付与し、その後ユーザー・セッションを終了します。

1.5 アダプタ・コンポーネントについて

この項では、次の各トピックで、アプリケーション・アダプタの主要コンポーネントについて説明します。

- 第1.5.1項「ビジネス・アプリケーション・プラグイン」

- 第1.5.2項「AXFインフラストラクチャ」

- 第1.5.3項「AXFユーザー・インタフェース・コンポーネント」

- 第1.5.4項「コンテンツ・サーバー・コンポーネント(管理対象添付ファイル)」

- 第1.5.5項「AXFソリューション・アクセラレータ」

1.5.1 ビジネス・アプリケーション・プラグイン

これは、Oracle E-Business SuiteまたはOracle PeopleSoft(あるいはその両方)、または別のビジネス・アプリケーションのプラグインで構成されます。

- Oracle E-Business Suite: Oracle E-Business Suiteプラグインの構成では、Oracle E-Business Suiteデータベースに対して、表の移入と機能の構成を行うPL/SQLスクリプトが実行されます。第2章を参照してください。AXF関連のOracle E-Business Suite表を使用すると、Oracle E-Business SuiteのフォームまたはページでAXFコンポーネントを使用できるようになります。

- また、Formsの構成では、カスタム・アクションを既存のOracle E-Business Suite Formsと統合するためのファイルを、Oracle E-Business Suiteシステムにアップロードします。

- OAFの構成(管理対象添付ファイルのみで使用可能)では、ファイルをMDSリポジトリにインポートし、OAFページのパーソナライズによって管理対象添付ファイルのボタンを追加します。

- PeopleSoft: Oracle PeopleSoftプラグインの構成では、Oracle PeopleSoftプロジェクトのインポート、AXFと通信するためのIntegration Brokerの構成、ユーザー・ロールの設定およびOracle PeopleSoftページでのAXF機能の有効化を行います。第3章を参照してください。AXF関連のOracle PeopleSoft表を使用すると、Oracle PeopleSoftページでAXFコンポーネントを使用できるようになります。

- その他のビジネス・アプリケーション: エンタープライズ・アプリケーション・アダプタ・フレームワークと呼ばれる汎用コンポーネントを使用すると、Oracle E-Business SuiteとOracle PeopleSoft以外のビジネス・アプリケーションで使用できるように、管理対象添付ファイル・ソリューションをカスタマイズできます。詳細は、7.4項を参照してください。

1.5.2 AXFインフラストラクチャ

AXF統合インフラストラクチャでは、ビジネス・アプリケーション統合アダプタからのリクエストを処理するサービス・レイヤーが採用されます。このインフラストラクチャは、Oracle WebCenter Contentインストールに含まれており、インストール時にAXF表が自動的に作成されます。

AXFインフラストラクチャには、次のコンポーネントが含まれています。

- ソリューション・メディエータ

- AXFリクエスト/レスポンス

- コマンド・メディエータ

- AXFコマンド

- 対話

1.5.2.1 ソリューション・メディエータ

ソリューション・メディエータは、ビジネス・アプリケーション統合アダプタからAXFリクエストを受信します。ソリューション・メディエータは、単純なAXFリクエスト/レスポンス・プロトコルを実装して、ビジネス・アプリケーション統合アダプタからの抽象機能リクエストを、ビジネス機能を実装するAXFコマンド・コンポーネントに委譲します。ソリューション・メディエータは、AXFリクエストを処理するコマンド・メディエータの起動、対話の管理、一般的なエラー処理など、すべてのAXFリクエスト/レスポンスにわたって一般的なサービスを容易にする役割を担っています。

1.5.2.2 AXFリクエスト/レスポンス

AXFリクエストでは、機能リクエストが使用されます。AXFリクエストは、ソリューション・ネームスペース(DocumentProcessingなどの作業スレッドを表す)およびコマンド・ネームスペース(StartProcessingなどのサービスを表す)によって定義されます。AXFリクエストにオプションの引数が含まれる場合があります。AXFレスポンスには、リクエスタが実行することになる指示と、ビジネス・アプリケーションとAXFソリューション・アプリケーションとの間でアクティビティを同期するために使用される対話ID (CID)が含まれます。ビジネス・アプリケーション統合アダプタには、返されたCIDが格納され、同じソリューション・ネームスペース内の後続リクエストにそのCIDが組み込まれます。

1.5.2.3 コマンド・メディエータ

コマンド・メディエータは、AXFリクエストのソリューション・ネームスペースおよびコマンド・ネームスペースに基づいて、論理機能リクエストをAXFコマンドにマップします。

1.5.2.4 AXFコマンド

AXFコマンドは、ビジネス機能を実装します。コマンドでは、リクエストで指定された引数を使用して、AXFレスポンスを通してリクエスタに指示が返される場合があります。

- BPMイメージング・ソリューションでは、第1.2.3項で示しているように、いくつかのAXFコマンドが使用されます。

- BPELイメージング・ソリューションでは、第1.3.2項で示しているように、複数のAXFコマンドが使用されます。

- 管理対象添付ファイル・ソリューションでは、ビジネス・アプリケーション・エンティティに関連付けられているドキュメントを一時的に表示してそのアクセスを提供するコンテンツ・サーバー・サービスを実装するAXFコマンドが1つだけ使用されます。第1.4.2項を参照してください。

1.5.2.5 対話

対話では、ビジネス・アプリケーションとAXFソリューション・アプリケーションとの共有状態が維持されます。対話は、ビジネス・アプリケーションにはAXFレスポンスで返され、AXFソリューション・アプリケーションにはパラメータとして指定されるCIDを使用して、両方のアプリケーションで参照されます。

1.5.3 AXFユーザー・インタフェース・コンポーネント

アダプタでは、タスク・リストやタスクの詳細(列挙コントロール、アイデンティティ・ブラウザ、メタデータ表示、コメントなどのサブコンポーネントを含む)など、イメージング・ソリューションのユーザー・インタフェース・コンポーネントを使用できます。

- BPMイメージング・ソリューションの場合、ユーザー・インタフェース・コンポーネント(ソリューション・ワークスペースおよびソリューション・アプリケーション)は、ユーザー・インタフェース・ライブラリを通して提供されます。ビジネス・アジリティ層管理者は、BPMビジネス・ルールを変更することによってソリューションの動作をカスタマイズします。1.2.2項および1.2.4項を参照してください。

- BPELイメージング・ソリューションの場合、ユーザー・インタフェース・コンポーネント(タスク・リストおよびタスク・ビューア)は、AXF (WebCenter Imaging)データベース表を使用して構成されます。ソリューション開発者は、Imagingのソリューション・エディタを使用して、またはAXF表を変更することによって、ソリューションをカスタマイズします。第1.3.3項を参照してください。

1.5.4 コンテンツ・サーバー・コンポーネント(管理対象添付ファイル)

管理対象添付ファイル・ソリューションの場合、アダプタには、ZIPファイルにバンドルされているコンテンツ・サーバー・コンポーネントが組み込まれます。これらのコンポーネントは、コンポーネント・マネージャを使用してインストールし、有効化します。これらのコンポーネントによって、AppAdapterフレームワークのコア・ファイルが組み込まれます。第7.3項を参照してください。

1.5.5 AXFソリューション・アクセラレータ

Oracleでは、関連する承認ルール、データ・エントリ・フォームおよびレポートが含まれるワークフローを使用して請求書および受領の処理を自動化するなどの、特定の機能に対して実装アクセラレータが用意されています。

注意:

ソリューション実装アクセラレータを入手するには、システム・インテグレータ、Oracle ConsultingまたはOracleサポートまでお問い合せください。

1.6 アダプタのセキュリティと認証について

アダプタは、複数のセキュリティおよび認証レベルを提供します。これらのレベルは、表1-1に示しているように、ソリューション(BPMイメージング、BPELイメージングまたは管理対象添付ファイル)およびビジネス・アプリケーションによって異なります。

表1-1 アダプタのセキュリティ・コントロール

認証/
セキュリティ・レベル

ビジネス・アプリケーション

サポートされるソリューション

説明

構成情報

Webサービス認証(WSS/SOAP)

Oracle E-Business SuiteおよびOracle PeopleSoft

BPMイメージング、BPELイメージングおよび管理対象添付ファイル

AXFに対してWebサービス・コールが行われたときに実行されます。ソリューションでは、AXFソリューション・メディエータWebサービスに対するユーザー認証がサポートされ、AXFが配置されているアプリケーション・サーバーにインストールされているユーザー名トークン・セキュリティが使用されます。

- Oracle E-Business Suiteでは、プロパティ表(AXF_PROPERTIES or OAF_AXF_PROPERTIES)のAXF_SOAP_POLICYキーを使用して、ユーザー名トークン認証を設定します。

- Oracle PeopleSoftでは、ユーザー名トークン認証を使用してAXFと通信するIntegration Brokerノードを構成します。

BPMイメージング・ソリューションの場合、ソリューション・ワークスペースは、WebLogic Serverセキュリティによって保護されます。シングル・サインオン(SSO)を有効にすることによって、ビジネス・アプリケーションとソリューション・アプリケーションとの間で複数回のサインオンが必要になることを回避できます。

Oracle E-Business Suiteの詳細は、第2.4.1項を参照してください。

Oracle PeopleSoftの詳細は、第3.2.2.1項を参照してください。

SSL

Oracle E-Business SuiteおよびOracle PeopleSoft

BPMイメージング、BPELイメージングおよび管理対象添付ファイル

Oracle E-Business Suiteの場合、AXF_CONFIGS表およびAXF_PROPERTIES表(Forms)を使用するか、またはOAF_AXF_CONFIGS表およびOAF_AXF_PROPERTIES表(OAF)を使用してSSL設定を構成します。

Oracle PeopleSoftの場合、Integration Brokerを使用してSSL設定を構成します。

Oracle E-Business SuiteとOracle PeopleSoftの両方の場合に、Webサーバー・ベースのデジタル証明をビジネス・アプリケーションおよびOracle WebCenter Content側に構成します。

Oracle E-Business Suiteの詳細は、第2.4.2項を参照してください。

Oracle PeopleSoftの詳細は、第3.2.1項を参照してください。

AXFからコンテンツ・サーバー

Oracle E-Business SuiteおよびOracle PeopleSoft

管理対象添付ファイル

AXFが実行されているホストとコンテンツ・サーバーとの間の信頼できる通信を有効にします。

第7.7.4項を参照してください。

ドキュメント・セキュリティ

Oracle E-Business SuiteおよびOracle PeopleSoft

管理対象添付ファイル

ユーザーは、添付時(コンテンツ・サーバーへのチェックイン時)にドキュメントへのプライベート・アクセスまたは共有アクセスを指定します。

- ユーザーは、「管理対象添付ファイル」ページからのみプライベート・ドキュメントにアクセスできます。

- ドキュメントのセキュリティ・グループ・アクセス権を持っているコンテンツ・サーバー・ユーザーはすべて、共有ドキュメントにアクセスできます。

第7.7.3項を参照してください。

1.7 アダプタのシステム要件

アダプタは、AXF機能を使用するアダプタに標準の、AXF、Imagingおよびコンテンツ・サーバーのファイルの基本構成に加えてインストールされるオプションのソリューションから成ります。アダプタの一般的な要件をこの項で示します。サポートされる構成および動作保証情報は、次のWebページから入手できます。

http://www.oracle.com/technetwork/middleware/webcenter/content/documentation/documentation-155348.html

注意:

構成を開始する際に、My Oracle Supportで、適用可能な最新のパッチがないかどうか確認してください。

一般的な要件には次のものがあります。

- Oracle E-Business Suite

- Oracle PeopleSoft Enterprise

- SOA 11g(イメージング・ソリューションの場合のみ)

- Oracle BPM Suite (BPMイメージング・ソリューションの場合のみ)

- 管理対象添付ファイルの追加要件

1.7.1 Oracle E-Business Suite

- 完全に機能するOracle E-Business Suiteシステム。Oracle E-Business Suiteアプリケーション・アダプタでは、Oracle E-Business Suite Forms(イメージングおよび管理対象添付ファイル)とOAF Webページ(管理対象添付ファイルのみ)の両方がサポートされます。サポートされるリリースの詳細は、動作保証マトリックスを参照してください。第7.1項に示したOracle E-Business Suiteの要件も参照してください。

- Formsアプリケーションの場合、.PLLコンパイルにOracle E-Business Suite Forms Builderが必要です。特定のリリースが、マトリックスにリストされています。

- 重複したログインを回避するために、Oracle Single Sign-OnまたはOracle Access Managerが必要です。詳細は、『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』を参照してください。

注意:

Oracle Single Sign-Onを使用する場合、Oracle Identity Management (OIM)またはOracle Internet Directory (OID)サーバーが必要です。

1.7.2 Oracle PeopleSoft Enterprise

- 完全に機能するOracle PeopleSoftシステムで、PeopleToolsが含まれています。サポートされるリリースの詳細は、動作保証マトリックスを参照してください。

- 重複したログインを回避するために、Oracle Single Sign-OnまたはOracle Access Managerが必要です。詳細は、『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』を参照してください。

注意:

Oracle Single Sign-Onを使用する場合、Oracle Identity Management (OIM)またはOracle Internet Directory (OID)サーバーが必要です。

1.7.3 SOA 11g(イメージング・ソリューションの場合のみ)

いずれのイメージング・ソリューションの場合でも、SOA 11gおよび使用可能なパッチ・セットが必要です。BPELサーバー・インスタンスも必要です。BPELは、SOA 11gに含まれています。

注意:

管理対象添付ファイル・ソリューションのみを構成する場合は、SOA 11gは必要ありません。

注意:

Oracle WebCenter Content(以前のOracle Enterprise Content Management)とSOA Suiteをマップする特定のバージョンが必要です。次のWebページから入手できる動作保証情報を参照してください。

http://www.oracle.com/technetwork/middleware/webcenter/content/documentation/documentation-155348.html

1.7.4 Oracle BPM Suite (BPMイメージング・ソリューションの場合のみ)

BPM用AXFを構成する場合は、Oracle Business Process Management (Oracle BPM)が必要です。Oracle BPMは、BPM Suiteに含まれています。Oracle BPM Suiteは、Oracle SOA Suiteの上に配置されます。

1.7.5 管理対象添付ファイルの追加要件

管理対象添付ファイル・ソリューションには、第7.1項に示した追加要件があります。

管理対象添付ファイル・ソリューションは、コンテンツ・サーバーがWebSphere Application Serverで実行されていて、Application Extension Framework(イメージング・サーバー)がOracle WebLogic Serverで実行されている場合に、WebSphere Application Serverでサポートされます。

1.8 アダプタの構成ロードマップ

この項では、インストール後の、アダプタの主要構成手順を示します。

1. アダプタをOracle E-Business Suiteに構成する場合は、Oracle E-Business Suiteプラグインを構成します。

タスク

参照先

PL/SQLスクリプトを実行して、Oracle E-Business Suiteデータベースを構成します。

第2.1項

いずれか、または両方のOracle E-Business Suiteプラグインを構成します。

- Formsの構成の場合、PLLファイルを変更することによってOracle E-Business Suite Formsをコンパイルします。

- OAFの構成の場合、パーソナライズによって管理対象添付ファイルのボタンをOAFページに追加します。

- 第2.2項(Forms)

- 第2.3項(OAF)

SOAPセキュリティおよびSSLを使用して、Oracle E-Business SuiteからAXFへの通信を保護します。

第2.4項

Oracle E-Business Suiteロギングを構成します。

第2.5項

2. アダプタをOracle PeopleSoftに構成する場合は、PeopleSoftプラグインを構成します。

タスク

参照先

Oracle PeopleSoft統合プロジェクトをインポートします。

第3.1項

AXFと安全に通信するようIntegration Brokerを構成し、Oracle PeopleSoftユーザーに対してAXFアクセスを構成します。

第3.2項

Oracle PeopleSoftページにAXFコンポーネントを配置します。

第3.3項

Oracle PeopleSoftロギングを構成します。

第3.4項

3. AXF設定を構成します。

タスク

参照先

AXFロギングを構成します。

第4.1.1項または第4.1.2項

4. BPMイメージング・ソリューションを構成する場合は、次の手順を完了します。

タスク

参照先

HelloBPMソリューションを実行するか、ソリューション・アクセラレータを適用します。ソリューションを使用して、BPMイメージング機能を確認します。

第5.2.1項

ソリューション管理リンクを使用して、ソリューション・アプリケーションを構成します。ビジネス・ルールおよびコンテキストを管理し、コマンド・ドライバを使用して、タスク・アクション、動的タブ、コンテキストなどの構成をテストおよび確認し、ページを制御します。

第5.2項

HelloBPMソリューションおよびそのユースケースを使用して、ビジネス・ルール変更について学びます。

第5.3項および第5.4項

BPMビューを構成します。(HelloBPMソリューションには、単一管理者ユーザー向けに構成されたBPMビューが用意されています。)

第5.5項

システム管理者は、必要に応じて、Enterprise Managerで構成を変更します。

第5.6項

5. BPELイメージング・ソリューションを構成する場合は、次の手順を完了します。

タスク

参照先

BPEL接続を構成します。

第6.1項

AXF表を構成するか、ソリューション実装アクセラレータを適用します。

初期構成後に、Imagingのソリューション・エディタを使用して、タスク・リストやタスク・ビューアなどのユーザー・インタフェース・コンポーネントを編集します。

第6.2項

第B.2.1項

AXFドライバ・ページを使用して、機能をテストします。

第6.3項

必要に応じてImaging機能をカスタマイズします。

第6.4項

6. 管理対象添付ファイル・ソリューションを構成する場合は、次の手順を完了します。

タスク

参照先

構成が管理対象添付ファイルの追加システム要件を満たしていることを確認します。

第7.1項

管理対象添付ファイルのインストール・スクリプトを実行します。

第7.2項

コンテンツ・サーバー・コンポーネントを構成します。

第7.3項

管理対象添付ファイルをOracle E-Business SuiteとOracle PeopleSoft以外のビジネス・アプリケーションに構成する場合は、エンタープライズ・アプリケーション・アダプタ・フレームワークを構成します。

第7.4項

管理対象添付ファイルの変数を構成します。

第7.5項

必要に応じて、管理対象添付ファイル機能をカスタマイズします。

第7.6項

認証およびセキュリティを構成します。

第7.7項

AutoVueを使用してドキュメントの表示を構成します(オプション)。

第7.8項

Oracle WebCenter CaptureまたはOracle Distributed Document Captureを使用して、ドキュメントのスキャンまたはインポートを構成します(オプション)。

第7.9項、第7.10項

2 Oracle E-Business Suiteプラグインの構成

この章では、WebCenterアダプタ・ソリューションで使用できるようにOracle E-Business Suiteプラグインを構成する方法について説明します。Oracle E-Business Suiteデータベースの構成、Oracle E-Business Suite FormsのコンパイルおよびパーソナライズによるOracle Application Framework (OAF)ページの構成についても説明します。SOAPセキュリティおよびSSLを使用した通信の保護についても説明します。

AXFのOracle E-Business Suite部分では、Oracle E-Business Suiteデータベースへのアクティブな接続、一般的なデータベース操作およびOracle E-Business Suite Forms BuilderとOAFページ・パーソナライズに関する知識が必要です。

注意:

アダプタ・ソリューションをOracle PeopleSoftにはインストールしたが、Oracle E-Business Suiteにはインストールしていない場合は、この章はスキップして、第3章「Oracle PeopleSoftプラグインの構成」で説明している手順を完了してください。

この章の内容は、次のとおりです。

- 第2.1項「Oracle E-Business Suiteデータベースの構成」

- 第2.2項「Oracle E-Business Suite Formsのコンパイル」

- 第2.3項「パーソナライズによるOracle Application Framework (OAF)ページの構成」

- 第2.4項「Oracle E-Business Suiteのアダプタ通信の保護」

- 第2.5項「Oracle E-Business Suiteロギングの構成」

- 第2.6項「ユーザー・ロケールの設定」

- 第2.7項「Oracle E-Business Suiteのソリューションの構成」

- 第2.8項「Oracle E-Business SuiteからのAXFのアンインストール」

2.1 Oracle E-Business Suiteデータベースの構成

アダプタでは、Oracle E-Business Suiteデータベースを使用して、PL/SQLプロシージャおよびOracle E-Business Suite構成情報が格納されます。これらのタスクについては、ローカルのDBAに問い合せてください。この項で説明する手順では、SQL*PLUSの使用が前提となっていますが、Oracle Databaseに問合せを実行できる任意のツールを使用できます。

- 第2.1.1項「AXF用Oracle E-Business Suite構成スキーマ・ユーザー(AXF)の作成」

- 第2.1.2項「提供されているPL/SQLプロシージャ」

- 第2.1.3項「PL/SQLスクリプトの実行」

2.1.1 AXF用Oracle E-Business Suite構成スキーマ・ユーザー(AXF)の作成

次の手順に従って、Oracle E-Business Suiteデータベース内でAXFによって使用するためのデータベース・ユーザーを作成します。

注意:

Oracle E-Business Suite 11iおよびOracle Database 9iを使用している場合は、Oracle XML Database XDB パッケージをOracle E-Business Suiteデータベースにインストールする必要があります。(この要件は、Oracle E-Business Suite 11iおよびOracle Database 9iを使用している場合にのみ適用されます。)Oracle XML Database XDBパッケージのインストールの詳細は、Oracle Database 9iのドキュメントを参照してください。

1. AXFという名前のユーザーを作成します。
ユーザーを作成するには、システム・アカウントのユーザー名とパスワードが必要です。ユーザーの作成については、DBAに問い合せてください。

2. 構成スキーマ・ユーザーに次のアクセス権限を割り当てます。

- 表の作成

- 順序の作成

- タイプの作成

- パブリック・シノニムの作成

- セッションの作成

- プロシージャの作成

- 無制限の表領域

2.1.2 提供されているPL/SQLプロシージャ

表2-1は、実行するPL/SQLスクリプトを示しています。場合によっては、Oracle E-Business Suiteリリース11とリリース12で、別々のスクリプトが提供されます。名前がOAFで始まるスクリプトは、OAF構成に適用されます。

FormsとOAFアプリケーションのいずれ(あるいはその両方)を構成しているかにかかわらず、第2.1.3項で説明しているように、Oracle E-Business Suiteリリースに対してすべてのスクリプトを実行することをお薦めします。

表2-1 Oracle E-Business Suiteプラグインとともに提供されるPL/SQLプロシージャ

PL/SQLプロシージャ

適用先

説明

AXF_CREATE_TABLES_SYNONYM

OAF_AXF_CREATE_TABLES_SYNONYM

Forms

OAF

これらのスクリプトによって、FormsおよびOAFアプリケーションに対してAXFで使用される表およびシノニムが作成されます。また、OAF_AXF_CREATE_TABLES_SYNONYM.sqlによって、OAF_AXF_PROPERTIES表が移入されます。

AXF_EBS_PROPERTIES_DATA

Forms

AXFに対する様々なOracle E-Business Suiteコールに関するセキュリティ情報がAXF_PROPERTIES表に移入されます。

AXF_APPS_INIT

Forms

Formsアプリケーションの場合に、Oracle E-Business Suite添付に必要です。

AXF_ADD_EBS_ATTACHMENT_PROC_R11

AXF_ADD_EBS_ATTACHMENT_PROC_R12

Forms

Oracle E-Business Suite Formsアプリケーションで、トランザクションに添付を追加するストアド・プロシージャを作成します。

AXF_MANAGED_ATTACHMENT_DATA

AXF_MANAGED_ATTACH_AVAIL

AXF_MANAGED_ATTACH_VALUES

Forms

Formsアプリケーションの場合に、ドキュメント添付に必要です。

AXF_SOAP_CALL_PROC

Forms

OAF

このスクリプトは、PL/SQLからのSOAPコールを行うストアド・プロシージャを作成します。

2.1.3 PL/SQLスクリプトの実行

次の手順に従って、Oracle E-Business Suiteデータベースを構成します。

1. 次のフォルダにあるスクリプトを見つけます。Oracle E-Business Suite Formsリリース11とリリース12で、個別のフォルダが提供されています。

- Oracle E-Business Suite Formsの場合:
MW_HOME/ECM_HOME/axf/adapters/ebs/R11/

MW_HOME/ECM_HOME/axf/adapters/ebs/R12/

- Oracle E-Business Suite OAFの場合:
MW_HOME/ECM_HOME/axf/adapters/ebs/oaf/

2. SQL*PLUSを使用して、Oracle E-Business SuiteデータベースにAXF Oracle E-Business Suite構成スキーマ・ユーザー(AXF)としてログインします。
このユーザーは、第2.1.1項で説明しているとおりに前もって作成したものです。

3. AXFユーザーとして、該当するOracle E-Business Suiteの場所からAXF_CREATE_TABLES_SYNONYMスクリプトを実行します。
スクリプトを実行するには、次のコマンドを入力します。

@AXF_CREATE_TABLES_SYNONYM.sql

次の表が作成されたことを確認します。AXF_COMMAND_PARAMETERS、AXF_COMMANDS、AXF_CONFIGS、AXF_PROPERTIESおよびAXF_FND_MAP。

4. AXFユーザーとして、該当するOracle E-Business Suiteの場所からOAF_AXF_CREATE_TABLES_SYNONYMスクリプトをカスタマイズして実行します。
スクリプトを実行する前に、スクリプトによってOracle E-Business Suiteシステムのホスト名とポート(通常は8000)が特定されるように、スクリプトのAXF_OAF_REDIRECT_PAGE_URL値を設定します。

スクリプトを実行するには、次のコマンドを入力します。

@OAF_AXF_CREATE_TABLES_SYNONYM.sql

次の表が作成されたことを確認します。OAF_AXF_CMD_PARAMS、OAF_AXF_COMMANDS、OAF_AXF_CONFIGSおよびOAF_AXF_PROPERTIES。

注意:

AXF_CREATE_TABLES_SYNONYMスクリプトとOAF_AXF_CREATE_SYNONYMスクリプトによって、それぞれAXF_PROPERTIES表とOAF_AXF_PROPERTIES表に行が挿入されます。デフォルトでは、AXF_SOAP_SECURITYセキュリティ・パラメータはTRUEに設定されます。SOAPセキュリティを機能させるには、SOAPユーザーのパスワードをFND_VAULTに格納する必要があります。SOAPユーザー名およびパスワードをOracle E-Business Suite FND_VAULTに格納する手順の詳細は、第2.4項を参照してください。

5. AXFユーザーとして、該当するOracle E-Business Suiteの場所からAXF_EBS_PROPERTIES_DATAスクリプトを実行します。
スクリプトを実行するには、次のコマンドを入力します。

@AXF_EBS_PROPERTIES_DATA.sql

6. APPSユーザーとしてログインします。

7. APPSユーザーとして、該当するOracle E-Business Suiteの場所からAXF_APPS_INITスクリプトを実行します。
次のコマンドを入力して、スクリプトを実行します。

@AXF_APPS_INIT.sql

8. APPSユーザーとして、該当するOracle E-Business Suiteの場所から、AXF_ADD_EBS_ATTACHMENT_PROC_R12スクリプトまたはAXF_ADD_EBS_ATTACHMENT_PROC_R11スクリプトを実行します。
使用しているバージョンに該当するコマンドを入力して、スクリプトを実行します。

@AXF_ADD_EBS_ATTACHMENT_PROC_R12.sql

@AXF_ADD_EBS_ATTACHMENT_PROC_R11.sql

注意:

このコンパイルによって警告が発生する場合がありますが、この警告は無視できます。

9. APPSユーザーとして、該当するOracle E-Business Suiteの場所から、AXF_MANAGED_ATTACH_AVAILスクリプト、AXF_MANAGED_ATTACH_VALUESスクリプトおよびAXF_MANAGED ATTACHMENT_DATAスクリプトを実行します。
次のコマンドを入力して、スクリプトを実行します。

@AXF_MANAGED_ATTACH_AVAIL.sql

@AXF_MANAGED_ATTACH_VALUES.sql

@AXF_MANAGED_ATTACHMENT_DATA.sql

10. APPSユーザーとして、該当するOracle E-Business Suiteの場所からAXF_SOAP_CALL_PROCスクリプトを実行します。
次のコマンドを入力して、スクリプトを実行します。

@AXF_SOAP_CALL_PROC.sql

注意:

このコンパイルによって警告が発生する場合がありますが、この警告は無視できます。

2.2 Oracle E-Business Suite Formsのコンパイル

既存のOracle E-Business Suite Formsにカスタム・アクションをシームレスに統合できるように、特定のファイルがOracle E-Business Suiteシステムにアップロードされ、アダプタで使用されます。アダプタでは、ワークフロー・タスク(イメージング・ソリューション)およびビジネス・レコードに関連付けられているドキュメント(両方のソリューション)へのアクセスに、ユーザー・インタフェース.PLL拡張モジュールが使用されます。

Custom.PLLモジュールは、AXFの機能をコールするよう構成時に少しだけ変更されます。このモジュールは、Oracle E-Business Suiteイベントが発生するたびにAXFに通知して、イベントがAXF機能に関連しているかどうかをAXFが判断できるようにします。

AXF_Custom.PLLコンポーネントは、次の機能を実行します。

- AXFコマンドを実行するWebサービスのコール

- 次のAXFレスポンス・コマンドへの応答

- ブラウザを開く

- 対話の終了

- Oracle E-Business Suite構成データベースに基づいてAXF機能を公開するためのメニューのレンダリング

次の手順に従い、AXF_CUSTOM.pldファイルをコピーして、AXF_CUSTOM.pllファイルに変換し、変更を行ってからAXF_CUSTOM.plxファイルにコンパイルします。

注意:

別のコマンドライン・メソッド(Oracle E-Business Suite 12 Formsに使用する場合のみ適用可能)を使用してAXF_CUSTOM.pllをコンパイルするときは、第2.2.1項を参照してください。

注意:

Oracle Forms Builderの使用法は、そのOracle E-Business Suiteドキュメントを参照してください。

1. 次に示した適用可能なバージョンの場合に、AXF_CUSTOM.pldファイルをE-Businessサーバー(Oracle E-Business Suite 12の場合はFORMS_PATH、Oracle E-Business Suite 11の場合はFORMS60_PATH)にコピーします。
Oracle E-Business Suite 12: MW_HOME/ECM_HOME/axf/adapters/ebs/R12/AXF_CUSTOM.pld

Oracle E-Business Suite 11: MW_HOME/ECM_HOME/axf/adapters/ebs/R11/AXF_CUSTOM.pld

注意:

Linux/UNIXシステムを使用していて、Windowsシステムから.PLDをコピーした場合は、次のような変換を実行する前に、dos2unixコマンドを発行します。

2. Oracle Forms Builderを開き、Oracle E-Business SuiteデータベースにAPPSユーザーとして接続します。Forms Builderは通常、データベースのOracleホームの/bin/サブディレクトリにあります。

注意:

Oracle E-Business Suiteデータベースに接続していることを確認してください。接続に失敗した場合は、tnsnames.oraファイルを確認してください。

3. Forms Builderで、AXF_CUSTOM.pldをAXF_CUSTOM.pllに変換します。

- Oracle E-Business Suite 12では、「ファイル」を選択して、「変換」を選択します。

- Oracle E-Business Suite 11では、「ファイル」を選択して、「管理」を選択してから、「変換」を選択します。

ファイルの変換時に、PL/SQLライブラリおよびテキストからバイナリを選択します。

注意:

AXF_CUSTOM.pldからAXF_CUSTOM.pllへの変換時に次のエラーが表示された場合は、ファイルが正常に変換されるまでこの手順を繰り返します。

PDE-PLI038: ファイルをPL/SQLライブラリとして開けません

注意:

変換時に次のエラーが表示された場合は、ファイルが正常に変換されるまで「OK」を繰り返しクリックします。

PDE-PLI018: ライブラリAXF_CUSTOMは見つかりませんでした

4. 「ファイル」メニューから、AXF_CUSTOM.pllを開きます。

- Oracle E-Business Suite 12では、「プログラム」を選択し、PL/SQLのコンパイルを選択してから、「すべて」を選択します。

- Oracle E-Business Suite 11では、「プログラム」を選択し、「コンパイル」を選択してから、「すべて」を選択します。

5. AXF_CUSTOMをモジュール(.plx)にコンパイルします。

- Oracle E-Business Suite 12では、「プログラム」を選択して、モジュールのコンパイルを選択します。

- Oracle E-Business Suite 11では、「ファイル」を選択して、「管理」を選択してから、ファイルのコンパイルを選択します。

注意:

- APPSスキーマ・ユーザーIDを使用してAXF_CUSTOMをコンパイルする必要があります。

- コンパイル時に、以下の識別子またはAPPCORE.pll内のオブジェクトを参照するその他のエラーが発生した場合、APPCORE.pllファイルをフォームに添付する必要があることを示しています。
'APP_SPECIAL.ENABLE' を(a)と定義する必要があります。

6. 「ファイル」を選択して、「接続」を選択し、APPSユーザーとしてデータベースに接続されていることを確認します。

7. CUSTOM.pllファイルのバックアップを作成します。

警告:

CUSTOM.pllに対する変更は、Oracle E-Business Suiteインフラストラクチャに対する変更です。変更を加える前に、必ずこのファイルのバックアップを適切に作成しておきます。

8. 「ファイル」を選択して、「開く」を選択し、「ファイルのタイプ」フィールドのPL/SQLライブラリ(*.pll)を選択して、CUSTOM.pllを開きます。ファイルを開いて、「プログラム・ユニット」を開いてから、CUSTOM.pllのカスタム・パッケージ本体を右クリックして、PL/SQLエディタを選択します。

9. CUSTOM.pllのボディ・テキストで、構成しているソリューション別に、太字イタリック形式になっている次のテキストを変更します。ファイルに他のカスタマイズが含まれている場合は、各関数またはプロシージャ内の既存コードの後ろに次の変更を配置します。

- 管理対象添付ファイルのみまたは両方のソリューションの場合:

function zoom_available return boolean is
begin

-- Required for ALL integrations
return true;
end zoom_available;

- イメージング・ソリューションのみの場合:

function zoom_available return boolean is
begin

-- Required for ALL integrations
return AXF_CUSTOM.zoom_available();
end zoom_available;

重要:

pllのヘッダーではなく、ボディ・テキストを変更してください。次のコメント・ヘッダーまでスクロール・ダウンします。

- -Real code starts here

10. CUSTOM.pllのボディ・テキストで、太字イタリック形式になっている次のテキストを変更します。ファイルに他のカスタマイズが含まれている場合は、各関数またはプロシージャ内の既存コードの後ろに次の変更を配置します。

procedure event(event_name varchar2) is
begin

-- Required for AXF integrations
AXF_CUSTOM.event(event_name);
null;

end event;

注意:

null;の行を削除しないでください。

11. 「ファイル」を選択して、「保存」を選択し、CUSTOM.pllを保存します。

12. CUSTOM.pllが開いた状態で、AXF_CUSTOMが添付ライブラリとしてリストされているかどうかを確認します。

- リストされている場合、AXF_CUSTOMを選択して、マイナス(-)記号をクリックし、これを連結解除します。その上で、CUSTOMの下の添付ライブラリを選択し、プラス(+)記号をクリックして、AXF_CUSTOMを再添付し、AXF_CUSTOM.pllを参照して、これを選択します。

- リストされていない場合は、CUSTOMの下の添付ライブラリを選択し、プラス(+)記号をクリックして、AXF_CUSTOMを添付し、AXF_CUSTOM.pllを参照して、これを選択します。

パスの削除を求められた場合は、「はい」をクリックします。

13. CUSTOM.pllが開いた状態で、APPCOREおよびAPPCORE2が、AXF_CUSTOM.pllの添付ライブラリとしてリストされていることを確認します。リストされていない場合は、これらを添付します。リストされている場合は、いったん連結解除してから、添付します。

14. CUSTOM.pllが開いた状態で、「プログラム」を選択し、PL/SQLのコンパイルを選択してから、「すべて」を選択するか(Oracle E-Business Suite 12)、「プログラム」を選択し、「コンパイル」を選択してから、「すべて」を選択します(Oracle E-Business Suite 11)。

15. 「プログラム」を選択して、モジュールのコンパイルを選択する(Oracle E-Business Suite 12)か、「ファイル」を選択して、「管理」を選択してからファイルのコンパイルを選択し(Oracle E-Business Suite 11)、CUSTOMをモジュール(.plx)にコンパイルします。

16. Forms Builderを終了する前に、すべてを保存します。該当するOracle E-Business Suiteフォームに、「ズーム」メニュー・コマンドが表示されることを確認します。

2.2.1 コマンドラインを使用したAXF_CUSTOM.pllのコンパイル

この項では、アダプタ使用のOracle E-Business Suite Formsをコンパイルするための、別のコマンドライン・メソッドについて説明します。これはOracle E-Business Suite 12 Formsの使用にのみ適用され、Oracle E-Business Suite 11には適用されません。

次の手順に従い、AXF_CUSTOM.pldファイルをコピーして、AXF_CUSTOM.pllファイルに変換し、変更を行ってからAXF_CUSTOM.plxファイルにコンパイルします。その後で、第2.2項の手順に従って、示されているとおりに別のファイルCUSTOM.pllを変更して、Forms構成を完了します。

1. AXF_CUSTOM.pldファイルをUNIXシステムにコピーして、dos2unixコマンドを実行し、このファイルをUNIX形式に変換します。
または、このファイルをviエディタで開き、ファイルから^M文字を手動で削除します。

2. 次のコマンドラインを入力し、AXF_CUSTOM.pldをAXF_CUSTOM.pllに変換します。

$APPL_TOP/au/12.0.0/resource>frmcmp_batch.sh module=AXF_CUSTOM.pld  userid=apps/apps output_file=AXF_CUSTOM.pll module_type=library parse=yes

3. 次のコマンドラインを入力し、AXF_CUSTOM.pllをAXF_CUSTOM.plxに変換します。

$APPL_TOP/au/12.0.0/resource>frmcmp_batch.sh module=AXF_CUSTOM.pll userid=apps/apps output_file=AXF_CUSTOM.plx module_type=library compile_all=special

4. 第2.2項の手順に従って、手順6から始め、CUSTOM.pllファイルを変更します。残りの手順を完了します。

2.3 パーソナライズによるOracle Application Framework (OAF)ページの構成

OAFページの管理対象添付ファイル機能は、次のように動作します。

- OAFパーソナライズを使用して、管理対象添付ファイルのボタンをOAFページに手動で追加します。これには、MDSリポジトリにインポートされたカスタム・フレックス・リージョンにボタンをに配置します。

- このボタンは汎用拡張コントローラ・クラスに関連付けられます。このコントローラ・クラスは、Oracle E-Business Suiteからのコールをカスタムの中間OAFページにリダイレクトして、必要なOracle E-Business Suiteマッピング・エントリを渡します。

- コントローラ・クラスでは、どのOAFページにコールされたのかが分析されます。OAFページのキー識別子(名前、ビュー・オブジェクト、主キー属性およびラベル)がデータベース表に格納されます。コントローラをコールしたOAFページに基づいて、ソリューションでは、データベース表から該当する行と必要なビジネス・エンティティ値がフェッチされます。これらのビジネス・エンティティ値は、パラメータとしてカスタムの中間OAFページのURLに追加されます。

- ユーザーが管理対象添付ファイルのボタンをクリックすると、カスタムの中間OAFページが開き、ProcessRequestメソッドがコールされ、SOAPパケットが作成されます。SOAPコールで、コンテンツ・サーバーのURLがフェッチされ、ロード時にページはこのコンテンツ・サーバーのURLにリダイレクトされます。

注意:

管理対象添付ファイル機能にOAFページを構成することに加えて、第2.3.3項で説明しているように、OAFページにイメージングへのアクセスを提供することもできます。

Oracle E-Business Suite OAFプラグインを構成するには、次の各項の手順に従ってください。

- 第2.3.1項「Javaファイルのコンパイル、クラス・ファイルのコピーおよびXMLファイルのインポート」

- 第2.3.2項「管理対象添付ファイルを追加するためのOAFページのパーソナライズ」

- 第2.3.3項「OAFページのその他のサービスの構成(オプション)」

2.3.1 Javaファイルのコンパイル、クラス・ファイルのコピーおよびXMLファイルのインポート

次の手順に従って、Javaファイルをコンパイルし、クラス・ファイルをコピーして、XMLファイルをMDSリポジトリにインポートして、管理対象添付ファイルのボタンをOAFページに追加できるようにします。第2.3.2項で、MDSリポジトリからカスタム・フレックス・リージョンにボタンを追加します。

注意:

この手順では、JDeveloperを使用してJavaファイルをコンパイルする作業に精通していることが前提となっています。基本情報は、次のWebページにある、JDeveloper 10gを使用した初めてのプログラムの作成に関する項を参照してください。

http://download.oracle.com/otndocs/tech/ias/portal/files/RG/OBE/FirstStep/FirstStep.htm

1. 使用しているOracle E-Business Suiteのリリースに対応する正しいJDeveloperバージョンを使用していることを確認してください。http://support.oracle.comで、次の記事を検索し、使用しているJDeveloperバージョンに、必要なOAFパッチが含まれていることを確認します。適切なバージョンではない場合は、該当するJDeveloper OAFパッチ・ファイルをダウンロードして、解凍します。

- Doc ID 416708.1: Oracle E-Business Suite 11iまたはリリース12.xで使用するために、適切なバージョンのJDeveloperを検索する方法

- Doc ID 416708.1: Oracleアプリケーションに対するJDeveloperの設定のトラブルシューティング

2. JDeveloperを起動して、アプリケーションを作成します。新規アプリケーション内で、プロジェクトを作成します。

3. 次の場所で、JavaファイルGenericUcmButtonCO.javaおよびRedirectToAxfCO.javaを見つけ、プロジェクトに追加します。
$MiddlewareHome/OracleHome/axf/adapters/ebs/oaf/src/oracle/apps/ak/ucm/axf/webui

「プロジェクト・コンテンツの追加」を選択して、「追加」ボタンをクリックし、対象のJavaファイルが含まれるフォルダを選択します。

4. プロジェクトのプロパティで、次のOAFライブラリを追加します。

- BC4Jクライアント

- BC4Jランタイム(注意: BC4J EJBランタイムを追加しないでください)

- Cabo

- FNDライブラリ

5. プロジェクトでJavaファイルをコンパイルします(プロジェクトを右クリックして、「再ビルド」を選択します)。

6. クラス・ファイル(プロジェクトのプロパティで、Output Directoryを見つけます。これには、生成されたクラスが含まれます)を、指定したOracle E-Business Suite中間層の$JAVA_TOPディレクトリにコピーします。このとき、必要なディレクトリ構造を作成します。

- コピーするクラス・ファイル: GenericUcmButtonCO.classおよびRedirectToAxfCO.class

- クラス・ファイルのコピー先のOracle E-Business Suite Serverディレクトリ:
$JAVA_TOP/oracle/apps/ak/ucm/axf/webui

7. 汎用フレックス・レイアウト・リージョン用のXMLファイルをMDSリポジトリにインポートします。

- インポートするXMLファイル: ManagedAttachmentButtonRN.xml

- コマンドの実行元のディレクトリ($JDEV_USER_HOMEの場合があり、次に2つ上のレベルのjdevbinになります):
$JdevHome/jdevbin/oaext/bin

- 実行するManagedAttachmentButtonRN importコマンド(コマンド・プロンプトから実行し、イタリックのパラメータを置換します):

./import Full path to ManagedAttachmentButtonRN.xml -username appsUsername -password appsPassword -dbconnection "(description = (address_list = (address = (community = tcp.world)(protocol = tcp)(host = DB Hostname)(port = DB Port)))(connect_data = (sid = DB SID)))" -rootdir path to directory where ManagedAttachmentButtonRN.xml is located -rootPackage /oracle/apps/ak/ucm/axf/webui

- ManagedAttachmentButtonRN importコマンドの例(ここでは、XMLファイルは$JAVA_TOPディレクトリにあります):

./import /$JAVA_TOP/ManagedAttachmentButtonRN.xml -username apps -password password -dbconnection "(description = (address_list = (address = (community = tcp.world)(protocol = tcp)(host = DB Hostname)(port = DB Port)))(connect_data = (sid = DB SID)))" -rootdir /$JAVA_TOP -rootPackage /oracle/apps/ak/ucm/axf/webui

注意:

インポートが失敗して、jarファイルが見つからないというエラーが返された場合は、oamdsdt.jar fileのフルパスを、インポート・スクリプト(Linuxではimport file、Windowsではimport.bat)のCLASSPATHエントリに追加します。oamdsdt.jarのフルパスは、次のとおりです。

$JdevHome/jdevbin/oaext/lib/oamdsdt.jar

たとえば、import fileには通常、次の形式のCLASSPATHエントリが含まれます。

set CLASSPATH=$JRAD_ROOT/jdev/appslibrt/uix2.jar

次のように、必要なjarを追加して変更します。

set CLASSPATH=$JRAD_ROOT/jdev/appslibrt/uix2.jar:/oracle/r12/JDeveloper/jdevbin/oaext/lib/oamdsdt.jar

8. リダイレクトに使用するカスタムOAFページのXMLファイルをMDSリポジトリにインポートします。

- インポートするXMLファイル: RedirectToAxfPG.xml

- コマンドの実行元のディレクトリ:
$JdevHome/jdevbin/oaext/bin

- 実行するRedirectToAxfPG importコマンド(コマンド・プロンプトから実行し、イタリックのパラメータを置換します):

./import Full path to RedirectToAxfPG.xml -username appsUsername -password appsPassword -dbconnection "(description = (address_list = (address = (community = tcp.world)(protocol = tcp)(host = DB Hostname)(port = DB Port)))(connect_data = (sid = DB SID)))" -rootdir Path to directory where RedirectToAxfPG.xml is located -rootPackage /oracle/apps/ak/ucm/axf/webui

RedirectToAxfPG importコマンドの例(ここでは、XMLファイルは$JAVA_TOPディレクトリにあります):

./import /$JAVA_TOP/RedirectToAxfPG.xml -username apps -password password -dbconnection "(description = (address_list = (address = (community = tcp.world)(protocol = tcp)(host = DB Hostname)(port = DB Port)))(connect_data = (sid = DB SID)))" -rootdir /$JAVA_TOP -rootPackage /oracle/apps/ak/ucm/axf/webui

注意:

インポートが失敗して、jarファイルが見つからないというエラーが返された場合は、手順7の注意を参照してください。

9. SQLプロンプトから次のコマンドをOracle E-Business Suite APPSユーザーとして実行し、インポートが正常に完了したことを確認します。

SET SERVEROUTPUT ON
BEGIN
JDR_UTILS.PRINTDOCUMENT('/oracle/apps/ak/ucm/axf/webui/RedirectToAxfPG');
JDR_UTILS.PRINTDOCUMENT('/oracle/apps/ak/ucm/axf/webui/ManagedAttachmentButtonRN');
END;
/

10. FNDLOADを使用して、oaf_axf_messages.ldtメッセージ・バンドルをロードします。このファイルには、コントローラ・クラスで使用される変換可能メッセージが含まれます。

- LD_LIBRARY_PATH変数が$ORACLE_HOME/libに設定されていることを確認します。

- Oracle E-Business Suite APPSユーザーとして、$FND_TOP/binから次のコマンドを実行します。

FNDLOAD apps/$CLIENT_APPS_PWD 0 Y UPLOAD $FND_TOP/patch/115/import/afmdmsg.lct Full path to oaf_axf_messages.ldt

- プロンプトが表示されたら、APPSユーザー・パスワードを入力します。

11. Oracle E-Business Suiteインスタンスを再起動します。

2.3.2 管理対象添付ファイルを追加するためのOAFページのパーソナライズ

管理対象添付ファイルのボタンを表示するOAFページごとに次の手順を実行します。パーソナライズによってフレキシブル・レイアウトを作成し、フレキシブル・コンテンツとしてMDSリポジトリに前にインポートした管理対象添付ファイル・ボタンのファイルを追加します。

注意:

OAFページごとに、管理対象添付ファイルのボタンを1つのみ追加します。複数のボタンを組み込むと、同一のコントローラ・コードが複数回実行されることになってしまいます。

管理対象添付ファイル機能を、OAFページの明細項目の添付ファイルに実装することはできません。

1. Oracle E-Business SuiteにOPERATIONSユーザーとしてログインします。

2. 管理対象添付ファイルのボタンの追加先のOAFページを表示し、ページの上部にある「ページのパーソナライズ」リンクをクリックします。

3. 「ページのパーソナライズ」ページのパーソナライズ構造で、「完全ビュー」オプションを選択し、「すべて開く」リンクをクリックします。OAFページ上のすべてのリージョンの完全な階層ビューが表示されます。

4. フレキシブル・レイアウトを作成して、構成します。

1. OAFページ上でボタンの表示場所となるリージョンまで階層リストをスクロール・ダウンし、「アイテムの作成」アイコンをクリックします。図2-1に示したような「アイテムの作成」ページが表示されます。

2. 「レベル」フィールドで、「サイト」を選択します。

3. 「アイテム・スタイル」フィールドで、フレキシブル・レイアウトを選択します。

4. 「ID」フィールドに、任意の値(たとえば、test)を入力します。

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

図2-1 フレキシブル・レイアウトの作成

5. フレキシブル・コンテンツを作成して、構成します。

1. 階層リストで、追加したばかりのフレキシブル・レイアウトを見つけ、その「アイテムの作成」アイコンをクリックします。図2-2に示したような「アイテムの作成」ページが表示されます。

2. 「アイテム・スタイル」フィールドで、フレキシブル・コンテンツを選択します。

3. 「ID」フィールドに、任意の値(たとえば、test1)を入力します。

4. 拡張フィールドに、(第2.3.1項で)MDSリポジトリにインポートしたフレックス・リージョンのパッケージを入力します。

/oracle/apps/ak/ucm/axf/webui/ManagedAttachmentButtonRN

図2-2 フレキシブル・コンテンツの作成

6. 「Apply」ボタンをクリックします。

図2-3 パーソナライズによって管理対象添付ファイルのボタンを追加した後のページ階層

2.3.3 OAFページのその他のサービスの構成(オプション)

OAFページでは、管理対象添付ファイル・ソリューションのかわりに、イメージング・ソリューションへのアクセスを提供できます。たとえば、イメージング・ソリューションで使用可能な仕入先の保守機能にユーザーがアクセスできるようにするボタンを組み込むことができます。

次に、カスタム・ボタン(管理対象添付ファイルのボタンのかわり)を追加して、ボタンのアクションをデータベース表で管理対象添付ファイルではなくイメージングとして特定する場合に実行する手順を示します。

1. 第2.3.1項の手順7を除くすべての手順を完了します。(手順7はManagedAttachmentButtonRN.xmlファイルをインポートする手順であるため、必要ありません。)

2. 次のボタンIDおよびボタン・プロンプト(タイトル)の値を変更することによって、提供されているサンプルのXMLファイル(SampleAXFButtonRN.xml)をカスタマイズします。
<oa:button id="AXFButton" prompt="Sample AXF Button"/>

たとえば、ボタンIDをIPM_BUTTONに、ボタン・プロンプト(タイトル)をSupplier Maintenanceに変更します。

3. XMLファイルをMDSリポジトリにインポートします。

- インポートするXMLファイル: SampleAXFButtonRN.xml(または変更したバージョン)

- コマンドの実行元のディレクトリ:
$JdevHome/jdevbin/oaext/bin

- 実行するimportコマンド(コマンド・プロンプトから実行し、イタリックのパラメータを置換します):

./import  Full path to XML file -username apps -password appsPassword -dbconnection "(description = (address_list = (address = (community = tcp.world)(protocol = tcp)(host = DB Hostname)(port = DB Port)))(connect_data = (sid = DB SID)))" -rootdir path to directory where XML file is located -rootPackage /oracle/apps/ak/ucm/axf/webui

- importコマンドの例(ここで、XMLファイルは$JAVA_TOPディレクトリにあります):

./import /$JAVA_TOP/SampleAXFButtonRN.xml  -username appsUsername -password appsPassword -dbconnection "(description = (address_list = (address = (cUommunity = tcp.world)(protocol = tcp)(host = DB Hostname)(port = DB Port)))(connect_data = (sid = DB SID)))" -rootdir /$JAVA_TOP -rootPackage /oracle/apps/ak/ucm/axf/webui

4. OAF_AXF_COMMANDS表(Oracle E-Business Suite OAF)でコマンドにこのボタンIDを使用します。新規ボタンIDは、AXF_EVENT_IDに対応することになります。第C.3.3.2項に例を示しています。

5. OAF_AXF_CMD_PARAMS表で、AXF_EVENT_IDに必要なコマンド・パラメータがあれば、それらを追加します。

6. 第2.3.2項の手順に従って、前述のインポートしたボタンをパーソナライズを使用して追加します。第2.3.2項の手順5では、その項の手順3でMDSリポジトリにインポートしたパッケージの名前を必ず入力してください。提示した例では、この名前は/oracle/apps/ak/ucm/axf/webui/SampleAXFButtonRNです。

2.4 Oracle E-Business Suiteのアダプタ通信の保護

この項の内容は次のとおりです。

- 第2.4.1項「SOAPセキュリティを使用した通信の保護」

- 第2.4.2項「SSLを使用した通信の保護(Oracle E-Business Suite)」

2.4.1 SOAPセキュリティを使用した通信の保護

次の手順に従って、SOAPセキュリティを構成します。SOAPセキュリティでは、アプリケーションからSOAPユーザーおよびパスワードが認証用にヘッダーで送信されます。

注意:

SOAPセキュリティの構成が必要です。

1. SOAPセキュリティが有効になっていることを確認します。これを行うには、AXF_PROPERTIES表(Oracle E-Business Suite)およびOAF_AXF_PROPERTIES表(Oracle E-Business Suite OAF)のAXF_SOAP_SECURITYプロパティでSOAPセキュリティがTRUEに設定されていることを確認します。

2. AXF_SOAP_POLICYプロパティをUSER_NAME_TOKENに設定します。

3. AXF_SOAP_USER値を設定します(たとえば、weblogicに設定します)。デフォルトで、この設定はAXFになっている可能性があり、変更する必要があります。AXF_SOAP_USERは、有効なOracle WebLogic Server管理者です。

4. 次のコマンドをAPPSスキーマとして実行して、データベース・ボールトにSOAPパスワードを格納します。
execute fnd_vault.put('AXF','AXF_SOAP_USER','SOAP_PASSWORD');

ここで、AXF_SOAP_USERは、認証用にSOAPヘッダーで使用されるSOAPユーザーIDで、SOAP_PASSWORDはSOAPパスワードです。(最初のアイテム'AXF'は、このまま含める必要がある識別子です。)

たとえば、次のようになります。

execute fnd_vault.put('AXF','weblogic','examplepassword');

5. 前述のコマンドを次の文で確認します。
select fnd_vault.get ('AXF','AXF_SOAP_USER') from dual;

たとえば、次のようになります。

select fnd_vault.get ('AXF','weblogic') from dual;

2.4.2 SSLを使用した通信の保護(Oracle E-Business Suite)

次の手順を実行して、AXFのSSL構成にOracle E-Business Suiteシステム設定を指定します。

- 第2.4.2.1項「Oracle Walletの構成」

- 第2.4.2.2項「SSLの統合の構成」

2.4.2.1 Oracle Walletの構成

1. Oracle Wallet Managerを実行します。Linuxでは、owm実行ファイルは次の場所にあります。
//ORACLE_HOME/bin/owm

2. ウォレットを作成します。ウィザードを使用して、必要な情報を入力し、証明書を作成します。ファイルをエクスポートします。

3. 証明書リクエストをCA (Verisignなどの認証局)に送信して、新規証明書を購入します。

4. SSL証明書を拡張子.cerで保存します。ほとんどの場合、CAからは、SSL証明書、中間証明書および信頼されたルート証明書を電子メールで提供されます。

5. 「信頼できる証明書」を右クリックして、ルート証明書と中間証明書をOracle Walletにインポートします。

6. SSL証明書をWallet Managerにインポートします。
プロセスが正常に完了したら、「準備完了」ステータスが表示されます。

ヒント:

SSL証明書をインポートする場合、必要に応じて、「リクエストされた証明書」ツリー項目を右クリックします。

7. FORMS_PATHで定義されているいずれかのフォルダにウォレットを保存します。(ewallet.p12という名前で保存されます)。

2.4.2.2 SSLの統合の構成

詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverの保護』のSSLの構成に関する項を参照してください。

1. Oracle E-Business Suiteデータベースで、次のSQL文を実行します。

1. Oracle E-Business Suite Formsアプリケーションの場合:

update AXF_PROPERTIES set propvalue='file:walletpath' where propname = 'AXFWalletPath';
update AXF_PROPERTIES set propvalue='ON/OFF' where propname = 'SecureMode';
commit;

2. Oracle E-Business Suite OAFアプリケーションの場合:

update OAF_AXF_PROPERTIES set propvalue='file:walletpath' where propname = 'AXFWalletPath';
update OAF_AXF_PROPERTIES set propvalue='ON/OFF' where propname = 'SecureMode';
commit;

2. SecureMode設定およびセキュア・ポートを反映するように表を更新します。SecureModeがオンの場合、統合では、SSL (https)を使用してAXFアプリケーションへの接続が試行されます。

1. Oracle E-Business Suite AXF_CONFIGS表で、SecureModeがオンの場合はhttps://で開始するように、またはSecureModeがオフの場合はhttp://で開始するようにSOLUTIONENDPOINTを更新します。Oracle WebCenter Content側のセキュア・ポートに一致するようにPortを変更します。

2. Oracle E-Business Suite OAF_AXF_CONFIGS表で、SecureModeがオンの場合はhttps://で開始するように、またはSecureModeがオフの場合はhttp://で開始するようにSOLUTIONENDPOINTを更新します。Oracle WebCenter Content側のセキュア・ポートに一致するようにPortを変更します。

イメージングの構成の場合は、第B.4.2項を参照してください。管理対象添付ファイルのFormsの構成の場合は、第C.2.1項を参照してください。管理対象添付ファイルのOAFの構成の場合は、第C.3.1項を参照してください。

3. 次のコマンドをAPPSスキーマとして実行して、データベース・ボールトにウォレットのパスワードを格納します。
execute fnd_vault.put('AXF','AXFWalletKey','WalletPassword');

ここで、WalletPasswordは、ウォレットのパスワードです。

4. 前述のコマンドを次の文で確認します。
select fnd_vault.get ('AXF','AXFWalletKey') from dual;

5. AXF証明書をウォレットにインポートします。

6. Oracle WebCenter Content側で、Oracle WebLogic ServerのSSLを有効にします。
詳細は、『Oracle Fusion Middleware Oracle WebCenter Contentのインストールと構成』のOracle WebCenter ContentアプリケーションへのSSLの構成に関する項を参照してください。

7. Webサーバー間でサーバー証明書を交換します。
この手順には、統合のOracle WebCenter Content側でのOracle Walletからの証明書のエクスポートおよびOracle WebLogic Serverキーストアへのその証明書のインポートが含まれます。このキーストアを、管理サーバーおよびImagingサーバーの両方で有効にしておく必要があります。また、Oracle Weblogic Serverからサーバー証明書をエクスポートして、それをOracle Walletにインポートする必要があります。

2.5 Oracle E-Business Suiteロギングの構成

- 第2.5.1項「Formsアプリケーションのロギングの構成」

- 第2.5.2項「OAFアプリケーションのロギングの構成」

2.5.1 Formsアプリケーションのロギングの構成

AXF_CONFIGS表で特定のフォームのロギングを有効にします。イメージング・ソリューションの場合は、第B.4.2項を参照してください。管理対象添付ファイル・ソリューションの場合は、第C.2.1項を参照してください。

特定のフォーム機能のロギングを有効にするには、LOGENABLEDフィールドを1、YESまたはTRUEのいずれかに設定して、UTL_FILE_DIRフォルダにファイルを作成します。DBAに問い合せて、UTL_FILE_DIRフォルダが使用可能かつアクセス可能であることを確認してください。ログ・ファイルにはUsername_MASTER_LOG.txtという名前が付けられ、アイテムが追加されるにつれ、増大していきます。

2.5.2 OAFアプリケーションのロギングの構成

次の手順に従って、特定のOAFページの診断を有効にします。

1. OAFページの上部にある「診断」リンクをクリックします。

2. 「診断」ページで、次の設定を選択します。

1. 「診断」フィールドで、ログオン・ページの表示を選択します。

2. 「ログ・レベル」フィールドで、文(1)を選択します。

3. 「実行」をクリックします。

4. エラーが発生したページに移動します。ページで文字列Debug-->を検索します。

2.6 ユーザー・ロケールの設定

AXFの起動時に異なるロケールによる問題が生じないように、Oracle E-Business Suiteユーザーは、ユーザー・ロケール・プリファレンスとブラウザのロケールに同一の値を設定する必要があります。管理対象添付ファイル・ソリューションを使用している場合は、コンテンツ・サーバーのロケールに、同じ値を設定します。

2.7 Oracle E-Business Suiteのソリューションの構成

各ソリューションを構成するための追加タスクは、次に示した各項を参照してください。

イメージング・ソリューションの場合

イメージング・ソリューションは、第6章で示しているように構成します。第B.4項で示しているようにAXF関連のOracle E-Business Suiteの表を構成するか、または第6.2項で示しているようにソリューション・アクセラレータを適用します。

注意:

Oracle E-Business Suiteイメージング・ソリューションは、Formsベースのアプリケーションのみでサポートされます。OAFアプリケーションではサポートされません。

管理対象添付ファイル・ソリューションの場合

1. 管理対象添付ファイル・ソリューションは、第7章で示しているように構成します。コンテンツ・サーバー・コンポーネントを構成し、AXF_ATTACHMENTS_CONFIG.sqlスクリプトを実行してソリューションやコマンドなどのAXF要素を構成することに加えて、FormsアプリケーションおよびOAFアプリケーションの表に値を移入するスクリプトを実行する必要があります。

1. Formsアプリケーションの場合、AXF_EBS_ATTACHMENTS_CONFIG.sqlを実行することによって、管理対象添付ファイル・ソリューションを有効にするよう「ズーム」メニューが構成されます。詳細は、7.2.2項を参照してください。

2. OAFアプリケーションの場合、OAF_AXF_EBS_ATTACHMENTS_CONFIG.sqlスクリプトを実行することによって、選択したOAFページ(使用するOAFページ用に変更可能)に対する管理対象添付ファイル・ソリューションについて第C.4項に示されている表に値が移入されます。詳細は、7.2.3項を参照してください。

2.8 Oracle E-Business SuiteからのAXFのアンインストール

Oracle E-Business SuiteからAXFをアンインストールするには、Oracle E-Business Suite構成に適用される次の手順に従ってください。

- 第2.8.1項「Oracle E-Business Suite Formsからのアンインストール」

- 第2.8.2項「Oracle E-Business Suite OAFからのアンインストール」

2.8.1 Oracle E-Business Suite Formsからのアンインストール

1. AXF構成スキーマ・ユーザーに次の権限を割り当てます。

- 表の削除

- 順序の削除

- パブリック・シノニムの削除

2. AXFユーザーとして、次のOracle E-Business Suiteのバージョン別に該当する場所から、AXF_DROP_TABLES_SYNONYMスクリプトを実行します。このスクリプトによって、インストール時に実行されたAXF_CREATE_TABLES_SYNONYMスクリプトによって作成されたすべての表、シノニムおよび順序が削除されます。
Oracle E-Business Suite 12: MW_HOME/ECM_HOME/axf/adapters/ebs/R12/AXF_DROP_TABLES_SYNONYM.sql

Oracle E-Business Suite 11: MW_HOME/ECM_HOME/axf/adapters/ebs/R11/AXF_DROP_TABLES_SYNONYM.sql

次のコマンドを入力して、スクリプトを実行します。

@AXF_DROP_TABLES_SYNONYM.sql

3. AXFデータベース・スキーマ・ユーザーを削除します。

4. AXF_CUSTOM.*(AXF_CUSTOM.pll、AXF_CUSTOM.pldおよびAXF_CUSTOM.plx)をFORMS_PATH(またはOracle E-Business Suite 11システムの場合はFORMS60_PATH)から削除します。

5. 手順7(第2.2項)でバックアップを作成したCUSTOM.pllファイルをリストアします。

6. Oracle Forms Builderを開き、Oracle E-Business SuiteデータベースにAPPSユーザーとして接続します。Forms Builderは通常、データベースのOracleホームの/bin/サブディレクトリにあります。

7. 「ファイル」を選択して、「開く」を選択し、「ファイルのタイプ」フィールドのPL/SQLライブラリ(*.pll)を選択して、リストアしたCUSTOM.pllを開きます。

8. CUSTOM.pllが開いた状態で、「プログラム」を選択し、PL/SQLのコンパイルを選択してから、「すべて」を選択するか(Oracle E-Business Suite 12)、「プログラム」を選択し、「コンパイル」を選択してから、「すべて」を選択します(Oracle E-Business Suite 11)。

9. 「プログラム」を選択して、モジュールのコンパイルを選択する(Oracle E-Business Suite 12)か、「ファイル」を選択して、「管理」を選択してからファイルのコンパイルを選択し(Oracle E-Business Suite 11)、CUSTOMをモジュール(.plx)にコンパイルします。

10. Forms Builderを終了する前に、すべてを保存します。

2.8.2 Oracle E-Business Suite OAFからのアンインストール

1. AXF構成スキーマ・ユーザーに次の権限を割り当てます。

- 表の削除

- 順序の削除

- パブリック・シノニムの削除

2. AXFユーザーとして、次に示した場所からOAF_AXF_DROP_TABLES_SYNONYMスクリプトを実行します。このスクリプトによって、インストール時に実行されたOAF_AXF_CREATE_TABLES_SYNONYMスクリプトによって作成されたすべての表、シノニムおよび順序が削除されます。
MW_HOME/ECM_HOME/axf/adapters/ebs/oaf/OAF_AXF_DROP_TABLES_SYNONYM.sql

次のコマンドを入力して、スクリプトを実行します。

@OAF_AXF_DROP_TABLES_SYNONYM.sql

3. AXFデータベース・スキーマ・ユーザーを削除します。

3 Oracle PeopleSoftプラグインの構成

この章では、1つ以上のWebCenterアプリケーション・アダプタ・ソリューションで使用できるようにOracle PeopleSoftプラグインを構成する方法について説明します。Oracle PeopleSoftプロジェクトのインポート、Integration Brokerを使用した構成、SSLを使用した通信の保護およびOracle PeopleSoftページへのAXFコンポーネントの配置について説明します。

この章の内容は、次のとおりです。

- 第3.1項「Oracle PeopleSoftプロジェクトのインポート」

- 第3.2項「Oracle PeopleSoftのアダプタ通信の構成および保護」

- 第3.3項「Oracle PeopleSoftページへのAXFコンポーネントの配置」

- 第3.4項「Oracle PeopleSoftロギングの構成」

- 第3.5項「Oracle PeopleSoftのソリューションの構成」

- 第3.6項「Oracle PeopleSoftからのAXFのアンインストール」

注意:

アダプタ・ソリューションをOracle E-Business Suiteにはインストールしたが、Oracle PeopleSoftにはインストールしていない場合、第2章「Oracle E-Business Suiteプラグインの構成」で説明している手順を完了した後はこの章はスキップしてください。

3.1 Oracle PeopleSoftプロジェクトのインポート

次の手順に従って、Oracle PeopleSoftプロジェクトをインポートします。この手順では、AXF関連のOracle PeopleSoft表を作成してこれに値を移入し、Oracle PeopleSoftページでのAXF構成を有効にします。

1. 管理権限のあるユーザーとして、Oracle PeopleSoftスキーマが含まれるデータベースにAXFという名前の表領域を作成します。
たとえば、次のSQL例を使用してAXF表領域を作成できる場合もあります。

SQL> create tablespace axf datafile 'D:/oradata/FS91DMO/axf.dbf' size 100m extent management LOCAL SEGMENT SPACE MANAGEMENT AUTO;

表領域の詳細は、『Oracle Database管理者ガイド』の表領域の作成に関する説明を参照してください。

注意:

Oracle PeopleSoft統合では、プロジェクトのインポート時に必要な表がすべて作成されるため、追加のデータベース・ユーザーは必要ありません。

注意:

SQL Serverでは、プロジェクトのインポート時に表領域が自動的に作成されます。Oracle PeopleSoftインストールでSQL Serverを使用する場合、この手順は必要ありません。

2. Oracle PeopleSoft Application Designerを2層モードで起動し、管理権限のあるユーザーとしてログインします。

注意:

使用しているOracle PeopleSoftシステムにすでにAXF_PS_INTEGRATIONプロジェクトがインストールされている場合は、次の手順に進む前に、その既存のプロジェクトをOracle PeopleSoft Application Designerで削除します。これを削除するには、「ファイル」を選択して、「削除」を選択します。プロジェクト名としてAXF_PS_INTEGRATIONと入力し、これを削除します。Oracle PeopleSoft Application Designerで、「全て保存」をクリックします。

3. メニューから「ツール」を選択し、「プロジェクトのコピー」を選択してから、「ファイルから」を選択します。「コピー元ファイル」ダイアログ・ボックスが表示されます。

4. 次のディレクトリを見つけます。
MW_HOME/ECM_HOME/axf/adapters/psft/

5. このpsftディレクトリを選択してから、AXF_PS_INTEGRATIONディレクトリを選択し、「開く」をクリックします。

2つ目のAXF_PS_INTEGRATIONディレクトリには、プロジェクトのXMLファイルが含まれていますが、Oracle PeopleSoft Application DesignerからこれらのXMLファイルにアクセスするには、この親ディレクトリ(同じ名前)を選択する必要があります。AXF_PS_INTEGRATIONプロジェクトがページの下部のペインに表示されます。

6. 「選択」をクリックしてすべての定義タイプを選択し、「コピー」をクリックします。プロジェクト・ファイルのコピーが開始します。

7. すべてのファイルがコピーされたら、「ビルド」を選択して、メニューから「プロジェクト」を選択します。「ビルド」ページが表示されます。

8. 「テーブル作成」およびすぐにSQLを実行オプションを選択して、「ビルド」をクリックします。ファイルがOracle PeopleSoftにインポートされているときに、ビルド・ステータスを監視できます。

9. 処理が完了したら、PSBUILD.LOGファイルで、プロジェクトが正常にインポートされたことを確認します。

10. ログ・ファイルにtablespace 'AXF' does not exist(表領域'AXF'は存在しません)というエラーが表示された場合は、表領域が適切に作成されていないことを示します。Oracle PeopleSoft Application Designerを起動したときにログインしたデータベースにAXFという表領域を手動で作成してから、手順5に戻ってプロジェクトを再ビルドします。

11. Oracle PeopleSoft Application Designerで、「全て保存」をクリックします。

3.2 Oracle PeopleSoftのアダプタ通信の構成および保護

Oracle PeopleSoftアダプタ・セキュリティは、Integration Brokerを使用して構成します。このとき、ユーザー名トークン認証を選択してから、Oracle PeopleSoftユーザーにAXFアクセスを付与します。

この項の内容は次のとおりです。

- 第3.2.1項「SSLを使用した通信の保護(Oracle PeopleSoft)」

- 第3.2.2項「AXFと通信するためのIntegration Brokerの構成」

- 第3.2.3項「Oracle PeopleSoftユーザーのAXFアクセスの構成」

3.2.1 SSLを使用した通信の保護(Oracle PeopleSoft)

次の主要手順に従って、Oracle PeopleSoftアダプタにWebサーバーSSL暗号化を実装します。

1. Webサーバーベースのデジタル証明をインストールします。
統合環境の保護の概要およびPeopleSoft Integration Brokerのセキュリティ処理については、Oracle PeopleSoftのドキュメントを参照してください。Enterprise PeopleTools PeopleBookのIntegration Broker管理ガイドで、Webサーバーベースのデジタル証明のインストールに関する項を参照してください。

2. Oracle WebCenter Content側で、Oracle WebLogic ServerのSSLを有効にします。
詳細は、『Oracle Fusion Middleware Oracle WebCenter Contentのインストールと構成』のOracle WebCenter ContentアプリケーションへのSSLの構成に関する項を参照してください。

3. Webサーバー間でサーバー証明書を交換します。
詳細は、『Oracle Fusion Middleware管理者ガイド』の"exportKeyStoreObject"に関する項を参照してください。

3.2.2 AXFと通信するためのIntegration Brokerの構成

Oracle PeopleSoftにAXF_PS_INTEGRATIONプロジェクトをインポートすると、Integration Broker接続情報もインポートされます。これらのコンポーネントには、Oracle PeopleSoftからAXFサーバーへの接続に必要な情報が含まれます。この項では、Oracle PeopleSoft Webクライアントでこの情報にアクセスして、AXFサーバーをポイントするようこの情報を編集する方法を説明します。

該当するAXFサーバー・バージョン別に、示された手順に従って、AXFとIntegration Brokerとの通信を構成します。

- 第3.2.2.1項「11g AXFサーバーとの通信の構成」

- 第3.2.2.2項「10g AXFサーバーとの通信の構成」

該当するAXFサーバー・バージョンの通信を構成した後、次の手順を完了します。

- 第3.2.2.3項「ゲートウェイ・パスワードの暗号化」

- 第3.2.2.4項「サービス操作ルーティングの設定」

- 第3.2.2.5項「ドメイン・ステータスの確認」

注意:

Oracle PeopleSoft外部通信には、Oracle PeopleSoftローカル統合ゲートウェイが必要です。ゲートウェイの設定の詳細は、Oracle PeopleSoft Enterpriseのドキュメントを参照してください。その上で、AXFサーバーと通信するためのOracle PeopleSoftサービス操作の構成に進むことができます。

3.2.2.1 11g AXFサーバーとの通信の構成

1. Oracle PeopleSoftサーバーで、PeopleToolsを開き、インテグレーション ブローカーを選択して、統合設定を選択します。統合設定メニューが開いて、選択可能なオプションが表示されます。

2. 「ノード」をクリックします。

3. 「既存の値の検索」タブで、「検索条件」フィールドの「ノード名」を選択し、「先頭」フィールドにAXFと入力して、「検索」をクリックします。

4. 検索結果から、「AXF_SOLUTION_MEDIATOR_11G」リンクをクリックします。

5. ノード定義タブで、「アクティブ・ノード」フィールドを選択します。外部ユーザーIDフィールドおよび「外部パスワード」フィールドに、Oracle WebLogic Server管理者のユーザー名とパスワードを入力します。
このユーザーは、AXFのインストール先のアプリケーション・サーバーにインストールされているソリューション・メディエータWebサービスに対して認証を行います。

6. 「コネクタ」タブをクリックします。

7. 「資産価値」列で、「ホスト」をAXFサーバーの名前またはIPアドレスに設定します。

8. 「資産価値」列で、「URL」を設定します。

- SSLを使用している場合は、httpではなくhttpsを使用する次のURLに設定します。port_numberが、Oracle WebCenter Content側のセキュア・ポートに一致する必要があることに注意してください。
https://AXFサーバー名またはIPアドレス:port_number/axf-ws/AxfSolutionMediatorService

- SSLを使用していない場合は、次のURLに設定します。
http://AXFサーバー名またはIPアドレス:port_number/axf-ws/AxfSolutionMediatorService

9. 「保存」をクリックします。

10. ノードのpingをクリックして、ノードが適切に構成されていることを確認します。

- 適切に構成されている場合は、「完了」という語が「ノードのpingの結果」ページのメッセージ・テキスト領域に表示されます。第3.2.2.4項および第3.2.2.5項に進みます。

- 「完了」が表示されなかった場合は、「ノードの構成」ページに戻り、ノードへのpingが成功するまで値を再入力します。

11. 「WSセキュリティ」タブをクリックします。

12. 「認証トークン・タイプ」フィールドのユーザー名トークンを選択して、「外部ユーザーIDの使用」フィールドを選択します。

13. 「保存」をクリックします。

3.2.2.2 10g AXFサーバーとの通信の構成

1. Oracle PeopleSoftサーバーで、PeopleToolsを開き、インテグレーション ブローカーを選択して、統合設定を選択します。統合設定メニューが開いて、選択可能なオプションが表示されます。

2. 「ノード」をクリックします。

3. 「既存の値の検索」タブで、「検索条件」フィールドの「ノード名」を選択し、「ノード名」フィールドにAXFと入力して、「検索」をクリックします。

4. 検索結果から、「AXF_SOLUTION_MEDIATOR_10G」リンクをクリックします。

5. 「コネクタ」タブをクリックします。

6. 「プロパティ名」列で、「ホスト」をAXFサーバーの名前またはIPアドレスに設定します。

7. 「プロパティ名」列で、「URL」を設定します。
http://AXF_Server name or IP address:port_number/imaging-bai-axf/AxfSolutionMediator

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

9. ノードのpingをクリックして、ノードが適切に構成されていることを確認します。

- 適切に構成されている場合は、「完了」という語が「ノードのpingの結果」ページのメッセージ・テキスト領域に表示されます。第3.2.2.4項および第3.2.2.5項に進みます。

- 「完了」が表示されなかった場合は、第3.2.2.3項を参照してください。「ノードの構成」ページに戻り、ノードへのpingが成功するまで値を再入力します。

10. 「WSセキュリティ」タブをクリックして、「認証トークン・タイプ」フィールドが「なし」に設定されていることを確認します。

3.2.2.3 ゲートウェイ・パスワードの暗号化

ノードにpingを実行して「完了」が表示されなかった場合、次の手順で示しているように、ゲートウェイのプロパティのsecureFileKeystorePasswdの値を暗号化します。

1. Oracle PeopleSoftサーバーで、PeopleToolsを開き、「インテグレーション ブローカー」、「設定」、「ゲートウェイ」の順に選択します。

2. LOCALゲートウェイを検索して開き、「ゲートウェイ設定プロパティ」リンクをクリックします。

3. integrationGateway.propertiesファイルにアクセスするためにサインオンします。

4. 「拡張プロパティ・ページ」リンクをクリックします。

5. 「ゲートウェイ・プロパティ」ページのパスワード暗号化ユーティリティを使用して、secureFileKeystorePasswd値を暗号化します。

6. 「ゲートウェイ・プロパティ」ページで、暗号化されたパスワードをsecureFileKeystorePasswd=の後に貼り付け、「OK」をクリックします。

3.2.2.4 サービス操作ルーティングの設定

1. 統合設定オプションから、サービス操作を選択します。

2. サービス操作の検索タブで、サービス操作フィールドにAXFと入力して、「検索」をクリックします。1つの結果リストが返されます。

3. 「AXF_EXECUTE」リンクをクリックします。

4. 「ルーティング」タブをクリックします。

5. ステータスを確認します。

- 11g AXFサーバーと通信している場合は、AXF_SOLUTION_MEDIATOR_ROUTINGルーティング定義のステータスが「アクティブ」になっていることを確認します。そうなっていない場合は、「選択」フィールドを選択して、選択したルーティングのアクティブ化ボタンをクリックし、その他すべてのルーティング定義が「非アクティブ」に設定されていることを確認します。

- 10g AXFサーバーと通信している場合は、AXF_SM_ROUTING_10Gルーティング定義のステータスが「アクティブ」になっていることを確認します。そうなっていない場合は、「選択」フィールドを選択して、選択したルーティングのアクティブ化ボタンをクリックし、その他すべてのルーティング定義が「非アクティブ」に設定されていることを確認します。

6. 「保存」ボタンをクリックします。

3.2.2.5 ドメイン・ステータスの確認

AXFと通信するようIntegration Brokerを構成したら、次の手順に従って、そのステータスを確認します。

1. 「PeopleTools」を選択し、「インテグレーション ブローカー」を選択してから、サービス操作モニターを選択して、「サービス操作モニター」ページに移動します。「サービス操作モニター」ページが表示されます。

2. 「管理」セクションのドメイン・ステータスをクリックします。「ドメイン・ステータス」ページが表示されます。

3. ドメインで、Oracle PeopleSoftサーバーの隣にドメイン・ステータスが「アクティブ」としてリストされていることを確認します。そうなっていない場合は、「ドメイン・ステータス」フィールドから「アクティブ」を選択して、「更新」をクリックします。

3.2.3 Oracle PeopleSoftユーザーのAXFアクセスの構成

次の各項の手順に従って、Oracle PeopleSoftユーザーにAXFアクセス権を付与します。

- 第3.2.3.1項「Oracle PeopleSoftユーザーのAXF_ROLEの確認」

- 第3.2.3.2項「ユーザーへのAXF_ROLEの割当て」

3.2.3.1 Oracle PeopleSoftユーザーのAXF_ROLEの確認

Oracle PeopleSoftプロジェクトのインポート時に、AXF_ROLEが自動的に構成されます。次の手順に従って、適切なOracle PeopleSoftユーザーがAXF機能へのアクセス権を持っていることを確認します。必要に応じて、示されている手順に従って、Oracle PeopleSoftにAXF_ROLEおよび権限を手動で追加します。

1. Oracle PeopleSoftサーバーで、「PeopleTools」を開き、「セキュリティ」を選択してから、権限とロールを選択します。「権限とロール」メニューが開き、選択可能なオプションが表示されます。

2. 「ロール」をクリックします。「ロール」ページが表示されます。AXF_ROLEが表示されているはずです。表示されていない場合は、次の手順に従って追加します。

Oracle PeopleSoftへのAXF_ROLEの手動による追加

前の項でAXF_ROLEを正常に確認できなかった場合のみ、次の手順を実行してください。

1. 「値の追加」タブをクリックします。

2. 「ロール名」フィールドにAXF_ROLEと入力して、「追加」をクリックします。「ロール名」フィールドがクリアされて、AXF_ROLEが追加されます。必要に応じて説明を入力し、「保存」をクリックします。

3. 「ロール」をクリックします。「既存の値の検索」タブをクリックして、使用可能なロールのリストからAXF_ROLEを見つけます。AXF_ROLEをクリックすると、その詳細が表示されます。

4. 「権限リスト」タブをクリックして、「権限リスト」フィールドにAXF_PERMSと入力し、「保存」をクリックします。

3.2.3.2 ユーザーへのAXF_ROLEの割当て

Oracle PeopleSoftにAXF_ROLEを作成したら、次の手順に従って、AXF機能へのアクセスが必要なすべてのユーザーにロールを割り当てます。

注意:

AXFコールがOracle PeopleSoftから適切に処理されるように、AXF機能へのアクセスが必要なすべてのユーザーにOracle PeopleSoftのAXF_ROLEを割り当てる必要があります。

1. Oracle PeopleSoftサーバーで、PeopleToolsを開き、「セキュリティ」を選択してから、「ユーザー・プロファイル」を選択します。「ユーザー・プロファイル」メニューが開き、選択可能なオプションが表示されます。

2. 「ユーザー プロファイル」クリックします。「ユーザー プロファイル」ページが表示されます。

3. 検索基準を選択して、それを「検索」フィールドに入力し、「検索」をクリックします。ユーザーのリストが表示されます。

4. ロールを割り当てるユーザーをクリックします。ユーザー情報の詳細ページが表示されます。

5. 「ロール」タブをクリックします。対象のユーザーに割り当てられているロールのリストが表示されます。

6. 空のフィールド(必要に応じて「+」アイコンをクリックして空白行を作成します)にAXF_ROLEと入力するか、虫眼鏡のアイコンをクリックしてこのロールを検索します。

7. 「保存」をクリックします。これでユーザーはOracle PeopleSoftページのAXF機能にアクセスできるようになりました。

3.3 Oracle PeopleSoftページへのAXFコンポーネントの配置

Oracle PeopleSoft Application DesignerおよびOracle PeopleSoft内のAXF表を使用して、Oracle PeopleSoftページにAXFコンポーネントを構成します。

Oracle PeopleSoftページの主キーおよびビジネス・オブジェクトの指定

必要に応じて、次の手順を実行します。

1. Oracle PeopleSoftアプリケーションで、有効にするページに移動します。

2. [Ctrl]キーを押しながら[J]キーを押します。情報ページで、選択したページの「ページ」エントリおよび「コンポーネント」エントリをメモに取ります。

3. Application Designerで、「ファイル」→「開く」を選択して、「定義」フィールドから「ページ」を選択します。

4. 「名前」フィールドに、手順2でメモに取ったページ名を入力して、「開く」をクリックします。

5. 上部にある「オーダー」タブを選択します。

6. 表示される一連のフィールドから、一意IDである可能性が一番高い(たとえば、請求書エントリの場合のVOUCHER_ID)フィールドを特定して、レコード名をメモに取ります。
このレコード名は、PS_AXF_CMD_PARAMS表(管理対象添付ファイル・ソリューション)およびPS_AXF_COMMAND_PARAMS表(イメージング・ソリューション)のビジネス・オブジェクトの値に使用されます。

7. 「挿入」メニューから、「プロジェクトの定義」コマンドを選択して、「定義タイプ」フィールドから「レコード」を選択します。

8. 「名前」フィールドに、手順6でメモに取ったレコード名を入力して、「挿入」をクリックします。

9. リストからレコードを選択して、「挿入」をクリックします。レコードが、左のプロジェクト・ツリーに挿入されます。

10. 左のレコード・ツリーを開き、追加したレコードを開きます。上部に主キーが、キー名の左にゴールドのキー・アイコンが付いて示されます。これらの主キーをメモに取ります。

主キーのサンプル

表3-1 主キーのサンプル

ページ

ページ名

レコード名

主キー

メンテナンス管理→作業指示管理→作業指示

WM_WO_HDR

WM_WO_HDR

BUSINESS_UNIT

メンテナンス管理→作業指示管理→作業指示

WM_WO_HDR

WM_WO_HDR

WO_ID

顧客契約→作成と修正→一般情報

CA_HDR_PNL

CA_CONTR_HDR

BUSINESS_UNIT

顧客契約→作成と修正→一般情報

CA_HDR_PNL

CA_CONTR_HDR

CONTRACT_NUM

購買→調達依頼→調達依頼の追加/更新

REQ_FORM

REQ_HDR

BUSINESS_UNIT

購買→調達依頼→調達依頼の追加/更新

REQ_FORM

REQ_HDR

REQ_ID

Oracle PeopleSoftページへのAXFコンポーネントの配置

Oracle PeopleSoftページで使用するAXFコンポーネントには次の2つのカテゴリがあります。

- ユーザー・インタフェース・アイテムは、Oracle PeopleSoftページに配置する、AXFボタン、リンクおよびメニューです。それぞれ5個ずつ用意されています(たとえば、AXF_BUTTON_1から_5)。管理対象添付ファイル・ソリューションでは、これらのユーザー・インタフェース・アイテムのみが使用されます。
ユーザー・インタフェース・アイテムは、ページに配置されたときにアクティブになります。AXF_BUTTON_1を同一のOracle PeopleSoftコンポーネント内の複数ページに配置する場合、ページ間で同一の構成が共有されます。同一コンポーネント内でページごとに異なるアクションを構成するには、異なるユーザー・インタフェース・アイテムを使用します(たとえば、AXF_BUTTON_2)。別のOracle PeopleSoftコンポーネントでユーザー・インタフェース・アイテムを競合なく再使用できることに留意してください。

- システム・イベント・コンポーネントは、Oracle PeopleSoftページに配置する、保存前または保存後のシステム・イベントをトリガーする保存前および保存後アイテムです。イメージング・ソリューションでは、ユーザー・インタフェースとシステム・イベント・アイテムの両方が使用されます。
システム・イベントは、ユーザー・インタフェース・アイテムと同様に、Oracle PeopleSoftコンポーネント・レベルで構成されます。ただし、これらはユーザーには表示されないため、配置されているページに関係なく、適宜トリガーされます。たとえば、AXF_POST_SAVE_SBPアイテムおよびAXF_PRE_SAVE_SBPアイテムは特定のページに配置され、保存中のOracle PeopleSoftコンポーネントのページで保存イベントが発生した場合に、構成されているコマンドが実行されます。

- AXF_POST_SAVE_SBPアイテムは、SAVE_POST_CHANGEシステム・イベントを取得します。このシステム・イベントは、Oracle PeopleSoftコンポーネントの保存後に、構成されているコマンドを実行します。
たとえば、SAVE_POST_CHANGEイベントの発生時に呼び出されるようSaveInvoiceコマンドを構成して、アクションによって新規Oracle PeopleSoftトランザクション・レコードが挿入された場合は常にSaveInvoiceコマンドによって保存が自動的に実行されるようにできます。

- AXF_PRE_SAVE_SBPアイテムは、SAVE_PRE_CHANGEシステム・イベントを取得します。このシステム・イベントは、Oracle PeopleSoftコンポーネントの保存前に、構成されているコマンドを実行します。

Oracle PeopleSoftページへのAXFコンポーネントの配置手順

1. Oracle PeopleSoft Application Designerで、手順5(第3.1項)でインポートしたAXF_PS_Integrationプロジェクトを開きます。

2. 有効にするOracle PeopleSoftページを開きます。たとえば、VCHR_HEADER_QV2を開きます。

3. Pagesフォルダから、ボタンまたはリンク(サブページ)を選択して、それをOracle PeopleSoftページ内の適切な場所にドラッグします。たとえば、AXF_LINK1_SBPというリンクまたはAXF_BTN1_SBPというボタンをドラッグします。このサブページ・リンクまたはボタンは、表C-35(第C.4.2項)のAXFイベント設定に対応しています(表C-36の例を参照してください)。

4. ページを保存します。

3.4 Oracle PeopleSoftロギングの構成

AXF Oracle PeopleSoftアダプタでは、標準のapache log4jロギングが使用されます。log4j.propertiesファイルを使用して、ロギングをアクティブにしたり、管理したりできます。このファイルは、PeopleSoft Installation Directory/classディレクトリにあります。次のオプションを設定します。

# A1 is set to be a ConsoleAppender which outputs to System.out.
log4j.appender.A1=org.apache.log4j.DailyRollingFileAppender
log4j.appender.A1.File=./LOGS/PS_AXF.log

# A1 uses PatternLayout.
log4j.appender.A1.layout=org.apache.log4j.PatternLayout
log4j.appender.A1.DatePattern=.yyyy-MM-dd
log4j.appender.A1.layout.ConversionPattern=%{dDATE} [%t] %-5p %c %x - %m%n

log4j.category.com.oracle.axf=DEBUG, A1

少なくとも、有効なファイルの場所でアペンダを定義し、レポートするメッセージのレベルを定義します(前述の箇所を参照してください)。有効なレベルは次のとおりです。これは詳細なものから順に並べられており、DEBUGではすべてのメッセージと詳細が表示されます。

- DEBUG

- INFO

- WARN

- ERROR

- FATAL

注意:

log4jの詳細は、log4jのドキュメントを参照してください。

3.5 Oracle PeopleSoftのソリューションの構成

各ソリューションを構成するための追加タスクは、次に示した各項を参照してください。Oracle PeopleSoftページにコンポーネントを配置した後の主要なタスクは、新しく追加したボタン、リンクまたはイベントにコマンドを関連付けるようAXF関連のOracle PeopleSoftの表を構成することです。

イメージング・ソリューションの場合

1. イメージング・ソリューションは、第6章で示しているように構成します。第B.5項で示しているようにAXF関連のOracle PeopleSoftの表を構成するか、または第6.2項で示しているようにソリューション・アクセラレータを適用します。

2. PS_AXF_COMMANDS表でOracle PeopleSoftのロールを指定して、指定されたユーザー・インタフェース・アイテムを使用する権限をユーザーに付与するか、または指定されたシステム・イベントをユーザーがトリガーできるようにします。第B.5.3項を参照してください。

管理対象添付ファイル・ソリューションの場合

1. 管理対象添付ファイル・ソリューションは、第7章で示しているように構成します。

2. 第C.4項にリストされているPeopleSoft AXF表にエントリを追加するか、変更を加えます。第7.2.4項で説明しているサンプルのスクリプトを実行することによって、表に変更可能なサンプルの値が移入されます。次の情報を入力する必要があります。

1. 第3.3項でメモしたページの主キーを入力します。

2. PS_AXF_COMMANDS表でOracle PeopleSoftのロールを指定して、指定されたユーザー・インタフェース・アイテムを使用する権限をユーザーに付与します。第C.4.2項を参照してください。

3.6 Oracle PeopleSoftからのAXFのアンインストール

実装されているAXFソリューションがない場合は使用されているリソースがないため、システムにAXFオブジェクトを残しておいても害はありません。実装されているAXFソリューションがない場合、Application Designerを使用してすべてのAXFオブジェクトを削除できます。

4 AXF設定の構成

ほとんどのAXF構成が、Oracle WebCenter Contentのインストールの一部として完了されます。この章では、追加のAXF設定の構成方法を説明します。この項の内容は、次のとおりです。

- 4.1項「ロギングの構成」

- 4.2項「Coherenceの構成」

4.1 ロギングの構成

この項の内容は次のとおりです。

- 第4.1.1項「BPM用AXFのロギングの構成」

- 第4.1.2項「BPEL用AXFのロギングの構成」

4.1.1 BPM用AXFのロギングの構成

この項では、Enterprise ManagerおよびDMSロギングを使用したBPM用AXFのロギングについて説明します。

表4-1は、構成可能なロガーを示しています。こられには、基本、カスタマイズおよびパフォーマンスのロガーが含まれます。詳細構成については、第4.1.1.1項を参照してください。

表4-1 AXFロガー

ロガー

説明

oracle.ecm.axf

この基本AXFロガーは、AXFシステム診断の高度な詳細ログを提供します。これには、製品のトレース実行および例外に関する情報も含まれます。

oracle.ecm.axf.performance

AXFパフォーマンス・ロガーは、DMSメトリックに対応する詳細ログを提供し、システム全体のパフォーマンスを判断したり、特定のパフォーマンス・ベースのテスト・ケースを別にしたりするために使用されます。第4.1.1.2項を参照してください。

基本AXFロガーは、Oracle親ロガーのロギング・レベルを継承します。デフォルトで、親ロガーは、NOTIFICATIONレベルのロギングを使用するよう構成されます。カスタマイズ・ロガーおよびパフォーマンス・ロガーは、基本AXFロガーのロギング・レベルを継承します。NOTIFICATION構成では、コンソールに対する警告メッセージおよびエラー・メッセージのみが記録されます。(詳細は、表4-4を参照してください。)ロギング・レベルを上げ、コンソールへのロギングをより詳細にするには、図4-1に示しているように、Enterprise Managerコンソールを使用してレベルを調整します。

図4-1 Enterprise Managerコンソールのログ構成

4.1.1.1 詳細構成

BPM用AXFシステム上の特定の動作を調査するために、コンソールへのロギングで提供されるものより詳細な情報の取得が必要な場合があります。この項では詳細構成の手順を説明します。この手順では、サーバー上のlogging.xmlファイルを使用して、1つ以上のログ・ハンドラおよびロガーを定義します。各サーバーには、Oracleドメインの次のディレクトリにlogging.xmlファイルが設定されています。

Oracle/Middleware/user_projects/domains/<domain name>/config/fmwconfig/servers/<server> directory

1. logging.xmlファイルを編集して、2つのログ・ハンドラ(log_handler)と2つのロガー(logger)を定義します。これによって、2つのロガーからの出力を個別に処理して、対応するログ・ハンドラを使用して出力を別の一意のログ・ファイルにルーティングできるようになります。表4-2に示されているプロパティを使用し、例4-1を参照して、log_handlersタグの下に、ログ・ハンドラを定義します。

表4-2 ログ・ハンドラのプロパティ

プロパティ

説明

path

ロギングを格納するサーバーの場所を定義します。

maxFileSize

各ログ・ファイルの最大サイズ(バイト単位)を指定します。メイン・ログ・ファイルが指定のサイズに達した場合、ログ・ローテーションがトリガーされ、メイン・ログ・ファイルは完了して新規ログ・ファイルが作成されます。

maxLogSize

ログ全体の最大サイズ(バイト単位)を指定します。古いアーカイブ・ファイルから削除されていき、ログ・サイズ合計が指定の上限を下回るようにします。

例4-1 ログ・ハンドラの変更が加えられたLogging.xmlファイル

<log_handler name='axf-handler' class='oracle.core.ojdl.logging.ODLHandlerFactory' level='ALL'>
<property name='path' value='${domain.home}/servers/${weblogic.Name}/logs/axf.log'/>
<property name='maxFileSize' value='5485760'/>
<property name='maxLogSize' value='54857600'/>
</log_handler>
<log_handler name='axf-handler-performance' class='oracle.core.ojdl.logging.ODLHandlerFactory' level='ALL'>
<property name='path' value='${domain.home}/servers/${weblogic.Name}/logs/axf_performance.log'/>
<property name='maxFileSize' value='5485760'/>
<property name='maxLogSize' value='54857600'/>
</log_handler>

2. ログ・ハンドラの定義と同様に、3つのロガー(logger)を定義します。AXFアプリケーションでログごとに1つのログ・ハンドラが定義され、Enterprise Managerコンソールで表示できます。これによって、各ロガーのロギング・レベルを個別に構成して、出力に使用するログ・ハンドラを指定できます。表4-3に示されているプロパティを使用し、例4-2を参照して、loggersタグの下に、ロガーを定義します。

表4-3 ロガーのプロパティ

プロパティ

説明

name

アプリケーションで定義されるロガー名。AXFには、次のロガーが含まれます。oracle.ecm.axf、oracle.ecm.axf.performanceおよびoracle.ecm.axf.customization。

level

情報を記録するレベル。詳細は、次の表4-4を参照してください。

useParentHandlers

親からレベルを継承するにはtrueに設定し、指定したレベルを使用するにはfalseに設定します。

例4-2 ロガーの変更が加えられたLogging.xmlファイル

<logger name='oracle.ecm.axf' level='TRACE:32' useParentHandlers='false'>
<handler name='axf-handler'/>
<handler name='console-handler'/>
</logger>
<logger name='oracle.ecm.axf.performance' level='TRACE:32' useParentHandlers='false'>
<handler name='axf-handler-performance'/>
<handler name='console-handler'/>
</logger>

3. ロガーおよびログ・ハンドラを定義して保存すると、ロガー・レベル属性で定義されたとおりにログ・ファイルでロギングの入力が自動的に開始します。Enterprise Managerコンソールを使用してレベルを変更し、詳細が必要な特定のログを別にして、残りのログのロギング処理は最小限に抑えてサーバーのパフォーマンスが受ける影響を軽減することもできます。ロギング・レベルに指定できる値を表4-4に示します。

表4-4 ロギング・レベル

メッセージ・タイプ/ロガー・レベル

説明

ERROR

システム管理者がすぐに対処する必要がある重大な問題。

WARNING

システム管理者が確認する必要がある潜在的な問題。

NOTIFICATION

主要なライフサイクル・イベント。

TRACE

トレースまたはデバッグ情報。

UNKNOWN

タイプが不明な場合に使用できます。

4.1.1.2 DMSロギングの構成

Oracle Dynamic Monitoring Service (DMS)は、アプリケーション・パフォーマンス診断のOracle標準です。Oracle標準の一部として、DMSロギングを常にオンにしておく必要があります。AXFでは、次のような目的を持ってDMSロギングが処理されます。

- AXFのパフォーマンスを適切に評価するには、外部製品での時間を除外する能力が必要になる。

- 特定の製品領域のパフォーマンスの問題の解決が容易になるように、DMSメトリックをコール・スタックのタイミングのメトリックに関連付けるためのログを使用する必要がある。

表4-5に示したメトリック表は、実行されるアクションのタイプに基づいたパフォーマンスの問題の解決に役立ちます。

表4-5 DMSロギング

メトリック表

説明

AXF

AXF API操作に関するタイミング統計を記録します。統計は、サービス操作ごとに記録されます。

AXF_Business Rules

SOAビジネス・ルールとの相互作用に関するタイミング統計を記録します。

AXF_HumanTasks

SOAヒューマン・タスクとの相互作用に関するタイミング統計を記録します。

AXF製品のインストゥルメンテーションの一部として、特別なロガーであるoracle.ecm.axf.performanceによって、DMSデータと一般的な実行スタック・トレースとの関連付けが容易になります。AXF_Performance.logは、標準のJavaおよびOracleの実施基準に基づいて、Enterprise Managerを使用して構成できます。ログの構成例については、第4.1.1.1項を参照してください。

4.1.1.2.1 DMSロギングの消去

特定のユースケースを別にする場合、DMSロギングを消去すると便利です。「DMSメトリックのリセット」ボタンをクリックして、「AXFコマンド・ドライバ」ページからDMSロギングを消去します。

4.1.2 BPEL用AXFのロギングの構成

次のいずれかの方法を使用してロギングを構成できます。

- 第4.1.2.1項「Enterprise Managerの使用」

- 第4.1.2.2項「Application Serverの使用」

4.1.2.1 Enterprise Managerの使用

ロガーの設定にWebインタフェースを使用するには、Enterprise Managerの「ログ構成」ページに移動します。たとえば、サイド・ペインでサーバーを選択し、右クリックして、「ロギング」を選択してから、ロギングの構成を選択します。詳細は、Oracle Enterprise Managerのドキュメントを参照してください。

4.1.2.2 Application Serverの使用

AXFログを使用して、ソリューション構成における問題を取り出します。デフォルトで、一部のAXFロギングは、Application Serverロギングの一部として自動的に実行されます。次の手順に従って、より詳細な別個のAXFロギングを構成します。

1. ログ・ハンドラをApplication Server構成に追加します。次の場所にあるlogging.xmlファイルの<log_handlers>タグ内にハンドラを追加します。
DOMAIN/config/fmwconfig/servers/SERVER/logging.xml

場所の例を次に示します。

base_domain/config/fmwconfig/servers/IPM_Server1/logging.xml

<log_handler name='axf-handler' level='ALL' class='oracle.core.ojdl.logging.ODLHandlerFactory'>
<property name='path' value='${domain.home}/servers/${weblogic.Name}/logs/axf.log'/>
<property name='maxFileSize' value='5485760'/>
<property name='maxLogSize' value='54857600'/>
<property name='encoding' value='UTF-8'/>
</log_handler>

2. ロガーをlogging.xmlファイルに追加して、表4-6に示したログ・レベル(ODLメッセージ・タイプ)からレベルを設定します。XMLファイルにロギング・レベルを設定することも、Enterprise Managerを使用することもできます。

<logger name='oracle.imaging.axf' level='TRACE:32' useParentHandlers='false'>
<handler name='axf-handler'/>
<handler name='console-handler'/>
</logger>

注意:

端末のロギングを省略するには、console-handlerタグを削除します。

3. 表4-6 設定可能なロギング・レベル

ログ・タイプ

説明

ログ・レベル(ODLメッセージ・タイプ)

NULL

ロガーは、親に設定されたログ・レベルを継承します。

該当なし

SEVERE

システム管理者の注意が必要なシステム・エラーを記録します。

ERROR:1

WARNING

エラーが発生する前に確認して処理する必要があるとして検出されたアクションまたは条件を記録します。

WARNING:1

INFO

正常なアクションまたはイベントを記録します。これには、ログイン完了などのユーザー操作や、ログ・ファイルのローテーションなどの自動処理が該当します。

NOTIFICATION:1

CONFIG

構成関連のメッセージまたは問題を記録します。

NOTIFICATION:16

FINE

デバッグまたはパフォーマンス監視に使用されるトレース・メッセージまたはデバッグ・メッセージを記録します。通常は、詳細なイベント・データが含まれます。

TRACE:1

FINER

かなり詳細なトレース・メッセージまたはデバッグ・メッセージを記録します。

TRACE:16

FINEST

きわめて詳細なトレース・メッセージまたはデバッグ・メッセージを記録します。

TRACE:32

4. Windowsを使用している場合に、管理サーバーを実行しているときは、これを再起動します。ロガーがEnterprise Managerに表示されます。実行時にロギング・レベルを変更できます。

4.2 Coherenceの構成

インストールでキャッシュにCoherenceを使用する場合(高可用性環境の要件)、ネームスペース、プロパティ定義、プロパティ・セット定義およびプロパティ・セット用にそれぞれ1つずつ4つの個別のキャッシュが設定されます。このデフォルトのキャッシュ構成は、Coherenceのデフォルトとともに即時機能します。

AXF用に最適化されたオプションのCoherence構成を構成するには、単純なCoherenceキャッシュの構成方法を示す、次のサンプルのaxf-cache-config.xml構成ファイルを参照してください。高度なキャッシュ・タイプの詳細は、Coherenceのドキュメントを参照してください。次に記載されたようにCoherenceを構成することをお薦めしますが、必須ではありません。

<?xml version="1.0"?>
<!-- File: coherence-cache-config.xml -->
<cache-config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://xmlns.oracle.com/coherence/coherence-cache-config"
xsi:schemaLocation="http://xmlns.oracle.com/coherence/coherence-cache-config http://xmlns.oracle.com/coherence/coherence-cache-config/1.0/coherence-cache-config.xsd">

<!-- Prefix all service names to ensure no unintended clustering with other cache servers -->
<scope-name>com.oracle.ecm.axf</scope-name>

<defaults>
<serializer>pof</serializer>
</defaults>

<caching-scheme-mapping>
<!-- Specific cache mappings to avoid configuration errors -->

<!--
Cache limits are set per cache per node, so the total limit is the sum of all the cache limits on this node.

As there are 3 caches the storage will be a maximum of 3 x 100MB = 300MB,
in addition to 3 x 5MB = 15MB of near cache for clients.
-->
<cache-mapping>
<cache-name>AXF</cache-name>
<scheme-name>CustomNearCacheScheme</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>AXF_CONVERSATION</cache-name>
<scheme-name>CustomNearCacheScheme</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>AXF_EVENT</cache-name>
<scheme-name>CustomNearCacheScheme</scheme-name>
</cache-mapping>
</caching-scheme-mapping>

<caching-schemes>
<near-scheme>
<scheme-name>CustomNearCacheScheme</scheme-name>
<front-scheme>
<local-scheme>
<scheme-ref>SizeLimitedLocalScheme</scheme-ref>
</local-scheme>
</front-scheme>
<back-scheme>
<distributed-scheme>
<scheme-name>CustomDistributedCacheScheme</scheme-name>
<backing-map-scheme>
<local-scheme>
<scheme-name>SizeLimitedLocalScheme</scheme-name>
<eviction-policy>HYBRID</eviction-policy>
<!-- 100M -->
<high-units>100</high-units>
<unit-calculator>BINARY</unit-calculator>
<unit-factor>1048576</unit-factor>
<expiry-delay>4h</expiry-delay>
</local-scheme>
</backing-map-scheme>
<autostart>true</autostart>
</distributed-scheme>
</back-scheme>
<invalidation-strategy>present</invalidation-strategy>
</near-scheme>

<local-scheme>
<scheme-name>SizeLimitedLocalScheme</scheme-name>
<eviction-policy>HYBRID</eviction-policy>
<!-- 5M -->
<high-units>5</high-units>
<unit-calculator>BINARY</unit-calculator>
<unit-factor>1048576</unit-factor>
<expiry-delay>4h</expiry-delay>
<cachestore-scheme></cachestore-scheme>
</local-scheme>
</caching-schemes>
</cache-config>

5 BPMイメージング・ソリューションの構成

この章では、管理者ロールに基づいて、BPMイメージング・ソリューションのコンポーネントとオプションの構成方法について説明します。ロールおよび管理者が各ロールで実行できるソリューション変更のタイプの詳細は、第1.2.2項を参照してください。

この章の内容は、次のとおりです。

- 第5.1項「ソリューション・アプリケーション管理について」

- 第5.2項「ソリューション・アプリケーションの構成に関するスタート・ガイド」

- 第5.3項「HelloBPMソリューションについて」

- 第5.4項「HelloBPMソリューションのユースケース」

- 第5.5項「BPMビューの構成」

- 第5.6項「Oracle Fusion Middleware Controlを使用したBPMのAXF管理」

5.1 ソリューション・アプリケーション管理について

第1.2.4項では、ソリューション・ワークスペースのソリューション・アプリケーションの部分(図5-1)が、選択したタスクを完了させる高度な構成が可能なヒューマン・タスク・エリアを提供する方法を説明しました。この項では、ソリューション・アプリケーションの基礎となるビジネス・ルールの編集の概念について説明します。また、BPMのAXFとともにインストールされたHelloBPMソリューションでは、ソリューション・アプリケーション構成の確認および実行に使用できる構成例を提供します。

注意:

この項では、ルールセット、デシジョン表およびディクショナリなどのビジネス・ルール編集の一般的な知識があることを前提としています。ビジネス・ルールの情報は、『Oracle Fusion Middleware Oracle Business Process Management Business Process Composerユーザーズ・ガイド』で詳しく説明されています。

図5-1 ビジネス・ルール駆動型ソリューション・アプリケーション

この項の内容は次のとおりです。

- 第5.1.1項「動的ページ・テンプレートおよびページ・コンポーネントについて」

- 第5.1.2項「ビジネス・ルールおよびディクショナリについて」

- 第5.1.3項「機能ブロックについて」

- 第5.1.4項「コントロール・ページについて」

- 第5.1.5項「プロンプトおよび検証について」

- 第5.1.6項「パッケージについて」

- 第5.1.7項「コンテキストについて」

- 第5.1.8項「データ・フィールド、表および参照について」

- 第5.1.9項「ビジネス・ルール変更の無効化または破棄について」

5.1.1 動的ページ・テンプレートおよびページ・コンポーネントについて

BPMのAXFでは、表示するすべてのソリューション・アプリケーション・ページが1つの動的ページ・テンプレートで構築されます。このテンプレートには、図5-1で示すように、メニュー(アクション・コントロール)およびタブ(動的タブ)コンポーネントが含まれます。移動先のページがすべて同じページの場合でも、ビジネス・ルールではページのレンダリング方法を定義します。たとえば、コンテキストに応じて、別のタブが一部のユーザーに表示され、そのタブのコンテキストも異なることがあります。

- 第5.1.1.1項「アクション・コントロールについて」

- 第5.1.1.2項「「ステータスの更新」アイコンについて」

- 第5.1.1.3項「動的タブについて」

- 第5.1.1.4項「ページ・コンポーネントについて」

5.1.1.1 アクション・コントロールについて

アクション・コントロールは、AXF機能をコールするアクションを定義するビジネス・ルール駆動型コンポーネントです。アクションがコールする機能は機能ブロックにより指定されます(第5.1.3項を参照してください)。たとえば、HelloBPMソリューション・アクション・コントロールには、リンクとして表示される「承認」および「却下」アクションが含まれます。この構成は、一般的に使用されているアクションに使用できます。アクション・コントロールを構成して、グループ化されたアクションをドロップダウン・メニューに表示できます。たとえば、「アカウント・マネージャ」アクションおよび「保存して閉じる」アクションは、「例外」および「閉じる」ドロップダウン・メニューで構成されています。

アクション・ルール・ディクショナリを使用して、アクション・コントロールに表示されるアクションのレイアウトおよび動作を構成し、FunctionalBlockディクショナリを使用して、アクションによって起動する機能を構成します。たとえば、ビジネス・ルールを使用して次のことを行います。

- アクションおよびセクションを定義します(たとえば、複数の「閉じる」アクション・リンクで、「閉じる」ドロップダウン・メニューに表示できます)。
セクションに割り当てられていないアクションは、リンクとして「アクション」メニューに左揃えで表示されるため、一般的に使用されるアクションに簡単にアクセスできます。セクションでは、メニュー・アイテムとしてリストされたアクションをドロップダウン・メニューで表示します。

- 新規アクションをコントロールに追加します。アクションを追加した後に、アクションに対して起動する機能ブロックまたは機能ブロックシーケンスを定義します。たとえば、「承認」アクションをクリックすると、「アイデンティティ・ブラウザ」コントロール・ページに移動するようになります。

- ルール結果に基づいて、アクションまたはセクションを除外または無効にします。たとえば、必須のデータ・フィールドが空白または0に設定されていると、「承認」アクションが無効または非表示になることがあります。

5.1.1.2 「ステータスの更新」アイコンについて

アクション・コントロールの右側には、次に示す「ステータスの更新」アイコンが表示されます。

このアイコン(選択済の場合表示されます)は変化して、内部の基礎となるデータが更新されたことを示します。たとえば、ビジネス・アプリケーションで値が更新されると、このアイコンは変化しますが、ユーザーが動的タブでデータ値を変更した場合は変化しません。変更後は、アイコンをクリックしてデータ更新を確認します。これにより、アイコンを選択解除されている状態にリセットします。

5.1.1.3 動的タブについて

動的タブ・コントロールは、ソリューション・アプリケーションおよびそのページ・コンポーネント・コンテンツ内で表示されるタブを定義するビジネス・ルール駆動型コンポーネントです。図5-1で示すHelloBPMソリューションのデフォルトの動的タブには、「イメージ・データ」、「製品」のマスター・ディテール、「ライセンス条項」のマスター・ディテールおよび「コメント」が含まれます。

タブのコンテンツおよび動作を構成するには、DynamicTabディクショナリを使用します。第5.1.2項を参照してください。

5.1.1.4 ページ・コンポーネントについて

ページ・コンポーネントは、動的タブでイメージ、データ・フィールド、and/or表などのコンテンツを表示します。動的タブ・コントロールは、ページ・コンポーネントをホストします(詳細は、A.1.1項を参照してください)。ページ・コンポーネントは、タスクの詳細領域で表示される主な機能を実装します。

- ページ・コンポーネントは、他のページ・コンポーネントで構成できるため、コンポジット・ページ・コンポーネントです。たとえば、動的タブがデータ・ページ・コンポーネントをホスする場合、ユーザー・ロールではデータのみを表示します。ただし、タブがイメージまたはTableDataのページ・コンポーネントもホストする場合は、イメージまたはデータ表をそれぞれ表示します。

- 「イメージ・データ」およびマスター・ディテールのページ・コンポーネントは、他のページ・コンポーネントから作成されたページ・コンポーネントの例です。「イメージ・データ」ページ・コンポーネントには、「データ」および「イメージ」ページ・コンポーネントが含まれます。また、「マスター・ディテール」ページ・コンポーネントには、「データ」および「表データ」ページ・コンポーネントが含まれます。

5.1.2 ビジネス・ルールおよびディクショナリについて

ビジネス・ルールは、ソリューション・アプリケーションの構成手段を提供し、ビジネス・アプリケーション・ユーザーのカスタム・ニーズを満たします。BPMのAXFソリューション管理において、ビジネス・ルールとは、AXFソリューションの動作を変更するために変更される標準SOAビジネス・ルールです。ソリューション管理領域を使用すると、ビジネス・ルールのロード、編集および保存、変更の結果テストを実行できます。また必要に応じて、ビジネス・ルールをそれぞれの製品状態に戻すこともできます。

ルールは、個別のAXF MDSリポジトリに格納されます。このリポジトリでは同じスキーマが使用されますが、SOAリポジトリとは異なります。初期製品ルールはソリューション・アプリケーションの一部としてデプロイされています。

ディクショナリは、ソリューション・アプリケーション機能に対してグループ化されたビジネス・ルールのコンテナです。たとえば、アクション・ディクショナリは、アクションおよびセクション(ドロップダウン・メニュー)をソリューション・アプリケーションのアクション・コントロール部分に定義します。BPMのAXFインフラストラクチャで提供されるディクショナリは、表5-1にリストされています。ソリューションのディクショナリは、パッケージにグループ化されています(第5.1.6項を参照してください)。たとえば、HelloBPMソリューションのすべてのディクショナリは、oracle.axf.solution.hellobpmパッケージに含まれています。

ほとんどの場合、ルール・ディクショナリはそれぞれ独立していますが、A.1.9項で強調表示されているようにエンティティ・リレーションシップがある場合もあります。すべてのルールはBPMプロセスではなく、ソリューション・アプリケーションに関連付けられています。

表5-1 BPMのAXFインフラストラクチャで提供されるディクショナリ

ディクショナリ

説明

アクション

このディクショナリは、タスク・アクションが表示されるアクション・コントロール領域のレイアウトおよび動作を定義します。

オプションで、アクションを条件に応じて表示または無効にするように定義できます。たとえば、特定のデータ値(金額など)が指定された金額を超える場合、「承認」ボタンで特定のユーザー・ロールを無効として表示できるように、ビジネス・ルールを編集できます。

詳細は、A.1.3項を参照してください。

データ

このディクショナリは、「データ」ページ・コンポーネント内に表示されるデータ(メタデータ)およびアイテムを定義します。データ値は編集可能または読取り専用などの様々な形で定義できます。

詳細は、A.1.4項を参照してください。

DynamicTab

このディクショナリは、ソリューション・アプリケーションで表示されるタブのレイアウトおよび動作を定義します。たとえば、このディクショナリを使用して、「コメント」タブを表示したり、タスクのルーティング前にコメントの入力を要求したりすることができます。

詳細は、A.1.5項を参照してください。

FunctionalBlock

このディクショナリは、ソリューション・アプリケーション機能およびアクションの機能シーケンス(アクション・リンクを選択した際に起こるアクションなど)を定義します。たとえば、機能ブロックを使用して、ヒューマン・タスクに結果を設定したり、事前定義済コントロール・ページ(「アイデンティティ・ブラウザ」コントロール・ページなど)に移動したりできます。

詳細は、A.1.6項を参照してください。

LookupAndValidator

このディクショナリは、データおよびTableDataコントロールに対して参照(選択一覧からのデータ値の選択)を定義します。参照は、静的(固定リスト)または動的(データベースからのSQL問合せ)のいずれかであり、動的参照フィールドは依存しています(リンク)。参照に加えて、このディクショナリでは、検証構成のバリデータも定義します。

詳細は、A.1.7項を参照してください。

TableData

このディクショナリは、データの表形式での表示方法を定義します。複数の列定義を含む単一表を定義できます。表は、ルール構成に基づいて実行時に動的にレンダリングされます。

詳細は、A.1.8項を参照してください。

5.1.2.1 ディクショナリの編集について

ディクショナリのビジネス・ルールを編集する場合、そのカスタム・ルールを編集しますが、必要に応じて、ディクショナリのルールを製品ルールに戻すことができます。ディクショナリの編集の詳細は、第5.2.5項を参照してください。

コンテキストは、1つ以上のディクショナリの特化されたバージョンです。通常、コンテキストはあるタスクに機能を追加するために使用されます。たとえば、営業見積入力タスクが選択されている場合、HelloBPMソリューションには、データ・フィールドおよび表を表示するSalesQuoteEntryコンテキストが含まれます。詳細は、第5.2.6項を参照してください。

5.1.2.2 ルールセットおよびバケットセット

ビジネス・ルール・ディクショナリでは、関連するルールが、ディクショナリの特定の側面を定義するルールセットにグループ化されています。たとえば、図5-2に示すようにDynamicTabディクショナリを開くと、ペインの右側に、横のペイン(ルールセット)で選択したルールセットに対して定義されている各ルールがリストされます。

各ルールセットは可能なかぎり移入します。そうすると、前の設定を適用したり、プレースホルダ値を変更したりすることで新機能を追加できます。

バケットセットは、指定したファクト・タイプの値のリストまたは値の範囲などの制約を定義します。たとえば、DynamicTabディクショナリのバケットセット、PageComponentは、ユーザーが構成できるページ・コンポーネント(「イメージ」、「イメージ・データ」、「データ」、「表データ」、マスター・ディテール、「コメント」および「アイデンティティ・ブラウザ」)を定義します。

図5-2 DynamicTabディクショナリでのビジネス・ルールの編集

5.1.2.3 入力について

各ユーザー・インタフェース・コントロールのルールセットは、表5-2にリストされた入力変数(デシジョン・ポイントに送信される)を使用できます。ルールセットで生成した出力の詳細は、A.1項の特定のコントロールに関する項を参照してください。

表5-2 BPMのAXFルールセットで使用される入力

入力

説明

タスク

ヒューマン・タスク

ペイロード

ヒューマン・タスクのペイロード

コンテキスト

現在のコンテキスト(条件付ルールで使用可能)

5.1.3 機能ブロックについて

BPMのAXFにおいて、機能ブロックとは、ソリューション・アプリケーションで実行できることに対するRAW機能ビルディング・ブロックを表します。たとえば、機能ブロックを使用して、タスクの承認などのヒューマン・タスクに結果を設定したり、コントロール・ページなどの他のページに移動したりできます。

- 名前付き機能ブロックは、パラメータなどの機能ブロックのインスタンスを定義します。たとえば、機能ブロックではコントロール・ページに移動できますが、名前付き機能ブロックでは移動先のコントロール・ページおよび使用するパラメータを指定します。

- 名前付き機能ブロック・シーケンスとは、名前付き機能ブロックのシーケンスを表します。たとえば、シーケンスでは、「アイデンティティ・ブラウザ」コントロール・ページに移動し、「承認」するヒューマン・タスクの結果を設定します。

名前付き機能およびそのシーケンスをFunctionalBlockルール・ディクショナリに定義します。通常、すべての機能ブロックはベース・コンテキストで定義され、他のコンテキストの他のルールで参照されます。

表5-3にリストされたアクション・タイプに対して機能ブロックを使用できます。これらの使用例については、第5.3.6.1項を参照してください。

表5-3 機能ブロックで実行されるアクション

アクション

説明

結果の設定

指定されたヒューマン・タスクの結果を設定します(承認または却下など)。

動的ページに移動

指定された動的ページに移動します。

コントロール・ページに移動

指定されたコントロール・ページに移動します(「アイデンティティ・ブラウザ」、「コメント」または「データ」コントロール・ページなど)。

保存

明示的な保存を実行します。

元に戻す

オリジナル・ペイロードをロードします。これにより、最後に開いてからタスクに行われた変更に対する取消機能が提供されます。

注意: タスクに追加されたコメントは、「元に戻す」機能ブロックを使用してもロールバックされません。

タスクを閉じる

タスク・リストから別のタスクを選択すると、タスクは自動的に閉じられますが、この機能ブロックにより明示的に閉じられます。

SystemActionSuspend

指定されたアクションを一時停止するBPMアクションです。詳細は、Oracle BPMドキュメントを参照してください。

SystemActionWithdraw

指定されたアクションを取り消すBPMアクションです。詳細は、Oracle BPMドキュメントを参照してください。

SystemActionSkipCurrentAssignment

割当てをスキップするBPMアクションです。詳細は、Oracle BPMドキュメントを参照してください。

SystemActionEscalate

指定されたアクションをエスカレートするBPMアクションです。詳細は、Oracle BPMドキュメントを参照してください。

5.1.4 コントロール・ページについて

コントロール・ページは、事前定義済の動的タブ・ページであり、ソリューションで使用する1つ以上のタブとその関連付けられたページ・コンポーネントが含まれます。これにより、一般的に使用される機能を簡単に実装することが可能です。たとえば、「アイデンティティ・ブラウザ」コントロール・ページでは、承認目的などでユーザーまたはグループを選択できるインタフェースが表示されます。

BPMのAXFインフラストラクチャでは、次のコントロール・ページが提供されます。

- データ(第5.1.4.1項を参照してください)

- アイデンティティ・ブラウザ(第5.1.4.2項を参照してください)

- コメント(第5.1.4.3項を参照してください)

各コントロール・ページには、ビジネス・ルール構成に基づいた構成可能なコンテンツの既定の構造があります。

5.1.4.1 データ・コントロール・ページについて

データ・コントロール・ページでデータ・フィールドを指定することにより、図5-3で示すように表示または編集ができるようになります。コントロール・ページで表示される各データ・フィールドはデータ・ディクショナリで定義されたデータ・フィールドにバインドされます。データ・コントロール・ページのパラメータは、表A-7にリストされています。

データ・フィールドの指定に加えて、このコントロール・ページを使用し、データ・フィールドの表の構成、および既定の参照やSQLベースの参照を構成できます(第5.1.8項を参照してください)。セクションのデータ・アイテムをグループ化することもできます。

図5-3 データ・コントロール・ページ

5.1.4.2 「アイデンティティ・ブラウザ」コントロール・ページについて

図5-4で示す「アイデンティティ・ブラウザ」コントロール・ページでは、ユーザー、グループまたはアプリケーション・ロールの検索およびタスク・ペイロードの更新ができます。通常、プロセス後半のタスク割当てで使用されます。「アイデンティティ・ブラウザ」コントロール・ページのパラメータは、表A-8にリストされています。HelloBPMの例では、営業見積入力ユーザーが「承認」アクション・リンクを選択すると、承認ロールの選択を要求する「アイデンティティ・ブラウザ」タブが表示されます。

「アイデンティティ・ブラウザ」コントロール・ページは次のとおりです。

- 通常、名前付き機能ブロックのシーケンスの一部として使用され、割当て情報を収集してタスクを完了します。

- タスクを割り当て、プロセス・フロー内の将来のタスクに対して更新できます。

図5-4 「アイデンティティ・ブラウザ」コントロール・ページ

5.1.4.3 「コメント」コントロール・ページについて

「コメント」コントロール・ページでは、図5-5で示すようにタスクのコメントの表示およびタスクへのコメントの追加ができます。「コメント」コントロール・ページのパラメータは、表A-9にリストされています。

ユーザーにコメントの入力を要求できます。たとえば、「承認」アクション・リンクにより、承認タスクを完了する前にユーザーにコメントの入力を要求できます。

図5-5 「コメント」コントロール・ページ

5.1.5 プロンプトおよび検証について

ソリューション・アプリケーション構成の一部として、ヒューマン・タスク・フローにプロンプトおよび検証を含めることができます。

プロンプトについて

プロンプトは、機能ブロックの一部として指定されたメッセージを表示します。プロンプトを検証の前または後に表示させることで、ユーザーはアクションの取消し/続行または変更を元に戻してアクションの続行を行うことができます。

FunctionalBlockディクショナリのNamedFunctionalBlockPromptプロパティでプロンプトを構成します。たとえば、次の設定を指定します。

- プロンプトを生成する機能ブロック

- プロンプトを表示する時点(検証の前または後)

- ユーザーに表示するプロンプト・メッセージ

- プロンプト・タイプ(OKまたは取消など)

たとえば、「却下」機能ブロック(「却下」リンクをクリックした場合)で生成されるプロンプトを定義できます。検証後に、プロンプトを生成し、プロンプト・メッセージ(「このリクエストを却下しますか。」)とともに「OK」/「取消」ボタンを表示します。プロンプト構成の例は、表5-24を参照してください。

検証について

次のような様々な形で検証を構成できます。

- 検証を即時または機能ブロックを使用して実行できます。
即時検証は、ユーザーがデータ・フィールドを完了してフィールドから移動すると実行されます。

機能ブロック検証は、ページのアクション(「OK」または「取消」ボタンなど)をクリックすると実行されます。

- 検証は、LookupAndValidatorディクショナリで定義されたバリデータによって実行されます。
基本的な検証では、「承認」をクリックすると、データのNULL値を確認できます。NULL値が見つかると、最初に実行する必要があることを注意喚起するメッセージが表示されます。

複合検索では、指定されたバリデータをデータ・フィールドで実行できます。たとえば、DateTimeRangeValidatorは、データ・フィールドのエントリが指定された範囲内に収まっていることを検証します。バリデータ一覧は、表A-35を参照してください。

- 機能ブロック検証では、エラーが発生すると特定の結果(続行、中止またはプロンプト)が生成されます。
機能ブロックが実行されると結果が生成されるため、機能ブロックによって結果を調整できます。

検証タイプに応じて、次のディクショナリを使用して検証を構成します。

- LookupAndValidatorディクショナリ: バリデータ・プロパティおよびValidatorParameterプロパティで、バリデータ・クラスおよびそのパラメータなどの設定を構成します。

- データ・ディクショナリ: データ・アイテムに検証を指定する場合、(DataValidatorプロパティで)検証を実行するフィールドを指定し、即時検証または機能ブロックを使用した検証のどちらを実行するかを指定します。

- TableDataディクショナリ: 表列で検証を指定する場合、(ColumnValidatorプロパティで)検証を実行する列を指定し、即時検証または機能ブロックを使用した検証のどちらを実行するかを指定します。

5.1.6 パッケージについて

ビジネス・ルール・パッケージでは、ソリューション・アプリケーションのディクショナリ・セットにコンテナを用意しています。これには、ソリューション・アプリケーションのすべてのビジネス・ルール(その製品ルール、編集されたルールおよびソリューションのすべてのコンテキストで定義されたすべてのディクショナリなど)が含まれます。(コンテキストは、第5.1.7項で説明しています。)たとえば、HelloBPMソリューションは、oracle.axf.solution.hellobpmというパッケージに含まれていて、すべてのコンテキストで定義されたすべてのディクショナリを含みます。

5.1.7 コンテキストについて

コンテキストは、パッケージの1つ以上のディクショナリの特化されたバージョンであり、ベース・コンテキストとは異なります。つまり、コンテキストは実行するビジネス・ルールを指定します。コンテキストにより、ヒューマン・タスク定義またはペイロード・コンテンツに基づいて、ソリューション・アプリケーションの動作を変更できます。

HelloBPMソリューションの例では、コンテキストはヒューマン・タスクに基づき、表示されるユーザー・インタフェースは選択されたタスクによって異なります。ユーザーがタスク・リストから営業見積入力タスクを選択すると、営業見積承認タスクを選択した後では表示されない追加のタブとアクションが表示されます。

HelloBPMソリューションでは複数のコンテキストを使用して、3つのユーザー・タスク(営業見積入力ユーザー、アカウント・マネージャおよび承認者)に異なる機能を提供します。ベース・コンテキストは、ベース(アクションおよびデータ・フィールドと表を含むタブ)に機能の基本セット(機能ブロック、参照およびバリデータ)および追加機能のコンテキスト・レイヤーを定義します(第5.3.4項を参照してください)。

例5-1に示すように、コンテキストはピリオドで区切った階層文字列を特殊化の降順で構成します。ランタイム・コンテキストに基づいて、BPMのAXFインフラストラクチャは、コンテキストのいずれかでルールを検出するか、またはベース・コンテキストに到達するまで、文字列をトラバースします。

例5-1 コンテキストの階層文字列構造

a.b.c
a.b
a
base

HelloBPMの例として、例5-2にリストされているコンテキストを定義できます。ランタイム・コンテキストがSalesQuoteEntry.Specialistの場合、SalesQuoteEntry.Specialistのコンテキスト・ルールが実行されます。ランタイム・コンテキストがSalesQuoteEntryの場合、SalesQuoteEntryコンテキスト内のルールが実行されます。

例5-2 HelloBPMコンテキスト階層

SalesQuoteEntry.Specialist
SalesQuoteEntry
base

コンテキストの作成、更新および削除を行います。第5.2.6項を参照してください。

- コンテキストの作成および実装には、コンテキストに含める1つ以上のパッケージのディクショナリを指定して、コンテキストのディクショナリを変更することが必要です。

- コンテキストを作成する場合、この項の例で示すように、コンテキスト名にピリオド・デリミタを使用してこれらの階層を指定します。

- コンテキストを完全に削除すると、コンテキストが使用されている場合でもその変更されたルールが削除されます。

5.1.8 データ・フィールド、テーブルおよび参照について

ほとんどのBPMイメージング・ソリューションには、ユーザーによって表示または編集できるビジネス・データ・アイテムが含まれます。ビジネス・ルールを使用すると、ソリューション・アプリケーションでのデータ・アイテムの表示方法および動作方法をカスタマイズできます。いずれの場合も、データ・ソースはヒューマン・タスク・ペイロードです。

「マスター・ディテール」ページ・コンポーネントは、ソリューション・アプリケーションの動的タブでデータ・アイテムを表示します。次のデータ・コントロールを組み込んで構成できます(図5-6に示し、HelloBPMソリューション(第5.3項)で使用されています)。

- データ・フィールド(表示または編集用の個々のデータ・アイテムです)。第5.1.8.1項を参照してください。

- 表(列として表示されるデータ・アイテムです)。第5.1.8.2項を参照してください。

- 参照(静的または動的な選択リストを提供します。動的参照はデータベース値を返すこともできます)。第5.1.8.3項を参照してください。

図5-6 HelloBPMソリューションで構成されたデータ・コントロール

5.1.8.1 データ・フィールドについて

表5-4は、ユーザーに表示できるデータ・フィールドのタイプをリストしています。図5-6に例を示しています。

表5-4 データおよびデータ・フィールドのタイプ

タイプ

外観

説明

入力テキスト

これらのフィールドにはテキストおよび数値を使用します。「番地」、「市区町村」、「都道府県」および「郵便番号」フィールドが入力テキスト・フィールドです。

出力テキスト

これらのフィールド(「商談ID」など)は読取り専用です。

入力日

これらのフィールド(「有効期限終了」など)には、「日付の選択」アイコンが表示されます。クリックして表示されるカレンダから日付を選択します。

入力数値

これらのフィールド(「数量」など)には、数値スピンボックスが表示されます。上の三角形をクリックすると数値が1ずつ増加し、下の三角形をクリックすると数値が1ずつ減少します。

静的ドロップダウン

これらのドロップダウン・フィールド(「ステータス」フィールドなど)の三角形をクリックし、表示される選択リストから選択します。

静的ドロップダウンは静的参照で使用されます。

動的検索

これらのフィールド(「アカウント名」フィールドなど)の「検索」アイコンをクリックし、表示される検索結果から選択します。必要に応じて、追加の検索基準を指定し、検索結果を絞ることができます。

動的検索はSQLベースの参照で使用されます。

セクションのデータ・フィールドをグループ化できます。図5-6に、「アカウント」および「住所」セクションでグループ化されたデータ・フィールドを示しています。

データ・フィールドの指定には、フィールドで表示されるコンテキストのデータ・ディクショナリに新規データ・アイテムを追加し、次のようなプロパティを指定する必要があります。

- 表示順序およびセクション(存在する場合)

- 値の読取りおよび書込み先を指定するバインディング名

- 特殊属性(色など)

- その他の特殊オプション(参照など)

データ・コンポーネントの構成オプションについては、データ・ディクショナリを参照してください。

5.1.8.2 表について

表は、単一アイテムとしてではなく、列フォーマットで表示されるデータ・フィールドです。たとえば、図5-6に示す「製品」表には、列と行で配置された複数のデータ・アイテムが含まれます。これには、表の行の挿入、削除、コピーおよび貼付けを行う標準オプションがあり、複数の明細品目の複製や多少の変更が必要な場合に役立ちます。

表には、表5-4に示したデータ・アイテム・タイプを含めることができます。表5-5に記載されている表コントロールを含めることができます。

表5-5 使用可能な表コントロール

コントロール

説明

表示

このメニューから表ビュー・オプションを選択します。

- 列: 表で選択された列を表示または非表示にします。リストから選択するか、「列」、「列の管理」の順に選択します。

- 連結解除: 次の連結解除の要素に記載されているように表を拡大します。

挿入

表の下部に新規行を追加できます。

削除

選択した行を表から削除できます。

コピー

選択した行から1つ以上の列を、貼付け用にコピーできます。コピーする各列を選択するか、「すべて」を選択します。

貼付け

前にコピーした行から選択した行と列を置換できます。

タスクの詳細ペインを大きくするために表を拡大できます。「連結解除」アイコンを再度選択し、表の表示を元のビューに戻すことができます。

表の指定には、表が表示されるコンテキストのTableDataディクショナリに新規表を追加し、次のようなプロパティを指定する必要があります。

- 表の行と列のロード先を定義するバインディング

- 行で作業するために「コピー」、「貼付け」、「削除」および「挿入」ボタンの有効化または無効化

- 列ストレッチなどの設定オプション

- 列の設定(値の読取り先や書込み先を指定するバインディング名など)、表示順序、列幅および参照オプション

注意:

TableDataディクショナリには1つの表定義を指定できます。

5.1.8.3 参照について

参照は参照リストにリンクされたデータ・アイテム(個々のフィールドまたは表列)です。たとえば、図5-6では、「ステータス」および「アカウント名」をデータ・フィールド参照として、「製品名」を表参照として示しています。参照は、データ・フィールドおよび表で同じように機能します。

参照には次のタイプがあります。

- 静的(固定リストにリンクされ、ドロップダウン選択リストで表示されます)。たとえば、「ステータス」フィールドは、「開く」、「承認保留中」または「クローズ済」の値を選択する固定参照です。これらの参照値は、LookupAndValidatorディクショナリのStaticLookupルールセットで定義されます。

- 動的(SQLデータベースにリンクされ、問い合せる際にクリックする検索アイコンとともに表示されます)。たとえば、「アカウント名」および「製品名」フィールドは、動的参照です。動的参照を構成し、動的参照からアイテムを選択した際に他のデータ・フィールドを自動移入することもできます。たとえば、HelloBPMソリューションのAccountName参照はAccountName参照から住所フィールドを移入します。

参照の指定には、1つ以上のコンテキストで使用するLookupAndValidatorディクショナリに新規参照を追加することが必要です。主な手順は次のとおりです。

- 静的参照の場合、値および値の順序を指定します。

- 動的参照の場合、Enterprise Managerで参照のデータベース構成を作成し、指定されたデータベース接続を再実行するためにSQL問合せを指定します。また、参照で選択した際に、選択された値が格納されるバインディングの場所を指定する必要があります。

- データまたはTableDataディクショナリでは、データまたは表フィールドに対して新規参照を参照します。

5.1.9 ビジネス・ルール変更の無効化または破棄について

カスタム・ビジネス・ルールを編集する場合、変更を一時的に無効にするか、完全に破棄するかを決定できます。たとえば、「ルールの管理」タブで検証するビジネス・ルールを取得できない場合、変更を破棄できます。

- いずれかの時点で参照用に製品ルールを表示するには、「ルールの管理」タブの「ルール・タイプ」フィールドから「製品ルール」を選択します。選択したら、「編集」リンクを「表示」に変更し、製品ルールを読取り専用にします。

- ディクショナリのカスタム・ルールをデフォルトの製品設定に完全にリセットするには、「製品にリセット」ボタンを使用します。第5.2.7項を参照してください。

- 製品モードで指定されたソリューションを実行するには、一時的にすべてのビジネス・ルールの変更を停止します。第5.6.2項を参照してください。

5.2 ソリューション・アプリケーションの構成に関するスタート・ガイド

この項の内容は次のとおりです。

- 第5.2.1項「BPMイメージング・ソリューションの実行または適用」

- 第5.2.2項「ソリューション管理の起動」

- 第5.2.3項「「コマンド・ドライバ」ページからのユーザーとしてのソリューションのテスト」

- 第5.2.4項「HelloBPMソリューションで使用するタスクの挿入」

- 第5.2.5項「ビジネス・ルールの管理」

- 第5.2.6項「コンテキストの管理」

- 第5.2.7項「ディクショナリのカスタム・ルールの製品設定へのリセット」

5.2.1 BPMイメージング・ソリューションの実行または適用

BPMイメージング・ソリューションのインストールが完了した後で、実装のために次のいずれかの手順を完了します。

- HelloBPMイメージング・ソリューションを使用します。これは、インストール時に自動的に構成されます。第5.3項を参照してください。このソリューションを使用してBPMイメージング機能を検証し、構成変更の検索および実行で使用するためにカスタマイズします。
または

- ソリューション・アクセラレータを適用します。アクセラレータを入手するには、システム・インテグレータまたはOracle Consultingに連絡してください。

5.2.2 ソリューション管理の起動

ソリューション管理の「ルールの管理」リンクを使用してビジネス・ルールへのアクセスおよび編集を行うには、Oracle WebLogic Serverでaxfadminグループに割り当てる必要があります。

ソリューション・アプリケーションの管理機能にアクセスするには、次の手順を実行します。

1. 次の形式を使用して、ソリューション管理ページを開きます。
http://hostname:port/axf/faces/pages/axfadmin.jspx

2. ユーザーID (Oracle WebLogic Server)およびパスワードを入力し、「サインイン」をクリックします。
図5-7に示すように、ソリューション管理ウィンドウが表示されます。

図5-7 ソリューション管理リンク

3. 左側のペインの「管理リンク」をクリックします。

- 「コマンド・ドライバ」をクリックし、ユーザーとしてソリューションを実行します。第5.2.3項を参照してください。

- 「ルールの管理」をクリックし、ソリューション・ディクショナリおよびビジネス・ルールを表示または更新します。第5.2.5項を参照してください。

- 「コンテキストの管理」をクリックし、特定のヒューマン・タスクなどのランタイム・コンテキストの様々なビジネス・ルールを作成、更新または削除します。第5.2.6項を参照してください。

5.2.3 「コマンド・ドライバ」ページからのユーザーとしてのソリューションのテスト

「コマンド・ドライバ」ページでは、ビジネス・アプリケーションまたは電子メール・リンクからAXFを起動しなくても機能の検索またはビジネス・ルールおよびコンテキストを対象とした更新のテストを行うために、エンド・ユーザーとしてAXFアプリケーションを実行できます。

注意:

FirefoxでBPMイメージング・ソリューションを使用している場合には、ポップアップ・ブロッカがオンになっていることを確認してください。ポップアップ・ブロッカがオフの状態のFirefoxで実行すると、ソリューションが正しくロードしない場合があります。

コマンド・ドライバを使用するには、次の手順を実行します。

1. ソリューション管理ページ(第5.2.2項を参照)で、「管理リンク」の「コマンド・ドライバ」リンクをクリックします。
「コマンド・ドライバ」オプションが表示されます。

2. 「入力パラメータ」で、solutionNamespaceフィールドにSalesQuoteEntryを、commandNamespaceフィールドにStartSalesQuoteEntryを入力します。
HelloBPMソリューションでは、デフォルトのコンテキストはヒューマン・タスクに基づいています。選択するヒューマン・タスクにより、表示されるユーザー・インタフェース(表およびタブ)が決まります。

3. 「リクエストの実行」ボタンをクリックします。
conversationIdおよび他の対応するフィールドでの入力によって指定されたとおり、対話が開始されます。

4. 「レスポンス・コマンド」で、「レスポンスの実行」ボタンをクリックします。
新規ブラウザ・ウィンドウが開き、「ソリューション・ワークスペース」ページが表示されます。

HelloBPMソリューションでは、単一管理者ユーザーに対してBPMビューが構成され、すべてのタスクが単一デフォルト・ビューに割り当てられます。タスクを挿入するには、第5.2.4項を参照してください。

5. リストからタスクを選択し、右下のペインのソリューション・アプリケーションにその詳細を表示します。
「ビュー」および「タスク・リスト」ペインを非表示にする、または「ビュー」ペインを固定/固定解除することで、ソリューション・アプリケーション・ビューを全画面表示できます。『Oracle Fusion Middleware Oracle WebCenterアプリケーション・アダプタの使用』を参照してください。

6. タスクの再選択後にビジネス・ルールを変更して、その結果を表示するために、ソリューション・アプリケーション・ユーザー・ビューとソリューション管理(第5.2.2項)を簡単に切り替えることができます。

5.2.3.1 コマンド・エグゼキュータの使用

コマンド・エグゼキュータにより、「コマンド・ドライバ」ページに入力された同じ情報を表すURLリンクを定義できます。たとえば、コマンド・エグゼキュータURLはユーザーへの電子メール・リンクで使用されます。

コマンド・エグゼキュータの例として、次のURLを使用し、HelloBPMソリューションのソリューション・ワークスペースを表示します。

http://hostname:port/axf/faces/command/CommandExecutor.jspx?sol=SalesQuoteEntry&cmd=StartSalesQuoteEntry

サインインをすると、指定したソリューション・ワークスペースが表示されます。

5.2.4 HelloBPMソリューションで使用するタスクの挿入

BPMのAXFインフラストラクチャとともに自動的にインストールされるHelloBPMソリューションには、ソリューションへのタスクの挿入に使用できるコンテンツ入力ファイルが付属しています。イメージングの入力エージェントを使用してタスクを挿入すると、ソリューション・アプリケーションの変更をテストできます。必要に応じて、入力ファイルを変更し、第5.3項に記載されているHelloBPMワークフローに一致させることができます。初期構成の詳細は、『Oracle Fusion Middleware Oracle WebCenter Contentのインストールと構成』のHelloBPMを使用したBPM用のAXFのインストールおよび構成の検証に関する説明を参照してください。

コンテンツ・ファイルは、HelloBPM.xml、イメージング・アプリケーション定義とともに次のディレクトリにあります。

$ECM_ORACLE_HOME/axf_bpm/ipm

サンプル入力ファイルには次のものが含まれます。

- TestSalesQuote.pdf(サンプル・イメージを含む)

- TestSalesQuote.txt(入力ファイルを含む)

- TestSalesQuote.xml(ドキュメントのサポートするコンテンツを含む)

この項では、タスクの挿入方法を説明します。アダプタのインストール時に構成されたデフォルトのディレクトリが使用されていて、前述の入力ディレクトリのファイルを検索するために入力エージェントが構成されていることを前提としています。詳細は、Oracle Fusion Middleware Oracle WebCenter Content: Imagingの管理の入力エージェントの有効化に関する説明を参照してください。

入力エージェントに対して指定された時間間隔(デフォルトでは15分)内で、入力エージェントは入力ファイルを検出し、テキスト入力ファイルに含まれるデータ値、PDFに含まれるイメージおよびXMLファイルに含まれるサポートするコンテンツを使用してドキュメントを作成します。

HelloBPMソリューションを使用する場所のワークフロー構成に基づいて、タスクは、BPMタスク・リストに表示されるドキュメント用に作成されます。

1. タスク・リストでは、新規に挿入されたタスクをクリックし、その詳細をソリューション・アプリケーションで表示します。

2. 必要に応じて、入力ファイルを再度挿入する前に、入力ファイルのデータ値を変更します。たとえば、アカウント情報が欠落しているタスクを挿入し、そのヒューマン・タスク・フローを使用します。

5.2.5 ビジネス・ルールの管理

この項では、ソリューション・アプリケーション管理の基礎を説明します。ソリューションのビジネス・ルールを編集することにより、各コンテキストのソリューション・アプリケーションのユーザー・インタフェースをカスタマイズします。ほとんどの場合、このプロセスには、コンテキストのディクショナリを開いて、ルールの選択やルールセットへのルールの追加を行い、プロパティを指定することが必要です。ビジネス・ルールの管理のバックグラウンド情報は、第5.1.2項を参照してください。

1. ソリューション管理ページ(第5.2.2項を参照)で、「ビジネス・ルールの管理」の「ルールの管理」リンクをクリックします。
「ルールの管理」オプションが表示されます。

2. 「パッケージ」フィールドで、ソリューション・パッケージを選択します。必要に応じて、「リフレッシュ」をクリックし、パッケージのリストを再ロードします。
たとえば、oracle.axf.solution.hellobpmを選択し、HelloBPMソリューションのビジネス・ルールを表示します。

3. 「コンテキスト」フィールドで、「ベース」を選択し、ベース・ディクショナリのルールまたはこのコンテキストのルールを編集するために以前に作成されたコンテキストを編集します。
図5-8に示すように、選択したパッケージに対して定義されたディクショナリが表に表示されます。

図5-8 「ルールの管理」ウィンドウ、ベース・コンテキストのディクショナリ

4. 「カスタム・ルール」は「ルール・タイプ」フィールドで選択します。
読取り専用の製品ルールとは異なり、カスタム・ルールは編集できます。変更したカスタム・ルールをその製品のデフォルトに戻すこともできます。第5.2.7項を参照してください。

5. 編集するディクショナリに対応する「編集」リンクをクリックします。

- 図5-9に、DynamicTabディクショナリの「編集」リンクをクリックすると表示される「ルールの管理」ウィンドウを表示します。

- 表5-6では、「ルールの管理」ウィンドウでルールを追加、編集または削除するツールを説明します。

図5-9「ルールの管理」ウィンドウ、DynamicTabディクショナリの編集

表5-6「ルールの管理」ウィンドウのツール

要素

説明

ビジネス・ルール

この中央ヘッダーには、現在編集中のパッケージ、コンテキストおよびディクショナリがリストされます。たとえば、図5-9に示すビジネス・ルールには次のものが表示されています。

- パッケージ(oracle.axf.solution.hellobpm)

- コンテキスト(ベース)

- ディクショナリ(DynamicTab)

ルールセット

ディクショナリに対して編集できるルールセットがリストされています。選択されたルールセットのルールが編集用に右側に表示されます。使用されていないルールセットには、新規アイテムを簡単に追加できるようにルールセットのプレースホルダが含まれます。

ビジネス・ルールの変更を保存しないでルールを閉じるには、このボタンをクリックします。

ルールを検証するには、このボタンをクリックします。「ビジネス・ルール検証ログ」セクションに結果が表示されます。

ビジネス・ルールに行った変更を検証して保存するには、このボタンをクリックします。検証エラーが見つかった場合は、警告が表示されます。

このディクショナリのビジネス・ルールに行った変更をすべて破棄して、ディクショナリをその製品ルール設定に戻すには、このボタンをクリックします。

注意: このアクションを元に戻すことはできません。

「アクションの追加」アイコンをクリックし、新規ルールを選択したルールセットに追加します。

「プロパティの編集」アイコンをクリックし、選択したルールのプロパティを編集します。

「削除」アイコンをクリックし、選択したルールをルールセットから削除します。

ビジネス・ルール検証ログ

「検証」ボタンをクリックすると、ディクショナリの検証結果が表示されます。

6. ルールを編集するには、「ルールセット」でそのルールセットを選択します。リストされた「THEN」のアイテムから、ルールの「プロパティの編集」アイコンをクリックします。

図5-10に示すように、ルールのプロパティを編集します。適用可能な場合は、「値」(拡大鏡)アイコンをクリックすると、プロパティに適用可能な値が表示されます。たとえば、タブ・ルールのpageComponentプロパティの「値」アイコンをクリックすると、ページ・コンポーネント値に適用可能な値が表示されます。プロパティを指定する際には、A.1項のディクショナリ・プロパティのリファレンス、第5.3.6項および第5.3.5項のHelloBPMソリューションに対して選択された設定例を参照してください。

注意:

プロパティ・タイプを表示する場合は、引用符を含める必要があります。「定数」フィールドをチェックし、自動的に引用符を追加します。

プロパティを入力する際、大文字と小文字に注意してください。たとえば、"salesRepName"と"SalesRepName"は別々のエントリとして扱われます。

図5-10 ルールのプロパティの編集(DynamicTabディクショナリのタブ・プロパティ)

7. ルールを追加するには、「ルールセット」でルールセットを選択します。「THEN」のアイテムを表示するセクションでは、「アクションの追加」アイコン(次に示す)の逆向きの三角形をクリックし、新規アサートを選択してルールのリスト下部で新規アイテムを追加します。

新規アサートの横にあるフィールドから、追加するアイテムを選択します。通常、前のアイテムに割り当てられたタイプと同じタイプを選択します(たとえば、新規タブをタブ・ルールセットに追加します)。

次に表示されている「プロパティの編集」アイコンをクリックし、ルールのプロパティを編集します(図5-10および手順6を参照してください)。必要な場合のみ、各プロパティの「定数」ボックスをチェックして、引用符を追加します。

8. ルールに対して行った変更または追加を検証し、ディクショナリを保存して閉じます。

- 「保存」ボタンをクリックすると、最初に検証を行い、エラーが発生した場合は保存の前に警告します。ウィンドウ下部の検証ログでは、検出されたエラーまたは警告が表示されます。

- 「閉じる」ボタンをクリックします。保存しないでディクショナリを閉じると、変更は保存されません。

9. 「コマンド・ドライバ」ページ(第5.2.3項)を使用して、結果を表示します。
別のブラウザ・ウィンドウでソリューション・アプリケーション・ユーザー・ビューを開いておくと、結果の編集と表示を素早く切り替えることができます。ディクショナリの変更結果を表示するには、タスクを閉じてから再度開く必要があります。

5.2.6 コンテキストの管理

コンテキストを管理するには、次の項を参照してください。コンテキストに関するバックグラウンド情報は、第5.1.7項を参照してください。

- 第5.2.6.1項「コンテキストの作成」

- 第5.2.6.2項「コンテキストの更新」

- 第5.2.6.3項「コンテキストの削除」

5.2.6.1 コンテキストの作成

コンテキストを作成し、ベース・ルールの特殊化を可能にします。

1. ソリューション管理ページ(第5.2.2項を参照)で、「ビジネス・ルールの管理」の「コンテキストの管理」リンクをクリックします。

2. 「アクション」の選択肢から、「作成」を選択します。

3. 「パッケージ」フィールドで、コンテキストを追加するパッケージを選択します。

4. 「コンテキスト」フィールドに、新規コンテキスト名を入力します。
必要に応じて、コンテキスト名にピリオド・デリミタを使用し、コンテキスト階層を作成します(第5.1.7項を参照してください)。

5. コンテキストに含めるディクショナリを「選択済」フィールドに移動します。

6. 「変更の適用」ボタンをクリックします。

7. ビジネス・ユーザーのロールに応じて、新規コンテンツのディクショナリを編集します(第5.2.5項を参照してください)。

5.2.6.2 コンテキストの更新

コンテキストを更新して、ユーザー・ロールに選択済ディクショナリを含めるか、またはユーザー・ロールから選択済ディクショナリを除外します。

1. ソリューション管理ページ(第5.2.2項を参照)で、「ビジネス・ルールの管理」の「コンテキストの管理」リンクをクリックします。

2. 「アクション」の選択肢から、「更新」を選択します。

3. 「パッケージ」フィールドで、編集するコンテキストを含むパッケージを選択します。

4. 「コンテキスト」フィールドで、更新するコンテキストを選択します。

5. 含めるディクショナリを「選択済」フィールドに移動し、除外するディクショナリを「使用可能」フィールドに移動します。

6. 「変更の適用」ボタンをクリックします。

7. ビジネス・ユーザーのロールに応じて、ディクショナリを編集します(第5.2.5項を参照してください)。

5.2.6.3 コンテキストの削除

コンテキストを削除すると、ソリューションで使用されていても、選択済のディクショナリとそのビジネス・ルールは削除されます。

1. ソリューション管理ページ(第5.2.2項を参照)で、「ビジネス・ルールの管理」の「コンテキストの管理」リンクをクリックします。

2. 「アクション」の選択肢から、「削除」を選択します。

3. 「パッケージ」フィールドで、削除するコンテキストを含むパッケージを選択します。

4. 「コンテキスト」フィールドで、削除するコンテキストを選択します。

5. 「変更の適用」ボタンをクリックします。削除する場合、削除を確定します。

5.2.7 ディクショナリのカスタム・ルールの製品設定へのリセット

ディクショナリのカスタム・ビジネス・ルールを製品設定に完全にリセットすると、行ったビジネス・ルールの変更がすべて削除され、カスタム・ルールが製品ルールに戻されます。これは、ソリューションの実行時にエラー受け取った場合またカスタマイズが検証されない場合に役立ちます。製品ルールにリセットすると、選択済のディクショナリに行ったすべての変更が削除されます。ソリューションの各ディクショナリをそれぞれリセットする必要があります。

または、RunAsProduct MBean設定を使用して、すべてのビジネス・ルールの変更を一時的に削除することもできます(第5.6.2項を参照してください)。

ベース・コンテキストなどのすべてのコンテキストに対してディクショナリ・ルールをリセットできます。コンテキストに対してリセットを行う場合、影響を与えるのはそのコンテキストのディクショナリのみです。

ディクショナリのカスタム・ルールを製品ルールにリセットするには、次の手順を実行します。

1. 「ルールの管理」タブで、パッケージおよびコンテキストを選択します。

2. ルール・ディクショナリの「編集」リンクをクリックします。ディクショナリが開きます。

3. 「製品にリセット」ボタンをクリックします。ビジネス・ルールの変更を完全に削除するかどうかを確認するプロンプトが表示されます。

4. 「OK」をクリックします。製品ディクショナリ・ルールはカスタム・ルールに正常に置換されましたというメッセージが表示されます。
ソリューション・アプリケーションでタスクをクリックしても、前のビジネス・ルールの変更は表示されません。

5.3 HelloBPMソリューションについて

この項の内容は次のとおりです。

- 第5.3.1項「HelloBPMソリューションとは」

- 第5.3.2項「HelloBPM営業見積システムの概要」

- 第5.3.3項「HelloBPMユーザー・ロールおよびワークフロー」

- 第5.3.4項「HelloBPMソリューションでのコンテキストの使用方法」

- 第5.3.5項「営業見積入力コンテキストのビジネス・ルール」

- 第5.3.6項「ベース・コンテキストのビジネス・ルール」

5.3.1 HelloBPMソリューションとは

HelloBPMソリューションは、BPMのAXFソリューションの例であり、BPMのAXFインフラストラクチャを使用して自動的にインストールおよび構成されます。コンポーネントを提供し、次のことを実行します。

1. ユーザーとしてBPMのAXF機能を確認し、理解します。
第5.2.2項の説明に従ってHelloBPMソリューションを起動し、第5.2.3項の説明に従ってユーザーとして実行します。

2. HelloBPMの例を確認し、ユースケースを使用することで、ビジネス・ルールの変更を理解します。
ビジネス・ルール機能の管理(図5-7を参照)を使用して管理者としてソリューション・アプリケーションの構成を開始し、ユーザーとしてソリューション機能をテストします(図5-11を参照)。

ユースケースでは、HelloBPMソリューションのディクショナリおよびコンテキストの変更例に加えて、ユーザーとして変更をテストおよび表示する例を提供します。

注意:

HelloBPMソリューションのルールを変更する際はいつでも、ディクショナリ・ルールを元の製品設定にリセットできます。第5.2.7項を参照してください。

5.3.2 HelloBPM営業見積システムの概要

HelloBPMソリューションでは、架空の営業見積システムを説明しています。ソリューションには、3つのユーザー・コンテキストおよびロールに対応する次のBPMヒューマン・タスクが含まれます。

- 営業見積入力

- 営業見積アカウント・マネージャ

- 営業見積承認

図5-11に、メイン・ユーザー(営業見積入力ユーザー)に表示されるソリューション・アプリケーション(タスク詳細)を示しています。

図5-11 HelloBPMソリューションの営業見積入力ユーザーとしての表示

5.3.3 HelloBPMユーザー・ロールおよびワークフロー

HelloBPMソリューションの基本ワークフロー機能は次のとおりです。

1. 営業見積入力タスクをシステムに流し込みます。営業見積入力タスクとしてタスク・リスト・ビューに表示されます。
営業見積入力ユーザー(入力ユーザー)は、タスクを選択し、図5-11に示す製品やライセンスの表などのフィールドを確認し、入力します。この入力ユーザーは次のアクション・リンクにアクセスできます。

- 承認: 営業見積入力ユーザーがこのリンクをクリックすると、「アイデンティティ・ブラウザ」コントロール・ページが表示されるので、入力ユーザーは承認者を選択します。「アイデンティティ・ブラウザ」コントロール・ページの「OK」アクションをクリックすると、タスクは完了し、SalesQuoteApproverヒューマン・タスクにルーティングされます。

- 却下: 入力ユーザーがこのリンクをクリックすると、却下するかどうかを確認するプロンプトが表示されます。

- アカウント・マネージャ (例外セクション): このリンクは、「アカウント名」フィールドに入力がない場合のみユーザーを入力するためにアクティブになります。入力ユーザーがこのリンクをクリックすると、「アカウント・マネージャの理由の選択」画面が表示されるので、理由(新規アカウント、無効な住所または期限切れアカウントなど)を選択します。

2. 営業見積アカウント・マネージャ(アカウント・マネージャ)は、ソリューション・ワークスペースを入力し、営業見積アカウント・マネージャ・タスクを選択します。アカウント管理の更新を完了し、タスクを保存して閉じます。

3. A 営業見積承認者(承認者)は、ソリューション・ワークスペースを入力し、営業見積承認タスクを選択します。タスクを承認または却下します。承認された場合、タスクは自動的に完了としてマークされ、タスク・リストから削除されます。

このワークフローを図5-12に示します。

図5-12 HelloBPMソリューションの基本ワークフロー

5.3.4 HelloBPMソリューションでのコンテキストの使用方法

HelloBPMソリューションに含まれる3つのヒューマン・タスクは、それぞれ個別のデータおよびアクションにアクセスする必要があるため、複数のコンテキストは、選択されたタスクのタイプに応じて、個別のユーザー・インタフェースおよびカスタマイズされたユーザー・インタフェースを表示するように構成されています。たとえば、SalesQuoteEntryタスクを選択した場合、タスクが完了すると追加のタブおよびアクションが表示されます。

図5-13 HelloBPMソリューションのコンテキスト

ソリューションのコンテキストには、次のものが含まれます。

- 営業見積承認タスクを選択すると、「製品」または「ライセンス条項」タブは表示されませんが、「承認」および「却下」コマンドおよび承認/却下の決定を文書化する「コメント」タブにアクセスできます。承認者コンテキストには、このタイプのタスクにアクション、タブおよびデータ・フィールドを定義するためにアクション、DynamicTabおよびデータ・ディクショナリのみが含まれます。

- 営業見積アカウント・マネージャ・タスクを選択すると、営業アカウントの設定または変更に制限された機能が表示されます。このタスクでは、組織の連絡先情報の変更、および詳細なデータ入力または承認に対するタスクのルーティングを行うことができます。承認タスクと同様に、アカウント・マネージャ・コンテキストには、このタイプのタスクで表示されるアクション、タブおよびデータ・フィールドを定義するためのアクション、DynamicTabおよびデータ・ディクショナリのみが含まれます。

- 営業見積入力タスクを選択すると、最も特化されたタスクが、追加の「製品」および「ライセンス条項」タブおよび「アカウント・マネージャ」アクション・リンクのある「例外」セクションとともに表示されます。このコンテキストには、追加のタブ、アクションおよびデータ・フィールドを表示するアクション、DynamicTabおよびデータ・ディクショナリが含まれます。

- SalesQuoteEntry_ProductItemおよびSalesQuoteEntry_LicenseTermコンテキストには、「製品」および「ライセンス条項」表をそれぞれ表示するためにTableDataディクショナリのみが含まれます。

- SalesQuoteEntry_AccountManagerReasonコンテキストには、「アカウント・マネージャ」アクション・リンクを選択すると理由参照データ・フィールドが表示されるように、データ・ディクショナリが含まれます。

5.3.5 営業見積入力コンテキストのビジネス・ルール

- SalesQuoteEntryコンテキストのアクション・ルールセット

- SalesQuoteEntryコンテキストのデータ・ルールセット

- SalesQuoteEntryコンテキストのDynamicTabルールセット

- SalesQuoteEntry_AccountManagerReasonコンテキストのデータ・ルールセット

- SalesQuoteEntry_ProductItemコンテキストの表ルールセット

- SalesQuoteEntry_LicenseTermコンテキストの表ルールセット

5.3.5.1 SalesQuoteEntryコンテキストのアクション・ルールセット

アクション・ディクショナリはSalesQuoteEntryコンテキストに含まれているため、ベース・コンテキストの定義ではなく、SalesQuoteEntryコンテキストの定義が使用されます。次のアクションを定義します。

- 「承認」リンク(アクションを実行するためにSendSalesQuoteEntryToSalesQuoteApprovalという機能ブロックを使用します)。

- 「アカウント・マネージャ」コマンド(「例外」というアクション・ドロップダウン・メニューに含まれます)。「アカウント名」フィールドが空白である場合を除いて、「アカウント・マネージャ」コマンドは無効化されます。

- 「閉じる」というアクション・ドロップダウン・メニュー(「保存して閉じる」および「元に戻して閉じる」コマンドが含まれます)。

表5-7 アクション・プロパティ

actionId

displayName

displayOrder

enableMode

namedFunctionalBlockId

sectionId

"Approve"

"Approve"

1

ENABLE

"SendSalesQuoteEntryToSalesQuoteApproval"

"Reject"

"Reject"

2

ENABLE

"Reject"

"AccountManager"

"Account Manager"

1

ENABLE

"SendSalesQuoteEntryToSalesQuoteAccountManager"

"Exceptions"

"CloseTask"

"Save and Close"

1

ENABLE

"CloseTask"

"Close"

"RevertCloseTask"

"Revert Changes and Close"

2

ENABLE

"RevertCloseTask"

"Close"

表5-8 セクション・プロパティ

disclosed

displayName

displayOrder

enableMode

sectionId

true

"Exceptions"

1

ENABLE

"Exceptions"

true

"Close"

2

ENABLE

"Close"

5.3.5.2 SalesQuoteEntryコンテキストのデータ・ルールセット

データ・ディクショナリはSalesQuoteEntryコンテキストに含まれているため、次のデータ・フィールドおよびセクションを提供できます。(表5-9では、componentClassフィールドに値がないため表示されていません。)

表5-9 データ・プロパティ

displayName

bindingName

displayOrder

lookupId

dataId

enableMode

sectionId

validator

"OPPORTUNITY_ID"

"OpportunityID"

1

"OpportunityID"

DISABLE

"Account"

"STATUS"

"QuoteRequestStatus"

2

"QuoteRequestStatus"

"QuoteRequestStatus"

ENABLE

"Account"

"ACCOUNT_NAME"

"Account Name"

3

"AccountName"

"AccountName"

ENABLE

"Account"

"AccountName"

"VALID_UNTIL"

"Valid Until"

4

"ValidUntil"

ENABLE

"Account"

"STREET"

"Street"

1

"Street"

ENABLE

"Address"

"CITY"

"City"

2

"City"

ENABLE

"Address"

"STATE"

"State"

3

"State"

ENABLE

"Address"

表5-10 セクション・プロパティ

disclosed

displayName

displayOrder

enableMode

sectionId

true

"ACCOUNT"

1

ENABLE

"Account"

true

"ADDRESS"

2

ENABLE

"Address"

表5-11 DataComponentAttributeプロパティ

attributeName

attributeValue

dataId

"contentStyle"

"color:blue"

"OpportunityID"

ComponentAttribute.converterdatetime.dateStyle

"MMM/dd/yyyy"

"ValidUntil"

5.3.5.3 SalesQuoteEntryコンテキストのDynamicTabルールセット

DynamicTabディクショナリは、SalesQuoteEntryコンテキストに含まれているため、追加タブを提供できます。次のタブおよびパラメータを定義します。

- 「製品」および「ライセンス条項」タブを追加します。

- タイトルおよび位置の設定に加えて、パラメータ・ルールセットは、データおよび表コンテキストを新規タブに設定します。たとえば、「製品アイテム」タブを設定し、実際のデータ・フィールドのSalesQuoteEntryコンテキストではなく、表設定にはSalesQuoteEntry_ProductItemコンテキストを使用します。

表5-12 タブ・プロパティ

pageComponent

displayOrder

tabId

displayName

PageComponent.Image Data

1

"Image"

"Image"

PageComponent.Master Detail

2

"ProductItem"

"Products"

PageComponent.Master Detail

3

"LicenseTerm"

"License Terms"

PageComponent.Comment

4

"Comments"

"Comments"

表5-13 TabParameterプロパティ

tabId

parameterKey

parameterValue

"Image"

"HideData"

"false"

"Image"

"SplitterPosition"

"250"

"ProductItem"

"TableDataContext"

"SalesQuoteEntry_ProductItem"

"ProductItem"

"DataContext"

"SalesQuoteEntry"

"ProductItem"

"PageComponentTitle"

"Products"

"LicenseTerm"

"TableDataContext"

"SalesQuoteEntry_LicenseTerm"

"LicenseTerm"

"DataContext"

"SalesQuoteEntry"

"LicenseTerm"

"PageComponentTitle"

"License Terms"

5.3.5.4 SalesQuoteEntry_AccountManagerReasonコンテキストのデータ・ルールセット

データ・ディクショナリは、SalesQuoteEntry_AccountManagerReasonコンテキストに含まれているため、入力ユーザーがアカウント・マネージャの理由を選択するデータ参照フィールドを提供します。(表5-14では、componentClassおよびバリデータ・フィールドに値がないため表示されていません。)

表5-14 データ・プロパティ

displayName

bindingName

displayOrder

lookupId

dataId

sectionId

enableMode

"Account Manager Reason"

"NewCustomer"

1

"AccountManagerReason"

"AccountManagerReason"

"AccountManagerReason"

ENABLE

表5-15 セクション・プロパティ

disclosed

displayName

displayOrder

enableMode

sectionId

true

"Select Account Manager Reason"

1

ENABLE

"AccountManagerReason"

5.3.5.5 SalesQuoteEntry_ProductItemコンテキストの表ルールセット

TableDataディクショナリは、他のコンテキストではなくSalesQuoteEntry_ProductItemコンテキストに含まれているため、営業見積入力ユーザーに製品表が表示されます。

表5-16 表プロパティ

bindingName

enableCopyPaste

enableDelete

enableInsert

tableId

tableStretchMode

"ProductItem"

ENABLE

HIDE

ENABLE

"ProductItem"

TableStretchMode.Blank

(表5-17では、バリデータ・フィールドに値がないため表示されていません。)

表5-17 列プロパティ

bindingName

columnId

componentClass

displayName

displayOrder

enableMode

columnWidth

lookupId

"ProductID"

"ProductID"

"Product ID"

1

DISABLE

"ProductName"

"ProductName"

"Product Name"

2

ENABLE

300

"ProductName"

"ListPrice"

"ListPrice"

"PRICE"

3

ENABLE

"Quantity"

"Quantity"

ComponentClass.RichInputNumberSpinbox

"Quantity"

4

ENABLE

"RestrictedItem"

"RestrictedItem"

ComponentClass.RichSelectBooleanCheckbox

"Restricted Item"

5

ENABLE

表5-18 ColumnComponentAttributeプロパティ

attributeName

columnId

attributeValue

ColumnComponentAttribute.pattern

"ListPrice"

"#{bindings.ListPrice.format}"

5.3.5.6 SalesQuoteEntry_LicenseTermコンテキストの表ルールセット

TableDataディクショナリは、他のコンテキストではなくSalesQuoteEntry_LicenseTermコンテキストに含まれているため、営業見積入力ユーザーにライセンス条項表が表示されます。

表5-19 表プロパティ

bindingName

enableCopyPaste

enableDelete

enableInsert

tableId

tableStretch

"LicenseTerm"

ENABLE

ENABLE

ENABLE

"LicenseTerm"

TableStretchMode.Last

表5-20 列プロパティ

bindingName

columnId

componentClass

displayName

displayOrder

enableMode

columnWidth

lookupId

"Category"

"Category"

"Category"

1

ENABLE

300

"LicenseTermCategory"

"Type"

"Type"

"Type"

2

ENABLE

300

"LicenseTermType"

"Description"

"Description"

"Description"

3

ENABLE

5.3.6 ベース・コンテキストのビジネス・ルール

HelloBPMソリューションのベース・コンテキストは、他のコンテキスト・レイヤーの追加機能の基本となる機能のベース・レイヤーを提供し、その機能ブロックと参照を参照します。

- ベース・コンテキストのFunctionalBlockルールセット

- ベース・コンテキストのLookupAndValidatorルールセット

5.3.6.1 ベース・コンテキストのFunctionalBlockルールセット

次のルールセットは、ソリューションで使用する機能ブロック、シーケンスおよびパラメータを定義します。

NamedFunctionalBlockRulesetは、結果、タスク詳細動的ページ、およびアイデンティティ・ブラウザ、データおよびコメントのコントロール・ページに移動する機能を設定します。

表5-21 NamedFunctionalBlockプロパティ

functionalBlock

namedFunctionalBlockId

FunctionalBlock.Set Outcome

"Approve"

FunctionalBlock.Set Outcome

"Reject"

FunctionalBlock.Set Outcome

"AccountManager"

FunctionalBlock.Close Task

"RevertCloseTask"

FunctionalBlock.Navigate Control Page

"SelectSalesQuoteApprover"

FunctionalBlock.Navigate Control Page

"SelectAccountManagerReason"

FunctionalBlock.Navigate Dynamic Page

TaskDetail"

FunctionalBlock.Navigate Control Page

"IdentityBrowserControlPage"

FunctionalBlock.Navigate Control Page

"DataControlPage"

FunctionalBlock.Navigate Control Page

"CommentControlPage"

FunctionalBlock.Save

"Save"

FunctionalBlock.Close Task

"CloseTask"

FunctionalBlock.Revert

"Revert"

表5-22 NamedFunctionalBlockSequenceプロパティ

namedFunctionalBlockId

functionalBlockSequenceId

順序

"SelectSalesQuoteApprover"

"SendSalesOrderEntryToSalesOrderApproval"

1

"Approve"

"SendSalesOrderEntryToSalesOrderApproval"

2

"SelectAccountManagerReason"

"SendSalesQuoteEntryToSalesQuoteAccountManager"

1

"AccountManager"

"SendSalesQuoteEntryToSalesQuoteAccountManager"

2

表5-23 NamedFunctionalBlockParameterプロパティ

namedFunctionalBlockId

parameterKey

parameterValue

"Approve"

"Outcome"

"APPROVE"

"Reject"

"Outcome"

"REJECT"

"AccountManager"

"Outcome"

"ACCOUNT_MANAGER"

"SelectSalesQuoteApprover"

"ControlPageName"

"IdentityBrowserControlPage"

"SelectSalesQuoteApprover"

"ControlPageTitle"

"Select Approver"

"SelectSalesQuoteApprover"

"UserBindingName"

"UserBindingName"

"SelectSalesQuoteApprover"

"GroupBindingName"

"GroupBindingName"

"SelectSalesQuoteApprover"

"CommentRequired"

"true"

"SelectAccountManagerReason"

"ControlPageName"

"DataControlPage"

"SelectAccountManagerReason"

"DataContext"

"SalesQuoteEntry_AccountManagerReason"

"TaskDetail"

"pageTitle"

SolutionApplicationProperty.TaskTitle

"DataControlPage"

"ControlPageName"

"DataControlPage"

"DataControlPage"

"ControlPageTitle"

"IdentityBrowserControlPage"

"ControlPageName"

"IdentityBrowserControlPage"

"IdentityBrowserControlPage"

"ControlPageTitle"

"IdentityBrowserControlPage"

"UserBindingName"

"UserBindingName"

"IdentityBrowserControlPage"

"GroupBindingName"

"GroupBindingName"

"CommentControlPage"

"ControlPageName"

"CommentControlPage"

"CommentControlPage"

"ControlPageTitle"

表5-24 NamedFunctionalBlockPromptプロパティ

namedFunctionalBlockId

順序

promptMessage

promptMode

promptType

"Reject"

1

"Are you sure you would like to reject this request?"

PromptModeType.AFTER_VALIDATION

PromptType.OK_CANCEL_FUNCTIONAL_BLOCK

"RevertCloseTask"

1

"Are you sure you would like to revert any changes before closing?"

PromptModeType.BEFORE_VALIDATION

PromptType.ROLLBACK_SAVED_CHANGES

表5-25 NamedFunctionalBlockValidatorプロパティ

namedFunctionalBlockId

validatorMode

validatorCategoryId

"Reject"

ValidatorMode.CONTINUE

"Account"

"RevertCloseTask"

ValidatorMode.CONTINUE

"Account"

"CloseTask"

ValidatorMode.CONTINUE

"Account"

5.3.6.2 ベース・コンテキストのLookupAndValidatorルールセット

次のルールセットは、ソリューションの他の部分で使用される参照、プロンプトおよび検証を定義します。

表5-26 StaticLookupプロパティ

displayName

lookupId

値

displayOrder

"Open"

"QuoteRequestStatus"

"OPEN"

1

"Pending Approval"

"QuoteRequestStatus"

"PENDING_APPROVAL"

2

"Closed"

"QuoteRequestStatus"

"CLOSED"

3

"Price Hold Options"

"LicenseTermCategory"

"PriceHoldOptions"

1

"Non-Standard Pricing And Currency Options"

"LicenseTermCategory"

"NonStandardPricingAndCurrencyOptions"

2

"License Management Services Options"

"LicenseTermCategory"

"LicenseManagementServicesOptions"

3

"Non-Standard Licensing Options"

"LicenseTermCategory"

"NonStandardLicensingOptions"

4

"Future Program Price Holds"

"LicenseTermType"

"FutureProgramPriceHolds"

1

"Future Discount Provisions"

"LicenseTermType"

"FutureDiscountProvisions"

2

"Price Hold On Entire Price List"

"LicenseTermType"

"PriceHoldOnEntirePriceList"

3

"Modifications To Contractual Pricing"

"LicenseTermType"

"Modifications ToContractualPricing"

4

"Currency"

"LicenseTermType"

"Currency"

5

"Preferred Customer Provisions"

"LicenseTermType"

"PreferredCustomerProvisions"

6

"Waiving Or Lowering Purchase Minimums"

"LicenseTermType"

"WaivingOrLoweringPurchaseMinimums"

7

"Audit Waivers"

"LicenseTermType"

"AuditWaivers"

8

"Cancel And Replace"

"LicenseTermType"

"CancelAndReplace"

9

"Direct Order From Competitors"

"LicenseTermType"

"DirectOrderFromCompetitors"

10

"Reciprocal Transaction"

"LicenseTermType"

"ReciprocalTransaction"

11

"Hosting"

"LicenseTermType"

"Hosting"

12

"Hosting Rights"

"LicenseTermType"

"HostingRights"

13

"NDA"

"LicenseTermType"

"NDA"

14

"New Account"

"AccountManagerReason"

"NEW_ACCOUNT"

1

"Invalid Address"

"AccountManagerReason"

"INVALID_ADDRESS"

2

"Expired Account"

"AccountManagerReason"

"EXPIRED_ACCOUNT"

3

表5-27 DynamicLookupプロパティ

sqlColumn

dataSource

lookupId

lookupType

sqlQuery

"NAME"

"/jdbc/IPMDS"

"AccountName"

LookupType.DYNAMIC_SEARCH

"select ACCOUNT_NAME as Name, ADDRESS_STREET as Street, ADDRESS_CITY as City, ADDRESS_STATE as State, ADDRESS_ZIP as Zip, ADDRESS_COUNTRY as Country from AXF_HELLOBPM_ACCOUNTS"

"PRODUCT"

"jdbc/IPMDS"

"ProductName"

LookupType.DYNAMIC_SEARCH

"select PRODUCT_ID as ID, PRODUCT_NAME as Product, LIST_PRICE as Price from AXF_HELLOBPM_PRODUCTS"

表5-28 DynamicLookupRelatedBindingプロパティ

bindingName

lookupId

sqlColumn

"Street"

"AccountName"

"STREET"

"City"

"AccountName"

"CITY"

"State"

"AccountName"

"STATE"

"Zip"

"AccountName"

"ZIP"

"Country"

"AccountName"

"COUNTRY"

"ListPrice"

"ProductName"

"PRICE"

"ProductID"

"ProductName"

"ID"

表5-29 バリデータ・プロパティ

validatorClass

validatorId

ValidatorClass."RegExpValidator"

"AccountName"

ValidatorClass."RegExpValidator"

"State"

表5-30 ValidatorParameterプロパティ

parameterKey

parameterValue

validatorId

"Pattern"

"\\S"

"AccountName"

"MessageDetailNoMatch"

"You must enter an Account Name before requesting approval"

"AccountName"

"Pattern"

"AL|AK|AS|AZ|AR|CA|CO|CT|DE|DC|FM|FL|GA|GU|HI|ID|IL|IN|IA|KS|KY|LA|ME|MH|MD|MA|MI|MN|MS|MO|MT|NE|NV|NH|NJ|NM|NY|NC|ND|MP|OH|OK|OR|PW|PA|PR|RI|SC|SD|TN|TX|UT|VT|VI|VA|WA|WV|WI|WY"

"State"

"MessageDetailNoMatch"

"You must enter a valid state abbreviation"

"State"

5.4 HelloBPMソリューションのユースケース

この項に示すユースケース例は、基本シナリオの実装方法を例によって理解しやすくすることを目的としています。

注意:

HelloBPMソリューションは、AXFのインストール時にインストールされます。詳細は、『Oracle Fusion Middleware Oracle WebCenter Contentのインストールと構成』のHelloBPMを使用したBPM用のAXFのインストールおよび構成の検証に関する項を参照してください。

アクションおよび機能ブロックのユースケース

- 第5.4.1項「ユースケース: アクション・リンクの追加および構成」

- 第5.4.2項「ユースケース: データ・コントロール・ページへの移動」

- 第5.4.3項「ユースケース: 新規コンテキストの追加」

データおよび表のユースケース

- 第5.4.4項「ユースケース: 新規セクションへのデータ・フィールドの追加」

- 第5.4.5項「ユースケース: データ・フィールドの背景色の設定」

- 第5.4.6項「ユースケース: データ・アイテムまたはセクションの表示順序の変更」

- 第5.4.7項「ユースケース: 折りたたまれた初期表示へのセクションの設定」

- 第5.4.8項「ユースケース: すべての表の行ボタンの非表示」

参照およびバリデータのユースケース

- 第5.4.9項「ユースケース: 静的参照の構成表示」

- 第5.4.10項「ユースケース: 動的参照の構成表示」

5.4.1 ユースケース: アクション・リンクの追加および構成

この演習では、営業見積承認タスクを完了し、そのタスクを営業見積入力タスク・キューに戻すために、アクション・メニューに「戻る」というリンクを追加する手順を説明します。アクションを追加し、そのアクションに対して機能ブロック設定を構成します。

1. 「ルールの管理」で、「パッケージ」フィールドのHelloBPMパッケージ(oracle.axf.solution.hellobpm)を選択します。

2. SalesQuoteApprovalコンテキストを選択し、アクション・ディクショナリを編集します。

3. アクション・ルールセットでは、新規アサート・アクションを追加し、次のプロパティを割り当てることでアクションを追加します。

プロパティ

値

actionId

"Return"

displayName

"Return"

displayOrder

4

enableMode

EnableMode.ENABLE

namedFunctionalBlockId

"Return"

sectionId

4. ディクショナリを検証し、保存して閉じます。
次の手順では、新規アクションの機能ブロックを構成します(具体的には、タスクを完了するBPMのコールを作成します)。

5. 「ルールの管理」で、ベース・コンテキストを選択し、そのFunctionalBlockディクショナリを編集します。

6. 「ルールセット」で、NamedFunctionalBlockを選択します。新規アサートNamedFunctionalBlockを追加し、次のプロパティを割り当てます。

プロパティ

値

functionalBlock

FunctionalBlock.Set Outcome

namedFunctionalBlockId

"Return"

7. 「ルールセット」で、NamedFunctionalBlockParameterを選択します。新規アサートNamedFunctionalBlockParameterを追加し、次のプロパティを割り当てます。

プロパティ

値

namedFunctionalBlockId

"Return"

parameterKey

"Outcome"

parameterValue

"RETURN"

8. ディクショナリを検証し、保存して閉じます。

9. ここまでの構成をテストします。

1. 「コマンド・ドライバ」ページから、ソリューションをSalesQuoteEntry/StartSalesQuoteEntryとして実行します。

2. タスク・リストで、営業見積承認タスクを選択します。(タスクが営業見積承認タスクとして表示されるように、営業見積入力タスクを承認する必要があります。)

3. アクション・メニューから、追加した新規の「戻る」リンクをクリックします。タスクがタスク・リストから削除されます。これは、そのタスクが営業見積入力に戻されたことを示します。

5.4.2 ユースケース: データ・コントロール・ページへの移動

このユースケースでは、営業見積リクエストを戻す理由の選択方法を構成する手順を説明します。「戻る」リンクをクリックすると、選択する理由コードが表示されるデータ・コントロール・ページ(データが表示される事前定義済ページ)に移動します。

1. HelloBPMパッケージから、ベース・コンテキストを選択し、そのFunctionalBlockディクショナリを編集します。
最初に、コントロール・ページへのナビゲーションを指定します。

2. NamedFunctionalBlockルールセットで、新規アサートNamedFunctionalBlockを追加し、次のプロパティを割り当てます。

プロパティ

値

functionalBlock

FunctionalBlock.Navigate Control Page

namedFunctionalBlockId

"ReturnReason"

次に、移動先のコントロール・ページを指定します。

3. 「ルールセット」で、NamedFunctionalBlockParameterを選択します。新規アサートNamedFunctionalBlockParameterを追加し、次のプロパティを割り当てます。

プロパティ

値

namedFunctionalBlockId

"ReturnReason"

parameterKey

"ControlPageName"

parameterValue

"DataControlPage"

「理由を返す」ページに移動してから、コールのシーケンスを定義します。

4. 「ルールセット」で、NamedFunctionalBlockSequenceを選択します。新規アサートNamedFunctionalBlockSequenceを追加し、次のプロパティを割り当てます。

プロパティ

値

namedFunctionalBlockId

"ReturnReason"

namedFunctionalBlockSequenceID

"ReturnToSalesQuoteEntry"

順序

1

次のコールで、戻るを定義してタスクを完了します。

5. 別の新規アサートNamedFunctionalBlockSequenceを追加し、次のプロパティを割り当てます。

プロパティ

値

namedFunctionalBlockId

"Return"

namedFunctionalBlockSequenceID

"ReturnToSalesQuoteEntry"

順序

2

6. ディクショナリを検証し、保存して閉じます。
最後の手順では、定義した新規のシーケンスをコールするアクションを更新します。

7. SalesQuoteApprovalコンテキストを選択し、アクション・ディクショナリを編集します。

8. namedFunctionalBlockを"Return"から"ReturnToSalesQuoteEntry"に変更することにより、第5.4.1項の手順3で作成したアクションを更新します。

プロパティ

値

actionId

"Return"

displayName

"Return"

displayOrder

4

enableMode

EnableMode.ENABLE

namedFunctionalBlockId

"ReturnToSalesQuoteEntry"

sectionId

9. ディクショナリを検証し、保存して閉じます。

10. 構成をテストします。

1. ソリューション・アプリケーションに戻り、タスク・リストから営業見積承認タスクを選択します。

2. アクション・メニューから、「戻る」リンクをクリックします。構成したナビゲーションに応じて新規の「理由を返す」データ・ページが表示されます。
「理由を返す」データ・ページでは、他のページで表示されたデータと同じデータが表示されます。第5.4.3項の手順を実行し、そのデータ表示を変更します。

3. 「取消」リンクをクリックします。

5.4.3 ユースケース: 新規コンテキストの追加

このユースケースでは、適切なデータ(理由コードを返す)を表示するように、「理由を返す」データ・ページに対するコンテキストを追加する手順を説明します。最初にコンテキストを作成し、その選択肢とともに表示するデータ・フィールドを構成してから、最後に新規コンテキストを使用するデータ・ページを構成します。

1. 左端のメニューから、「コンテキストの管理」を選択します。

2. 「パッケージ」フィールドで、HelloBPMソリューション(oracle.axf.solution.hellobpm)を選択します。

3. 「コンテキスト」フィールドに、SalesQuoteApproval_ReturnReasonの名前を入力します。

4. データ・ディクショナリを「選択済」フィールドに移動し、「変更の適用」をクリックします。
ここで、「理由を返す」データ・ページに表示するデータの属性を定義します。「理由を返す」というデータ・フィールド、およびフィールドから理由コードを選択するように指示するセクションを追加します。

5. 「ルールの管理」を選択します。「コンテキスト」フィールドの横にある「リフレッシュ」アイコンをクリックし、作成した新規コンテキストSalesQuoteApproval_ReturnReasonを選択します。そのデータ・ディクショナリを編集します。

6. データ・ルールセットで、プレースホルダ・ルールを編集し、次のプロパティを割り当てます。

プロパティ

値

displayName

"Return Reason"

bindingName

"NewCustomer"

displayOrder

1

lookupId

"ReturnReason"

dataId

"ReturnReason"

sectionId

"ReturnReason"

enableMode

EnableMode.ENABLE

componentClass

7. セクション・ルールセットを選択し、プレースホルダ・ルールを編集し、次のプロパティを割り当てます。

プロパティ

値

disclosed

true

displayName

"Select the return reason:"

displayOrder

1

enableMode

EnableMode.ENABLE

sectionId

"ReturnReason"

8. ディクショナリを検証し、保存して閉じます。
次の手順では、静的参照として定義する「理由を返す」フィールドに理由コードを構成します。

9. ベース・コンテキストを選択し、そのLookupAndValidatorディクショナリを編集します。

10. StaticLookupルールセットで、新規アサートStaticLookupルールを追加し、次のプロパティを割り当てます。

プロパティ

値

displayName

"Invalid License Terms"

displayOrder

1

lookupId

"ReturnReason"

値

"INVALID_LICENSE_TERMS"

11. 別のStaticLookupルールを追加し、次のプロパティを割り当てます。

プロパティ

値

displayName

"Invalid Product Discount"

displayOrder

2

lookupId

"ReturnReason"

値

"INVALID_PRODUCT_DISCOUNT"

12. ディクショナリを検証し、保存して閉じます。

13. ベース・コンテキストのFunctionalBlockディクショナリを開きます。
最後の手順では、新規コンテキストSalesQuoteApproval_ReturnReasonasを理由を返すデータ・ページで使用するコンテキストとしてを定義します。

14. 「ルールセット」で、NamedFunctionalBlockParameterを選択します。新規アサートNamedFunctionalBlockParameterを追加し、次のプロパティを割り当てます。

プロパティ

値

namedFunctionalBlockId

"ReturnReason"

parameterKey

"DataContext"

parameterValue

"SalesQuoteApproval_ReturnReason"

15. ディクショナリを検証し、保存して閉じます。

16. 最終構成をテストします。

1. ソリューション・アプリケーションに戻り、タスク・リストから営業見積承認タスクを選択します。

2. アクション・メニューから、「戻る」リンクをクリックします。

3. 表示されるデータ・コントロール・ページで、理由を返すフィールドから理由を選択し、「OK」をクリックします。タスクは戻され、削除されます。

5.4.4 ユースケース: 新規セクションへのデータ・フィールドの追加

このユースケースでは、営業担当者名というデータ・アイテム(読取り専用入力テキスト・フィールド)を営業情報というセクション内で表示するデータ・ディクショナリに追加する手順を説明します。別のデータ・フィールド・タイプ(出力(編集可能)テキスト・フィールド、データ入力フィールドまたは数値入力フィールドなど)を作成する手順は、この項の最後のバリエーションで示すようにほぼ同じです。

1. 最初にテキスト・フィールドを追加します。「ルールの管理」で、oracle.axf.solution.hellobpmパッケージのSalesQuoteApprovalコンテキストを選択します。

2. データ・ディクショナリを編集します。

3. 「ルールセット」で、データを選択します。

4. 新規アサート・データを追加し、次の値を入力します。

プロパティ

値

bindingName

"SalesRepName"

componentClass

ComponentClass.RichInputText

displayName

"Sales Rep Name"

displayOrder

lookupId

dataId

"salesRepName"

enableMode

EnableMode.ENABLE

sectionId

"sales"

5. ここで、テキスト・フィールドにセクションを追加します。「ルールセット」で、セクションを選択します。

6. 新規アサート・セクションを追加し、次の値を入力します。

プロパティ

値

disclosed

true

displayName

"Sales Info"

displayOrder

3

enableMode

EnableMode.ENABLE

sectionId

"sales"

7. ディクショナリを検証して保存します。

8. ここで、テキスト・フィールドを表示します。「コマンド・ドライバ」ページから、SalesQuoteEntry/StartSalesQuoteEntryを実行し、営業見積承認タスクを選択します。
結果: 「イメージ」タブで、営業情報という新規データ・セクションを表示します。これには、新規入力テキスト営業担当者名フィールドが含まれます。

バリエーション

データ・アイテムのcomponentClassプロパティがそのタイプを定義します。前述の手順4で、ComponentClass.RichInputTextを指定することにより、入力テキスト・フィールドを定義します。

- データ入力フィールドを定義するには、componentClassプロパティにComponentClass.RichInputDateを指定します。

- 数値入力フィールドを定義するには、componentClassプロパティにComponentClass.RichInputNumberSpinBoxを指定します。

データ・アイテムまたはセクションのenableModeプロパティは、その有効化モードを定義します。前述の手順4および6で、EnableMode.ENABLEを指定することにより、フィールドおよびセクションをそれぞれ有効にします。

- フィールドまたはセクションを無効状態で表示するには、enableModeプロパティにEnableMode.DISABLEを指定します。

- フィールドまたはセクションを非表示にするには、enableModeプロパティにEnableMode.HIDEを指定します。

5.4.5 ユースケース: データ・フィールドの背景色の設定

このユースケースでは、第5.4.4項で追加した営業担当者名データ・フィールドに背景色を設定します。

1. oracle.axf.solution.hellobpmパッケージのSalesQuoteApprovalコンテキストを開きます。

2. データ・ディクショナリを編集します。

3. 「ルールセット」で、DataComponentAttributeを選択します。

4. 新規アサートDataComponentAttributeを追加し、次の値を入力します。

プロパティ

値

attributeName

"contentStyle"

attributeValue

"background-color:lightblue"

dataId

"salesRepName"

5. ディクショナリを検証し、保存して閉じます。

6. 「コマンド・ドライバ」ページから、SalesQuoteEntry/StartSalesQuoteEntryを実行します。

7. 営業見積承認タスクを選択します。
結果: 「イメージ」タブで、営業担当者名フィールドがライト・ブルーの背景で表示されます。

バリエーション

前述のユースケース属性値で、ライト・ブルーのフィールド背景に"background-color:lightblue"が指定されました。フィールドの入力色を指定するには、たとえば、次のいずれかの属性値を指定します。

"color:red"

"color:blue"

5.4.6 ユースケース: データ・アイテムまたはセクションの表示順序の変更

このユースケースでは、セクション内のデータ・セクションおよびデータ・アイテムの順序を戻す方法を示します。

1. 「ルールの管理」で、oracle.axf.solution.hellobpmパッケージのSalesQuoteApprovalコンテキストを開きます。

2. データ・ディクショナリを編集します。

3. 「ルールセット」で、データを選択します。

4. 各データ・アイテムのdisplayOrderプロパティをアカウントのsectionIdで変更すると、データ・アイテムの表示順序が逆になります。

5. 「ルールセット」で、セクションを選択します。

6. 各セクションのdisplayOrderプロパティを変更すると、セクションの表示順序が逆になります。

7. ディクショナリを検証し、保存して閉じます。

8. 「コマンド・ドライバ」ページから、SalesQuoteEntry/StartSalesQuoteEntryを実行します。

9. 営業見積承認タスクを選択します。
結果: 「イメージ」タブで、セクションおよびアカウント・セクションのデータ・フィールドが逆の順序で表示されます。

5.4.7 ユースケース: 折りたたまれた初期表示へのセクションの設定

このユースケースでは、折りたたまれた初期表示にセクションを設定します。

1. 「ルールの管理」で、oracle.axf.solution.hellobpmパッケージのSalesQuoteApprovalコンテキストを開きます。

2. データ・ディクショナリを開きます。

3. 「ルールセット」で、セクションを選択し、disclosedプロパティをfalseに変更することにより営業情報セクションを編集します。

4. ディクショナリを検証して保存します。

5. 「コマンド・ドライバ」ページから、SalesQuoteEntry/StartSalesQuoteEntryを実行します。

6. 営業見積承認タスクを選択します。
結果: 営業情報セクションを閉じた状態で表示します。

注意:

セクションを手動で折りたたまない場合、パーソナライズのためにロードする次のページも折りたたまれていない状態になります。

5.4.8 ユースケース: すべての表の行ボタンの非表示

このユースケースでは、表の行を編集できる有効化された「挿入」、「削除」、「コピー」および「貼付け」ボタンの表示を抑止します。

1. 「ルールの管理」で、oracle.axf.solution.hellobpmパッケージのSalesQuoteEntry_LicenseTermコンテキストを開きます。
このユースケースでは、ライセンス条項表を使用しますが、記載されているようにすべての表を編集できます。

2. TableDataディクショナリを編集します。

3. 「ルールセット」で、表を選択します。

4. 既存の表アイテムを編集します。そのプロパティは次のとおりです。

プロパティ

値

bindingName

"LicenseTerm"

enableCopyPaste

EnableMode.HIDE

enableDelete

EnableMode.DISABLE

enableInsert

EnableMode.HIDE

tableId

"LicenseTerm"

tableStretch

TableStretchMode.Last

5. ディクショナリを検証して保存します。

6. ソリューション・アプリケーションで、営業見積入力タスクを選択し、「ライセンス条項」タブを選択します。
結果: 「ライセンス条項」タブの表では、無効化された「削除」ボタンが表示され、「コピー」、「貼付け」および「挿入」ボタンは非表示になっています。

5.4.9 ユースケース: 静的参照の構成表示

このユースケースでは、静的参照の構成およびユーザーとしての静的参照の使用を説明します。

1. 「ルールの管理」で、oracle.axf.solution.hellobpmパッケージのベース・コンテキストを開きます。

2. LookupAndValidatorディクショナリを編集します。

3. 「ルールセット」で、StaticLookupを選択します。
3つのエントリには、QuoteRequestStatusのlookupIdが含まれます。

4. 「コマンド・ドライバ」ページから、SalesQuoteEntry/StartSalesQuoteEntryを実行します。

5. 営業見積入力タスクを選択します。
結果: 「ステータス」フィールドでは、3つの値がドロップダウンで表示されます。

6. 「承認保留中」を選択します。

7. 「閉じる」メニューから、「保存して閉じる」アクションを選択します。

8. 同じタスクを再度選択します。
結果: 「ステータス」フィールドでは、3つの値がドロップダウンで表示され、「承認保留中」が選択されています。

5.4.10 ユースケース: 動的参照の構成表示

動的参照の構成には、Oracle WebLogic Serverで構成されたデータソース(/jdbc/IPMDSなど)を指定する必要があります。IPMDSは、インストール時およびホストAXFに必要なIPM_serverドメインの作成時に自動的に構成されます。動的参照がLookupAndValidatorディクショナリでどのように構成されているか、コンテキストのデータまたはTableDataディクショナリでどのように参照されているかを表示するには、次の手順を実行します。

1. 「ルールの管理」で、oracle.axf.solution.hellobpmパッケージのベース・コンテキストを開きます。

2. LookupAndValidatorディクショナリを編集します。

3. 「ルールセット」で、DynamicLookupを選択します。
DynamicLookupの各エントリでは、データソースとして/jdbc/IPMDSを使用します。lookupIdのエントリを確認し、AccountNameに設定します。サンプル・アカウント表を問い合せます。これにより、アカウント名のリストを返します。

4. LookupAndValidatorディクショナリを閉じ、SalesQuoteEntryコンテキストを選択して、データ・ディクショナリを開きます。データ・ルールセットで、アカウント名のデータ・アイテムを検索し、そのプロパティを表示します。"AccountName"は、LookupIdプロパティに対して指定されています。

5. 「コマンド・ドライバ」ページから、SalesQuoteEntry/StartSalesQuoteEntryを実行します。

6. 営業見積入力タスクを選択します。
結果: 「アカウント名」フィールドは、横にある「検索」アイコン(拡大鏡)とともに表示されます。

7. 「アカウント名」フィールドの横にある「検索」アイコンを選択します。リストからアカウントを選択し、「OK」を選択します。
結果: 「アカウント名」フィールドに選択したアカウント名が移入されます。

8. 「保存して閉じる」タスク・アクションを選択します。

9. 同じタスクを再度選択します。
結果: 「アカウント名」フィールドには、選択したアカウント名が移入されたままであることに注意してください。

5.5 BPMビューの構成

ソリューション・ワークスペースでは、標準BPMビューおよびタスク・リスト機能を使用して、AXFソリューションで制御されたヒューマン・ワークフロー・タスクを表示します。BPM Worklistアプリケーションを使用して、BPMビューを作成し、他のユーザーまたはグループと共有します。『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

列ヘッダーをクリックしてタスクをソートしたり、「検索」フィールドを使用して特定のタスクを検索したりなど、タスク・リストのアクションを実行できます。詳細は、『Oracle Fusion Middleware Oracle WebCenterアプリケーション・アダプタの使用』を参照してください。

5.6 Oracle Fusion Middleware Controlを使用したBPMのAXF管理

システム管理者は、Oracle Fusion Middleware Control (またはEnterprise Manager)を使用して、BPMのAXF機能の特定の側面を管理します。これらのタスクを実行するには、Enterprise Managerにアクセスできるシステム管理者である必要があります。

この項の内容は次のとおりです。

- 第5.6.1項「BPMのAXFライブラリおよびアプリケーションの再デプロイ」

- 第5.6.2項「ビジネス・ルールの変更の一時取消し」

- 第5.6.3項「BPMのAXFテスト環境から本番環境への移行」

Enterprise Managerで、BPMのAXFロギング機能を設定することもできます。第4.1.1項を参照してください。

5.6.1 BPMのAXFライブラリおよびアプリケーションの再デプロイ

BPMのAXFは、アプリケーションおよびライブラリとしてWeblogic Serverにデプロイされます。ソリューション・ワークスペースおよびソリューション・アプリケーションは、IPM管理対象サーバーにデプロイされます。

表5-31では、BPMのAXFによりデプロイされたライブラリおよびアプリケーションについて説明します。デプロイの詳細は、『Oracle Fusion Middleware Oracle WebCenter Contentのインストールと構成』を参照してください。

表5-31 BPMのAXFによりデプロイされたアプリケーションおよびライブラリ

アイテム名

タイプ

WLS管理対象サーバー

説明

axf-solutionWorkspace.ear

アプリケーション

IPM

ソリューション・ワークスペース・アプリケーションが含まれます(ソリューション・アプリケーションを起動するために選択できるタスク・リストを表示します)。

axf-infrastructure.ear

アプリケーション

IPM

インフラストラクチャ・コードが含まれます(ソリューション・メディエータ、コマンド・メディエータ、コマンド、ビジネス・ルール・フレームワーク、ソリューション・ワークスペースADF共有ライブラリ、ソリューション・アプリケーションADF共有ライブラリ、Webサービスおよび他の共通インフラストラクチャ・コードなど)。

axf-common-lib.war

ライブラリ

IPM

他のすべてのアプリケーションおよびライブラリ全体で使用する共通コードが含まれます。一般的な共通コードに加えて、このWARには、システムMBean構成用コード、ソリューション・メディエータ・インタフェース、コマンド・メディエータ・インタフェース、コマンド・インタフェース、ロギングおよび対話管理が含まれます。

5.6.2 ビジネス・ルールの変更の一時取消し

トラブルシューティング・ソリューション・アプリケーションの構成時に、ビジネス・ルールの変更の抑止が役立ちます。次に記載するMBeanにより、適用された変更済カスタム・ルールではなく製品ビジネス・ルールで、指定されたソリューション・アプリケーションを実行し、必要に応じて再度変更済ルールを適用できます。

MBean設定

説明

RunAsProduct

trueに設定すると、このMBeanは、RunAsProductSolutionApplicationValue MBeanで指定されたアプリケーションのワークスペース・カスタマイズすべてを無効にし、指定されたAXFアプリケーションを初期のデプロイ状態で実行します。

この設定を、カスタマイズを無効にする(true)または変更済ビジネス・ルールおよびカスタマイズを元に戻す(false)のいずれかに変更します。

RunAsProductSolutionApplicationValue

RunAsProduct MBean設定に応じて、AXFソリューション・アプリケーションを無効または有効に指定します。この値は、コンソール・デプロイメントで検索されるソリューション・デプロイメント名です。HelloBPMソリューションでは、これはaxf-solutionApplication-HelloBPMです。

別のソリューション・アプリケーションでのカスタマイズを無効にするにはこの設定を変更します。

RunAsProduct MBeanを変更する手順は次のとおりです。

1. Enterprise ManagerシステムMBeanブラウザで、BPMのAXF MBeanを開きます。

1. Enterprise Managerで、「WebLogicドメイン」を展開します。

2. ベース・ドメインを右クリックし、「システムMBeanブラウザ」を選択します。

3. 「アプリケーション定義のMBean」で、oracle.ecm.axf、IPMサーバーエントリの順に展開し、config MBeanを表示します。

2. 必要に応じて、RunAsProductおよびRunAsProductSolutionApplicationValueを変更します。

5.6.3 BPMのAXFテスト環境から本番環境への移行

『Oracle Fusion Middleware管理者ガイド』のテスト環境から本番環境への移行に関する項で示すように、BPMイメージング・ソリューションをテスト環境から本番環境へ移行した後に、次の手順を実行します。これらの手順では、本番環境の外部JNDIを更新し、本番環境との通信がテスト環境にリンクされていないことを確認します。

1. Weblogic Server管理コンソールの左側で、ドメイン構造、「サービス」、「外部JNDIプロバイダ」の順に選択します。

2. テストから本番へのプロセスの一部としてコピーされたForeignJNDIProvider-SOAという名前の「外部JNDIプロバイダ」をクリックします。

3. 「プロバイダURL」フィールドを更新し、本番のOracle SOA Suiteを指定します。

4. 「ユーザー」および「パスワード」フィールドを更新し、本番環境に適用します。

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

6 BPELイメージング・ソリューションの構成

この章では、Credential Store Framework (CSF)別名を使用したBPEL接続の構成、AXF表の構成およびソリューション・アクセラレータの使用など、イメージング・ソリューションのコンポーネントとオプションを構成する方法を説明します。また、クラスタ化および代替認証とログインなどのオプションについても説明します。

この章の内容は、次のとおりです。

- 第6.1項「BPEL接続の構成」

- 第6.2項「AXF表の構成またはソリューション・アクセラレータの適用」

- 第6.3項「AXFドライバ・ページの使用による機能のテスト」

- 第6.4項「イメージング・ソリューションのオプションの構成」

注意:

Oracle E-Business Suite Oracle Application Framework (OAF)アプリケーションからイメージング・ソリューションへのアクセスを提供できます。詳細は、第2.3.3項を参照してください。

注意:

「タスク・リスト」でユーザーに表示されるプロファイルおよび「タスク・ビューア」でユーザーに表示されるタスク・アクションとメタデータの変更など、イメージング・ソリューションへの特定の変更を行うには、イメージング・ソリューション・エディタを使用します。ソリューション・エディタの詳細は、Oracle Fusion Middleware Oracle WebCenter Content: Imagingの管理のソリューション・エディタ・ページに関する説明を参照してください。

6.1 BPEL接続の構成

AXFソリューションによる使用のためのBPEL接続の構成には、次のタスクが含まれます。

- 第6.1.1項「CSF資格証明別名の作成」

- 第6.1.2項「Imaging接続での接続の作成」

- 第6.1.3項「AXF_SOLUTION_ATTRIBUTES表での接続の参照」

6.1.1 CSF資格証明別名の作成

Credential Store Framework (CSF)により、Imaging接続構成で使用するためのユーザー名/パスワードの別名を作成できます。CSF別名では、ユーザー名とパスワードのかわりにキーを提供し、Imaging接続の作成においてこのキーを使用します。(複数のImaging接続に対して1つのCSFキーを使用できます。)

キーおよび別名の作成の詳細は、Oracle Fusion Middleware管理者ガイドを参照してください。

注意:

MS LDAPをユーザー・リポジトリとして使用してAXFソリューションを実装している場合、資格証明ユーザーは、ビルトインCNのMS LDAP内の管理者グループに属する管理者である必要があります。AXFでは、特定のセルの作成時(SOAからタスク・リストを取得するときなど)に、この資格証明ユーザーを使用します。さらに、CN=Builtinをインポートするために、グループ・ベースDN (WLSコンソール使用、プロバイダ固有)を構成する必要があります。

6.1.2 Imaging接続での接続の作成

次の手順に従って、接続を作成し、CSF別名キー、BPELサーバー名およびポートを指定します。

1. 管理者としてImagingシステムにログインします。

2. BPEL接続を作成するために、サイド・ペインの「接続の管理」から、+ (プラス)記号のドキュメント・アイコンをクリックします。

3. 接続の名前を入力し、「次」をクリックします。
この名前は、接続を確立するためにAXF_SOLUTION_ATTRIBUTES表で参照されます。

4. BPEL設定の手順で、BPEL接続設定を入力します。

- HTTPフロントエンド・アドレス: http://hostname:BPEL server port

- 資格証明別名(前に作成済、第6.1.1項で説明)

- プロバイダ: t3://hostname:BPEL server port

たとえば、次のようになります。

- HTTPフロントエンド・アドレス: http://hostname:port

- 資格証明別名: axf.credential

- プロバイダ: t3://hostname:port

5. 「次」をクリックし、「送信」をクリックします。

6.1.3 AXF_SOLUTION_ATTRIBUTES表での接続の参照

この手順に従って、第6.1.2項で説明したように、AXFソリューションへのImaging接続を識別します。SQL Developer (または、イメージング・データベース・スキーマに接続できるその他の適切なツール)からコマンドを実行します。

注意:

実装アクセラレータを使用している場合(HelloBPELソリューションを含む)、この手順は必要ありません。

1. 次で指定した構成行を実行します。

Insert into AXF_SOLUTION_ATTRIBUTES (SOLUTION_NAMESPACE,PARAMETER_KEY,PARAMETER_VALUE) values \ ('InvoiceProcessing','BPEL_CONNECTION','axfconnection');

6.2 AXF表の構成またはソリューション・アクセラレータの適用

イメージング・ソリューションのインストールおよび構成が完了した後で、実装のために次のいずれかの手順を完了します。

- AXF表およびAXF関連のOracle E-Business Suite表またはOracle PeopleSoft表を構成します。表の説明および例の実装は、付録B「BPELイメージング・ソリューション・リファレンス」で提供されます。
または

- ソリューション実装アクセラレータを適用します。アクセラレータを入手するには、システム・インテグレータ、Oracle ConsultingまたはOracleサポートに連絡してください。

6.3 AXFドライバ・ページの使用による機能のテスト

AXF Webアプリケーションのドライバ・ページにアクセスして機能を検証します。ドライバ・ページの詳細は、『Oracle Fusion Middleware Oracle WebCenter Contentのインストールと構成』のHelloWorldを使用したAXFインストールの検証に関する項を参照してください。

6.4 イメージング・ソリューションのオプションの構成

この項では、イメージング・ソリューションのための次のオプションの構成について説明します。

- 第6.4.1項「Imagingビューアの自動ログインの構成」

- 第6.4.2項「Oracle WebLogic Server/ビジネス・アプリケーション・ユーザーへのタスクの実行の許可」

- 第6.4.3項「Imaging管理対象サーバーにおけるAXFのためのクラスタ化の構成」

- 第6.4.4項「自動タスク・ロックの構成」

- 第6.4.5項「XPATHの使用によるタスク・ペイロードの更新」

- 第6.4.6項「複数のウィンドウ・インスタンスの表示による単一の対話のターゲット設定」

- 第6.4.7項「検証の追加」

- 第6.4.8項「カスタム・コマンドのデプロイ」

- 第6.4.9項「連鎖コマンドとユーザー・インタフェース・コンポーネントの構成」

- 第6.4.10項「動的データ表の構成または無効化」

- 第6.4.11項「紙クリップ添付ファイルの再有効化(Oracle E-Business SuiteおよびImagingのみ)」

- 第6.4.12項「Oracle PeopleSoftポップアップ・ソリューション・ウィンドウのサイズ変更」

6.4.1 Imagingビューアの自動ログインの構成

セッションごとに始めてImagingビューアにアクセスする際にユーザーがImagingにログインする必要がないようにするには、この項の手順に従います。Imagingのホスト名とAXFサーバーのホスト名が一致するように、フロントエンドHTTPホストおよびポートを設定します。

次の手順に従って、フロントエンドHTTPホストとポートを設定します。

1. Oracle WebLogic Server管理コンソールを開きます。

2. ホームページで、環境ヘッダーの下の「サーバー」をクリックします。

3. 「名前」列にリストされるサーバーからイメージング・サーバーをクリックします。

4. 「プロトコル」タブ、「HTTP」タブの順にクリックします。

5. 「フロントエンド・ホスト」フィールドおよび該当するフロントエンド・ポートのフィールドを変更します。(SSLを使用する場合は、「フロントエンドHTTPSポート」フィールドで値を指定します。SSLを使用しない場合は、「フロントエンドHTTPポート」フィールドで値を指定します。)

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

6.4.2 Oracle WebLogic Server/ビジネス・アプリケーション・ユーザーへのタスクの実行の許可

Oracle E-Business SuiteやOracle PeopleSoftから渡されたユーザーではなく、認証Oracle WebLogic Serverユーザーに、BPELタスクなどのタスクの実行を許可できます。このため、Oracle E-Business Suite/Oracle PeopleSoftとOracle WebLogic Serverについて別のユーザーを保存できます。

関連するAXF_SOLUTION_ATTRIBUTES表の構成を、表6-1に示します。B.1.2項も参照してください。

表6-1 AXF_SOLUTION_ATTRIBUTES表、USERNAME_PASS_THROUGH構成

SOLUTION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

AXF

USERNAME_PASS_THROUGH

TRUEまたはFALSE

説明:

- TRUE (デフォルト): Oracle E-Business SuiteまたはOracle PeopleSoftから渡されたユーザーを使用してタスクを実行します。

- FALSE: 認証Oracle WebLogic Serverユーザーを使用してタスクを実行します。

注意:

Managed Attachments構成については、USERNAME_PASS_THROUGHパラメータをTRUEに設定しておく必要があります。管理対象添付ファイルのためのAXF_ATTACHMENTS_CONFIG.SQLスクリプト(第7.2.1項で説明)では、この値はTRUEに設定されます、値が指定されない場合、この値はデフォルトでTRUEに設定されます。第7.6.19項も参照してください。

注意:

データベースでUSERNAME_PASS_THROUGHの値を変更した後は、Oracle WebLogic Server管理コンソールでImagingアプリケーションを停止し、再起動してください。

6.4.3 Imaging管理対象サーバーにおけるAXFのためのクラスタ化の構成

クラスタで稼働するImaging管理対象サーバーのOracle Application Extension Framework (AXF)は、Java Object Cache (JOC)を構成してすべての管理対象サーバーに配布する必要があります。『Oracle Fusion Middleware Oracle WebCenter Contentのインストールと構成』の分散イメージング管理対象サーバーでのAXF用のJavaオブジェクト・キャッシュの構成に関する説明を参照してください。

6.4.4 自動タスク・ロックの構成

複数の同時ユーザーによるAXF構成では、エンド・ユーザーが自動タスク・モードでタスクの取得を試みたときに衝突が発生する可能性があります。(自動タスク・モードの詳細は、B.3.2項を参照してください。)衝突を避けるには、AXFデータベースで、名前付きBPEL接続ごとに自動タスク・ロックを有効化します。ロックが有効な場合は、1人のユーザーのみが、指定された時間に自動的にタスクを取得する可能性があります。

ロック機能の有効化は、2人のユーザーが同時にタスクを取得したときにエラーが「タスク・リスト」に表示されるのを防ぐため、お薦めの設定です。同時取得が起こる可能性が低い状況では、ロック機能を無効化するとパフォーマンスが向上する可能性があります。

設定は、次の行を挿入することで、AXF_SOLUTION_ATTRIBUTES表で構成されます。

SOLUTION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

BPEL.default

USE_AUTOTASK_LOCKING

TRUE

6.4.5 XPATHの使用によるタスク・ペイロードの更新

B.3.7項で説明しているように、Update Task From Procedureコマンドは、指定したデータソースを使用してストアドPL/SQLプロシージャをコールし、XPATHを使用してタスク・ペイロードを更新します。

6.4.5.1 タスク・ペイロードを更新するPL/SQLプロシージャの例

XMLのDOMへのロード後のPL/SQLプロシージャにより、請求書IDを取得し、そのトランザクションの請求金額を問い合せ、その金額に基づいて一連のユーザーを返します。

この例を使用するには、このプロシージャを変更して、選択したペイロードからデータの特定部分を取得できるようにします。作成するPL/SQLファンクションの唯一の要件として、VARCHAR2を取り、2つのVARCHAR2 OUTパラメータを設定し、INTEGERを返すことが必要です。ファンクションの名前はAXF構成に含めます。

create or replace FUNCTION axfretrieveuserlist(xmlPayload IN VARCHAR2, pDataString OUT VARCHAR2, pMsgString OUT VARCHAR2) RETURN INTEGER IS

v_node    xmldom.DOMNode;
v_node2   xmldom.DOMNode;
v_nl      xmldom.DOMNodeList;
v_doc     xmldom.DOMDocument;
v_elem    xmldom.DOMElement;
v_parser  xmlparser.Parser;
invoiceID     VARCHAR2(256);
invoiceAmount NUMBER(8,2);
userList      VARCHAR2(256);
rtnCode      INTEGER;

BEGIN

rtnCode := 0;  -- execute CMD_NO_DATA
-- rtnCode := -1; -- execute CMD_ERROR
pmsgstring := ''; -- empty msg string (task is updated with this value)
v_parser := xmlparser.newParser;
xmlparser.parseBuffer(v_parser, xmlPayload);
v_doc := xmlparser.getDocument(v_parser);
xmlparser.freeParser(v_parser);

-- Retrieve the invoice ID
v_nl := xmldom.getElementsByTagName(v_doc, 'invoiceID');
v_node := xmldom.item(v_nl, 0);
v_node2 := xmldom.getFirstChild(v_node);
invoiceID := xmldom.getNodeValue(v_node2);

-- Retrieve Invoice Amount for given invoice id
select INVOICE_AMOUNT into invoiceAmount from ap_invoices_all where INVOICE_ID = invoiceid;

if invoiceamount > 10000 then
pdatastring := 'jlondon';
rtnCode := 1;  -- execute CMD_DATA
else
pdatastring := 'jcooper,mtwain';
rtnCode := 1;  -- execute CMD_DATA
pmsgstring := '';
end if;

RETURN rtnCode;

END;

6.4.6 複数のウィンドウ・インスタンスの表示による単一の対話のターゲット設定

特定のOracle E-Business Suiteウィンドウの複数のインスタンスが表示される場合に、Oracle E-Business Suiteアダプタを構成して、同じインスタンス/対話をターゲット設定できます。この機能を使用可能にするには、AXF_PROPERTIES表(Oracle E-Business Suite)でAXF_MULTINSTANCEパラメータを使用します。

- AXF_MULTINSTANCEがTRUEに設定されている場合、各Oracle E-Business Suiteウィンドウは個別の対話、および個別のImagingとして扱われるか、AXFウィンドウがターゲット設定されます。

- AXF_MULTINSTANCEがFALSEに設定されている場合(デフォルト)、各Oracle E-Business Suiteインスタンスのウィンドウは同一の対話として扱われ、同じImagingまたはAXFターゲット・ウィンドウを使用します。

6.4.7 検証の追加

B.3.9項で説明しているように、Validate Taskコマンドは、BPELシステム属性またはBPELペイロード・データを検証し、検証結果に基づいて、後続のコマンドを実行します。

次の例および対応する手順では、タスクの完了を許可する前にトランザクションIDが存在することを確認する検証を追加します。この例では、請求書処理ソリューション実装アクセラレータ・データをインストールしてあると仮定します。

注意:

タスクを完了する前にビジネス・アプリケーションの請求書を作成する必要がある使用事例でのみ、この構成変更を適用します。タスクを完了する前に請求書を作成しない可能性がある使用事例(たとえば、一般的には、仕入先の保守の結果によってタスクが完了されている場合)では、この構成は当てはまりません。

1. AXF_COMMANDS表に次の行を追加します。

表6-2 AXF_COMMANDS表の例

SOLUTION_NAMESPACE

COMMAND_CLASS

COMMAND_NAMESPACE

InvoiceProcessing

oracle.imaging.axf.commands.bpel.ValidateTaskCommand

ValidateTransactionID

2. 表6-3で示されている行をAXF_SOLUTION_PARAMETERS表に追加します。
次の構成は、請求書が保存されている(請求書トランザクションIDが0でない)ことを検証します。0の場合、コマンドは、FAIL_MESSAGEパラメータで指定されたエラー・メッセージを報告します。

Fields not shown: SOLUTION_NAMESPACE=InvoiceProcessing

表6-3 AXF_SOLUTION_PARAMETERS表のValidateTaskコマンドの例

COMMAND_NAMESPACE

CONFIGURATION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

ValidateTransactionID

oracle.imaging.axf.commands.bpel.ValidateTaskCommand

ATTRIBUTE_TO_VALIDATE

XPATH:InvoiceProcessing_TransactionID

ValidateTransactionID

oracle.imaging.axf.commands.bpel.ValidateTaskCommand

CMD_ON_PASS

CompleteInvoice

ValidateTransactionID

oracle.imaging.axf.commands.bpel.ValidateTaskCommand

REGULAR_EXPRESSION

[^0]

ValidateTransactionID

oracle.imaging.axf.commands.bpel.ValidateTaskCommand

FAIL_MESSAGE

Please save the transaction before completing the task.

3. AXF_ACTIONS表で、CompleteアクションのCOMMAND_NAMESPACE列をValidateTransactionIDのコマンド・ネームスペースと置き換えて、Complete Taskが構成される行を編集します。

表6-4 AXF_ACTIONS表

ACTION_ID

VIEW_ID

DISPLAY_NAME

COMMAND_NAMESPACE

MENU_ORDER

CompleteInvoice

/TaskViewer.jspx

Complete Invoice

ValidateTransactionID

3

6.4.8 カスタム・コマンドのデプロイ

AXFインフラストラクチャ内で作業するためにカスタム・コマンドをデプロイすることもできます。カスタム・コマンドは、oracle.imaging.axf.commands.AxfCommandインタフェースを実装する必要があります。インフラストラクチャによって実行(AxfRequest)メソッドが呼び出されます。AXF構成データベース内で実行するように実装を構成します。

また、コマンドは、oracle.imaging.axf.commands.ValidatableCommandインタフェースを実装する場合があります。これは、AXFインフラストラクチャが、構成およびコマンドの動作を、システム・コマンド・ステータスを提供するために実行することなく検証するための方法を提供します。

6.4.9 連鎖コマンドとユーザー・インタフェース・コンポーネントの構成

一部のAXFコマンドには、コマンドの完了後に起こることを指定して、それらの連鎖を可能にする、パラメータ・キーがあります。たとえば、表6-5は、AXF_SOLUTION_PARAMETERS表の一部を示しています。CompleteTaskコマンドを実行したら、追加のAXFコマンドが実行されます(プログラム・ロジックに基づいて、StartInvoiceProcessingおよびAutoOpenTask)。

表6-5 CompleteTaskコマンドのためのAXF_SOLUTION_PARAMETERS表の例(InvoiceProcessingソリューション)

COMMAND_NAMESPACE

CONFIGURATION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

DuplicateInvoice

oracle.imaging.axf.commands.bpel.CompleteTaskCommand

CMD_AUTOTASK_OFF

StartInvoiceProcessing

DuplicateInvoice

oracle.imaging.axf.commands.bpel.CompleteTaskCommand

CMD_AUTOTASK_ON

AutoOpenTask

DuplicateInvoice

oracle.imaging.axf.commands.bpel.CompleteTaskCommand

OUTCOME

DUPLICATE_INVOICE

6.4.10 動的データ表の構成または無効化

「タスク・ビューア」で、BPELペイロードXMLからの動的データの表を表示できます(図1-4の下部のタブで示されている請求書処理ソリューションのためのGeneral Ledgerなど)。AXF_METADATA_BLOCKS表内の表およびAXF_METADATA_ATTRIBUTES表内のそのデータ行を構成します。BPELペイロードにおけるXMLデータの書式設定の詳細は、第6.4.10.1項を参照してください。また、B.2.3項も参照してください。

表6-6の下部の行では、構成されたGL Linesと呼ばれる動的データ表の例を示します。

表6-6 AXF_METADATA_BLOCKS表の例

BLOCK_ID

BLOCK_LOCATION

LABEL

DISPLAY_ORDER

TASK_FLOW_ID

SOLUTION_NAMESPACE

BLOCK_TYPE

METADATA_STYLE

1

LEFT_SIDEBAR

Summary

1

axf-taskviewer-tfd

InvoiceProcessing

METADATA

null

2

LEFT_SIDEBAR

Comments

2

axf-taskviewer-tfd

InvoiceProcessing

COMMENT

null

3

BOTTOM_PANEL

GL Lines

3

axf-taskviewer-tfd

InvoiceProcessing

METADATA

TABLE

表6-7では、構成された、GL Lines表のデータ行を示します。この例は、表内の3つのデータ列となります。XPATH属性がAXF_XPATH_ATTRIBUTES表内に存在すると仮定します。

表示されないフィールドには、DATA_TYPE=Stringが含まれます。

表6-7 動的データ表のためのAXF_METADATA_ATTRIBUTES表の例

BLOCK_ID

ATTRIBUTE_ID

LABEL

ATTRIBUTE_KEY

IS_XPATH

DISPLAY_ORDER

2

8

Line Number

DistributionLines_LineNumber

TRUE

0

2

9

Dist Account

DistributionLines_DistributionAccount

TRUE

1

2

10

Amount

DistributionLines_Amount

TRUE

2

6.4.10.1 動的データ表のためのXMLデータの書式設定

AXF_METADATA_BLOCKS表に表を追加して、AXF_METADATA_ATTRIBUTES表でそのデータ行を構成したら、次のガイドラインに従って、BPELペイロード内のXMLデータが表での表示のために正しく書式設定されていることを確認します。

XMLペイロード内の任意のレベルで表示するためのXMLのサンプルを次に示します。First column XPATHは、親およびそのピア要素(collectionItem)を取得します。構成された各XPATHは、各collectionItemから表のためのセル値を取得するために使用されるitemValue要素を指します。

注意:

すべての列は、同じ直接の親要素内に表示される必要があります。

<rootElement>
<collectionContainerElement>
<collectionItem>                                        <--First row for table
<itemValue1>value1</itemValue1>                       <--First column XPATH
<itemValue2>value2</itemValue2>
<itemValue3>value3</itemValue3>
</collectionItem>
<collectionItem>                                        <--Second row
<itemValue1>value1</itemValue1>
<itemValue2>value2</itemValue2>
<itemValue3>value3</itemValue3>
</collectionItem>
<collectionItem>
<itemValue1>value1</itemValue1>
<itemValue2>value2</itemValue2>
<itemValue3>value3</itemValue3>
</collectionItem>
</collectionContainerElement>
</rootElement>

前のXMLのためのfirst column XPATHは、次のようになる必要があります。

/task:payload/task:rootElement/collectionContainerElement/collectionItem/itemValue1

6.4.10.2 「タスク・ビューア」の「下部パネル」の非表示

使用中のイメージ化ソリューションでタスク・ビューアの下部パネルを使用していない場合、AXFソリューションでは無効化することができます。たとえば、請求書処理のソリューションでは、General Ledger行を表示する下部パネルを非表示にするとします。パネルを非表示にすると、パフォーマンスの速度が上がり、ページ領域を節約できます。

下部パネルを非表示にするには、次のステップを実行します。

1. Oracle SQL Developerなどのツールを使用し、AXFデータベースへの接続をオープンします。

2. 次の問合せを実行し、BLOCK_IDが下部パネルに使用されていることを確認します。
SELECT BLOCK_ID FROM AXF_METADATA_BLOCKS WHERE BLOCK_LOCATION = 'BOTTOM_PANEL'

3. 次のコマンドを実行してAXF_METADATA_ATTRIBUTES表から行を削除し、BLOCK_IDをステップ2で識別したIDと置換します。
DELETE FROM AXF_METADATA_ATTRIBUTES where BLOCK_ID = BLOCK_ID;insert BLOCK_ID from previous step;

4. 次のコマンドを実行し、AXF_METADATA_BLOCKS表から行を削除します。
DELETE FROM AXF_METADATA_BLOCKS WHERE BLOCK_LOCATION = 'BOTTOM_PANEL'

5. ドライバ・ページの「構成キャッシュのクリア」ボタンをクリックします。

6.4.11 紙クリップ添付ファイルの再有効化(Oracle E-Business SuiteおよびImagingのみ)

管理対象添付ファイル・ソリューションをインストールして構成すると、Oracle E-Business Suite添付の紙クリップ・アイコンおよび機能が自動的に無効化されます。イメージング・ソリューションの紙クリップ機能を再度有効化するには、次の手順を行って管理対象添付ファイル・ソリューションを無効化します。

注意:

この項は、Oracle E-Business Suiteを使用する場合のみ適用されます。

1. AXF_CONFIGS表(Oracle E-Business Suite)表を開きます。

2. FORMFUNCTIONフィールドでAXF_MANAGED_ATTACHMENTSエントリの名前を変更します。詳細は、B.4.2.2項を参照してください。
たとえば、エントリ名を次のように変更します。

AXF_MANAGED_ATTACHMENTS-DISABLED

注意:

管理対象添付ファイル・ソリューションを再度有効化するには、FORMFUNCTIONフィールドを変更して次のエントリに戻してください。

AXF_MANAGED_ATTACHMENTS

3. AXF_PROPERTIES表内のAXF_PAPERCLIPプロパティがTRUEに設定されていることを確認します。詳細は、第B.4.5項を参照してください。

表6-8 紙クリップの使用のためのAXF_PROPERTIES値

PROPNAME

PROPVALUE

AXF_PAPERCLIP

紙クリップ・オプションを有効にするにはTRUEに設定し、無効にするにはFALSEに設定します。(値は大文字である必要があります。)

6.4.12 Oracle PeopleSoftポップアップ・ソリューション・ウィンドウのサイズ変更

ソリューションの一部として表示されるすべてのOracle PeopleSoftポップアップ・ウィンドウのシステム全体のデフォルト・サイズを変更できます。次の点に注意してください。

- デフォルトのポップアップ・ウィンドウ・サイズは高さ600ピクセル、幅800ピクセルです。PS_AXF_PROPERTIES表で設定します。この表でサイズが設定された場合、ユーザーはポップアップ・ウィンドウ・サイズを自分で設定および保存することはできません。

- ウィンドウ・サイズを変更するには、B.5.5項で示されているように、表に新しい値を入力します。

- ポップアップ・ウィンドウ・サイズを削除するには(および、個々のユーザーに、標準のブラウザ・コントロールの使用によるポップアップ・ウィンドウ・サイズの変更と保存を可能にするには)、PS_AXF_PROPERTIES表からWINDOW_HEIGHT行とWINDOW_WIDTH行を削除します。

7 管理対象添付ファイル・ソリューションの構成

この章では、Oracle E-Business Suite、Oracle PeopleSoftまたは別のビジネス・アプリケーションのための管理対象添付ファイル・ソリューションを構成する方法を説明します。構成スクリプトを実行し、コンテンツ・サーバー・コンポーネントを構成し、ソリューションをカスタマイズし、Oracle AutoVueとOracle WebCenter Captureを統合し、認証とセキュリティを構成する方法を説明します。

注意:

管理対象添付ファイル・ソリューションのバックグラウンドの情報については、第1.4項を参照してください。

この章の内容は、次のとおりです。

- 第7.1項「管理対象添付ファイル・ソリューションのシステム要件」

- 第7.2項「管理対象添付ファイルを使用可能にするための構成スクリプトの実行」

- 第7.3項「コンテンツ・サーバー・コンポーネントの構成」

- 第7.4項「Enterprise Application Adapter Frameworkの構成」

- 第7.5項「管理対象添付ファイルの設定の構成」

- 第7.6項「管理対象添付ファイル・ソリューションのカスタマイズ」

- 第7.7項「認証およびセキュリティの構成」

- 第7.8項「Oracle AutoVue Document Viewingの構成」

- 第7.9項「Oracle WebCenter Captureの構成」

- 第7.10項「Oracle Distributed Document Captureの構成」

- 第7.11項「管理対象添付ファイル・ソリューションのテスト」

- 第7.12項「コンテンツ・サーバーのロギングの構成」

- 第7.13項「コンテンツ・サーバー上のアダプタ・コンポーネントのアンインストール」

7.1 管理対象添付ファイル・ソリューションのシステム要件

第1.7項でリストした他のすべての要件に加えて、管理対象添付ファイル・ソリューションには追加の要件があります。管理対象添付ファイルの一般的な要件は、この項でリストします。また、ブラウザなど、サポートされている構成および動作保証情報は、以下で入手可能です。

http://www.oracle.com/technetwork/middleware/webcenter/content/documentation/documentation-155348.html

Oracle WebCenter Content: Imaging 11gリリース1 (11.1.1以上)

管理対象添付ファイル・ソリューションの構成のみの場合であっても、Imaging 11gのインストールが必要です。これは、AXFがImagingデプロイメントの一部であるためです。

注意:

管理対象添付ファイル・ソリューションは、コンテンツ・サーバーがWebSphere Application Serverで実行されていて、Application Extension Framework(イメージング・サーバー)がOracle WebLogic Serverで実行されている場合に、WebSphere Application Serverでサポートされます。

Oracle WebCenter Content Server 11gリリース1 (11.1.1以上)

管理対象添付ファイル・ソリューションは、コンテンツ・サーバーの次の検索エンジンをサポートしています。

- メタデータのみ検索

- データベース – 全文検索

- Oracleテキスト – 全文検索

注意:

Folders_gコンポーネントにより、デフォルトでAuthorDelete=trueと呼ばれる変数が設定され、この変数により、ユーザーはセキュリティ・グループの権限を削除せずに、自身が権限を持つドキュメントを削除できます。Folders_gコンテンツ・サーバー・コンポーネントを管理対象添付ファイル・ソリューションで使用する場合は、この変数設定が管理対象添付ファイルのdPrivilegeまたはAppAdapterGrantPrivilege削除設定をオーバーライドすることがある点に注意してください。

Oracle E-Business Suite

- Oracle E-Business Suiteフォーム・ベース・エンティティがある管理対象添付ファイルの場合、管理対象添付ファイルは、EBS FND添付ファイル・フレームワークが特定のエンティティのために構成されている必要があります。管理対象添付ファイルはFND添付ファイルの代替の添付ファイル・フレームワークですが、管理対象添付ファイルは、基盤となるFND添付ファイル・インフラストラクチャを活用します。

- Oracle E-Business OAFベース・エンティティがある管理対象添付ファイルの場合、管理対象添付ファイルは、エンティティに関連付けられているOAFページに、「このページの情報」リンクとともに「ページのパーソナライズ」オプションがある必要があります。 OAFページは、「管理対象添付ファイル」ボタンを手動で追加できるように、サイト・レベルのパーソナライズをサポートしている必要があります。「このページの情報」リンクは、主キーなど、OAFエンティティの詳細を取得します。このオプションのないOAFベースのページは、管理対象添付ファイルではサポートされていません。

7.2 管理対象添付ファイルを使用可能にするための構成スクリプトの実行

この項では、次の項で説明されている手順に従って、表7-1でリストされている構成スクリプトの実行について説明します。最初のスクリプトは、AXF要素を構成します。また、Enterprise Application Adapter Frameworkを含む、すべての管理対象添付ファイルの構成のために必要です。残りのスクリプトは、表7-1で示されているように、特定のビジネス・アプリケーションに適用されます。

- 第7.2.1項「管理対象添付ファイルのためのAXF要素の構成」

- 第7.2.2項「Oracle E-Business Suite Formsアプリケーションのための管理対象添付ファイルの有効化」

- 第7.2.3項「Oracle E-Business Suite OAFアプリケーションのための管理対象添付ファイルの有効化」

- 第7.2.4項「Oracle PeopleSoftのための管理対象添付ファイルの有効化」

表7-1 管理対象添付ファイルを構成するためのSQLスクリプト

SQLスクリプト

適用先

説明

AXF_ATTACHMENTS_CONFIG.sql

- Oracle E-Business Suite Forms

- Oracle E-Business Suite OAF

- Oracle PeopleSoft

- Enterprise Application Adapter Framework (第7.4項を参照)

ソリューションやコマンドなど、AXF要素を構成するAXFスクリプト。第7.2.1項を参照してください。

Imagingスキーマを所有するユーザーとして、Oracle WebCenter Content中間層でこのスクリプトを実行します。

AXF_EBS_ATTACHMENTS_CONFIG.sql

Oracle E-Business Suite Formsのみ

Oracle E-Business Suite Formsアプリケーション内の「ズーム」メニューを介した管理対象添付ファイルへのアクセスのためにAXFによって使用される、Oracle E-Business Suite Form表を移入します。第7.2.2項を参照してください。

Oracle E-Business Suiteプラグイン・スキーマ・ユーザー(AXF)としてこのスクリプトを実行します。

OAF_AXF_EBS_ATTACHMENTS_CONFIG.sql

Oracle E-Business Suite OAFのみ

管理対象添付ファイルへのアクセスのためにAXFによって使用されるOracle E-Business Suite OAF表を移入する、サンプル・スクリプトを提供します。第7.2.3項を参照してください。

Oracle E-Business Suiteプラグイン・スキーマ・ユーザー(AXF)としてこのスクリプトを実行します。

AXF_PSFT_ATTACHMENTS_CONFIG.sql

Oracle PeopleSoftのみ

管理対象添付ファイルへのアクセスのためにAXFによって使用されるPeopleSoft表を移入する、サンプル・スクリプトを提供します。第7.2.4項を参照してください。

管理者権限のあるOracle PeopleSoftユーザーとして、このスクリプトを実行します。

7.2.1 管理対象添付ファイルのためのAXF要素の構成

次の手順に従って、AXF_ATTACHMENTS_CONFIG.sql(ソリューションやコマンドなど、AXF要素を構成するAXFスクリプト)を実行します。このスクリプトは、すべてのビジネス・アプリケーションの管理対象添付ファイルのために必要です。

1. Fusion Middlewareホームで、ビジネス・アプリケーションのために、次で指定されたフォルダ内にスクリプトを配置します。

- Oracle E-Business Suite Formsの場合:
MW_HOME/ECM_HOME/axf/adapters/ebs/R11/

MW_HOME/ECM_HOME/axf/adapters/ebs/R12/

- Oracle E-Business Suite OAFの場合:
MW_HOME/ECM_HOME/axf/adapters/ebs/oaf/

- Oracle PeopleSoftの場合:
MW_HOME/ECM_HOME/axf/adapters/psft/

- Enterprise Application Adapter Frameworkの場合:
MW_HOME/ECM_HOME/axf/adapters/framework/

2. 現在の環境と一致するようにAXF_ATTACHMENTS_CONFIG.sqlスクリプト内のパラメータを変更します。

1. コンテンツ・サーバーのインストールと一致するようにRIDC_CONNECTION_STRパラメータのためのシステム名とポートを変更します。ポート番号は、RIDCコールを取得するコンテンツ・サーバーのIntradocサーバー・ポートのポート番号に対応している必要があります。(コンテンツ・サーバー・ポートのための値を見つけるには、config.cfg内のIntradocServerPort構成値を探します。)

2. コンテンツ・サーバーのインストールと一致するようにUCM_CONNECTION_STRパラメータのためのシステム名とポートを変更します。ポート番号は、コンテンツ・サーバーのWebサーバー・ポートのポート番号に対応している必要があります。

3. 構成のために、UCM_CONNECTION_STRパラメータ内の[Content ServerProfile]値および[ResultTemplate]値を変更します。これらの値は、C.1.4項で説明されているように、コンテンツ・サーバーの添付ファイル・フレームワーク検索を呼び出す管理対象添付ファイルURLで使用されます。

- プロファイル値に含まれている値: EBSProfile (デフォルト)、PSFTProfileおよびUniversalProfile (Enterprise Application Adapter Framework用)。プロファイルのカスタマイズの詳細は、第7.6.5項を参照してください。

- 結果テンプレート値に含まれている値: EBS_LIST (adapter_list_results_template.htm)、PSFT_LIST (ps_adapter_list_results_template.htm)およびUniversal_LIST (universal_adapter_list_results_template.htm、Enterprise Application Adapter Framework用)。結果テンプレートのカスタマイズの詳細は、第7.6.13項を参照してください。

注意:

BPMインフラストラクチャのためにAXFを使用している場合は、任意のエディタでAXF_ATTACHMENTS_CONFIG.sqlファイルを開きます。.imaging.を.ecm.で置き換え、ファイルを保存します。

3. Oracle WebCenter Content中間層で、Imagingスキーマを所有するユーザーとしてAXF Configuration Databaseにログインし、AXF_ATTACHMENTS_CONFIG.sqlスクリプトを実行します。
スクリプトを実行するには、次のコマンドを入力します。

@AXF_ATTACHMENTS_CONFIG.sql

注意:

Oracle WebCenter Contentのインストールの前または後のスキーマの作成の詳細は、『Oracle Fusion Middleware Oracle WebCenter Contentのインストールと構成』のリポジトリ作成ユーティリティによるOracle WebCenter Contentスキーマの作成に関する項を参照してください。

7.2.2 Oracle E-Business Suite Formsアプリケーションのための管理対象添付ファイルの有効化

Oracle E-Business Suite Formsのためにアダプタを構成している場合は、次の手順に従って、AXF_EBS_ATTACHMENTS_CONFIG.sql (Oracle E-Business Suiteシステム内で管理対象添付ファイル・ソリューションを使用可能にするよう「ズーム」メニューを構成する、Oracle E-Business Suiteプラグイン・スクリプト)を実行します。

1. 次で指定されているフォルダ内に、リリースに対応するスクリプトを配置します。
MW_HOME/ECM_HOME/axf/adapters/ebs/R11/

MW_HOME/ECM_HOME/axf/adapters/ebs/R12/

2. AXF_EBS_ATTACHMENTS_CONFIG.sqlスクリプトで、Imagingサーバーと一致するようにホスト名およびポートを変更します。

3. Oracle E-Business Suiteプラグイン・スキーマ・ユーザー(AXF)としてOracle E-Business Suiteデータベースにログインし、適切なスクリプトを実行します。
スクリプトを実行するには、次のコマンドを入力します。

@AXF_EBS_ATTACHMENTS_CONFIG.sql

4. AXF_FND_MAP表を開き、不要な行を削除します。
C.2.3項を参照してください。スクリプトによって複数の行が挿入され、特定の構成に適用する行を保持できるようになります。

7.2.3 Oracle E-Business Suite OAFアプリケーションのための管理対象添付ファイルの有効化

OAFページの詳細を、コンテンツ・サーバーにチェックインされたドキュメントとリンクさせるには、C.3項で説明されているように、OAFページのビジネス・エンティティおよび主キーの値を、Oracle E-Business Suite OAF AXFデータベース表に格納する必要があります。この構成には、次の手順が含まれています。

- OAF_AXF_EBS_ATTACHMENTS_CONFIG.sqlスクリプト(第7.2.3.1項で説明されているように、特定のサンプルOAFページのための値がある表を移入する)を使用してデータベースを移入します。

- 第7.2.3.2項で識別する値を使用して、OAFページのためのサンプル・キー値を変更します。

7.2.3.1 サンプル・キー値があるOAF AXFデータベース表の移入

表7-2に、指定されたOAFページのためのOAF_AXF_EBS_ATTACHMENTS_CONFIG.sqlスクリプトによって移入された、サンプル・キー値をリストします。

- OAFページの場所は、OAF_AXF_CONFIGS表(Oracle E-Business Suite OAF)でAXF_OAF_PAGE値として使用されます。C.3.1.2項の表の例を参照してください。

- 次のキー値は、OAF_AXF_CMD_PARAMS表(Oracle E-Business Suite OAF)で使用されます。C.3.4.2項の表の例を参照してください。

- エンティティ(businessObjectType)、たとえば、REQ_HEADERS

- 主キー(businessObjectKey1)、たとえば、REQUISITION_HEADER_ID

- ビュー・オブジェクト(businessObjectValue1)、たとえば、ReqHeadersVO

- ビュー属性(businessObjectValue1またはlabelValue1)、たとえば、RequisitionHeaderId

注意:

各OAFフォームに対し、意味をなすbusinessObjectTypeおよびbusinessObjectKey1の値を指定します。値は一意である必要があります。これにより、設定の時間を節約でき、複数のOAFページを同じ添付ファイルに結合できます。

表7-2 サンプルOAF_AXF_EBS_ATTACHMENTS_CONFIG.SQLスクリプトによって構成されたOAFページ

OAFページ

ナビゲーション

サンプル・キー値

iProcurement申込書

iProcurement、申込書タブの順に選択し、申込書の説明をクリックします。

OAFページ = /oracle/apps/icx/por/reqmgmt/webui/ReqDetailsPG

- エンティティ = REQ_HEADERS

- 主キー = REQUISITION_HEADER_ID

- ビュー・オブジェクト = ReqHeadersVO

- ビュー属性 = RequisitionHeaderId

iProcurement発注書

iProcurement、申込書タブの順に選択し、発注番号をクリックします。

OAFページ = /oracle/apps/pos/changeorder/webui/PosViewPOPG

- エンティティ = PO_HEADERS

- 主キー = PO_HEADER_ID

- ビュー・オブジェクト = PosViewHeadersVO

- ビュー属性 = PO_HEADER_ID

発注書

購入、バイヤー作業センター、発注書の順に選択し、発注番号をクリックします。

OAFページ = /oracle/apps/po/document/order/webui/OrderPG

- エンティティ = PO_HEADERS_MERGE_V

- 主キー = PO_HEADER_ID

- ビュー・オブジェクト = PoHeaderMergeVO

- ビュー属性 = PoHeaderId

仕入先

購入、仕入場所、仕入先の順に選択します。「実行」をクリックすることで検索し、「更新」アイコンをクリックします。

OAFページ = /oracle/apps/pos/supplier/webui/QuickUpdatePG

- エンティティ = PO_VENDORS

- 主キー = VENDOR_ID

- ビュー・オブジェクト = SupplierVO

- ビュー属性 = VendorId

見積依頼書(RFQ)ヘッダー

購入、バイヤー作業センター、交渉、RFQ、ヘッダーの順に選択します。

OAFページ = /oracle/apps/pon/negotiation/creation/webui/ponDefineHdrPG

- エンティティ = PON_AUCTION_HEADERS_ALL

- 主キー = AUCTION_HEADER_ID

- ビュー・オブジェクト = AuctionHeadersAllVO

- ビュー属性 = AuctionHeaderId

見積依頼書(RFQ)行

購入、バイヤー作業センター、交渉、RFQ、行の順に選択します。「実行」ボタンをクリックします。

OAFページ = /oracle/apps/pon/negotiation/creation/webui/ponItemHeaderPG

- エンティティ = PON_AUCTION_ITEM_PRICES_ALL

- 主キー = AUCTION_HEADER_ID & LINE_NUMBER

- ビュー・オブジェクト = AuctionItemPricesAllVO

- ビュー属性 = AuctionHeaderId & LineNumber

プロジェクト

「プロジェクト・マネージャ」、プロジェクト: 配信、プロジェクト・リストの順に選択します。プロジェクト名をクリックし、「添付」タブをクリックします。

OAFページ = /oracle/apps/pa/project/webui/ProjAttachmentPG

- エンティティ = PA_PROJECTS

- 主キー = PROJECT_ID

- ビュー・オブジェクト = ProjAttachmentsVO

- ビュー属性 = PROJECT_ID

次の手順に従って、スクリプトを実行します。

1. 次のフォルダにOAF_AXF_EBS_ATTACHMENTS_CONFIG.sqlスクリプトを配置します。
MW_HOME/ECM_HOME/axf/adapters/ebs/oaf/

2. Oracle E-Business Suiteプラグイン・スキーマ・ユーザー(AXF)としてOracle E-Business Suiteデータベースにログインします。

3. スクリプトで、Imagingサーバーのホスト名とポートと一致するようにホスト名とポートを置き換えます。

4. OAF_AXF_EBS_ATTACHMENTS_CONFIG.sqlスクリプトを実行します。
スクリプトを実行するには、次のコマンドを入力します。

@OAF_AXF_EBS_ATTACHMENTS_CONFIG.sql

7.2.3.2 OAFページのためのキー値の識別

この項では、主キーを識別して管理対象添付ファイル機能があるOAFページにリンクするためと、ラベルとして使用するページ名とフィールドを識別するための手順を説明します。

次のシナリオで説明されているように、必要な情報をどのように識別するかは、OAFページの内容によって異なります。

- 第7.2.3.2.1項「添付ファイル情報と主キーの両方が存在する」

- 第7.2.3.2.2項「添付ファイル情報は存在するが主キーはない」

- 第7.2.3.2.3項「添付ファイル情報も主キーも存在しない」

7.2.3.2.1 添付ファイル情報と主キーの両方が存在する

理想的に、必要なOracle E-Business Suite添付ファイルと主キーの詳細がOAFページのXMLファイルに存在します。この場合は、次の手順に従って、必要なマッピング情報を見つけます。

1. OAFページに移動し、下部にある「このページの情報」リンクをクリックします。
たとえば、従業員セルフ・サービス、評価OAFページの順に移動し、「このページの情報」リンクをクリックします。

2. ページのXMLファイルのフルパスをメモしてください。たとえば、次のようになります。

/oracle/apps/per/selfservice/appraisals/webui/EmpMyAppraisalsPG

3. ビューに関連付けられているビジネス・エンティティのためのビュー・オブジェクト名および主キーの詳細を含む、<oa:attachment> XMLタグのためのXMLファイルを検索します。
たとえば、次の<oa:attachment>セクションはこれらのキー値を提供しており、太字で強調表示されています。

<oa:attachmentImage id="EMPInprogressJournal" prompt="Journal" viewName="EmpMyAppraisalsInProgressVO" autoCommitEnabled="true" enableDocumentCatalog="false">
<oa:entityMappings>
<oa:entityMap id="APPRAISEEentityMap" entityId="APPRAISEE_JOURNAL" showAll="false">
<oa:primaryKeys>
<oa:primaryKey id="primaryKey1" viewAttr="AppraisalId"/>
<oa:primaryKey id="primaryKey2" viewAttr="AppraiseePersonId"/>
</oa:primaryKeys>
<oa:categoryMappings>
<oa:categoryMap id="categoryMap1" categoryName="MISC"/>
</oa:categoryMappings>
</oa:entityMap>
</oa:entityMappings>
</oa:attachmentImage>

4. 識別している値をメモしてください。第7.2.3項でそれらを使用して、管理対象添付ファイルのあるOAFページ詳細をマップします。
例では、次の値が見つかりました。

- エンティティ = APPRAISEE_JOURNAL

- 主キー = APPRAISAL_IDおよびAPPRAISEE_PERSON_ID

- ビュー・オブジェクト = EmpMyAppraisalsInProgressVO

- ビュー属性 = AppraisalIdおよびAppraiseePersonId

7.2.3.2.2 添付ファイル情報は存在するが主キーはない

この場合、OAFページのXMLファイルには、添付ファイル・オブジェクト情報(ビュー・オブジェクトおよびエンティティ)が含まれていますが、対応する主キーは含まれていません。次の手順に従って、XMLファイルからビュー・オブジェクトおよびエンティティ名を判別し、FND_DOCUMENT_ENTITIES表を問い合せて主キーを判別します。

1. OAFページに移動し、下部にある「このページの情報」リンクをクリックします。
たとえば、iProcurement、申込書、申込詳細OAFページの順に移動し、「このページの情報」リンクをクリックします。

2. ページのXMLファイルのフルパスをメモしてください。たとえば、次のようになります。

/oracle/apps/icx/por/reqmgmt/webui/ReqDetailsPG

3. APPSスキーマから、FND_DOCUMENT_ENTITIES表に対して次の問合せを実行し、EntityNameをXMLファイル内で識別したエンティティと置き換えます。
SELECT * FROM FND_DOCUMENT_ENTITIES WHERE ENTITY_NAME=EntityName

たとえば、次のxmlファイルの<oa:attachment>セクションは、太字で強調表示された、次のようなキー値を提供します。

<oa:attachmentLink id="Attachment" viewName="ReqHeaderVO" prompt="Attachment">
<oa:entityMappings>
<oa:entityMap entityId="REQ_HEADERS" id="entityMap1" insertAllowed="false" updateAllowed="false" deleteAllowed="false">
<oa:categoryMappings>
<oa:categoryMap categoryName="REQ Internal" id="ReqInternal"/>
<oa:categoryMap categoryName="Approver" id="ToApprover"/>
<oa:categoryMap categoryName="Buyer" id="ToBuyer"/>
<oa:categoryMap categoryName="Receiver" id="ToReceiver"/>
<oa:categoryMap categoryName="Vendor" id="ToSupplier"/>
</oa:categoryMappings>
</oa:entityMap>
</oa:entityMappings>
</oa:attachmentLink>

次のような情報が判明します。

- エンティティ = REQ_HEADERS

- ビュー・オブジェクト = ReqHeaderVO

4. 主キー列に基づいて、その対応するビュー属性を判別します。

1. REQ_HEADERSエンティティのためにFND_DOCUMENT_ENTITIES問合せを実行します。
SELECT * FROM FND_DOCUMENT_ENTITIES WHERE ENTITY_NAME='REQ_HEADERS'

問合せは、主キー列の名前REQ_HEADER_IDを返します。

2. 「このページの情報」リンクをクリックし、「ビュー・オブジェクト」を選択して、列名RequisitionHeaderIdと一致する、対応する属性名を探します。

- 主キー = REQUISITION_HEADER_ID

- ビュー属性 = RequisitionHeaderId

5. 識別している値をメモしてください。第7.2.3項でそれらを使用して、管理対象添付ファイルのあるOAFページ詳細をマップします。
例では、次の値が見つかりました。

- エンティティ = REQ_HEADERS

- 主キー = REQUISITION_HEADER_ID

- ビュー・オブジェクト = ReqHeadersVO

- ビュー属性 = RequisitionHeaderId

7.2.3.2.3 添付ファイル情報も主キーも存在しない

この場合、ページに関連付けられているXMLファイルには、添付ファイル情報は含まれません。次の手順に従って、必要な情報を判別します。

1. OAFページに移動し、下部にある「このページの情報」リンクをクリックします。
たとえば、購入、バイヤー作業センター、発注書の順に移動し、発注番号をクリックします。「このページの情報」リンクをクリックします。

ページのXMLファイルのフルパスをメモしてください。たとえば、次のようになります。

/oracle/apps/po/document/order/webui/OrderPG

ページのXMLファイルには、Oracle E-Business Suiteの添付ファイル情報は含まれません。

2. 「ページ定義」を選択し、「すべて開く」リンクをクリックします。

3. ビュー・オブジェクトを判別します。
「ビュー・オブジェクト」列で、最も多くリストされているビュー・オブジェクトを見つけます。最上位のリージョンで使用されているビュー・オブジェクトは、ページのための駆動ビュー・オブジェクトです。図7-1で示されている例では、ビュー・オブジェクトはPoHeaderMergeVOです。

図7-1 ビュー・オブジェクトの判別

4. エンティティ(駆動表)を判別します。
ビュー・オブジェクト・リンクをクリックして、ビュー・オブジェクトのための詳細を表示します。たとえば、PoHeaderMergerVOビュー・オブジェクトのためのエンティティ(駆動表)は、PO_HEADERS_MERGE_Vです。

5. エンティティの主キーを判別します。

1. 次の場所にあるOracle E-Business Suite電子技術リファレンス・マニュアルを参照してください。
http://etrm.oracle.com/pls/etrm/etrm_search.search

2. 表の詳細を取得するためにエンティティ名を含む検索を入力します。たとえば、PO_HEADERS_MERGE_Vエンティティの場合は、次のように入力します。
http://etrm.oracle.com/pls/etrm/etrm_pnav.show_object?c_name=PO_HEADERS_MERGE_V&c_owner=APPS&c_type=VIEW

3. 検索結果から、ビューまたは表の詳細を表示します。図7-2で示されている例は、ビューの詳細を提供します。

図7-2 ビューの詳細の表示

4. 選択したビューに一番適した表を選択します(この例では、PO_HEADERS_ALL)。

5. 図7-3に、その表に関連付けられた主キー詳細を示します。その主キーを判別します(この例では、PO_HEADER_ID)。

6. 図7-3 表の詳細の表示

6. 主キーに基づいて、その対応するビュー属性を取得します。
OAFページに戻り、「このページの情報」リンクをクリックし、「すべて開く」リンクをクリックします。最も頻繁に表示するビュー・オブジェクトを選択します(たとえば、PoHeaderMergeVO)。表示される「属性」リストから、属性名を判別します。属性名は、一般には、主キーの名前からわずかに異なります(たとえば、PO_HEADER_ID対PoHeaderId)。

7. 識別している値をメモしてください。第7.2.3項でそれらを使用して、管理対象添付ファイルのあるOAFページ詳細をマップします。
例では、次の値が見つかりました。

- エンティティ = PO_HEADERS_MERGE_V

- 主キー = PO_HEADER_ID

- ビュー・オブジェクト = PoHeaderMergeVO

- ビュー属性 = PoHeaderId

7.2.4 Oracle PeopleSoftのための管理対象添付ファイルの有効化

主な構成手順は、次のとおりです。

- C.4項で説明されているように、Oracle PeopleSoft AXFデータベース表内の各Oracle PeopleSoftエンティティの主キーの値を構成します。AXF_PSFT_ATTACHMENTS_CONFIG.sqlは、出発点として提供されます。それには、作業命令、販売契約および購入請求書など、PeopleSoftエンティティのためのサンプル値が含まれています。第3.3項で示された主キーを使用して、自分のOracle PeopleSoftページを反映するようにサンプル・キー値を変更できます。

- Oracle PeopleSoftロールを指定してユーザーに権限を付与します。

この項の手順に従って、Oracle PeopleSoftのための管理対象添付ファイルを有効化します。

1. 次のフォルダにAXF_PSFT_ATTACHMENTS_CONFIG.sqlサンプル・スクリプトを配置します。
MW_HOME/ECM_HOME/axf/adapters/psft/

2. 管理者権限があるユーザーとしてOracle PeopleSoftデータベースにログインします。

3. 第3.3項でOracle PeopleSoftエンティティのために識別した値を含むように、サンプル・スクリプトを変更し、そのスクリプトを実行します。
スクリプトを実行するには、次のコマンドを入力します。

@AXF_PSFT_ATTACHMENTS_CONFIG.sql

4. PS_AXF_COMMANDS表でOracle PeopleSoftのロールを指定して、指定されたユーザー・インタフェース・アイテムを使用する権限をユーザーに付与します。たとえば、Employee値をPeopleSoft Userまたは適切なOracle PeopleSoftユーザー・ロールに変更できます。C.4.2.2項を参照してください。

7.3 コンテンツ・サーバー・コンポーネントの構成

次にリストされる項に従って、Oracle E-Business SuiteまたはOracle PeopleSoftのための管理対象添付ファイル・ソリューションのコンテンツ・サーバー・コンポーネントを構成し、完成したソリューションをテストします。

注意:

別のビジネス・アプリケーションのための管理対象添付ファイル・ソリューションを構成するには、第7.4項で提供される説明を参照してください。

- 第7.3.1項「コンテンツ・サーバー・コンポーネントの有効化」

- 第7.3.2項「必要なコンテンツ・サーバー・コンポーネントおよび構成の確認」

- 第7.3.3項「管理対象添付ファイル・ソリューションのテスト」

7.3.1 コンテンツ・サーバー・コンポーネントの有効化

表7-3に、管理対象添付ファイル・ソリューションのコンテンツ・サーバー・コンポーネントをリストします。

表7-3 管理対象添付ファイルのコンテンツ・サーバー・コンポーネント

コンテンツ・サーバー・コンポーネント

説明

AppAdapterCore.zip

管理対象添付ファイルの構成のために必要

AppAdapterEBS.zip

Oracle E-Business Suite FormsおよびOAFの統合のために必要

AppAdapterPSFT.zip

Oracle PeopleSoftの統合のために必要

AppAdapterUniversal.zip

第7.4項で説明されているように、別のビジネス・アプリケーションの統合のために必要

次の手順に従って、コンポーネント・マネージャを使用してコンテンツ・サーバー・コンポーネントを有効化します。

1. アダプタの以前のインストールからアップグレートしている場合は、第7.3.1.1項で説明されているように、前のカスタマイズをバックアップします。

2. コンテンツ・サーバーに管理者としてログインします。

3. 「管理」メニューから「管理サーバー」を選択します。
「コンポーネント・マネージャ」ページが表示されます。

4. 「統合」を選択します。
表7-3で説明されているコンテンツ・サーバー・コンポーネントが統合オプションとしてリストされます。

5. AppAdapterCoreコンポーネントを選択して有効化します。

6. 適切なビジネス・アプリケーション・コンポーネントを選択します。

- Oracle E-Business Suiteの場合はAppAdapterEBS.zip

- Oracle PeopleSoftの場合はAppAdapterPSFT.zip

- 第7.4項で説明されているように、別のビジネス・アプリケーションの場合はAppAdapterUniversal.zip

7. 「更新」をクリックします。

8. コンテンツ・サーバーを再起動します。

9. コンテンツ・サーバーおよびデータベースのログをチェックして、アプリケーション・アダプタのインストールでエラーが発生していないことを確認します。

7.3.1.1 アップグレード前のカスタマイズのバックアップ

前のバージョンのアダプタ(管理対象添付ファイル・ソリューション)からアップグレードしており、第7.3.1項の手順1で示したように、コンテンツ・サーバー・コンポーネントのインストールの前に必要な場合は、次の追加のアップグレード手順を実行します。

1. コンテンツ・サーバーのルールおよびプロファイルのカスタマイズをバックアップします。
新しいアダプタのインストールによって、既存のルールおよびプロファイルが上書きされます。前のインストールにコンテンツ・サーバーのルールおよびプロファイルへのカスタマイズが含まれている場合は、コンテンツ・サーバー・コンポーネントをインストールする前に、CMUバンドルを使用してこれらのルールおよびプロファイルをバックアップします。インストール後に、新しいルールおよびプロファイルを作成し、カスタマイズを手動で適用します。

2. config.cfgファイルをバックアップします。
このアダプタ・リリースは、config.cfgのかわりにpreferences.hdaファイルを使用して環境変数を格納します。インストール後に、config.cfgからpreferences.hdaへ構成プリファレンスを手動でコピーします。

3. カスタマイズおよび変更を含む、他の任意のテンプレートまたはリソースをバックアップします。
一部のリソース・インクルードおよびテンプレートは、このリリースで変更されています。インストール後にこれらのカスタマイズを手動で設定します。

7.3.2 必要なコンテンツ・サーバー・コンポーネントおよび構成の確認

次の手順に従って、必要なコンテンツ・サーバー・コンポーネントが有効になっていることを確認します。

1. コンテンツ・サーバーに管理者としてログインします。

2. コンテンツ・サーバーの「管理」トレイで「[インスタンス]の構成」リンクをクリックします。

3. 「機能とコンポーネント」セクションで、「有効なコンポーネントの詳細」をクリックします。

4. 表示された詳細から、次のコンポーネントが有効になっていることを確認します。コンポーネントがリストされない場合は、そのインストール・ドキュメントに従ってそれをインストールして有効にします。
次のコンポーネントは、インストール済のContent Server 11gリリースとともに含まれるバージョン・レベル以上である必要があります。

- YahooUserInterfaceLibrary

- CheckoutAndOpenInNative

- CoreWebdav

- NativeOsUtils

- ContentFolios

5. 「ユーザー管理」アプレットで、次のロールに、対応するセキュリティ・グループへの正しいアクセス・レベルがあることを確認します。
コンテンツ・サーバーで、メイン・メニューから「管理」オプションを選択し、「管理アプレット」、「ユーザー管理」の順に選択します。「セキュリティ」、「ロールの権限」の順に選択します。

- AFAdmin: AFDocuments (RWDA)、および他のグループに対する権限なし

- AFDelete: AFDocuments (RWD)、および他のグループに対する権限なし

- AFWrite: AFDocuments (RW)、および他のグループに対する権限なし

- AFRead: AFDocuments (R)、および他のグループに対する権限なし

7.3.3 管理対象添付ファイル・ソリューションのテスト

『Oracle Fusion Middleware Oracle WebCenterアプリケーション・アダプタの使用』に示された手順に従って、選択したビジネス・アプリケーションの構成をテストします。

7.4 Enterprise Application Adapter Frameworkの構成

アダプタは、Oracle E-Business SuiteおよびOracle PeopleSoftコンポーネントのほかに、別のビジネス・アプリケーションで使用するための管理対象添付ファイル・ソリューションのカスタマイズのために、Enterprise Application Adapter Frameworkと呼ばれる汎用コンポーネントを提供します。このコンポーネントには、Oracle E-Business SuiteおよびOracle PeopleSoftコンポーネントのzipファイルに似た設定が含まれています。

第7.2.1項では、UCM_Managed_AttachmentsソリューションのためにAXF表を構成する、AXF_ATTACHMENTS_CONFIG.sqlスクリプトを実行しました。次の項でリストされている手順に従って、ビジネス・アプリケーション/管理対象添付ファイルの統合を構成します。

- 第7.4.1項「コンテンツ・サーバーでのAppAdapterUniversalコンポーネントのデプロイ」

- 第7.4.2項「SOAPサービス・コールおよび管理対象添付ファイルURL表示の構成」

7.4.1 コンテンツ・サーバーでのAppAdapterUniversalコンポーネントのデプロイ

この項で後で説明するとおりに、AppAdapterUniversal.zipコンポーネントをデプロイする前に、オプションでコンポーネント・ファイルの名前を変更し、フレームワーク・レイアウト、イメージおよびプロファイルをカスタマイズします。

コンポーネント・マネージャから、コンポーネントをインストールし、有効化し、コンテンツ・サーバーを再起動します。詳細は、第7.3.1項または『Oracle Fusion Middleware Oracle WebCenter Contentの管理』のコンポーネント・ウィザードの使用によるコンポーネントの作成に関する項を参照してください。

7.4.1.1 任意でのコンポーネント・ファイルの名前変更

ファイルの名前を変更することを選択する場合は、次の手順に従って、コンポーネントを解凍し、ビジネス・アプリケーションのために特定のファイルの名前を変更し、新たに名前が付けられたファイルにファイルを圧縮します。大文字のビジネス・アプリケーション名(たとえば、BIZAPP)、小文字の名前(たとえば、bizapp)、および詳細名(たとえば、ExampleBusinessApp)が必要になります。

1. AppAdapterUniversal.zipファイルをバックアップします。
このzipファイルは、次の場所にあります。

ECM_HOME/ucm/Distribution/AppAdapter

2. AppAdapterUniversal.zipファイルを解凍します。

3. 大文字と小文字を区別して、ファイル名のUniversalをビジネス・アプリケーション名と置き換えます(たとえば、UniversalをBIZAPPと置き換えます)。

この文字列が、管理対象添付ファイルURLで使用されるResultTemplate名で使用されることに注意してください(たとえば、ResultTemplate=BIZAPP_LIST)。結果テンプレートの詳細は、第7.6.13項を参照してください。

4. universal_AppAdapter_strings.htmファイルを見つけて、文字列Applicationをすべてビジネス・アプリケーションの詳細名と置き換えます(たとえば、ApplicationをExampleBusinessAppと置き換えます)。

5. 各ファイルで文字列Universalのインスタンスを検索し、大文字と小文字を区別して、手順3で指定した名前とそれらを置き換えます(たとえば、BIZAPP)。

6. 各ファイルで文字列universalのインスタンスを検索し、それらをビジネス・アプリケーションの小文字の名前と置き換えます(たとえば、bizapp)。

7. 新たに名前が付けられたファイルにファイルを圧縮します(たとえば、AppAdapterBuzzApp.zip)。

7.4.1.2 任意でのフレームワーク・レイアウト、イメージおよびプロファイルのカスタマイズ

- 結果テンプレート・ファイルのルック・アンド・フィールを変更するには、結果テンプレート・ファイルをカスタマイズします(本来はUniversal_LIST、universal_adapter_list_results_template.htmという名前が付けられている)。第7.6.13項を参照してください。

- イメージをカスタマイズするには、resources\publish\imagesフォルダ内のイメージを置き換えます。

- 使用されるコンテンツ・サーバー・プロファイルをカスタマイズするには、UniversalProfileファイルを変更します。第7.6.5項を参照してください。

7.4.2 SOAPサービス・コールおよび管理対象添付ファイルURL表示の構成

この項の手順に従って、AXFをコールして管理対象添付ファイルのURLを取得するように、ビジネス・アプリケーションを構成します。

1. アプリケーション・エンティティ・コンテキスト・リンク、ボタンまたはメニュー項目を提供して、SOAPサービスを介してAXFをコールし、表7-4にリストされている管理対象添付ファイル属性を渡すように、ビジネス・アプリケーションを構成します。

- 例7-1では、AXFをコールするためのサンプルSOAP XMLファイルを提供します。また、表7-5では、AXFRequest内のフィールドを説明します。

- 例7-2では、サンプルAXFResponseを提供します。また、表7-6では、AXFResponse内のフィールドを説明します。
SOAPレスポンスには、「管理対象添付ファイル」ページのURLが含まれています。付与コール時にエラーが発生した場合は、AXFエラー・ページURLが返されます。WSDL URLは次のとおりです。

http://Imaging Hostname:Imaging Port/axf-ws/AxfSolutionMediatorService?wsdl

表7-4 AXFへSOAPコールを介して渡す属性

管理対象添付ファイル属性キー

説明

値の例

application (必須)

インスタンスを区別するために一意の識別子を提供し、ビジネス・アプリケーションのインスタンス名を指定します。

BIZAPP_instanceA

businessObjectType (必須)

ビジネス・アプリケーションのオブジェクト・タイプを指定します(一般には、ビジネス・オブジェクト・データが格納されるレコードの名前)。

REQ_HEADERS

businessObjectKey1...businessObjectKey5 (1つのペアが必要)

ビジネス・アプリケーションのレコード・フィールドをコンテンツ・サーバーに一意にマップする、キー値のペアのObjectKey部分を指定します。

1つのキー値のペアが必要です。また、最大で5つまでのペアがサポートされています。

REQUISITION_HEADER_ID

businessObjectValue1...businessObjectValue5 (1つのペアが必要)

ビジネス・アプリケーションのレコード・フィールドをコンテンツ・サーバーに一意にマップする、キー値のペアのObjectValue部分を指定します。

1つのキー値のペアが必要です。また、最大で5つまでのペアがサポートされています。

1234

labelValue1...labelValue5 (オプション)

「管理対象添付ファイル」ページのタイトルに表示されるラベルを指定します。これらのlabelValueフィールドを使用して、エンド・ユーザーに、管理対象添付ファイルを適用する特定のアプリケーション・エンティティ・レコードをインタフェースを介して表示できるようにする、テキスト定数およびレコード・データを渡します。

ラベルはオプションです。また、5つまでのラベル値がサポートされています。

事業単位

US001

申込ID

1234

extraParamName (オプション、たとえばextraxReqNum)

フォームのチェックインまたはスキャンにおいてビジネス・アプリケーションからコンテンツ・サーバーへメタデータとして渡される追加パラメータ。(詳細は、第7.6.16.1項を参照してください。)

1234

例7-1 AXFをコールするためのSOAP XMLファイルのサンプル

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://service.axf.imaging.oracle/">
<soapenv:Header>
<Security xmlns="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
<UsernameToken>
<Username>weblogic</Username>
<Password>welcome1</Password>
</UsernameToken>
</Security>
</soapenv:Header>
<soapenv:Body>
<ser:execute>
<request>
<solutionNamespace>UCM_Managed_Attachments</solutionNamespace>
<commandNamespace>UCM_Managed_Attachments</commandNamespace>
<conversationId></conversationId>
<systemName></systemName> <!-- future use -->
<role></role> <!-- future use -->
<userContext></userContext> <!-- future user -->
<username>jcooper</username>
<requestParameters>
<entry>
<key>application</key>
<value>BIZAPP_instanceA</value>
</entry>
<entry>
<key>businessObjectType</key>
<value>REQ_HEADERS</value>
</entry>
<entry>
<key>businessObjectKey1</key>
<value>BUSINESS_UNIT</value>
</entry>
<entry>
<key>businessObjectValue1</key>
<value>US001</value>
</entry>
<entry>
<key>businessObjectKey2</key>
<value>REQUISITION_HEADER_ID</value>
</entry>
<entry>
<key>businessObjectValue2</key>
<value>1234</value>
</entry>
<entry>
<key>extraxReqNum</key>
<value>1234</value>
</entry>
</requestParameters>
</request>
</ser:execute>
</soapenv:Body>
</soapenv:Envelope>

表7-5 AXFRequest属性

AXFRequest属性

説明

例

solutionNamespace

コマンドを実行するSolutionNamespace。

UCM_Managed_Attachments

commandNamespace

指定したSolutionNamespace内で実行するコマンド。

UCM_Managed_Attachments

conversationID

AXFによって作成された現在開かれている対話。これが最初のコールであり、管理対象添付ファイル・ソリューションによって使用されない場合、この属性は空白です。

systemName

将来使用するために予約されています。

role

将来使用するために予約されています。

userContext

将来使用するために予約されています。

userName

ビジネス・アプリケーションのユーザー名です。

(管理対象添付ファイル・ソリューションについては、BPELのためにAXFで使用される場合は、USERNAME_PASS_THROUGHパラメータをTRUEに設定する必要があることに注意してください。USERNAME_PASS_THROUGHの詳細は、第7.6.19項を参照してください。)

jcooper

requestParameters

コマンド・パラメータを提供するキー/値のペアの集合。

<entry>
<key>application</key>
<value>BIZAPP_instanceA</value>
</entry>

例7-2 AXFResponse

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<ns2:executeResponse xmlns:ns2="http://service.axf.imaging.oracle/">
<response>
<conversationId>b80ce79b-6b46-4302-ab59-ddb91e30692b</conversationId>
<responseCommands>
<command>OPEN_BROWSER</command>
<value>http://imaging.example.com:16200/cs/idcplg/-UniversalProfile?IdcService=GET_SEARCH_RESULTS_FORCELOGIN&ResultTemplate=Universal_LIST&afGuid=00000132-b540-810e-63f4-00e94577f990</value>
</responseCommands>
</response>
</ns2:executeResponse>
</S:Body>
</S:Envelope>

表7-6 AXFResponse属性

AXFResponse属性

説明

conversationId

トランザクションの状態/コンテキストを維持するのに役立つ、AXFによって作成された現在の対話

responseCommands

単一のパラメータで実行するためにビジネス・アプリケーションにコマンドを提供するキー/値のペアの集合。ほとんどの場合、それはビジネス・アプリケーションが開く必要があるURLを提供するOPEN_BROWSERコマンドです。

2. 新しいブラウザ・ウィンドウまたはiFrameでAXF SOAPコールによって返されるURLを表示します。

3. オプションで、第7.4.2.1項で説明されているように、コールのためにSOAP over SSLセキュリティを構成します。

7.4.2.1 SSLを介した通信の保護(他のビジネス・アプリケーション)

次の主要な手順に従って、Enterprise Application Adapter FrameworkのためにWebサーバーのSSL暗号化を実装します。

1. Webサーバーベースのデジタル証明をインストールします。
ビジネス・アプリケーションのドキュメントで、ビジネス・アプリケーションのWebサーバー環境での証明書の構成についての情報を参照してください。

2. Oracle WebCenter Content側で、Oracle WebLogic ServerのSSLを有効にします。
詳細は、『Oracle Fusion Middleware Oracle WebCenter Contentのインストールと構成』のOracle WebCenter ContentアプリケーションへのSSLの構成に関する項を参照してください。

3. Webサーバー間でサーバー証明書を交換します。
詳細は、『Oracle Fusion Middleware管理者ガイド』の"exportKeyStoreObject"に関する項を参照してください。

7.5 管理対象添付ファイルの設定の構成

第7.3項で説明したようにコンテンツ・サーバー・コンポーネントを構成したら、管理対象添付ファイル管理インタフェースを使用してその設定を構成します。この項では、一般的な構成情報を提供します。また、第7.6項では、詳細なカスタマイズの説明および例を提供します。

優先順位の設定

構成設定の優先順位は、次のとおりです。

- ロール固有(最上位)

- ビジネス・コンテキスト固有

- アプリケーション・エンティティ固有

- アプリケーション・インスタンス固有

- グローバル(最下位)

添付ファイルの設定を構成する場合は、この優先順位を覚えておいてください。たとえば、他のすべてのロールに対してスキャンが無効になっている場合にスキャン結果を有効にするロールの構成などがあります。

注意:

この項では、管理インタフェースで管理対象添付ファイルの設定を編集する方法について説明します。別の方法としては、第7.5.2項で説明されているように、設定が格納されているpreferences.hdaファイル構成ファイルを直接編集することで設定をカスタマイズできます。

1. コンテンツ・サーバーで、「管理」メニューから「管理対象添付ファイル」を選択します。
図7-4で示されているように、「管理対象添付ファイルの構成」ページが表示されます。

図7-4 「管理対象添付ファイルの構成」ページ

2. 必要な場合は、「グローバル構成」の変数を編集し、「更新」をクリックします。
これらの設定を使用して、第7.5.1項および第7.6項で説明されているように、アダプタのためのコンテンツ・サーバー環境変数を構成します。

3. 「添付リレーションシップ属性」を追加、編集または削除します。
この領域を使用して、第7.6.10項で説明されているように、添付されたドキュメントとビジネス・エンティティの間のカスタム・リレーションシップを構成します。たとえば、ユーザーに、特定のビジネス・エンティティのためのドキュメント添付ファイルを印刷できるようにし、他のビジネス・エンティティのためのドキュメント添付ファイルは印刷できないようにします。

4. エンティティ固有の構成を追加、編集または削除します。
この領域を使用して、第7.6.3項で説明されているように、指定されたビジネス・エンティティまたはアプリケーションのためのグローバル設定をオーバーライドします。たとえば、「リポジトリから」ボタンを表示し、指定されたビジネス・エンティティのためにそのボタンを非表示にするグローバル設定をオーバーライドします。

5. ロール固有の構成またはビジネス・コンテキスト固有の構成を追加、編集または削除します。
これらの領域を使用して、次のいずれかに基づいて、管理対象添付ファイルのどの機能およびボタンを表示し使用可能にするかを構成します。

- 第7.6.1項で説明されている、ユーザーの割当て済ロール。たとえば、読取り専用の管理対象添付ファイル・アクセス権を持つように読取りロールを付与されたすべてのユーザーを構成します。

- 第7.6.2項で説明されている、ユーザーのビジネス・アプリケーション・コンテキスト。たとえば、businessObjectContextがbusiness application=ScanContextから渡されたときのみ「スキャン」ボタンを表示し使用可能にします。

7.5.1 グローバル構成変数での作業

「管理対象添付ファイルの構成」ページの「グローバル構成」セクションを使用して、デフォルト値からグローバル環境変数を変更します。

グローバル構成変数は、ページ上で次のようにグループ化されます。

- チェックイン変数(表7-7)

- スキャン変数(表7-8)

- ボタン変数(表7-9)

- 一般変数(表7-10)

表7-7 チェックイン変数

フィールド

デフォルト値

説明

AppAdapterCheckinPrivate

true

trueに設定する場合、「コンテンツ・チェックイン」ページおよび「ドキュメントのスキャン」ページの「共有ドキュメント」フィールドはデフォルトで選択解除されます。この設定はプライベート・チェックインのためにドキュメントを構成しますが、ユーザーは共有チェックインのためにフィールドを選択できます。第7.7.3項を参照してください。

AppAdapterExtraCheckinMetadata

null

オプションで、「チェックイン」ページに移入されるようAXF付与コールを渡すために、パラメータのカンマ区切りリストを指定します(次の値の前のカンマの後にはスペースは残しません)。詳細は、第7.6.16項を参照してください。

表7-8 スキャン変数

フィールド

デフォルト値

説明

AppAdapterExtraScanMetadata

null

オプションで、「ドキュメントのスキャン」ページに移入されるようAXF付与コールを渡すために、パラメータのカンマ区切りリストを指定します(次の値の前のカンマの後にはスペースは残しません)。詳細は、第7.6.16項を参照してください。

ODDCURLPath

ドキュメントの添付ファイルのスキャン、およびOracle WebCenter CaptureまたはOracle Distributed Document Captureを介したインポートを有効にします。構成の説明については、第7.9項および第7.10項を参照してください。

Oracle WebCenter Capture (11g)の統合

このエントリは、Oracle WebCenter CaptureへのWebアドレスを指定します。

形式:

ODDCURLPath

http://capture_host:port/dc-client

例:

ODDCURLPath

http://capture1:16400/dc-client

Oracle Distributed Document Capture (10g)の統合

このエントリは、Oracle Distributed Document CaptureへのWebアドレスを指定します。

形式:

ODDCURLPath

http://ODDC_host/ODDC_webcapture_address

例:

ODDCURLPath

http://xyz/webcapture.asp

ODDCScanAction

1

第7.10項で説明されているように、ドキュメントの添付ファイルのスキャン、およびOracle Distributed Document Capture (10g)を介したインポートの構成用に使用します。このエントリでは、実行するスキャン・アクションを次のように指定します。

- 1 = スキャン

- 2 = インポート

表7-9 ボタン変数

フィールド

デフォルト値

説明

AppAdapterDetachBtnVisible

true

「管理対象添付ファイル」ページに「削除」ボタンが表示されるかどうかを指定します。

AppAdapterRefreshBtnVisible

true

「管理対象添付ファイル」ページに「リフレッシュ」ボタンが表示されるかどうかを指定します。

AppAdapterCheckinNewBtnVisible

true

「管理対象添付ファイル」ページに「新規」ボタンが表示されるかどうかを指定します。

AppAdapterRepoAttachBtnVisible

true

「管理対象添付ファイル」ページに「リポジトリから」ボタンが表示されるかどうかを指定します。

AppAdapterConfigureBtnVisible

true

「管理対象添付ファイル」ページに「構成」ボタンが表示されるかどうかを指定します。

AppAdapterSearchWithinBtnVisible

true

ユーザーに添付ファイル・リスト内を検索できるようにする「絞込み検索」ボタンが、「管理対象添付ファイル」ページに表示されるかどうかを指定します。

AppAdapterScanBtnVisible

false

「管理対象添付ファイル」ページに「スキャン」ボタンが表示されるかどうかを指定します。

AppAdapterHelpIconVisible

true

「管理対象添付ファイル」ページに「ヘルプ」アイコンが表示されるかどうかを指定します。

AppAdapterAutoVueIconVisible

false

「管理対象添付ファイル」ページの「アクション」列に「Autovue」アイコンが表示されるかどうかを指定します。詳細は、第7.8項を参照してください。

表7-10 一般変数

フィールド

デフォルト値

説明

AppAdapterGrantPrivilege

W

AF_GRANT_ACCESSサービスのdPrivilegeパラメータが指定されない場合は、すべてのユーザーに付与するためのアクセス・レベルを指定します。有効な値には、R (読取り)、W (書込み)、D (削除)およびA (管理)があります。

詳細は、C.5.1項を参照してください。

AppAdapterGrantHours

0.5

ユーザー・セッションを利用できる時間を指定します。ソリューションでは、AF_GRANT_ACCESSサービスのnumHoursパラメータが指定されない場合のみ、この値が使用されます。有効な値は、オプションで小数がある数値です。

詳細は、C.5.1項を参照してください。

AppAdapterMaxGrantHours

24

.「管理対象添付ファイル」ページへのユーザー・アクセスを付与する最大時間を指定します。有効な値は、小数がある数値です。

たとえば、AppAdapterGrantHoursが1時間に設定され、AppAdapterMaxGrantHoursが24時間に設定されているとします。ユーザーが12:00 (正午)にビジネス・アプリケーションから「管理対象添付ファイル」ページにアクセスする場合、AFGrants表内のdExpirationDateのは13:00に設定され、dMaxExpirationは翌日の12:00 (正午)に設定されます。ユーザーが12:30にアクションを実行する場合(ドキュメントのチェックインなど)、dExpirationDateは13:30などに変更されます。その結果、ユーザーは、2つの要求の間のギャップが1時間未満の場合はいつでも、24時間まで「管理対象添付ファイル」ページにアクセスすることができます。どのような場合であっても、24時間に達したときは、アクセスは拒否されます。この設定は、ユーザーがユーザー・アクションなしで長期間アクセスを開いたままにすることを防ぎ、ユーザーがアクティブにシステムを使用している場合にアクセスが期限切れにならないようにします。

AppAdapterKeyDelimiter

|

パラメータとして渡される主キーおよび値を連結させるために使用される内部デリミタを指定します。詳細は、C.5.1項を参照してください。デフォルトのデリミタは、 | (パイプ)文字です。

AutoVueURLPath

Oracle AutoVue Webバージョンを介して、添付されたドキュメントのAutoVue表示を有効にします。構成の説明については、第7.8項を参照してください。このエントリは、実行するAutoVueサーブレットを指定します。

形式:

AutoVueURLPath

http://ucm_host name:port/web_root/idcplg?IdcService=VIEW_IN_AUTOVUE

例:

AutoVueURLPath

http://ucm1.example.com/cs/idcplg?IdcService=VIEW_IN_AUTOVUE

AppAdapterFrameLessWindowRequired

true

添付ファイルの表示(true)または表示済(false)から開くブラウザ・ウィンドウで標準のブラウザ・メニュー・オプションを非表示にするかどうかを指定します。

AppAdapterViewUnreleased

false

trueに設定する場合は、リリースされる前に、Webファイルへのリンクなしで、添付ファイル・リスト内のドキュメントを表示します。

ResultCount

20

「管理対象添付ファイル」ページでページごとに表示する添付ファイルの数を指定します。結果の数がResultCountを超える場合は、前のページと次のページのコントロールがページに表示されます。

SearchEngineName

DATABASE.METADATA.AFLIST

使用する検索エンジンを指定します。次の選択が可能です。

- DATABASE.METADATA.AFLIST.STANDARD: リリースされたドキュメントのみを表示します。

- DATABASE.METADATA.AFLIST: リリースされたドキュメントとリリースされていないドキュメントを表示します。

注意: コンテンツ・サーバーでデータベース全文検索またはOracle全文検索が構成されている場合は、ユーザーが「リポジトリから」ボタンをクリックした場合のみ、指定された検索エンジンが使用されます。

7.5.2 代替方法としてのPreferences.hdaファイル内の設定の編集

管理対象添付ファイル管理の設定は、preferences.hdaと呼ばれる構成ファイルに格納されます。

第7.5項で説明されているように、管理対象添付ファイル管理インタフェースを使用して設定を編集できます。別の方法としては、この項の手順に従ってpreferences.hdaファイルを直接変更できます。

注意:

preferences.hdaファイルを変更したら、コンテンツ・サーバーを再起動する必要があります。

必要に応じてアプリケーションおよびビジネス・エンティティ構成のエントリを追加または削除できますが、preferences.hdaファイルからグローバル構成のエントリを削除しないでください。

1. 次のディレクトリでpreferences.hdaファイルを開きます。
UCM_Instance/data/appadapter

このファイルは、表7-11で説明されているResultSetセクションで管理対象添付ファイルの構成オプションを提供します。

Table 7-11 Preferences.hdaファイルのResultSetセクション

セクション

説明

AFEnvironmentConfiguration

アダプタのためのコンテンツ・サーバー環境変数を構成するために使用します。

詳細は、表7-7および第7.6項を参照してください。

AFRelationshipAttributes

添付されたドキュメントとビジネス・エンティティの間のカスタム・リレーションシップを構成するために使用します。

詳細は、第7.6.10項を参照してください。

AFRevisionSpecificEntities

ドキュメントが後で更新されたとしても、添付されたドキュメント・バージョンにユーザーがアクセスできるようにするために使用します。

詳細は、第7.6.11項を参照してください。

2. AFEnvironmentConfiguration ResultSetセクションにスクロールし、必要に応じて、第7.5.1項で説明されているようにエントリを編集します。これらの変数の使用による管理対象添付ファイル・ソリューションのカスタマイズの詳細は、第7.6項を参照してください。

7.6 管理対象添付ファイル・ソリューションのカスタマイズ

この項では、管理対象添付ファイル・ソリューションのカスタマイズ方法について説明します。この項の内容は、次のとおりです。

- 第7.6.1項「ユーザーの割当て済ロールに基づいた設定のカスタマイズ」

- 第7.6.2項「ユーザーのビジネス・コンテキストに基づいた設定のカスタマイズ」

- 第7.6.3項「ビジネス・エンティティまたはアプリケーション・レベルでの設定のカスタマイズ」

- 第7.6.4項「新しい添付ファイルのために使用されるドキュメント・タイプのカスタマイズ」

- 第7.6.5項「使用されるコンテンツ・サーバー・プロファイルのカスタマイズ」

- 第7.6.6項「管理対象添付ファイル・ページのボタンの非表示または表示」

- 第7.6.7項「スキャンのカスタマイズ」

- 第7.6.8項「管理対象添付ファイル・ページのイメージのカスタマイズ」

- 第7.6.9項「使用されるスタイル・シート(CSS)のカスタマイズ」

- 第7.6.10項「添付リレーションシップ属性の構成」

- 第7.6.11項「リビジョン固有モードの構成」

- 第7.6.12項「結果数の変更」

- 第7.6.13項「結果テンプレートの変更」

- 第7.6.14項「デフォルト列の設定」

- 第7.6.15項「添付ファイルでの紙クリップの有効化(Oracle E-Business Suite Formsのみ)」

- 第7.6.16項「ビジネス・アプリケーションからコンテンツ・サーバーへの追加のメタデータ値の引渡し」

- 第7.6.17項「Oracle PeopleSoftポップアップ・ソリューション・ウィンドウのサイズ変更」

- 第7.6.18項「エンティティのプライベート添付ファイルのセキュリティ・グループの構成」

- 第7.6.19項「管理対象添付ファイルのためのビジネス・アプリケーション・ユーザーのパス・スルーの復元」

- 第7.6.20項「OAFエンティティのための管理対象添付ファイル・ボタンの名前変更」

7.6.1 ユーザーの割当て済ロールに基づいた設定のカスタマイズ

管理対象添付ファイル管理を使用して、ユーザー・ロールに基づいて設定をカスタマイズできます。(一般的な情報については、第7.5項を参照してください。)これにより、特定のユーザー・ロールのための設定をカスタマイズするとともにグローバル値を保存できるようになります。たとえば、この機能を使用して、読取り専用ロールを割り当てられたコンテンツ・サーバー・ユーザーのために管理対象添付ファイルへのアクセスを読取り専用に制限できます。

1. コンテンツ・サーバーで、「管理」メニューから「管理対象添付ファイル」を選択します。
「管理対象添付ファイルの構成」ページが表示されます。

2. ページの下部にある「ロール固有構成」の設定にスクロールして、「追加」をクリックします。

3. 図7-5で示されている「ロール固有構成の追加」ページで、フィールドに入力しユーザー・ロールに基づいて管理対象添付ファイル変数をカスタマイズし、「更新」をクリックします。この例は、次の設定を指定します。

- 構成名: AppAdapterGrantPrivilege

- 値: R

- ロール: readRole

AppAdapterGrantPrivilege変数では、ユーザーに付与するアクセス・レベルが指定されます。この例では、コンテンツ・サーバーでUser Admin機能を使用してロール(この例ではreadRole)を構成し割り当ててあるものとします。

図7-5 ロール固有の構成の例

7.6.2 ユーザーのビジネス・コンテキストに基づいた設定のカスタマイズ

管理対象添付ファイル管理を使用して、ユーザーのビジネス・コンテキストに基づいて設定をカスタマイズできます。(一般的な情報については、第7.5項を参照してください。)これにより、特定のビジネス・コンテキストのための設定をカスタマイズするとともにグローバル値を保存できるようになります。たとえば、この機能を使用して、ユーザーのビジネス・コンテキスト(ビジネス・アプリケーションから渡されたbusinessObjectContext)が特定の値(ScanContextなど)の場合のみ「スキャン」ボタンを表示し使用可能にすることができます。

1. コンテンツ・サーバーで、「管理」メニューから「管理対象添付ファイル」を選択します。
「管理対象添付ファイルの構成」ページが表示されます。

2. ページの下部にある「ビジネス・コンテキスト固有構成」の設定にスクロールして、「追加」をクリックします。

3. 図7-6で示されている「ビジネス・コンテキスト固有構成」ページで、フィールドに入力しビジネス・コンテキストに基づいて管理対象添付ファイル変数をカスタマイズし、「更新」をクリックします。
図7-6で示されている例では、ScanContextと等しいビジネス・アプリケーションからbusinessObjectContextが渡されたときに「スキャン」ボタンを表示するよう構成します。この例は、次の設定を指定します。

- 構成名: AppAdapterScanBtnVisible

- 値: true

- ロール: ScanContext

図7-6 ビジネス・コンテキスト固有の構成の例

4. キー・ラベル/値(labelValues)を構成するように、ビジネス・アプリケーションからScanContext値に渡すようビジネス・アプリケーション表を構成します。

- 構成するOracle PeopleSoftページごとに、ScanContextを渡すPS_AXF_CMD_PARAMS表に行を挿入します。表C-38で、AXF_PARAM_NAME=businessObjectContextおよびAXF_CONSTANT_VALUE=ScanContextの行を確認してください。

- Oracle E-Business Suite OAFページごとに、ScanContextを渡すOAF_AXF_CMD_PARAMS表に行を挿入します。表C-32で、AXF_PARAM_NAME=businessObjectContextおよびAXF_CONSTANT_VALUE=ScanContextの行を確認してください。

7.6.3 ビジネス・エンティティまたはアプリケーション・レベルでの設定のカスタマイズ

管理対象添付ファイル管理を使用して、アプリケーション・レベルおよびビジネス・エンティティ・レベルで設定をカスタマイズできます。(一般的な情報については、第7.5項を参照してください。).これにより、特定のビジネス・エンティティのための設定をカスタマイズするとともにグローバル値を保存できるようになります。たとえば、「スキャン」ボタンを使用可能にしてグローバルなスキャンを許可するが、そのボタンを非表示にすることで特定のビジネス・エンティティに対してそれを使用不可にすることができます。

1. コンテンツ・サーバーで、「管理」メニューから「管理対象添付ファイル」を選択します。
「管理対象添付ファイルの構成」ページが表示されます。現在選択されているグローバル設定は、「グローバル構成」ヘッダーの下に表示されます。

2. ページの下部にある「エンティティ固有構成」の設定にスクロールして、「追加」をクリックします。

3. 図7-7で示されている「エンティティ固有構成」ページで、フィールドに入力し、エンティティまたはアプリケーションのためのグローバル設定をオーバーライドします。

- ビジネス・エンティティ・レベルでオーバーライドするには、すべてのフィールドに入力します。次の値の例は、グローバル設定に関係なく、ExpenseClaimsビジネス・エンティティのみのために表示するように「リポジトリから」ボタンを構成します。

- アプリケーション・レベルでオーバーライドするには、「オブジェクト名」フィールドを空白のままにします。次の例でそのようにすると、グローバル設定に関係なく、EBS_Instanceアプリケーションのすべてのビジネス・エンティティのために「リポジトリから」ボタンが表示されます。

フィールド

説明

例

アプリケーション名

ビジネス・アプリケーションを識別します

EBS_Instance

オブジェクト名

ビジネス・エンティティを識別します

ExpenseClaims

構成名

ビジネス・エンティティのために設定するグローバル構成変数

AppAdapterRepoAttachButtonVisible

構成値

ビジネス・エンティティのために設定する変数値

true

図7-7 エンティティ固有の構成の例

注意:

「アプリケーション名」フィールドまたは「オブジェクト・タイプ」フィールドのどちららかに入力する必要があります。アプリケーション名なしでオブジェクト・タイプを入力すると、そのオブジェクト・タイプのすべてのアプリケーションのビジネス・エンティティに設定が適用されます。

7.6.4 新しい添付ファイルのために使用されるドキュメント・タイプのカスタマイズ

ユーザーが「新規」ボタンをクリックしてドキュメントを添付しチェックインした場合は、コンテンツ・サーバーのドキュメント・タイプはデフォルトで選択されます。preferences.hdaの設定を使用すると、異なるデフォルト・ドキュメント・タイプを指定できます。また、グローバル、アプリケーションまたはビジネス・エンティティ・レベルでドキュメント・タイプを指定できます。たとえば、経費添付ファイルを対象とするカスタム・ドキュメント・タイプを使用して、経費ビジネス・エンティティのためのすべての新規ドキュメントをチェックインできます。

手順は、次のとおりです。

1. コンテンツ・サーバーで、ドキュメント・タイプを作成または変更します。
ドキュメント・タイプの詳細は、コンテンツ・サーバーのドキュメントを参照してください。

2. preferences.hdaファイルで、AFEnvironmentConfiguration結果セットに新しい行を追加します。一般的な情報については、第7.5.2項を参照してください。

3. 次のように、指定されたビジネス・エンティティのデフォルト・タイプとして使用するためのドキュメント・タイプを識別するエントリを挿入します。

- 名前: afDocType

- 値: ドキュメント・タイプ・キー

- dAFApplication: このドキュメント・タイプを割り当てるアプリケーション

- dAFBusinessObjectType: ドキュメント・タイプを割り当てるアプリケーション内のビジネス・エンティティ

例7-3は、ユーザーがドキュメントをExpenseClaimsビジネス・エンティティ(PSFT_Instanceアプリケーション内)に添付する場合に、ドキュメント・タイプExpenseClaimsTypeをデフォルト・タイプとして設定します。

例7-3 経費ビジネス・エンティティのためのカスタム・デフォルト・ドキュメント・タイプ

afDocType
ExpenseClaimsType
PSFT_Instance
ExpenseClaims

4. コンテンツ・サーバーを再起動します。

7.6.5 使用されるコンテンツ・サーバー・プロファイルのカスタマイズ

アダプタは、ビジネス・アプリケーションごとにデフォルトのコンテンツ・サーバー・プロファイルを提供します。

- Oracle E-Business Suiteの場合はEBSProfile

- Oracle PeopleSoftの場合はPSFTProfile

- Enterprise Application Adapter Frameworkの場合はUniversalProfile

第7.2.1項でAXF_ATTACHMENTS_CONFIG.sqlスクリプトを実行している場合は、プロファイルを設定します。プロファイルをコピーしてカスタマイズし、カスタマイズの必要性に応じて、次のいずれかの方法を使用してそれを割り当てます。たとえば、プロファイルにメタデータ・フィールドを追加できます。

注意:

カスタム・プロファイルを使用する場合は、デフォルトで、アプリケーション固有のエラー・メッセージではなく一般的なエラー・メッセージが表示されます。カスタム・エラー・メッセージを表示するには、af_custom_error_msg_displayを含むリソースをオーバーライドします。オーバーライドしたリソース・インクルードで、エラー・メッセージをafErrorMsgに設定します。

7.6.5.1 プロファイルのグローバルな変更

次の手順に従って、使用されるグローバル・プロファイルを変更します。

1. コンテンツ・サーバーの構成マネージャから、提供されたデフォルト・プロファイル(EBSProfile、PSFTProfileまたはUniversalProfile)をコピーします。これらのプロファイルを表示するには、構成マネージャで「プロファイル」タブに移動します。

2. 必要に応じて新しいルールを追加します。たとえば、新しいメタデータ・フィールドを追加します。

3. AXF_SOLUTION_PARAMETERS表のUCM_CONNECTION_STRパラメータ(トリガー値)で、新しいプロファイルを指すようにURLを変更します。
詳細は、C.1.4項を参照してください。

7.6.5.2 特定のビジネス・エンティティまたはアプリケーションのためのプロファイルの指定

次の手順に従って、特定のビジネス・エンティティまたはアプリケーションのためのプロファイルを変更します。

1. コンテンツ・サーバーの構成マネージャから、提供されたデフォルト・プロファイル(EBSProfile、PSFTProfileまたはUniversalProfile)をコピーします。これらのプロファイルを表示するには、構成マネージャで「プロファイル」タブに移動します。

2. 必要に応じて新しいルールを追加します。たとえば、新しいメタデータ・フィールドを追加します。

3. preferences.hdaファイルで、AFEnvironmentConfiguration結果セットに新しい行を追加します。一般的な情報については、第7.5.2項を参照してください。

4. 次のように、指定されたビジネス・エンティティのために使用する、コンテンツ・サーバー・プロファイルを識別するエントリを挿入します。

- 名前: dpTriggerValue

- 値: 新しいコンテンツ・サーバー・プロファイルのキー

- dAFApplication: このプロファイルを割り当てるアプリケーション

- dAFBusinessObjectType: プロファイルを割り当てるアプリケーション内のビジネス・エンティティ

例7-4は、ユーザーがEBS_Instanceアプリケーション内のOrderPayablesビジネス・エンティティのドキュメントを添付またはスキャンするときに使用するために、OrderPayableProfileと呼ばれるプロファイルを設定します。

例7-4 経費ビジネス・エンティティのためのカスタム・コンテンツ・サーバー・プロファイル

dpTriggerValue
OrderPayableProfile
EBS_Instance
OrderPayables

5. コンテンツ・サーバーを再起動します。

7.6.6 管理対象添付ファイル・ページのボタンの非表示または表示

変数設定をそれぞれtrueまたはfalseに変更することで、管理対象添付ファイル・ページで、ユーザーに対して、表7-12にリストされているボタンを使用可能(表示)または使用不可(非表示)にすることを選択できます。管理対象添付ファイル変数の詳細は、第7.5.1項を参照してください。

表7-12 管理対象添付ファイルのボタンの表示または非表示のための変数

ボタン変数

説明

AppAdapterRepoAttachBtnVisible

「リポジトリから」ボタンを表示または非表示にします

AppAdapterRefreshBtnVisible

「リフレッシュ」ボタンを表示または非表示にします

AppAdapterConfigureBtnVisible

「構成」ボタンを表示または非表示にします

AppAdapterDetachBtnVisible

「削除」ボタンを表示または非表示にします

AppAdapterCheckinNewBtnVisible

「新規」ボタンを表示または非表示にします

AppAdapterScanBtnVisible

「スキャン」ボタンを表示または非表示にします

AppAdapterAutoVueIconVisible

「アクション」列の「Autovue」ボタンを表示または非表示にします

AppAdapterSearchWithinBtnVisible

「絞込み検索」ボタンを表示または非表示にします

AppAdapterHelpIconVisible

「ヘルプ」アイコンを表示または非表示にします

次の手順に従って、グローバルに、または特定のビジネス・エンティティやアプリケーションに対して、ボタンを表示または非表示にします

1. コンテンツ・サーバーで、「管理」メニューから「管理対象添付ファイル」を選択します。

2. ボタンを非表示にするには、「グローバル構成」の下でボタンのグローバル設定をfalseに変更し、表示するには、trueに変更します。

3. ビジネス・エンティティ・レベルでボタンの表示を構成するには、「エンティティ固有構成」の下の「追加」をクリックすることでエンティティ固有の構成を作成し、第7.6.3項で説明されているようにフィールドに入力します。

7.6.7 スキャンのカスタマイズ

この項では、Oracle Distributed Document Capture 10gまたはOracle WebCenter Capture 11gを使用してスキャン機能をカスタマイズする方法を説明します。プロファイルは、Oracle Distributed Document Capture 10gではスキャン・プロファイルと呼ばれ、Oracle WebCenter Capture 11gではクライアント・プロファイルと呼ばれます。この項の内容は、次のとおりです。

- 第7.6.7.1項「スキャンの有効化または無効化」

- 第7.6.7.2項「ビジネス・エンティティのための代替スキャン・プロファイルの構成」

- 第7.6.7.3項「使用されるドキュメント分類の変更」

7.6.7.1 スキャンの有効化または無効化

グローバル、アプリケーションまたはビジネス・エンティティ・レベルでスキャンを有効化または無効化できます。たとえば、グローバルにスキャンを無効化してから、次の「エンティティ固有構成」設定を使用して、OrderPayablesビジネス・エンティティのためにのみスキャンを有効化するようエンティティ固有の構成を追加できます。

- アプリケーション名: EBS_Instance

- オブジェクト・タイプ: OrderPayables

- 構成名: AppAdapterScanBtnVisible

- 構成値: true

7.6.7.2 ビジネス・エンティティのための代替スキャン・プロファイルの構成

アダプタでは、管理対象添付ファイルのスキャン・ページを表示する、次のデフォルトのビジネス・アプリケーション・スキャン・プロファイルが提供されます。それぞれは、次のようにアプリケーション固有のフィールドを指します。

- EBSScanProfileは、EBSAppScanProfilesアプリケーション・フィールドを参照します

- PSFTScanProfileは、PSFTAppScanProfilesアプリケーション・フィールドを参照します

- UniversalScanProfileは、UniversalAppScanProfilesアプリケーション・フィールドを参照します

次の手順で説明するように、ビジネス・アプリケーションに適したプロファイルをコピーし、別のアプリケーション・フィールドを参照するようにそれを変更し、1つ以上のビジネス・エンティティのためにそれを構成することで、使用されるスキャン・プロファイルをカスタマイズできます。

1. ビジネス・アプリケーションに適用するスキャン・プロファイルをコピーし、新しい名前で保存します。

2. AppScanProfilesアプリケーション・フィールド、表およびビューを含む、必要なすべてのスキーマ要素を作成します。
アプリケーション・フィールド参照を変更するには、コンテンツ・サーバーにログインします。構成マネージャで、「ルール」タブに移動します。PSFTScanRule、EBSScanRuleまたはUniversalScanRuleを選択し、「サイド・エフェクト」タブの「編集」をクリックし、別のアプリケーション・フィールドを指すようにScanProfileKeyフィールドを更新します。

3. preferences.hdaファイルで、AFEnvironmentConfiguration結果セットに新しい行を追加します。

4. afScanProfile設定を含むエントリを挿入し、使用するスキャン・プロファイル、それを適用するアプリケーションおよびビジネス・エンティティを識別します。
例7-5では、PIMビジネス・エンティティのみのために使用可能なMyPIMScanProfileと呼ばれるスキャン・プロファイルを示します。

例7-5 ビジネス・エンティティのための別のスキャン・プロファイルの有効化

afScanProfile
MyPIMScanProfile
PSFT_Instance
PIM

7.6.7.3 使用されるドキュメント分類の変更

アダプタは、表7-13にリストされている、スキャンのためのデフォルトのビジネス・アプリケーション・ドキュメント分類を提供します。各分類には、一連のコンテンツ・サーバー・アプリケーション・フィールド、表およびビューが含まれています。

表7-13 提供されるデフォルトのドキュメント分類

ビジネス・アプリケーション

コンテンツ・サーバー・フィールド

表

表示

Oracle E-Business Suite

EBSAppScanProfiles

EBSDocClass

EBSDocClassView

Oracle PeopleSoft

PSFTAppScanProfiles

PSFTDocClass

PSFTDocClassView

Enterprise Application Adapter Framework

UniversalAppScanProfiles

UniversalDocClass

UniversalDocClassView

分類を変更するには:

1. コンテンツ・サーバーにログインします。構成マネージャで、EBSDocClassView、PSFTDocClassViewまたはUniversalDocClassViewに移動します。

2. ドキュメント分類およびスキャン・タイプの値を編集します。詳細は、第7.10.4項を参照してください。

7.6.8 管理対象添付ファイル・ページのイメージのカスタマイズ

アダプタは、管理対象添付ファイルの表示のための標準イメージを提供します(カスタマイズ可能)。たとえば、Oracleの青い波のイメージをユーザーの組織固有のイメージに置き換えることができます。イメージを変更するには、af_ebs_define_image_locationsを含むリソースをオーバーライドします。実装例については、Oracle E-Business Suiteの場合はAppAdapter_JS_resource.htmを、Oracle PeopleSoftの場合はps_AppAdapter_Js_resource.htmを参照してください。

注意:

管理対象添付ファイルのためのイメージのカスタマイズには、コンテンツ・サーバーの構成およびカスタマイズの高度な知識が必要です。変更を行う前に、必ず適切なファイルをバックアップしてください。

7.6.9 使用されるスタイル・シート(CSS)のカスタマイズ

アダプタは、「管理対象添付ファイル」ページのための標準のスタイル・シートを提供します。リソース・インクルードをオーバーライドすることで、それを変更できます。実装例については、Oracle E-Business Suiteの場合はAppAdapter_CSS_resource.htmを、Oracle PeopleSoftの場合はps_AppAdapter_CSS_resource.htmを参照してください。

注意:

管理対象添付ファイルのためのスタイル・シートのカスタマイズには、コンテンツ・サーバーの構成およびカスタマイズの高度な知識が必要です。変更を行う前に、必ず適切なファイルをバックアップしてください。

7.6.10 添付リレーションシップ属性の構成

添付リレーションシップ属性により、管理対象添付ファイルでのドキュメントの添付の際に、リレーションシップ・メタデータ(ドキュメントとそのビジネス・エンティティの間のリレーションシップについての情報)を格納できます。

たとえば、2つの作業オーダー・エンティティ(WO1およびWO2)に添付される1つのドキュメントがあり、ユーザーに、WO1からのドキュメントの印刷を許可し、WO2からの印刷は許可しないようにするとします。この場合、コンテンツ・サーバー上でアプリケーション・フィールドとして印刷属性を作成し、管理対象添付ファイル管理(またはpreferences.hdaファイル)内でWO1ビジネス・エンティティのための印刷リレーションシップ属性を指定します。印刷属性は、「更新」ページで、WO1エンティティのみのためにエンド・ユーザーに表示され、添付されたドキュメントの印刷が可能になります。

添付リレーションシップ属性についての重要点

- 新しいドキュメントのチェックインのために添付リレーションシップ属性を構成することはできますが、スキャンを介して添付されたドキュメントのためには構成できません。

- リレーションシップ属性の追加によって、そのリレーションシップ属性のためにコンテンツ・サーバー内で新しいアプリケーション・フィールドが作成されます(存在しない場合)。コンテンツ・サーバー管理アプレット - 構成マネージャを使用して、「アプリケーション」フィールドを更新できます。また、リレーションシップ属性の追加によって、第7.5.2項で説明されているpreferences.hdaファイルのAFRelationshipAttributesセクションにエントリも追加されます。

- 実行時に、添付リレーションシップ属性値は、AFRelationshipAttributes表に格納されます。C.5.3項を参照してください。

次の手順に従って、添付リレーションシップ属性を構成します。

1. コンテンツ・サーバーで、「構成マネージャ」を開き、「アプリケーション・フィールド」タブに移動します。

2. 1つ以上のアプリケーション・フィールドを追加します。

3. 「ルール」タブに移動します。

4. AFRelationshipAttributesルールを編集します。このルールに、手順2で追加したアプリケーション・フィールドを追加します。

5. コンテンツ・サーバーで、「管理」メニューから「管理対象添付ファイル」を選択します。

6. 「管理対象添付ファイルの構成」ページで、ページの下部にある「添付リレーションシップ属性」の設定にスクロールして、「追加」をクリックします。
「添付リレーションシップ属性の追加」ページが表示されます。

図7-8 「添付リレーションシップ属性の追加」ページ

7. 属性のためのフィールドに入力し、「更新」をクリックします。図7-8の例では、Oracle PeopleSoftアプリケーションのWO1ビジネス・オブジェクトのために構成されたリレーションシップ属性(Print)を示します。

要素

説明

例

アプリケーション名

リレーションシップ属性が構成されるビジネス・アプリケーションです。

PSFT_Instance

オブジェクト・タイプ

リレーションシップ属性を使用可能にするビジネス・オブジェクトです。

WO1

属性名

リレーションシップ属性です。

Print

属性のタイプ

属性のタイプ。使用可能なタイプは、テキスト、ロング・テキスト、日付、メモ、整数およびTrueFalseです。

TrueFalse

7.6.11 リビジョン固有モードの構成

デフォルトでは、「管理対象添付ファイル」ページ上の各添付ファイルは、ドキュメントの最も新しいリビジョンへのアクセスを提供します。ただし、ある場合においては、ドキュメントが後でコンテンツ・サーバーで更新された場合でも、添付されたリビジョンへのアクセスを提供するよう、1つ以上のビジネス・エンティティを構成できます。このモードでは、ユーザーは、より新しいリビジョンが存在することを確認し、必要な場合は、それを表示し、それを添付済リビジョンにすることができます。

次の手順に従って、最も新しいリビジョンではなく添付されたリビジョンを表示するようビジネス・エンティティを構成します。

1. コンテンツ・サーバーで、「管理」メニューから「管理対象添付ファイル」を選択します。

2. 「管理対象添付ファイルの構成」ページで、ページの下部にある「エンティティ固有構成」の設定にスクロールして、「追加」をクリックします。
「エンティティ固有構成の追加」ページが表示されます。

図7-9 「エンティティ固有構成の追加」ページでのリビジョン固有モードの構成

3. リビジョン固有モードのためのフィールドに入力し、「構成名」フィールドでAFRevisionSpecificEntitiesを選択し、「更新」をクリックします。図7-9の例では、Oracle E-Business SuiteアプリケーションのCallRecordsビジネス・オブジェクトのために構成されたリビジョン固有モードを示します。

要素

説明

例

アプリケーション名

リレーションシップ属性が構成されるビジネス・アプリケーションです。

EBS_Instance

オブジェクト・タイプ

リレーションシップ属性を使用可能にするビジネス・オブジェクトです。

CallRecords

構成名

リビジョン固有モードを構成するには、AFRevisionSpecificEntitiesを選択します。

Print

フィールド・タイプ

リビジョン固有モードを構成するには、trueを選択します。

true

別の方法としては、次の手順に従って、preferences.hdaファイルを使用してリビジョン固有モードを構成します。

1. preferences.hdaファイルを開き、AFRevisionSpecificEntities結果セットに新しい行を追加します。(一般的な情報については、第7.5.2項を参照してください。)
結果セット内の各行は、次のような、リビジョン固有添付ファイルを使用可能にする1つのビジネス・エンティティを表しています。

- dAFApplicationは、リビジョン機能を使用可能にするビジネス・アプリケーションを参照します。

- dAFBusinessObjectTypeは、リビジョン機能を使用可能にするビジネス・オブジェクトを参照します。

例7-6では、Oracle E-Business SuiteアプリケーションのCallRecordsビジネス・オブジェクトのために構成されたリビジョン固有モードを示します。

例7-6 AFRevisionSpecificEntitiesのカスタマイズ

@ResultSet AFRevisionSpecificEntities
2
dAFApplication
dAFBusinessObjectType
EBS_Instance
CallRecords
@end

7.6.12 結果数の変更

「管理対象添付ファイル」ページは、ページごとに特定の数の添付ファイル結果を表示します(ResultCountと呼ばれる)。結果の数がResultCountを超える場合は、前のページと次のページのコントロールがページに表示されます。管理対象添付ファイルの構成で新しいResultCount値を指定することで、それを別の値(20など)に変更できます。第7.5.1項を参照してください。

7.6.13 結果テンプレートの変更

「管理対象添付ファイル」ページは、その表示を決定するために結果テンプレートを使用します。コンテンツ・サーバーの結果テンプレートでは、管理対照添付ファイルのユーザー・インタフェースが指定されます。アダプタは、次のような結果テンプレートを提供します。

- Oracle E-Business Suiteテンプレートadapter_list_results_template.htmは、EBS_LISTと呼ばれます。

- Oracle PeopleSoftテンプレートps_adapter_list_results_template.htmは、PSFT_LISTと呼ばれます。

- Enterprise Application Adapter Frameworkテンプレートuniversal_adapter_list_results_template.htmは、Universal_LISTと呼ばれます。第7.4.1.2項を参照してください。

次の手順に従って、アプリケーションまたはビジネス・エンティティのための代替の結果テンプレートを識別します。

注意:

結果テンプレートのカスタマイズには、コンテンツ・サーバーの管理およびカスタマイズの高度な知識が必要です。

1. 適切なデフォルト結果テンプレートのコピーを作成し、新しい名前で、できれば新しいコンポーネントに、テンプレートを登録します。

- Oracle E-Business Suiteテンプレートは次の場所にあります。
UCM_HOME/custom/AppAdapterEBS/adapter_list_results_template.htm

- Oracle PeopleSoftテンプレートは次の場所にあります。
UCM_HOME/custom/AppAdapterPSFT/ps_adapter_list_results_template.htm

- Enterprise Application Adapter Frameworkテンプレートは次の場所にあります。
UCM_HOME/custom/AppAdapterUniversal/universal_adapter_list_results_template.htm

2. preferences.hdaファイルで、次のようにAFEnvironmentConfigurationセクションにエントリを追加します。

ResultTemplate
Template Reference
Application Name
Business Entity

例7-7では、WorkOrderビジネス・エンティティのための管理対象添付ファイルへのすべての要求では、デフォルトのOracle E-Business Suiteテンプレートではなく、EBS_WORK_ORDER_LISTカスタム結果テンプレートが使用されます。

例7-7 カスタム結果テンプレートを指定するためのPreferences.hdaエントリ

ResultTemplate
EBS_WORK_ORDER_LIST
EBS_Instance
WorkOrder

7.6.14 デフォルト列の設定

「管理対象添付ファイル」ページでユーザーに表示する、デフォルト列を指定できます。(ユーザーが「表示用にフィールドを構成」ページで「リセット」をクリックすると、デフォルト列がページの「主な情報」セクションにリストされます。)

列のデフォルトは、次のようなタイトル、タイプ、作成者、日付およびリビジョンです。

dDocTitle、dDocType、dDocAuthor、dInDate、dRevision

アプリケーションまたはビジネス・エンティティのための代替のデフォルト列を設定するには、次の手順に従います。

1. preferences.hdaファイルで、AFEnvironmentConfigurationセクションにエントリを追加します。

2. AppAdapterDefaultDisplayColumns構成変数の値を、コンテンツ・サーバーのメタデータ・フィールド名を含むカンマ区切りのリストとして設定します。
例7-8では、最初のエントリは、EBS_Instanceアプリケーションのデフォルト列としてドキュメント・タイトル、タイプ、作成者および日付を設定します。2番目のエントリは、デフォルト列としてリビジョン列(dRevision)を追加することで、CallRecordsビジネス・エンティティのためのこの設定をオーバーライドします。

例7-8 デフォルト列を指定するためのPreferences.hdaエントリ

AppAdapterDefaultDisplayColumns
dDocTitle,dDocType,dDocAuthor,dInDate
EBS_Instance

AppAdapterDefaultDisplayColumns
dDocTitle,dDocType,dDocAuthor,dInDate,dRevision
EBS_Instance
CallRecords

7.6.15 添付ファイルでの紙クリップの有効化(Oracle E-Business Suite Formsのみ)

デフォルトでは、Oracle E-Business Suiteの紙クリップ添付ファイル・オプションは、管理対象添付ファイルの構成の一部として無効化されています。管理対象添付ファイル・ソリューションと共存してこのネイティブのOracle E-Business Suite添付ファイル機能を使用するには、次で説明されているように、紙クリップ・アイコンを再度使用可能にする必要があります。

注意:

この項は、Oracle E-Business Suite Formsを使用する場合のみ適用されます。

1. AXF_PROPERTIES表に次の行を追加します。

表7-14 紙クリップの使用のためのAXF_PROPERTIES値

PROPNAME

PROPVALUE

AXF_PAPERCLIP

紙クリップ・オプションを有効にするにはTRUEに設定し、無効にするにはFALSE (デフォルト)に設定します。(値は大文字である必要があります。)

詳細は、C.2.2項を参照してください。

7.6.16 ビジネス・アプリケーションからコンテンツ・サーバーへの追加のメタデータ値の引渡し

ビジネス・アプリケーションからコンテンツ・サーバーへ追加のメタデータ値を渡し、添付済ドキュメントとともに格納するよう、管理対象添付ファイル・ソリューションを構成できます。たとえば、ユーザーがドキュメントを添付またはスキャンするときに、コンテンツ・チェックイン・ページおよび「ドキュメントのスキャン」ページの請求番号フィールドに値が移入されるよう、アプリケーションから要求番号を渡すことができます。

この機能の手順は次のとおりです。

- メタデータ値がコンテンツ・サーバーに渡されるビジネス・アプリケーション・フィールドが、ビジネス・アプリケーション内に存在する必要があります。たとえば、ビジネス・レコードのサービス・リクエスト番号または主キーを渡すことができます。

- コンテンツ・サーバーの管理対象添付ファイル管理変数を使用して(表7-7および表7-8)、ユーザーがドキュメントをチェックインまたはスキャンするときに値が渡されるフィールドを指定します。これにより、ユーザーのためのコンテンツ・チェックイン・ページまたは「ドキュメントのスキャン」ページの指定されたフィールドに自動入力されます。

- ビジネス・アプリケーションのコマンド・パラメータ表で、渡される追加のメタデータ・フィールドを識別します。

次の手順に従って、渡す追加のメタデータ値を構成します。

1. コンテンツ・サーバーで、「管理」メニューから「管理対象添付ファイル」を選択します。

2. 「グローバル構成」の下で、渡すフィールド名を1つ以上入力します(複数の名前を区切るのにカンマを使用)。

- AppAdapterExtraCheckinMetadataフィールドにフィールド名を入力し、それらの値をコンテンツ・チェックイン・ページに直接渡します。

- AppAdapterExtraScanMetadataフィールドにフィールド名を入力し、それらの値を「ドキュメントのスキャン」ページに直接渡します。

3. ビジネス・アプリケーションのためのコマンド・パラメータ表にアクセスします。

- Oracle E-Business Suite Formsの構成の場合は、AXF_COMMAND_PARAMETERS表(Oracle E-Business Suite Forms)およびAXF_MA_PARAMETERS表(Oracle E-Business Suite Forms)にアクセスして追加パラメータを渡します。

- Oracle E-Business Suite OAFの構成の場合は、OAF_AXF_CMD_PARAMS表(Oracle E-Business Suite OAF)にアクセスします。

- PeopleSoftの構成の場合は、PS_AXF_CMD_PARAMS表にアクセスします。

- Enterprise Application Adapter Frameworkの構成の場合は、第7.6.16.1項を参照してください。

4. labelValue行の追加と同様に、コンテンツ・サーバーに渡される追加の値のための表にエントリを追加します。例7-9で示されているコマンドの例、および表7-15で示されている表の例を参照してください。
コンテンツ・サーバーのフィールド名の先頭にextraを追加して、メタデータごとに行を追加します。たとえば、xReqNumはextraxReqNumになり、dDocTitleはextradDocTitleになります。

注意:

一般には、コンテンツ・サーバーの追加情報フィールドには前に x文字が、標準のものには前に d文字があります。詳細は、『Oracle Fusion Middleware Oracle WebCenter Contentのマネージング』の標準メタデータ・フィールドに関する項を参照してください。

例7-9 OAFコマンド・パラメータ表への追加のメタデータ・フィールドの挿入

Insert into OAF_AXF_CMD_PARAMS (AXF_CMD_PARAMS_ID, AXF_CMDS_ID, AXF_PARAM_NAME, AXF_DATASOURCE,AXF_VIEW_OBJ_NAME, AXF_ATTRIBUTE_NAME,AXF_CONSTANT_VALUE) values (OAF_AXF_CMD_PARAMS_SEQ.NEXTVAL,v_cmdId,'extraxReqNum','DATA','ReqHeaderVO', 'ReqNum',null);

表7-15 追加のメタデータ・フィールドが指定されたOAF_AXF_CMD_PARAMS表の例

AXF_CMD_PARAMS_ID

AXF_CMDS_ID

AXF_PARAM_NAME

AXF_DATASOURCE

AXF_VIEW_OBJ_NAME

AXF_ATTRIBUTE_NAME

AXF_CONSTANT_VALUE

1

1

application

CONSTANT

EBS_instanceA

2

1

businessObjectType

CONSTANT

REQ_HEADERS

3

1

businessObjectKey1

CONSTANT

REQUISITION_HEADER_ID

4

1

businessObjectValue1

DATA

ReqHeaderVO

RequisitionHeaderId

5

1

labelValue1

DATA

ReqHeaderVO

PreparerName

6

1

labelValue2

DATA

ReqHeaderVO

ReqNum

7

1

extraxReqNum

DATA

ReqHeaderVO

ReqNum

7.6.16.1 Enterprise Application Adapter Frameworkを介した値の引渡し

Enterprise Application Adapter Frameworkの場合は、コンテンツ・サーバーのフィールド名の先頭にextraを追加して(xReqNumはextraxReqNumになり、dDocTitleはextradDocTitleになる)、追加のメタデータ値をSOAPエンベロープ本体のリクエスト・パラメータ・セクションの一部として渡します。たとえば、次のようになります。

<entry><key>extraxReqNum</key><value>123456</value></entry>

7.6.17 Oracle PeopleSoftポップアップ・ソリューション・ウィンドウのサイズ変更

ソリューションの一部として表示されるすべてのOracle PeopleSoftポップアップ・ウィンドウのシステム全体のデフォルト・サイズを変更できます。次の点に注意してください。

- デフォルトのポップアップ・ウィンドウ・サイズは高さ600ピクセル、幅800ピクセルです。PS_AXF_PROPERTIES表で設定します。この表でサイズが設定された場合、ユーザーはポップアップ・ウィンドウ・サイズを自分で設定および保存することはできません。

- ウィンドウ・サイズを変更するには、C.4.4項で示されているように、表に新しい値を入力します。

- ポップアップ・ウィンドウ・サイズを削除して、個々のユーザーに、標準のブラウザ・コントロールの使用によるポップアップ・ウィンドウ・サイズの変更と保存を可能にするには、PS_AXF_PROPERTIES表からWINDOW_HEIGHT行とWINDOW_WIDTH行を削除します。

7.6.18 エンティティのプライベート添付ファイル・セキュリティ・グループの構成

ユーザーが管理対象添付ファイルを介してドキュメントをチェックインする際には、第7.7.3項で説明されているように、それらのためにプライベートまたは共有アクセスを選択できます。プライベート・ドキュメントは、AFDocumentsと呼ばれる特別なコンテンツ・サーバー・セキュリティ・グループに自動的に割り当てられます。

次の手順に従って、エンティティ・レベルごとに、オプションでプライベート添付ファイルのためのセキュリティ・グループをオーバーライドし、ドキュメントを代替のセキュリティ・グループに割り当てることができます。

1. コンテンツ・サーバーで、「管理」メニューから「管理対象添付ファイル」を選択します。

2. 「管理対象添付ファイルの構成」ページで、ページの下部にある「エンティティ固有構成」の設定にスクロールして、「追加」をクリックします。
「エンティティ固有構成の追加」ページが表示されます。

図7-10 エンティティ・レベルのプライベート添付ファイル・セキュリティ・グループの構成

3. 図7-10で示されている「エンティティ固有構成の追加」ページで、指定されたビジネス・エンティティに対して使用するためにAppAdapterPrivateSecGroup変数および代替のセキュリティ・グループを識別して、次のように、フィールドに入力します。

- アプリケーション名: 代替セキュリティ・グループを割り当てるアプリケーション

- オブジェクト・タイプ: 代替のセキュリティ・グループを割り当てるビジネス・エンティティ

- 構成名: AppAdapterPrivateSecGroup

- 構成値: 代替セキュリティ・グループ

図7-10で示されている値の例は、ユーザーがプライベート・ドキュメントをExpenseClaimsビジネス・エンティティ(PSFT_Instanceアプリケーション内)に添付する場合に、ClaimsSecurityをセキュリティ・グループとして設定します。

4. 指定されたセキュリティ・グループにロールAFRead、AFWrite、AFDeleteおよびAFAdminを割り当てます(AFDocumentsセキュリティ・グループに割り当てられているロールと同じである必要がある)。

5. config.cfgファイルで、SpecialAuthGroups構成変数に代替セキュリティ・グループを追加します。

7.6.19 管理対象添付ファイルのためのビジネス・アプリケーション・ユーザーのパス・スルーの復元

注意:

この項は、管理対象添付ファイルをBPELインフラストラクチャのためのAXFとともに使用する場合のみ適用されます。BPMインフラストラクチャのためのAXFを使用する場合は適用されません。

第6.4.2項で説明されているように、BPELイメージング・ソリューションでは、Oracle E-Business SuiteまたはOracle PeopleSoftから渡されたユーザーではなく、認証されたOracle WebLogic Serverユーザーを構成してタスクを実行できます。このオプションは、AXF_SOLUTION_ATTRIBUTES表の次のようなUSERNAME_PASS_THROUGHパラメータを介して提供されます。

- TRUE (デフォルト): Oracle E-Business SuiteまたはOracle PeopleSoftから渡されたユーザーを使用してタスクを実行します。

- FALSE: 認証Oracle WebLogic Serverユーザーを使用してタスクを実行します。

注意:

値が指定されない場合、この値はデフォルトでFALSEに設定されます。

管理対象添付ファイル・ソリューションでは、タスクを実行する、Oracle E-Business SuiteまたはOracle PeopleSoftから渡されたユーザーが必要です。管理対象添付ファイルのために第7.2.1項で実行したAXF_ATTACHMENTS_CONFIG.SQLスクリプトは、USERNAME_PASS_THROUGH値をTRUEに設定します。表7-16およびC.1.2項で示されているように、必要な場合は任意の時点で、パラメータの値をTRUEに復元します。

表7-16 管理対象添付ファイルのためのAXF_SOLUTION_ATTRIBUTES表、USERNAME_PASS_THROUGH構成

SOLUTION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

AXF

USERNAME_PASS_THROUGH

TRUE

7.6.20 OAFエンティティのための管理対象添付ファイル・ボタンの名前変更

ローカライズのためなど、Oracle E-Business Suite OAFエンティティのための管理対象添付ファイル・ボタンの名前を変更するには:

1. セットアップ時にOracle E-Business Suite OAF側のMDSリポジトリにインポートされた、ManagedAttachmentButtonRN.xmlファイルを開きます。

2. 次の行を見つけて、Managed Attachmentsをローカライズされた名前と置き換えます。

<oa:button id="MAButton" prompt="Managed Attachments"/>

3. インポート・コマンドを使用して、ファイルをMDSに再度インポートします。

7.7 認証およびセキュリティの構成

この項では、管理対象添付ファイル・ソリューションのための認証およびセキュリティの管理に関する説明を提供します。この項の内容は、次のとおりです。

- 第7.7.1項「管理対象添付ファイルのためのCSF資格証明の構成」

- 第7.7.2項「ユーザー認証の構成」

- 第7.7.3項「ドキュメント・セキュリティの構成」

- 第7.7.4項「AXFとコンテンツ・サーバーの間の通信の保護」

- 第7.7.5項「ビジネス・アプリケーションおよびコンテンツ・サーバー・ユーザーの管理」

7.7.1 管理対象添付ファイルのためのCSF資格証明の構成

管理者ユーザーの資格証明を資格証明ストア・フレームワーク(CSF)に格納する必要があります(別名によって入力され、CSF内の名前付きマップに格納されるユーザー名/パスワードのペア)。CSFに格納されるユーザー名は、Oracle E-Business Suite、Oracle PeopleSoft、またはWebサービス・コール内のEnterprise Application Adapter Frameworkをコールするカスタム・プラグインによって送信されるユーザー名と比較されます。管理者のユーザー名が一致しない場合(C.1.4項を参照)、「管理対象添付ファイル」ページにはアクセスできません。

Enterprise Manger (EM)またはWebLogic Scripting Tool (WLST)を介して資格証明を作成できます。

7.7.1.1 Enterprise Managerの使用による資格証明の作成

1. Enterprise Managerにログインします。

2. 「WebLogicドメイン」の下の自分のドメインを右クリックします。

3. 「セキュリティ」、「資格証明」の順にクリックします。

4. oracle.wsm.securityマップを選択します。存在しない場合は、次の手順に従います。

1. 「マップの作成」を選択します。

2. マップ・フィールドにoracle.wsm.securityと入力し、「OK」をクリックします。

5. oracle.wsm.securityマップを開きます。

6. 「キーの作成」をクリックします。キーを選択できるようになりました。

7. キー名としてMA_CSF_KEYを入力します。

8. 「タイプ」フィールドで「パスワード」を選択します。

9. 有効なOracle WebLogic Server管理者のためのユーザー名およびパスワードを入力します(たとえば、weblogicおよびWelcome1)。
ユーザー名およびパスワードは、ビジネス・アプリケーションによってAXFに渡されます、また、Oracle E-Business Suite (第2.4.1項を参照)、Oracle PeopleSoft (第3.2.2.1項を参照)およびEnterprise Application Adapter Frameworkをコールするカスタム・プラグイン(第7.4.2項を参照)からのWebサービス・コールのために以前に構成済です。

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

7.7.1.2 WLSTの使用による資格証明の作成

1. 次のコマンドを実行します。ここで、usernameおよびpasswordは、ビジネス・アプリケーションからAXFに渡される有効なOracle WebLogic Server管理者のことを指しており、Oracle E-Business Suite (第2.4.1項を参照)、Oracle PeopleSoft (第3.2.2.1項を参照)およびEnterprise Application Adapter Frameworkをコールするカスタム・プラグイン(第7.4.2項を参照)からのWebサービス・コールのために以前に構成されています。
createCred(map="oracle.wsm.security", key="MA_CSF_KEY", user=[username], password=[password])

例:

createCred(map="oracle.wsm.security", key="MA_CSF_KEY", user="weblogic", password="Welcome1")

2. 次のコマンドを実行して、資格証明が正しく作成されたことを確認します。
listCred(map="oracle.wsm.security",key="MA_CSF_KEY")

7.7.2 ユーザー認証の構成

ビジネス・アプリケーション・ユーザーは、サポートされているビジネス・アプリケーション・エンティティ内の「管理対象添付ファイル」ページを表示するためのコンテンツ・サーバー・アカウントを持つ必要があります。また、コンテンツ・サーバーおよびビジネス・アプリケーションのために構成された認証モデルは、ユーザーが、ビジネス・アプリケーション・レコードから管理対象添付ファイルを初めてアクティブ化したときにどのように認証されるかを決定します。

- シングル・サインオン用に構成されたコンテンツ・サーバー: ビジネス・アプリケーションがシングル・サインオン用に構成されていない場合は、コンテンツ・サーバーのシングル・サインオン・ログイン・プロンプトが表示されます。(ビジネス・アプリケーションがシングル・サインオン用に構成されている場合、ユーザーは認証されているため、ログイン・プロンプトは表示されません。)

- シングル・サインオン用に構成されていないコンテンツ・サーバー: 選択したビジネス・アプリケーション認証モデルに関係なく、コンテンツ・サーバーのログイン・プロンプトが表示されます。

注意:

第7.7項で説明されているように、セキュリティ・チェックが正しく構成されている場合は、.AXFのためにユーザー認証は必要ありません。

7.7.3 ドキュメント・セキュリティの構成

ドキュメントを管理対象添付ファイルのユーザー・インタフェースを介してコンテンツ・サーバーにチェックインする際に、ユーザーは、次の2つのモードのいずれかを選択することでアクセスを指定します。

- プライベート(共有ではない): ユーザーは、管理対象添付ファイルのユーザー・インタフェース介して、関連するビジネス・アプリケーション・エンティティ画面を使用してのみ、これらのドキュメントにアクセスできます。ユーザー(ドキュメントをチェックインするユーザーを含む)は、他の標準のコンテンツ・サーバー・ユーザー・インタフェースを使用してプライベート・ドキュメントを検索したりそれらにアクセスしたりすることはできません。これは、管理対象添付ファイルのユーザー・インタフェースを介して新しいドキュメントをチェックインする際のデフォルトのセキュリティ・モードです。

注意:

AppAdapterCheckinPrivateグローバル構成変数は、コンテンツ・チェックイン・ページの「共有ドキュメント」フィールドをデフォルトで選択解除する(プライベート・チェックインのために設定される)かどうかを決定します。詳細は、第7.5.1項を参照してください。

注意:

プライベート(共有ではない)ドキュメントは、AFDocumentsと呼ばれる特別なセキュリティ・グループに自動的に割り当てられます。また、ビジネス・アプリケーション・エンティティにアクセスできるユーザーは、管理対象添付ファイルのユーザー・インタフェースを起動する際に、ドキュメントへの一時アクセス権を付与されます。AppAdapterPrivateSecGroup変数により、エンティティ・レベルごとにセキュリティ・グループをオーバーライドして、プライベート添付ファイルのために使用し、代替グループにそれらを割り当てることができます。詳細は、第7.6.18項を参照してください。

ある例外的なケースでは、管理者は、AFDocumentsセキュリティ・グループのためのAFRead、AFWrite、AFDeleteまたはAFAdminロールを永続的に割り当てることで、特別なユーザーにAFDocumentsセキュリティ・グループへの直接アクセス権を付与できます。その場合、ユーザーは、標準の任意のコンテンツ・サーバー・ユーザー・インタフェースを介してプライベート・ドキュメントにアクセスできます。

- 共有: これらのドキュメントは、セキュリティがコンテンツ・サーバーによって管理されるため、プライベート・ドキュメントよりも容易にアクセスされます。ドキュメントの割当て済セキュリティ・グループ・アクセス権があるコンテンツ・サーバー・ユーザーは、管理対象添付ファイルのユーザー・インタフェースを介して関連するビジネス・アプリケーション・エンティティ画面を使用してアクセスするだけでなく、標準の任意のコンテンツ・サーバー・ユーザー・インタフェースを使用してドキュメントを検索し、それらにアクセスできます。

注意:

ユーザーは、AutoVueでのみ共有ドキュメントを表示できます(構成されている場合)。プライベート・ドキュメントは表示できません。詳細は、7.8項を参照してください。

7.7.4 AXFとコンテンツ・サーバーの間の通信の保護

次の手順に従って、AXFが実行されているホストとコンテンツ・サーバーの間の信頼された通信を使用可能にします。コンテンツ・サーバーでは、この構成手順のための2つのオプションがあります。System Propertiesアプリケーションの使用またはconfig.cfgファイルの編集のどちらかです。

7.7.4.1 コンテンツ・サーバーのSystem Propertiesアプリケーションの使用

1. コンテンツ・サーバー・インスタンスのためのSystem Propertiesユーティリティを開きます。

2. 「サーバー」タブを選択します。

3. 「ホスト名フィルタ」フィールドに名前を入力するか「IPアドレス・フィルタ」フィールドにアドレスを入力することで、AXFホストを識別します。

4. 「OK」をクリックし、コンテンツ・サーバーを再起動します。

7.7.4.2 コンテンツ・サーバーのConfig.cfgファイルの編集

1. config.cfgファイルを開きます。

2. SocketHostAddressSecurityFilterエントリを見つけ、AXFが実行されているシステムのIPアドレスを含むようそれを編集します。

3. コンテンツ・サーバーを再起動します。

7.7.5 ビジネス・アプリケーションおよびコンテンツ・サーバー・ユーザーの管理

管理対象添付ファイルへのアクセスのためにOracle E-Business Suite、Oracle PeopleSoftまたは別のビジネス・アプリケーションのユーザーを管理する場合は、次のガイドラインを覚えておいてください(たとえば、シングル・サインオンを使用して中央リポジトリでユーザーを管理する場合)。

- ビジネス・アプリケーション・ユーザーが管理対象添付ファイル機能にアクセスするには、Oracle E-Business Suite、Oracle PeopleSoftまたは別のビジネス・アプリケーションのユーザー名MUSTをコンテンツ・サーバー・ユーザー名と一致させます。

- コンテンツ・サーバーのユーザーを作成する場合は(グローバルまたはローカル)、AFRead、AFWrite、AFDeleteまたはAFAdminロールを割り当てないでください。
アダプタは、ユーザーにロールを動的に割り当てます。ロールは、AF_GRANT_ACCESSサービスが呼び出されたときに、dPrivilegeの値に基づいてユーザーに付与されます(C.5.1項を参照)。または、指定されない場合は、構成値AppAdapterGrantPrivilegeの値に基づきます(第7.5項を参照)。権限(R、W、DまたはA)に基づいて、定義済のロールが動的にユーザーに割り当てられます。

注意:

システムからAFRead、AFWrite、AFDelete、AFAdminロールを削除しないでください。

7.8 Oracle AutoVue Document Viewingの構成

この項の内容は次のとおりです。

- 第7.8.1項「Oracle AutoVueの構成について」

- 第7.8.2項「Oracle VueLink for Content Serverの要件」

- 第7.8.3項「アダプタのためのAutoVueの有効化」

7.8.1 Oracle AutoVueの構成について

「管理対象添付ファイル」ページのためのデフォルトのドキュメント表示オプションは、コンテンツ・サーバーによって提供される標準のWebレンディションです。拡張表示オプションの場合、アダプタは、VueLink for Content Serverを介してOracle AutoVueもサポートします。実質的にどのドキュメント・タイプの非プライベート添付ファイルでも、表示、印刷、コラボレーション、アノテーションおよびマークアップのために使用可能であり、Webテクノロジを使用してセキュアに提供されます。

AutoVue/アダプタの統合についての重要点

- 構成されている場合、ユーザーは、AutoVueを介してすべての非プライベート添付ファイルを表示できます。共有ドキュメント対プライベート・ドキュメントの詳細は、第7.7.2項を参照してください。

- VueLink統合は、表示、デジタル・マークアップおよびコラボレーションのためにコンテンツ・サーバー・リポジトリからAutoVueへドキュメントをセキュアに流すブリッジの役割を果たします。デジタル・マークアップは、コンテンツ・サーバー・リポジトリに保存され、添付されたドキュメントに関連付けられます。

- デフォルトでは、AutoVueは、管理対象添付ファイル・ソリューションではオフになっています。AutoVueアイコンを表示して、ユーザーが「AutoVueで表示」アイコンをクリックしたときに起動するようAutoVueサーブレットへのURLを識別することで、「管理対象添付ファイルの構成」ページでそれをアクティブ化します。

- 他のプリファレンス設定と同様に、AutoVue統合をグローバル、アプリケーションおよびビジネス・エンティティ・レベルで有効にできます。

- AutoVueは、コンテンツ・サーバーに対するユーザー認証を信頼します。コンテンツ・サーバーに認証されたら、ユーザーがAutoVueを使用して添付済ドキュメントを表示するためのAutoVueへの認証はもう必要ありません。

- AutoVueでのドキュメントの表示またはアノテーションによって、それがチェックアウトされることやそれを他のユーザーが編集できないようになることはありません。アノテーションは、それらの対応するドキュメントとは別のレイヤーに含まれます。

7.8.2 Oracle VueLink for Content Serverのための要件

この項では、AutoVue表示とコンテンツ・サーバーとの統合のための要件をリストします。特定のリリースの要件については、次の場所にある構成および動作保障情報を参照してください。

http://www.oracle.com/technetwork/middleware/webcenter/content/documentation/documentation-155348.html

注意:

この項でリストされる要件は、Oracle AutoVueを介してオプションのドキュメント表示にアダプタを提供する場合のみ適用されます。

注意:

管理対象添付ファイルのためのAutoVueオプションは、WebSphere Application Serverではサポートされていません。

要件は、次のとおりです。

- Oracle AutoVue (および適用できる任意のサービス・パック)。

- Oracle VueLink for Content Server、コンテンツ・サーバーのためのAutoVue VueLink統合(この統合のためにシステム管理者ドキュメントも参照してください。)

7.8.3 アダプタのためのAutoVueの有効化

次の手順に従って、AutoVueドキュメント表示をグローバルに、または特定のアプリケーションやビジネス・エンティティのために使用可能にして構成します。

1. コンテンツ・サーバー/AutoVueの統合を構成します。
Oracle VueLink 20 for Oracle UCMシステム管理者マニュアルで説明されている手順に従います。

2. コンテンツ・サーバーで、「管理」メニューから「管理対象添付ファイル」を選択します。

3. 「管理対象添付ファイルの構成」ページで、AppAdapterAutoVueIconVisible変数をTrueに設定することで、AutoVueアイコンのグローバルな表示を有効にします。一般的な情報については、第7.5項を参照してください。

4. 「AutoVueURLPath」フィールドで、次の形式を使用して、実行するAutoVueサーブレットを指定します。

http://ucm_host name:port/web_root/idcplg?IdcService=VIEW_IN_AUTOVUE

たとえば、次のようになります。

http://ucm1.example.com/cs/idcplg?IdcService=VIEW_IN_AUTOVUE

5. オプションで、次のようにAppAdapterAutoVueIconVisible変数およびAutoVueURLPath変数のためのAFEnvironmentConfiguration結果セットに新しい行を追加することで、アプリケーションまたはビジネス・エンティティの設定を指定します。

- dAFApplication: ボタンを表示または非表示にするアプリケーション

- dAFBusinessObjectType: ボタンを表示または非表示にするアプリケーション内のビジネス・エンティティ

例7-9には、いくつかのAutoVue設定が含まれています。「AutoVueで表示」アイコンがグローバルにfalseに設定されていると仮定します。最初の2つのエントリは、PSFT_Instance_Aアプリケーションのためのアイコンを使用可能にして表示します。最後の2つのエントリは、PSFT_Instance_Bアプリケーションのためのアイコンを使用可能にして表示しますが、そのPIMビジネス・エンティティ内のみとなります。

図7-11 AutoVue Document Viewingの例

7.9 Oracle WebCenter Captureの構成

この項の内容は次のとおりです。

- 第7.9.1項「Oracle WebCenter Captureの使用によるドキュメント・スキャンについて」

- 第7.9.2項「Oracle WebCenter Captureおよび関連するコンポーネントの要件」

- 第7.9.3項「アダプタのためのOracle WebCenter Captureの構成」

- 第7.9.4項「アダプタを介したWebCenter Captureのためのコンテンツ・サーバーの構成」

- 第7.9.5項「アダプタ構成を介したOracle WebCenter Captureのテスト」

注意:

このアダプタとのOracle WebCenter Captureの使用に固有のインストール要件については、第7.9.2項を参照してください。

7.9.1 Oracle WebCenter Captureの使用によるドキュメント・スキャンについて

Oracle WebCenter Captureアプリケーションにより、アダプタなどのアプリケーションが、ドキュメントをスキャンしてドキュメントメタデータ値を渡すよう指示することができるようになります。これにより、ユーザーは、ドキュメントをスキャンしたり、ファイル(PDFやMicrosoft Wordファイルなどのイメージ・ファイルまたはイメージ以外のファイル)を「管理対象添付ファイル」ページからインポートして、選択したビジネス・アプリケーション・レコードに添付することができます。

アダプタのために構成されている場合、ドキュメント・スキャンは次のように機能します。

- 「管理対象添付ファイル」に「スキャン」ボタンが追加されます。ユーザーがそのボタンをクリックし、「ドキュメント分類」や「セキュリティ・グループ」などのオプション(Oracle WebCenter Captureクライアント・プロファイルに割り当てられる)を選択します。たとえば、ユーザーは、Identity Documentsの分類を選択して、運転免許証またはパスポートのコピーをスキャンできます。(Oracle WebCenter Captureクライアント・プロファイルは、スキャン、インポートおよび索引作成の設定を指定します。)また、ユーザーは、ドキュメントを共有する必要があるかどうかも指定します。必要がある場合、ユーザーは、アクセスできるセキュリティ・グループから共有ドキュメントのためのセキュリティ・グループを指定します。

- ユーザーが「ドキュメントのスキャン」ボタンをクリックすると、Oracle WebCenter Captureのクライアントが新しいウィンドウで起動され、使用するクライアント・プロファイルや後で添付するためのビジネス・アプリケーション・エンティティの値などのパラメータを渡します。

- Oracle WebCenter Captureクライアント内で、ユーザーは、ドキュメントを確認し、必要に応じて変更し、クライアント・プロファイル内で構成された任意のメタデータ・フィールドに入力してから、バッチをリリースします。バッチをリリースすると、WebCenter Contentに出力するように構成されたCaptureコミット・プロファイルを使用して、コンテンツ・サーバーに新しいドキュメントがコミットされます。(コンテンツ出力用に構成されたCaptureコミット・プロファイルは、WebCenter CaptureとContent Serverメタデータ・フィールドの間の接続情報およびフィールド・マッピングを指定します。)

- バッチ・リリースが成功すると、ユーザーは、「管理対象添付ファイル」ページに戻り、新しくスキャンされたドキュメントまたはインポートされたファイルを表示するよう表示をリフレッシュします。

7.9.2 Oracle WebCenter Captureおよび関連するコンポーネントの要件

この項では、Oracle WebCenter Captureでのスキャンおよびインポート機能の実装ための要件を一覧します。ブラウザなどのシステム要件を満たすためには、次の場所にある構成および動作保障情報を参照してください。

http://www.oracle.com/technetwork/middleware/webcenter/content/documentation/documentation-155348.html

注意:

この項で示す要件は、オプションのスキャン機能のためにOracle WebCenter Captureを使用する場合のみ適用されます。

要件は、次のとおりです。

- Oracle WebCenter Capture 11g

7.9.3 アダプタのためのOracle WebCenter Captureの構成

次の手順に従って、Oracle WebCenter Capture側での添付ファイルのスキャンを構成します。

1. 必要に応じて、Oracle WebCenter Capture用にシングル・サインオン(SSO)を構成します。
アダプタおよびWebCenter CaptureがOracle Access Manager (OAM)で構成されているかぎり、CaptureのユーザーをSSOによって認証できます。

2. Captureワークスペース・コンソールで、図7-12に示すように、新しいドキュメントに値をキャプチャするため、選択したワークスペースにメタデータ・フィールドを追加します。詳細は、Oracle Fusion Middleware Oracle WebCenter Captureの管理のワークスペース要素に関する項を参照してください。

1. 値のためのメタデータ・フィールドを作成し、コンテンツ・サーバー上に添付済ドキュメントとともに保存します。たとえば、ユーザーが標準のドキュメント・タイプから選択するための、「ドキュメント・タイプ」および「セキュリティ・グループ」選択リスト・メタデータ・フィールドを構成できます。

2. ビジネス・アプリケーション・エンティティの値および必要なフィールドを含むよう、次の英数字のメタデータ・フィールドを作成します。

- dAFApplication

- dAFBusinessObjectType

- dAFBusinessObject

- dSecurityGroup

図7-12 WebCenter Capture、メタデータ・フィールド

3. ワークスペースの「分類」タブで、図7-13に示すように、アダプタ・メタデータ・フィールドのドキュメント・プロファイルを作成します。詳細は、Oracle Fusion Middleware Oracle WebCenter Captureの管理のドキュメント・プロファイルに関する項を参照してください。

図7-13 WebCenter Capture、ドキュメント・プロファイル

注意:

一般には、ユーザーに表示するためにビジネス・アプリケーション・エンティティ・フィールド(たとえば、dAFBusinessObject)を選択しません。表示するように選択した場合には、メタデータ設定の下でロックして、ユーザーが値を変更できないようにします。

4. 「キャプチャ」タブで、図7-14に示すように、クライアント・プロファイルを作成します。後でこのクライアント・プロファイルを1つ以上のドキュメント分類に関連付けます。そのため、ユーザーが分類を選択する際に、関連付けられたクライアント・プロファイルの設定が使用されます。詳細は、Oracle Fusion Middleware Oracle WebCenter Captureの管理のクライアント・プロファイルに関する項を参照してください。

1. 「一般設定」トレイン・ストップの「プロファイル・タイプ」フィールドで「2 - キャプチャと索引」を選択します。このキャプチャ・タイプには、キャプチャ(スキャンまたはインポート)および索引付けが含まれます。クライアント・プロファイルのプロファイル名とバッチ・プレフィクスを指定します。

2. 「ドキュメント索引付け設定」トレイン・ストップで、手順3で作成したアダプタ・ドキュメント・プロファイルを選択します。「メタデータ」タブでデータベース参照プロファイルを作成した場合、オプションでこれを選択できます。

3. 「送信」をクリックし、クライアント・プロファイルを保存します。

図7-14 WebCenter Capture、クライアント・プロファイル

5. 「コミット」タブで、Oracle WebCenter Contentコミット・プロファイルを作成し、完了したバッチをユーザーがリリースする際にコンテンツ・サーバーにスキャン済ドキュメントまたはインポート済ドキュメントをコミットします。
このコミット・プロファイルは、コンテンツ・サーバーへの接続方法およびビジネス・アプリケーションとCapture値がコンテンツ・サーバーにどのように渡されるかを指定します。コンテンツ・サーバー・コミット・プロファイルの作成の詳細は、Oracle Fusion Middleware Oracle WebCenter Captureの管理のプロファイルのコミットに関する項を参照してください。

1. 「一般設定」トレイン・ストップの「コミット・ドライバ」フィールドで「WebCenter Content」を選択します。この統合については、「ドキュメント出力形式」フィールドでPDFイメージのみを選択することをお薦めします。「コミットをドキュメント・プロファイルに制限」フィールドで、手順3で作成したドキュメント・プロファイルを選択します。

2. 「ログイン」タブで、コンテンツ・サーバー・インスタンスへのログインのための設定を指定します。(他のタブは、ログイン後にアクティブになります。)コンテンツ・サーバーのURLのために次の形式を使用します。
http://コンテンツ・サーバー・ホスト名またはIPアドレス:WebServerPort/ucm web root/idcplg

指定されたコンテンツ・サーバー・ユーザーは、AFDocumentsセキュリティ・グループのためにAFWriteロールを割り当てられる必要があります。管理対象添付ファイル・ソリューションのために予約されるAFDocumentsセキュリティ・グループへの書き込みアクセス権を一般ユーザーが取得しないようにするために、この目的で管理対象添付ファイル・ソリューション固有の特別なCaptureユーザーを作成することをお薦めします。AFDocumentsグループの詳細は、第7.7.3項を参照してください。

3. 「チェックイン」タブで、「動的に値を割り当てる」フィールドおよび「フィールド・マッピング別」フィールドを選択します。また、「ドキュメント・タイトル」フィールドで名前を付ける方法も指定します。

4. 図7-15で示されているように、「フィールド・マッピング」タブの「カスタム・フィールド」表で「追加」アイコンをクリックし、次のカスタム・フィールドを追加します。

- dAFApplication

- dAFBusinessObjectType

- dAFBusinessObject

追加したカスタム・フィールドが、「フィールド・マッピング」タブに表示されます。新しいコンテンツ・サーバー・ドキュメントをビジネス・アプリケーション・エンティティに添付するために必要なため、手順2で作成した対応するメタデータ・フィールドにこれらのカスタム・フィールドをマップします。また、値をコンテンツ・サーバー・フィールドに書き込みたいその他のCaptureフィールドもマップします。

5. 「オプション」タブで追加の設定を指定します。

図7-15 WebCenter Content、フィールド・マッピング

7.9.4 アダプタを介したWebCenter Captureのためのコンテンツ・サーバーの構成

次の手順に従って、コンテンツ・サーバー側で添付ファイルのスキャンを構成します。

1. コンテンツ・サーバーで、Oracle WebCenter Captureのための次の構成変数を編集します(まだ行っていない場合)。第7.5項を参照してください。

- ODDCURLPath
http://capture_host:port/dc-client

- ODDCScanAction
ODDC Scan Action

- AdapterAppScanBtnVisible
true

2. コンテンツ・サーバーを再起動します。

3. コンテンツ・サーバーで、ドキュメント分類およびスキャン・タイプを構成します。

1. コンテンツ・サーバーの「管理」トレイから、「管理アプレット」リンクをクリックします。

2. 「構成マネージャ」アプレットを選択します。構成マネージャが表示されます。

3. 「ビュー」タブをクリックし、アルファベット順のリストから適切なドキュメント分類ビューを選択し(Oracle E-Business Suiteの場合はEBSDocClassView、Oracle PeopleSoftの場合はPSFTDocClassView、またはEnterprise Application Adapter Frameworkの場合はUniversalDocClassView)、「値の編集」をクリックします。

4. 「値の編集」ダイアログ・ボックスで「追加」をクリックし、ドキュメントの分類と対応するクライアント・プロファイルを指定します。documentClassificationエントリは一意である必要がありますが、クライアント・プロファイルは複数回使用できることに注意してください。「閉じる」をクリックします。

5. 「オプション」メニューから、「スキーマのパブリッシュ」を選択してデータをパブリッシュします。

7.9.5 アダプタ構成を介したOracle WebCenter Captureのテスト

次の手順に従って、エンド・ユーザーとして構成をテストします。Oracle WebCenter Captureを使用してエンド・ユーザーとしてスキャンする方法の詳細は、『Oracle Fusion Middleware Oracle WebCenterアプリケーション・アダプタの使用』を参照してください。

1. 「管理対象添付ファイル」結果ペインをリフレッシュします。「新規」ボタンの横に「スキャン」ボタンが表示されている必要があります。

2. 「スキャン」をクリックします。「ドキュメントのスキャン」ページで、ドキュメント分類およびセキュリティ・グループを選択し、「ドキュメントのスキャン」をクリックします。Oracle WebCenter Captureクライアントが起動します。
URLは、クライアントを実行するために指定した設定を反映することに注意してください。また、それはクライアント・プロファイル、スキャン・アクション(1 = スキャンおよび2 = インポート)、およびOracle E-Business SuiteまたはOracle PeopleSoftのエンティティ値を含むメタデータを渡します。

3. Oracle WebCenter Captureクライアント内で、ドキュメントのバッチを確認し、索引を作成し、リリースします。

4. 「管理対象添付ファイル」ページに戻り、「リフレッシュ」をクリックします。新しくスキャンしたドキュメントまたはインポートしたスキャン済ファイルが、リスト内に表示されるはずです。(表示には数分かかる可能性があります。)

7.10 Oracle Distributed Document Captureの構成

この項の内容は次のとおりです。

- 第7.10.1項「Oracle Distributed Document Captureの使用によるドキュメント・スキャンについて」

- 第7.10.2項「Oracle Distributed Document Captureおよび関連するコンポーネントの要件」

- 第7.10.3項「アダプタのためのOracle Distributed Document Captureの構成」

- 第7.10.4,項「アダプタを介したDistributed Document Captureのためのコンテンツ・サーバーの構成」

- 第7.10.5項「アダプタ構成を介したOracle Distributed Document Captureのテスト」

注意:

このアダプタとのOracle Distributed Document Captureの使用に固有のインストール要件については、第7.10.2項を参照してください。

7.10.1 Oracle Distributed Document Captureの使用によるドキュメント・スキャンについて

Oracle Distributed Document Captureアプリケーションにより、アダプタなどのアプリケーションが、ドキュメントをスキャンしてドキュメント索引値を渡すよう指示することができるようになります。これにより、ユーザーは、ドキュメントをスキャンすることや、スキャンしたイメージを「管理対象添付ファイル」ページからインポートして、選択したビジネス・アプリケーション・レコードにそれらを添付することができます。

アダプタのために構成されている場合、ドキュメント・スキャンは次のように機能します。

- 「管理対象添付ファイル」に「スキャン」ボタンが追加されます。ユーザーがそのボタンをクリックし、「ドキュメント分類」などのオプション(Oracle Distributed Document Captureスキャン・プロファイルに割り当てられる)を選択します。たとえば、ユーザーは、Identity Documentsの分類を選択して、運転免許証またはパスポートのコピーをスキャンできます。(Oracle Distributed Document Captureスキャン・プロファイルは、スキャン、インポートおよび索引作成の設定を指定します。)また、ユーザーは、ドキュメントを共有する必要があるかどうかも指定します。必要がある場合、ユーザーは、アクセスできるセキュリティ・グループから共有ドキュメントのためのセキュリティ・グループを指定します。

- ユーザーが「ドキュメントのスキャン」ボタンをクリックすると、Oracle Distributed Document Captureのリモート・クライアントが新しいウィンドウで起動され、ユーザーを自動的に認証してログインさせ(構成されている場合)、使用するスキャン・プロファイルや後で添付するためのビジネス・アプリケーション・エンティティなどのパラメータを渡します。

- Oracle Distributed Document Captureクライアント内で、ユーザーは、ドキュメントを確認し、必要に応じて変更し、スキャン・プロファイル内で構成された任意の索引フィールドに入力してから、バッチを送信します。バッチの送信により、スキャン・プロファイルのために指定されたコミット・プロファイルを使用して、新しいドキュメントがContent Server 11gにコミットされます。(Capture/Content Serverコミット・プロファイルは、CaptureとContent Serverメタデータ・フィールドの間の接続情報およびフィールド・マッピングを指定します。)

- 送信が成功すると、ユーザーは、「管理対象添付ファイル」ページに戻り、新しくスキャンされたドキュメントまたはインポートされたスキャン済イメージ・ファイルを表示するよう表示をリフレッシュします。

7.10.2 Oracle Distributed Document Captureおよび関連するコンポーネントの要件

この項では、スキャンの実装およびOracle Distributed Document Captureでの機能のインポートのための要件をリストします。ブラウザなどのシステム要件を満たすためには、次の場所にある構成および動作保障情報を参照してください。

http://www.oracle.com/technetwork/middleware/webcenter/content/documentation/documentation-155348.html

注意:

この項でリストされる要件は、オプションのスキャン機能のためにOracle Distributed Document Captureを使用する場合のみ適用されます。

要件は、次のとおりです。

- Oracle Distributed Document Capture Release 10.1.3.5.1以降(Oracle UCM 11g Commit Driverを含む(このリリースでのインストールのために提供される))。Oracle UCM 11g Commit Driverは、Oracle Distributed Document CaptureからOracle WebCenter Content Server 11gにドキュメントをコミットするために必要です。

- エンド・ユーザーのためのInternet Explorer 6以上。

7.10.3 アダプタのためのOracle Distributed Document Captureの構成

次の手順に従って、Oracle Distributed Document Capture側での添付ファイルのスキャンを構成します。

1. オプションで、自動ログインのためにOracle Distributed Document Captureを設定します。
図7-16で示されているDistributed Document Captureの「サーバーの構成」アプリケーションの「システム設定」タブで、「認証メソッド」オプションからWebサーバー認証済アクセスを選択します。この設定により、ユーザーがログインする必要なく、クライアントを自動的に起動できます。詳細は、Oracle Distributed Document Captureインストレーション・ガイドの認証に関する項を参照してください。

図7-16 Distributed Document Capture Server Configuration、「システム設定」タブ

2. 図7-17で示されているように、取得管理で、新規ドキュメントのための値を取得するために、選択されたファイル・キャビネットへ索引フィールドを追加します。詳細は、Oracle Distributed Document Capture管理者ガイドの取得管理に関する項を参照してください。

1. 値のための索引フィールドを作成し、コンテンツ・サーバー上に添付済ドキュメントとともに保存します。たとえば、ユーザーが標準のドキュメント・タイプから選択するための、ドキュメント・タイプ選択リスト索引フィールドを構成できます。

2. ビジネス・アプリケーション・エンティティの値および必要なフィールドを含むよう、次の英数字の索引フィールドを作成します。

- dAFApplication

- dAFBusinessObjectType

- dAFBusinessObject

- dSecurityGroup

- Title

図7-17 Captureの「管理」の「索引」フィールド

3. 図7-18で示されているように、Oracle Distributed Document Captureのプロファイル管理で、スキャン・プロファイルを作成します。後でこのスキャン・プロファイルを1つ以上のドキュメント分類に関連付けます。そのため、ユーザーが分類を選択する際に、関連付けられたスキャン・プロファイルの設定が使用されます。詳細は、Oracle Distributed Document Capture管理者ガイドのスキャン・プロファイルに関する項を参照してください。

1. 「一般」ペインの「スキャン・タイプ」フィールドで2 - ドキュメントのスキャンおよび索引作成を選択します。このスキャン・タイプは索引作成を含み、ページをスキャンするか、バッチで単一のドキュメントにインポートします。ファイル・キャビネットおよびバッチ・プリフィックスを指定します。

図7-18 スキャン・プロファイル、Oracle Distributed Document Captureプロファイルの管理

2. 「ドキュメント索引付け」ペインで、ユーザーに表示するすべてのフィールドを「選択したフィールド」ボックスに移動します。ユーザーが入力するための「タイトル」フィールドを表示し、そのフィールドを必須にすることをお薦めします。

注意:

一般には、ユーザーに表示するためにビジネス・アプリケーション・エンティティ・フィールド(たとえば、dAFBusinessObject)を選択しません。それらを表示することを選択する場合は、「フィールドのプロパティ」ペインでそれらをロックし、ユーザーがそれらの値を変更できないようにします。

図7-19 スキャン・プロファイル、Oracle Distributed Document Captureプロファイルの管理

3. 「フィールドのプロパティ」ペイン、「自動入力」ペインおよび「データベース参照」ペインで、索引作成に必要な任意のピック・リスト、データベース参照または自動移入を構成します。スキャン・プロファイルを保存します。

4. Capture管理で、Oracle UCM 11g (コンテンツ・サーバー)コミット・プロファイルを作成し、完了したバッチをユーザーが送信する際にコンテンツ・サーバーにスキャン済ドキュメントまたはインポート済ドキュメントをコミットします。
このコミット・プロファイルは、コンテンツ・サーバーへの接続方法およびビジネス・アプリケーションとCapture値がコンテンツ・サーバーにどのように渡されるかを指定します。コンテンツ・サーバー・コミット・プロファイルの作成の詳細は、Oracle Distributed Document Capture管理者ガイドのコミット・プロファイルに関する項を参照してください。

1. コミット・ドライバ・フィールドのOracle UCM 11g Commit Driverを選択します。この統合については、「ドキュメント出力形式」フィールドでPDF - イメージのみを選択することをお薦めします。コミット・ドライバ・フィールドに隣接した「構成」ボタンをクリックします。

図7-20 コミット・プロファイル設定

2. 「ログイン」タブで、コンテンツ・サーバー・インスタンスへのログインのための設定を指定します。(他のタブは、ログイン後にアクティブになります。)コンテンツ・サーバーのURLのために次の形式を使用します。
http://コンテンツ・サーバー・ホスト名またはIPアドレス:WebServerPort/ucm web root/idcplg

指定されたコンテンツ・サーバー・ユーザーは、AFDocumentsセキュリティ・グループのためにAFWriteロールを割り当てられる必要があります。管理対象添付ファイル・ソリューションのために予約されるAFDocumentsセキュリティ・グループへの書き込みアクセス権を一般ユーザーが取得しないようにするために、この目的で管理対象添付ファイル・ソリューション固有の特別なCaptureユーザーを作成することをお薦めします。AFDocumentsグループの詳細は、第7.7.3項を参照してください。

3. 図7-21で示されているように、「チェックイン」タブで、「動的に値を割り当てる」フィールドおよび「フィールド・マッピング別」フィールドを選択します。「ドキュメント・タイトル」フィールドで名前を付ける方法を指定します。

図7-21 Captureの管理、コンテンツ・サーバーのコミット設定の「チェックイン」

4. 「フィールド・マッピング」タブで、「カスタム・フィールドの追加/編集」ボタンをクリックし、図7-22で示されている「カスタム・フィールドの追加/編集」ダイアログ・ボックスに次のカスタム・フィールドを追加します。

- dAFApplication

- dAFBusinessObjectType

- dAFBusinessObject

図7-22 Captureの管理、「カスタム・フィールドの追加/編集」

「OK」をクリックします。追加したカスタム・フィールドが、図7-23で示されている「フィールド・マッピング」タブに表示されます。新しいコンテンツ・サーバー・ドキュメントをビジネス・アプリケーション・エンティティに添付するために必要なため、手順2で作成した対応する索引フィールドにこれらのカスタム・フィールドをマップします。また、値をコンテンツ・サーバー・フィールドに書き込みたいその他のCaptureフィールドもマップします。「OK」をクリックします。

5. 「管理」ツリーから「コミット・プロファイル」をクリックし、コミット・プロファイルのために「アクティブ」チェック・ボックスを選択することで、ビジネス・アプリケーション-コンテンツ・サーバー・コミット・プロファイルをアクティブ化します。

図7-23 Captureの管理、コンテンツ・サーバー・コミット設定のためのフィールド・マッピング

7.10.4 アダプタを介したDistributed Document Captureのためのコンテンツ・サーバーの構成

次の手順に従って、コンテンツ・サーバー側で添付ファイルのスキャンを構成します。

1. コンテンツ・サーバーで、Oracle Distributed Document Captureのための次の構成変数を編集します(まだ行っていない場合)。第7.5項を参照してください。

- ODDCURLPath
http://ODDC_host/ODDC_webcapture_address

- ODDCScanAction
ODDC Scan Action

- AdapterAppScanBtnVisible
true

2. コンテンツ・サーバーを再起動します。

3. コンテンツ・サーバーで、ドキュメント分類およびスキャン・タイプを構成します。

1. コンテンツ・サーバーの「管理」トレイから、「管理アプレット」リンクをクリックします。

2. 構成マネージャ・アプレットを選択します。構成マネージャが表示されます。

3. 「ビュー」タブをクリックし、アルファベット順のリストから適切なドキュメント分類ビューを選択し(Oracle E-Business Suiteの場合はEBSDocClassView、Oracle PeopleSoftの場合はPSFTDocClassView、またはEnterprise Application Adapter Frameworkの場合はUniversalDocClassView)、「値の編集」をクリックします。

4. 「値の編集」ダイアログ・ボックスで、「追加」をクリックし、ドキュメント分類およびそれらに対応するスキャン・プロファイルを追加します。documentClassificationエントリは一意である必要がありますが、スキャン・プロファイルは複数回使用できることに注意してください。終了したら、「閉じる」をクリックします。

5. 「オプション」メニューから、「スキーマのパブリッシュ」を選択してデータをパブリッシュします。

7.10.5 アダプタ構成を介したOracle Distributed Document Captureのテスト

次の手順に従って、エンド・ユーザーとして構成をテストします。詳細は、『Oracle Fusion Middleware Oracle WebCenterアプリケーション・アダプタの使用』を参照してください。

1. 「管理対象添付ファイル」結果ペインをリフレッシュします。「新規」ボタンの横に「スキャン」ボタンが表示されている必要があります。

2. 「スキャン」ボタンをクリックします。「ドキュメントのスキャン」ページで、ドキュメント分類およびセキュリティ・グループを選択し、「ドキュメントのスキャン」をクリックします。Oracle Distributed Document Captureクライアントが起動します。

注意:

スキャンまたはインポートを介して一度に1つのドキュメントのみ添付できます。

URLは、クライアントを実行するために指定した設定を反映することに注意してください。また、それはスキャン・プロファイル、スキャン・アクション(1 = スキャンおよび2 = インポート)、およびOracle E-Business SuiteまたはOracle PeopleSoftエンティティ値を含むインデックス・データを渡します。

3. Oracle Distributed Document Captureクライアント内で、ドキュメントを確認し、索引を作成し、送信します。

注意:

ドキュメントのスキャンまたはインポートを取り消すことに決定した場合は、Oracle Distributed Document Captureウィンドウを閉じて、「管理対象添付ファイル」ページに戻り、新たにスキャンまたはインポートを実行する必要があります。これにより、確実にインデックス値が添付ファイルのために正しく設定されます。

4. 「管理対象添付ファイル」ページに戻り、「リフレッシュ」をクリックします。新しくスキャンしたドキュメントまたはインポートしたスキャン済イメージ・ファイルが、リスト内に表示されるはずです。(表示には数分かかる可能性があります。)

7.11 管理対象添付ファイル・ソリューションのテスト

機能をテストするには、ビジネス・アプリケーションではなく「コマンド・ドライバ」ページから管理対象添付ファイル・ソリューションを起動できます。

次の手順に従って、コマンド・ドライバを使用します。

1. 次のURL形式を使用して「コマンド・ドライバ」ページを表示します。
http://IPM Host:IPM Port/imaging/faces/Driver.jspx

第7.7.1項で説明されているように、管理対象添付ファイルのためのCSF資格証明で設定されたユーザーとして(たとえば、weblogic)このページにログインする必要があることに注意してください。

2. 表示されるコマンド・ドライバ・オプションで、「入力パラメータ」フィールドおよび「リクエスト・パラメータ」フィールドに入力します。「ユーザー名」フィールドで、コンテンツですでに構成されている有効なユーザーの名前を入力します(たとえば、operations)。図7-24の例を参照してください。「ConversationId」フィールドは空白にしておきます。

図7-24 管理対象添付ファイル・ドライバ・ページのパラメータの例

3. 「リクエストの実行」ボタンをクリックします。
conversationIdおよび他の対応するフィールドでの入力によって指定されたとおり、対話が開始されます。

4. 「レスポンス・コマンド」で、「レスポンスの実行」ボタンをクリックします。
新しいブラウザ・ウィンドウが開き、「管理対象添付ファイル」ページが表示されます。

7.12 コンテンツ・サーバーのロギングの構成

コンテンツ・サーバーのロギングの詳細は、『Oracle Fusion Middleware Oracle WebCenter Contentの管理』を参照してください。

7.13 コンテンツ・サーバー上のアダプタ・コンポーネントのアンインストール

次の手順に従って、コンテンツ・サーバー上の次のアダプタ・コンポーネントを無効にしてからアンインストールします。

- AppAdapterCore

- AppAdapterEBS

- AppAdapterPSFT

- AppAdapterUniversal

これらのコンポーネントの詳細は、第7.3.1項を参照してください。

1. コンテンツ・サーバーに管理者としてログインします。

2. 「管理」メニューから「管理サーバー」を選択します。
「コンテンツ管理サーバー」ページが表示されます。

3. コンポーネントをアンインストールするコンテンツ・サーバー・インスタンスの名前を選択します。
コンテンツ管理サーバーの<instance_name>ページが表示されます。

4. 「コンポーネント・マネージャ」をクリックします。
「コンポーネント・マネージャ」ページが表示されます。

5. 「有効なコンポーネント」リストでアダプタ・コンポーネントを選択し、「無効化」をクリックします。

6. 手順5を繰り返し、残りのアダプタ・コンポーネントを選択して無効にします。

7. 「Content Serverの起動または終了」をクリックします。
コンテンツ管理サーバーの<instance_name>が表示されます。

8. 「再起動」をクリックします。

9. 「コンポーネント・マネージャ」をクリックします。
コンポーネント・マネージャが表示されます。

10. 「コンポーネントのアンインストール」フィールドでアダプタ・コンポーネントを選択し、「アンインストール」をクリックします。「OK」をクリックしてコンポーネントのアンインストールを確認します。

11. 手順10を繰り返し、残りのアダプタ・コンポーネントをアンインストールします。

12. リンクを選択してコンポーネント・マネージャに戻ります。
「コンポーネント・マネージャ」ページが表示されます。

13. 「Content Serverの起動または終了」をクリックします。
コンテンツ管理サーバーの<instance_name>ページが表示されます。

14. コンテンツ・サーバーを再起動して変更内容を適用します。

A BPMイメージング・ソリューション・リファレンス

この付録では、BPM用AXFビジネス・ルールの入力、出力およびルールセットの定義を示します。また、BPMイメージング・ソリューションに使用される、AXF、Oracle E-Business SuiteおよびOracle PeopleSoftの構成表について、HelloBPMソリューションを実装例として説明します。

ここで説明する項目は、次のとおりです。

- 第A.1項「BPM用AXFビジネス・ルール・リファレンス」

- 第A.2項「BPMイメージング・ソリューションのためのAXFの表」

- 第A.3項「BPMイメージング・ソリューションのためのAXFのコマンド」

- 第A.4項「BPMイメージング・ソリューションのためのOracle E-Business Suite Formsの表」

- 第A.5項「BPMイメージング・ソリューションのためのOracle PeopleSoftの表」

A.1 BPM用AXFビジネス・ルール・リファレンス

この項では、BPM用AXFインフラストラクチャとともに提供されるビジネス・ルールのリファレンス情報を示します。

- 第A.1.1項「ページ・コンポーネントのパラメータ」

- 第A.1.2項「コントロール・ページのパラメータ」

- 第A.1.3項「Actionディクショナリ」

- 第A.1.4項「Dataディクショナリ」

- 第A.1.5項「DynamicTabディクショナリ」

- 第A.1.6項「FunctionalBlockディクショナリ」

- 第A.1.7項「LookupAndValidatorディクショナリ」

- 第A.1.8項「TableDataディクショナリ」

- 第A.1.9項「ビジネス・ルールのエンティティ関係」

A.1.1 ページ・コンポーネントのパラメータ

ページ・コンポーネントを使用すると、コンテンツ(イメージ、データ・フィールド、表など)を動的タブに表示できます(第5.1.1.4項を参照)。

ページ・コンポーネントをタブ上で使用するには、ページ・コンポーネントとそのパラメータをDynamicTabディクショナリで指定します。たとえば、SalesQuoteEntryコンテキストのDynamicTabディクショナリでは、Tabルールセットを使用してこのコンテキストの追加タブのページ・コンポーネントを定義し、TabParameterルールセットを使用してそのパラメータを定義しています(第5.3.5.3項参照)。第A.1.5.2項を参照してください。

これらのコンポーネントの1つをページに追加するには、ページ・コンポーネントを、DynamicTabビジネス・ルール、Tabルールセット内のpageComponentプロパティで指定します(Image DataおよびCommentsの各コンポーネントの例を次に示します)。

pageComponent: PageComponent."ImageData"

pageComponent: PageComponent."Comment"

ページ・コンポーネントのパラメータは、DynamicTabルールのTabParameterルールセットで指定します。

- イメージ・ページ・コンポーネントのパラメータ

- イメージ・データ・ページ・コンポーネントのパラメータ

- データ・ページ・コンポーネントのパラメータ

- 表データ・ページ・コンポーネントのパラメータ

- マスター/ディテール・ページ・コンポーネントのパラメータ

- アイデンティティ・ブラウザ・ページ・コンポーネントのパラメータ

- コメント・ページ・コンポーネントのパラメータ

A.1.1.1イメージ・ページ・コンポーネントのパラメータ

このページ・コンポーネントの内容は、イメージ・ビューアです。表A-1は、Imagingのビューアに対して設定できるパラメータの説明です。

表A-1 イメージ・ページ・コンポーネントの属性

属性

説明

AXFのデフォルト値

showTabs

タブを表示するかどうかを示します。表示すると、ユーザーが1つのフォルダ内のドキュメントを切り替えることができるようになります。

false

showFooter

フッターを表示するかどうかを指定します。表示すると、ユーザーが1つのフォルダ内のドキュメントを切り替えることができるようになります。

false

forceHideProperties

trueを指定すると、ビューアの「プロパティ」詳細パネルが強制的に閉じられます。これは、システム・デフォルトやユーザー・プリファレンスの設定をオーバーライドします。

true

forceHideStickyNotes

trueを指定すると、ビューアの「付箋」詳細パネルが強制的に閉じられます。これは、システム・デフォルトやユーザー・プリファレンスの設定をオーバーライドします。

true

forceHideHistory

trueを指定すると、ビューアの「履歴」詳細パネルが強制的に閉じられます。これは、システム・デフォルトやユーザー・プリファレンスの設定をオーバーライドします。

true

A.1.1.2 イメージ・データ・ページ・コンポーネントのパラメータ

このページ・コンポーネントはコンポジット・ページ・コンポーネントであり、データ・ページ・コンポーネントとイメージ・ページ・コンポーネントで構成されます。

表A-2は、イメージ・データ・ページ・コンポーネントの属性の説明です。さらに、表A-1に示したイメージ・ビューアの属性も、このページ・コンポーネントに対して構成できます。

表A-2 イメージ・データ・ページ・コンポーネントの属性

属性

説明

DataContext

どのデータを表に表示するかを決定するコンテキストを指定します。このコンテキストは、このデータに対する定義が含まれている適切なルールを実行するのに使用されます。

デフォルトでは、タスク・フロー・テンプレート内で構成されているデフォルトのコンテキストがこの属性で使用されます。

SplitterPosition

データ・コンポーネントとイメージ・コンポーネントの間のスプリッタ・バーを配置する場所を定義します。デフォルトは250です。

HideData

データ・コンポーネントを表示するか非表示にするかを指定します。値としてtrueを指定すると、データ・コンポーネントは非表示になり、イメージ・コンポーネントがタブ領域全体に拡張して表示されます。値としてfalseを指定すると、データ・コンポーネントがイメージ・コンポーネントの左に表示され、データとイメージのコンポーネント間がスプリッタ・バーで区切られます。

A.1.1.3 データ・ページ・コンポーネントのパラメータ

このページ・コンポーネントは、再利用可能なユーザー・インタフェース・コンポーネントです。この内容は、一連の入力/出力コンポーネントであり、様々なセクションでグループ化されています。コントロール上に表示される各コンポーネントは、BPMタスク・データ・コントロールで定義されたデータ・フィールドの1つにバインドされています。

このページ・コンポーネントを使用すると、次のことができます。

- どのデータ・フィールドをタスク詳細領域に表示するかを指定する

- 各データ・フィールドの表示属性を指定する(ラベル、読取り専用、順序、セクション/グループ名など)

- ペイロード・フィールドの値を編集する

- データ・フィールドのグループ化の方法をカスタマイズする

表A-3は、データ・ページ・コンポーネントの属性の一覧です。これらの属性は、必須ではありません。

表A-3 データ・ページ・コンポーネントの属性

属性

説明

コンテキスト

コントロールの表示コンテキストを指定します。

DisplayMode

どのモードでデータ・コントロールを表示するかを指定します。

0=panelAccordion

1=panelForm

NumberOfColumns

データの表示に使用する列の数を指定します。この属性が適用されるのは、panelForm表示モードのみです。

A.1.1.4 表データ・ページ・コンポーネントのパラメータ

このページ・コンポーネントは、表データを動的タブ上に表示します。

表A-4は、表データ・ページ・コンポーネントの省略可能な属性の一覧です。

表A-4 表データ・ページ・コンポーネントの属性

属性

説明

コンテキスト

どのデータを表に表示するかを決定するコンテキストを指定します。このコンテキストは、この表に対する定義が含まれている適切なルールを実行するのに使用されます。

デフォルトでは、タスク・フロー・テンプレート内で構成されているヒューマン・タスク定義のデフォルトのコンテキストがこの属性に使用されます。

A.1.1.5 マスター/ディテール・ページ・コンポーネントのパラメータ

マスター/ディテール・ページ・コンポーネントは、データのマスターとディテールの両方の領域を表示するために使用されます。データ・コンポーネントとデータ表コンポーネントの両方がこのページ・コンポーネントのために使用されます。

表A-5は、マスター/ディテール・ページ・コンポーネントで定義されている属性の一覧です。

表A-5 マスター/ディテール・ページ・コンポーネントの属性

属性

説明

DataContext

どのデータをページのヘッダー(マスター)部分に表示するかを決定するコンテキストを指定します。このコンテキストは、このページのデータ・コンポーネントに渡されます。

デフォルトでは、タスク・フロー・テンプレート内で構成されているデフォルトのコンテキストがこの属性で使用されます。

TableDataContext

どのデータをこのページの表部分に表示するかを決定するコンテキストを指定します。このコンテキストは、このページの表データ・コンポーネントに渡されます。

デフォルトでは、タスク・フロー・テンプレート内で構成されているデフォルトのコンテキストがこの属性で使用されます。

PageComponentTitle

このコンポーネントがレンダリングされるときにページの最上部に表示されるタイトルを指定します。

NumberOfColumns

この表の表示列数を指定します。

A.1.1.6 アイデンティティ・ブラウザ・ページ・コンポーネントのパラメータ

このページ・コンポーネントは、組込みのADFアイデンティティ・ブラウザをホスティングします。このブラウザでは、ユーザーが割当て対象のユーザーやグループを選択できます。

表A-6は、アイデンティティ・ブラウザ・ページ・コンポーネントの省略可能な属性の一覧です。

表A-6 アイデンティティ・ブラウザ・ページ・コンポーネントの属性

属性

説明

SearchFilter

アイデンティティ・ブラウザでのアイデンティティのフィルタリングを制御できます。

どのフィルタ表示を使用するかを定義するには、SearchFilterパラメータをNamedFunctionalBlockParameterとして指定します。このキーの値は、1個以上3個以下のフィルタをカンマで区切って連結した文字列です。フィルタの値は、"User"、"Group"および"ApplicationRole"です。

- 有効な文字列が1..Nフィルタ値で指定されている場合は、そのフィルタがドロップダウンに表示されます。
例1: Usersフィルタのみが使用可能

"User"

例2: GroupsおよびApplicationRoleが使用可能

"Group, ApplicationRole"

- SearchFilterパラメータが指定されていない場合や、値が空の場合は、3つのオプションすべてがフィルタとして使用可能になります(User、GroupsおよびApplicationRole)。

UserBindingName

選択されたユーザーの格納に使用するバインディングを指定します。

GroupBindingName

選択されたグループの格納に使用するバインディングを指定します。

ApplicationRoleBindingName

選択されたアプリケーション・ロールの格納に使用するバインディングを指定します。

AssignmentBindingName

割当てノードに対するバインディング名を指定します。3つのアイデンティティのそれぞれを格納するペイロード・フィールドを明示的に指定するかわりに、ノード名を1つだけ指定できます。アイデンティティ・ブラウザは、そのノードの下で固定のUser、GroupおよびApplicationRoleが使用可能であると判断して、その場所に値を割り当てます。

A.1.1.6.1 明示的または相対的モードでのアイデンティティ・ブラウザの構成

アイデンティティ・ブラウザ・コンポーネントで、明示的と相対的のどちらの割当てモードを使用するかを構成できます。

- 明示的モードでは、どのペイロード・フィールドに3つのアイデンティティそれぞれを格納するかを指定します。NamedFunctionalBlockParameterのプロパティの中の、UserBindingName、GroupBindingName、ApplicationRoleBindingNameの各プロパティで指定されたペイロード・フィールドに、ユーザー、グループおよびアプリケーション・ロールに対して選択された値が保存されます。値が指定されていない場合は、選択されたユーザー、グループまたはアプリケーション・ロールの値はペイロードに保存されません。

- 相対的モードでは、ペイロード・フィールドのかわりにノード名を1つだけ指定します。アイデンティティ・ブラウザは、固定のユーザー、グループおよびアプリケーション・ロールの値を、指定されたノードの中で探して、その値を割り当てます。NamedFunctionalBlockParameterのプロパティの中の割当てプロパティでノード名が指定され、アイデンティティ・ブラウザはこのノードの中で固定のユーザー、グループおよびアプリケーション・ロールの値を探します。

A.1.1.7 コメント・ページ・コンポーネントのパラメータ

このページ・コンポーネントを使用すると、選択されたタスクのコメントをユーザーが追加または表示できるようになります。これにはパラメータはありません。

A.1.2 コントロール・ページのパラメータ

コントロール・ページを使用すると、次に示す事前定義済ページ・コンポーネントをソリューションの中で簡単に統合できます(第5.1.4項を参照)。

- データ・コントロール・ページのパラメータ

- アイデンティティ・ブラウザ・コントロール・ページのパラメータ

- コメント・コントロール・ページのパラメータ

A.1.2.1 データ・コントロール・ページのパラメータ

データ・コントロール・ページを使用するには、そのデータ・コントロール・ページに移動するための名前付き機能ブロックを作成します。NamedFunctionalBlockParameterのプロパティで、表A-7に示すパラメータを指定します。例については、表5-23を参照してください。

表A-7 データ・コントロール・ページのパラメータ

パラメータ・キー

説明

デフォルト値

ControlPageName

ロードするコントロール・ページを指定します(必須)。この値は、ページ・コンポーネント内のstructureContextにマッピングされます。

"DataControlPage"

ControlPageTitle

コントロール・ページのタイトルを設定します(省略可能)。指定されていない場合は、タイトルは表示されません。

<空白>

コンテキスト

コンテンツのコンテキストを指定します。実行されるビジネス・ルールと、ページに表示されるデータは、このコンテキストで定義されます。

定義されているデフォルトのコンテキストが使用されます。

CommentRequired

ページのOKアクションを実行するためにユーザーが新しいコメントを入力する必要があるかどうかを指定します("True"または"False")。

"False"

A.1.2.2 アイデンティティ・ブラウザ・コントロール・ページのパラメータ

アイデンティティ・ブラウザ・コントロール・ページを使用するには、そのアイデンティティ・ブラウザ・コントロール・ページに移動するための名前付き機能ブロックを作成します。NamedFunctionalBlockParameterのプロパティで、表A-8に示すパラメータを指定します。例については、表5-23を参照してください。

表A-8 アイデンティティ・ブラウザ・コントロール・ページのパラメータ

パラメータ・キー

説明

デフォルト値

ControlPageName

ロードするコントロール・ページを指定します(必須)。

"IdentityBrowserControlPage"

CommentRequired

ページのOKアクションを実行するためにユーザーが新しいコメントを入力する必要があるかどうかを指定します("True"または"False")。

"False"

ControlPageTitle

コントロール・ページのタイトルを設定します(省略可能)。指定されていない場合は、タイトルは表示されません。

<空白>

UserBindingName

ユーザーに対して選択された値を保存するペイロード・フィールドを指定します。値が指定されていない場合は、選択されたユーザーの値はペイロードに保存されません。

なし

GroupBindingName

グループに対して選択された値を保存するペイロード・フィールドを指定します。値が指定されていない場合は、選択されたグループの値はペイロードに保存されません。

なし

ApplicationRoleBindingName

選択されたアプリケーション・ロールの格納に使用するバインディングを指定します。

なし

AssignmentBindingName

割当てノードに対するバインディング名を指定します。3つのアイデンティティのそれぞれを格納するペイロード・フィールドを明示的に指定するかわりに、ノード名を1つだけ指定できます。アイデンティティ・ブラウザは、そのノードの下で固定のUser、GroupおよびApplicationRoleが使用可能であると判断して、その場所に値を割り当てます。

なし

A.1.2.3 コメント・コントロール・ページのパラメータ

コメント・コントロール・ページを使用するには、そのコメント・コントロール・ページに移動するための名前付き機能ブロックを作成します。NamedFunctionalBlockParameterのプロパティで、表A-9に示すパラメータを指定します。例については、表5-23を参照してください。

表A-9 コメント・コントロール・ページのパラメータ

パラメータ・キー

説明

デフォルト値

ControlPageName

ロードするコントロール・ページを指定します(必須)。

"CommentControlPage"

CommentRequired

ページのOKアクションを実行するためにユーザーが新しいコメントを入力する必要があるかどうかを指定します("True"または"False")。

"False"

A.1.3 Actionディクショナリ

Actionディクショナリには、次のルールセットが格納されています。

- Action

- Section

- ActionEnableModeException

- SectionEnableModeException

- ActionParameter

- SectionParameter

A.1.3.1 Action

このルールセットは、アクション・コントロールのアクション・リンクまたはコマンドを定義します。

表A-10 Actionのプロパティ

プロパティ

説明

actionId

このアクションの一意のID。

displayName

このアクションに対して表示される名前。

displayOrder

セクション内でのこのアクションの表示順序。

enableMode

このアクションの有効化モード。

- HIDE: このアクションを表示しません。

- DISABLE: このアクションを無効化した状態で表示します。

- ENABLE: このアクションを有効化した状態で表示します。

namedFunctionalBlockId

このアクションによってトリガーされる名前付き機能ブロックまたは名前付き機能ブロック・シーケンスのID。

sectionId

このアクションが表示されるセクション(Sectionのプロパティへの外部キー)。

A.1.3.2 Section

このルールセットは、アクション・コントロール上のどのセクションにアクション・リンクを表示するかを定義します。

表A-11 Sectionのプロパティ

プロパティ

説明

disclosed

セクションを最初は開くか(true)閉じるか(false)を指定します。

displayName

このセクションに対して表示される名前。

displayOrder

セクションの表示順序。

enableMode

このセクションの有効化モード。

- HIDE: このアクションを表示しません。

- DISABLE: このアクションを無効化した状態で表示します。

- ENABLE: このアクションを有効化した状態で表示します。

sectionId

このセクションの一意のID(アクションによって参照されます)。

A.1.3.3 ActionEnableModeException

このルールセットは、指定された条件でのみ表示するアクション・リンクを定義します。たとえば、データ・フィールドが0またはnullの場合にのみ表示するアクションを構成します。

表A-12 ActionEnableModeExceptionのプロパティ

プロパティ

説明

actionId

このアクションの一意の名前。

enableMode

このアクションの有効化モード。(このルールセットのenableModeは、Actionのプロパティで定義された値をオーバーライドできます。)

- HIDE: このアクションを表示しません。

- DISABLE: このアクションを無効化した状態で表示します。

- ENABLE: このアクションを有効化した状態で表示します。

validatorId

LookupAndValidatorディクショナリのValidatorルールセットに定義されたバリデータ。このバリデータの結果によりアクションenableModeが決定されます。

validatorCriteriaMode

このActionEnableModeExceptionルールで定義されたアクションenableModeがアクションに適用されるかどうかを決定します。値は、ApplyOnPassとApplyOnFailのみです。

- 値がApplyOnPassの場合、バリデータが成功すると、このActionEnableModeExceptionルールで定義されたenableModeがアクションに適用されます。それ以外の場合、このアクション・ルールで定義されたenableModeがアクションに適用されます。

- 値がApplyOnFailの場合、バリデータが失敗すると、このActionEnableModeExceptionルールで定義されたenableModeがアクションに適用されます。それ以外の場合、このアクション・ルールで定義されたenableModeがアクションに適用されます。

bindingName

バリデータが使用するペイロード・バインディング。

A.1.3.4 SectionEnableModeException

このルールセットは、指定された条件でのみ表示するセクションを定義します。

表A-13 SectionEnableModeExceptionのプロパティ

プロパティ

説明

sectionId

このセクションの一意のID。

enableMode

このセクションの有効化モード。(このルールセットで定義されるenableModeは、Sectionのプロパティで定義された値をオーバーライドできます。)

- HIDE: このアクションを表示しません。

- DISABLE: このアクションを無効化した状態で表示します。

- ENABLE: このアクションを有効化した状態で表示します。

validatorId

LookupAndValidatorディクショナリのValidatorルールセットに定義されたバリデータ。このバリデータの結果は、セクションのenableModeを決定するために使用されます。

validatorCriteriaMode

このSectionEnableModeExceptionルールで定義されたセクションenableModeがセクションに適用されるかどうかを決定します。値は、ApplyOnPassとApplyOnFailのみです。

- 値がApplyOnPassの場合、バリデータが成功すると、このSectionEnableModeExceptionルールで定義されたenableModeがセクションに適用されます。それ以外の場合、このセクション・ルールで定義されたenableModeがセクションに適用されます。

- 値がApplyOnFailの場合、バリデータが失敗すると、このSectionEnableModeExceptionルールで定義されたenableModeがセクションに適用されます。それ以外の場合、このセクション・ルールで定義されたenableModeがセクションに適用されます。

bindingName

バリデータが使用するペイロード・バインディング。

A.1.3.5 ActionParameter

このルールセットは、アクションに関連付けられているパラメータを定義します。これを使用すると、インタフェースを変更せずにアクションを拡張できます。

表A-14 ActionParameterのプロパティ

プロパティ

説明

actionId

このアクションの一意のID。

parameterKey

パラメータのキー。

parameterValue

パラメータの値。

A.1.3.6 SectionParameter

このルールセットは、セクションに関連付けられているパラメータを定義します。これを使用すると、インタフェースを変更せずにセクションを拡張できます。

表A-15 SectionParameterのプロパティ

プロパティ

説明

sectionId

このセクションの一意のID。

parameterKey

パラメータのキー

parameterValue

パラメータの値。

A.1.4 Dataディクショナリ

Dataディクショナリには、次のルールセットが格納されています。

- Data

- Section

- DataParameter

- SectionParameter

- DataComponentAttribute

- DataValidator

A.1.4.1 Data

このルールセットは、データ・コンポーネントの個々のデータ項目を指定します。

表A-16 Dataのプロパティ

プロパティ

説明

bindingName

この項目のバインディング(値が読み込まれる/書き込まれる場所)。必須。

displayName

属性のラベルとして表示される名前。必須。

displayOrder

この項目の表示順序。

lookupId

このフィールドに使用されるルックアップ。LookupAndValidatorディクショナリで定義されます。空白の場合は、ルックアップは使用できません。

dataId

この項目とDataParameterのプロパティとのリンクに使用されるID。必須。

enableMode

項目の表示モードを指定します。値は次のとおりです。

- EnableMode.ENABLE (デフォルト)

- EnableMode.DISABLE

- EnableMode.HIDE

sectionId

この項目を配置するセクションのID(Sectionのプロパティで定義されます)。各データ項目は、セクション内に配置されている必要があります。

componentClass

このデータ項目のためにレンダリングするユーザー・インタフェース・コントロールを指定します。この値では、ユーザー・インタフェース・コントロールを指定する必要があります。一般的にはADF入力/出力コンポーネントで、たとえば「ComponentClass.RichInputText」です。

コンポーネント・クラスが指定されない場合の、この値のデフォルトはリッチ入力テキストです。ただし、データが日付型の場合は、デフォルトはリッチ入力日付となります。

A.1.4.2 Section

このルールセットは、データ項目を表示するセクションを指定します。

表A-17 Sectionのプロパティ

プロパティ

説明

disclosed

セクションを最初は公開状態で表示するかどうかを指定します(ブール)

displayName

ユーザー・インタフェースに表示される、セクションの名前。

displayOrder

コンポーネント内でのセクションの表示順序。

enableMode

項目の表示モードを指定します。値は次のとおりです。

- EnableMode.ENABLE (デフォルト)

- EnableMode.DISABLE

- EnableMode.HIDE

sectionId

セクションの一意のID。Dataのプロパティで参照されます。

A.1.4.3 DataParameter

このルールセットは、データ・コンポーネント上の個々のデータ項目のパラメータを指定します。このルールセットは、将来使用するためのものです。

表A-18 DataParameterのプロパティ

プロパティ

説明

dataId

Dataのプロパティへの外部キー。

parameterKey

このパラメータのキー。

parameterValue

このパラメータの値。

A.1.4.4 SectionParameter

このルールセットは、データ・セクションのパラメータを指定します。このルールセットは、将来使用するためのものです。

表A-19 SectionParameterのプロパティ

プロパティ

説明

sectionId

Sectionのプロパティへの外部キー。

parameterKey

このパラメータのキー。

parameterValue

このパラメータの値。

A.1.4.5 DataComponentAttribute

このルールセットは、データ・コンポーネントで指定されたユーザー・インタフェース・コンポーネントのユーザー・インタフェース属性を指定します。例に示したとおりに値を指定すると、ユーザー・インタフェース・コンポーネントの背景色がライト・ブルーに設定されます。これらの属性は、標準のOracle ADFユーザー・インタフェース属性です。

表A-20 DataComponentAttributeのプロパティ

プロパティ

説明

dataId

Dataのプロパティへの外部キー。

parameterKey

このパラメータのキー。たとえば、次のように指定します。

- "contentStyle" (値の例: "background-color:lightblue")

- "ComponentAttribute.converterdatetime.dateStyle" (値の例: "yyyy/MM/dd HH:mm:ss")

parameterValue

このパラメータの値。

A.1.4.6 DataValidator

このルールセットは、参照されるバリデータをデータ項目でどのように使用するかを定義します。

表A-21 DataValidatorのプロパティ

プロパティ

説明

validatorCategoryId

このプロパティは、特定の機能ブロックに関連する検証のグループのカテゴリとそのモード・プロパティを設定するときに使用します。たとえば、このプロパティを"AddressInfo"に設定してから、NamedFunctionalBlockValidatorのプロパティのvalidatorCategoryIdプロパティを"AddressInfo"に設定し、モード・プロパティを「PROMPT」に設定した場合は、指定のバリデータによる検証を行うようにDataディクショナリで設定されたフィールドはすべて、PROMPTモードとなります。

dataId

Dataのプロパティへの外部キー。

validatorMode

バリデータのモードを指定します。

- IMMEDIATE: フィールドは、検証可能になると(フィールドがフォーカスを失ったとき)すぐに検証されます。

- FUNCTIONAL_BLOCK: 検証が実行されるのは、機能ブロックが実行されるときです。

validatorId

選択されているデータ・フィールドに対して実行されるバリデータ。LookupAndValidatorディクショナリのValidatorで定義されます。空白の場合は、バリデータは適用されません。

A.1.5 DynamicTabディクショナリ

DynamicTabディクショナリには、次のルールセットが格納されます。

- Tab

- TabParameter

A.1.5.1 Tab

このルールセットは、指定されたコンテキストに対して表示するタブを定義します。たとえば、「イメージ」や「コメント」です。

表A-22 Tabのプロパティ

プロパティ

説明

tabId

タブの一意の名前。

displayName

タブのタイトル。

displayOrder

タブの順序。

pageComponent

ページ・コンポーネント定義ファイルの場所。

A.1.5.2 TabParameter

このルールセットは、表示されるタブ(ページ・コンポーネント)のパラメータを定義します。たとえば、データおよび表データのコンテキストと、ページ・コンポーネント・タイトルを設定します。

表A-23 TabParameterのプロパティ

プロパティ

説明

tabId

タブの一意の名前。

parameterKey

ページ・コンポーネントで定義されているパラメータ。たとえば、パラメータSplitterPositionと値250を指定して画面のデフォルトのサイジングを設定します。または、表示するデータを指定するために、コンテキストを指定します(実行されるビジネス・ルールは、コンテキストによって定義されます)。各ページ・コンポーネントのパラメータの説明は、第A.1.1項を参照してください。

parameterValue

タブにマッピングされているページ・コンポーネントで定義されているパラメータの値。値の先頭が${または#{でない場合は、リテラルとして扱われます。

注意: 式言語を使用してパラメータ値を指定できます(たとえば、"#{pageFlowScope.taskId}")

A.1.6 FunctionalBlockディクショナリ

FunctionalBlockディクショナリには、次のルールセットが格納されます。

- NamedFunctionalBlock

- NamedFunctionalBlockSequence

- NamedFunctionalBlockParameter

- NamedFunctionalBlockPrompt

- NamedFunctionalBlockValidator

A.1.6.1 NamedFunctionalBlock

このルールセットは、コンテキストの機能ブロックを定義します。

表A-24 NamedFunctionalBlockのプロパティ

プロパティ

説明

functionalBlock

機能ブロックが何を行うかを指定します(たとえば、"setOutcome"、"navControlPage"、"system::SUSPEND")

namedFunctionalBlockId

名前付き機能ブロックの一意の名前を指定します。

注意: この名前は、NamedFunctionalBlock namedFunctionalBlockIdおよびNamedFunctionalBlockSequence namedFunctionalBlockSequenceIdの両方のすべてのインスタンスの中で一意であることが必要です。

A.1.6.2 NamedFunctionalBlockSequence

このルールセットは、機能ブロック・シーケンスを定義します。

表A-25 NamedFunctionalBlockSequenceのプロパティ

プロパティ

説明

namedFunctionalBlockId

シーケンスに含まれる機能ブロックの名前を指定します。これは、NamedFunctionalBlockのプロパティで定義されます。

namedFunctionalBlockSequenceId

NamedFunctionalBlockSequenceの一意のIDを指定します。

注意: この名前は、NamedFunctionalBlock namedFunctionalBlockIdおよびNamedFunctionalBlockSequence namedFunctionalBlockSequenceIdの両方のすべてのインスタンスの中で一意であることが必要です。

順序

シーケンス内のNamedFunctionalBlockの実行順序。

A.1.6.3 NamedFunctionalBlockParameter

このルールセットは、機能ブロックのパラメータを定義します。

表A-26 NamedFunctionalBlockParameterのプロパティ

プロパティ

説明

namedFunctionalBlockId

NamedFunctionalBlockの一意のID。この表の値の例は、表5-23を参照してください。

parameterKey

パラメータのキー(たとえば、Outcome)。

parameterValue

パラメータの値(たとえば、APPROVE)。

A.1.6.4 NamedFunctionalBlockPrompt

このルールセットは、機能ブロックのプロンプトを定義します。

表A-27 NamedFunctionalBlockPromptのプロパティ

プロパティ

説明

namedFunctionalBlockId

NamedFunctionalBlockの一意のID。この表の値の例は、表5-24を参照してください。

順序

プロンプトの表示順序。

promptMessage

ポップアップ・ウィンドウに表示されるメッセージ。

promptMode

プロンプトを表示するタイミング。使用可能な値は次のとおりです。

- PromptModeType.BEFORE_VALIDATION

- PromptModeType.AFTER_VALIDATION

promptType

プロンプトのタイプ。使用可能な値は、OkCancelFunctionalBlockContinuationおよびRollbackSavedChangesです。

OkCancelFunctionalBlockContinuationを指定すると、ユーザーに対して次のプロンプトが表示されます。

- はい: 名前付き機能ブロックを続行します

- いいえ: 名前付き機能ブロックを取り消します

RollbackSavedChangesを指定すると、ユーザーに対して次のプロンプトが表示されます。

- はい: 名前付き機能ブロックを続行しますが、その前に、タスク・ペイロードの変更はタスクが開かれたときの状態に戻されます。タスクが開かれた後に追加されたコメントは、元に戻されないことに注意してください。

- いいえ: 名前付き機能ブロックを続行します

- 取消し: 名前付き機能ブロックを取り消します

A.1.6.5 NamedFunctionalBlockValidator

このルールセットは、機能ブロック検証の設定を定義します。たとえば、関連付けられた機能ブロックや、エラー時の処理です(続行、強制終了またはプロンプト)。

表A-28 NamedFunctionalBlockValidatorのプロパティ

プロパティ

説明

namedFunctionalBlockId

バリデータを関連付けるNamedFunctionalBlockの一意のID。

validatorCategoryId

このプロパティは、特定の機能ブロックに関連する検証のグループのカテゴリとそのモード・プロパティを設定するときに使用します。たとえば、このプロパティを"AddressInfo"に設定し、モード・プロパティを「PROMPT」に設定してから、DataValidatorのプロパティやColumnValidatorのプロパティのvalidatorCategoryIdプロパティを"AddressInfo"に設定した場合は、指定のバリデータによる検証を行うようにDataディクショナリやTableDataディクショナリで設定されているフィールドはすべて、PROMPTモードとなります。

validatorMode

このプロパティでは、検証で不合格となったときの処理を指定します。選択肢は次のとおりです。

- CONTINUE

- ABORT (デフォルト)

- PROMPT

A.1.7 LookupAndValidatorディクショナリ

LookupAndValidatorディクショナリには、次のルールセットが格納されます。

- StaticLookup

- DynamicLookup

- DynamicLookupBindVariable

- LookupParameter

- DynamicLookupRelatedBinding

- Validator

- ValidatorParameter

A.1.7.1 StaticLookup

このルールセットは、静的ルックアップのリストを、その値および表示順序とともに定義します。この固定リストのルックアップをDataディクショナリまたはDataTableディクショナリで使用してルックアップを実装することができます。

この表の値の例は、表5-26を参照してください。

表A-29 StaticLookupのプロパティ

プロパティ

説明

lookupId

この項目と他のルックアップ定義ルールセットおよびDataディクショナリおよびTableDataディクショナリとをリンクする、一意のID。

displayName

選択リストに表示する名前。

値

ユーザーが表示名を静的ドロップダウンから選択すると、このルックアップが関連付けられているフィールドにこの値が入力されます。

displayOrder

リスト内でのこの項目の表示順序。

A.1.7.2 DynamicLookup

このルールセットは、動的ルックアップ、そのデータベース接続およびバインディング、タイプ(ドロップダウンまたは検索)および実行するSQL問合せを定義します。この動的ルックアップをDataディクショナリまたはDataTableディクショナリで使用してルックアップを実装することができます。

この表の値の例は、表5-27を参照してください。

表A-30 DynamicLookupのプロパティ

プロパティ

説明

lookupId

この項目と他のルックアップ定義ルールセットおよびDataディクショナリおよびTableDataディクショナリとをリンクする、一意のID。

dataSource

問合せのデータソースを指定します。たとえば、/jdbc/IPMDSです。IPMDSの部分は、インストール時に自動的に構成されます。

詳細は、第5.4.10項を参照してください。

sqlQuery

lookupConfigurationで指定されたデータベース接続に対して実行する、SQL問合せ文字列を指定します。select句で指定される別名にスペースが含まれていてはなりません。

sqlColumn

このルックアップを参照しているDataまたはTableDataの列へのバインドに、select句のどの列を使用するかを指定します。

注意: この値は、select句の列の1つか、別名(定義されている場合)であることが必要です。

A.1.7.3 DynamicLookupBindVariable

このルールセットは、指定されたSQL問合せで使用されるバインド変数を定義します。一般的には、バインディング/ペイロード内の値にアクセスするには式言語を使用します。

表A-31 DynamicLookupBindVariableのプロパティ

プロパティ

説明

lookupId

DynamicLookupのプロパティへの外部キー。

variableName

SQL問合せ内に存在するバインディング変数名。

variableValue

ペイロード内の値を取り出すためのバインディングを指定します。

A.1.7.4 LookupParameter

このルールセットは、参照定義のパラメータを指定します。このルールセットは、将来使用するために用意されています。

表A-32 LookupParameterのプロパティ

プロパティ

説明

lookupId

参照ルールセットへの外部キー。

parameterKey

このパラメータのキー。

parameterValue

このパラメータの値。

A.1.7.5 DynamicLookupRelatedBinding

このルールセットは、ユーザーが参照から値を選択したときに更新される関連バインディングを定義します。

このルールセットを使用するのは、追加のデータ・フィールドを動的参照にバインドするときです。たとえば、HelloBPMソリューションのAccountNameという参照によって、住所フィールドの値がAccountName参照から入力されます。

この表の値の例は、表5-28を参照してください。

表A-33 DynamicLookupRelatedBindingのプロパティ

プロパティ

説明

lookupId

DynamicLookupのプロパティへの外部キー。

bindingName

更新するバインディング/ペイロード・フィールドの名前。

sqlColumn

bindingNameで指定されたデータ項目を更新するのに使用される、動的参照のselect句の列の1つを指定します。

注意: この値は、select句の列の1つか、別名(定義されている場合)であることが必要です。

A.1.7.6 Validator

このルールセットは、実行するバリデータ、その検証タイプおよび即座に実行するか機能ブロックの一部として実行するかを指定します。

表A-34 Validatorのプロパティ

プロパティ

説明

validatorId

バリデータの一意のIDを指定します。これは、ValidatorParameterのプロパティ(この中で検証のパラメータが設定されます)への主キーとなります。

validatorClass

バリデータのクラスを指定します。標準のクラスの一覧と説明は、表A-35を参照してください。

このバリデータの詳細(必須パラメータなど)は、Oracle ADFのドキュメントの、ADF Facesのバリデータに関する項を参照してください。

表A-35 Standard Validator Classesのプロパティ

バリデータ・クラス

説明

ByteLengthValidator

エンコード時に文字列のバイト数が検証されます。inputTextのmaximumLength属性も類似していますが、これは、ユーザーが入力できる文字数を制限するものです。

DateRestrictionValidator

入力された日付が、指定された制限に対し有効かどうかが検証されます。

DateTimeRangeValidator

入力された日付が所定の範囲内であることを検証します。この範囲は、バリデータの属性として指定されます。

DoubleRangeValidator

コンポーネント値が指定された範囲内にあるかが検証されます。値は浮動小数点型に変換可能である必要があります。

LengthValidator

コンポーネントの長さが指定された範囲内にあるかが検証されます。値はjava.lang.String型である必要があります。

LongRangeValidator

コンポーネント値が指定された範囲内にあるかが検証されます。値は任意の数値型であるか、longデータ型に変換可能な文字列であることが必要です。

RegExpValidator

Java正規表現構文を使用するデータを検証します。

A.1.7.7 ValidatorParameter

このルールセットは、実行する検証のパラメータを定義します。一般的には、このパラメータは指定のバリデータに関する追加情報を渡すのに使用されます。

表A-36 ValidatorParameterのプロパティ

プロパティ

説明

validatorId

バリデータの一意のIDを指定します。これは、Validatorのプロパティで定義されます。

parameterKey

このパラメータのキー。Validatorのプロパティで指定されるvalidatorClassに必要です。

parameterValue

このパラメータの値。

A.1.8 TableDataディクショナリ

TableDataディクショナリには、次のルールセットが格納されます。

- Table

- Column

- TableParameter

- ColumnParameter

- ColumnComponentAttribute

- ColumnValidator

A.1.8.1 Table

このルールセットは、表、そのバインディング、有効化されているボタン(コピー、貼付け、削除および挿入)およびストレッチ・モードを定義します。

表A-37 Tableのプロパティ

プロパティ

説明

tableId

この表の主キー。TableParameterのプロパティにリンクしています。

bindingName

表の行をロードするバインディング(XMLノード)の名前。

tableStretchMode

表の列に適用するストレッチを指定します。

- none (デフォルト): パフォーマンスを最適にする場合に指定します。

- last: 最後の列をストレッチして未使用の領域を埋める場合に指定します。

- blank: 空の列を自動的に挿入する場合に指定します。この列がストレッチして、行の背景色が表の幅いっぱいに広がります。

- multiple: 2つ以上の列をストレッチする場合に指定します。

特定のリーフ(グループではない)列をストレッチして未使用の領域を埋めるように構成するには、次に示すように、"column:"の後に、ストレッチする列のIDを指定します。

"column:myColId"

enableInsert

trueの場合は、挿入ボタンが有効になります。

enableDelete

trueの場合は、削除ボタンが有効になります。

enableCopyPaste

trueの場合は、コピーと貼付けのボタンが有効になります。

A.1.8.2 Column

このルールセットは、表の列を定義します。列のバインディング、表示順序、列の幅、ルックアップ(ある場合)などです。

表A-38 Columnのプロパティ

プロパティ

説明

columnId

この列の主キー。ColumnParameterのプロパティにリンクしています。

displayName

列ヘッダーに対して表示する名前。

displayOrder

この列の表示順序。

columnWidth

列の幅を指定します(たとえば、"300")。

bindingName

列のデータをロードするバインディング(XMLノード)の名前。

enableMode

コントロールをどの状態でレンダリングするかを決定します。使用可能な値は次のとおりです。

- EnableMode.ENABLE (デフォルト)

- EnableMode.DISABLE

- EnableMode.HIDE

componentClass

このデータ項目のためにレンダリングするユーザー・インタフェース・コントロールを指定します。ここでは、ユーザー・インタフェース・コントロールを指定する必要があります。一般的にはADF入力/出力コンポーネントで、たとえば「ComponentClass.RichInputText」です。

lookupId

選択された表列に対して実行されるルックアップ。LookupAndValidatorディクショナリで定義されます。

A.1.8.3 TableParameter

このルールセットは、表に関連付けられているパラメータを定義します。

表A-39 TableParameterのプロパティ

プロパティ

説明

tableId

このパラメータが関連付けられている表の主キーを指定します。Tableのプロパティで定義されます。

parameterKey

このパラメータのキー。

parameterValue

このパラメータの値。

A.1.8.4 ColumnParameter

このルールセットは、表の列に関連付けられているパラメータを定義します。

表A-40 ColumnParameterのプロパティ

プロパティ

説明

columnId

このパラメータが関連付けられている列の主キーを指定します。Columnのプロパティで定義されます。

parameterKey

このパラメータのキー。

parameterValue

このパラメータの値。

A.1.8.5 ColumnComponentAttribute

このルールセットは、表の列に関連付けられている属性を定義します。

表A-41 ColumnComponentAttributeのプロパティ

プロパティ

説明

columnId

このパラメータが関連付けられている列の主キーを指定します。Columnのプロパティで定義されます。

attributeName

このパラメータのキー。

attributeValue

このパラメータの値。

A.1.8.6 ColumnValidator

このルールセットは、参照されるバリデータを列でどのように使用するかを定義します。

表A-42 ColumnValidatorのプロパティ

プロパティ

説明

validatorCategoryId

このプロパティは、特定の機能ブロックに関連する検証のグループのカテゴリとそのモード・プロパティを設定するときに使用します。たとえば、このプロパティを"AddressInfo"に設定してから、NamedFunctionalBlockValidatorのプロパティのvalidatorCategoryIdプロパティを"AddressInfo"に設定し、モード・プロパティを「PROMPT」に設定した場合は、指定のバリデータによる検証を行うようにDataディクショナリで設定されたフィールドはすべて、PROMPTモードとなります。

columnId

このパラメータが関連付けられている列の主キーを指定します。Columnのプロパティで定義されます。

validatorMode

バリデータのモードを指定します。

IMMEDIATE: フィールドは、検証可能になると(フィールドがフォーカスを失ったとき)すぐに検証されます。

FUNCTIONAL_BLOCK: 検証が実行されるのは、機能ブロックが実行されるときです。

validatorId

選択されている表列に対して実行されるバリデータ。LookupAndValidatorディクショナリのValidatorルールセットで定義されます。

A.1.9 ビジネス・ルールのエンティティ関係

次の図は、ビジネス・ルール・ディクショナリ間の関係を表すものです。

- アクションのエンティティ関係

- 機能ブロックのエンティティ関係

- ルックアップおよびバリデータのエンティティ関係

- データのエンティティ関係

- 表データのエンティティ関係

- 動的タブのエンティティ関係

図A-1 アクションのエンティティ関係

図A-2 機能ブロックのエンティティ関係

図A-3 ルックアップおよびバリデータのエンティティ関係

図A-4 データのエンティティ関係

図A-5 表データのエンティティ関係

図A-6 動的タブのエンティティ関係

A.2 BPMイメージング・ソリューションのためのAXFの表

この項では、BPM AXFの表について説明します。

次の図に、BPM AXFの構成表とその関係を示します。

図A-7 BPM AXFの構成表(BPMイメージング・ソリューション)

AXFの表

説明

AXF_SOLUTIONS表

AXF_SOLUTION_ATTRIBUTES表

AXFソリューションを定義し、インフラストラクチャ、サービスおよびソリューションの全般的なパラメータを定義します。

AXF_COMMANDS表

ソリューション内のAXFのコマンドを定義します。

AXF_SOLUTION_PARAMETERS表

AXFのコマンドのパラメータを定義します。

AXF_XPATH_ATTRIBUTES表、

AXF_XPATH_NAMESPACES表

ペイロード要素のXPATH属性を定義します。

A.2.1 AXF_SOLUTIONS表

AXF_SOLUTIONS表は、AXFで使用されるソリューションを定義します。これは、SOLUTION_NAMESPACE列を通してAXF_COMMANDS表にリンクしています。

A.2.1.1 列の説明

表A-43 AXF_SOLUTIONS表の列の説明

列

説明

SOLUTION_CONTEXT

AXFソリューション実装のJNDI名を定義します。(現時点では、AxfCommandMediatorが唯一のソリューション実装です。)

SOLUTION_NAMESPACE

AXFソリューション名を定義します。

A.2.1.2 実装例

この例の表では、定義されているAXFソリューションを示します。各ソリューションでは、AxfCommandMediatorがソリューション実装として使用されています。

表A-44 AXF_SOLUTIONS表の例(HelloBPM)

SOLUTION_NAMESPACE

SOLUTION_CONTEXT

SalesQuoteEntry

ejb.AxfCommandMediator#oracle.imaging.axf.service.AxfCommandMediatorRemote

SalesQuoteApproval

ejb.AxfCommandMediator#oracle.imaging.axf.service.AxfCommandMediatorRemote

SalesQuoteAccountManager

ejb.AxfCommandMediator#oracle.imaging.axf.service.AxfCommandMediatorRemote

A.2.2 AXF_SOLUTION_ATTRIBUTES表

この表は、インフラストラクチャ、サービスまたはソリューションで使用される、全般的な属性を定義します。たとえば、この表を使用して接続設定を定義します。

A.2.2.1 列の説明

表A-45 AXF_SOLUTION_ATTRIBUTES表の列の説明

列

説明

SOLUTION_NAMESPACE

このパラメータを使用するソリューション・ネームスペースを指定します。

PARAMETER_KEY

パラメータの名前。パラメータ値をデータベースから取り出すときに使用されます。パラメータは次のとおりです。

- Provider_URL: SOAシステムの場所を指定します。BPM接続情報が格納されている場所を指定します。

PARAMETER_VALUE

パラメータの値。

A.2.2.2 実装例

この例の表では、BPM HelloBPMソリューションのソリューション属性が設定されます。

表A-46 AXF_SOLUTION_ATTRIBUTES表の例

SOLUTION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

SalesQuoteEntry

CONNECTION_PROVIDER

oracle.imaging.axf.servicemodules.bpel.workflow.AxfWorkflowServiceModule

A.2.3 AXF_COMMANDS表

この表は、各ソリューションのAXFコマンドおよびそのJavaクラスを定義するときに使用します。各コマンドのパラメータはAXF_SOLUTION_PARAMETERS表で定義されることに注意してください。

A.2.3.1 列の説明

表A-47 AXF_COMMANDS表の列の説明

列

説明

SOLUTION_NAMESPACE

ソリューションの名前。これは、AXF_SOLUTIONS表で定義されます。

COMMAND_NAMESPACE

ソリューション内でのコマンドの一意の名前を定義します。

COMMAND_CLASS

コマンドが定義されているクラスの完全修飾名。このクラスがロードされ、コマンドを表すexecute()メソッドが実行されます。特定のタスクの詳細は、第A.3項に記載されているそのタスクを参照してください。

A.2.3.2 実装例

この例では、HelloBPMソリューションのために定義されているコマンドを示します。

表A-48 HelloBPMのAXF_COMMANDS表の例

SOLUTION_NAMESPACE

COMMAND_CLASS

COMMAND_NAMESPACE

SalesQuoteApproval

oracle.ecm.axf.commands.system.OpenSolutionWorkspace

StartSalesQuoteApproval

SalesQuoteEntry

oracle.ecm.axf.commands.bpm.UpdateTaskCommand

SaveQuote

SalesQuoteEntry

oracle.ecm.axf.commands.system.OpenSolutionWorkspace

StartSalesQuoteEntry

SalesQuoteAccountManager

oracle.ecm.axf.commands.system.OpenSolutionWorkspace

StartSalesQuoteAccountManager

A.2.4 AXF_SOLUTION_PARAMETERS表

この表は、ソリューションおよびAXFのコマンドのコマンド・パラメータを定義します。

A.2.4.1 列の説明

表A-49 AXF_SOLUTION_PARAMETERS表の列の説明

列

説明

SOLUTION_NAMESPACE

ソリューション・ネームスペースを指定します。これは、AXF_SOLUTIONS表で定義されます。

COMMAND_NAMESPACE

コマンド名を指定します。これは、AXF_COMMANDS表で定義されます。

CONFIGURATION_NAMESPACE

コマンドを実装するために使用されます。実装クラスの完全なパッケージ名を指定します。このネームスペース・パスは、インスタンス化される物理Javaクラスを表します。また、このネームスペースによって、同じソリューション・ネームスペース内のコマンドが区別されます。

PARAMETER_KEY

AXFのコマンドで使用されるパラメータ・キーを指定します。パラメータの詳細は、そのコマンドの説明を参照してください。

AXFのコマンド:

- Open Solution Workspaceコマンド

- Update Taskコマンド

- Document Searchコマンド

PARAMETER_VALUE

パラメータ・キーの値を指定します。(パラメータの詳細は、該当するAXFコマンドまたはユーザー・コンポーネントの説明を参照してください。)

値にXPATH:という接頭辞が付いている場合は、属性値はAXF_XPATH_ATTRIBUTES表からのものです。

A.2.4.2 実装例

表A-50 HelloBPMのAXF_SOLUTION_PARAMETERS表の例

SOLUTION_NAMESPACE

COMMAND_NAMESPACE

CONFIGURATION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

SalesQuoteApproval

StartSalesQuoteApproval

oracle.ecm.axf.commands.system.OpenSolutionWorkspace

BASE_URL

http://hostname:16000/axf-solutionWorkspace/faces/solutionworkspace

SalesQuoteEntry

SaveQuote

oracle.ecm.axf.commands.bpm.UpdateTaskCommand

OpportunityID

XPATH:Order_OpportunityID

SalesQuoteEntry

StartSalesQuoteEntry

oracle.ecm.axf.commands.system.OpenSolutionWorkspace

BASE_URL

http://hostname:16000/axf-solutionWorkspace/faces/solutionworkspace

SalesQuoteAccountManager

StartSalesQuoteAccountManager

oracle.ecm.axf.commands.system.OpenSolutionWorkspace

BASE_URL

http://hostname:16000/axf-solutionWorkspace/faces/solutionworkspace

A.2.5 AXF_XPATH_ATTRIBUTES表

この表は、AXFフレームワークで使用されるXPATHの属性を定義します。このXPATHは主に、ペイロード要素に対して定義されます。

A.2.5.1 列の説明

表A-51 AXF_XPATH_ATTRIBUTES表の列の説明

列

説明

ATTRIBUTE_KEY

AXF_SOLUTION_PARAMETERS表のパラメータ値列で参照される属性キー。

XPATH

ペイロード内の値の場所を指定するために使用されるXPATH式。

A.2.5.2 実装例

この例は、AXF_SOLUTION_PARAMETERS表のOpportunity IDフィールドに対して指定されたXPATH属性に従っています。PARAMETER_VALUE列にはXPATH:という接頭辞が含まれており、この属性値がAXF_XPATH_ATTRIBUTES表からのものであることを示しています。

ここに示していないフィールド: SOLUTION_NAMESPACE=SalesQuoteEntry

表A-52 AXF_SOLUTION_PARAMETERS表の例

COMMAND_NAMESPACE

CONFIGURATION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

SaveQuote

oracle.ecm.axf.commands.bpm.UpdateTaskCommand

OpportunityID

XPATH:Order_OpportunityID

次のAXF_XPATH_ATTRIBUTES表では、対応するXPATH列にペイロードの値を特定するXPATH式が表示されます。最後の行には、省略可能な構成を示しています。これは、値の変換を指定するものです。

表A-53 AXF_XPATH ATTRIBUTES表の例

ATTRIBUTE_KEY

XPATH

Order_OpportunityID

//task:UserData/QuoteRequest/salesQuote:Summary/salesQuote:OpportunityID

次に示すAXF_NAMESPACES表のXMLNS_URI列の内容は、XMLファイル内のどの場所にSalesQuoteのタスク情報があるかを表しています。

表A-54 AXF_XPATH_NAMESPACES表の例

Prefix

XMLNS_URI

task

http://xmlns.oracle.com/bpm/workflow/task

A.2.6 AXF_XPATH_NAMESPACES表

次に示す表は、XPATHの属性に使用されるネームスペースを定義します。これは、AXF_XPATH_ATTRIBUTES表にリンクしています。

A.2.6.1 列の説明

表A-55 AXF_XPATH_NAMESPACES表の列の説明

列

説明

PREFIX

XPATHで使用されるネームスペース接頭辞。

XMLNS_URI

一意の識別子となります。

A.2.6.2 実装例

表A-56 HelloBPM AXF_XPATH_NAMESPACES表の例

Prefix

XMLNS_URI

task

http://xmlns.oracle.com/bpm/workflow/task

xml

http://www.w3.org/XML/1998/namespace

salesQuote

http://www.example.com/ns/salesquote

A.3 BPMイメージング・ソリューションのためのAXFのコマンド

BPM AXFのコマンドは次のとおりです。

- 第A.3.1項「Open Solution Workspaceコマンド」

- 第A.3.2項「Update Taskコマンド」

- 第A.3.3項「Document Searchコマンド」

A.3.1 Open Solution Workspaceコマンド

このコマンドは、リクエスタに対して、AXFソリューション・ワークスペースのURLを使用してブラウザを開くという指示を返します。この主な目的は、ソリューション・ワークスペースおよびソリューション・アプリケーションを表示することです。

A.3.1.1 Open Solution Workspaceコマンドのパラメータ

表A-57 OpenSolutionWorkspaceCommandのパラメータ

パラメータ・キー

説明

BASE_URL

このURLは、このコマンドの実行時にレスポンス・コマンドで返されます。これは、指定されたURLに移動する、標準のURL文字列です。

A.3.1.2 実装例

表A-58 AXF_COMMANDS表の例

SOLUTION_NAMESPACE

COMMAND_CLASS

COMMAND_NAMESPACE

SalesQuoteEntry

oracle.ecm.axf.commands.system.OpenSolutionWorkspace

StartSalesQuoteEntry

ここに示していないフィールド: SOLUTION_NAMESPACE=SalesQuoteEntry

表A-59 AXF_SOLUTION_PARAMETERS表内のリダイレクト・コマンドの例

COMMAND_NAMESPACE

CONFIGURATION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

StartSalesQuoteEntry

oracle.ecm.axf.commands.system.OpenSolutionWorkspace

BASE_URL

http://host:port/axf-solutionWorkspace/faces/solutionworkspace

A.3.2 Update Taskコマンド

Update Taskコマンドは、AXFリクエストに関連付けられたAXF対話の中で参照されている、BPMタスクを更新します。このコマンドは、BPMタスク・ペイロード・データを、リクエストで渡された引数を使用して更新します。また、AXFソリューション・アプリケーションに更新の通知を送ります。これは、更新されたデータと、そのアプリケーション内での変更とをマージさせるためです。

Update Taskコマンドは、XMLペイロード内の値を、XPATHまたはシステム属性を使用して更新できます。(XPATHの例は、第A.2.5項および第A.2.6項を参照してください。)

Update Taskコマンド用に独自のパラメータ・キーを作成して、システム属性またはXPATHをパラメータ値に使用することができます。AXFはリクエストのパラメータを検索し、パラメータ・キーに一致するすべての値を見つけます(Outcomeの他に)。そのタスク・ペイロードの中で使用するために、属性リストに対応するパラメータ・キーを取り出します。

BPMタスク内でペイロード以外の属性を更新するには、第A.3.2.2項に記載されているシステム属性を使用します。たとえば、UpdateTaskコマンドは、Outcome (PARAMETER_KEYとして定義されます)の値をリクエスト・パラメータから受け取って、そのタスクのOUTCOME (PARAMETER_VALUEとして定義されます)属性値を更新することができます。

A.3.2.1 Update Taskコマンドのパラメータ

表A-60 UpdateTaskCommandのパラメータ

パラメータ・キー

説明

OUTCOME

ヒューマン・ワークフロー・システムに対して定義されている結果を指定します。デフォルトでは、どのBPMプロセスでもAPPROVEおよびREJECTが使用可能であり、プロセス設計者は他にも作成できます。

A.3.2.2 システム属性

システム属性

ACQUIREDBY

APPROVERS

ASSIGNEDDATE

ASSIGNEDGROUP //更新できません

ASSIGNEDUSER //更新できません

CREATEDATE

CREATOR

DATEATTRIBUTE1-DATEATTRIBUTE5

EXPIREDDATE

ENDDATE

FORMATTRIBUTE1-FORMATTRIBUTE5

FROMUSER

NUMBERATTRIBUTE1-NUMBERATTRIBUTE5

OUTCOME

OWNERGROUP

OWNERUSER

PRIORITY

STATE

TASKID

TASKNUMBER //更新できません

TITLE

TASKDEFINITIONNAME

TEXTATTRIBUTE1-TEXTATTRIBUTE10

UPDATEDBY

URLATTRIBUTE1 - URLATTRIBUTE5

A.3.2.3 実装例

この例では、2つの属性が同じコマンド・ネームスペース、UpdateHelloBPMによって更新されることを示します。

ここに示していないフィールド: SOLUTION_NAMESPACE=SalesQuoteEntry

表A-61 AXF_SOLUTION_PARAMETERS表内のUpdateTaskCommandのパラメータの例

COMMAND_NAMESPACE

CONFIGURATION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

SaveQuote

oracle.ecm.axf.commands.bpm.UpdateTaskCommand

OpportunityID

XPATH:Order_OpportunityID

A.3.3 Document Searchコマンド

このコマンドは、ドキュメント・リポジトリ・システムに格納されているドキュメントを、ビューアでの表示用に取り出します。このときに使用する検索URLは、AXF_SOLUTION_PARAMETERS表で構成されます。ビジネス・アプリケーションから渡すパラメータを指定できます。このパラメータは、検索URLの末尾に付加されます。

A.3.3.1 Document Searchコマンドのパラメータ

表A-62は、このコマンドの構成パラメータの一覧です。AXF_SOLUTION_PARAMETERS表内のこれらのパラメータを使用してコマンドを構成します。

表A-62 DocumentSearchCommandのパラメータ

パラメータ・キー

説明

DOCUMENT_SEARCH_URL

コール元に返すURLを指定します。渡されたパラメータがURL文字列の末尾に付加されます。

A.3.3.2 実装例

次に示す表は、Document Searchコマンドの構成例です。最初の例(SearchIPM)では、指定されたURLとともに渡されたリクエスト・パラメータはありません。2番目の例では、1..n個のリクエスト・パラメータが渡されます。

表A-63 AXF_COMMANDS表の例

SOLUTION_NAMESPACE

COMMAND_CLASS

COMMAND_NAMESPACE

SalesQuoteEntry

oracle.ecm.axf.commands.ucm.DocumentSearchCommand

ImagingSearch

ここに示していないフィールド: SOLUTION_NAMESPACE=SalesQuoteEntry

表A-64 AXF_SOLUTION_PARAMETERS表内のDocument Searchコマンドの例

COMMAND_NAMESPACE

CONFIGURATION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

ImagingSearch

oracle.ecm.axf.commands.ucm.DocumentSearchCommand

DOCUMENT_SEARCH_URL

http://MyIPMServer:Port/imaging/faces/Pages/UrlTools.jspx?ToolName=ExecuteSearch&SearchName=HelloBPM

A.4 BPMイメージング・ソリューションのためのOracle E-Business Suite Formsの表

Oracle E-Business SuiteのためにAXFを構成するには、AXF関連の表をOracle E-Business Suiteで構成する必要があります。この項の内容は次のとおりです。

- 第A.4.1項「BPMイメージング・ソリューションのためのOracle E-Business Suite AXFの表について」

- 第A.4.2項「AXF_CONFIGS表(Oracle E-Business Suite)」

- 第A.4.3項「AXF_COMMANDS表(Oracle E-Business Suite)」

- 第A.4.4項「AXF_COMMAND_PARAMETERS表(Oracle E-Business Suite)」

- 第A.4.5項「AXF_PROPERTIES表(Oracle E-Business Suite)」

注意:

Oracle E-Business Suite BPMイメージング・ソリューションがサポートされるのは、フォーム・ベースのアプリケーションのみです。OAFアプリケーションに対してはサポートされません。

A.4.1 BPMイメージング・ソリューションのためのOracle E-Business Suite AXFの表について

次の図は、AXFソリューションの中でOracle E-Business Suiteシステムによって使用される表どうしの関係を示すものです。

A.4.2 AXF_CONFIGS表(Oracle E-Business Suite)

AXF_CONFIGS表は、AXFソリューションを様々なOracle E-Business Suiteフォーム上で有効化するために使用します。この表では、どのフォームをAXF対応にするかを、データ・ブロック・レベルにまで細分化して選択できます。

フォーム・イベントは、アクションがOracle E-Business Suiteフォームに対して実行されたときに、自動的に起動されます。AXF_CUSTOM.pllによって、すべてのイベント(たとえば、POST-INSERT)がカスタマイズ可能になります。どのイベントを使用するか、およびいつ、どのように使用するかを指定できます。

アクションが発生したときに、カスタマイズ済コードによって、指定のソリューションとそのイベントに対して構成されたコマンドが起動されます。同じフォームが再利用される場合は、FORMFUNCTIONおよびDATABLOCKNAMEによって各フォームを一意に識別します。

注意:

特定のデータブロックではなく、1つのフォーム上のすべてのデータブロックを有効化するには、AXF_DEFAULTをDATABLOCKNAMEパラメータに対して指定します。これで、フォームのPOST-INSERTイベントが発生したときに、発生したデータブロックにかかわらずAXFに通知が送られるようになります。ただし、このようにDATABLOCKNAMEパラメータをAXF_DEFAULTに設定すると、指定されたZOOMコマンドやSPECIALコマンドが、そのフォームに関連するすべてのページ上で有効になります。(ZOOMコマンドおよびSPECIALコマンドはAXF_COMMANDS表(Oracle E-Business Suite)で設定されます。)

A.4.2.1 列の説明

表A-65 AXF_CONFIGS表の列の説明

列名

説明

FORMID

表の主キーを指定します。

FORMFUNCTION

Oracle E-Business Suiteフォームのそれぞれを、フォームの機能に基づいて区別します。

SOLUTIONENDPOINT

AXFへのURLを指定します。この値はhttps://で始まる必要があります(SecureModeがオンの場合)。第2.4.2項を参照してください。

ENTITYNAME

添付ファイル機能によって一意の名前として使用されます。この名前によって、添付ファイルを正しいフォームにリンクします。

LOGENABLED

指定されたフォームに対するログを有効化または無効化します。次のいずれかを指定します。

- 1/TRUE/YES

- 0/FALSE/NO

DATABLOCKNAME

有効化する、フォーム上のデータブロックを指定します。

AXF_DEFAULTを指定すると、フォーム上のすべてのデータブロックを有効化できます。

フォームはOracle E-Business Suiteによって再利用されることもあるので、FORMFUNCTIONおよびDATABLOCKNAMEの組合せによって各フォームを一意に識別します。

A.4.3 AXF_COMMANDS表(Oracle E-Business Suite)

AXF_COMMANDS表は、ユーザーのアクティビティに応じて実行するアクションを記述するために使用します。この表は、AXF_CONFIGS表(Oracle E-Business Suite)と連携します。

A.4.3.1 列の説明

表A-66 AXF_COMMANDS表の列の説明

列名

説明

FORMID

AXF_CONFIGS表(Oracle E-Business Suite)にリンクしています。

EVENTID

表の主キー。

EVENTNAME

起動するイベント・コマンドの名前(例: ZOOM、POST-INSERT)。

DISPLAYMENU

コマンドに対応するメニューのテキストを表示します。

COMMANDNAMESPACE

メニューが選択されたときにバックエンドに渡されるリクエスト・コマンド。

REQUIRESCONVERSATION

このコマンドには有効な対話が必須かどうかを示します。

SORTBY

メニューを表示する順序。

SOLUTIONNAMESPACE

ソリューションの名前。

MENUTYPE

Oracle E-Business Suiteでユーザーに対して表示するメニューのタイプを指定します。次の選択が可能です。

- ZOOM: ズーム・メニューをツールバーに表示します。

- ZOOMANDSPECIAL: ズーム・メニューとスペシャル・メニューの両方を表示します。(スペシャル・キーをSPECIAL列に入力します。)

- SPECIAL: スペシャル・メニューをツールバーに表示します。(スペシャル・キーをSpecial列に入力します。)

SPECIAL

スペシャル・タイプ・メニューの一意の番号を入力して新しいメニュー・エントリを作成します。

- SPECIAL1-15: 「ツール」メニューのエントリを作成します。

- SPECIAL16-30: 「レポート」メニューのエントリを作成します。

- SPECIAL31-45: 「アクション」メニューのエントリを作成します。

(詳細は、Oracle E-Business Suiteのドキュメントを参照してください。)

RESPONSIBILITY

将来使用するために予約されています。

A.4.4 AXF_COMMAND_PARAMETERS表(Oracle E-Business Suite)

AXF_COMMAND_PARAMETERS表は、定義されたコマンドのそれぞれに対して送信される情報を定義するために使用します。コマンドごとに、必須または省略可能のパラメータのセットは異なります。

A.4.4.1 列の説明

表A-67 AXF_COMMAND_PARAMETERS表の列の説明

列

説明

PARAMETERID

パラメータの一意のIDを定義します。

EVENTID

イベントの一意のIDを定義します。AXF_COMMANDS表(Oracle E-Business Suite)からの値です。

PARAMETERNAME

渡すパラメータの名前。

DATASOURCENAME

パラメータ値のデータソース。DataまたはConstantを指定できます。

DATABLOCKNAME

値のフェッチ元である、フォームのデータ・ブロック。

FIELDNAME

値のフェッチ元である、フォーム内のフィールド名。

CONSTANTVALUE

パラメータの定数値。

A.4.5 AXF_PROPERTIES表(Oracle E-Business Suite)

AXF_PROPERTIES表は、Oracle E-Business SuiteとのAXF統合のプロパティを定義するために使用します。

A.4.5.1 列の説明

表A-68 AXF_PROPERTIES表の列の説明

列

説明

PROPNAME

使用するプロパティを指定します。プロパティは次のとおりです。

- SecureMode: SSLを有効にするには、このプロパティをONに設定し、AXFWalletPathプロパティおよびAXFWalletKeyプロパティの値を設定します。

- AXFWalletPath: 証明書の場所(パス)。

- AXFWalletKey: AXFウォレット・パスワードをOracle E-Business Suiteのボールトから取り出すためのキーを指定します。

- AXF_VERSION: AXF 10gの場合は1を指定し、AXF 11gの場合は2を指定します。

- AXF_SOAP_POLICY: 使用するSOAPポリシーの名前を指定します。現在サポートされているポリシーはUSER_NAME_TOKENです。

- AXF_SOAP_SECURITY: TRUEを指定します(必須)。これで、SOAPセキュリティが有効になります。第2.4.1項を参照してください。

- AXF_SOAP_USER: 認証のSOAPヘッダーで使用されるSOAPユーザーIDを指定します。第2.4.1項を参照してください。

- AXF_PAPERCLIP: TRUEに設定すると紙クリップ・オプションが有効になり、FALSE (デフォルト)に設定すると無効になります。第6.4.11項も参照してください。

PROPVALUE

プロパティの値を指定します。

A.5 BPMイメージング・ソリューションのためのOracle PeopleSoftの表

Oracle PeopleSoft用のアダプタを構成するには、Oracle PeopleSoftのAXF関連の表を構成する必要があります。詳細は、第3.5項を参照してください。

この項の内容は次のとおりです。

- 第A.5.1項「BPMイメージング・ソリューションのためのOracle PeopleSoft AXFの表について」

- 第A.5.2項「PS_AXF_CONFIG表」

- 第A.5.3項「PS_AXF_COMMANDS表」

- 第A.5.4項「PS_AXF_COMMAND_PARAMS表」

- 第A.5.5項「PS_AXF_PROPERTIES表」

A.5.1 BPMイメージング・ソリューションのためのOracle PeopleSoft AXFの表について

次の図は、AXFソリューションの中でOracle PeopleSoftシステムによって使用される表どうしの関係を示すものです。

注意:

AXFの表フィールドはすべて、null以外の値を必要とします。適用されないフィールドについては、スペースを入れておくことができます。

A.5.2 PS_AXF_CONFIG表

PS_AXF_CONFIG表は、AXFソリューションをOracle PeopleSoftの様々なコンポーネント上で有効にするために使用します。この表では、どのページやコンポーネントをAXF対応にするかを、細分化したレベルで選択できます。

イベントは、Oracle PeopleSoftのページに対してアクションが実行されたときに、自動的に起動されます。AXF_PS_Integrationプロジェクト・コンポーネントによってPRE-およびPOST- saveイベントがキャッチされるので、これらのイベントがカスタマイズ可能になります。どのイベントを使用するか、およびいつ、どのように使用するかを指定できます。

A.5.2.1 列の説明

表A-69 PS_AXF_CONFIG表の列の説明

列名

説明

AXF_CONFIG_ID

表の主キーを指定します。

AXF_COMPONENT_NAME

有効にするOracle PeopleSoftコンポーネントの名前を指定します。

AXF_CONNECT_NAME

Oracle PeopleSoftインテグレーション・ブローカー接続名(コールするサービス操作)を指定します。これは、Oracle PeopleSoftインテグレーション・ブローカーの管理インタフェースで定義されます。

デフォルトのサービス操作はAXF_EXECUTEです。他の接続を設定して使用することができます。

AXF_VERSION

接続のAXFバージョンを指定します。使用可能な値は次のとおりです。

- 10g

- 11g

A.5.3 PS_AXF_COMMANDS表

PS_AXF_COMMANDS表は、ユーザーのアクティビティに応じて実行するアクションを記述するために使用します。この表は、PS_AXF_CONFIG表と連携します。

A.5.3.1 列の説明

表A-70 PS_AXF_COMMANDS表の列の説明

列名

説明

AXF_CMDS_ID

表の主キーを指定します。これは、一意のコマンドを特定するために使用されます。

AXF_CONFIG_ID

PS_AXF_CONFIG表への外部キーを指定します。これによって、この一意のコマンドと特定のページおよびコンポーネントとが関連付けられます。

AXF_EVENT_NAME

実行されるイベントを指定します。AXF_EVENT_NAMEは、既存のOracle PeopleSoftページに組み込まれるサブページに対応します。たとえば、AXFの機能をコールするためにOracle PeopleSoftのページに追加されるボタン、リンクまたはメニューです。詳細は、第3.3項を参照してください。使用可能なオプションは次のとおりです。

- AXF_BUTTON_1、…、AXF_BUTTON_5

- AXF_LINK_1、...、AXF_LINK5

- AXF_COMBO_1、...、AXF_COMBO_5

- SAVE_PRE_CHANGE

- SAVE_POST_CHANGE

AXF_SELECT_LABEL

選択フィールドに対してページ上に表示される名前を定義します。これが使用されるのは、COMBOイベントのみです。

AXF_DISPLAY_NAME

Oracle PeopleSoftページ上に表示されるボタンまたはリンクの名前を定義します。

AXF_SOL_NAMESPC

実行するコマンドのソリューション・ネームスペースを指定します。

AXF_CMD_NAMESPC

実行するコマンドのコマンド・ネームスペースを指定します。

AXF_PSFT_ROLE

コマンドへのアクセス権を持つOracle PeopleSoftのロールを指定します。これは、各ロールを単一引用符で囲んだものをカンマで区切ったリストです(例: 'Role1','Role2','Role3')。

AXF_SORT_ORDER

選択フィールドに表示される項目の順序を指定します。ソート順序が適用されるのは選択フィールドのみです。

AXF_REQ_CONV

このコマンドの実行前に対話が必須かどうかを指定します。

A.5.4 PS_AXF_COMMAND_PARAMS表

PS_AXF_COMMAND_PARAMS表は、定義されたコマンドのそれぞれに対して送信される情報を指定するために使用します。コマンドごとに、必須または省略可能のパラメータのセットは異なります。

A.5.4.1 列の説明

表A-71 AXF_COMMAND_PARAMETERS表の列の説明

列

説明

AXF_CMDS_PARAMS_ID

表の主キーを指定します。

AXF_CMDS_ID

PS_AXF_COMMANDS表への外部キーを指定します。これによって、一意のパラメータと特定のコマンドとが関連付けられます。

AXF_PARAM_NAME

パラメータ名を定義します。

AXF_DATASOURCE

パラメータ値の取得元を指定します。

- DATA: AXF_RECORD_NAMEフィールドおよびAXF_FIELD_NAMEフィールドで定義された、Oracle PeopleSoft内の値を取得します。

- CONSTANT: AXF_CONSTANT_VALUEフィールドで定義された値を使用します。

AXF_RECORD_NAME

Oracle PeopleSoftページ内のフィールドのレコードを指定します。これは、AXF_DATASOURCEがDATAに設定されているときに取得するターゲット値として使用されます。

AXF_FIELD_NAME

AXF_DATASOURCEがDATAに設定されているときにターゲット値として使用されます。

AXF_CONSTANT_VALUE

AXF_DATASOURCEがCONSTANTに設定されているときに定数値として使用されます。

A.5.5 PS_AXF_PROPERTIES表

PS_AXF_PROPERTIES表は、Oracle PeopleSoftとのAXF統合のプロパティを定義するために使用します。第6.4.12項を参照してください。

A.5.5.1 列の説明

表A-72 PS_AXF_PROPERTIES表の列の説明

列

説明

AXF_PROPNAME

使用するプロパティを指定します。プロパティは次のとおりです。

- WINDOW_HEIGHT: ポップアップ・ウィンドウの高さをピクセル単位で指定します。(これは、ソリューションの一部して表示される任意のポップアップ・ウィンドウを指します。)

- WINDOW_WIDTH: ポップアップ・ウィンドウの幅をピクセル単位で指定します。

AXF_PROPVALUE

プロパティの値を指定します。

B BPELイメージング・ソリューション・リファレンス

この付録では、BPELイメージング・ソリューションのために使用されるAXF、Oracle E-Business SuiteおよびOracle PeopleSoftの構成表について説明します。AXFのコマンドおよびWebユーザー・インタフェース・ツール(タスク・リストやタスク・ビューアなど)について説明し、実装例を示します。

ここで説明する項目は、次のとおりです。

- 第B.1項「BPELイメージング・ソリューションのためのAXFの表」

- 第B.2項「BPELイメージング・ソリューションのためのAXFのユーザー・コンポーネント」

- 第B.3項「BPELイメージング・ソリューションのためのAXFのコマンド」

- 第B.4項「BPELイメージング・ソリューションのためのOracle E-Business Suite Formsの表」

- 第B.5項「BPELイメージング・ソリューションのためのOracle PeopleSoftの表」

B.1 BPELイメージング・ソリューションのためのAXFの表

この項では、BPEL AXFの表について説明します。

注意:

AXFとOracle BPM Worklistセッションを同時に実行すると、先に開かれたセッションが終了します。たとえば、Oracle BPM Worklistセッションが開いている状態でAXFセッションを開くと、BPM Worklistセッションが終了します。

この競合が発生するのは、コンソール・セッション情報を保持するブラウザCookieの名前がドメイン固有ですが、デフォルトの初期値が同一であるからです。この競合を回避するには、Cookieの名前がドメインごとに一意となるように設定します。Cookieの名前を設定するには、コンソールのドメイン構成/一般ページの詳細セクションを使用します。

注意:

稼働中のシステムでのAXFの表の値を変更する場合は、変更を有効にするために、ドライバ・ページでDBキャッシュのクリアを実行するか、AXFアプリケーションをアプリケーション・サーバー内で再起動してください。ドライバ・ページの詳細は、『Oracle Fusion Middleware Oracle WebCenter Contentのインストールと構成』のHelloWorldを使用したAXFインストールの検証に関する項を参照してください。

次の図に、BPEL AXFの構成表とその関係を示します。

図B-1 BPEL AXFの構成表(BPELイメージング・ソリューション)

AXFの表

説明

AXF_SOLUTIONS表

AXF_SOLUTION_ATTRIBUTES表

AXFソリューションを定義し、インフラストラクチャ、サービスおよびソリューションの全般的なパラメータを定義します。

AXF_COMMANDS表

ソリューション内のAXFのコマンドを定義します。

AXF_SOLUTION_PARAMETERS表

AXFのコマンドのパラメータおよびAXFのユーザー・インタフェース・コンポーネントを定義します。

AXF_ACTION_MENU表

AXF_ACTIONS表

タスク・アクション・ペインそのものと、ペイン内のリンクを定義します。

AXF_METADATA_BLOCKS表、

AXF_METADATA_ATTRIBUTES表

タスク・ビューア内の省略可能なセクション(たとえば「サマリー」、「コメント」)および動的データ表を定義します。

AXF_ENUM_TYPES表、

AXF_ENUM_ITEMS表

列挙ピッカーとその値を定義します。

AXF_XPATH_ATTRIBUTES表、

AXF_XPATH_NAMESPACES表

ペイロード要素のXPATH属性を定義します。

B.1.1 AXF_SOLUTIONS表

AXF_SOLUTIONS表は、AXFで使用されるソリューションを定義します。これは、SOLUTION_NAMESPACE列を通してAXF_COMMANDS表にリンクしています。

B.1.1.1 列の説明

表B-1 AXF_SOLUTIONS表の列の説明

列

説明

SOLUTION_CONTEXT

AXFソリューション実装のJNDI名を定義します。(現時点では、AxfCommandMediatorが唯一のソリューション実装です。)

SOLUTION_NAMESPACE

AXFソリューション名を定義します。

B.1.1.2 実装例

この例の表では、定義されているAXFソリューションを示します。各ソリューションでは、AxfCommandMediatorがソリューション実装として使用されています。

表B-2 AXF_SOLUTIONS表の例

SOLUTION_NAMESPACE

SOLUTION_CONTEXT

InvoiceProcessing

ejb.AxfCommandMediator#oracle.imaging.axf.service.AxfCommandMediatorRemote

AccountDistributionApproval

ejb.AxfCommandMediator#oracle.imaging.axf.service.AxfCommandMediatorRemote

SupplierMaintenance

ejb.AxfCommandMediator#oracle.imaging.axf.service.AxfCommandMediatorRemote

RequestInvoiceInformation

ejb.AxfCommandMediator#oracle.imaging.axf.service.AxfCommandMediatorRemote

AccountDistribution

ejb.AxfCommandMediator#oracle.imaging.axf.service.AxfCommandMediatorRemote

InvoiceApproval

ejb.AxfCommandMediator#oracle.imaging.axf.service.AxfCommandMediatorRemote

Rescan

ejb.AxfCommandMediator#oracle.imaging.axf.service.AxfCommandMediatorRemote

B.1.2 AXF_SOLUTION_ATTRIBUTES表

この表は、インフラストラクチャ、サービスまたはソリューションで使用される、全般的な属性を定義します。たとえば、この表を使用してエラー・メッセージのアドレス、接続および対話タイムアウトの設定を定義します。

B.1.2.1 列の説明

表B-3 AXF_SOLUTION_ATTRIBUTES表の列の説明

列

説明

SOLUTION_NAMESPACE

このパラメータを使用するソリューション・ネームスペースを指定します。

PARAMETER_KEY

パラメータの名前。パラメータ値をデータベースから取り出すときに使用されます。パラメータは次のとおりです。

- BPEL_CONNECTION: 使用するBPEL接続を指定します。

- CONNECTION_PROVIDER: 接続を定義します(BPELまたはカスタム)。BPEL接続を指定する場合は、この値はAxfWorkflowServiceModuleです。

- ConversationTimeoutSeconds: ConversationID (cid)が有効である時間の長さを指定します。何もアクティビティがない時間のデフォルト値は43200秒です。

- USE_AUTOTASK_LOCKING: 自動タスク・ロックを有効にするか(TRUE)無効にするか(FALSE)を指定します。自動タスク・ロックを有効にすると、複数のユーザーがタスクを自動タスク・モードで獲得するときに発生する可能性のある衝突を回避できます。第6.4.4項を参照してください。

- USERNAME_PASS_THROUGH: FALSEのときは、認証Oracle WebLogic Serverユーザーがタスク(たとえばBPELのタスク)を実行できます。デフォルトはTRUEで、Oracle E-Business SuiteまたはOracle PeopleSoftから渡されたユーザーが実行します。第6.4.2項を参照してください。

- TASKLIST_RANGESIZE: タスク・リストとして返すタスクの数を指定します。たとえば、タスクの数をデフォルトの25から10に変更できます。

PARAMETER_VALUE

パラメータの値。

B.1.2.2 実装例

この例の表では、請求書処理ソリューションのソリューション属性が設定されます。

表B-4 AXF_SOLUTION_ATTRIBUTES表の例

SOLUTION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

InvoiceProcessing

BPEL_CONNECTION

axfconnection

InvoiceProcessing

CONNECTION_PROVIDER

oracle.imaging.axf.servicemodules.bpel.workflow.AxfWorkflowServiceModule

InvoiceProcessing

USE_AUTOTASK_LOCKING

TRUE

InvoiceProcessing

TASKLIST_RANGESIZE

10

B.1.3 AXF_COMMANDS表

この表は、各ソリューションのAXFコマンドおよびそのJavaクラスを定義するときに使用します。各コマンドのパラメータはAXF_SOLUTION_PARAMETERS表で定義されることに注意してください。

B.1.3.1 列の説明

表B-5 AXF_COMMANDS表の列の説明

列

説明

SOLUTION_NAMESPACE

ソリューションの名前。これは、AXF_SOLUTIONS表で定義されます。

COMMAND_NAMESPACE

ソリューション内でのコマンドの一意の名前を定義します。

COMMAND_CLASS

コマンドが定義されているクラスの完全修飾名。このクラスがロードされ、コマンドを表すexecute()メソッドが実行されます。特定のタスクの詳細は、第B.3項に記載されているそのタスクを参照してください。

B.1.3.2 実装例

この例では、請求書処理ソリューションのために定義されているコマンドを示します。

Fields not shown: SOLUTION_NAMESPACE=InvoiceProcessing

表B-6 AXF_COMMANDS表の例

COMMAND_CLASS

COMMAND_NAMESPACE

oracle.imaging.axf.commands.bpel.AutotaskCommand

AutoOpenTask

oracle.imaging.axf.commands.bpel.ReleaseTaskCommand

ReleaseTask

oracle.imaging.axf.commands.bpel.ReleaseTaskCommand

SkipTask

oracle.imaging.axf.commands.bpel.CompleteTaskCommand

AccountDistributionComplete

oracle.imaging.axf.commands.bpel.CompleteTaskCommand

AssignProcessingGroupComplete

oracle.imaging.axf.commands.bpel.CompleteTaskCommand

CompleteInvoice

oracle.imaging.axf.commands.bpel.CompleteTaskCommand

DeleteInvoice

oracle.imaging.axf.commands.bpel.CompleteTaskCommand

DuplicateInvoice

oracle.imaging.axf.commands.bepl.CompleteTaskCommand

Hold

oracle.imaging.axf.commands.bpel.CompleteTaskCommand

InvoiceApprovalComplete

oracle.imaging.axf.commands.bpel.CompleteTaskCommand

RequestInformationComplete

oracle.imaging.axf.commands.bpel.CompleteTaskCommand

RescanComplete

oracle.imaging.axf.commands.bpel.CompleteTaskCommand

SpecialistExceptionComplete

oracle.imaging.axf.commands.bpel.CompleteTaskCommand

SupplierMaintenance

oracle.imaging.axf.commands.bpel.CompleteTaskCommand

SupplierMaintenanceComplete

oracle.imaging.axf.commands.bpel.OpenTaskCommand

OpenTask

oracle.imaging.axf.commands.bpel.UpdateTaskFromProcedureCommand

RetrieveUserList

oracle.imaging.axf.commands.bpel.UpdateTaskCommand

AttachSupplemental

oracle.imaging.axf.commands.bpel.UpdateTaskCommand

SaveInvoice

oracle.imaging.axf.commands.system.RedirectCommand

AccountDistributionEdit

oracle.imaging.axf.commands.system.RedirectCommand

AssignProcessingGroupEdit

oracle.imaging.axf.commands.system.RedirectCommand

EditComments

oracle.imaging.axf.commands.system.RedirectCommand

InvoiceApprovalEdit

oracle.imaging.axf.commands.system.RedirectCommand

RequestInformationEdit

oracle.imaging.axf.commands.system.RedirectCommand

RescanEdit

oracle.imaging.axf.commands.system.RedirectCommand

SearchIPM

oracle.imaging.axf.commands.system.RedirectCommand

SpecialistExceptionEdit

oracle.imaging.axf.commands.system.RedirectCommand

StartInvoiceProcessing

oracle.imaging.axf.commands.system.RedirectCommand

SupplierMaintenanceEdit

oracle.imaging.axf.commands.system.TerminateConversationCommand

TerminateConversation

B.1.4 AXF_SOLUTION_PARAMETERS表

この表は、ソリューション、AXFのコマンドおよびAXFのユーザー・インタフェース・コンポーネントのコマンド・パラメータを定義します。

B.1.4.1 列の説明

表B-7 AXF_SOLUTION_PARAMETERS表の列の説明

列

説明

SOLUTION_NAMESPACE

ソリューション・ネームスペースを指定します。これは、AXF_SOLUTIONS表で定義されます。

COMMAND_NAMESPACE

コマンド名を指定します。これは、AXF_COMMANDS表で定義されます。

CONFIGURATION_NAMESPACE

コマンドを実装するために使用されます。実装クラスの完全なパッケージ名を指定します。このネームスペース・パスは、インスタンス化される物理Javaクラスを表します。また、このネームスペースによって、同じソリューション・ネームスペース内のコマンドが区別されます。

PARAMETER_KEY

AXFのコマンドで使用されるパラメータ・キーを指定します。パラメータの詳細は、そのコマンドまたはWebツールの説明を参照してください。

ユーザー・インタフェース・コンポーネント:

- 第B.2.2項「タスク・リストWebツール」

- 第B.2.3項「タスク・ビューアWebツール」

- 第B.2.4項「列挙ピッカーWebツール」

- 第B.2.5項「アイデンティティ・ピッカーWebツール」

- 第B.2.3.3項「コメント」

AXFのコマンド:

- 第B.3.1項「Open Taskコマンド」

- 第B.3.2項「Autotaskコマンド」

- 第B.3.3項「Release Taskコマンド」

- 第B.3.4項「Complete Taskコマンド」

- 第B.3.5項「Redirectコマンド」

- 第B.3.6項「Update Taskコマンド(BPEL)」

- 第B.3.7項「Update Task From Procedureコマンド」

- 第B.3.8項「Terminate Conversationコマンド」

- 第B.3.9項「Validate Taskコマンド」

PARAMETER_VALUE

パラメータ・キーの値を指定します。(パラメータの詳細は、そのAXFコマンドまたはWebツールの説明を参照してください。)

値にXPATH:という接頭辞が付いている場合は、属性値はAXF_XPATH_ATTRIBUTES表からのものです。

B.1.4.2 実装例

この例では、請求書処理ソリューションのStartInvoiceProcessingコマンドが設定されます。最初の行では、タスク・リストが表示されることを、RedirectCommandおよび対応するURLを使用して指定します。残りの行では、タスク・リストをコールし(CONFIGURATION_NAMESPACE列で)、その動作を定義します。

Fields not shown: SOLUTION_NAMESPACE=InvoiceProcessing

表B-8 StartInvoiceProcessingコマンドのためのAXF_SOLUTION_PARAMETERS表の例

COMMAND_NAMESPACE

CONFIGURATION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

StartInvoiceProcessing

oracle.imaging.axf.commands.bpel.RedirectCommand

REDIRECT_URL

taskflow://WEB-INF/taskflows/axf-tasklist-tfd.xml#axf-tasklist-tfd

StartInvoiceProcessing

oracle.imaging.axf.web.backing.TaskList

CMD_OPEN_TASK_BUTTON

OpenTask

StartInvoiceProcessing

oracle.imaging.axf.web.backing.TaskList

CMD_AUTO_TASK_BUTTON

AutoOpenTask

StartInvoiceProcessing

oracle.imaging.axf.web.backing.TaskList

DEFAULT_VIEW

(Null)

StartInvoiceProcessing

oracle.imaging.axf.web.backing.TaskList

NO_OF_LINES

20

StartInvoiceProcessing

oracle.imaging.axf.web.backing.TaskList

SHOW_INBOX

FALSE

StartInvoiceProcessing

oracle.imaging.axf.web.backing.TaskList

CONNECTION_NAME

デフォルト

StartInvoiceProcessing

oracle.imaging.axf.web.backing.TaskList

VIEW_LIST

North Invoice Processing Group、South Invoice Processing Group、East Invoice Processing Group、West Invoice Processing Group、My Holds、Exceptions

B.1.5 AXF_ACTION_MENU表

この表は、アクション・メニューをAXF Webページ(たとえば、タスク・ビューアやタスク・リストのページ)上に挿入してカスタマイズするために使用します。一般的な用途の1つは、図B-2に示すように、タスク・ビューア内に「タスク・アクション」ペインを表示するというものです。ユーザーは、表示されているタスクに関連するアクション・リンクをクリックできます。AXF_ACTIONS表を使用して、指定されたメニューのアクションを定義します。

B.1.5.1 列の説明

表B-9 AXF_ACTION_MENU表の列の説明

列

説明

MENU_ID

AXF_ACTIONS表の主キーを指定します。これは、どのメニューにメニュー・アクションを配置するかを指定するものです。

DISPLAY_TEXT

ペインのタイトル(たとえば「タスク・アクション」、「ショートカット」または「再割当て」)を指定します。

MENU_TYPE

ページ上のメニューを表示する場所およびそのタイプを指定します。(LEFT_SIDEBARを指定すると、サイド・ペインがページの左端に表示されます。)

TASK_FLOW_ID

どのアクティブ・タスク・フローにこのメニューを関連付けるかを指定します。たとえば、サイド・メニューをタスク・リスト表示に追加するには、値としてaxf-tasklist-tfdを指定します。これは、メニューを表示するページを指定するものです。

VIEW_ID

(将来使用するために予約済。)

SOLUTION_NAMESPACE

AXFソリューションを指定します。これは、AXF_SOLUTIONS表で定義されます。

MENU_ORDER

表示するメニューが複数設定されているときに、メニューを表示する順序を定義します。

B.1.5.2 実装例

この例では、請求書処理ソリューションの「タスク・アクション」というタイトルのペインを実装し、タスク・ビューアの左側に表示します。

表B-10 AXF_ACTION_MENUの例

MENU_ID

DISPLAY_TEXT

MENU_TYPE

TASK_FLOW_ID

VIEW_ID

SOLUTION_NAMESPACE

MENU_ORDER

0

タスク・アクション

LEFT_SIDEBAR

axf-taskviewer-tfd

null

InvoiceProcessing

0

B.1.6 AXF_ACTIONS表

この表は、AXFのソリューションで使用されるタスク・アクションを定義します。アクション・メニューは、AXFのWebページ、たとえばタスク・ビューア・ページ(第B.2.3項を参照)やタスク・リスト(第B.2.2項を参照)に表示できます。この表は、AXF_COMMANDS表にリンクしています。

B.1.6.1 列の説明

表B-11 AXF_ACTIONS表の列の説明

列

説明

DISPLAY_TEXT

ペイン内のアクション(リンクなど)の名前を指定します。

COMMAND_NAMESPACE

アクションの結果としてコールされるコマンドを指定します。これは、AXF_COMMANDS表で定義されます。

MENU_ORDER

ペイン内でのアクションの表示順序を指定します。

ELEMENT_TYPE

アクションをページ上でどのようにレンダリングするかを指定します。LINKを指定すると、HTMLリンクが表示されます。

ACTION_HANDLER

誰が/何がこのアクションを処理するかを決定します。現在使用できるハンドラはCOMMANDです。

注意: 省略した(null)場合の、この値のデフォルトはCOMMANDです。

REQUIRES_CONVERSATION

このアクションには対話IDが初期化済であることが必須かどうかを指定します。

MENU_ID

AXF_ACTION_MENU表に存在するIDを指定します。ここで定義されたメニューにアクションが表示されます。

ACTION_ID

アクションの一意の数値識別子を定義します。

USE_POPUP

将来使用するために予約されています。

B.1.6.2 実装例

次に示す表は、AXF_ACTIONS表の例です。

図B-2 「タスク・アクション」、「サマリー」および「コメント」が有効になっている状態のタスク・ビューア・ページ

表B-12に示していないフィールド:

- ACTION_HANDLER=COMMAND

- REQUIRES_CONVERSATION=TRUE

表B-12 AXF_ACTIONS表の例

DISPLAY_TEXT

COMMAND_NAMESPACE

MENU_ORDER

ELEMENT_TYPE

MENU_ID

ACTION_ID

請求書承認

InvoiceApprovalEdit

1

LINK

0

AXF_ACTIONS_SEQ.NEXTVAL

タスク・リストに戻る

ReleaseTask

0

LINK

0

AXF_ACTIONS_SEQ.NEXTVAL

タスクをスキップ

SkipTask

0

LINK

0

AXF_ACTIONS_SEQ.NEXTVAL

Complete Invoice

CompleteTask

0

LINK

0

AXF_ACTIONS_SEQ.NEXTVAL

B.1.7 AXF_XPATH_ATTRIBUTES表

この表は、AXFフレームワークで使用されるXPATHの属性を定義します。このXPATHは主に、ペイロード要素に対して定義されます。

B.1.7.1 列の説明

表B-13 AXF_XPATH_ATTRIBUTES表の列の説明

列

説明

ATTRIBUTE_KEY

AXF_SOLUTION_PARAMETERS表のパラメータ値列で参照される属性キー。

XPATH

ペイロード内の値の場所を指定するために使用されるXPATH式。

B.1.7.2 実装例

この例は、AXF_SOLUTION_PARAMETERS表でAssignProcessingGroupEditコマンドに対して指定されたXPATH属性に従っています。PARAMETER_VALUE列にはXPATH:という接頭辞が含まれており、この属性値がAXF_XPATH_ATTRIBUTES表からのものであることを示しています。

Fields not shown: SOLUTION_NAMESPACE=InvoiceProcessing

表B-14 AXF_SOLUTION_PARAMETERS表の例

COMMAND_NAMESPACE

CONFIGURATION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

AssignProcessingGroupEdit

oracle.imaging.axf.web.EnumerationPicker

ATTRIBUTE_NAME

XPATH:InvoiceProcessing_ProcessingGroup

次のAXF_XPATH_ATTRIBUTES表では、対応するXPATH列にペイロードの値を特定するXPATH式が表示されます。

表B-15 AXF_XPATH ATTRIBUTES表の例

ATTRIBUTE_KEY

XPATH

InvoiceProcessing_ProcessingGroup

//task:processingGroup

次に示すAXF_NAMESPACES表のXMLNS_URI列の内容は、XMLファイル内のどの場所にprocessingGroupのタスク情報があるかを表しています。

表B-16 AXF_XPATH_NAMESPACES表の例

Prefix

XMLNS_URI

task

http://xmlns.oracle.com/bpel/workflow/task

B.1.8 AXF_XPATH_NAMESPACES表

次に示す表は、XPATHの属性に使用されるネームスペースを定義します。これは、AXF_XPATH_ATTRIBUTES表にリンクしています。

B.1.8.1 列の説明

表B-17 AXF_XPATH_NAMESPACES表の列の説明

列

説明

PREFIX

XPATHで使用されるネームスペース接頭辞。

XMLNS_URI

一意の識別子となります。

B.1.8.2 実装例

表B-18 AXF_XPATH_NAMESPACES表の例

Prefix

XMLNS_URI

task

http://xmlns.oracle.com/bpel/workflow/task

documentContent

http://xmlns.oracle.com/imaging/axf/documentContentTypes

solution

http://xmlns.oracle.com/imaging/axf/solutionTypes

invoiceProcessing

http://xmlns.oracle.com/imaging/axf/InvoiceProcessing

xml

http://www.w3.org/XML/1998/namespace

B.2 BPELイメージング・ソリューションのためのAXFのユーザー・コンポーネント

この項の内容は次のとおりです。

- 第B.2.1項「ソリューション・エディタ」

- 第B.2.2項「タスク・リストWebツール」

- 第B.2.3項「タスク・ビューアWebツール」

- 第B.2.4項「列挙ピッカーWebツール」

- 第B.2.5項「アイデンティティ・ピッカーWebツール」

- 第B.2.6項「アカウント配布コーディング・フォーム(Oracle E-Business Suiteのみ)」

B.2.1 ソリューション・エディタ

BPELイメージング・ソリューションの初期構成(ソリューション・アクセラレータまたはこの付録で説明する表を使用)の後に、Imagingのソリューション・エディタを使用してユーザー・インタフェースのコンポーネントに変更を加えることができます。ソリューション・エディタの詳細は、Oracle Fusion Middleware Oracle WebCenter Content: Imagingの管理のソリューション・エディタ・ページに関する説明を参照してください。

たとえば、ソリューション・エディタは次のようなタスクに使用できます。

- タスク・リストでユーザーに対して表示されるプロファイル(BPELビュー)を変更する。

- タスク・ビューアでユーザーに対して表示されるタスク・アクションを変更する。

- タスク・ビューアに表示されるメタデータ項目および下部パネル・タブを変更する。

- 指定の列挙に対して列挙ピッカー・ページに表示される列挙の値を指定する。

B.2.2 タスク・リストWebツール

AXFの「タスク・リスト」Webツールは、AXFソリューションによって制御されるヒューマン・ワークフロー・タスクを表示するための、再利用可能なWebインタフェースです。

タスク・リストの機能

- 「プロファイル」リストでは、BPELの標準のビューが使用され、ユーザー/グループ、BPEL ProcessのバージョンおよびBPELペイロード属性値に基づいてタスク・リストのビューが絞り込まれます。ビューを作成したり、ビューを他のユーザーまたはグループと共有するには、BPM Worklistアプリケーションを使用します。BPEL Imagingソリューション・エディタの「一般」タブを使用して、プロファイル・リストを編集し、デフォルト・プロファイルを割り当て、ソリューション内でのコメント・ブロックの使用を指定します。詳細は、Oracle Fusion Middleware Oracle WebCenter Content: Imagingの管理の「ソリューション・エディタ」ページの「一般」タブに関する説明を参照してください。

- ユーザーがタスクを表から選択するには、その「タスクの表示」リンクをクリックします。ワークフロー・タスクが指定のBPELサーバーおよびプロセスから取り出されて、そのユーザーが引き受けたことが宣言され、タスク・ビューアに表示されます。ユーザーは、選択されたタスクを完了したら、タスク・リストに戻ります。タスク・リストとして一度に返すタスクの数を構成できます。

- 自動タスク・モードが選択されているときは、タスクは自動的にそのユーザーが引き受けたことになって開かれ、ユーザーがそのタスクを完了します。これは、1人のユーザーの全タスクの処理が完了するか、ユーザーがタスクの処理の中止を選択してタスク・リストに戻るまで続きます。ユーザーが自動タスク・モードをアクティブにするには、「自動タスク」を選択します。

- ユーザーは、割り当てられたタスクをリリースできます。その場合は、「リリース」ボタンをクリックします。これで、タスクはリリースされて、割当て可能タスクのプールに戻されます。ユーザーが、選択したタスクを獲得していない状態で「リリース」をクリックした場合は、そのタスクをリリースできないことを示すメッセージが表示されます。

- ユーザーは、列見出しをクリックしてタスクをソートできます。ユーザーは、「検索」フィールドを使用して特定のタスクを検索することもできます。詳細は、『Oracle Fusion Middleware Oracle WebCenterアプリケーション・アダプタの使用』を参照してください。

B.2.2.1 タスク・リストのパラメータ

表B-19 AXF_SOLUTION_PARAMETERS表内のタスク・リストのパラメータ

パラメータ

説明

CMD_OPEN_TASK_BUTTON

ユーザーが「タスク・リスト」Webページで「タスクの表示」リンクをクリックしたときに実行するCOMMAND_NAMESPACEを指定します。

CMD_AUTO_TASK_BUTTON

ユーザーが「タスク・リスト」Webページで「自動タスク」ボタンをクリックしたときに実行するCOMMAND_NAMESPACEを指定します。

NO_OF_LINES

複数ページに分けずに一度に表示するタスクの最大数を指定します。タスク・リストとして返すタスクの数を構成するには、AXF_SOLUTION_ATTRIBUTES表にあるTASKLIST_RANGESIZEパラメータを使用します。

VIEW_LIST

「プロファイル」フィールドでユーザーに対して表示するビュー(ヒューマン・ワークフロー・システムで定義される)のリストを指定します。

DEFAULT_VIEW

デフォルトのプロファイルを指定します。VIEW_LISTパラメータとともに使用される場合は、この値はVIEW_LIST値のリストにも含まれている必要があります。

B.2.2.2 実装例

この例では、請求書処理ソリューションのStartInvoiceProcessingコマンドが設定されます。最初の行では、Redirectコマンドを使用してタスク・リストを表示します。残りの行では、タスク・リストの動作を定義します。

Fields not shown: SOLUTION_NAMESPACE=InvoiceProcessing

表B-20 AXF_SOLUTION_PARAMETERS表内のタスク・リストのパラメータの例

COMMAND_NAMESPACE

CONFIGURATION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

StartInvoiceProcessing

oracle.imaging.axf.commands.bpel.RedirectCommand

REDIRECT_URL

taskflow://WEB-INF/taskflows/axf-tasklist-tfd.xml#axf-tasklist-tfd

StartInvoiceProcessing

oracle.imaging.axf.web.backing.TaskList

CMD_OPEN_TASK_BUTTON

OpenTask

StartInvoiceProcessing

oracle.imaging.axf.web.backing.TaskList

CMD_AUTO_TASK_BUTTON

AutoOpenTask

StartInvoiceProcessing

oracle.imaging.axf.web.backing.TaskList

DEFAULT_VIEW

(Null)

StartInvoiceProcessing

oracle.imaging.axf.web.backing.TaskList

SHOW_INBOX

FALSE

StartInvoiceProcessing

oracle.imaging.axf.web.backing.TaskList

VIEW_LIST

North Invoice Processing Group、South Invoice Processing Group、East Invoice Processing Group、West Invoice Processing Group、My Holds、Exceptions

B.2.3 タスク・ビューアWebツール

AXFの「タスク・ビューア」Webツールは、ヒューマン・ワークフロー・タスクに関連付けられたコンテンツを表示する、再利用可能なWebインタフェースです。一般的な構成では、ビジネス・ユーザーはタスク・ビューアをモニターの1つで表示して、イメージに表示されている値を別のモニターのビジネス・アプリケーションに入力します。

構成後は、BPEL Imagingソリューション・エディタを使用してタスク・ビューアに次の変更を加えます。

- アクション・メニューの表示ラベルを編集し、メニュー項目の順序を定義し、メニュー項目を表示するか非表示にするかを指定してメニュー項目のラベルを編集します。Oracle Fusion Middleware Oracle WebCenter Content: Imagingの管理の「ソリューション・エディタ」ページの「アクション」タブに関する項を参照してください。

- メタデータ・ブロック・ラベルを編集し、メタデータ項目の順序を変更し、メタデータ項目を表示するか非表示にするかを指定し、メタデータ項目のラベルを編集し、動的データ表(下部パネル)の表示を変更します。Oracle Fusion Middleware Oracle WebCenter Content: Imagingの管理の「ソリューション・エディタ」ページの「タスク・ビューア」タブに関する項を参照してください。

Webページのカスタマイズは、データベース構成を通して行うこともできます。

タスク・ビューアの機能

- ユーザーはイメージ・ドキュメントを「イメージ・ビューア」ペインで、「基本」または「詳細」のイメージング・ビューア・モードで表示します。タスク・ビューアでは、Imagingビューア・ツールを使用してイメージ・ドキュメントがレンダリングされます。

- ユーザーは、横の「タスク・アクション」ペインでアクションを選択できます(このように構成されている場合)。選択すると、ソリューションのAXFコマンドが起動されます。管理者は、「タスク・アクション」ペインをAXF_ACTION_MENU表で有効化し、AXFのコマンドを起動するためのアクション・リンクをAXF_ACTIONS表で構成し、コマンドそのものをAXF_COMMANDS表で構成します。自動タスク・モードが選択されている場合は、ユーザーはタスク・リストに戻ることによってこのモードを無効化します。戻るには、「タスク・アクション」ペインにある「タスク・リストに戻る」リンクをクリックするのが一般的です。

- ユーザーは「サマリー」セクションを表示できます(そのように構成されている場合)。このセクションには、そのタスクに関するメタデータの値が表示されます。管理者は、この項目が表示されるように、AXF_METADATA_BLOCKS表およびAXF_METADATA_ATTRIBUTES表で構成します。このセクションのタイトルと、表示されるタスク・ペイロードの値も構成できます。

- ユーザーは「コメント」セクションを表示できます(そのように構成されている場合)。このセクションでは、コメントの一部が表示され、アイコンをクリックしてコメント全体を表示することや、タスクにコメントを追加することができます。管理者は、コメントが表示されるようにAXF_METADATA_BLOCKS表で構成します。

- ユーザーは、BPELペイロードXMLからの動的データ表(下部のタブ)を表示できます(そのように構成されている場合)。たとえば、請求書処理ソリューションのGeneral Ledger行です。管理者は、この表をAXF_METADATA_BLOCKS表で構成し、データ行をAXF_METADATA_ATTRIBUTES表で構成します。詳細は、第6.4.10項を参照してください。

タスク・ビューアの構成

タスク・ビューアの構成は、次に示す表で行います。

- 第B.1.4項「AXF_SOLUTION_PARAMETERS表」

- 第B.1.5項「AXF_ACTION_MENU表」

- 第B.1.6項「AXF_ACTIONS表」

- 第B.2.3.1項「AXF_METADATA_BLOCKS表」

- 第B.2.3.2項「AXF_METADATA_ATTRIBUTES表」

B.2.3.1 AXF_METADATA_BLOCKS表

この表は、タスク・ビューアそのものと、「タスク・ビューア」ページに表示するセクションを定義します。

B.2.3.1.1 列の説明

表B-21 AXF_METADATA_BLOCKS表の列の説明

列

説明

BLOCK_ID

データベース内の行を指定します。AXF_METADATA_ATTRIBUTES表にリンクしています。

BLOCK_LOCATION

「タスク・ビューア」ページ上のどの場所にブロックを表示するかを指定します。LEFT_SIDEBARを指定すると、左サイドバー・ペインが表示されます。

LABEL

ペインのラベルを定義します(例: 「サマリー」、「コメント」)。

DISCLOSED

TRUEを指定すると、ブロックが拡張した状態で表示されます。FALSEを指定した場合は、項目は表示されますが、折りたたまれた状態になります。

DISPLAY_ORDER

ブロックを表示する順序を指定します。

TASK_FLOW_ID

メタデータ・ブロックをどのタスク・フローに対して表示するかを指定します(例: axf-taskviewer-tfd、axf-tasklist-tfd)。

SOLUTION_NAMESPACE

AXFソリューション名を指定します。

BLOCK_TYPE

ブロックの中の値のタイプを指定します(例: METADATA、COMMENT)。

METADATA_STYLE

メタデータをどのように使用するかを指定します。null (使用しない)またはtableを指定できます。

tableを指定すると、BPELペイロードXMLからの動的データの表が下部のタブに表示されます。第6.4.10.1項を参照してください。このブロックが表示されるのは、データがある場合のみです。下部パネルを非表示にするには、第6.4.10.2項を参照してください。

動的表を構成するには、次の値を指定する必要があります。

BLOCK_LOCATION = BOTTOM_PANEL

BLOCK_TYPE = METADATA

METADATA_STYLE = table

ORGANIC_MENU_ID

将来使用するために予約されています。

B.2.3.1.2 実装例

この表によって、「タスク・ビューア」ページの「サマリー」および「コメント」の各セクションが表示されます。

ここに示していない列: DISCLOSED=TRUE

ORGANIC_MENU_ID=null

表B-22 AXF_METADATA_BLOCKS表の例

BLOCK_ID

BLOCK_LOCATION

LABEL

DISPLAY_ORDER

TASK_FLOW_ID

SOLUTION_NAMESPACE

BLOCK_TYPE

METADATA_STYLE

1

LEFT_SIDEBAR

Summary

1

axf-taskviewer-tfd

InvoiceProcessing

METADATA

null

2

LEFT_SIDEBAR

Comments

2

axf-taskviewer-tfd

InvoiceProcessing

COMMENT

null

3

BOTTOM_PANEL

GL Lines

3

axf-taskviewer-tfd

InvoiceProcessing

METADATA

TABLE

B.2.3.2 AXF_METADATA_ATTRIBUTES表

この表は、AXF_METADATA_BLOCKS表で指定されたメタデータのセクションに表示される、ラベルおよび値を定義します。また、XPath属性を使用して表示する属性値をどのように取得するかも定義します。

B.2.3.2.1 列の説明

表B-23 AXF_METADATA_ATTRIBUTES表の列の説明

列

説明

BLOCK_ID

AXF_METADATA_BLOCKS表を参照します。この中にメタデータのラベルと値が表示されます。

ATTRIBUTE_ID

メタデータ属性の主キー。

LABEL

メタデータ・セクションでユーザーに対して表示されるメタデータ・ラベルを指定します(たとえば、「サマリー」セクションの「ステータス」)。

動的データ表が指定されているときは、このラベルが列見出しになります。

ATTRIBUTE_KEY

この属性がBPELタスク内で更新されるのは、ユーザーが「タスク・ビューア」ページの「OK」ボタンをクリックしたときです。属性値はシステム属性名か(第B.3.6.2項を参照)、XPATHという接頭辞付きです。後者の場合は、XPath表を使用して値が検出されます。動的データ表に対しては、XPATHのみがサポートされます。

IS_XPATHの値がTRUEの場合は、attribute_keyの値はAXF_XPATH_ATTRIBUTES表に存在し、そのXPATHを使用してタスク・ペイロード内の値が更新されます。

IS_XPATH

TRUEの場合は、属性値はBPELペイロード内のXPATHから取得されます。FALSEの場合は、値はシステム属性またはフレックス・フィールド属性から取得されます。

DISPLAY_ORDER

メタデータのラベル/値をメタデータ・セクションに表示する順序を指定します。

動的データ表の場合は、列の順序を指定します。

DATA_TYPE

メタデータ項目のデータ型を指定します(例: String)。

動的データ表の場合は、この値はSTRINGであることが必要です。

B.2.3.2.2 実装例

表B-24は、図B-2に示すようにタスク・ビューアの「サマリー」セクションに表示されるメタデータのラベルと値を定義するものです。別の例は、第6.4.10項を参照してください。

ここに示していない列:

DATA_TYPE=String

表B-24 「サマリー」セクションのためのAXF_METADATA_ATTRIBUTES表の例

BLOCK_ID

ATTRIBUTE_ID

LABEL

ATTRIBUTE_KEY

IS_XPATH

DISPLAY_ORDER

1

1

Status

InvoiceProcessing_Status

TRUE

0

1

2

Exception Code

InvoiceProcessing_ExceptionCode

TRUE

1

1

3

Processing Group

InvoiceProcessing_ProcessingGroup

TRUE

2

1

4

Invoice Number

InvoiceProcessing_InvoiceNumber

TRUE

3

1

5

Supplier Name

InvoiceProcessing_SupplierName

TRUE

4

1

6

Supplier Site

InvoiceProcessing_SupplierSiteName

TRUE

5

B.2.3.3 コメント

「コメント」ペインでは、ユーザーが、トランザクションの処理中にヒューマン・タスクに関連するコメントを表示および入力することができます。管理者は、コメントの構成をAXF_METADATA_BLOCKS表で行います。第1.3.3.5項も参照してください。

「コメント」フィールドを表示するかどうかを、Imagingのソリューション・エディタの「一般」タブで指定できます。Oracle Fusion Middleware Oracle WebCenter Content: Imagingの管理の「ソリューション・エディタ」ページの「一般」タブに関する項を参照してください。コメントは、タスク・ビューア・ページ、アイデンティティ・ピッカー・ページおよび列挙ピッカー・ページに表示できます。

B.2.4 列挙ピッカーWebツール

列挙ピッカーWebツールを利用すると、AXFの表で構成された値のリストからユーザーが選択できるようになります。たとえば、次の図に示した列挙ピッカーには、「Processing Group」というドロップダウン・フィールドが表示され、このドロップダウンの値は「North」、「South」、「East」および「West」となっています。

ユーザーが値を選択すると、その値でBPELペイロード内の値が更新されてから、構成済のコマンドが実行されます。一般的には、タスク・ビューアに戻るためのコマンドか、そのコマンドを完了するためのコマンドです。

管理者は、列挙ピッカーの構成を次の表で行います。

- ピッカーの構成パラメータをAXF_SOLUTION_PARAMETERS表で定義します(表B-25を参照)。ピッカーをAXF_ENUM_TYPES表で定義します。

- ピッカーの値をAXF_ENUM_ITEMS表で定義します。

構成済の列挙を、Imagingのソリューション・エディタで編集できます。「列挙」タブで、列挙の追加、削除、順序の変更や、選択可能な値の指定ができます。Oracle Fusion Middleware Oracle WebCenter Content: Imagingの管理の「ソリューション・エディタ」ページの「列挙」タブに関する項を参照してください。

B.2.4.1 列挙ピッカーのパラメータ

表B-25 AXF_SOLUTION_PARAMETERS表内の列挙ピッカーのパラメータ

パラメータ

説明

LOV_REFERENCE

この値リスト参照は、AXF_ENUM_TYPES表にリンクしています。この表のID値がAXF_ENUM_ITEMS表にリンクしており、この表にすべてのピッカー値が格納されています。

ATTRIBUTE_NAME

この属性がBPELタスク内で更新されるのは、ユーザーが列挙ピッカーWebページの「OK」ボタンをクリックしたときです。属性値は定数です。第B.3.6.2項を参照してください。

値にXPATH:という接頭辞が付いている場合は、値はAXF_XPATH_ATTRIBUTES表に存在し、このXPATHを使用してタスク・ペイロード内の値が更新されます。

CMD_ON_CANCEL

ユーザーが列挙ピッカー・ページで「取消」ボタンをクリックしたときに実行するコマンド(COMMAND_NAMESPACE)を指定します。

CMD_ON_OK

ユーザーが列挙ピッカー・ページで「OK」ボタンをクリックしたときに実行するコマンド(COMMAND_NAMESPACE)を指定します。

ATTRIBUTE_LABEL

BPELタスク内で更新される属性に対してWebページ上に表示される、ラベル名を指定します。

DEFAULT_VALUE

ピッカーのデフォルト値を指定します。デフォルトが指定されていない場合は、空白値が表示されます。

DEFAULT_ALWAYS

列挙ピッカーを表示するときに、別の値が選択済かどうかにかかわらず、DEFAULT_VALUEパラメータで指定された値を必ず表示する場合は、TRUEを指定します。それ以外の場合は、FALSEを指定します。

実装例

この例で表示される列挙ピッカーは、処理グループを選択するために参照されます。

Fields not shown: SOLUTION_NAMESPACE=InvoiceProcessing

表B-26 AXF_SOLUTIONS表内の列挙ピッカーのパラメータの例

COMMAND_NAMESPACE

CONFIGURATION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

AssignProcessingGroupEdit

oracle.imaging.axf.web.backing.EnumerationPicker

LOV_REFERENCE

ProcessingGroups

AssignProcessingGroupEdit

oracle.imaging.axf.web.backing.EnumerationPicker

ATTRIBUTE_LABEL

Processing Group

AssignProcessingGroupEdit

oracle.imaging.axf.web.backing.EnumerationPicker

CMD_ON_OK

AssignProcessingGroupComplete

AssignProcessingGroupEdit

oracle.imaging.axf.web.backing.EnumerationPicker

ATTRIBUTE_NAME

XPATH:InvoiceProcessing_ProcessingGroup

AssignProcessingGroupEdit

oracle.imaging.axf.web.backing.EnumerationPicker

CMD_ON_CANCEL

OpenTask

AssignProcessingGroupEdit

oracle.imaging.axf.web.backing.EnumerationPicker

DEFAULT_VALUE

North

AssignProcessingGroupEdit

oracle.imaging.axf.web.backing.EnumerationPicker

DEFAULT_ALWAYS

FALSE

B.2.4.2 AXF_ENUM_TYPES表

この表は、列挙ピッカーを定義します。

列の説明

表B-27 AXF_ENUM_TYPES表の列の説明

列

説明

ENUMERATION_ID

列挙ピッカーのIDを指定します。

ENUMERATION_NAME

列挙ピッカー構成の名前を指定します。

実装例

この例では、請求書処理ソリューションの列挙ピッカーが定義されます。各ピッカーの項目は、AXF_ENUM_ITEMS表で定義します。

表B-28 AXF_ENUM_TYPES表の例

ENUMERATION_ID

ENUMERATION_NAME

1

ProcessingGroups

2

SupplierMaintenanceCodes

3

SpecialistExceptionCodes

4

RescanCodes

B.2.4.3 AXF_ENUM_ITEMS表

この表は、指定された列挙ピッカーの値を定義します。

列の説明

表B-29 AXF_ENUM_ITEMS表の列の説明

列

説明

ENUMERATION_ID

ピッカーのIDを指定します。これは、AXF_ENUM_TYPES表で定義されます。

ITEM_ID

ピッカー項目のIDを指定します。

DISPLAY_LABEL

ピッカー・フィールドに表示される項目名を指定します。

ATTRIBUTE_KEY

ペイロードに格納するリテラル値を指定します。この値は、多くの場合はDISPLAY_LABELの値と同じですが、異なっていてもかまいません。

LIST_ORDER

ピッカー・フィールドに値を一覧表示するときの順序を指定します。

実装例

この例では、ProcessingGroups、SupplierMaintenanceCodes、SpecialistExceptionCodesおよびRescanCodesの各列挙ピッカーの項目を定義します。これらのピッカーは、AXF_ENUM_TYPES表で定義されます。

表B-30 AXF_ENUM_ITEMS表の例

ENUMERATION_ID

ITEM_ID

DISPLAY_LABEL

ATTRIBUTE_KEY

LIST_ORDER

1

1

North

North

1

1

2

South

South

2

1

3

East

East

3

1

4

West

West

4

2

5

No Supplier

No Supplier

1

2

6

No Supplier Site

No Supplier Site

2

3

7

Duplicate Invoice

Duplicate Invoice

1

3

8

Invalid Invoice Number

Invalid Invoice Number

2

3

9

No PO

No PO

3

3

10

Invalid PO

Invalid PO

4

3

11

PO Overbill

PO Overbill

5

4

12

Poor Image Quality

Poor Image Quality

1

4

13

Pages Out of Order

Pages Out of Order

2

4

14

Pages Missing

Pages Missing

3

4

15

Other

Other

4

B.2.5 アイデンティティ・ピッカーWebツール

アイデンティティ・ピッカーWebツールを使用すると、BPELのために構成されたアイデンティティ・ストアからユーザーがユーザーやグループを選択できるようになります。一般的には、アイデンティティが選択されると、関連アクションが実行されます。たとえば、タスクの割当てや委任です。アイデンティティの選択後に実行されるアクションの構成は、AXF_SOLUTION_PARAMETERS表で行います。

注意:

このコマンドによってタスク・ペイロードが更新されるのは、ユーザーが「OK」をクリックしたときです。BPELプロセスは、この情報を使用してタスクを委任する処理を担当します。

B.2.5.1 アイデンティティ・ピッカーのパラメータ

表B-31 AXF_SOLUTION_PARAMETERS表内のアイデンティティ・ピッカーのパラメータ

パラメータ・キー

説明

CMD_ON_CANCEL

ユーザーがアイデンティティ・ピッカー・ページで「取消」ボタンをクリックしたときに実行するコマンド(COMMAND_NAMESPACE)を指定します。

CMD_ON_OK

ユーザーがアイデンティティ・ピッカー・ページで「OK」ボタンをクリックしたときに実行するコマンド(COMMAND_NAMESPACE)を指定します。

IDENTITY_FILTER

アイデンティティ・ピッカーの検索方法を定義します。

- USER: ピッカーは、BPEL内で定義されているユーザー情報を検索します。

- GROUP: ピッカーは、BPEL内で定義されているグループ情報を検索します。

注意: 1つのコマンドに対してUSERまたはGROUPを指定します。両方の検索タイプを使用できるようにするには、別のコマンドを作成し、そのコマンドで他方のタイプを使用してアイデンティティ・ピッカーを開くようにしてください。たとえば、AssignByGroupコマンドとAssignByUserコマンドを作成します。

IDENTITY_FILTER_ATTRIBUTE

アイデンティティ・ピッカーのワイルドカード検索を定義します。

- TRAILING: アスタリスク(*)を検索値の末尾に追加します。例: jc*

- LEADING: アスタリスク(*)を検索値の先頭に追加します。例: *cooper

- BOTH (デフォルト): アスタリスク(*)を検索値の先頭と末尾に追加します。例: *jc*

- NONE: 検索値にアスタリスクを追加しません。この設定が役に立つのは、ワイルドカード文字が原因で検索に時間がかかる可能性がある場合です。

注意: このパラメータの値としてnullを指定すると、アスタリスクが検索値の先頭と末尾に追加されます(デフォルトの設定)。

IDENTITY_ATTRIBUTE

この属性がBPELタスク内で更新されるのは、ユーザーがアイデンティティ・ピッカー・ページの「OK」をクリックしたときです。属性値は、システム属性で定義されている定数です。第B.3.6.2項を参照してください。

値にXPATH:という接頭辞が付いている場合は、値はAXF_XPATH_ATTRIBUTES表に存在し、このXPATHを使用してタスク・ペイロード内の値が更新されます。

B.2.5.2 実装例

この例に示すInvoiceApprovalEditコマンドは、BPEL内に格納されているユーザー情報を検索し、XPATH変数を使用してBPELタスクを更新します。

Fields not shown: SOLUTION_NAMESPACE=InvoiceProcessing

表B-32 AXF_SOLUTION_PARAMETERS表内のアイデンティティ・ピッカーのパラメータの例

COMMAND_NAMESPACE

CONFIGURATION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

InvoiceApprovalEdit

oracle.imaging.axf.web.backing.IdentityPicker

IDENTITY_FILTER

USER

InvoiceApprovalEdit

oracle.imaging.axf.web.backing.IdentityPicker

IDENTITY_FILTER_ATTRIBUTE

NONE

InvoiceApprovalEdit

oracle.imaging.axf.web.backing.IdentityPicker

CMD_ON_CANCEL

OpenTask

InvoiceApprovalEdit

oracle.imaging.axf.web.backing.IdentityPicker

IDENTITY_ATTRIBUTE

XPATH:InvoiceProcessing_InvoiceApprovalAssignment

InvoiceApprovalEdit

oracle.imaging.axf.web.backing.IdentityPicker

CMD_ON_OK

InvoiceApprovalComplete

B.2.6 アカウント配布コーディング・フォーム(Oracle E-Business Suiteのみ)

AXFアカウント配布コーディング・フォームは、請求書に対する詳細なアカウント配布情報を入力および選択するための、再利用可能なWebインタフェースです。図B-3に示すコーディング・フォームは、POなしの請求書に明細項目情報が必要である場合に使用されるものです。この場合は、認可を受けたユーザーはこのページにアカウント配布タスク・リストからアクセスし、アカウント配布コードを入力します。

図B-3 アカウント配布コーディング・フォームの例

アカウント配布コーディング・フォームに関する重要事項

- このコーディング・フォームを使用できるのは、Oracle E-Business Suiteに対してのみです。

- このコーディング・フォームは、Oracle E-Business Suiteシステムに対してルックアップを実行します。このルックアップを可能にするために、Oracle WebCenter Imaging WebLogic管理対象サーバーに対してJDBCデータソースが設定されている必要があります。このJDBCデータソースの設定方法は、ソリューション・アクセラレータのドキュメントを参照してください。

- このコーディング・フォームは、ソリューション・アクセラレータ経由で起動されます。第6.2項を参照してください。このコーディング・フォームを使用するには、ソリューションをデプロイおよび構成するとともに、サポートのためのAXFのコマンドおよびソリューション・パラメータを設定する必要があります。

- フォームの右上部分のボタン(「承認」、「却下」、「再割当て」、「保存」、「取消」および「未払請求書」)は、AXFの表を通して構成できます。

次に示す各項では、このコーディング・フォームに関する全般的な構成情報を示します。

- 第B.2.6.1項「コーディング・フォームのルックアップ要素のためのAXF_LOOKUPSスクリプト」

- 第B.2.6.2項「アカウント配布コーディング・フォーム・ソリューションの例」

- 第B.2.6.3項「アカウント配布コーディング・フォームのサポート・コマンドの例」

- 第B.2.6.4項「OpenTaskコマンドおよびAutoOpenTaskコマンドの例」

B.2.6.1 コーディング・フォームのルックアップ要素のためのAXF_LOOKUPSスクリプト

AXF_LOOKUPS.sqlスクリプトによって、コーディング・フォームのためのルックアップ要素が作成されます。これは、Oracle E-Business SuiteデータベースのAPPSユーザーとしてAPPSスキーマの下で実行する必要があります。

1. Oracle E-Business SuiteデータベースのAPPSスキーマに、適切なAPPSユーザーとして接続します。

2. 必要に応じて、既存のコーディング・フォーム・ルックアップ・パッケージをアンインストールします。
このステップを実行する必要があるのは、既存のシステムの更新/パッチ適用を実行しようとしているときに、そのシステムにAXF_LOOKUPSコーディング・フォーム・ルックアップ・パッケージがインストール済である場合のみです。

DROP TYPE AXF_LOOKUPS_SEGMENT_VALUE_COL;
show errors
DROP TYPE AXF_LOOKUPS_SEGMENT_OBJ;
show errors
DROP PACKAGE AXF_LOOKUPS;
show errors

3. AXF_LOOKUPSスクリプトを実行します。
このスクリプトは、Oracle E-Business Suiteアダプタの一部として配布されます。これが存在する場所は次のいずれかであり、Oracle E-Business Suiteのリリースによって決まります。

- MW_HOME/ECM_HOME/axf/adapters/ebs/R11/

- MW_HOME/ECM_HOME/axf/adapters/ebs/R12/

次のコマンドを入力して、スクリプトを実行します。

@AXF_LOOKUPS.sql

B.2.6.2 アカウント配布コーディング・フォーム・ソリューションの例

表B-33に、アカウント配布のソリューションの例を示します。

表B-33 アカウント配布コーディング・フォームのためのAXF_SOLUTIONS表の例

SOLUTION_NAMESPACE

SOLUTION_CONTEXT

AccountDistribution

ejb.AxfCommandMediator#oracle.imaging.axf.service.AxfCommandMediatorRemote

B.2.6.3 アカウント配布コーディング・フォームのサポート・コマンドの例

表B-34は、アカウント配布コーディング・フォーム・ソリューションをサポートするAXFコマンドの例の一覧です。

表B-34 アカウント配布コーディング・フォームのためのAXF_COMMANDS表の例

SOLUTION_NAMESPACE

COMMAND_CLASS

COMMAND_NAMESPACE

説明

AccountDistribution

oracle.imaging.axf.commands.bpel.CompleteTaskCommand

AccountDistributionApprove

コーディング・フォームの「承認」ボタンのためのコマンドを作成します。

AccountDistribution

oracle.imaging.axf.commands.bpel.ReleaseTaskCommand

AccountDistributionCancel

コーディング・フォームの「取消」ボタンのためのコマンドを作成します。

AccountDistribution

oracle.imaging.axf.commands.bpel.CompleteTaskCommand

AccountDistributionReject

コーディング・フォームの「却下」ボタンのためのコマンドを作成します。

AccountDistribution

oracle.imaging.axf.commands.bpel.CompleteTaskCommand

AccountDistributionRequestInfo

コーディング・フォームの「リクエスト情報」ボタンのためのコマンドを作成します。

AccountDistribution

oracle.imaging.axf.commands.system.RedirectCommand

AssignUser

コーディング・フォームの「再割当て」ボタンのためのコマンドを作成します。

AccountDistribution

oracle.imaging.axf.commands.bpel.CompleteTaskCommand

AssignUserComplete

ユーザーをアイデンティティ・ピッカーにリダイレクトするためのコマンドを作成します。

AccountDistribution

oracle.imaging.axf.commands.bpel.AutotaskCommand

AutoOpenTask

タスク・リストでの自動タスク操作のためのコマンドを作成します。

AccountDistribution

oracle.imaging.axf.commands.bpel.OpenTaskCommand

OpenTask

タスク・リスト上にOpenTaskコマンド・リンクを作成します。

AccountDistribution

oracle.imaging.axf.commands.system.RedirectCommand

StartAccountDistribution

ユーザーをタスク・リストからコーディング・フォームにリダイレクトするためのコマンドを作成します。

B.2.6.4 OpenTaskコマンドおよびAutoOpenTaskコマンドの例

OpenTaskコマンドおよびAutoOpenTaskコマンドのオプションが、コーディング・フォームのソリューションに対して構成されます。表B-35に、OpenTaskのオプションの例を示します。

ここに示していないフィールド: SOLUTION_NAMESPACEおよびCOMMAND_NAMESPACE

表B-35 アカウント配布コーディング・フォームのためのAXF_SOLUTION_PARAMETERS表の例

CONFIGURATION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

説明

oracle.imaging.axf.web.backing.Coding

CMD_APPROVE

AccountDistributionApprove

ユーザーがコーディング・フォームの「承認」ボタンをクリックしたときに実行するCOMMAND_NAMESPACE。

oracle.imaging.axf.web.backing.Coding

CMD_CANCEL

AccountDistributionCancel

ユーザーがコーディング・フォームの「取消」ボタンをクリックしたときに実行するCOMMAND_NAMESPACE。

oracle.imaging.axf.web.backing.Coding

CMD_REASSIGN

AssignUser

ユーザーがコーディング・フォームの「再割当て」ボタンをクリックしたときに実行するCOMMAND_NAMESPACE。

oracle.imaging.axf.web.backing.Coding

CMD_REJECT

AccountDistributionReject

ユーザーがコーディング・フォームの「却下」ボタンをクリックしたときに実行するCOMMAND_NAMESPACE。

oracle.imaging.axf.web.backing.Coding

CMD_REQUEST_INFO

AccountDistributionRequestInfo

ユーザーがコーディング・フォームの「リクエスト情報」ボタンをクリックしたときに実行するCOMMAND_NAMESPACE。

oracle.imaging.axf.web.backing.Coding

DISABLE_PROJECT

FALSE

コーディング・フォーム上の「プロジェクト」ルックアップ・ボックスを無効にするフラグ。

oracle.imaging.axf.web.backing.Coding

READ_ONLY

TRUE

ユーザーがコーディング・フォーム上の値を入力および編集できるか(FALSE、デフォルト)、読取り専用値として表示するか(TRUE)を指定します。

B.3 BPELイメージング・ソリューションのためのAXFのコマンド

BPEL AXFのコマンドは次のとおりです。

- 第B.3.1項「Open Taskコマンド」

- 第B.3.2項「Autotaskコマンド」

- 第B.3.3項「Release Taskコマンド」

- 第B.3.4項「Complete Taskコマンド」

- 第B.3.5項「Redirectコマンド」

- 第B.3.6項「Update Taskコマンド(BPEL)」

- 第B.3.7項「Update Task From Procedureコマンド」

- 第B.3.8項「Terminate Conversationコマンド」

- 第B.3.9項「Validate Taskコマンド」

注意:

AXFを使用して実行するために、カスタム・コマンドおよび連鎖コマンドをデプロイすることもできます。6.4.8項および6.4.9項を参照してください。

B.3.1 Open Taskコマンド

このコマンドは、指定のタスクIDのタスクをBPEL (ヒューマン・ワークフロー)から取得します。この指定されたタスクとは、多くの場合はタスク・リストから選択されたものです。そのタスクが、ユーザーによる取得が可能なものである場合は、このコマンドによってタスクの詳細が取得されて、指定のWebページ上に表示されます。

B.3.1.1 Open Taskコマンドのパラメータ

表B-36は、このコマンドの構成パラメータの一覧です。AXF_SOLUTION_PARAMETERS表内のこれらのパラメータを使用してコマンドを構成します。

表B-36 OpenTaskコマンドのパラメータ

パラメータ・キー

説明

TASK_VIEW_URL

このタスク・フローは、このコマンドの実行時にレスポンス・コマンドで返されます。

TASK_VIEW_URLパラメータの値では、次の文字列の1つを使用してタスク・フローを表します。各文字列は、taskflow:がhttpのかわりのプロトコルである、特別なURLと考えることができます。

- taskflow://WEB-INF/taskflows/axf-tasklist-tfd.xml#axf-tasklist-tfd (タスク・リストを表示します)

- taskflow://WEB-INF/taskflows/axf-taskviewer-tfd.xml#axf-taskviewer-tfd (タスク・ビューアを表示します)

- taskflow://WEB-INF/taskflows/axf-identity-picker-tfd.xml#axf-identity-picker-tfd (アイデンティティ・ピッカーを表示します)

- taskflow://WEB-INF/taskflows/axf-enumeration-picker-tfd.xml#axf-enumeration-picker-tfd (列挙ピッカーを表示します)

- taskflow://WEB-INF/taskflows/axf-comments-tfd.xml#axf-comments-tfd (コメントを表示します)

B.3.1.2 実装例

この例では、OpenTaskコマンドを使用して請求書処理ソリューションのタスク・ビューアを表示します。

Fields not shown: SOLUTION_NAMESPACE=InvoiceProcessing

表B-37 AXF_SOLUTION_PARAMETERS表内のOpen Taskコマンドの例

COMMAND_NAMESPACE

CONFIGURATION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

OpenTask

oracle.imaging.axf.commands.bpel.OpenTaskCommand

TASK_VIEW_URL

taskflow://WEB-INF/taskflows/axf-taskviewer-tfd.xml#axf-taskviewer-tfd

B.3.2 Autotaskコマンド

このコマンドは、自動タスク・モードを表示します。このモードでは、新しいヒューマン・ワークフロー・タスクは自動的に、そのユーザーが引き受けたことになります。第6.4.4項も参照してください。

B.3.2.1 Autotaskコマンドのパラメータ

AXF_SOLUTION_PARAMETERS表内のパラメータを使用してAutotaskのコマンドを構成します。

表B-38 AXF_SOLUTION_PARAMETERS表内のAutotaskコマンドのパラメータ

パラメータ・キー

説明

TASK_VIEW_URL

このコマンドの実行時にレスポンス・コマンドで返されるタスク・フロー。

CMD_ON_NO_TASKS

タスクがないときに実行するCOMMAND_NAMESPACE。

BPEL_TRY_AUTO

次のタスクをヒューマン・ワークフロー・システムから取得する処理の試行間隔(ミリ秒)。

B.3.2.2 実装例

この例では、Autotaskコマンドを使用して自動的にタスクを引き受け、請求書処理ソリューションのタスク・ビューアに表示します。

Fields not shown: SOLUTION_NAMESPACE=InvoiceProcessing

表B-39 AXF_SOLUTION_PARAMETERS表内のAutotaskコマンドのパラメータ

COMMAND_NAMESPACE

CONFIGURATION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

AutoOpenTask

oracle.imaging.axf.commands.bpel.AutotaskCommand

TASK_VIEW_URL

taskflow://WEB-INF/taskflows/axf-taskviewer-tfd.xml#axf-taskviewer-tfd

AutoOpenTask

oracle.imaging.axf.commands.bpel.AutotaskCommand

CMD_ON_NO_TASKS

StartInvoiceProcessing

AutoOpenTask

oracle.imaging.axf.commands.bpel.AutotaskCommand

BPEL_TRY_AUTO

3000

B.3.3 Release Taskコマンド

Release Taskコマンドは、ヒューマン・ワークフロー・タスクをリリースします。このコマンドの完了後に実行するアクションを構成するには、CMD_AUTOTASK_ONパラメータおよびCMD_AUTOTASK_OFFパラメータを使用します。

B.3.3.1 Release Taskコマンドのパラメータ

表B-40は、このコマンドの構成パラメータの一覧です。AXF_SOLUTION_PARAMETERS表内のこれらのパラメータを使用してコマンドを構成します。

表B-40 Release Taskコマンドのパラメータ

パラメータ・キー

説明

CMD_AUTOTASK_OFF

AUTOTASKモードがオフのときに実行するコマンド(COMMAND_NAMESPACE)を指定します。

CMD_AUTOTASK_ON

AUTOTASKモードがオンのときに実行するコマンド(COMMAND_NAMESPACE)を指定します。

B.3.3.2 実装例

Fields not shown: SOLUTION_NAMESPACE=InvoiceProcessing

表B-41 AXF_SOLUTION_PARAMETERS表内のRelease Taskコマンドの例

COMMAND_NAMESPACE

CONFIGURATION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

SkipTask

oracle.imaging.axf.commands.bpel.ReleaseTaskCommand

CMD_AUTOTASK_OFF

StartInvoiceProcessing

SkipTask

oracle.imaging.axf.commands.bpel.ReleaseTaskCommand

CMD_AUTOTASK_ON

AutoTaskOpen

ReleaseTask

oracle.imaging.axf.commands.bpel.ReleaseTaskCommand

CMD_AUTOTASK_OFF

StartInvoiceProcessing

ReleaseTask

oracle.imaging.axf.commands.bpel.ReleaseTaskCommand

CMD_AUTOTASK_ON

StartInvoiceProcessing

B.3.4 Complete Taskコマンド

Complete Taskコマンドは、ヒューマン・タスク・ワークフロー内の指定されたタスクの属性リストと結果を更新します。このコマンドは、Update Taskコマンド(BPEL)に対して定義されたパラメータも受け取ります。

さらに、Complete Taskコマンドは、このコマンドに対するリクエスト・パラメータを使用してBPELペイロード属性値を更新することができます。このコマンドの完了後に実行するアクションを構成することもでき、構成するにはCMD_AUTOTASK_ONパラメータおよびCMD_AUTOTASK_OFFパラメータを使用します。

B.3.4.1 Complete Taskコマンドのパラメータ

表B-42は、このコマンドの構成パラメータの一覧です。AXF_SOLUTION_PARAMETERS表内のこれらのパラメータを使用してコマンドを構成します。

表B-42 CompleteTaskコマンドのパラメータ

パラメータ・キー

説明

OUTCOME

ヒューマン・ワークフロー・システムに対して定義されている結果を指定します。デフォルトでは、どのBPELプロセスでもAPPROVEおよびREJECTが使用可能であり、プロセス設計者は他にも作成できます。

CMD_AUTOTASK_ON

AUTOTASKモードがオンのときに実行するコマンド(COMMAND_NAMESPACE)を指定します。

CMD_AUTOTASK_OFF

AUTOTASKモードがオフのときに実行するコマンド(COMMAND_NAMESPACE)を指定します。

B.3.4.2 実装例

Fields not shown: SOLUTION_NAMESPACE=InvoiceProcessing

表B-43 AXF_SOLUTION_PARAMETERS表内のComplete Taskコマンドの例

COMMAND_NAMESPACE

CONFIGURATION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

DeleteInvoice

oracle.imaging.axf.commands.bpel.CompleteTaskCommand

CMD_AUTOTASK_OFF

StartInvoiceProcessing

DeleteInvoice

oracle.imaging.axf.commands.bpel.CompleteTaskCommand

CMD_AUTOTASK_ON

AutoOpenTask

DeleteInvoice

oracle.imaging.axf.commands.bpel.CompleteTaskCommand

OUTCOME

DELETE_INVOICE

B.3.5 Redirectコマンド

Redirectコマンドは、ブラウザをAXF Webツールまたはその他の外部URLにリダイレクトします。リクエスト・パラメータは内部URLのみに対して有効であり、次のものがあります。

- CID (対話ID)

- PID (パラメータ・セットID)

任意のユーザー定義リクエスト・パラメータをPIDの一部として格納します。

このコマンドは、URLをレスポンス・コマンドで返します。

表B-44は、このコマンドの構成パラメータの一覧です。AXF_SOLUTION_PARAMETERS表内のこれらのパラメータを使用してコマンドを構成します。

B.3.5.1 Redirectコマンドのパラメータ

表B-44 RedirectCommandのパラメータ

パラメータ・キー

説明

REDIRECT_URL

このURLは、このコマンドの実行時にレスポンス・コマンドで返されます。次のいずれかです。

- タスク・フロー上で1つ以上のページをロードするタスク・フローIDに対応する、タスク・フロー文字列。

- 指定されたURLにリダイレクトする、標準URL文字列。

EXTERNAL

この値がTRUEの場合は、リダイレクト・ページにCIDおよびPIDは付加されません。リダイレクトURLは外部Webサイトであり、すべてのリクエスト・パラメータはURL内に付加されます。

B.3.5.2 実装例

Fields not shown: SOLUTION_NAMESPACE=InvoiceProcessing

表B-45 AXF_SOLUTION_PARAMETERS表内のRedirectコマンドの例

COMMAND_NAMESPACE

CONFIGURATION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

StartInvoiceProcessing

oracle.imaging.axf.commands.system.RedirectCommand

EXTERNAL

FALSE

StartInvoiceProcessing

oracle.imaging.axf.commands.system.RedirectCommand

REDIRECT_URL

taskflow://WEB-INF/taskflows/axf-tasklist-tfd.xml#axf-tasklist-tfd

B.3.6 Update Taskコマンド(BPEL)

Update Taskコマンドでは、BPELタスク内の属性リスト、XMLペイロード内の値(XPATHを使用)またはシステム属性を更新できます。(XPATHの例は、第B.3.6.3項を参照してください。)

Update Taskコマンド用に独自のパラメータ・キーを作成して、システム属性またはXPATHをパラメータ値に使用することができます。AXFはリクエスト・パラメータを検索し、パラメータ・キーに一致するすべての値を見つけます(outcomeの他に)。そのタスク・ペイロードの中で使用するために、属性リストに対応するパラメータ・キーを取り出します。

BPELタスク内でペイロード以外の属性を更新するには、第B.3.6.2項に記載されているシステム属性を使用します。たとえば、UpdateTaskコマンドは、outcome (PARAMETER_KEYとして定義されます)の値をリクエスト・パラメータから受け取って、そのタスクのOUTCOME (PARAMETER_VALUEとして定義されます)属性値を更新することができます。

B.3.6.1 Update Taskコマンドのパラメータ

表B-46 UpdateTaskCommandのパラメータ

パラメータ・キー

説明

OUTCOME

ヒューマン・ワークフロー・システムに対して定義されている結果を指定します。デフォルトでは、どのBPELプロセスでもAPPROVEおよびREJECTが使用可能であり、プロセス設計者は他にも作成できます。

B.3.6.2 システム属性

システム属性

ACQUIREDBY

APPROVERS

ASSIGNEDDATE

ASSIGNEDGROUP //更新できません

ASSIGNEDUSER //更新できません

CREATEDATE

CREATOR

DATEATTRIBUTE1-DATEATTRIBUTE5

EXPIREDDATE

ENDDATE

FORMATTRIBUTE1-FORMATTRIBUTE5

FROMUSER

NUMBERATTRIBUTE1-NUMBERATTRIBUTE5

OUTCOME

OWNERGROUP

OWNERUSER

PRIORITY

STATE

TASKID

TASKNUMBER //更新できません

TITLE

TASKDEFINITIONNAME

TEXTATTRIBUTE1-TEXTATTRIBUTE10

UPDATEDBY

URLATTRIBUTE1 - URLATTRIBUTE5

B.3.6.3 実装例

この例では、2つの属性が同じコマンド・ネームスペース、UpdateHelloBPELによって更新されることを示します。HelloBPELの詳細は、『Oracle Fusion Middleware Oracle WebCenter Contentのインストールと構成』のHelloBPELを使用したAXFインストールの検証に関する項を参照してください。

ここに示していないフィールド: SOLUTION_NAMESPACE=HelloBPEL

表B-47 AXF_SOLUTION_PARAMETERS表内のUpdateTaskCommandのパラメータの例

COMMAND_NAMESPACE

CONFIGURATION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

UpdateHelloBPEL

oracle.imaging.axf.commands.bpel.UpdateTaskCommand

String1

XPATH:HelloBPEL_String1

UpdateHelloBPEL

oracle.imaging.axf.commands.bpel.UpdateTaskCommand

String2

XPATH:HelloBPEL_String2

B.3.7 Update Task From Procedureコマンド

Update Task From Procedureコマンドは、指定したデータソースを使用してストアドPL/SQLプロシージャをコールし、XPATHを使用してタスク・ペイロードを更新します。実装例については第B.3.7.2項、ストアドPL/SQLプロシージャの例については第B.3.7.3項を参照してください。

B.3.7.1 Update Task From Procedureコマンドのパラメータ

表B-48 UpdateTaskFromProcedureコマンドのパラメータ

パラメータ・キー

説明

XPATH_DATASTRING

AXF_XPATH_ATTRIBUTES表に含まれるXPATH変数を指定し、返されたデータのリストが保存されるXPATHを参照します。

XPATH_MESSAGESTRING

XPATH変数を指定すると、UpdateFromStoredProcedure関数によって、データがBPELペイロードに書き込まれ、基本ステータス、または関数(axfretrieveuserlist)の実行中に発生したエラー・コードが通信されます。

CMD_NO_DATA

PL/SQLファンクションから結果が返されない場合は、このコマンドを指定して実行します。

CMD_DATA

PL/SQLファンクションから結果が返される場合は、このコマンドを指定して実行します。

CMD_ERROR

PL/SQLファンクションからエラーが返される場合は、このコマンドを指定して実行します。

JNDI_DS

Application Serverに構成されているJNDIデータソース名を指定し、PL/SQLファンクションの実行に使用します。

PLSQL_PROC

コールするPL/SQLファンクション名を指定します。

B.3.7.2 実装例

この例では、Update Task From Procedureコマンドを使用して、データソース(EBSDS)によってストアドPL/SQLプロシージャでコールされたAXFRETRIEVEUSERLISTをコールします。AXFRETRIEVEUSERLISTは請求書IDを取得し、そのトランザクションの請求金額を問い合せ、その金額に基づいて請求書承認を一連のユーザーに返します。

表B-49 UpdateTaskFromProcedureCommandの例のAXF_SOLUTIONS表

SOLUTION_NAMESPACE

SOLUTION_CONTEXT

InvoiceProcessing

ejb.AxfCommandMediator#oracle.imaging.axf.service.AxfCommandMediatorRemote

表B-50 UpdateTaskFromProcedureCommandのAXF_COMMANDS表の例(ここに示していないフィールド: SOLUTION_NAMESPACE=InvoiceProcessing)

COMMAND_CLASS

COMMAND_NAMESPACE

oracle.imaging.axf.commands.bpel.UpdateTaskFromProcedureCommand

RetrieveUserList

表B-51 UpdateTaskFromProcedureCommandの例のAXF_SOLUTION_PARAMETERS表(ここに示していないフィールド: SOLUTION_NAMESPACE=InvoiceProcessing)

COMMAND_NAMESPACE

CONFIGURATION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

RetrieveUserList

oracle.imaging.axf.commands.bpel.
UpdateTaskFromProcedureCommand

XPATH_DATASTRING

XPATH:InvoiceProcessing_InvoiceApprovalAssignment

RetrieveUserList

oracle.imaging.axf.commands.bpel.
UpdateTaskFromProcedureCommand

XPATH_MESSAGESTRING

<INSERT: ペイロードを介した通信ステータスに使用するXPATH変数>

RetrieveUserList

oracle.imaging.axf.commands.bpel.
UpdateTaskFromProcedureCommand

CMD_DATA

InvoiceApprovalEdit

RetrieveUserList

oracle.imaging.axf.commands.bpel.UpdateTaskFromProcedureCommand

CMD_NO_DATA

CompleteInvoice

RetrieveUserList

oracle.imaging.axf.commands.bpel.UpdateTaskFromProcedureCommand

CMD_ERROR

StartInvoiceProcessing

RetrieveUserList

oracle.imaging.axf.commands.bpel.UpdateTaskFromProcedureCommand

JNDI_DS

jdbc/EBSDS

RetrieveUserList

oracle.imaging.axf.commands.bpel.UpdateTaskFromProcedureCommand

PLSQL_PROC

AXFRETRIEVEUSERLIST

次のAXF_XPATH_ATTRIBUTES表では、対応するXPATH列にペイロードの値を特定するXPATH式が表示されます。

表B-52 UpdateTaskFromProcedureCommandの例のAXF_XPATH ATTRIBUTES表

ATTRIBUTE_KEY

XPATH

InvoiceProcessing_InvoiceApprovalAssignment

//task:InvoiceApprovalAssignment

次に示すAXF_NAMESPACES表では、XMLNS_URI列にXMLファイル内でInvoiceApprovalAssignmentタスク情報を特定する場所が表示されます。

表B-53 UpdateTaskFromProcedureCommandの例のAXF_XPATH_NAMESPACES表

Prefix

XMLNS_URI

task

http://xmlns.oracle.com/bpel/workflow/task

B.3.7.3 タスク・ペイロードを更新するPL/SQLプロシージャの例

XMLのDOMへのロード後のPL/SQLプロシージャにより、請求書IDを取得し、そのトランザクションの請求金額を問い合せ、その金額に基づいて一連のユーザーを返します。

create or replace FUNCTION axfretrieveuserlist(xmlPayload IN VARCHAR2, pDataString OUT VARCHAR2, pMsgString OUT VARCHAR2) RETURN INTEGER IS

v_node    xmldom.DOMNode;
v_node2   xmldom.DOMNode;
v_nl      xmldom.DOMNodeList;
v_doc     xmldom.DOMDocument;
v_elem    xmldom.DOMElement;
v_parser  xmlparser.Parser;
invoiceID     VARCHAR2(256);
invoiceAmount NUMBER(8,2);
userList      VARCHAR2(256);
rtnCode      INTEGER;

BEGIN

rtnCode := 0;  -- execute CMD_NO_DATA
-- rtnCode := -1; -- execute CMD_ERROR
pmsgstring := ''; -- empty msg string
v_parser := xmlparser.newParser;
xmlparser.parseBuffer(v_parser, xmlPayload);
v_doc := xmlparser.getDocument(v_parser);
xmlparser.freeParser(v_parser);

-- Retrieve the invoice ID
v_nl := xmldom.getElementsByTagName(v_doc, 'invoiceID');
v_node := xmldom.item(v_nl, 0);
v_node2 := xmldom.getFirstChild(v_node);
invoiceID := xmldom.getNodeValue(v_node2);

-- Retrieve Invoice Amount for given invoice id
select INVOICE_AMOUNT into invoiceAmount from ap_invoices_all where INVOICE_ID = invoiceid;

if invoiceamount > 10000 then
pdatastring := 'jlondon';
rtnCode := 1;  -- execute CMD_DATA
pmsgstring := 'Additional approval required due to invoice amount.';
else
pdatastring := 'jcooper,mtwain';
rtnCode := 1;  -- execute CMD_DATA
pmsgstring := 'No further approval is required.';
end if;

RETURN rtnCode;

END;

この例を使用するには、次のステップを実行します。

1. このプロシージャを変更して、選択したペイロードからデータの特定部分を取得できるようにします。作成するPL/SQLファンクションの唯一の要件として、VARCHAR2を取り、2つのVARCHAR2 OUTパラメータを設定し、INTEGERを返すことが必要です。ファンクションの名前はAXF構成に含めます。

2. Oracle E-Business Suiteデータベース・インスタンス上でストアド・プロシージャをインストールします。プロシージャはAppsユーザーとして実行する必要があります。

3. AXFインスタンス上のAXFユーザーとして、次のコマンドを実行してAXF_ACTIONS表を更新し、新規RetrieveUserListコマンドを実行パスに挿入します。

UPDATE AXF_ACTION SET COMMAND_NAMESPACE = 'RetrieveUserList' where DISPLAY_TEXT = 'Invoice Approval' and COMMAND_NAMESPACE = 'ValidateInvoiceApprovalEdit'

B.3.8 Terminate Conversationコマンド

Terminate Conversationコマンドは、外部クライアントとAXFとの対話を終了するために使用されます。

B.3.9 Validate Taskコマンド

Validate Taskコマンドは、BPELシステム属性データまたはBPELペイロード・データを検証し、検証結果に基づいて後続コマンドを実行します。

表B-54は、このコマンドの構成パラメータの一覧です。AXF_SOLUTION_PARAMETERS表内のこれらのパラメータを使用してコマンドを構成します。

B.3.9.1 Validate Taskコマンドのパラメータ

表B-54 ValidateTaskCommandのパラメータ

パラメータ・キー

説明

ATTRIBUTE_TO_VALIDATE

BPELタスク内の、検証対象の属性を指定します。これは、システム属性でもペイロード属性でもかまいません。ペイロード属性を指定する場合は、接頭辞の値としてXPATH:を使用し、AXF_XPATH_ATTRIBUTES表からの値を参照します。

REGULAR_EXPRESSION

指定された属性を検証するための、標準の正規表現を定義します。

CMD_ON_PASS

検証に合格した場合にこのコマンドの後に実行するコマンドを指定します。

CMD_ON_FAIL

検証不合格の場合にこのコマンドの後に実行するコマンドを指定します。

FAIL_MESSAGE

検証不合格の場合に表示するメッセージを指定します。

B.3.9.2 実装例

次の構成は、請求書が保存されている(請求書トランザクションIDが0でない)ことを検証します。0の場合、コマンドは、FAIL_MESSAGEパラメータで指定されたエラー・メッセージを報告します。検証を追加する手順は、第6.4.7項を参照してください。

Fields not shown: SOLUTION_NAMESPACE=InvoiceProcessing

表B-55 AXF_SOLUTION_PARAMETERS表内のValidateTaskコマンドの例

COMMAND_NAMESPACE

CONFIGURATION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

ValidateTransactionID

oracle.imaging.axf.commands.bpel.ValidateTaskCommand

ATTRIBUTE_TO_VALIDATE

XPATH:InvoiceProcessing_TransactionID

ValidateTransactionID

oracle.imaging.axf.commands.bpel.ValidateTaskCommand

CMD_ON_PASS

CompleteInvoice

ValidateTransactionID

oracle.imaging.axf.commands.bpel.ValidateTaskCommand

REGULAR_EXPRESSION

[^0]

ValidateTransactionID

oracle.imaging.axf.commands.bpel.ValidateTaskCommand

FAIL_MESSAGE

Please save the transaction before completing the task.

B.4 BPELイメージング・ソリューションのためのOracle E-Business Suite Formsの表

Oracle E-Business SuiteのためにAXFを構成するには、AXF関連の表をOracle E-Business Suiteで構成する必要があります。この項の内容は次のとおりです。

- 第B.4.1項「BPELイメージング・ソリューションのためのOracle E-Business Suite AXFの表について」

- 第B.4.2項「AXF_CONFIGS表(Oracle E-Business Suite)」

- 第B.4.3項「AXF_COMMANDS表(Oracle E-Business Suite)」

- 第B.4.4項「AXF_COMMAND_PARAMETERS表(Oracle E-Business Suite)」

- 第B.4.5項「AXF_PROPERTIES表(Oracle E-Business Suite)」

注意:

Oracle E-Business Suite BPELイメージング・ソリューションがサポートされるのは、フォーム・ベースのアプリケーションのみです。OAFアプリケーションに対してはサポートされません。

B.4.1 BPELイメージング・ソリューションのためのOracle E-Business Suite AXFの表について

次の図は、AXFソリューションの中でOracle E-Business Suiteシステムによって使用される表どうしの関係を示すものです。

B.4.2 AXF_CONFIGS表(Oracle E-Business Suite)

AXF_CONFIGS表は、AXFソリューションを様々なOracle E-Business Suiteフォーム上で有効化するために使用します。この表では、どのフォームをAXF対応にするかを、データ・ブロック・レベルにまで細分化して選択できます。

フォーム・イベントは、アクションがOracle E-Business Suiteフォームに対して実行されたときに、自動的に起動されます。AXF_CUSTOM.pllによって、すべてのイベント(たとえば、POST-INSERT)がカスタマイズ可能になります。どのイベントを使用するか、およびいつ、どのように使用するかを指定できます。

アクションが発生したときに、カスタマイズ済コードによって、指定のソリューションとそのイベントに対して構成されたコマンドが起動されます。同じフォームが再利用される場合(たとえば請求書入力と請求書問合せ)は、FORMFUNCTIONおよびDATABLOCKNAMEによって各フォームを一意に識別します。

注意:

特定のデータブロックではなく、1つのフォーム上のすべてのデータブロックを有効化するには、AXF_DEFAULTをDATABLOCKNAMEパラメータに対して指定します。これで、フォームのPOST-INSERTイベントが発生したときに、発生したデータブロックにかかわらずAXFに通知が送られるようになります。ただし、このようにDATABLOCKNAMEパラメータをAXF_DEFAULTに設定すると、指定されたZOOMコマンドやSPECIALコマンドが、そのフォームに関連するすべてのページ上で有効になります。(ZOOMコマンドおよびSPECIALコマンドはAXF_COMMANDS表(Oracle E-Business Suite)で設定されます。)

B.4.2.1 列の説明

表B-56 AXF_CONFIGS表の列の説明

列名

説明

FORMID

表の主キーを指定します。

FORMFUNCTION

Oracle E-Business Suiteフォームのそれぞれを、フォームの機能に基づいて区別します。

SOLUTIONENDPOINT

AXFへのURLを指定します。この値はhttps://で始まる必要があります(SecureModeがオンの場合)。第2.4.2項を参照してください。

ENTITYNAME

添付ファイル機能によって一意の名前として使用されます。この名前によって、添付ファイルを正しいフォームにリンクします。

LOGENABLED

指定されたフォームに対するログを有効化または無効化します。次のいずれかを指定します。

- 1/TRUE/YES

- 0/FALSE/NO

DATABLOCKNAME

有効化する、フォーム上のデータブロックを指定します。

AXF_DEFAULTを指定すると、フォーム上のすべてのデータブロックを有効化できます。

フォームはOracle E-Business Suiteによって再利用されることもあるので(たとえば請求書入力と請求書問合せ)、FORMFUNCTIONおよびDATABLOCKNAMEの組合せによって各フォームを一意に識別します。

B.4.2.2 実装例

この例では、請求書フォーム全体がAXF対応であることを定義します。(仮に、最初の行がないとすれば、その場合は請求書フォームのINV_SUM_FOLDERデータ・ブロックが有効になります。)

この例の表の最後の行は、紙クリップ添付機能が有効であることを示します(管理対象添付ファイル・ソリューションを無効にしています)。詳細は、第6.4.11項を参照してください。

ここに示していないフィールド: LOGENABLED=YES

表B-57 AXF_CONFIGS表の例

FORMID

FORMFUNCTION

SOLUTIONENDPOINT

ENTITYNAME

DATABLOCKNAME

1

AP_APXINWKB

https://ApplicationServerName:Port/axf-ws/AxfSolutionMediatorService

AP_INVOICES

AXF_DEFAULT

2

AP_APXINWKB_SUMMARY_VIEW

https://ApplicationServerName:Port/axf-ws/AxfSolutionMediatorService

AP_INVOICES

INV_SUM_FOLDER

6

AP_APXINWKB_BATCHES

https://ApplicationServerName:Port/axf-ws/AxfSolutionMediatorService

AP_INVOICES

INV_SUM_FOLDER

7

AXF_MANAGED_ATTACHMENTS-DISABLED

https://ApplicationServerName:Port/axf-ws/AxfSolutionMediatorService

(Null)

(Null)

B.4.3 AXF_COMMANDS表(Oracle E-Business Suite)

AXF_COMMANDS表は、ユーザーのアクティビティに応じて実行するアクションを記述するために使用します。この表は、AXF_CONFIGS表(Oracle E-Business Suite)と連携します。

B.4.3.1 列の説明

表B-58 AXF_COMMANDS表の列の説明

列名

説明

FORMID

AXF_CONFIGS表(Oracle E-Business Suite)にリンクしています。

EVENTID

表の主キー。

EVENTNAME

起動するイベント・コマンドの名前(例: ZOOM、POST-INSERT)。

DISPLAYMENU

コマンドのメニューのテキストを表示します。

COMMANDNAMESPACE

メニューが選択されたときにバックエンドに渡されるリクエスト・コマンド。

REQUIRESCONVERSATION

このコマンドには有効な対話が必須かどうかを示します。

SORTBY

メニューを表示する順序。

SOLUTIONNAMESPACE

ソリューションの名前。

MENUTYPE

Oracle E-Business Suiteでユーザーに対して表示するメニューのタイプを指定します。次の選択が可能です。

- ZOOM: ズーム・メニューをツールバーに表示します。

- ZOOMANDSPECIAL: ズーム・メニューとスペシャル・メニューの両方を表示します。(スペシャル・キーをSPECIAL列に入力します。)

- SPECIAL: スペシャル・メニューをツールバーに表示します。(スペシャル・キーをSpecial列に入力します。)

SPECIAL

スペシャル・タイプ・メニューの一意の番号を入力して新しいメニュー・エントリを作成します。

- SPECIAL1-15: 「ツール」メニューのエントリを作成します。

- SPECIAL16-30: 「レポート」メニューのエントリを作成します。

- SPECIAL31-45: 「アクション」メニューのエントリを作成します。

(詳細は、Oracle E-Business Suiteのドキュメントを参照してください。)

RESPONSIBILITY

将来使用するために予約されています。

B.4.3.2 実装例

この例では、2つのコマンドを「ズーム」メニューから起動するように設定します(「補足資料を添付」と「請求書処理」)。各コマンドは2回ずつ表示されます。コマンドによって有効化される機能は同じですが、2つの異なるページ上で有効化されるからです。

さらに、このソリューションはPOST-INSERTイベントの中でSaveInvoiceコマンドを起動するように構成されています。つまり、アクションによって新しいOracle E-Business Suiteトランザクション・レコードが挿入されるたびに、自動的にSaveInvoiceコマンドがバックエンド上で起動され、そのコマンドに関連付けられているアクションが実行されます。POST-INSERTは、Oracle E-Business Suiteの中で同じトランザクション・レコードがもう一度保存されてもコールされません。

ここに示していないフィールド: SOLUTION_NAMESPACE=InvoiceProcessing、SPECIAL=(null)、RESPONSIBILITY=(null)

表B-59 AXF_COMMANDS表の例

EVENTID

FORMID

EVENTNAME

DISPLAYMENU

COMMANDNAMESPACE

REQUIRESCONVERSATION

SORTBY

MENUTYPE

16

1

ZOOM

Attach Supplemental

AttachSupplemental

はい

2

ZOOM

14

6

ZOOM

Attach Supplemental

AttachSupplemental

はい

2

ZOOM

13

6

ZOOM

Process Batch Invoices

StartInvoiceProcessing

いいえ

1

ZOOM

10

1

ZOOM

Process Invoices

StartInvoiceProcessing

いいえ

1

ZOOM

11

1

POST-INSERT

(Null)

SaveInvoice

はい

0

(Null)

15

6

POST-INSERT

(Null)

SaveInvoice

はい

0

(Null)

B.4.4 AXF_COMMAND_PARAMETERS表(Oracle E-Business Suite)

AXF_COMMAND_PARAMETERS表は、定義されたコマンドのそれぞれに対して送信される情報を定義するために使用します。コマンドごとに、必須または省略可能のパラメータのセットは異なります。

B.4.4.1 列の説明

表B-60 AXF_COMMAND_PARAMETERS表の列の説明

列

説明

PARAMETERID

パラメータの一意のIDを定義します。

EVENTID

イベントの一意のIDを定義します。AXF_COMMANDS表(Oracle E-Business Suite)からの値です。

PARAMETERNAME

渡すパラメータの名前。

DATASOURCENAME

パラメータ値のデータソース。DataまたはConstantを指定できます。

DATABLOCKNAME

値のフェッチ元である、フォームのデータ・ブロック。

FIELDNAME

値のフェッチ元である、フォーム内のフィールド名。

CONSTANTVALUE

パラメータの定数値。

B.4.4.2 実装例

次に示す例では、2つのパラメータがEventID 2のために送信されます。1つは定数値(InvoicesByVendor)、もう1つはINVOICES_QFデータ・ブロック内のデータ値(VENDOR_NAME)です。

COMPLETEコマンドを実行するには、Oracle E-Business SuiteとAXFとの間の対話が確立している必要があります。対話とは、セッションの一意のIDであり、これによってOracle E-Business SuiteとAXF Frameworkの間の通信が可能になります。

別のウィンドウを開くことを必要とするコマンドの場合は、Oracle E-Business Suiteによってブラウザの別のインスタンスが開かれます。この新規作成されたウィンドウで、ユーザーはさらに操作を行うことができます。

表B-61 AXF_COMMAND_PARAMETERS表の例

PARAMETERID

EVENTID

PARAMETERNAME

DATASOURCENAME

DATABLOCKNAME

FIELDNAME

CONSTANTVALUE

1

2

SearchName

CONSTANT

(Null)

(Null)

InvoicesByVendor

2

2

VendorName

DATA

INVOICES_QF

VENDOR_NAME

(Null)

18

11

InvoiceTransactionID

DATA

INV_SUM_FOLDER

INVOICE_ID

(Null)

21

14

InvoiceTransactionID

DATA

INV_SUM_FOLDER

INVOICE_ID

(Null)

20

15

InvoiceTransactionID

DATA

INV_SUM_FOLDER

INVOICE_ID

(Null)

22

16

InvoiceTransactionID

DATA

INV_SUM_FOLDER

INVOICE_ID

(Null)

B.4.5 AXF_PROPERTIES表(Oracle E-Business Suite)

AXF_PROPERTIES表は、Oracle E-Business SuiteとのAXF統合のプロパティを定義するために使用します。

B.4.5.1 列の説明

表B-62 AXF_PROPERTIES表の列の説明

列

説明

PROPNAME

使用するプロパティを指定します。プロパティは次のとおりです。

- SecureMode: SSLを有効にするには、このプロパティをONに設定し、AXFWalletPathプロパティおよびAXFWalletKeyプロパティの値を設定します。

- AXFWalletPath: 証明書の場所(パス)。

- AXFWalletKey: AXFウォレット・パスワードをOracle E-Business Suiteのボールトから取り出すためのキーを指定します。

- AXF_VERSION: AXF 10gの場合は1を指定し、AXF 11gの場合は2を指定します。

- AXF_SOAP_POLICY: 使用するSOAPポリシーの名前を指定します。現在サポートされているポリシーはUSER_NAME_TOKENです。

- AXF_SOAP_SECURITY: TRUEを指定します(必須)。これで、SOAPセキュリティが有効になります。第2.4.1項を参照してください。

- AXF_SOAP_USER: 認証のSOAPヘッダーで使用されるSOAPユーザーIDを指定します。第2.4.1項を参照してください。

- AXF_PAPERCLIP: TRUEに設定すると紙クリップ・オプションが有効になり、FALSE (デフォルト)に設定すると無効になります。第6.4.11項も参照してください。

- AXF_MULTINSTANCE: あるOracle E-Business Suiteページの複数のインスタンスが表示されているときに、同じインスタンス/対話をターゲットとすることができます。第6.4.6項を参照してください。TRUEを指定すると、Oracle E-Business Suiteウィンドウをそれぞれ別の対話として扱い、別のImagingまたはAXFウィンドウをターゲットとすることになります。FALSE(デフォルト)を指定すると、Oracle E-Business Suiteインスタンス・ウィンドウそれぞれを同じ対話として扱い、同じImagingまたはAXFターゲット・ウィンドウを使用することになります。

PROPVALUE

プロパティの値を指定します。

B.4.5.2 実装例

この例の表には、デフォルトのプロパティ値を示します。

表B-63 AXF_PROPERTIES表の例

PROPNAME

PROPVALUE

SecureMode

OFF

AXFWalletPath

file:walletpath

AXFWalletKey

AXFWalletKey

AXF_VERSION

2

AXF_SOAP_POLICY

USER_NAME_TOKEN

AXF_SOAP_SECURITY

TRUE

AXF_SOAP_USER

weblogic

AXF_PAPERCLIP

TRUE

B.5 BPELイメージング・ソリューションのためのOracle PeopleSoftの表

Oracle PeopleSoft用のアダプタを構成するには、Oracle PeopleSoftのAXF関連の表を構成する必要があります。詳細は、第3.5項を参照してください。

この項の内容は次のとおりです。

- 第B.5.1項「BPELイメージング・ソリューションのためのOracle PeopleSoft AXFの表について」

- 第B.5.2項「PS_AXF_CONFIG表」

- 第B.5.3項「PS_AXF_COMMANDS表」

- 第B.5.4項「PS_AXF_COMMAND_PARAMS表」

- 第B.5.5項「PS_AXF_PROPERTIES表」

B.5.1 BPELイメージング・ソリューションのためのOracle PeopleSoft AXFの表について

次の図は、AXFソリューションの中でOracle PeopleSoftシステムによって使用される表どうしの関係を示すものです。

注意:

AXFの表フィールドはすべて、null以外の値を必要とします。適用されないフィールドについては、スペースを入れておくことができます。

B.5.2 PS_AXF_CONFIG表

PS_AXF_CONFIG表は、AXFソリューションをOracle PeopleSoftの様々なコンポーネント上で有効にするために使用します。この表では、どのページやコンポーネントをAXF対応にするかを、細分化したレベルで選択できます。

イベントは、Oracle PeopleSoftのページに対してアクションが実行されたときに、自動的に起動されます。AXF_PS_Integrationプロジェクト・コンポーネントによってPRE-およびPOST- saveイベントがキャッチされるので、これらのイベントがカスタマイズ可能になります。どのイベントを使用するか、およびいつ、どのように使用するかを指定できます。

B.5.2.1 列の説明

表B-64 PS_AXF_CONFIG表の列の説明

列名

説明

AXF_CONFIG_ID

表の主キーを指定します。

AXF_COMPONENT_NAME

有効にするOracle PeopleSoftコンポーネントの名前を指定します。

AXF_CONNECT_NAME

Oracle PeopleSoftインテグレーション・ブローカー接続名(コールするサービス操作)を指定します。これは、Oracle PeopleSoftインテグレーション・ブローカーの管理インタフェースで定義されます。

デフォルトのサービス操作はAXF_EXECUTEです。他の接続を設定して使用することができます。

AXF_VERSION

接続のAXFバージョンを指定します。使用可能な値は次のとおりです。

- 10g

- 11g

B.5.2.2 実装例

この例では、VCHR_QUICK_PNLコンポーネントがAXF対応であることを定義します。

表B-65 PS_AXF_CONFIG表の例

AXF_CONFIG_ID

AXF_COMPONENT_NAME

AXF_CONNECT_NAME

AXF_VERSION

1

VCHR_QUICK_PNL

AXF_EXECUTE

11g

B.5.3 PS_AXF_COMMANDS表

PS_AXF_COMMANDS表は、ユーザーのアクティビティに応じて実行するアクションを記述するために使用します。この表は、PS_AXF_CONFIG表と連携します。

B.5.3.1 列の説明

表B-66 PS_AXF_COMMANDS表の列の説明

列名

説明

AXF_CMDS_ID

表の主キーを指定します。これは、一意のコマンドを特定するために使用されます。

AXF_CONFIG_ID

PS_AXF_CONFIG表への外部キーを指定します。これによって、この一意のコマンドと特定のページおよびコンポーネントとが関連付けられます。

AXF_EVENT_NAME

実行されるイベントを指定します。AXF_EVENT_NAMEは、既存のOracle PeopleSoftページに組み込まれるサブページに対応します。たとえば、AXFの機能(イメージ・ビューアやタスク・リストなど)をコールするためにOracle PeopleSoftページに追加されるボタン、リンクまたはメニューです。詳細は、第3.3項を参照してください。使用可能なオプションは次のとおりです。

- AXF_BUTTON_1、…、AXF_BUTTON_5

- AXF_LINK_1、...、AXF_LINK5

- AXF_COMBO_1、...、AXF_COMBO_5

- SAVE_PRE_CHANGE

- SAVE_POST_CHANGE

AXF_SELECT_LABEL

選択フィールドに対してページ上に表示される名前を定義します。これが使用されるのは、COMBOイベントのみです。

AXF_DISPLAY_NAME

Oracle PeopleSoftページ上に表示されるボタンまたはリンクの名前を定義します。

AXF_SOL_NAMESPC

実行するコマンドのソリューション・ネームスペースを指定します。

AXF_CMD_NAMESPC

実行するコマンドのコマンド・ネームスペースを指定します。

AXF_PSFT_ROLE

コマンドへのアクセス権を持つOracle PeopleSoftのロールを指定します。これは、各ロールを単一引用符で囲んだものをカンマで区切ったリストです(例: 'Role1','Role2','Role3')。

AXF_SORT_ORDER

選択フィールドに表示される項目の順序を指定します。ソート順序が適用されるのは選択フィールドのみです。

AXF_REQ_CONV

このコマンドの実行前に対話が必須かどうかを指定します。たとえば、UpdateTaskコマンドを実行するには、対話が実行中であることが必要です。これは、ユーザーが現在のタスクを選択できるようにするためです。

B.5.3.2 実装例

この例では、2つのコマンドを同じ請求書処理ページに追加します。1つはボタンを挿入するものであり、このボタンがクリックされると請求書処理が開始します。もう1つはリンクを挿入するものであり、このリンクがクリックされるとImagingでの重複請求書の検索が開始します。

さらに、このソリューションはSAVE_POST_CHANGEイベントの中でSaveInvoiceコマンドを起動するように構成されています。つまり、アクションによって新しいOracle PeopleSoftトランザクション・レコードが挿入されるたびに、自動的にSaveInvoiceコマンドがバックエンド上で起動され、そのコマンドに関連付けられているアクションが実行されます。SAVE_POST_CHANGEは、Oracle PeopleSoftの中で同じトランザクション・レコードがもう一度保存されてもコールされません。

コマンドの使用を許可するために、Oracle PeopleSoftロールの1つをAXF_PSFT_ROLEフィールドで指定する必要があります。ユーザーに、コマンドを使用する許可が付与されていない場合は、コマンドは表示されません。コマンドが表示されるが機能しない場合は、そのコマンドが正しく構成されていません。

ここに示していないフィールド: AXF_SELECT_LABEL=(null)、AXF_SORT_ORDER=1、AXF_REQ_CONV=N

表B-67 PS_AXF_COMMANDS表の例

AXF_CMDS_ID

AXF_CONFIG_ID

AXF_EVENT_NAME

AXF_DISPLAY_NAME

AXF_SOL_NAMESPC

AXF_CMD_NAMESPC

AXF_PSFT_ROLE

1

1

AXF_BUTTON_1

Start Invoice Processing

InvoiceProcessing

StartInvoiceProcessing

'Employee'

2

1

AXF_LINK_1

Search For Duplicates

InvoiceInquiry

SearchIPM

'Employee'

3

1

SAVE_POST_CHANGE

(Null)

InvoiceProcessing

SaveInvoice

'Employee'

B.5.4 PS_AXF_COMMAND_PARAMS表

PS_AXF_COMMAND_PARAMS表は、定義されたコマンドのそれぞれに対して送信される情報を指定するために使用します。コマンドごとに、必須または省略可能のパラメータのセットは異なります。

B.5.4.1 列の説明

表B-68 AXF_COMMAND_PARAMETERS表の列の説明

列

説明

AXF_CMDS_PARAMS_ID

表の主キーを指定します。

AXF_CMDS_ID

PS_AXF_COMMANDS表への外部キーを指定します。これによって、一意のパラメータと特定のコマンドとが関連付けられます。

AXF_PARAM_NAME

パラメータ名を定義します。

AXF_DATASOURCE

パラメータ値の取得元を指定します。

- DATA: AXF_RECORD_NAMEフィールドおよびAXF_FIELD_NAMEフィールドで定義された、Oracle PeopleSoft内の値を取得します。

- CONSTANT: AXF_CONSTANT_VALUEフィールドで定義された値を使用します。

AXF_RECORD_NAME

Oracle PeopleSoftページ内のフィールドのレコードを指定します。これは、AXF_DATASOURCEがDATAに設定されているときに取得するターゲット値として使用されます。

AXF_FIELD_NAME

AXF_DATASOURCEがDATAに設定されているときにターゲット値として使用されます。

AXF_CONSTANT_VALUE

AXF_DATASOURCEがCONSTANTに設定されているときに定数値として使用されます。

B.5.4.2 実装例

次に示す例では、3つのパラメータがAXF_CMDS_ID 2のために送信されます。1つは定数値(SearchName)で、残りの2つはデータ値(INVOICENUMBERおよびInvoiceTransactionID)です。

表B-69 PS_AXF_COMMAND_PARAMS表の例

AXF_CMDS_PARAMS_ID

AXF_CMDS_ID

AXF_PARAM_NAME

AXF_DATASOURCE

AXF_RECORD_NAME

AXF_FIELD_NAME

AXF_CONSTANT_VALUE

1

2

SearchName

CONSTANT

(Null)

(Null)

SearchByInvoiceID

2

2

INVOICENUMBER

DATA

VCHR_HDR_QV

INVOICE_ID

(Null)

3

3

InvoiceTransactionID

DATA

VCHR_HDR_QV

VOUCHER_ID

(Null)

B.5.5 PS_AXF_PROPERTIES表

PS_AXF_PROPERTIES表は、Oracle PeopleSoftとのAXF統合のプロパティを定義するために使用します。第6.4.12項を参照してください。

B.5.5.1 列の説明

表B-70 PS_AXF_PROPERTIES表の列の説明

列

説明

AXF_PROPNAME

使用するプロパティを指定します。プロパティは次のとおりです。

- WINDOW_HEIGHT: ポップアップ・ウィンドウの高さをピクセル単位で指定します。(これは、ソリューションの一部して表示される任意のポップアップ・ウィンドウを指します。)

- WINDOW_WIDTH: ポップアップ・ウィンドウの幅をピクセル単位で指定します。

AXF_PROPVALUE

プロパティの値を指定します。

B.5.5.2 実装例

この例の表には、デフォルトのプロパティ値を示します。

表B-71 PS_AXF_PROPERTIES表の例

AXF_PROPNAME

AXF_PROPVALUE

WINDOW_HEIGHT

600

WINDOW_WIDTH

800

C 管理対象添付ファイル・ソリューション・リファレンス

この付録では、管理対象添付ファイル・ソリューションのために使用されるAXF、Oracle E-Business Suite、Oracle PeopleSoftおよびコンテンツ・サーバーの構成表について説明します。GrantAccessコマンドおよび管理対象添付ファイルURLについて説明し、実装例を示します。

ここで説明する項目は、次のとおりです。

- 第C.1項「管理対象添付ファイル・ソリューションのためのAXFの表」

- 第C.2項「管理対象添付ファイル・ソリューションのためのOracle E-Business Suite Formsの表」

- 第C.3項「管理対象添付ファイル・ソリューションのためのOracle E-Business Suite OAFの表」

- 第C.4項「管理対象添付ファイル・ソリューションのためのOracle PeopleSoftの表」

- 第C.5項「管理対象添付ファイル・ソリューションのためのコンテンツ・サーバーの表」

管理対象添付ファイルの表の多くは、ビジネス・アプリケーション・プラグインの構成時(第2章または第3章を参照)および管理対象添付ファイルの構成時(第7章を参照)に自動的にデータが入力されます。この付録では、管理対象添付ファイルのための追加のページの構成方法や、必要に応じて表に変更を加える方法を説明します。

C.1 管理対象添付ファイル・ソリューションのためのAXFの表

Application Extension Framework (AXF)の表によって、このソリューション、そのシステム・パラメータおよび使用されるGrantAccessコマンドが定義されます。

注意:

稼働中のシステムでのAXFの表の値を変更する場合は、変更を有効にするために、ドライバ・ページでDBキャッシュのクリアを実行するか、AXFアプリケーションをアプリケーション・サーバー内で再起動してください。

次に示す図は、管理対象添付ファイル・ソリューションに使用されるAXFの構成表と、表の関係を表すものです。

AXFの表

説明

AXF_SOLUTIONS表

AXF_SOLUTION_ATTRIBUTES表

AXFソリューションを定義し、インフラストラクチャ、サービスおよびソリューションの全般的なパラメータを定義します。

AXF_COMMANDS表

ソリューション内のAXFのコマンドを定義します。

AXF_SOLUTION_PARAMETERS表

AXFのコマンドのパラメータを定義します。

C.1.1 AXF_SOLUTIONS表

AXF_SOLUTIONS表は、AXFで使用されるソリューションを定義します。これは、SOLUTION_NAMESPACE列を通してAXF_COMMANDS表にリンクしています。

C.1.1.1 列の説明

表C-1 AXF_SOLUTIONS表の列の説明

列

説明

SOLUTION_CONTEXT

AXFソリューション実装のJNDI名を定義します。(現時点では、AxfCommandMediatorが唯一のソリューション実装です。)

SOLUTION_NAMESPACE

AXFソリューション名を定義します。

C.1.1.2 実装例

この例で定義される管理対象添付ファイル・ソリューションでは、AxfCommandMediatorがソリューション実装として使用されています。

表C-2 AXF_SOLUTIONS表の例

SOLUTION_NAMESPACE

SOLUTION_CONTEXT

UCM_Managed_Attachments

ejb.AxfCommandMediator#oracle.imaging.axf.service.AxfCommandMediatorRemote

C.1.2 AXF_SOLUTION_ATTRIBUTES表

この表は、インフラストラクチャ、サービスまたはソリューションで使用される、全般的な属性を定義します。

C.1.2.1 列の説明

表C-3 AXF_SOLUTION_ATTRIBUTES表の列の説明

列

説明

SOLUTION_NAMESPACE

このパラメータを使用するソリューション・ネームスペースを指定します。

PARAMETER_KEY

パラメータの名前。パラメータ値をデータベースから取り出すときに使用されます。適用可能なパラメータは次のとおりです。

- USERNAME_PASS_THROUGH: イメージング・ソリューションに対してこのパラメータがFALSEに設定されているときは、Oracle E-Business SuiteまたはOracle PeopleSoftから渡されたユーザーではなく、認証Oracle WebLogic Serverユーザーがタスク(たとえばBPELのタスク)を実行できます。このパラメータは、管理対象添付ファイル構成の場合はTRUEに設定されている必要があります。第7.6.19項を参照してください。

PARAMETER_VALUE

パラメータの値。

C.1.2.2 実装例

この例では、管理対象添付ファイル・ソリューションのソリューション属性を設定します。

表C-4 AXF_SOLUTION_ATTRIBUTES表の例

SOLUTION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

UCM_Managed_Attachments

USERNAME_PASS_THROUGH

TRUE

C.1.3 AXF_COMMANDS表

この表は、ソリューションのためのAXFのコマンドと、そのJavaクラスを定義します。各コマンドのパラメータの構成は、AXF_SOLUTION_PARAMETERS表で行います。

C.1.3.1 列の説明

表C-5 AXF_COMMANDS表の列の説明

列

説明

SOLUTION_NAMESPACE

ソリューションの名前。これは、AXF_SOLUTIONS表で定義されます。

COMMAND_NAMESPACE

ソリューション内でのコマンドの一意の名前を定義します。

COMMAND_CLASS

コマンドが定義されているクラスの完全修飾名。このクラスがロードされ、コマンドを表すexecute()メソッドが実行されます。

C.1.3.2 実装例

この例では、管理対象添付ファイル・ソリューションのためのManaged Attachmentsコマンドが定義されます。

表C-6 AXF_COMMANDS表の例

SOLUTION_NAMESPACE

COMMAND_CLASS

COMMAND_NAMESPACE

UCM_Managed_Attachments

oracle.imaging.axf.commands.ucm.AfGrantAccessCommand

UCM_Managed_Attachments

C.1.4 AXF_SOLUTION_PARAMETERS表

この表は、ソリューションおよびAXFのコマンドのコマンド・パラメータを定義します。

C.1.4.1 列の説明

表C-7 AXF_SOLUTION_PARAMETERS表の列の説明

列

説明

SOLUTION_NAMESPACE

ソリューション・ネームスペースを指定します。これは、AXF_SOLUTIONS表で定義されます。

COMMAND_NAMESPACE

コマンド名を指定します。これは、AXF_COMMANDS表で定義されます。

CONFIGURATION_NAMESPACE

コマンドを実装するために使用されます。実装クラスの完全なパッケージ名を指定します。このネームスペース・パスは、インスタンス化される物理Javaクラスを表します。また、このネームスペースによって、同じソリューション・ネームスペース内のコマンドが区別されます。

PARAMETER_KEY

AXFのコマンドで使用されるパラメータ・キーを指定します。パラメータは次のとおりです。

- RIDC_CONNECTION_STR: AF_GRANT_ACCESSコンテンツ・サーバー・サービスの実行に使用されるRIDC接続文字列を指定します。コンテンツ・サーバーが実行されるシステムのホスト名またはIPアドレスと、RIDCコールを受信するコンテンツ・サーバーのポートが含まれます。(コンテンツ・サーバー・ポートのための値を見つけるには、config.cfg内のIntradocServerPort構成値を探します。)

- UCM_CONNECTION_STR: コンテンツ・サーバー添付ファイル・フレームワーク検索を実行するベースURLを指定します。この検索によって、関連付けられたドキュメントのリストが返されます。このパラメータでは、次の値も設定されます。
コンテンツ・サーバーが実行されるシステムのホスト名またはIPアドレス

Webサーバーがリスニングするポート。

コンテンツ・サーバー・プロファイル(デフォルト・プロファイルはEBSProfileまたはPSFTProfileです。第7.4項で説明するユニバーサル・アダプタを使用する場合は、UniversalProfileを指定します。)

GET_SEARCH_RESULTS_FORCELOGINサービス

ResultTemplate (デフォルト・テンプレートはEBS_LISTまたはPSFT_LISTです。第7.4項で説明するユニバーサル・アダプタを使用する場合は、UNIVERSAL_LISTを使用します。)

- UCM_ADMIN_USER: ビジネス・アプリケーションにログインしているユーザーのためにAF_GRANT_ACCESSサービスを実行する、コンテンツ・サーバーの管理ユーザーを指定します。

- MA_CSF_KEY: 管理ユーザーの資格証明を資格証明ストア・フレームワーク(CSF)に、構成可能なキー名を使用して格納します。キー名は、必要に応じて変更できます。同じキー名がCSFでの資格証明作成に使用されます。第7.7.1項を参照してください。

PARAMETER_VALUE

パラメータ・キーの値を指定します。

C.1.4.2 実装例

この例では、UCM_Managed_AttachmentsソリューションのためのUCM_Managed_Attachmentsコマンドを定義します。表C-8はOracle E-Business Suiteの例で、表C-9はOracle PeopleSoftの例です。表C-10および表C-11に示すBPM用AXFの例のCONFIGURATION_NAMESPACEの値では、imagingがecmで置き換えられています。これは、BPM用AXFインフラストラクチャに必要です。これらの値は、第7.2.1項で設定されたものです。

- 最初の行でRIDC接続文字列を指定します。これによって、AF_GRANT_ACCESSコンテンツ・サーバー・サービスを実行します。

- 2番目の行で、管理対象添付ファイルURLを指定します。これによって、コンテンツ・サーバー添付ファイル・フレームワーク検索が起動されます。

- 3番目の行で、コンテンツ・サーバーの管理ユーザーを指定します。このユーザーがAF_GRANT_ACCESSサービスを実行します。このユーザー名は動的に取得されます。

- 4番目の行で、CSFキーを指定します。CSFに格納されているユーザー名が、ビジネス・アプリケーションから受け取ったリクエスト内のユーザー名の値と比較されます。

ここに示していないフィールド: SOLUTION_NAMESPACE=UCM_Managed_Attachments

表C-8 Oracle E-Business Suite管理対象添付ファイル・ソリューションのAXF_SOLUTION_PARAMETERS表の例(BPEL用AXF)

COMMAND_NAMESPACE

CONFIGURATION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

UCM_Managed_Attachments

oracle.imaging.axf.commands.ucm.AfGrantAccessCommand

RIDC_CONNECTION_STR

idc://コンテンツ・サーバーのホスト名またはIPアドレス:コンテンツ・サーバーのRIDCポート

UCM_Managed_Attachments

oracle.imaging.axf.commands.ucm.AfGrantAccessCommand

UCM_CONNECTION_STR

http://コンテンツ・サーバーのホスト名またはIPアドレス:
コンテンツ・サーバーのポート/cs/idcplg/_p/min/af/trigger-EBSProfile?IdcService=GET_SEARCH_RESULTS_FORCELOGIN&ResultTemplate=EBS_LIST

UCM_Managed_Attachments

oracle.imaging.axf.commands.ucm.AfGrantAccessCommand

UCM_ADMIN_USER

コンテンツ・サーバーの管理ユーザー

UCM_Managed_Attachments

oracle.imaging.axf.commands.ucm.AfGrantAccessCommand

MA_CSF_KEY

MA_CSF_KEY

表C-9 Oracle PeopleSoft管理対象添付ファイル・ソリューションのAXF_SOLUTION_PARAMETERS表の例(BPEL用AXF)

COMMAND_NAMESPACE

CONFIGURATION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

UCM_Managed_Attachments

oracle.imaging.axf.commands.ucm.AfGrantAccessCommand

RIDC_CONNECTION_STR

idc://コンテンツ・サーバーのホスト名またはIPアドレス:コンテンツ・サーバーのRIDCポート

UCM_Managed_Attachments

oracle.imaging.axf.commands.ucm.AfGrantAccessCommand

UCM_CONNECTION_STR

http://コンテンツ・サーバーのホスト名またはIPアドレス:
コンテンツ・サーバーのポート/cs/idcplg/_p/min/af/trigger-PSFTProfile?IdcService=GET_SEARCH_RESULTS_FORCELOGIN&ResultTemplate=PSFT_LIST

UCM_Managed_Attachments

oracle.imaging.axf.commands.ucm.AfGrantAccessCommand

UCM_ADMIN_USER

コンテンツ・サーバーの管理ユーザー

UCM_Managed_Attachments

oracle.imaging.axf.commands.ucm.AfGrantAccessCommand

MA_CSF_KEY

MA_CSF_KEY

表C-10 Oracle E-Business Suite管理対象添付ファイル・ソリューションのAXF_SOLUTION_PARAMETERS表の例(BPM用AXF)

COMMAND_NAMESPACE

CONFIGURATION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

UCM_Managed_Attachments

oracle.ecm.axf.commands.ucm.AfGrantAccessCommand

RIDC_CONNECTION_STR

idc://コンテンツ・サーバーのホスト名またはIPアドレス:コンテンツ・サーバーのRIDCポート

UCM_Managed_Attachments

oracle.ecm.axf.commands.ucm.AfGrantAccessCommand

UCM_CONNECTION_STR

http://コンテンツ・サーバーのホスト名またはIPアドレス:
コンテンツ・サーバーのポート/cs/idcplg/_p/min/af/trigger-EBSProfile?IdcService=GET_SEARCH_RESULTS_FORCELOGIN&ResultTemplate=EBS_LIST

UCM_Managed_Attachments

oracle.ecm.axf.commands.ucm.AfGrantAccessCommand

UCM_ADMIN_USER

コンテンツ・サーバーの管理ユーザー

UCM_Managed_Attachments

oracle.ecm.axf.commands.ucm.AfGrantAccessCommand

MA_CSF_KEY

MA_CSF_KEY

表C-11 Oracle PeopleSoft管理対象添付ファイル・ソリューションのAXF_SOLUTION_PARAMETERS表の例(BPM用AXF)

COMMAND_NAMESPACE

CONFIGURATION_NAMESPACE

PARAMETER_KEY

PARAMETER_VALUE

UCM_Managed_Attachments

oracle.ecm.axf.commands.ucm.AfGrantAccessCommand

RIDC_CONNECTION_STR

idc://コンテンツ・サーバーのホスト名またはIPアドレス:コンテンツ・サーバーのRIDCポート

UCM_Managed_Attachments

oracle.ecm.axf.commands.ucm.AfGrantAccessCommand

UCM_CONNECTION_STR

http://コンテンツ・サーバーのホスト名またはIPアドレス:
コンテンツ・サーバーのポート/cs/idcplg/_p/min/af/trigger-PSFTProfile?IdcService=GET_SEARCH_RESULTS_FORCELOGIN&ResultTemplate=PSFT_LIST

UCM_Managed_Attachments

oracle.ecm.axf.commands.ucm.AfGrantAccessCommand

UCM_ADMIN_USER

コンテンツ・サーバーの管理ユーザー

UCM_Managed_Attachments

oracle.ecm.axf.commands.ucm.AfGrantAccessCommand

MA_CSF_KEY

MA_CSF_KEY

C.2 管理対象添付ファイル・ソリューションのためのOracle E-Business Suite Formsの表

Oracle E-Business Suite Formsの表では、管理対象添付ファイルのページをどのように、選択されたOracle E-Business Suiteフォームの「ズーム」メニューを通してアクティブ化するかを定義します。AF統合に対して有効化されるOracle E-Business Suiteフォームのそれぞれに、AXF Oracle E-Business Suite構成が必要です。この構成で、「ズーム」メニュー項目とラベル管理対象添付ファイルを定義し、パラメータのセットを定義します。このパラメータとは、Oracle E-Business Suiteインスタンス名、ビジネス・オブジェクトのタイプ、ビジネス・オブジェクト・キーおよびビジネス・オブジェクト・インスタンスのユーザーにわかりやすい説明などです。

次に示す図は、管理対象添付ファイル・ソリューションに使用されるOracle E-Business Suite Formsの構成表と、表の関係を表すものです。

Oracle E-Business Suite Formsの表

説明

AXF_CONFIGS表(Oracle E-Business Suite Forms)

AXFソリューションを様々なOracle E-Business Suiteフォーム上で有効化します。

AXF_PROPERTIES表(Oracle E-Business Suite Forms)

Oracle E-Business Suiteに対するAXF統合のプロパティを定義します。

AXF_FND_MAP表(Oracle E-Business Suite Forms)

AfGrantAccessCommandに渡されるOracle E-Business Suiteフォームの値を定義します。この値が渡されるのは、ユーザーがOracle E-Business Suiteのフォームから管理対象添付ファイル機能をアクティブ化したときです。

AXF_COMMANDS表(Oracle E-Business Suite Forms)

ユーザーのアクティビティに基づいて実行するアクションを表します。

AXF_COMMAND_PARAMETERS表(Oracle E-Business Suite Forms)

AfGrantAccessコマンドのために送信される情報を定義します。

AXF_MA_PARAMETERS表(Oracle E-Business Suite Forms)

管理対象添付ファイルの追加パラメータに送信される情報を定義します。

C.2.1 AXF_CONFIGS表(Oracle E-Business Suite Forms)

AXF_CONFIGS表は、AXFソリューションを様々なOracle E-Business Suiteフォーム上で有効化するために使用します。この表では、どのフォームをAXF対応にするかを、細分化したレベルで選択できます。

アクションが発生したときに、カスタマイズ済コードによって、指定のソリューションとそのイベントに対して構成されたコマンドが起動されます。この表がコンテンツ・サーバー用のOracle E-Business Suiteアダプタのために構成されているときは、この表によってAfGrantAccessコマンドが起動されます。

C.2.1.1 列の説明

表C-12 AXF_CONFIGS表の列の説明

列名

説明

FORMID

表の主キーを指定します。

FORMFUNCTION

Oracle E-Business Suiteフォームのそれぞれを、フォームの機能に基づいて区別します。

SOLUTIONENDPOINT

AXFへのURLを指定し、BPM用AXFとBPEL用AXFのどちらのインフラストラクチャを使用するかを定義します。BPM用AXFを指定する場合は、表C-14に示すように、この列の末尾に「2」を入力します。

この値はhttps://で始まる必要があります(SecureModeがオンの場合)。第2.4.2項を参照してください。

ENTITYNAME

添付ファイル機能によって一意の名前として使用されます。この名前によって、添付ファイルを正しいフォームにリンクします。

LOGENABLED

指定されたフォームに対するログを有効化または無効化します。第2.5項を参照してください。次のいずれかを指定します。

- 1/TRUE/YES

- 0/FALSE/NO

DATABLOCKNAME

有効化する、フォーム上のデータブロックを指定します。

AXF_DEFAULTを指定すると、フォーム上のすべてのデータブロックを有効化できます。

フォームはOracle E-Business Suiteによって再利用されることもあるので(たとえば請求書入力と請求書問合せ)、FORMFUNCTIONおよびDATABLOCKNAMEの組合せによって各フォームを一意に識別します。

C.2.1.2 実装例

この例では、特定のフォームのためのAfGrantAccessコマンドをAXF_CONFIGS表内で定義します。表C-14に示す、BPM用のAXFの例でのSolutionEndpointの値では、axf-wsの後に2があります。これは、BPM用AXFインフラストラクチャの場合に必要です。

ここに示していないフィールド: ENTITYNAME=(null)、LOGENABLED=YESおよびDATABLOCKNAME=(null)

表C-13 AXF_CONFIGS表の例(BPEL用AXF)

FORMID

FORMFUNCTION

SOLUTIONENDPOINT

1

AXF_MANAGED_ATTACHMENTS

https://ApplicationServerName:Port/axf-ws/AxfSolutionMediatorService

表C-14 AXF_CONFIGS表の例(BPM用AXF)

FORMID

FORMFUNCTION

SOLUTIONENDPOINT

1

AXF_MANAGED_ATTACHMENTS

https://ApplicationServerName:Port/axf-ws2/AxfSolutionMediatorService

C.2.2 AXF_PROPERTIES表(Oracle E-Business Suite Forms)

AXF_PROPERTIES表は、Oracle E-Business Suiteに対するAXF統合のプロパティを定義するために使用します。このAXF_PAPERCLIPプロパティを使用して、紙クリップ(添付されたドキュメントを表示)機能を有効にするか無効にするかを指定することもできます。第7.6.15項を参照してください。

C.2.2.1 列の説明

表C-15 AXF_PROPERTIES表(Oracle E-Business Suite)の列の説明

列

説明

PROPNAME

使用するプロパティを指定します。プロパティは次のとおりです。

- SecureMode: SSLを有効にするには、このプロパティをONに設定し、AXFWalletPathプロパティおよびAXFWalletKeyプロパティの値を設定します。

- AXFWalletPath: 証明書の場所(パス)。

- AXFWalletKey: AXFウォレット・パスワードをOracle E-Business Suiteのボールトから取り出すためのキーを指定します。

- AXF_VERSION: AXF 10gの場合は1を指定し、AXF 11gの場合は2を指定します。

- AXF_SOAP_POLICY: 使用するSOAPポリシーの名前を指定します。現在サポートされているポリシーはUSER_NAME_TOKENです。

- AXF_SOAP_SECURITY: TRUEを指定するとSOAPセキュリティが有効になります。第2.4.1項を参照してください。この設定は必須です。

- AXF_SOAP_USER: 認証のSOAPヘッダーで使用されるSOAPユーザーIDを指定します。第2.4.1項を参照してください。

- AXF_PAPERCLIP: TRUEに設定するとOracle E-Business Suiteネイティブの添付ファイル紙クリップ・オプションが有効になり、FALSE (デフォルト)に設定すると無効になります。第7.6.15項を参照してください。

PROPVALUE

プロパティの値を指定します。

C.2.2.2 実装例

この例の表には、デフォルトのプロパティ値を示します。

表C-16 AXF_PROPERTIES表の例

PROPNAME

PROPVALUE

SecureMode

OFF

AXFWalletPath

file:walletpath

AXFWalletKey

AXFWalletKey

AXF_VERSION

2

AXF_SOAP_POLICY

USER_NAME_TOKEN

AXF_SOAP_SECURITY

TRUE

AXF_SOAP_USER

weblogic

AXF_PAPERCLIP

FALSE

C.2.3 AXF_FND_MAP表(Oracle E-Business Suite Forms)

この表は、AfGrantAccessCommandに渡されるOracle E-Business Suiteフォームの値に関連しています。この値が渡されるのは、ユーザーがOracle E-Business Suiteのフォームから管理対象添付ファイル機能をアクティブ化したときです。アダプタは、そのOracle E-Business Suiteフォームに対応する値をこの表の中で検索してAfGrantAccessCommandに渡します。これは、コンテンツ・サーバーのAF_GRANT_ACCESSサービスおよび添付ファイル・フレームワーク検索を実行するためです。

C.2.3.1 列の説明

表C-17 AXF_FND_MAP表の列の説明

列

説明

FUNCTION_NAME

Oracle E-Business Suiteフォームを、その機能に基づいて定義します。

FORM_NAME

有効にするOracle E-Business Suiteフォームの名前を定義します。

BLOCK_NAME

有効にする、フォーム上のデータ・ブロックを定義します。

ENTITY_NAME

添付ファイル機能によって一意の名前として使用されます。この名前によって、添付ファイルを正しいフォームにリンクします。

C.2.3.2 実装例

次に示すAXF_FND_MAPの例では、請求書入力フォーム用にAfGrantAccessコマンドに対して構成されているフィールドが表示されます。

表C-18 AXF_FND_MAP表の例

FUNCTION_NAME

FORM_NAME

BLOCK_NAME

ENTITY_NAME

AP_APXINWKB

APXINWKB

INV_SUM_FOLDER

AP_INVOICES

C.2.4 AXF_COMMANDS表(Oracle E-Business Suite Forms)

AXF_COMMANDS表は、ユーザーのアクティビティに応じて実行するアクションを記述するために使用します。この表は、AXF_CONFIGS表(Oracle E-Business Suite Forms)と連携します。

C.2.4.1 列の説明

表C-19 AXF_COMMANDS表の列の説明

列名

説明

NULL値可能

FORMID

AXF_CONFIGS表(Oracle E-Business Suite Forms)にリンクしています。

いいえ

EVENTID

表の主キー。

はい

EVENTNAME

起動するEventコマンドの名前(このアダプタの場合はZOOM)。

はい

DISPLAYMENU

コマンドのメニューのテキストを表示します。

はい

COMMANDNAMESPACE

ユーザーがこのメニューを選択したときにバックエンドに渡されるリクエスト・コマンド。

はい

REQUIRESCONVERSATION

このコマンドには有効な対話が必須かどうかを示します。このアダプタの場合は、この値はNOであることが必要です。

はい

SORTBY

このメニューを表示する順序。

はい

SOLUTIONNAMESPACE

ソリューションの名前。

はい

MENUTYPE

Oracle E-Business Suiteでユーザーに対して表示するメニューのタイプを指定します。ZOOMを指定すると、ズーム・メニューがツールバーに表示されます。

はい

SPECIAL

スペシャル・タイプ・メニューの一意の番号を入力して新しいメニュー・エントリを作成します。(このアダプタには適用されません。)

はい

RESPONSIBILITY

この列は、ユーザーの職責に基づいてメニュー・オプションを絞り込むために使用されます。入力した値に関連付けられている職責を持つエンド・ユーザーに対してのみ、このメニューが表示されます。(このアダプタには適用されません。)

はい

C.2.4.2 実装例

次に示すAXF_COMMANDS表の例では、請求書入力フォームのためのAfGrantAccessコマンド構成のフィールドが表示されます。

ここに示していないフィールド: SPECIAL=(null)、RESPONSIBILITY=(null)

表C-20 請求書入力フォームのためのAXF_COMMANDS表の例

EVENTID

FORMID

EVENTNAME

DISPLAYMENU

COMMAND
NAMESPACE

REQUIRESCONVERSATION

SORTBY

SOLUTION
NAMESPACE

MENUTYPE

8

1

ZOOM

管理対象添付ファイル

UCM_Managed_Attachment

いいえ

3

UCM_Managed_Attachments

ZOOM

C.2.5 AXF_COMMAND_PARAMETERS表(Oracle E-Business Suite Forms)

AXF_COMMAND_PARAMETERS表は、定義されたコマンドのそれぞれに対して送信される情報を定義するために使用します。コマンドごとに、必須または省略可能のパラメータのセットは異なります。

C.2.5.1 列の説明

表C-21 AXF_COMMAND_PARAMETERS表の列の説明

列

説明

PARAMETERID

パラメータの一意のIDを定義します。

EVENTID

イベントの一意のIDを定義します。AXF_COMMANDS表(Oracle E-Business Suite Forms)からの値です。

PARAMETERNAME

渡されるパラメータの名前。

- application: ビジネス・アプリケーションを指定します。これは、AFObjects表で定義されます。この名前/値ペアは、構成パラメータの1つとしてコンテンツ・サーバーのAF_GRANT_ACCESSサービスおよび添付ファイル・フレームワーク検索に渡されます。

- extraParamName: チェックインまたはスキャンのフォームで、メタデータとしてビジネス・アプリケーションからコンテンツ・サーバーに渡される追加パラメータ。第7.6.16項を参照してください。

DATASOURCENAME

パラメータ値のデータソース。DataまたはConstantを指定できます。

DATABLOCKNAME

値のフェッチ元である、フォームのデータ・ブロック

FIELDNAME

値のフェッチ元である、フォーム内のフィールド名。

CONSTANTVALUE

Oracle E-Business Suiteインスタンスを一意に識別する値に設定されている必要があります。

C.2.5.2 実装例

次に示すAXF_COMMAND_PARAMETERSの例では、請求書入力フォーム用にAfGrantAccessコマンドに対して構成されているフィールドが表示されます。

表C-22 AXF_COMMAND_PARAMETERS表の例

PARAMETERID

EVENTID

PARAMETERNAME

DATASOURCENAME

DATABLOCKNAME

FIELDNAME

CONSTANTVALUE

1

8

application

CONSTANT

(Null)

(Null)

EBS_instanceA

C.2.6 AXF_MA_PARAMETERS表(Oracle E-Business Suite Forms)

AXF_MA_PARAMETERS表を使用して、管理対象添付ファイルの追加パラメータに送信する情報を定義します。

C.2.6.1 列の説明

表C-23 AXF_MA_PARAMETERS表の列の説明

列

説明

PARAMETERID

パラメータの一意のIDを定義します。

FNDID

fnd map表の一意のIDを定義します。AXF_FND_MAP表(Oracle E-Business Suite Forms)から取得します。

PARAMETERNAME

渡されるパラメータの名前。

- application: ビジネス・アプリケーションを指定します。これは、AFObjects表で定義されます。この名前/値ペアは、構成パラメータの1つとしてコンテンツ・サーバーのAF_GRANT_ACCESSサービスおよび添付ファイル・フレームワーク検索に渡されます。

- extraParamName: チェックインまたはスキャンのフォームで、メタデータとしてビジネス・アプリケーションからコンテンツ・サーバーに渡される追加パラメータ。第7.6.16項を参照してください。

DATASOURCENAME

パラメータ値のデータソース。DataまたはConstantを指定できます。

DATABLOCKNAME

値のフェッチ元である、フォームのデータ・ブロック

FIELDNAME

値のフェッチ元である、フォーム内のフィールド名。

CONSTANTVALUE

Oracle E-Business Suiteインスタンスを一意に識別する値に設定されている必要があります。

C.2.6.2 実装例

請求書入力フォームのAfGrantAccessコマンドで構成された表示フィールドに従うAXF_MA_PARAMETERSの例。

表C-24 Example AXF_MA_PARAMETERS表の例

PARAMETERID

FNDID

PARAMETERNAME

DATASOURCENAME

DATABLOCKNAME

FIELDNAME

CONSTANTVALUE

1

5

Company

CONSTANT

(Null)

(Null)

MyCompany

C.3 管理対象添付ファイル・ソリューションのためのOracle E-Business Suite OAFの表

Oracle E-Business Suite OAFの表では、管理対象添付ファイル・ページをどのようにアクティブ化するかを定義します。このアクティブ化に使用されるボタンは、選択されたOAFページに、パーソナライズを通して追加されます。このページは、コンテンツ・サーバー内の管理対象添付ファイルURLにリダイレクトします。

次に示す図は、管理対象添付ファイル・ソリューションに使用されるOracle E-Business Suite OAFの構成表と、表の関係を表すものです。

Oracle E-Business Suite OAFの表

説明

OAF_AXF_CONFIGS表(Oracle E-Business Suite OAF)

Oracle E-Business Suite OAFの様々なページ上でAXFソリューションを有効にします。

OAF_AXF_PROPERTIES表(Oracle E-Business Suite OAF)

Oracle E-Business Suiteに対するAXF統合のプロパティを定義します。

OAF_AXF_COMMANDS表(Oracle E-Business Suite OAF)

ユーザーのアクティビティに基づいて実行するアクションを表します。

OAF_AXF_CMD_PARAMS表(Oracle E-Business Suite OAF)

AfGrantAccessコマンドのために送信される情報を定義します。

C.3.1 OAF_AXF_CONFIGS表(Oracle E-Business Suite OAF)

OAF_AXF_CONFIGS表は、特定のOAFページに対応するAXFエンドポイントを格納するために使用されます。複数のエンドポイントを同じページに対して定義できます。

アクションが発生したときに、カスタマイズ済コードによって、指定のソリューションとそのイベントに対して構成されたコマンドが起動されます。この表がコンテンツ・サーバー用のOracle E-Business Suiteアダプタのために構成されているときは、この表によってAfGrantAccessコマンドが起動されます。

C.3.1.1 列の説明

表C-25 OAF_AXF_CONFIGS表の列の説明

列名

説明

AXF_CONFIG_ID

表の主キーを指定します。

AXF_OAF_PAGE

Oracle E-Business Suite OAFページのフル・パス名を指定します。第7.2.3.2項を参照してください。

AXF_END_POINT

接続先のAXFエンドポイントのURLを指定します。この値はhttps://で始まる必要があります(SecureModeがオンの場合)。第2.4.2項を参照してください。

AXF_VERSION

接続のAXFバージョンを指定します。1はAXF 10gを示し、2はAXF 11gを示します。

C.3.1.2 実装例

この例では、指定したOracle E-Business Suite OAFページ上でAXFソリューションを有効にします。最初の2行に示す2つのコマンドは同じページに対するものですが、それぞれ別のエンドポイントを指しています。これらのコマンドは、それぞれ別の操作を実行するように構成されます。たとえば、管理対象添付ファイル・ボタンと、請求書処理ボタンです。(管理対象添付ファイル・ボタンは、1つのOAFページ上に1つだけ配置することをお薦めします。)

ここに示していないフィールド: AXF_VERSION=2

表C-26 OAF_AXF_CONFIGS表の例

AXF_CONFIG_ID

AXF_OAF_PAGE

AXF_END_POINT

1

/oracle/apps/icx/por/reqmgmt/webui/ReqDetailsPG

http://ImagingServerHostname1:Port1/axf-ws/AxfSolutionMediatorService

2

/oracle/apps/icx/por/reqmgmt/webui/ReqDetailsPG

http://ImagingServerHostname2:Port2/axf-ws/AxfSolutionMediatorService

3

/oracle/apps/po/document/order/webui/OrderPG

http://ImagingServerHostname1:Port1/axf-ws/AxfSolutionMediatorService

4

/oracle/apps/pos/changeorder/webui/PosViewPOPG

http://ImagingServerHostname1:Port1/axf-ws/AxfSolutionMediatorService

5

/oracle/apps/pos/supplier/webui/QuickUpdatePG

http://ImagingServerHostname1:Port1/axf-ws/AxfSolutionMediatorService

6

/oracle/apps/pon/negotiation/creation/webui/ponDefineHdrPG

http://ImagingServerHostname1:Port1/axf-ws/AxfSolutionMediatorService

7

/oracle/apps/pon/negotiation/creation/webui/ponItemHeaderPG

http://ImagingServerHostname1:Port1/axf-ws/AxfSolutionMediatorService

8

/oracle/apps/pa/project/webui/ProjAttachmentPG

http://ImagingServerHostname1:Port1/axf-ws/AxfSolutionMediatorService

C.3.2 OAF_AXF_PROPERTIES表(Oracle E-Business Suite OAF)

OAF_AXF_PROPERTIES表は、Oracle E-Business Suite OAFアプリケーションに対するAXF統合のプロパティを定義するために使用されます。

C.3.2.1 列の説明

表C-27 OAF_AXF_PROPERTIES表(Oracle E-Business Suite)の列の説明

列

説明

PROPNAME

使用するプロパティを指定します。プロパティは次のとおりです。

- SecureMode: SSLを有効にするには、このプロパティをONに設定し、AXFWalletPathプロパティおよびAXFWalletKeyプロパティの値を設定します。

- AXFWalletPath: 証明書の場所(パス)。

- AXFWalletKey: AXFウォレット・パスワードをOracle E-Business Suiteのボールトから取り出すためのキーを指定します。

- AXF_SOAP_POLICY: 使用するSOAPポリシーの名前を指定します。現在サポートされているポリシーはUSER_NAME_TOKENです。

- AXF_SOAP_SECURITY: TRUEを指定するとSOAPセキュリティが有効になります。第2.4.1項を参照してください。この設定は必須です。

- AXF_SOAP_USER: 認証のSOAPヘッダーで使用されるSOAPユーザーIDを指定します。第2.4.1項を参照してください。

- AXF_OAF_REDIRECT_PAGE_URL: カスタム中間OAFページのURLを指定します。このURLは、第2.3.1項で構成されます。Oracle E-Business Suiteインスタンス上でSSLが構成されている場合は、https://で始まります。

PROPVALUE

プロパティの値を指定します。

C.3.2.2 実装例

この例の表には、デフォルトのプロパティ値を示します。

表C-28 OAF_AXF_PROPERTIES表の例

PROPNAME

PROPVALUE

SecureMode

OFF

AXFWalletPath

file:walletpath

AXFWalletKey

AXFWalletKey

AXF_SOAP_POLICY

USER_NAME_TOKEN

AXF_SOAP_SECURITY

TRUE

AXF_SOAP_USER

weblogic

AXF_OAF_REDIRECT_PAGE_URL

http://EBSホスト : EBSポート/OA_HTML/OA.jsp?page=/oracle/apps/ak/ucm/axf/webui/RedirectToAxfPG

C.3.3 OAF_AXF_COMMANDS表(Oracle E-Business Suite OAF)

この表には、特定のOAFページに対して構成される様々なコマンドが格納されます。各コマンドにはEVENT_IDが関連付けられます。このIDは、パーソナライズ(第2.3項で構成されます)を通してOAFページに埋め込まれたボタン/リンクのIDを指します。

C.3.3.1 列の説明

表C-29 OAF_AXF_COMMANDS表の列の説明

列名

説明

AXF_CMDS_ID

表の主キーを指定します。これは、一意のコマンドを特定するために使用されます。

AXF_CONFIG_ID

OAF_AXF_CONFIGS表(Oracle E-Business Suite OAF)への外部キーを指定します。これによって、この一意のコマンドと特定のページおよびそのページ上のコンポーネントが関連付けられます。

AXF_EVENT_ID

ユーザー・インタフェースで実行されるイベントを指定します。AXF_EVENT_IDは、AXF機能を起動するためにパーソナライズを通して追加されたボタンまたはリンクのIDに対応します。使用可能なオプションは次のとおりです。

- MAButton (管理対象添付ファイルの場合)

- IPM_BUTTON (イメージングの場合)

AXF_SOL_NAMESPC

実行するコマンドのソリューション・ネームスペースを指定します。

AXF_CMD_NAMESPC

実行するコマンドのコマンド・ネームスペースを指定します。

AXF_REQ_CONV

このコマンドの実行前に対話が必須かどうかを指定します。

C.3.3.2 実装例

この例では、UCM_Managed_Attachmentsコマンドが複数のOAFページに対して定義されます。各コマンドにはEVENT_IDが関連付けられます。このIDは、パーソナライズを通してOAFページに埋め込まれたボタン/リンクのIDを指します。2行目では、Imaging (IPM)のボタンを構成しています。このボタンは、ImagingソリューションのSupplierMaintenanceコマンドにリンクしています。このタイプの構成の説明は、第2.3.3項を参照してください。

ここに示していないフィールド: AXF_REQ_CONV=N

表C-30 OAF_AXF_COMMANDS表の例

AXF_CMDS_ID

AXF_CONFIG_ID

AXF_EVENT_ID

AXF_SOL_NAMESP

AXF_CMD_NAMESPC

1

1

MAButton

UCM_Managed_Attachments

UCM_Managed_Attachments

2

2

IPM_BUTTON

SupplierMaintenance

StartSupplierMaintenance

3

3

MAButton

UCM_Managed_Attachments

UCM_Managed_Attachments

4

4

MAButton

UCM_Managed_Attachments

UCM_Managed_Attachments

5

5

MAButton

UCM_Managed_Attachments

UCM_Managed_Attachments

6

6

MAButton

UCM_Managed_Attachments

UCM_Managed_Attachments

7

7

MAButton

UCM_Managed_Attachments

UCM_Managed_Attachments

8

8

MAButton

UCM_Managed_Attachments

UCM_Managed_Attachments

C.3.4 OAF_AXF_CMD_PARAMS表(Oracle E-Business Suite OAF)

各コマンドには、SOAPコールに必要な、様々なパラメータが関連付けられます。このパラメータは、定数値のこともあれば、ビュー属性名を指すこともあります。この属性値は、ページ・コンテキストのビュー・オブジェクトから取得できます。

C.3.4.1 列の説明

表C-31 OAF_AXF_CMD_PARAMS表の列の説明

列

説明

AXF_CMD_PARAMS_ID

表の主キーを指定します。

AXF_CMDS_ID

OAF_AXF_COMMANDS表(Oracle E-Business Suite OAF)への外部キーを指定します。これによって、この一意のパラメータと特定のコマンドとが関連付けられます。

AXF_PARAM_NAME

パラメータ名を定義します。

- application: ビジネス・アプリケーションを指定します。これは、AFObjects表で定義されます。

- businessObjectType: ビジネス・アプリケーションのオブジェクト・タイプを指定します。これは、AFObjects表で定義されます。

- businessObjectKey: ビジネス・アプリケーションのオブジェクト・キーを指定します。これは、AFObjects表で定義されます。

- businessObjectValue1...5: ドキュメントの主キー値を表します。

- labelValue1...5: 管理対象添付ファイルのユーザー・インタフェースに表示されるラベル。添付ファイル統合のキー値を表示するためのものです。

- extraParamName: チェックインまたはスキャンのフォームで、メタデータとしてビジネス・アプリケーションからコンテンツ・サーバーに渡される追加パラメータ。第7.6.16項を参照してください。

AXF_DATASOURCE

パラメータ値の取得元を指定します。

- DATA: AXF_RECORD_NAMEフィールドおよびAXF_FIELD_NAMEフィールドで定義された、Oracle PeopleSoft内の値を取得します。

- CONSTANT: AXF_CONSTANT_VALUEで定義された値を使用します。

AXF_VIEW_OBJ_NAME

OAF ViewObject名を指定します。これは、実行時にコマンド・パラメータ値を取得するために使用されます。第7.2.3.2項を参照してください。

AXF_ATTRIBUTE_NAME

AXF_DATASOURCEがDATAに設定されているときに使用されます。この属性名によって、実際の実行時値がコントローラ・クラス内のビュー・オブジェクトから取得されます。

AXF_CONSTANT_VALUE

AXF_DATASOURCEがCONSTANTに設定されているときに定数値として使用されます。

C.3.4.2 実装例

次のOAF_AXF_CMD_PARAMSの例では、複数のOAFページのためにAfGrantAccessコマンドに対して構成されているフィールドを示します。このページのキー値は、第7.2.3.2項で指定したものです。

表C-32 OAF_AXF_CMD_PARAMS表の例

AXF_CMD_PARAMS_ID

AXF_CMDS_ID

AXF_PARAM_NAME

AXF_DATASOURCE

AXF_VIEW_OBJ_NAME

AXF_ATTRIBUTE_NAME

AXF_CONSTANT_VALUE

1

1

application

CONSTANT

EBS_instanceA

2

1

businessObjectType

CONSTANT

REQ_HEADERS

3

1

businessObjectKey1

CONSTANT

REQUISITION_HEADER_ID

4

1

businessObjectValue1

DATA

ReqHeaderVO

RequisitionHeaderId

5

1

labelValue1

DATA

ReqHeaderVO

PreparerName

6

1

labelValue2

DATA

ReqHeaderVO

ReqNum

7

1

businessObjectContext

CONSTANT

ScanContext

8

3

application

CONSTANT

EBS_instanceA

9

3

businessObjectType

CONSTANT

PO_HEADERS_MERGE_V

10

3

businessObjectKey1

CONSTANT

PO_HEADER_ID

11

3

businessObjectValue1

DATA

POHeaderMergeVO

POHeaderId

12

4

application

CONSTANT

EBS_instanceA

13

4

businessObjectType

CONSTANT

PO_HEADERS

14

4

businessObjectKey1

CONSTANT

PO_HEADER_ID

15

4

businessObjectValue1

DATA

PosViewHeadersVO

PO_HEADER_ID

16

5

application

CONSTANT

EBS_instanceA

17

5

businessObjectType

CONSTANT

PO_VENDORS

18

5

businessObjectKey1

CONSTANT

VENDOR_ID

19

5

businessObjectValue1

DATA

SupplierVO

VendorID

20

6

application

CONSTANT

EBS_instanceA

21

6

businessObjectType

CONSTANT

PON_AUCTION_HEADERS_ALL

22

6

businessObjectKey1

CONSTANT

AUCTION_HEADER_ID

23

6

businessObjectValue1

DATA

AuctionHeadersAllVO

AuctionHeaderId

24

7

application

CONSTANT

EBS_instanceA

25

7

businessObjectType

CONSTANT

PON_AUCTION_ITEM_PRICES_ALL

26

7

businessObjectKey1

CONSTANT

AUCTION_HEADER_ID

27

7

businessObjectValue1

DATA

ActionItemPricesAllVO

AuctionHeaderId

28

7

businessObjectKey2

CONSTANT

LINE_NUMBER

29

7

businessObjectValue2

DATA

AuctionItemPricesAllVO

LineNumbers

30

8

application

CONSTANT

EBS_instanceA

31

8

businessObjectType

CONSTANT

PA_PROJECTS

32

8

businessObjectKey1

CONSTANT

PROJECT_ID

33

8

businessObjectValue1

DATA

ProjAttachmentsVO

PROJECT_ID

C.4 管理対象添付ファイル・ソリューションのためのOracle PeopleSoftの表

Oracle PeopleSoftの表では、管理対象添付ファイル・ページをどのように、選択されたOracle PeopleSoftのページ上のボタン、リンクまたはメニューを通してアクティブ化するかを定義します。

AXFをOracle PeopleSoft用に構成するには、次に示すAXF関連の表をOracle PeopleSoftで構成する必要があります。

- 第C.4.1項「PS_AXF_CONFIG表」

- 第C.4.2項「PS_AXF_COMMANDS表」

- 第C.4.3項「PS_AXF_CMD_PARAMS表」

- 第C.4.4項「PS_AXF_PROPERTIES表」

次の図は、AXFソリューションの中でOracle PeopleSoftシステムによって使用される表どうしの関係を示すものです。

注意:

AXFの表フィールドはすべて、null以外の値を必要とします。適用されないフィールドについては、スペースを入れておくことができます。

C.4.1 PS_AXF_CONFIG表

PS_AXF_CONFIG表は、AXFソリューションをOracle PeopleSoftの様々なコンポーネント上で有効にするために使用します。この表では、どのページやコンポーネントをAXF対応にするかを、細分化したレベルで選択できます。

イベントは、Oracle PeopleSoftのページに対してアクションが実行されたときに、自動的に起動されます。AXF_PS_Integrationプロジェクト・コンポーネントによってPRE-およびPOST- saveイベントがキャッチされるので、これらのイベントがカスタマイズ可能になります。どのイベントを使用するか、およびいつ、どのように使用するかを指定できます。

C.4.1.1 列の説明

表C-33 PS_AXF_CONFIG表の列の説明

列

説明

AXF_CONFIG_ID

表の主キーを指定します。

AXF_COMPONENT_NAME

有効にするOracle PeopleSoftコンポーネントの名前を指定します。

AXF_CONNECT_NAME

Oracle PeopleSoftインテグレーション・ブローカー接続名(コールするサービス操作)を指定します。これは、Oracle PeopleSoftインテグレーション・ブローカーの管理インタフェースで定義されます。

デフォルトのサービス操作はAXF_EXECUTEです。他の接続を設定して使用することができます。

AXF_VERSION

接続のAXFバージョンを指定します。この値は、11gに設定されている必要があります。

C.4.1.2 実装例

この例では、WM_WO (work order)コンポーネントがAXF対応であることを定義します。

表C-34 PS_AXF_CONFIG表の例

AXF_CONFIG_ID

AXF_COMPONENT_NAME

AXF_CONNECT_NAME

AXF_VERSION

101

WM_WO

AXF_EXECUTE

11g

102

CA_HDR_PNG

AXF_EXECUTE

11g

103

REQUISITIONS

AXF_EXECUTE

11g

C.4.2 PS_AXF_COMMANDS表

PS_AXF_COMMANDS表は、ユーザーのアクティビティに応じて実行するアクションを記述するために使用します。この表は、PS_AXF_CONFIG表と連携します。

C.4.2.1 列の説明

表C-35 PS_AXF_COMMANDS表の列の説明

列

説明

AXF_CMDS_ID

表の主キーを指定します。これは、一意のコマンドを特定するために使用されます。

AXF_CONFIG_ID

PS_AXF_CONFIG表への外部キーを指定します。これによって、この一意のコマンドと特定のページおよびコンポーネントとが関連付けられます。

AXF_EVENT_NAME

実行されるイベントを指定します。AXF_EVENT_NAMEは、既存のOracle PeopleSoftページに組み込まれるサブページに対応します。たとえば、AXFの機能(イメージ・ビューアやタスク・リストなど)を起動するためにOracle PeopleSoftページに追加されるボタン、リンクまたはメニューです。使用可能なオプションは次のとおりです。

- AXF_BUTTON_1, …,  AXF_BUTTON_5

- AXF_LINK_1, ..., AXF_LINK5

- AXF_COMBO_1, ..., AXF_COMBO_5

- AXF_PRE_SAVE_SBP

- AXF_POST_SAVE_SBP

AXF_SELECT_LABEL

ドロップダウン・コンポーネント(たとえばAXF_COMBO_1)を使用する場合に表示するラベルを表します。

AXF_DISPLAY_NAME

Oracle PeopleSoftページ上に表示されるボタンまたはリンクの名前を定義します。

AXF_SOL_NAMESPC

実行するコマンドのソリューション・ネームスペースを指定します。

AXF_CMD_NAMESPC

実行するコマンドのコマンド・ネームスペースを指定します。

AXF_PSFT_ROLE

コマンドへのアクセス権を持つOracle PeopleSoftのロールを指定します。ロールをカンマ区切りのリストとして指定します。各ロールは単一引用符で囲みます(例: 'Role1','Role2','Role3')。

AXF_SORT_ORDER

選択フィールドに表示される項目の順序を指定します。ソート順序が適用されるのは選択フィールドのみです。

AXF_REQ_CONV

このコマンドの実行前に対話が必須かどうかを指定します。たとえば、UpdateTaskコマンドを実行するには、対話が実行中であることが必要です。これは、ユーザーが現在のタスクを選択できるようにするためです。

C.4.2.2 実装例

この例では、UCM_Managed_AttachmentsコマンドをリンクとしてOracle PeopleSoftのページに追加します。

コマンドの使用を許可するために、Oracle PeopleSoftロールの1つをAXF_PSFT_ROLEフィールドで指定する必要があります。ユーザーに、コマンドを使用する許可が付与されていない場合は、コマンドは表示されません。コマンドが表示されるが機能しない場合は、そのコマンドが正しく構成されていません。

表C-36 PS_AXF_COMMANDS表の例

AXF_CMDS_ID

AXF_CONFIG_ID

AXF_EVENT_NAME

AXF_SELECT_LABEL

AXF_DISPLAY_NAME

AXF_SOL_NAMESPC

AXF_CMD_NAMESPC

AXF_PSFT_ROLE

AXF_SORT_ORDER

AXF_REQ_CONV

101

101

AXF_LINK_1

(Null)

管理対象添付ファイル

UCM_Managed_Attachments

UCM_Managed_Attachments

'Employee'

1

N

102

102

AXF_LINK_1

(Null)

管理対象添付ファイル

UCM_Managed_Attachments

UCM_Managed_Attachments

'Employee'

1

N

103

103

AXF_LINK_1

(Null)

管理対象添付ファイル

UCM_Managed_Attachments

UCM_Managed_Attachments

'Employee'

1

N

C.4.3 PS_AXF_CMD_PARAMS表

PS_AXF_COMMAND_PARAMS表は、定義されたコマンドのそれぞれに対して送信される情報を指定するために使用します。コマンドごとに、必須または省略可能のパラメータのセットは異なります。

PS_AXF_CMD_PARAMS表は、属性リストのラベルを構成するために使用します。定数とデータ値の組合せを使用してキー情報を表示することができます。ラベルを構成するのと同様に、追加のメタデータ値を渡すための行を追加できます。第7.6.16項を参照してください。

C.4.3.1 列の説明

表C-37 PS_AXF_CMD_PARAMS表の列の説明

列

説明

AXF_CMD_PARAM_ID

表の主キーを指定します。

AXF_CMD_ID

PS_AXF_COMMANDS表への外部キーを指定します。これによって、一意のパラメータと特定のコマンドとが関連付けられます。

AXF_PARAM_NAME

パラメータ名を定義します。

- application: ビジネス・アプリケーションを指定します。これは、AFObjects表で定義されます。

- businessObjectType: ビジネス・アプリケーションのオブジェクト・タイプを指定します。これは、第3.3項で定義されます。

- businessObjectKey1...5: ドキュメントの主キー名を表します。

- businessObjectValue1...5: ドキュメントの主キー値を表します。

- labelValue1...5: 管理対象添付ファイルのユーザー・インタフェースに表示されるラベル。添付ファイル統合のキー値を表示するためのものです。

- extraParamName: チェックインまたはスキャンのフォームで、メタデータとしてビジネス・アプリケーションからコンテンツ・サーバーに渡される追加パラメータ。第7.6.16項を参照してください。

AXF_DATASOURCE

パラメータ値の取得元を指定します。

- DATA: AXF_RECORD_NAMEフィールドおよびAXF_FIELD_NAMEフィールドで定義された、Oracle PeopleSoft内の値を取得します。

- CONSTANT: AXF_CONSTANT_VALUEフィールドで定義された値を使用します。

AXF_RECORD_NAME

Oracle PeopleSoftページ内のフィールドのレコードを指定します。これは、AXF_DATASOURCEがDATAに設定されているときに取得するターゲット値として使用されます。

AXF_FIELD_NAME

AXF_DATASOURCEがDATAに設定されているときに定数値として使用されます。

AXF_CONSTANT_VALUE

AXF_DATASOURCEがCONSTANTに設定されているときに定数値として使用されます。

C.4.3.2 実装例

この例では、UCM_Managed_Attachmentsコマンドのために送信される情報を示します。たとえば、アプリケーションやビジネス・オブジェクト・タイプです。

- labelValueのエントリは、添付ファイルのキー・ラベル/値を表示するために構成されます。たとえば、この表のとおりにlabelValueが構成されているときは、作業オーダーについて次のように管理対象添付ファイル・ページに表示されます。
[Business Unit], [US001], [Work Order], [123456]

表C-38 PS_AXF_CMD_PARAMS表の例

AXF_CMD_PARAM_ID

AXF_CMD_ID

AXF_PARAM_NAME

AXF_DATASOURCE

AXF_RECORD_NAME

AXF_FIELD_NAME

AXF_CONSTANT_VALUE

101

101

application

CONSTANT

PSFT_INSTANCE_A

102

101

businessObjectType

CONSTANT

WM_WO_HDR

103

101

businessObjectKey1

CONSTANT

BUSINESS_UNIT

104

101

businessObjectValue1

DATA

WM_WO_HDR

BUSINESS_UNIT

105

101

businessObjectKey2

CONSTANT

WO_ID

106

101

businessObjectValue2

DATA

WM_WO_HDR

WO_ID

107

101

labelValue1

CONSTANT

事業単位

108

101

labelValue2

DATA

WM_WO_HDR

BUSINESS_UNIT

109

101

labelValue3

CONSTANT

Work Order

110

101

labelValue4

DATA

WM_WO_HDR

WO_ID

111

101

businessObjectContext

CONSTANT

ScanContext

112

102

application

CONSTANT

PSFT_INSTANCE_A

113

102

businessObjectType

CONSTANT

CA_CONTR_HDR

114

102

businessObjectKey1

CONSTANT

BUSINESS_UNIT

115

102

businessObjectValue1

DATA

CA_CONTR_HDR

BUSINESS_UNIT

116

102

businessObjectKey2

CONSTANT

CONTRACT_NUM

117

102

businessObjectValue2

DATA

CA_CONTR_HDR

CONTRACT_NUM

118

102

labelValue1

CONSTANT

事業単位

119

102

labelValue2

DATA

CA_CONTR_HDR

BUSINESS_UNIT

120

102

labelValue3

CONSTANT

Contract Number

121

102

labelValue4

DATA

CA_CONTR_HDR

CONTRACT_NUM

122

103

application

CONSTANT

PSFT_INSTANCE_A

123

103

businessObjectType

CONSTANT

REQ_HDR

124

103

businessObjectKey1

CONSTANT

BUSINESS_UNIT

125

103

businessObjectValue1

DATA

REQ_HDR

BUSINESS_UNIT

126

103

businessObjectKey2

CONSTANT

REQ_ID

127

103

businessObjectValue2

DATA

REQ_HDR

REQ_ID

128

103

labelValue1

CONSTANT

事業単位

129

103

labelValue2

DATA

REQ_HDR

BUSINESS_UNIT

130

103

labelValue3

CONSTANT

Requisition

131

103

labelValue4

DATA

REQ_HDR

REQ_ID

C.4.4 PS_AXF_PROPERTIES表

PS_AXF_PROPERTIES表は、Oracle PeopleSoftとのAXF統合のプロパティを定義するために使用します。第7.6.17項を参照してください。

C.4.4.1 列の説明

表C-39 PS_AXF_PROPERTIES表の列の説明

列

説明

AXF_PROPNAME

使用するプロパティを指定します。プロパティは次のとおりです。

- WINDOW_HEIGHT: ポップアップ・ウィンドウの高さをピクセル単位で指定します。(これは、ソリューションの一部して表示される任意のポップアップ・ウィンドウを指します。)

- WINDOW_WIDTH: ポップアップ・ウィンドウの幅をピクセル単位で指定します。

AXF_PROPVALUE

プロパティの値を指定します。

C.4.4.2 実装例

この例の表には、デフォルトのプロパティ値を示します。

表C-40 PS_AXF_PROPERTIES表の例

AXF_PROPNAME

AXF_PROPVALUE

WINDOW_HEIGHT

600

WINDOW_WIDTH

800

C.5 管理対象添付ファイル・ソリューションのためのコンテンツ・サーバーの表

コンテンツ・サーバーの表では、コンテンツ・サーバーのドキュメントをどのようにOracle E-Business SuiteまたはOracle PeopleSoftのビジネス・オブジェクトにマッピングするか、および特定のビジネス・オブジェクトに関連付けられたドキュメントへの一時的なアクセス権をどのようにユーザーに付与するかを定義します。

次の追加のデータベース表がアダプタで利用されます。

- 第C.5.1項「AFGrants表」

- 第C.5.2項「AFObjects表」

- 第C.5.3項「AFRelationshipAttributes表」

- 第C.5.4項「AFKeys表」

これらの表のデータは、実行時に自動的に入力されます。AFGrantsの初期データが入力されるのは、ユーザーがコンテンツ・サーバーにビジネス・アプリケーションからアクセスして、AF_GRANT_ACCESSサービスが実行されたときです。AFObjectsのデータが入力されるのは、ユーザーが管理対象添付ファイルのページからドキュメントをコンテンツ・サーバーにチェックインしたときです。

C.5.1 AFGrants表

この表には、ユーザーに付与される権限が格納されます。これによって、ユーザーは、特定のビジネス・オブジェクトに関連付けられたドキュメントに一時的にアクセスできるようになります。

C.5.1.1 列の説明

表C-41 AFGrants表の列の説明

列

説明

dUserName

ユーザーの名前を格納します。

dAFApplication

ビジネス・アプリケーションのインスタンス名を格納します(たとえばPSFT_Instance1)。

dAFBusinessObject

ビジネス・アプリケーションのオブジェクトを格納します。

dAFBusinessObjectType

ビジネス・アプリケーションのオブジェクト・タイプを格納します。

dPrivilege

ユーザーに付与する権限を格納します。R (読取り)、W (書込み)、D (削除)またはA (管理者)です。

このパラメータはオプションです。指定されていない場合は、AppAdapterGrantPrivilege構成変数で指定されたアクセス・レベルが使用されます。第7.5項を参照してください。

dExpirationDate

この権限の有効期限である日時を格納します。

dMaxExpiration

最大アクセス期間(時間単位)の終了時刻を格納します。

C.5.2 AFObjects表

この表は、コンテンツ・サーバーのドキュメントをAFビジネス・オブジェクトにN対N関係でマッピングします。これによって、複数のコンテンツ・アイテムを1つのビジネス・オブジェクトに関連付けることや、複数のビジネス・オブジェクトに同じコンテンツ・アイテムを格納することが可能になります。

ユーザーがドキュメントの添付や添付解除を行うたびに、この表のレコードが追加または更新されます。

C.5.2.1 列の説明

表C-42 AFObjects表の列の説明

列

説明

dAFID

各添付ファイルの一意のIDを格納します。

dAFApplication

ビジネス・アプリケーションのインスタンス名を格納します(たとえばPSFT_InstanceやEBS_Instance)。

dAFBusinessObjectType

ビジネス・アプリケーションのオブジェクト・タイプを格納します(たとえばCallRecordsやHRMS)。

dAFBusinessObject

ビジネス・アプリケーション・インスタンスでのビジネス・オブジェクトのIDを格納します。

dDocName

ビジネス・オブジェクトに関連付けられているコンテンツ・アイテムのIDを格納します。

DID

ビジネス・エンティティに関連付けられているドキュメントのIDを格納します。リビジョン固有添付ファイル・モードでは、ドキュメントの特定バージョンを返すときにこのIDが使用されます。詳細は、第7.6.11項を参照してください。

C.5.3 AFRelationshipAttributes表

この表は、添付ファイルに関連付けられているリレーションシップ属性を格納します。詳細は、第7.6.10項を参照してください。リレーションシップ属性の構成に応じて、1つのドキュメントが0個以上のリレーションシップ属性を持つことができます。

C.5.3.1 列の説明

表C-43 AFRelationshipAttributes表の列の説明

列

説明

dAFID

各添付ファイルの一意のIDを格納します。

attribute

リレーションシップ属性名を格納します。

値

ユーザーが選択したリレーションシップ属性の値を格納します。

C.5.4 AFKeys表

この表は、後で参照できるように個々のキー値を格納します。

ビジネス・アプリケーションでは最大5個の主キー/値の組合せがサポートされ、これをdAFBusinessObjectのかわりに使用してビジネス・エンティティを表すことができます。管理対象添付ファイル・ソリューションでは、これらのキーは、PK_Valueのフィールドを間にパイプ文字(|)を入れて連結することによってdAFBusinessObjectにマッピングされます。元のPK_KeyおよびPK_ValueがAFKeys表に記録され、その後でマッピング操作が実行されます。

C.5.4.1 列の説明

表C-44 AFKeys表の列の説明

列

説明

dAFApplication

ビジネス・アプリケーションのインスタンス名を格納します。

dAFBusinessObjectType

ビジネス・アプリケーションのオブジェクト・タイプを格納します。

dAFBusinessObject

ビジネス・アプリケーション・インスタンスでのビジネス・オブジェクトのIDを格納します。

PK1_Key ... PK5_Key

最大5個のキー/値の組合せを格納します。

PK1_Value ... PK5_Value

最大5個のキー/値の組合せを格納します。

オラクル社の法律上の注意点について

コピーライトについて

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

商標と登録商標について

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

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

ライセンス制約の保証と結果的に生じる損害の免責

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

保証免責

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

制限付権利

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

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

危険な用途への使用について

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

第三者のコンテンツ、製品、サービスに対する免責事項

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

ドラフトのアルファ版およびベータ版ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。オラクル社およびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。