ヘッダーをスキップ
Oracle® Fusion Middleware Oracle WebCenterアプリケーション・アダプタの管理
11gリリース1 (11.1.1)
B72423-02
  ドキュメント・ライブラリへ移動
ライブラリ
目次へ移動
目次

前
 
次
 

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

この章では、Oracle E-Business Suite、Oracle PeopleSoftまたは別のビジネス・アプリケーションのための管理対象添付ファイル・ソリューションを構成する方法を説明します。構成スクリプトを実行し、コンテンツ・サーバー・コンポーネントを構成し、ソリューションをカスタマイズし、Oracle AutoVueとOracle WebCenter Captureを統合し、認証とセキュリティを構成する方法を説明します。


注意:

管理対象添付ファイル・ソリューションのバックグラウンドの情報については、第1.4項を参照してください。


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

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以上)

管理対象添付ファイル・ソリューションは、コンテンツ・サーバーの次の検索エンジンをサポートしています。


注意:

Folders_gコンポーネントにより、デフォルトでAuthorDelete=trueと呼ばれる変数が設定され、この変数により、ユーザーはセキュリティ・グループの権限を削除せずに、自身が権限を持つドキュメントを削除できます。Folders_gコンテンツ・サーバー・コンポーネントを管理対象添付ファイル・ソリューションで使用する場合は、この変数設定が管理対象添付ファイルのdPrivilegeまたはAppAdapterGrantPrivilege削除設定をオーバーライドすることがある点に注意してください。


Oracle E-Business Suite

7.2 管理対象添付ファイルを使用可能にするための構成スクリプトの実行

この項では、次の項で説明されている手順に従って、表7-1でリストされている構成スクリプトの実行について説明します。最初のスクリプトは、AXF要素を構成します。また、Enterprise Application Adapter Frameworkを含む、すべての管理対象添付ファイルの構成のために必要です。残りのスクリプトは、表7-1で示されているように、特定のビジネス・アプリケーションに適用されます。

表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 添付ファイル情報と主キーの両方が存在する

理想的に、必要な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 ビュー・オブジェクトの判別

    この図については、前後のテキストで説明されています。
    「図 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 ビューの詳細の表示

      この図については、前後のテキストで説明されています。
      「図7-2 ビューの詳細の表示」の説明

    4. 選択したビューに一番適した表を選択します(この例では、PO_HEADERS_ALL)。

    5. 図7-3に、その表に関連付けられた主キー詳細を示します。その主キーを判別します(この例では、PO_HEADER_ID)。

    6. 図7-3 表の詳細の表示

      この図については、前後のテキストで説明されています。
      「図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に、管理対象添付ファイル・ソリューションのコンテンツ・サーバー・コンポーネントをリストします。

表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コンポーネントのデプロイ

この項で後で説明するとおりに、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をビジネス・アプリケーション名と置き換えます(たとえば、UniversalBIZAPPと置き換えます)。

    この文字列が、管理対象添付ファイルURLで使用されるResultTemplate名で使用されることに注意してください(たとえば、ResultTemplate=BIZAPP_LIST)。結果テンプレートの詳細は、第7.6.13項を参照してください。

  4. universal_AppAdapter_strings.htmファイルを見つけて、文字列Applicationをすべてビジネス・アプリケーションの詳細名と置き換えます(たとえば、ApplicationExampleBusinessAppと置き換えます)。

  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 「管理対象添付ファイルの構成」ページ

    図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 チェックイン変数

フィールド デフォルト値 説明

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.5項を参照してください。)これにより、特定のユーザー・ロールのための設定をカスタマイズするとともにグローバル値を保存できるようになります。たとえば、この機能を使用して、読取り専用ロールを割り当てられたコンテンツ・サーバー・ユーザーのために管理対象添付ファイルへのアクセスを読取り専用に制限できます。

  1. コンテンツ・サーバーで、「管理」メニューから「管理対象添付ファイル」を選択します。

    「管理対象添付ファイルの構成」ページが表示されます。

  2. ページの下部にある「ロール固有構成」の設定にスクロールして、「追加」をクリックします。

  3. 図7-5で示されている「ロール固有構成の追加」ページで、フィールドに入力しユーザー・ロールに基づいて管理対象添付ファイル変数をカスタマイズし、「更新」をクリックします。この例は、次の設定を指定します。

    • 構成名: AppAdapterGrantPrivilege

    • 値: R

    • ロール: readRole

    AppAdapterGrantPrivilege変数では、ユーザーに付与するアクセス・レベルが指定されます。この例では、コンテンツ・サーバーでUser Admin機能を使用してロール(この例ではreadRole)を構成し割り当ててあるものとします。

    図7-5 ロール固有の構成の例

    この図については、前後のテキストで説明されています。
    「図7-5 ロール固有の構成の例」の説明

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

