ヘッダーをスキップ
Oracle® Fusion Middleware Oracle WebLogic Server Application Adaptersインストレーション・ガイド
11g リリース1(11.1.1.3.0)
B61415-01
  目次へ移動
目次
索引へ移動
索引

前
 
次
 

A Oracle Fusion Middleware Application Adapter for PeopleSoftの構成

この付録では、Oracle Fusion Middleware Application Adapter for PeopleSoftの構成方法を説明します。内容は次のとおりです。

PeopleSoftのバージョンの指定

Oracle Fusion Middleware Application Adapter for PeopleSoftでは、複数のバージョンのPeopleSoftがサポートされます。ただし、一部のバージョン同士は互換性がないため、使用中のバージョンをアダプタに認識させる必要があります。

インストール後、PeopleTools 8.4xリリースのiwpsci84.jarファイルがデフォルトの場所に配置されます。例:

Oracle SOA Suite:

<ORACLE_HOME>\Oracle_SOA1\soa\thirdparty\ApplicationAdapters\lib

Oracle Service Bus (OSB):

<OSB_HOME>\Oracle_OSB1\3rdparty\ApplicationAdapters\lib

PeopleTools 8.1xリリースのiwpsci81.jarファイルは、次のディレクトリに配置されます。

Oracle SOA Suite:

<ORACLE_HOME>\Oracle_SOA1\soa\thirdparty\ApplicationAdapters\etc\peoplesoft

Oracle Service Bus (OSB):

<OSB_HOME>\Oracle_OSB1\3rdparty\ApplicationAdapters\etc\peoplesoft

Windows以外のシステムでは、対応する場所を使用します。

確実にアダプタを正しく機能させるために、使用するリリースに対応するファイルを使用してください。

libディレクトリの内容を変更した後、すべてのコンポーネント(たとえば、アプリケーション・エクスプローラおよびSOAサーバー)を再起動します。

アダプタのコンポーネント・インタフェースのインストール

Oracle Fusion Middleware Application Adapter for PeopleSoftには、2つのカスタム・コンポーネント・インタフェースが含まれています。Oracle WebLogic Serverアダプタ・アプリケーション・エクスプローラでは、これらのコンポーネント・インタフェースを使用してイベントおよびサービスのスキーマを作成します。

Oracle Fusion Middleware Application Adapter for PeopleSoftのコンポーネント・インタフェースを構成するには、次の項を参照してください。

  1. コンポーネント・インタフェースのインポートおよびビルド

  2. コンポーネント・インタフェースのセキュリティの構成

  3. Oracle Fusion Middleware Application Adapter for PeopleSoftのTCP/IPおよびHTTPメッセージ・ルーターのインストール

コンポーネント・インタフェースのインポートおよびビルド

Oracle Fusion Middleware Application Adapter for PeopleSoftで提供されるコンポーネント・インタフェースは、次のPeopleSoftプロジェクトを介して配布されます。

  • PeopleSoftリリース8.4の場合、iwpsci84.zipにパッケージされているIWY_CI_84プロジェクト。

  • PeopleSoftリリース8.1の場合、iwpsci81.zipにパッケージされているIWY_CI_81プロジェクト。

Microsoft Windowsの場合、これらのファイルのデフォルトの場所は次のとおりです。

Oracle SOA Suite:

<ORACLE_HOME>\Oracle_SOA1\soa\thirdparty\ApplicationAdapters\etc\peoplesoft

Oracle Service Bus (OSB):

<OSB_HOME>\Oracle_OSB1\3rdparty\ApplicationAdapters\etc\peoplesoft

Windows以外のシステムでは、対応する場所を使用します。

コンポーネント・インタフェースのインポートおよびビルド