管理対象添付ファイル管理を使用して、ユーザーのビジネス・コンテキストに基づいて設定をカスタマイズできます。(一般的な情報については、第7.5項を参照してください。)これにより、特定のビジネス・コンテキストのための設定をカスタマイズするとともにグローバル値を保存できるようになります。たとえば、この機能を使用して、ユーザーのビジネス・コンテキスト(ビジネス・アプリケーションから渡されたbusinessObjectContext)が特定の値(ScanContextなど)の場合のみ「スキャン」ボタンを表示し使用可能にすることができます。

  1. コンテンツ・サーバーで、「管理」メニューから「管理対象添付ファイル」を選択します。

    「管理対象添付ファイルの構成」ページが表示されます。

  2. ページの下部にある「ビジネス・コンテキスト固有構成」の設定にスクロールして、「追加」をクリックします。

  3. 図7-6で示されている「ビジネス・コンテキスト固有構成」ページで、フィールドに入力しビジネス・コンテキストに基づいて管理対象添付ファイル変数をカスタマイズし、「更新」をクリックします。

    図7-6で示されている例では、ScanContextと等しいビジネス・アプリケーションからbusinessObjectContextが渡されたときに「スキャン」ボタンを表示するよう構成します。この例は、次の設定を指定します。

    • 構成名: AppAdapterScanBtnVisible

    • 値: true

    • ロール: ScanContext

    図7-6 ビジネス・コンテキスト固有の構成の例

    この図については、前後のテキストで説明されています。
    「図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-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 スキャンの有効化または無効化

グローバル、アプリケーションまたはビジネス・エンティティ・レベルでスキャンを有効化または無効化できます。たとえば、グローバルにスキャンを無効化してから、次の「エンティティ固有構成」設定を使用して、OrderPayablesビジネス・エンティティのためにのみスキャンを有効化するようエンティティ固有の構成を追加できます。

  • アプリケーション名: EBS_Instance

  • オブジェクト・タイプ: OrderPayables

  • 構成名: AppAdapterScanBtnVisible

  • 構成値: true

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

アダプタでは、管理対象添付ファイルのスキャン・ページを表示する、次のデフォルトのビジネス・アプリケーション・スキャン・プロファイルが提供されます。それぞれは、次のようにアプリケーション固有のフィールドを指します。

  • EBSScanProfileは、EBSAppScanProfilesアプリケーション・フィールドを参照します

  • PSFTScanProfileは、PSFTAppScanProfilesアプリケーション・フィールドを参照します

  • UniversalScanProfileは、UniversalAppScanProfilesアプリケーション・フィールドを参照します

次の手順で説明するように、ビジネス・アプリケーションに適したプロファイルをコピーし、別のアプリケーション・フィールドを参照するようにそれを変更し、1つ以上のビジネス・エンティティのためにそれを構成することで、使用されるスキャン・プロファイルをカスタマイズできます。

  1. ビジネス・アプリケーションに適用するスキャン・プロファイルをコピーし、新しい名前で保存します。

  2. AppScanProfilesアプリケーション・フィールド、表およびビューを含む、必要なすべてのスキーマ要素を作成します。

    アプリケーション・フィールド参照を変更するには、コンテンツ・サーバーにログインします。構成マネージャで、「ルール」タブに移動します。PSFTScanRuleEBSScanRuleまたは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-8 「添付リレーションシップ属性の追加」ページ」の説明

  7. 属性のためのフィールドに入力し、「更新」をクリックします。図7-8の例では、Oracle PeopleSoftアプリケーションのWO1ビジネス・オブジェクトのために構成されたリレーションシップ属性(Print)を示します。

    要素 説明

    アプリケーション名

    リレーションシップ属性が構成されるビジネス・アプリケーションです。

    PSFT_Instance

    オブジェクト・タイプ

    リレーションシップ属性を使用可能にするビジネス・オブジェクトです。

    WO1

    属性名

    リレーションシップ属性です。

    Print

    属性のタイプ

    属性のタイプ。使用可能なタイプは、テキスト、ロング・テキスト、日付、メモ、整数およびTrueFalseです。

    TrueFalse


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

デフォルトでは、「管理対象添付ファイル」ページ上の各添付ファイルは、ドキュメントの最も新しいリビジョンへのアクセスを提供します。ただし、ある場合においては、ドキュメントが後でコンテンツ・サーバーで更新された場合でも、添付されたリビジョンへのアクセスを提供するよう、1つ以上のビジネス・エンティティを構成できます。このモードでは、ユーザーは、より新しいリビジョンが存在することを確認し、必要な場合は、それを表示し、それを添付済リビジョンにすることができます。