IWY_CI_81またはIWY_CI_84プロジェクトをPeopleSoftにインポートするには:

  1. iwpsci81.zipまたはiwpsci84.zipを任意のディレクトリに解凍します。

    解凍処理によって独自のサブディレクトリが作成されます。たとえば、c:\tempにファイルを抽出した場合は、c:\temp\IWY_CI_81またはc:\temp\IWY_CI_84が作成されます。

  2. PeopleSoftアプリケーション・デザイナを2層モードで起動します。

  3. 次の手順でコピー元ファイル・プロジェクト選択ダイアログを開きます。

    • PeopleSoft 8.4の場合は、ツール・メニューからプロジェクトのコピーコピー元ファイルを選択します。

    • PeopleSoft 8.1の場合は、ファイル・メニューからファイルからプロジェクトをコピーを選択します。

      図A-1のようにファイルからプロジェクトをコピー・ダイアログが表示されます。

  4. ファイルを解凍した元のディレクトリにナビゲートします。

    図A-1 コピー元ファイル・ダイアログ

    コピー元ファイル・ダイアログ・ボックス
    「図A-1 図A-1 コピー元ファイル・ダイアログ」の説明

  5. 開く(リリース8.4)またはコピー(リリース8.1)をクリックしてコピー元ファイル・ダイアログを開きます。


    注意:

    前出の図はPeopleSoftリリース8.4の画面を表していますが、それぞれの説明はリリース8.1および8.4に正確に対応しています。

  6. 定義タイプに表示されているすべてのオブジェクトを強調表示してコピーをクリックします。

    図A-2のように、正常に完了したことを示すメッセージがアプリケーション・デザイナに表示されます。

    図A-2 アプリケーション・デザイナのメッセージ

    正常終了メッセージ
    「図A-2 アプリケーション・デザイナのメッセージ」の説明

  7. プロジェクトのビューをビルドするには、ビルドプロジェクトを選択します。

    図A-3のようにビルドダイアログが表示されます。

    図A-3 ビルドダイアログ

    ビルドダイアログ・ボックス
    「図A-3 ビルドダイアログ」の説明

  8. ビルド・オプション・ペインでビューの作成を選択します。

  9. ビルド実行オプションペインで、サイトで通常使用するオプションを選択します(前出の図ではSQLを今すぐ実行が選択されています)。

  10. ビルドをクリックします。

    図A-4のように、アプリケーション・デザイナにビルドの進行状況ステータス・ウィンドウが表示されます。

    図A-4 ビルドの進行状況ステータス

    ビルドの進行状況ダイアログ・ボックス
    「図A-4 ビルドの進行状況ステータス」の説明

    ネイティブSQLツールを使用して、生成されたビューのレコードを表示すると、レコードが正しくビルドされたことを確認できます。

  11. ビューが正しくビルドされていない場合は、閉じるをクリックしてSQLビルドのログ文をダブルクリックします。

    図A-5のようにPSBUILDログ・ファイルが表示されます。

    図A-5 PSBuildログ・ファイル

    PSBuildログ・ファイル
    「図A-5 PSBuildログ・ファイル」の説明

  12. 問題が発生した場合は、ビルド設定を選択して、ビルド設定のオプションを確認します。

    図A-6のようにビルド設定ダイアログが表示されます。

    図A-6 ビルド設定ダイアログ

    ビルド設定ダイアログ・ボックス
    「図A-6 ビルド設定ダイアログ」の説明

PeopleSoftのアプリケーション・サーバー・データベースによっては、一部のデータベースで表領域名が必要になる場合があります。この機能に関する詳細は、PeopleSoftデータベース管理者に問い合せてください。

これで、コンポーネント・インタフェースのインポートおよびビルドが終了しました。コンポーネント・インタフェースのセキュリティの構成方法は、「コンポーネント・インタフェースのセキュリティの構成」を参照してください。

コンポーネント・インタフェースのセキュリティの構成

アプリケーション・エクスプローラには、前述の手順でインポートおよびビルドしたカスタムのコンポーネント・インタフェースが必要です。そのため、すべてのアプリケーション・エクスプローラ・ユーザーがこれらのコンポーネント・インタフェースにアクセスできることを確認する必要があります。すべてのPeopleSoftオブジェクトと同様に、セキュリティは権限リスト・レベルで割り当てられます。サイトのセキュリティ要件を確認してアプリケーション・エクスプローラを使用するユーザーを決定し、それらのユーザーに属する個別の権限リストに対してコンポーネント・インタフェースのセキュリティを設定してください。


注意:

これらのコンポーネント・インタフェースは、スキーマおよびビジネス・サービスの作成に必要で、Findメソッドを使用するために実行時に使用されます。コンポーネント・インタフェースにはGetおよびFindのアクセスのみが許可されており、PeopleSoftデータベースの更新に使用することはできません。これにより、セキュリティ上の危険性が最小限に抑えられます。

PeopleSoftリリース8.1では、2、3または4層モードでセキュリティを設定できます。一方リリース8.4以上では、4層モードのみでセキュリティを設定できます。


次の各項では、サポートされているすべてのモードで、PeopleSoftのサポート対象の全リリースのセキュリティを構成する方法を説明します。手順に含まれる図は、4層モードのPeopleSoftリリース8.4を反映しています。

図A-7 PeopleSoftのセキュリティの構成

権限リスト
「図A-7 PeopleSoftのセキュリティの構成」の説明

  1. 図A-7のように、PeopleToolsセキュリティユーザー・プロファイル権限/ロール権限リストを選択します。

  2. 検索をクリックして関連する権限リストを選択します。

    図A-8のように権限リスト・ペインが表示されます。

    図A-8 権限リスト・ペイン

    権限リスト・ペイン
    「図A-8 権限リスト・ペイン」の説明

  3. 図A-9のように、サインオン時間タブの横の右向き矢印をクリックしてコンポーネント・インタフェース・タブを表示します。

    図A-9 一般、ページ、PeopleTools、プロセスおよびサインオン時間タブ

    サインオン時間タブの横の右向き矢印
    「図A-9 一般、ページ、PeopleTools、プロセスおよびサインオン時間タブ」の説明

  4. コンポーネント・インタフェース・タブをクリックします。

  5. コンポーネント・インタフェース・リストに新規行を追加するには、プラス記号(+)を選択します。

  6. IWY_CI_ATTRIBUTES Component Interfaceを入力または選択して編集をクリックします。

  7. GetおよびFindメソッドをフル・アクセスに設定するには、すべてフル・アクセスをクリックします。

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

  9. IWY_CI_MESSAGESコンポーネント・インタフェースに対してステップ5 - 8を繰り返します。

  10. コンポーネント・インタフェース・ウィンドウの下までスクロールして保存をクリックします。

Oracle Fusion Middleware Application Adapter for PeopleSoftとともに配布されたコンポーネント・インタフェースのセキュリティの構成が終了しました。コンポーネント・インタフェースをテストするには、「コンポーネント・インタフェースのテスト」を参照してください。

コンポーネント・インタフェースのテスト

Oracle Fusion Middleware Application Adapter for PeopleSoftのそれぞれのコンポーネント・インタフェースは、使用前にテストする必要があります。

コンポーネント・インタフェースをテストするには:

  1. PeopleSoftアプリケーション・デザイナでIWY_CI_ATTRIBUTESコンポーネント・インタフェースを開きます。

  2. ツールコンポーネント・インタフェースのテストを選択します。

    図A-10のようにコンポーネント・インタフェース・テスター・ダイアログが表示されます。

    図A-10 コンポーネント・インタフェース・テスター・ダイアログ

    コンポーネント・インタフェース・テスター・ダイアログ・ボックス
    「図A-10 コンポーネント・インタフェース・テスター・ダイアログ」の説明


    注意:

    このコンポーネント・インタフェースにはAddメソッドが適用されないため、新規作成オプションは無効化されています。

  3. 検索をクリックします。基礎となるコンポーネントのエントリが表示されます。

    図A-11のように、表示されるエントリが特定の数に制限されていることを示すメッセージが表示される場合があります。これは問題ありません。

    図A-11 コンポーネント・インタフェース・テスター - 検索結果ダイアログ

    コンポーネント・インタフェース・テスター検索結果
    「図A-11 コンポーネント・インタフェース・テスター - 検索結果ダイアログ」の説明

  4. 検索結果ウィンドウで対応するキーを含む1行を強調表示し、選択を取得をクリックします。選択したキーの関連データが表示されます。

    図A-12のようにこのウィンドウが表示されると、コンポーネント・インタフェースのFindメソッドに関するテストが正常に実行されたことになります。

    図A-12 コンポーネント・インタフェース・テスター・ダイアログ

    コンポーネント・インタフェース・テスターのデータ
    「図A-12 コンポーネント・インタフェース・テスター・ダイアログ」の説明

  5. 既存を取得をクリックします。Getメソッドの場合は、図A-13のように既存のキーを入力する必要があります。

    図A-13 コンポーネント・インタフェース・テスター・ダイアログ - キー値

    コンポーネント・インタフェース・テスターのGetメソッド
    「図A-13 コンポーネント・インタフェース・テスター・ダイアログ - キー値」の説明

    入力したキーの公開中のプロパティが返されます。

    図A-14のようにウィンドウが表示されると、コンポーネント・インタフェースのGetメソッドに関するテストが正常に実行されたことになります。

    図A-14 コンポーネント・インタフェース・テスター・ダイアログ - Getメソッド

    コンポーネント・インタフェース・テスター - 公開中のキー・プロパティ
    「図A-14 コンポーネント・インタフェース・テスター・ダイアログ - Getメソッド」の説明

  6. IWY_CI_MESSAGESコンポーネント・インタフェースに対してこの手順を繰り返します。

コンポーネント・インタフェースのテストが終了しました。

Oracle Fusion Middleware Application Adapter for PeopleSoftのTCP/IPおよびHTTPメッセージ・ルーターのインストール

TCP/IPおよびHTTPを使用してPeopleSoftからコンポーネントへXMLイベント・ドキュメントを送信できるようにするには、使用するPeopleSoftのリリースに必要なタイプのTCP/IPおよびHTTPメッセージ・ルーターをインストールする必要があります。

  • リリース8.4の場合は、TCP/IPおよびHTTPターゲット・コネクタをインストールします。詳細は、「PeopleSoftリリース8.4のTCP/IPおよびHTTPターゲット・コネクタのインストール」を参照してください。

    リリース8.4に関して、iWay Softwareでは、PeopleSoftによって配布されるPeopleTools 8.4シリーズ用のTCP/IPおよびHTTPターゲット・コネクタを使用することを推奨しています。iWay SoftwareからPeopleTools 8.1シリーズ用に提供されているターゲット・コネクタは使用しないでください。iWay Software提供のPeopleTools 8.4シリーズ用コネクタは、リリース8.1からリリース8.4へ移行する既存のユーザーを支援するためにのみ、パッケージに含まれています。

  • リリース8.1の場合は、TCP/IPおよびHTTPハンドラをインストールします。詳細は、「PeopleSoftリリース8.1のTCP/IPおよびHTTPハンドラのインストール」を参照してください。