次の手順に従って、最も新しいリビジョンではなく添付されたリビジョンを表示するようビジネス・エンティティを構成します。

  1. コンテンツ・サーバーで、「管理」メニューから「管理対象添付ファイル」を選択します。

  2. 「管理対象添付ファイルの構成」ページで、ページの下部にある「エンティティ固有構成」の設定にスクロールして、「追加」をクリックします。

    「エンティティ固有構成の追加」ページが表示されます。

    図7-9 「エンティティ固有構成の追加」ページでのリビジョン固有モードの構成

    この図については、前後のテキストで説明されています。
    「図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. ビジネス・アプリケーションのためのコマンド・パラメータ表にアクセスします。

  4. labelValue行の追加と同様に、コンテンツ・サーバーに渡される追加の値のための表にエントリを追加します。例7-9で示されているコマンドの例、および表7-15で示されている表の例を参照してください。

    コンテンツ・サーバーのフィールド名の先頭にextraを追加して、メタデータごとに行を追加します。たとえば、xReqNumextraxReqNumになり、dDocTitleextradDocTitleになります。


    注意:

    一般には、コンテンツ・サーバーの追加情報フィールドには前に 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を追加して(xReqNumextraxReqNumになり、dDocTitleextradDocTitleになる)、追加のメタデータ値を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 エンティティ・レベルのプライベート添付ファイル・セキュリティ・グループの構成

    この図については、前後のテキストで説明されています。
    「図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資格証明の構成