注意:

イベント処理にPeopleSoftのメッセージを使用しない場合は、この項をスキップして構いません。

PeopleSoftリリース8.4のTCP/IPおよびHTTPターゲット・コネクタのインストール

PeopleSoftリリース8.4のTCP/IPおよびHTTPターゲット・コネクタは、Oracle Fusion Middleware Application Adapter for PeopleSoftとともにインストールされます。Microsoft Windowsの場合、デフォルトの場所は次のとおりです。

Oracle SOA Suite:

<ORACLE_HOME>\Oracle_SOA1\soa\thirdparty\ApplicationAdapters\etc\peoplesoft\iwpsevent84.jar

Oracle Service Bus (OSB):

<OSB_HOME>\Oracle_OSB1\3rdparty\ApplicationAdapters\etc\peoplesoft\iwpsevent84.jar

Windows以外のシステムでは、対応する場所を使用します。

PeopleSoftリリース8.4のTCP/IPおよびHTTPターゲット・コネクタをインストールするには:

  1. iwpsevent84.jarからTCPIPTARGET84.classを抽出します。使用するプラットフォームの任意の抽出ユーティリティを使用してください。

  2. TCPIPTARGET84.classをPeopleSoftゲートウェイWebサーバーがあるプラットフォームに移植します。

  3. PeopleSoftサーバーのターゲット・コネクタ・ディレクトリにTCPIPTARGET84.classを配置します。

    例:

    $PS_HOME/webserv/servletclasses/TCPIPTARGET84.class
    

PeopleSoftリリース8.1のTCP/IPおよびHTTPハンドラのインストール

PeopleSoftリリース8.1のTCP/IPおよびHTTPターゲット・コネクタは、Oracle Fusion Middleware Application Adapter for PeopleSoftとともにインストールされます。Microsoft Windowsの場合、デフォルトの場所は次のとおりです。

Oracle SOA Suite:

<ORACLE_HOME>\Oracle_SOA1\soa\thirdparty\ApplicationAdapters\etc\peoplesoft\iwpsevent81.jar

Oracle Service Bus (OSB):

<OSB_HOME>\Oracle_OSB1\3rdparty\ApplicationAdapters\etc\peoplesoft\iwpsevent81.jar

Windows以外のシステムでは、対応する場所を使用します。この場所がない場合は、販売代理店に問い合せて関連するファイルのコピーを入手してください。

PeopleSoftリリース8.1のTCP/IPおよびHTTPハンドラをインストールするには:

  1. iwpsevent81.jarをPeopleSoftゲートウェイWebサーバーがあるプラットフォームに移植します。

  2. PeopleSoft Webサーバーのservletclassesディレクトリにiwpsevent81.jarを配置します。

    例:

    $PS_HOME/webserv/servletclasses/iwpsevent81.jar
    
  3. 組込みクラスのファイルを抽出します。

UNIXシステムでのTCP/IPおよびHTTPハンドラのインストール

UNIXシステムでPeopleSoftリリース8.1のTCP/IPおよびHTTPハンドラをインストールするには:

  1. 正しいPeopleSoftのIDおよび権限を使用してUNIXシステムにログインします。

  2. PeopleSoft Webサーブレットのディレクトリにナビゲートします。このディレクトリはリリースによって異なる場合がありますが、通常は次のディレクトリです。

    $PS_HOME/webserv/servletclasses
    
  3. jarコマンドを発行して、PeopleSoftに必要なクラス・ファイルを抽出します。

    次にコマンドの例を示します。

    jar -xvf /tmp/iwpsevent81.jar
    

    Sun (Solaris)システムでは次の出力が表示されます。

    $ jar -xvf /tmp/iwpsevent81.jar
    created: META-INF/
    extracted: META-INF/MANIFEST.MF
    extracted: psft/pt8/tcphandler/TCPIPHandler81$Entry.class
    extracted:
    psft/pt8/tcphandler/TCPIPHandler81$HandlerEntry.class
    extracted:
    psft/pt8/tcphandler/TCPIPHandler81$PublicationHandler.class
    extracted: psft/pt8/tcphandler/TCPIPHandler81.class
    $
    

    注意:

    ファイルは、psft/pt8の下のtcphandlerという新規ディレクトリに配置されます。