管理者ユーザーの資格証明を資格証明ストア・フレームワーク(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の構成について

「管理対象添付ファイル」ページのためのデフォルトのドキュメント表示オプションは、コンテンツ・サーバーによって提供される標準の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-11 AutoVue Document Viewingの例」

7.9 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、メタデータ・フィールド

      図7-12の説明が続きます
      「図7-12 WebCenter Capture、メタデータ・フィールド」の説明

  3. ワークスペースの「分類」タブで、図7-13に示すように、アダプタ・メタデータ・フィールドのドキュメント・プロファイルを作成します。詳細は、Oracle Fusion Middleware Oracle WebCenter Captureの管理のドキュメント・プロファイルに関する項を参照してください。

    図7-13 WebCenter Capture、ドキュメント・プロファイル

    図7-13の説明が続きます
    「図7-13 WebCenter Capture、ドキュメント・プロファイル」の説明


    注意:

    一般には、ユーザーに表示するためにビジネス・アプリケーション・エンティティ・フィールド(たとえば、dAFBusinessObject)を選択しません。表示するように選択した場合には、メタデータ設定の下でロックして、ユーザーが値を変更できないようにします。


  4. 「キャプチャ」タブで、図7-14に示すように、クライアント・プロファイルを作成します。後でこのクライアント・プロファイルを1つ以上のドキュメント分類に関連付けます。そのため、ユーザーが分類を選択する際に、関連付けられたクライアント・プロファイルの設定が使用されます。詳細は、Oracle Fusion Middleware Oracle WebCenter Captureの管理のクライアント・プロファイルに関する項を参照してください。

    1. 「一般設定」トレイン・ストップの「プロファイル・タイプ」フィールドで「2 - キャプチャと索引」を選択します。このキャプチャ・タイプには、キャプチャ(スキャンまたはインポート)および索引付けが含まれます。クライアント・プロファイルのプロファイル名とバッチ・プレフィクスを指定します。

    2. 「ドキュメント索引付け設定」トレイン・ストップで、手順3で作成したアダプタ・ドキュメント・プロファイルを選択します。「メタデータ」タブでデータベース参照プロファイルを作成した場合、オプションでこれを選択できます。

    3. 「送信」をクリックし、クライアント・プロファイルを保存します。

      図7-14 WebCenter Capture、クライアント・プロファイル

      図7-14の説明が続きます
      「図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-15の説明が続きます
      「図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の構成

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


注意:

このアダプタとの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、「システム設定」タブ

    この図については、前後のテキストで説明されています。
    「図7-16 Distributed Document Capture Server Configuration、「システム設定」タブ」の説明

  2. 図7-17で示されているように、取得管理で、新規ドキュメントのための値を取得するために、選択されたファイル・キャビネットへ索引フィールドを追加します。詳細は、Oracle Distributed Document Capture管理者ガイドの取得管理に関する項を参照してください。

    1. 値のための索引フィールドを作成し、コンテンツ・サーバー上に添付済ドキュメントとともに保存します。たとえば、ユーザーが標準のドキュメント・タイプから選択するための、ドキュメント・タイプ選択リスト索引フィールドを構成できます。

    2. ビジネス・アプリケーション・エンティティの値および必要なフィールドを含むよう、次の英数字の索引フィールドを作成します。

      • dAFApplication

      • dAFBusinessObjectType

      • dAFBusinessObject

      • dSecurityGroup

      • Title

      図7-17 Captureの「管理」の「索引」フィールド

      この図については、前後のテキストで説明されています。
      「図7-17 Captureの「管理」の「索引」フィールド」の説明

  3. 図7-18で示されているように、Oracle Distributed Document Captureのプロファイル管理で、スキャン・プロファイルを作成します。後でこのスキャン・プロファイルを1つ以上のドキュメント分類に関連付けます。そのため、ユーザーが分類を選択する際に、関連付けられたスキャン・プロファイルの設定が使用されます。詳細は、Oracle Distributed Document Capture管理者ガイドのスキャン・プロファイルに関する項を参照してください。

    1. 「一般」ペインの「スキャン・タイプ」フィールドで2 - ドキュメントのスキャンおよび索引作成を選択します。このスキャン・タイプは索引作成を含み、ページをスキャンするか、バッチで単一のドキュメントにインポートします。ファイル・キャビネットおよびバッチ・プリフィックスを指定します。

      図7-18 スキャン・プロファイル、Oracle Distributed Document Captureプロファイルの管理

      この図については、前後のテキストで説明されています。
      「図7-18 スキャン・プロファイル、Oracle Distributed Document Captureプロファイルの管理」の説明

    2. 「ドキュメント索引付け」ペインで、ユーザーに表示するすべてのフィールドを「選択したフィールド」ボックスに移動します。ユーザーが入力するための「タイトル」フィールドを表示し、そのフィールドを必須にすることをお薦めします。


      注意:

      一般には、ユーザーに表示するためにビジネス・アプリケーション・エンティティ・フィールド(たとえば、dAFBusinessObject)を選択しません。それらを表示することを選択する場合は、「フィールドのプロパティ」ペインでそれらをロックし、ユーザーがそれらの値を変更できないようにします。


      図7-19 スキャン・プロファイル、Oracle Distributed Document Captureプロファイルの管理

      この図については、前後のテキストで説明されています。
      「図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 コミット・プロファイル設定

      この図については、前後のテキストで説明されています。
      「図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の管理、コンテンツ・サーバーのコミット設定の「チェックイン」

      この図については、前後のテキストで説明されています。
      「図7-21 Captureの管理、コンテンツ・サーバーのコミット設定の「チェックイン」」の説明

    4. 「フィールド・マッピング」タブで、「カスタム・フィールドの追加/編集」ボタンをクリックし、図7-22で示されている「カスタム・フィールドの追加/編集」ダイアログ・ボックスに次のカスタム・フィールドを追加します。

      • dAFApplication

      • dAFBusinessObjectType

      • dAFBusinessObject

      図7-22 Captureの管理、「カスタム・フィールドの追加/編集」

      この図については、前後のテキストで説明されています。
      「図7-22 Captureの管理、「カスタム・フィールドの追加/編集」」の説明

      「OK」をクリックします。追加したカスタム・フィールドが、図7-23で示されている「フィールド・マッピング」タブに表示されます。新しいコンテンツ・サーバー・ドキュメントをビジネス・アプリケーション・エンティティに添付するために必要なため、手順2で作成した対応する索引フィールドにこれらのカスタム・フィールドをマップします。また、値をコンテンツ・サーバー・フィールドに書き込みたいその他のCaptureフィールドもマップします。「OK」をクリックします。

    5. 「管理」ツリーから「コミット・プロファイル」をクリックし、コミット・プロファイルのために「アクティブ」チェック・ボックスを選択することで、ビジネス・アプリケーション-コンテンツ・サーバー・コミット・プロファイルをアクティブ化します。

    図7-23 Captureの管理、コンテンツ・サーバー・コミット設定のためのフィールド・マッピング

    この図については、前後のテキストで説明されています。
    「図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)、「値の編集」をクリックします。

      この図については、前後のテキストで説明されています。
      illustration doc_class1.gifの説明

  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 管理対象添付ファイル・ドライバ・ページのパラメータの例

    図7-24の説明が続きます
    「図7-24 管理対象添付ファイル・ドライバ・ページのパラメータの例」の説明

  3. 「リクエストの実行」ボタンをクリックします。

    conversationIdおよび他の対応するフィールドでの入力によって指定されたとおり、対話が開始されます。

  4. 「レスポンス・コマンド」で、「レスポンスの実行」ボタンをクリックします。

    新しいブラウザ・ウィンドウが開き、「管理対象添付ファイル」ページが表示されます。

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

コンテンツ・サーバーのロギングの詳細は、『Oracle Fusion Middleware Oracle WebCenter Contentの管理』を参照してください。

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

次の手順に従って、コンテンツ・サーバー上の次のアダプタ・コンポーネントを無効にしてからアンインストールします。

これらのコンポーネントの詳細は、第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. コンテンツ・サーバーを再起動して変更内容を適用します。