ヘッダーをスキップ
Oracle Identity Manager PeopleSoft Employee Reconciliation Connectorガイド
リリース9.0.4
E05507-02
  目次
目次
索引
索引

戻る
戻る
 
次へ
次へ
 

3 ターゲット・システムとOracle Identity Managerの構成

この章では、次のトピックについて説明します。


注意:

この項では、コネクタの構成に関する概念および手順の両方を説明します。概念情報を確認してから手順を実行することをお薦めします。

ターゲット・システムの構成

この項では、次のトピックについて説明します。

完全リコンシリエーションのためのターゲット・システムの構成

第1章「コネクタについて」で説明しているように、完全リコンシリエーションでは、ターゲット・システムのすべてのデータがOracle Identity Managerにリコンサイルされます。アクティブ化されたPeopleCodeが、PERSONAL_DATAJOB_DATAJOB_DATA_EMPなどの該当する一部のコンポーネントを使用して必要な従業員情報を抽出します。

完全リコンシリエーションのためのターゲット・システムを構成するには、次の手順を実行して、完全リコンシリエーションのためのフラット・ファイルを準備します。

  1. Application Engineプログラムの作成

    Application Engineプログラムは、完全リコンシリエーションを初めて実行するときに1回のみ作成する必要があります。

  2. Application Engineプログラムの実行

    完全リコンシリエーションを実行するたびに、Application Engineプログラムを実行する必要があります。

Application Engineプログラムの作成

Application Engineプログラムは、完全リコンシリエーションの実行に使用されるフラット・ファイルに、リコンサイルする必要があるユーザー・アカウント情報を移入します。Application Engineプログラムを作成するには、次のようにします。

  1. Application Designerを2層モードで開くには、「スタート」「プログラム」「Peoplesoft8.x「Application Designer」の順にクリックします。

  2. 「File」メニューから「New」を選択します。

  3. 「New Definition」ダイアログ・ボックスで、「Definition」リストから「App Engine Program」を選択します。

  4. 「App Engine Program」ページで、Application EngineプログラムのMAINセクションの前に表示されているプラス記号(+)の下に、複数のステップを含めることができます。各ステップに、実行するPeopleCodeを含めることができます。プラス記号(+)をクリックします。Step01という名前のステップがMAINに追加されます。

  5. Step01Populateという名前に変更します。

  6. App Engine Programウィンドウで、「Insert」メニューから「Action」を選択します。アクションがPopulateステップに追加されます。

  7. 新しいアクションのリストから「PeopleCode」を選択します。

  8. 「File」メニューから「Save」をクリックして、Application EngineプログラムをBLKPRCS_HRという名前で保存します。

  9. 「PeopleCode」アクションをダブルクリックします。新しいPeopleCodeウィンドウが表示されます。

  10. PeopleCodeウィンドウで、OIM_HOME/xellerate/Scripts/HRMSBulkRecon.txtファイルからコードをコピーします。このコードを次のように変更する必要があります。

    • <ABSOLUTE_PATH_OF_THE_FILE>プレースホルダを出力ファイルのディレクトリ・パスに置き換えます。サンプル・ディレクトリ・パスを、ターゲット・システム・サーバー上のディレクトリ・パスに変更します。

    • BIRTHDATEおよびHIREDATEの値をフェッチするコードの記述は、Oracleデータベースに固有のものです。したがって、Peoplesoftを実行しているデータベースによっては、HRMSBulkRecon.txtファイルからコピーしたコードの変更が必要な場合があります。次に例を示します。

      Microsoft SQL ServerでPeoplesoftを実行する場合:

      • TO_CHAR(BIRTHDATE, 'ddmmyy')convert(varchar, BIRTHDATE, 104)で置き換えます。

      • TO_CHAR(HIRE_DT, 'ddmmyy')convert(varchar, HIRE_DT, 104)で置き換えます。

      SybaseでPeoplesoftを実行する場合:

      • TO_CHAR(BIRTHDATE, 'ddmmyy')convert (char(6), BIRTHDATE, 12)で置き換えます。

      • TO_CHAR(HIRE_DT, 'ddmmyy')convert (char(6), HIRE_DT, 12)で置き換えます。

      InformixでPeoplesoftを実行する場合:

      • TO_CHAR(BIRTHDATE, 'ddmmyy')TO_CHAR (BIRTHDATE, " | """%d %m %y""" | ")で置き換えます。

      • TO_CHAR(HIRE_DT, 'ddmmyy')TO_CHAR(HIRE_DT, " | """%d %m %y""" | ")で置き換えます。

  11. Microsoft SQL ServerでPeopleSoftサーバーを実行する場合は、次のファイルのXelServerDateプロパティ値の変更が必要な場合があります。

    OIM_HOME/xellerate/XLIntegrations/PSFTHR/config/configureReconciliation.properties
    

    このプロパティの値を次のように変更します。

    dd.mm.yy
    

    OracleデータベースでPeopleSoftサーバーを実行する場合、XelServerDateプロパティの値を変更する必要はありません。

  12. Application Engineプログラムを保存し、ウィンドウを閉じます。

Application Engineプログラムの実行

Application Engineプログラムを実行する手順は、使用しているPeopleToolsのリリースによって異なります。

PeopleTools 8.22でのApplication Engineプログラムの実行

PeopleTools 8.22でApplication Engineプログラムを実行するには、次のようにします。

  1. PeopleSoft Internet Architectureにログインします。

  2. 「People Tools」「Process Scheduler Manager」「Use」「Process Definitions」の順にクリックします。

  3. 「Process Definitions」ページで、「Add a New value」をクリックします。

  4. 「Process Type」リストから「Application Engine」を選択します。

  5. プロセス名としてApplication Engineプログラムの名前BLKPRCS_HRを入力します。

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

  7. 「Add」をクリックしたときに表示される検索結果から、Application Engineプログラムを選択します。

  8. 「Process Definition Options」タブで、次の値を指定します。

    • Run Location: Server

    • Server Name: PSNT

    • Component: PRCSMULTI

    • Process Groups: ALLPANLS

  9. 「Save」をクリックします。

  10. ホームページに戻ります。

  11. 「People Tools」「Process Scheduler Manager」「Process」「Sample Processes」の順にクリックします。

  12. 「Sample Processes」ページで、「Add a New value」をクリックします。

  13. 実行制御IDを指定し、「Add」をクリックします。


    注意:

    実行制御IDは、実行時にプロセスに必要なパラメータが含まれるレコードのキーとして使用されます。パラメータが、プロセスで実行制御IDおよびユーザーIDを使用して問合せできる表に格納されている場合、そのプロセスはユーザー介入なしで実行できます。

  14. 「Run」をクリックします。

  15. 「Process Scheduler Request」ページで、サーバー名を指定します。

  16. Application Engineプログラム名を選択し、「OK」をクリックします。

  17. 「Process Monitor」をクリックして、プロセスのステータスを確認します。

    プロセス・ステータスがSuccessに変更された後、HRMSBulkRecon.txtファイルからコピーしたコード内の指定された場所に、カンマ区切りのフラット・ファイルが作成されます。

PeopleTools 8.45〜8.48でのApplication Engineプログラムの実行


注意:

Application Engineプログラムが2層モードで動作するためには、Application Designerへのアクセスに使用されるサーバーにデータベース・クライアントがインストールされている必要があります。2層モードに切り替えるには、PeopleSoftのサインオン画面でConnection Typeをデータベースとして選択します。

PeopleTools 8.45〜8.48でApplication Engineプログラムを実行するには、次のようにします。

  1. 「スタート」「プログラム」「Peoplesoft8.x「Application Designer」の順にクリックします。Application Designerウィンドウが2層モードで表示されます。

  2. 接続タイプ、ユーザーIDおよびパスワードを指定します。

  3. 作成したApplication Engineプログラムを開くには、次のようにします。

    1. 「File」メニューから「Open」を選択し、「Object Type」リストから「Application Engine Program」を選択します。

    2. 「BLKPRCS_HR」を選択し、「Open」をクリックします。

  4. メニュー・バーの下のツールバーで「RUN PROGRAM」コントロールをクリックします。HRMSBulkRecon.txtファイルからコピーしたコード内の指定された場所に、従業員レコードを含むカンマ区切りのフラット・ファイルが作成されます。

増分リコンシリエーションのためのターゲット・システムの構成

増分リコンシリエーションのためのターゲット・システムの構成では、メッセージおよびメッセージ・チャネルを作成し、PeopleSoft Integration Brokerから他のシステムにメッセージを移入および送信するためのPeopleCodeを記述してメッセージを公開し、Integration Brokerを構成します。


注意:

PeopleTools 8.48およびHCM 9.0では、メッセージ・チャネルがキューに置き換えられています。

メッセージは、PeopleSoft Enterprise Applicationsから送信されるXMLデータの物理コンテナです。メッセージ定義は、PeopleSoft Enterprise Applicationsから送信されるデータの物理記述です。このデータには、フィールド、フィールドのタイプおよび長さが含まれます。メッセージ・チャネルを使用して、メッセージを搬送します。メッセージ・チャネルは、データを論理グループとして構成するためのメカニズムです。各メッセージは、1つのメッセージ・チャネルのみに所属できます。

メッセージを作成し、メッセージをそれぞれのメッセージ・チャネルに関連付けた後、Application DesignerでPeopleCodeを記述して、メッセージを公開する必要があります。これは、PeopleSoft Integration BrokerとOracle Identity ManagerはXMLメッセージを交換して通信し、メッセージはPeopleCodeの特定の命令によってのみ開始されるためです。


注意:

メッセージおよびメッセージ・チャネルの作成、およびメッセージの公開の手順は、使用しているターゲット・システムのバージョンによって異なります。PeopleSoft Integration Brokerを構成する手順は、使用しているPeopleToolsのバージョンによって異なります。

PeopleSoft Integration Brokerを構成する場合、PeopleSoft Integration Brokerゲートウェイの設定は必須です。XMLデータへのサブスクライブのため、Oracle Identity ManagerはPeopleSoft Integration BrokerゲートウェイにあるPeopleSoftコネクタを使用して、PeopleSoftによってポストされるXMLメッセージを受け入れ、処理できます。これらのコネクタは、PeopleSoft Integration Brokerゲートウェイによって制御されるJavaプログラムであり、XMLファイルの場所を制御します。

このゲートウェイは、PeopleSoft Webサーバーで実行されるプログラムです。PeopleSoftと他のPeopleSoftアプリケーション(またはOracle Identity Managerなどのサード・パーティのシステム)との間の物理ハブとなります。ゲートウェイは、PeopleSoft Integration Brokerを通じてシステム間で渡されるメッセージの受信および配信を管理します。

増分リコンシリエーションのためのターゲット・システムを構成するには、次の手順を実行する必要があります。


注意:

管理者アカウントを使用して次の手順を実行する必要があります。

  1. メッセージ・チャネルの作成

  2. メッセージの作成

  3. メッセージの公開

  4. PeopleSoft Integration Brokerの構成

メッセージ・チャネルの作成

メッセージ・チャネルを作成する手順は、使用しているターゲット・システムのバージョンによって異なります。

PeopleSoft HRMS 8.3 SP1でのメッセージ・チャネルの作成

PeopleSoft HRMS 8.3 SP1でメッセージ・チャネルを作成するには、次のようにします。

  1. 「スタート」「プログラム」「Application Designer」の順にクリックします。Application Designerウィンドウが2層モードで表示されます。

  2. 「File」メニューから「New」を選択します。

  3. 「New Definition」ダイアログ・ボックスで、「Message Channel」を選択し、「OK」をクリックします。

  4. 新しいメッセージ・チャネルをPERSON_BASICとして保存します。

  5. 「File」メニューから「Definition Properties」を選択します。

  6. 「Message Channel Properties」ダイアログ・ボックスで、「Run」オプションを選択し、「Archive Messages」を選択します。

  7. 「OK」をクリックし、メッセージを保存します。

PeopleSoft HRMS 8.9でのメッセージ・チャネルの作成

PeopleSoft HRMS 8.9でメッセージ・チャネルを作成するには、次のようにします。

  1. 「スタート」「プログラム」「Application Designer」の順にクリックします。Application Designerウィンドウが2層モードで表示されます。

  2. 「File」メニューから「New」を選択します。

  3. 「New Definition」ダイアログ・ボックスで、「Message Channel」を選択し、「OK」をクリックします。

  4. 新しいメッセージ・チャネルをPERSON_BASICとして保存します。

  5. 「File」メニューから「Object Properties」を選択します。

  6. 「Message Channel Properties」ダイアログ・ボックスで「Use」タブを選択し、「Run」オプションを選択して、「Archive Messages」チェック・ボックスを選択します。

  7. 「OK」をクリックし、メッセージ・チャネルを保存します。

PeopleSoft HCM 9.0でのキューの作成

PeopleSoft HCM 9.0でキューを作成するには、次のようにします。

  1. PeopleSoft Internet Architectureウィンドウで、「People Tools」「Integration Broker」「Integration Setup」の順に開き、「Queue」をクリックします。

  2. 「Add a New Value」タブで、キュー名(たとえばPSFT_HR_QUEUEなど)を入力し、「Add」をクリックします。

  3. 「Queue Definition」タブで、「archive」チェック・ボックスを選択します。

  4. 「Queue Status」リストから「Run」を選択します。

  5. 「Save」をクリックして、変更を保存します。

メッセージの作成

メッセージを作成する手順は、使用しているターゲット・システムのバージョンによって異なります。

PeopleSoft HRMS 8.3 SP1でのメッセージの作成

PeopleSoft HRMS 8.3 SP1でメッセージを作成するには、次のようにします。

  1. 「スタート」「プログラム」「Application Designer」の順にクリックします。Application Designerウィンドウが表示されます。

  2. 「File」メニューから「New」を選択します。

  3. 「New Definition」ダイアログ・ボックスで、リストから「Message」を選択し、「OK」をクリックします。

  4. 「File」メニューから「Definition Properties」を選択します。

  5. 「Message Properties」ダイアログ・ボックスで、「Use」タブをクリックします。

  6. 「Use」タブで、PERSON_BASICメッセージ・チャネルと、作成したメッセージのバージョンを「Version」リストから選択します。これにより、メッセージと「PeopleSoft HRMS 8.3 SP1でのメッセージ・チャネルの作成」で作成したメッセージ・チャネルを関連付けます。

  7. 「Active」を選択してメッセージをアクティブ・メッセージにし、「OK」をクリックします。

  8. 「VERSION_1」を右クリックし、「Insert Child Record」オプションを選択します。

  9. Insert Recordウィンドウで、「Name」フィールドにPERSONAL_DATAを入力し、「Insert」をクリックしてから「Close」をクリックします。

  10. 「VERSION_1」の下の「PERSONAL_DATA」をクリックします。PERSONAL_DATAレコードを構成するすべてのフィールドが表示されます。

    デフォルトでは、すべてのフィールドが選択されています。生成するメッセージXMLファイルに必要でないフィールドは、チェック・ボックスの選択を解除してください。メッセージXMLファイル内のフィールドの詳細は、OIM_HOME/xellerate/XLIntegrations/PSFTHR/cbrecon/psft_xellerate_msg.xmlファイルを参照してください。

  11. PS_PERS_NIDレコード、EMPLOYMENTレコードおよびJOBレコードについて、ステップ810を繰り返します。

  12. メッセージをPSFT_XELLERATE_MSGとして保存します。

PeopleSoft HRMS 8.9でのメッセージの作成

PeopleSoft HRMS 8.9でメッセージを作成するには、次のようにします。

  1. 「スタート」「プログラム」「Application Designer」の順にクリックします。Application Designerウィンドウが表示されます。

  2. 「File」メニューから「New」を選択します。

  3. 「New Definition」ダイアログ・ボックスで、リストから「Message」を選択し、「OK」をクリックします。

  4. 「File」メニューから「Object Properties」を選択します。

  5. 「Message Properties」ダイアログ・ボックスで、「Use」タブをクリックします。

  6. 「Use」タブで、PERSON_BASICメッセージ・チャネルと、ステップ2で作成したメッセージのバージョンを選択します。これにより、メッセージと「PeopleSoft HRMS 8.9でのメッセージ・チャネルの作成」で作成したメッセージ・チャネルを関連付けます。

  7. 「Active」を選択してメッセージをアクティブ・メッセージにし、「OK」をクリックしてダイアログ・ボックスを閉じます。

  8. メッセージをPSFT_XELLERATE_MSGとして保存します。

    任意の名前でこのメッセージを保存することもできます。その場合、「PeopleSoft HRMS 8.9またはHCM 9.0でのメッセージの公開」に記載された手順を実行する際にHRMSCBRecon.txtファイルからコピーするコードに同様の変更を行う必要があります。

PeopleSoft HCM 9.0でのメッセージの作成

PeopleSoft HCM 9.0でメッセージを作成するには、次のようにします。

  1. PeopleSoft Internet Architectureウィンドウで、「People Tools」「Integration Broker」「Integration Setup」の順に開き、「Message」をクリックします。

  2. 「Add a New Value」タブで、メッセージ名(たとえばPSFT_XELLERATE_MSGなど)を入力します。また、「Version」フィールドにバージョンを入力します。このフィールドの有効な値は、version_1またはv1です。

  3. 「Add」をクリックします。

  4. 「Message Definition」タブで、「Nonrowset-based」をメッセージ・タイプとして選択します。

  5. 「Save」をクリックして、変更を保存します。

メッセージの公開

メッセージを公開する手順は、使用しているターゲット・システムのバージョンによって異なります。

PeopleSoft HRMS 8.3 SP1でのメッセージの公開

PeopleSoft HRMS 8.3 SP1でメッセージを公開するには、次のようにします。

  1. 「スタート」「プログラム」「Peoplesoft8.x」「Application Designer」の順にクリックします。Application Designerウィンドウが2層モードで表示されます。


    注意:

    Application Designerを2層モードで実行するには、データベース・クライアント(PeopleSoftで使用されているデータベースのクライアント)がサーバーにインストールされている必要があります。さらに、PeopleSoft Application Designer Signonウィンドウでサインオン情報を入力するときに、「Connection Type」フィールドから適切なデータベース・タイプ(たとえば、「Oracle Database」など)を選択する必要があります。

  2. 「File」メニューから「Open」を選択します。「Open Definition」ダイアログ・ボックスが表示されます。

  3. 「Definition」リストから「Component」を選択し、「Name Selection Criteria」フィールドにPERSONAL_DATAを入力して、「Enter」をクリックします。テキストPERSONAL_DATAで始まるすべてのコンポーネント名が表示されます。

  4. リストから「PERSONAL_DATA」を選択し、「Open」をクリックします。PERSONAL_DATAコンポーネントの詳細が表示されます。

  5. 「Structure」タブをクリックし、「PERSONAL_DATA」を右クリックして「View PeopleCode」を選択します。PERSONAL_DATAコンポーネントのPeopleCodeが表示されます。

  6. ウィンドウ右上隅のリストからSavePostChangeイベントを選択します。このイベントのPeopleCodeが表示されます。

  7. 次のファイル内のコードを、SavePostChangeイベントのPeopleCode内のインポート定義の直後にコピーします。

    PeopleTools 8.22の場合:

    OIM_HOME/xellerate/Scripts/HRMSCBRecon.txt
    

    PeopleTools 8.45〜8.47の場合:

    OIM_HOME/xellerate/Scripts/HRMSCBRecon_8.45-8.47.txt
    

    PeopleTools 8.48の場合:

    OIM_HOME/xellerate/Scripts/HRMSCBRecon-8.48.txt
    

    注意:

    「PeopleSoft HRMS 8.3 SP1でのメッセージの作成」の手順を実行してメッセージを作成する際に、メッセージの名前をPSFT_XELLERATE_MSG以外の名前に変更する場合は、コピーしたコードで同じ名前を使用する必要があります。

    BIRTHDATEおよびHIREDATEの値をフェッチするコードの記述は、Oracleデータベースに固有のものです。使用するデータベースに基づいてこのコードを変更する必要があります。次に例を示します。

    Microsoft SQL ServerでPeoplesoftを実行する場合:

    • TO_CHAR(BIRTHDATE, 'ddmmyy')convert(varchar, BIRTHDATE, 104)で置き換えます。

    • TO_CHAR(HIRE_DT, 'ddmmyy')convert(varchar, HIRE_DT, 104)で置き換えます。

    SybaseでPeoplesoftを実行する場合:

    • TO_CHAR(BIRTHDATE, 'ddmmyy')convert (char(6), BIRTHDATE, 12)で置き換えます。

    • TO_CHAR(HIRE_DT, 'ddmmyy')convert (char(6), HIRE_DT, 12)で置き換えます。

    InformixでPeoplesoftを実行する場合:

    • TO_CHAR(BIRTHDATE, 'ddmmyy')TO_CHAR (BIRTHDATE, " | """%d %m %y""" | ")で置き換えます。

    • TO_CHAR(HIRE_DT, 'ddmmyy')TO_CHAR(HIRE_DT, " | """%d %m %y""" | ")で置き換えます。

  8. 「File」メニューから「Save」を選択して、PERSONAL_DATAコンポーネントへの変更を保存します。

    次のコンポーネントでメッセージを公開する場合は、ステップ2〜8を繰り返す必要があります。

    • JOB_DATA

    • JOB_DATA_HIRE

PeopleSoft HRMS 8.9またはHCM 9.0でのメッセージの公開

PeopleSoft HRMS 8.9またはHCM 9.0でメッセージを公開するには、次のようにします。

  1. 「スタート」「プログラム」「Peoplesoft8.x」「Application Designer」の順にクリックします。Application Designerウィンドウが2層モードで表示されます。


    注意:

    Application Designerを2層モードで実行するには、データベース・クライアント(PeopleSoftで使用されているデータベースのクライアント)がサーバーにインストールされている必要があります。さらに、PeopleSoft Application Designer Signonウィンドウでサインオン情報を入力するときに、「Connection Type」フィールドから適切なデータベース・タイプ(たとえば、「Oracle Database」など)を選択する必要があります。

  2. 「File」メニューから「Open」を選択します。「Open Definition」ダイアログ・ボックスが表示されます。

  3. 「Definition」リストから「Component」を選択し、「Name Selection Criteria」フィールドにPERSONAL_DATAを入力して、「Enter」を押します。テキストPERSONAL_DATAで始まるすべてのコンポーネント名が表示されます。

  4. リストから「PERSONAL_DATA」を選択し、「Open」をクリックします。PERSONAL_DATAコンポーネントの詳細が表示されます。

  5. 「Structure」タブをクリックし、「PERSONAL_DATA」を右クリックして「View PeopleCode」を選択します。PERSONAL_DATAコンポーネントのPeopleCodeが表示されます。

  6. ウィンドウ左上隅のリストからSavePostChangeイベントを選択します。このイベントのPeopleCodeが表示されます。

  7. 次のファイル内のコードを、SavePostChangeイベントのPeopleCode内のインポート定義の直後にコピーします。

    OIM_HOME/xellerate/Scripts/HRMSCBRecon.txt
    

    注意:

    「PeopleSoft HRMS 8.9でのメッセージの作成」の手順を実行してメッセージを作成する際に、メッセージの名前をPSFT_XELLERATE_MSG以外の名前に変更する場合は、コピーしたコードで同じ名前を使用する必要があります。

    BIRTHDATEおよびHIREDATEの値をフェッチするコードの記述は、Oracleデータベースに固有のものです。使用するデータベースに基づいてこのコードを変更する必要があります。次に例を示します。

    Microsoft SQL ServerでPeoplesoftを実行する場合:

    • TO_CHAR(BIRTHDATE, 'ddmmyy')convert(varchar, BIRTHDATE, 104)で置き換えます。

    • TO_CHAR(HIRE_DT, 'ddmmyy')convert(varchar, HIRE_DT, 104)で置き換えます。

    SybaseでPeoplesoftを実行する場合:

    • TO_CHAR(BIRTHDATE, 'ddmmyy')convert (char(6), BIRTHDATE, 12)で置き換えます。

    • TO_CHAR(HIRE_DT, 'ddmmyy')convert (char(6), HIRE_DT, 12)で置き換えます。

    InformixでPeoplesoftを実行する場合:

    • TO_CHAR(BIRTHDATE, 'ddmmyy')TO_CHAR (BIRTHDATE, " | """%d %m %y""" | ")で置き換えます。

    • TO_CHAR(HIRE_DT, 'ddmmyy')TO_CHAR(HIRE_DT, " | """%d %m %y""" | ")で置き換えます。

  8. 「File」メニューから「Save」を選択して、PERSONAL_DATAコンポーネントへの変更を保存します。

  9. 次のファンクション・コール・コードを、SavePostChangeイベントのPeopleCodeの最後に追加します。


    注意:

    このステップは、コードをコピーしてから実行してください。

    /**********************************************************************/
    /*  Calling the Generate function to generate the
    PSFT_XELLERATE_MSG message*/
    /**********************************************************************/
    Local string &emplid;
    &emplid = PERSON.EMPLID;
    GENERATE(&emplid);
    
  10. 「File」メニューから「Save」を選択して、ステップ5で行ったコンポーネントへの変更を保存します。

    次のコンポーネントでメッセージを公開する場合は、ステップ2〜10を繰り返す必要があります。

    • JOB_DATA

    • JOB_DATA_EMP

PeopleSoft Integration Brokerの構成

PeopleSoft Integration Brokerを構成する手順は、使用しているPeopleToolsのリリースによって異なります。


注意:

PeopleSoft Integration Brokerを構成する際、PeopleSoft Internet Architectureで実行する手順と、Application Designerで実行する手順があります。たとえば、PeopleTools 8.22およびPeopleTools 8.45〜8.47の場合は、一部の構成手順をPeopleSoft Internet Architectureで実行し、一部をApplication Designerで実行する必要があります。PeopleTools 8.48の場合は、すべての構成手順をPeopleSoft Internet Architectureで実行する必要があります。

次の項では、PeopleTools 8.22でPeopleSoft Integration Brokerを構成する手順を説明します。

次の各項では、PeopleTools 8.45〜8.47およびPeopleTools 8.48でPeopleSoft Integration Brokerを構成する手順を説明します。

PeopleTools 8.22でのPeopleSoft Integration Brokerの構成

PeopleTools 8.22でPeopleSoft Integration Brokerを構成するには、次のようにします。


注意:

PeopleSoft Integration Brokerゲートウェイの構成は、PeopleTools 8.22でPeopleSoft Integration Brokerを構成する手順の一部です。

  1. XL_NODEリモート・ノードを作成するには、次のようにします。

    1. Application Designerで、「File」メニューから「New」を選択します。

    2. 「New Definition」ダイアログ・ボックスで、リストから「Message Node」を選択し、「OK」をクリックします。

    3. 空白の部分を右クリックし、「Insert Location」を選択します。「Location」ダイアログ・ボックスが表示されます。

    4. PeopleSoft Integration BrokerゲートウェイのURLを次の書式で入力します。

      http://hostname:port/servlets/gateway
      

      このURLでは、hostnameはPeopleSoftをホストするアプリケーション・サーバーであり、portはアプリケーション・サーバーがリスニングしているポート番号です。

    5. 「File」メニューから「Object Properties」を選択します。

    6. 「Message Node Properties」ダイアログ・ボックスで、「Use」タブを選択します。「Local Node」が選択されていないことを確認してください。

    7. リモート・ノードをXL_NODEとして保存します。

  2. PERSON_BASICメッセージ・チャネルを構成するには、次のようにします。

    1. 「File」メニューから「Open」を選択し、「Message Channel」をクリックします。

    2. PERSON_BASICメッセージ・チャネルを開くには、「PERSON_BASIC」を選択します。

    3. 「Routing Rules」タブをクリックします。

    4. 空白の部分を右クリックし、「Insert Message Node」を選択します。

    5. 「Insert Message Node」ダイアログ・ボックスで、「XL_NODE」メッセージ・ノードを選択し、「Insert」をクリックします。

    6. ダイアログ・ボックスを閉じます。

    7. 「Routing Rules」タブに表示されたメッセージ・ノードを右クリックします。

    8. 「Routing Direction」をポイントし、「Publish To」を選択します。

    9. メッセージ・チャネルを保存します。

  3. メッセージがPeopleSoft Integration Brokerゲートウェイ経由でOracle Identity Managerに送信されるようにPeopleSoft Integration Brokerゲートウェイを構成するには、次のようにします。


    注意:

    この手順で示されるSimple File Handlerは、PeopleTools 8.22のユーティリティであり、PeopleSoftノードによって公開されたメッセージを受け取り、サード・パーティのシステムで使用可能なファイルにこれらのメッセージを書き込むことができます。

    1. Webブラウザで、次の書式のURLを使用して、「Handler Directory」ページ(PeopleSoft Integration Brokerゲートウェイの構成ウィンドウ)を開きます。

      http://hostname:port/servlets/gateway.administration
      

      次に例を示します。

      http://10.121.16.42:8080/peopleSoftApp/do/peopleSoftAction
      

      このURLでは、hostnameはPeopleSoftをホストするアプリケーション・サーバーであり、portはアプリケーション・サーバーがリスニングしているポート番号です。

    2. 「Add Handler」をクリックします。

    3. 「Add Handler」ページで、Simple File Handlerクラスの完全名psft.pt8.filehandler.SimpleFileHandlerを入力します。

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

    5. ハンドラをロードするには、「Handler Directory」ページで、「Load」をクリックします。

      ハンドラのロード後、「Status」列に「Loaded successfully」というメッセージが表示されます。

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

    7. 「Add a file handler node」をクリックします。

    8. 「Add File Handler Node」ページの「Node Name」フィールドに、作成したメッセージ・ノードの名前としてXL_NODEを入力します。

    9. 公開されたメッセージを格納する出力ディレクトリを指定します。

    10. 「Include Header」を選択します。

    11. 「Save」をクリックします。

  4. PeopleTools 8.22 Simple File HandlerによってXMLメッセージが生成されます。これらのメッセージをPeopleSoftコネクタに公開するには、次の手順を実行してMicrosoft Windowsスケジュール済タスクを作成します。スケジュール済タスクは、PeopleSoft Webサーバーを実行しているコンピュータ上に作成する必要があります。


    注意:

    Microsoft Windowsスケジュール済タスクは、Oracle Identity Managerサーバー上にデプロイされているサーブレットと通信するJavaプログラムを呼び出します。サーブレットはメッセージを解析し、リコンシリエーション・イベントをOracle Identity Managerに送信します。

    サーブレットは、リコンシリエーション・イベントのステータスに基づいてリターン・コードを送信します。リコンシリエーション・イベントが正常に送信された場合、メッセージ・ファイルは削除またはアーカイブされます。そうでない場合、メッセージ・ファイルは変更されない状態で残ります。次回にスケジュール済タスクが実行されるときに、メッセージの送信が再び試行されます。


    1. xliMsgPublisher.jarファイルおよびpublish.batファイルを、OIM_HOME/xellerate/lib/MsgPublisherディレクトリからターゲット・システム・サーバー上のディレクトリにコピーします。

    2. テキスト・エディタを使用してpublish.batファイルを開き、ファイルを次のように変更します。

      i. JAVA_HOME変数の値を、PeopleSoft Webサーバーを実行しているコンピュータ上のJDKインストール・ディレクトリを指し示すように変更します。

      ii.ファイルの最後にあるJavaコマンド内に次の値を指定します。

      - PeopleSoft_listener_servlet_URL: これは、PeopleSoft Application Mappingを使用して生成されるリコンシリエーション・イベントをリスニングするサーブレットのURLです。

      - Output_directory_for_XML_messages: これは、公開したメッセージを格納するPeopleSoft Webサーバー・ディレクトリです。出力ディレクトリは、この手順のステップ3.iで指定済です。

      - XML_message_name: これは、ターゲットを構成する際に作成されるメッセージ名です。詳細は、「メッセージの作成」を参照してください。

      - console_log_file_path: 生成されるログ・ファイルのディレクトリのフルパスおよび名前です。

      コマンドの書式は次のとおりです。

      java com.thortech.xl.Integration.msgpublisher.PeopleSoftPublisher "
      PeopleSoft_listener_servlet_URL" 
      "Output_directory_for_XML_messages" 
      XML_message_name >> 
      console_log_file_path
      

      次に例を示します。

      java Com.thortech.xl.Integration.msgpublisher.PeopleSoftPublisher
      "http://host:
      port/peopleSoftApp/do/peopleSoftAction" 
      "C:/test/file" PSFT_XELLERATE_MSG >> c:/test/consolelog.log
      

      この例に指定されるPeopleSoftリスナー・サーブレットURLで、hostnameはOracle Identity Managerが実行されているIPアドレスまたはアプリケーション・サーバーのホスト名で、portはアプリケーション・サーバーが着信メッセージをリスニングするHTTPポートです。

    3. バッチ・ファイルを保存して閉じます。

    4. PeopleSoft Webサーバーを実行しているコンピュータで、「スタート」「設定」「コントロール パネル」の順にクリックします。

    5. 「タスク」をダブルクリックします。

    6. 「スケジュールされたタスクの追加」をクリックし、「次へ」をクリックします。

    7. 「参照」をクリックし、publish.batファイルを保存先のディレクトリから選択します。

    8. 「日単位」を選択して「次へ」をクリックし、再び「次へ」をクリックします。

    9. スケジュール済タスクを実行するためのユーザーIDおよびパスワードを入力します。

    10. 「[完了]をクリックしたときに詳細プロパティを開く」を選択します。

    11. 「完了」をクリックします。

    12. 「スケジュール」タブで、「詳細設定」をクリックします。

    13. 「タスクを繰り返し実行」を選択します。

    14. タスクを実行する頻度を選択します。

    15. 「OK」をクリックし、再び「OK」をクリックしてウィンドウを閉じます。

PeopleTools 8.45〜8.48でのPeopleSoft Integration Brokerゲートウェイの構成

PeopleTools 8.45〜8.48でPeopleSoft Integration Brokerゲートウェイを構成するには、次のようにします。

  1. Webブラウザを開き、PeopleSoft Internet ArchitectureのURLを入力します。PeopleSoft Internet ArchitectureのURLの書式は次のとおりです。

    http://servername/psp/ps/Databasename/?cmd=login
    

    次に例を示します。

    http://psftserver.acme.com/psp/ps/TestDB/?cmd=login
    
  2. 「PeopleTools」「Integration Broker」「Configuration」「Gateways」の順に開きます。ゲートウェイ・コンポーネントの詳細が表示されます。

  3. 「Integration Gateway ID」フィールドにLOCALを入力し、「Search」をクリックします。LOCALゲートウェイは、PIAをインストールすると作成されるデフォルトのゲートウェイです。

  4. PeopleSoftリスニング・コネクタのURLに指定されたIPアドレスが、ターゲット・システムがインストールされているコンピュータのIPアドレスであることを確認します。PeopleSoftリスニング・コネクタのURLの書式は次のとおりです。

    http://computer_name_of_the_PeopleSoft_Web_server/IP address:port/PSIGW/PeopleSoftListeningConnector
    

    次に例を示します。

    http://10.121.16.42:80/PSIGW/PeopleSoftListeningConnector
    
  5. LOCALゲートウェイに登録されているすべてのターゲット・コネクタをロードするには、「Load Gateway Connectors」をクリックします。

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

  7. 「Ping Gateway」をクリックして、ゲートウェイ・コンポーネントが有効か確認します。

PeopleTools 8.45〜8.47でのPeopleSoft Integration Brokerの構成

PeopleTools 8.45〜8.47でPeopleSoft Integration Brokerを構成するには、次のようにします。

リモート・ノードとして機能するXL_NODEノードを作成するには、次のようにします。

  1. PIAウィンドウで、「PeopleTools」「Integration Broker」「Integration Setup」の順に開き、「Node Definitions」をクリックします。

  2. 「Add a New Value」タブをクリックします。

  3. 「Add a New Value」タブで、ノード名としてXL_NODEを入力し、「Add」をクリックします。

  4. 「Node Definition」タブで、「Description」フィールドにノードの説明を入力します。

  5. 「Local Node」チェック・ボックスの選択を解除し、「Active Node」チェック・ボックスを選択することによって、このノードをリモート・ノードにします。

  6. 「Connectors」タブで、次の情報を入力して検索を実行します。

    Gateway ID: LOCAL

    Connector ID: HTTPTARGET

  7. 「Connectors」タブの「Properties」サブページで、次の情報を入力します。

    Property ID: HTTPTARGET

    Property Name: URL

    Required value: XMLメッセージを受け取るPeopleSoftサーブレットのURLを入力します。このURLは、次の書式で入力してください。

    http://computer name of the Oracle Identity Manager server/IP address:port/peopleSoftApp/do/peopleSoftAction
    

    次に例を示します。

    http://10.121.16.42:8080/peopleSoftApp/do/peopleSoftAction
    
  8. 「Ping Node」ボタンをクリックして、指定したIPアドレスとの接続が確立されていることを確認します。

  9. 「Transactions」タブで、「Add Transaction」をクリックします。「Add Transaction」ダイアログ・ボックスが表示されます。

  10. 次の詳細を入力して、新しいトランザクションを定義します。

    Transaction Type: Outbound Asynchronous

    Request Message: PSFT_XELLERATE_MSG

    Request Message Version: VERSION_1

  11. 「Add」をクリックします。

  12. ステータスを常にアクティブにするには、「Active」を選択します。

  13. 「Save」をクリックして、変更を保存します。

PERSON_BASICメッセージ・チャネルをセキュアにするには、次のようにします。

  1. PIAで、「PeopleTools」「Security」「Permission & Roles」「Permission Lists」の順に開きます。

  2. 「AEAE1000」を選択します。「AEAE1000」権限リストが表示されます。

  3. 「Message Monitor」タブを選択し、プラス記号(+)ボタンをクリックしてチャネル名を追加します。

  4. チャネル名として「PERSON_BASIC」を指定し、アクセス・レベルとして「FULL」を選択します。

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

PERSON_BASICメッセージ・チャネルが実行モードになっていることを確認するには、次のようにします。

  1. 「PeopleTools」「Integration Broker」「Monitor Integration」「Monitor Message」の順に開きます。

  2. 「Channel Status」タブをクリックします。

  3. PERSON_BASICメッセージ・チャネルが実行されていることを確認します。停止している場合は、「Run」をクリックします。

PeopleTools 8.48でのPeopleSoft Integration Brokerの構成

PeopleTools 8.48でPeopleSoft Integration Brokerを構成するには、次のようにします。

  1. 次のステップを実行してリモート・ノードを作成します。

    1. PeopleSoft Internet Architectureで、「PeopleTools」「Integration Broker」「Integration Setup」の順に開き、「Nodes」をクリックします。

    2. 「Add a New Value」タブで、ノード名(たとえばHT_NODEなど)を入力し、「Add」をクリックします。

    3. 「Node Definition」タブで、「Description」フィールドにノードの説明を入力します。さらに、「Default User ID」フィールドにPSと入力します。

    4. 「Local Node」チェック・ボックスの選択を解除し、「Active Node」チェック・ボックスを選択することによって、このノードをリモート・ノードにします。

    5. 「Connectors」タブで、次の情報を入力します。

      Gateway ID: LOCAL

      Connector ID: HTTPTARGET

    6. 「Ping Node」ボタンをクリックして、指定したIPアドレスとの接続が確立されていることを確認します。

    7. 「Connectors」タブの「Properties」サブページで、次の情報を入力します。

      Property ID: PRIMARYURL

      Property Name: URL

      Required value: XMLメッセージを受け取るPeopleSoftサーブレットのURLを入力します。このURLは、次の書式で入力してください。

      http://computer name of the Oracle Identity Manager server/IP address:port/peopleSoftApp/do/peopleSoftAction
      

      次に例を示します。

      http://10.121.16.42:8080/peopleSoftApp/do/peopleSoftAction
      
    8. 「Save」をクリックして、変更を保存します。

  2. 次のステップを実行してサービスを作成します。

    1. PeopleSoft Internet Architectureで、「PeopleTools」「Integration Broker」「Integration Setup」の順に開き、「Service」をクリックします。

    2. 「Add a New Value」タブで、サービス名(たとえばPSFT_HR_SERVICEなど)を入力し、「Add」をクリックします。

    3. 「Service Definition」タブで、「Description」フィールドにサービスの説明を入力します。

    4. 「Save」をクリックして、変更を保存します。

  3. 次のステップを実行してサービス操作を作成します。

    1. PeopleSoft Internet Architectureウィンドウで、「PeopleTools」「Integration Broker」「Integration Setup」の順に開き、「Service Operation」をクリックします。

    2. 「Add a New Value」タブで、作成しているサービス操作のサービス名を入力します。さらに、サービス操作名を入力します。サービス操作名は、「PeopleSoft HCM 9.0でのメッセージの作成」のステップ2で作成したサービス名(たとえば、PSFT_HR_SERVICE)と同じである必要があります。

    3. 「Operation Type」リストから「Asynchronous-Oneway」を選択し、「Add」をクリックします。

    4. 「Service Operation Definition」ページの「General」タブで、「Operation Description」フィールドに操作タイプの説明を入力します。さらに、「Message.Version」フィールドにPSFT_XELLERATE_MSG.V1「Queue Name」フィールドにPSFT_HR_QUEUEと入力します。

    5. 「Save」をクリックして、変更を保存します。

    6. 「Routing」タブで、ルーティング名としてPSFT_HR_ROUTINGと入力し、「Add」をクリックします。

    7. 「Routing Definition」タブで、「Sender Node」フィールドにPSFT_HR「Receiver Node」フィールドにPSFT_HR_NODEと入力します。

    8. 「Save」をクリックして、変更を保存します。

      ターゲット・システムからOracle Identity ManagerへのXMLメッセージの送信を開始する前に、PeopleSoftノードが実行中であることを確認する必要があります。これを確認するには、「Connectors」タブで「Ping Node」ボタンをクリックします。「Connectors」タブにアクセスするには、「PeopleTools」「Integration Broker」「Nodes」の順にクリックします。

      メッセージの公開時にOracle Identity Managerサーバーが実行中でない場合、キューにメッセージが追加されます。「Message Instance」タブで、キュー内のメッセージのステータスを確認できます。このタブには、キュー内のすべての公開メッセージが表示されます。特定のメッセージの詳細を確認すると、ステータスがTimeoutまたはErrorとして表示されます。

      Oracle Identity Managerにキュー内のメッセージを公開するには、Oracle Identity Managerが実行中であるときにメッセージを再送信します。詳細は、「メッセージの公開」を参照してください。

      メッセージのステータスがNewまたはStartedであり、TimeoutまたはDoneに変更されない場合は、Oracle Identity Managerサーバーを再起動した後にPeopleSoftアプリケーション・サーバーを再起動する必要があります。

Oracle Identity Managerの構成

このコネクタのOracle Identity Managerの構成では、リコンシリエーションの構成のみを行います。このガイドで前述したように、リコンシリエーションとは、ターゲット・システムからの新規および変更されたユーザー・アカウント情報を、Oracle Identity Manager内で複製することです。

この項では、次のトピックについて説明します。

完全リコンシリエーションの構成

この項では、次のトピックについて説明します。

リコンシリエーションのスケジュール済タスクの構成

「手順4: コネクタのXMLファイルのインポート」で説明する手順を実行すると、スケジュール済タスクがOracle Identity Managerで自動的に作成されます。完全リコンシリエーションを実行するには、ユーザーが指定したスケジュール済タスクの属性の値に応じてOracle Identity Manager内でユーザーがリコンサイルされるようにスケジュール済タスクを構成する必要があります。


注意:

次の間隔を指定して、将来の任意の日付または時間に完全リコンシリエーションを実行できます。
  • Daily

  • Weekly

  • Monthly

  • Yearly

  • Recurring intervals

または、指定した日時に1回実行するようにスケジュール済タスクの属性を構成できます。


スケジュール済タスクの属性の値を指定するには、次の手順を実行します。

  1. Oracle Identity Manager Design Consoleを開きます。

  2. 「Administration」フォルダを開きます。

  3. 「Task Scheduler」を選択します。

  4. 「Find」をクリックし、「Task Scheduler」表にあるPSFTHRTrustedUserReconというスケジュール済タスクを探します。

  5. 「Max Retries」フィールドに数値を入力します。この数値は、Oracle Identity Managerがタスクの完了を試行する回数です。この数値を超えると、FAILEDステータスがタスクに割り当てられます。

  6. 「Disabled」チェック・ボックスと「Stop Execution」チェック・ボックスが選択されていないことを確認します。

  7. 「Start」リージョンで「Start Time」フィールドをダブルクリックし、タスクを実行する日付と時間を選択します。

  8. タスクを1回のみ実行するように設定するには、「Interval」リージョンで「Once」オプションを選択します。

  9. スケジュール済タスクの属性の値を指定します。指定する値の詳細は、「スケジュール済タスク属性の値の指定」を参照してください。

  10. 「Save」をクリックします。スケジュール済タスクが構成されます。現在はタスクが実行されていないため、「Status」フィールドにINACTIVEステータスが表示されます。タスクは、ステップ7で指定した日時にのみ実行されます。

スケジュール済タスクを構成した後、「増分リコンシリエーションの構成」に進みます。

スケジュール済タスク属性の値の指定

ユーザー・リコンシリエーション用のスケジュール済タスクは、2つのスケジュール済タスクとして定義されています。1つは信頼できる従業員リコンシリエーション、他の1つはターゲット・リソースの従業員リコンシリエーションのスケジュール済タスクです。ただし、ターゲット・システムには信頼できる従業員リコンシリエーション用のスケジュール済タスクのみを使用する必要があります。

PSFTHRTrustedUserRecon従業員リコンシリエーションのスケジュール済タスクの属性に値を指定する必要があります。スケジュール済タスクの属性の説明を次の表に示します。


注意:

  • デフォルトの属性値は、インポートしたコネクタのXMLファイルで事前定義されています。変更する属性にのみ値を指定してください。

  • すべての属性に値(デフォルトまたはデフォルト以外)を割り当てる(またはデフォルトで指定されている)必要があります。属性値を1つでも空白のままにした場合、リコンシリエーションは実行されません。

  • ターゲット・リソースのリコンシリエーションを実行するスケジュール済タスクPSFTHRNonTrustedUserReconには変更を加えないでください。このスケジュール済タスクは、このコネクタでは使用されません。


属性名 説明 サンプル値
FolderPath ターゲット・システムによって生成される従業員リコンシリエーション・ファイルが格納されるOracle Identity Managerサーバー上のディレクトリ・パス。

注意: フォルダ・パスには、アプリケーション・エンジンを実行したときに生成されるテキスト・ファイルのみを含める必要があります。Task Schedulerはテキスト・ファイルを検索します。したがって、指定するパスには、Task Schedulerが読み取るファイルのみを含める必要があります。フォルダ・パスの値は末尾に\が必要です。

C:\PSFTHR\UserRecon\
TargetSystem リソース・オブジェクトの名前。 PSFT_HR_RO
IsTrusted 信頼できるモードでリコンシリエーションを実行するかどうかを指定します。このコネクタでは、信頼できるソースのリコンシリエーションのみが構成されます。したがって、この属性値は常にYesに設定する必要があります。 Yes
XellerateOrganization Oracle Identity Managerの組織のデフォルト名。

この値は、信頼できるソースのリコンシリエーション・モードでXellerateユーザーを作成するために使用されます。Oracle Identity Managerに存在する値を指定する必要があります。

注意: この属性は、信頼できるソースのリコンシリエーションのスケジュール済タスクに固有のものです。

Xellerate Users
NoOfRecordsToBeReconciled リコンサイル対象となるレコードの数を指定します。

0より大きい任意の整数値を入力する必要があります。この属性の詳細は、「リコンサイルされるレコード数の指定」を参照してください。

デフォルト値: all

0より大きい任意の整数値
Lastname リコンシリエーション対象かどうかの基準となるLastname属性値を指定します。

リコンシリエーション時に、指定したLastname値を含むターゲット・システム・レコードのみがリコンサイルされます。このリコンシリエーションの実行方法の詳細は、「制限付きのリコンシリエーション」を参照してください。

Nodata
Postal リコンシリエーション対象かどうかの基準となるPostal属性値を指定します。

リコンシリエーション時には、ここで指定したPostal値を含むターゲット・システム・レコードのみがリコンサイルされます。

Nodata
DeptId リコンシリエーションを実行するDeptId属性値を指定します。

リコンシリエーション時に、指定したDeptId値を含むターゲット・システム・レコードのみがリコンサイルされます。

Nodata
Operator nodata以外の値を指定するターゲット・システム属性に適用する演算子を指定します。

演算子の値はANDまたはORです。この値に基づいて、Lastnameフィールド、Postalフィールド、DeptIdフィールドの任意の組合せのデータが結合されます。

リコンシリエーション時に、指定したフィールド(LastnamePostalおよびDeptId)の組合せを含むターゲット・システム・レコードのみがリコンサイルされます。

AND
ServerName PeopleSoftアプリケーションのターゲット・システムに定義されたITリソースの名前。 PSFT_Employee

これらのタスク属性の値を指定したら、ステップ10に進んでスケジュール済タスクを作成してください。

リコンサイルされるレコード数の指定

リコンシリエーションの実行中には、ターゲット・システム・レコードのすべての変更内容がOracle Identity Managerにリコンサイルされます。リコンサイルされるレコード数によっては、このプロセスに長い時間がかかる場合があります。また、リコンシリエーション中に接続が中断すると、プロセスの完了にはさらに時間がかかります。

リコンサイルされるレコード数を指定すると、リコンシリエーション時間を短縮できます。これには、スケジュール済タスクのNoOfRecordsToBeReconciled属性の値を指定します。

NoOfRecordsToBeReconciled属性に値を指定する場合は、「スケジュール済タスク属性の値の指定」に記載されている説明に従ってください。

IndexOfLastReconciledRecordパラメータの構成

完全リコンシリエーションを実行する場合は、ITリソース・パラメータIndexOfLastReconciledRecordの値を指定します。初めて完全リコンシリエーションの実行を開始するとき、このパラメータの値は-1です。その後の各完全リコンシリエーションの実行の終了時に、このパラメータは、前回のリコンシリエーションの実行中にリコンサイルされた最後のレコードの索引番号を保存します。

完全リコンシリエーションを実行する場合は、IndexOfLastReconciledRecordパラメータの値を-1に変更します。このパラメータの値を変更するには、次の手順を実行します。

  1. Oracle Identity Manager Design Consoleにログインします。

  2. 「Resource Management」を開きます。

  3. 「IT Resources」をダブルクリックします。

  4. PSFT_Employee ITリソースを探します。

  5. IndexOfLastReconciledRecordパラメータの値を-1に変更します。

完全リコンシリエーションのカスタム属性の追加

完全リコンシリエーションのカスタム属性を追加するには、次のようにします。


注意:

この項で説明する手順は、PeopleToolsのすべての認定バージョンで同じです。完全リコンシリエーションのカスタム属性を追加しない場合は、この項を省略してかまいません。

  1. PeopleSoft Application Designerで、次のようにします。


    注意:

    PeopleTools 8.22を使用する場合、ステップ1は必須です。

    1. 「File」メニューから「Open」を選択します。「Open Definition」ダイアログ・ボックスが表示されます。

    2. 「Definition」リストから「Message」を選択し、「Name Selection Criteria」フィールドにPSFT_XELLERATE_MSGを入力して、「Enter」をクリックします。PSFT_XELLERATE_MSGメッセージの詳細が表示されます。

    3. カスタム属性を追加する先のレコードをクリックします。

      たとえば、JOBレコードの給与属性SALARYを追加する場合は、「VERSION_1」の下の「JOB」をクリックします。

    4. 必要な属性のチェック・ボックスを選択し、メッセージを保存します。

      たとえば、「SALARY」フィールドを選択します。

  2. Application Engineコード(BLKPRCS_HR)に記述されたヘッダーと問合せに変更を加えます。たとえば、SALARYという名前の新しい列をリコンサイルする場合は、Application Engineコードを次のように変更する必要があります。

    Local string &empid, &lastnm, &firstnm, &sex, &postal, &city, &ssn, &ph, &birthdt, 
    &country, &add1, &state, &hir_dt, &deptid, &jobcd, &salary;
    
    &hdr = "EMPLID,LASTNAME,FIRSTNAME,SEX,POSTAL,CITY,SSN,PHONE,BIRTHDATE,COUNTRY,
    ADDRESS,STATE,HIRE_DATE,DEPTID,JOBCODE,SALARY";
    

    SALARY列がps_job表に存在する場合、SQL文は次のようになります。

    SQLExec("select DEPTID, JOBCODE, SALARY from ps_job a where emplid =:1 
    and effdt=(select max(effdt) from ps_job b where a.emplid=b.emplid 
    and effseq =(select max(effseq) from ps_job c where b.emplid = c.emplid and b.effdt=c.effdt))",
    &empid, &deptid, &jobcd, &salary);
    
  3. Oracle Identity Manager Design Consoleの「Development Tools」フォルダ内にあるプロセス・フォームを開きます。


    関連項目:

    このステップおよびこの手順の残りのステップの詳細は、『Oracle Identity Managerデザイン・コンソール・ガイド』を参照してください。

  4. 「Create New Version」をクリックします。

  5. 「Create New Version」ダイアログ・ボックスの「Label」フィールドに、バージョン名を指定します。変更内容を保存し、ダイアログ・ボックスを閉じます。

  6. 「Current Version」リストから、新しく作成したバージョンを選択します。

  7. 「Additional Columns」タブで、「Add」をクリックします。「User Defined Process」フォーム内の新しい属性UD_PSFT_HRに対応する列を追加します。前述の例では、UD_PSFT_HR_SALARYという列を追加できます。

  8. リソース・オブジェクトの新しい属性PSFT_HR_ROに対応するリコンシリエーション・フィールドを追加します。前述の例では、Users.SALARYというリコンシリエーション・フィールドを追加できます。

  9. PSFT_HRプロセス定義を変更して、新しく追加した属性と対応するリコンシリエーション・フィールドとの間のマッピングを追加します。前述の例では、マッピングは次のようになります。

    Users.SALARY=UD_PSFT_SALARY
    

    この例では、SALARYがリコンシリエーション・フィールドであり、対応するターゲット・システム属性でもあります。標準として、すべてのリコンシリエーション・フィールド名の前に接頭辞Users.が付けられます。

  10. OIM_HOME/xellerate/XLIntegrations/PSFTHR/configディレクトリにあるattributemapping_recon.propertiesファイルを変更します。

    このファイルに新しい属性を追加することもできます。使用する必要のある書式は次のとおりです。

    TargetAttribute=Users.OimAttributeName
    

    注意:

    指定するTargetAttribute値に空白が含まれていないことを確認する必要があります。

    次に例を示します。

    SALARY=Users.SALARY
    

    この例では、SALARYがリコンシリエーション・フィールドであり、対応するターゲット・システム属性でもあります。標準として、すべてのリコンシリエーション・フィールド名の前に接頭辞Users.が付けられます。

制限付きのリコンシリエーション

デフォルトでは、前回のリコンシリエーションの実行後に追加または変更されたすべてのターゲット・システム・レコードが、現在のリコンシリエーションの実行中にリコンサイルされます。リコンサイルする必要のある新規に追加または変更されたレコードのサブセットを指定して、リコンシリエーション・プロセスをカスタマイズできます。このような制限付きのリコンシリエーションを実装するには、リコンシリエーション用にカスタマイズされた問合せを作成します。これは、リコンシリエーション・モジュールのフィルタを作成して行います。

フィルタを作成するには、ターゲット・システム属性に値を指定します。この値は、SELECT問合せの条件で、リコンサイルするレコードを取得するために使用されます。次のターゲット・システム属性のいずれか、または属性の組合せに対して値を指定できます。

  • Lastname

  • DeptId

  • Postal

複数のターゲット・システム属性を使用してレコードをフィルタリングする場合は、選択したターゲット・システム属性の組合せに適用する論理演算子(ANDまたはOR)も指定する必要があります。

コネクタをデプロイする際に、ターゲット・システムの属性値および適用する論理演算子を指定する手順の詳細は、「スケジュール済タスク属性の値の指定」を参照してください。

増分リコンシリエーションの構成


注意:

この項では、属性という用語はユーザー・データを格納するIDデータ・フィールドを指します。

この項では、次のトピックについて説明します。

PeopleSoftリスナーの構成

この項では、PeopleSoftリスナーを構成する方法について説明します。以降の手順において、OIM_HOMEはローカルのOracle Identity Managerのインストール・ディレクトリを指します。

PeopleSoftリスナーを構成するには、次のようにします。

  1. OIM_HOME/cbrecon_webapp/lib/peopleSoftApp.warファイルを一時フォルダ内にコピーします。次のコマンドを入力して、peopleSoftApp.warファイルの内容を抽出します。

    jar –xvf peopleSoftApp.war
    

    注意:

    残りのステップに示すファイルはすべて、peopleSoftApp.warファイルから抽出されたものです。

  2. deployment.propertiesファイルを編集します。このファイルには、PeopleSoftフィードからのXMLメッセージの名前に対応するメッセージ・プロパティが含まれます。この属性のデフォルト値は、PSFT_XELLERATE_MSGです。この属性の正しい実際の値をPeopleSoft管理者から取得し、このファイル内の値を実際の値に置き換えます。

  3. xlsession.propertiesファイルを編集します。このファイルには、次のOracle Identity Manager接続パラメータが含まれます。

    • ObjectName: これは、リコンシリエーション・イベントが作成されるOracle Identity Managerのリソース・オブジェクトの名前です。デフォルト値はPSFT_HR_ROです。

    • Username: これは、Oracle Identity Managerにログインするためのユーザー名です。デフォルト値はxelsysadmです。

    • Password: これは、Oracle Identity Managerにログインするためのパスワードです。暗号化されたパスワードの値を入力する必要があります。


      関連項目:

      プレーン・テキスト・パスワードの暗号化の詳細は、「新しいOracle Identity Managerパスワードの暗号化」を参照してください。

  4. xlclient.propertiesファイルを編集します。このファイルには、APIクライアントとOracle Identity Managerとの通信を可能にする次のシステム・プロパティが含まれます。

    • xl.homedir: このプロパティは、Oracle Identity Managerクライアント・ディレクトリを指定します。通常、Oracle Identity Managerクライアント・ディレクトリはOIM_HOME/xlclientです。

    • java.security.policy: このプロパティは、セキュリティ・ポリシー・ファイルのパスを指定します。通常、このファイルはOIM_HOME/xlclient/configディレクトリにあります。

    • java.security.auth.login.config: このプロパティは、認証構成ファイルのパスを指定します。通常、このファイルはOIM_HOME/xlclient/configディレクトリにあります。

      各アプリケーション・サーバーは、それぞれ異なる認証構成ファイルを使用します。

      IBM WebSphere: authws.conf

      BEA WebLogic: authwl.conf

      JBoss Application Server: auth.conf

      Oracle Application Server: auth.conf

    • java.naming.provider.url: このプロパティは、アプリケーション・サーバーのJNP URLを指定します。このURLは、OIM_HOME/xlclient/config/xlconfig.xmlファイルの<Discovery><CoreServer><java.naming.provider.url>タグに示されています。各アプリケーション・サーバーは、異なるjava.naming.provider.urlを使用します。

      • WebLogic: t3://host:7001

      • JBoss: jnp://host:1099

      • WebSphere: corbaloc:iiop:host:2809

      • Oracle Application Server: ormi://localhost:12401/Xellerate

  5. configureReconciliation.propertiesファイルで次のプロパティを編集します。

    • reconciliationMode: このプロパティは常にtrustedに設定する必要があります。

    • Serverdateformat: このプロパティは、PeopleSoftサーバーで使用される日付書式を指定します。次のいずれか1つの日付書式を選択できます。

      • dd-mmm-yy

      • ddmmyy

      • yyddmm

      • yymmdd

      • dd.mm.yy(PeopleSoftインストールでMicrosoft SQL Serverが使用されている場合)

      • dd.mm.yyyy(PeopleSoftインストールでIBM DB2 UDBが使用されている場合)

    • xellerateOrganization: このプロパティは、Oracle Identity Manager組織の名前を指定します。このプロパティのデフォルト値は、Xellerate Usersです。このプロパティには、Oracle Identity Managerに存在している値を割り当てる必要があります。

    • nullDate: このプロパティは、日付フィールドのデフォルト値を指定します。値は2200/01/01 00:00:00 PSTです。日付フィールドを空白のままにした場合は、この値が使用されます。

    • PeoplesoftstartingYEAR: このプロパティは、年を2桁で指定します。この2桁(xx)で表された数字に応じて、年は次のように決まります。

      • 50以上の場合、19xx年とみなされます。

      • 50未満の場合、20xx年とみなされます。

      これにより、プロパティは1950〜2049の範囲で指定されます。

    • XelServerDate: このプロパティには、Oracle Identity Managerサーバーに使用される日付書式が含まれます。

      XelServerDateプロパティの現在の値: yyyy/MM/dd hh:mm:ss z


      注意:

      この日付書式は変更しないでください。

    • Filter: このプロパティは、OPRIDLIKEおよびUserTypeなどのフィルタの値を必要に応じて編集します。このプロパティのデフォルト値は、NO DATAです。これらの値を使用して増分リコンシリエーションを構成します。

  6. OIM_HOME/xellerate/libディレクトリからWEB-INF/libディレクトリに次のファイルをコピーします。


    注意:

    WEB-INF/libディレクトリから次のJARファイルを削除した後、OIM_HOME/xellerate/libディレクトリからJARファイルをコピーしてください。

    • xlAPI.jar

    • xlAuthentication.jar

    • xlBackOfficeBeans.jar

    • xlBackofficeClient.jar

    • xlCache.jar

    • xlCrypto.jar

    • xlDataObjectBeans.jar(IBM WebSphere Application Serverの場合、このファイルをOIM_CLIENT/xlclient/libからコピー)

    • xlDataObjects.jar

    • xlLogger.jar

    • xlUtils.jar

    • xlVO.jar

    • xlAdapterUtilities.jar

    OIM_HOME/xellerate/extディレクトリからWEB-INF/libディレクトリに次のファイルをコピーします。

    • oscache.jar

    • javagroups-all.jar

    • commons-collections.jar

    • commons-digester.jar

    • commons-logging.jar

    • commons-validator.jar

    • jdbcpool-0.99.jar

    • log4j-1.2.8.jar

    • struts.jar

    • xalan.jar

    • xerces.jar

    • xercesImpl.jar

    • xlRemoteManager.jar

    • xlScheduler.jar

  7. peopleSoftApp.warファイルを抽出先の一時ディレクトリから削除し、次のコマンドを使用してファイルを再作成します。

    jar –cvf peopleSoftApp.war
    
  8. アプリケーション・サーバー(BEA WebLogic、IBM WebSphere、JBoss Application ServerまたはOracle Application Server)のデプロイ・ディレクトリから古いバージョンのpeopleSoftApp.warファイルが削除されていることを確認します。

  9. 新しく作成したpeopleSoftApp.warファイルをアプリケーション・サーバーのデプロイ・ディレクトリにコピーします。

  10. Oracle Identity Managerのサーバーおよびクライアントを再起動します。


注意:

増分リコンシリエーション中にリコンサイルするカスタム属性を追加できます。ただし、カスタム属性を追加する前に、デプロイ手順を完了しておく必要があります。

リコンシリエーションのカスタム属性を追加する手順の詳細は、「増分リコンシリエーションの構成」を参照してください。


新しいOracle Identity Managerパスワードの暗号化

Oracle Identity Manager管理者のパスワードがデフォルトのパスワードと異なる場合、次の手順でOracle Identity Managerパスワードを暗号化する必要があります。


注意:

デフォルトの管理者ユーザーIDはxelsysadmです。

  1. Oracle Identity Managerサーバーで、コマンド・ウィンドウを開きます。

  2. コマンド・ウィンドウで、OIM_HOME/xellerate/ScheduleTaskディレクトリに移動します。

  3. 次のコマンドを入力します。

    java -classpath xlPSFTHRRecon.jar  \
    com.thortech.xl.integration.peoplesoft.util.tcUtilEncryption -e \
    OIM_plaintext_password
    

    このコマンドのOIM_plaintext_passwordは、暗号化する新しいOracle Identity Manager管理者パスワードです。

    暗号化されたパスワードがコマンド・ウィンドウに表示されます。

  4. xlsession.propertiesファイルの暗号化されたパスワードの値を、コマンド・ウィンドウからコピーした値に置き換えます。このファイルはOIM_HOME/xlclient/lib/peopleSoftApp.warファイルに圧縮されています。

  5. peopleSoftApp.warファイルを抽出先の一時ディレクトリから削除し、次のコマンドを使用してファイルを再作成します。

    jar –cvf peopleSoftApp.war .
    
  6. アプリケーション・サーバー(BEA WebLogic、IBM WebSphere、JBoss Application ServerまたはOracle Application Server)のデプロイ・ディレクトリから古いバージョンのpeopleSoftApp.warファイルが削除されていることを確認します。

  7. 新しく作成したpeopleSoftApp.warファイルを、アプリケーション・サーバー(BEA WebLogic、IBM WebSphere、JBoss Application ServerまたはOracle Application Server)のデプロイ・ディレクトリにコピーします。

  8. Oracle Identity ManagerおよびDesign Consoleを再起動します。

増分リコンシリエーションのカスタム属性の追加


注意:

この項では、属性という用語はユーザー・データを格納するIDデータ・フィールドを指します。増分リコンシリエーションのカスタム属性を追加しない場合は、この項を省略してかまいません。

標準的な増分リコンシリエーションでは、事前定義済属性のリコンシリエーションが行われます。必要な場合、リコンサイルされる属性のリストにカスタム属性を追加できます。

リコンシリエーションのカスタム属性を追加する手順は、使用しているPeopleToolsのリリースによって異なります。

PeopleTools 8.22での増分リコンシリエーションのカスタム属性の追加

PeopleTools 8.22でリコンシリエーションのカスタム属性を追加するには、次のようにします。

  1. HRMSBulkRecon.txtファイルにあるPeopleCodeを変更します。このファイルはOIM_HOME/xellerate/scriptsディレクトリにあります。必要な変更は次のとおりです。

    1. ファイルの次の行を変更します。

      &hdr = "EMPLID,LASTNAME,FIRSTNAME,SEX,POSTAL,CITY,SSN,PHONE,BIRTHDATE,
      COUNTRY,ADDRESS,STATE,HIRE_DATE,DEPTID,JOBCODE";
      

      たとえば、LOCATION列を追加するには、次のように列名のリストの最後にLOCATIONを追加します。

      &hdr = "EMPLID,LASTNAME,FIRSTNAME,SEX,POSTAL,CITY,SSN,PHONE,BIRTHDATE,
      COUNTRY,ADDRESS,STATE,HIRE_DATE,DEPTID,JOBCODE,LOCATION";
      
    2. 追加された新しい属性の値を取得してローカル変数に格納するようにファイル内のSQL文を変更します。

      たとえば、リコンサイルされる属性のリストにジョブのロケーション属性LOCATIONを追加するには、SQL文を次のように変更します。

      SQLExec("select DEPTID, JOBCODE, LOCATION 
      from ps_job a where emplid =:1 and effdt=(select max(effdt) 
      from ps_job b where a.emplid=b.emplid and effseq =(select max(effseq) from ps_job c 
      where b.emplid = c.emplid and b.effdt=c.effdt))", &empid, &deptid, 
      &jobcd, &location);
      
    3. ヘッダーとSQL文を変更した後、XMLメッセージに必要なデータを追加します。たとえば、JOBタグにXMLメッセージのLOCATIONデータを追加するには、次のコード・サンプルの太字で示された行を追加します。

      /* FOR JOB RECORD */
      &MSG_ROWSET.GetRow(1).JOB.JOBCODE.Value = &jobcd;
      &MSG_ROWSET.GetRow(1).JOB.DEPTID.Value = &deptid;
      &MSG_ROWSET.GetRow(1).JOB.LOCATION.Value = &location;
      
  2. 追加したカスタム属性に基づいてpeopleSoftApp.warファイルを変更します。次のコマンドを使用して、peopleSoftApp.warファイルの内容を一時ディレクトリに抽出します。

    jar –xvf peopleSoftApp.war
    

    このファイルのコピーは、アプリケーション・サーバーのデプロイ・ディレクトリにあります。

  3. attributemap.propertiesファイルで、カスタム属性のXPath(キーと値のエントリ)を追加します。たとえば、LOCATION属性の場合は次のXPathを追加できます。

    Users.LOCATION=//Transaction/DEPT_TBL/LOCATION
    

    注意:

    attributemap.propertiesファイルで、各行のキー部分は等号(=)の左側のテキストです。行のキー部分に空白が含まれていないことを確認する必要があります。たとえば、Users . LOCATIONUsers. LOCATIONUsers.CURRENT LOCATIONには空白が含まれているため、これらのキー値はすべて無効です。

  4. 古いバージョンのpeopleSoftApp.warファイルを抽出先の一時ディレクトリから削除し、次のコマンドを入力して、追加したカスタム属性を含むファイルを再作成します。

    jar –cvf peopleSoftApp.war .
    
  5. アプリケーション・サーバーのデプロイ・ディレクトリから古いバージョンのpeopleSoftApp.warファイルを削除します。

  6. 新しく作成したpeopleSoftApp.warファイルをアプリケーション・サーバーのデプロイ・ディレクトリにコピーします。

  7. Oracle Identity Manager Design Consoleで、次の手順で必要な変更を行います。


    関連資料:

    次の手順の実行に関する詳細は、『Oracle Identity Managerデザイン・コンソール・ガイド』を参照してください。

    1. 「User Defined Process」フォーム内の新しい属性UD_PSFT_HRに対応する列を追加します。前述の例では、追加した新しい属性のUD_PSFT_HR_LOCATIONという列を追加できます。

    2. リソース・オブジェクトの新しい属性PSFT_HR_ROに対応するリコンシリエーション・フィールドを追加します。前述の例では、Users.LOCATIONというリコンシリエーション・フィールドを追加できます。

    3. PSFT_HR Processプロセス定義を変更して、新しく追加した属性と対応するリコンシリエーション・フィールドの間のマッピングを追加します。前述の例では、マッピングは次のようになります。

      Users.LOCATION = UD_PSFT_HR_LOCATION
      

      この例では、LOCATIONがリコンシリエーション・フィールドであり、対応するターゲット・システム属性でもあります。標準として、すべてのリコンシリエーション・フィールド名の前に接頭辞Users.が付けられます。

  8. Oracle Identity Managerのサーバーおよびクライアントを再起動します。

PeopleTools 8.45〜8.48での増分リコンシリエーションのカスタム属性の追加

PeopleTools 8.45〜8.48でリコンシリエーションのカスタム属性を追加するには、次のようにします。

  1. HRMSCBRecon.txtファイル内のPeopleCodeに必要な変更を行います。このファイルはOIM_HOME/xellerate/scriptsディレクトリにあります。必要な変更は次のとおりです。

    1. SQL文セクションの最後に、新しい属性の列値を取得してローカル変数にそれらの値を格納するためのSQL文を追加します。

      たとえば、リコンサイルされる属性のリストに部門のロケーション属性LOCATIONを追加するとします。この場合、PS_DEPT_TBL表からLOCATION列の値が取得されるように次のSQL文を追加します。

      SQLExec("SELECT DESCR, LOCATION FROM PS_DEPT_TBL WHERE DEPTID=:1", &deptid, &deptname, &location);
      
    2. 取得したデータ・フィールドをXMLメッセージに追加します。たとえば、DEPT_TBLタグにLOCATION列を追加するには、次のコード・サンプルの太字で示された行を追加します。

      &recnode = &fieldtypenode.AddElement("DEPT_TBL");
      &recnode.AddAttribute("class", "R");
      &fields = &recnode.AddElement("DEPTNAME");
      &fields.AddAttribute("type", "CHAR");
      &fields = &recnode.AddElement("LOCATION");
      &fields.AddAttribute("type", "CHAR");
      
    3. 取得したデータ・テキストをXMLメッセージに追加します。たとえば、DEPT_TBLタグにLOCATION列を追加するには、次のコード・サンプルの太字で示された行を追加します。

      &datarecnode = &transnode.AddElement("DEPT_TBL");
      &datarecnode.AddAttribute("class", "R");
      &datafldnode = &datarecnode.AddElement("DEPTNAME");
      &textnode = &datafldnode.AddText(&deptname);
      &datafldnode = &datarecnode.AddElement("LOCATION");
      &textnode = &datafldnode.AddText(&location);
      
  2. PeopleSoft Application Designerで、HRMSCBRecon.txtファイルの内容をPERSONAL_DATAコンポーネントのsavePostChangeイベントにコピーします。

  3. 次のコマンドを使用して、peopleSoftApp.warファイルの内容を一時ディレクトリに抽出します。

    jar –xvf peopleSoftApp.war
    

    このファイルのコピーは、アプリケーション・サーバーのデプロイ・ディレクトリにあります。

  4. attributemap.propertiesファイルで、カスタム属性のXPath(キーと値のエントリ)を追加します。たとえば、LOCATION属性のXPathを次のように追加します。

    Users.LOCATION=//Transaction/DEPT_TBL/LOCATION
    

    注意:

    attributemap.propertiesファイルで、各行のキー部分は等号(=)の左側のテキストです。行のキー部分に空白が含まれていないことを確認する必要があります。たとえば、Users . LOCATIONUsers. LOCATIONUsers.CURRENT LOCATIONには空白が含まれているため、これらのキー値はすべて無効です。

  5. 古いバージョンのpeopleSoftApp.warファイルを抽出先の一時ディレクトリから削除し、次のコマンドを使用して、新しい属性を含むファイルを再作成します。

    jar –cvf peopleSoftApp.war .
    
  6. アプリケーション・サーバーのデプロイ・ディレクトリから古いバージョンのpeopleSoftApp.warファイルを削除します。

  7. 新しく作成したpeopleSoftApp.warファイルをアプリケーション・サーバーのデプロイ・ディレクトリにコピーします。

  8. Oracle Identity Manager Design Consoleで、次の手順で必要な変更を行います。


    関連資料:

    次の手順の実行に関する詳細は、『Oracle Identity Managerデザイン・コンソール・ガイド』を参照してください。

    1. Oracle Identity Manager Design Consoleの「Development Tools」フォルダ内にあるプロセス・フォームを開きます。

    2. 「Create New Version」をクリックします。

    3. 「Create New Version」ダイアログ・ボックスの「Label」フィールドに、バージョン名を指定します。変更内容を保存し、ダイアログ・ボックスを閉じます。

    4. 「Current Version」リストから、新しく作成したバージョンを選択します。

    5. 「Additional Columns」タブで、「Add」をクリックします。「User Defined Process」フォーム内の新しい属性UD_PSFT_HRに対応する列を追加します。前述の例では、UD_PSFT_HR_LOCATIONという列を追加できます。

    6. リソース・オブジェクトの新しい属性PSFT_HR_ROに対応するリコンシリエーション・フィールドを追加します。前述の例では、Users.LOCATIONというリコンシリエーション・フィールドを追加できます。

    7. PSFT_HR Processプロセス定義を変更して、新しく追加した属性と対応するリコンシリエーション・フィールドの間のマッピングを追加します。前述の例では、マッピングは次のようになります。

      Users.LOCATION = UD_PSFT_HR_LOCATION
      

      この例では、LOCATIONがリコンシリエーション・フィールドであり、対応するターゲット・システム属性でもあります。標準として、すべてのリコンシリエーション・フィールド名の前に接頭辞Users.が付けられます。

  9. Oracle Identity Managerのサーバーおよびクライアントを再起動します。

制限付きのリコンシリエーション

デフォルトでは、前回のリコンシリエーションの実行後に追加または変更されたすべてのターゲット・システム・レコードが、現在のリコンシリエーションの実行中にリコンサイルされます。リコンサイルする必要のある新規に追加または変更されたレコードのサブセットを指定して、リコンシリエーション・プロセスをカスタマイズできます。このような制限付きのリコンシリエーションを実装するには、リコンシリエーション用にカスタマイズされた問合せを作成します。これは、リコンシリエーション・モジュールのフィルタを作成して行います。

フィルタを作成するには、ターゲット・システム属性に値を指定します。この値は、SELECT問合せの条件で、リコンサイルするレコードを取得するために使用されます。OPRIDLIKEパラメータおよびUserTypeパラメータが含まれているconfigureReconciliation.propertiesファイルを編集すると、フィルタを作成できます。

次のターゲット・システム属性のいずれか、または属性の組合せに対して値を指定できます。

  • Lastname

  • DeptId

  • Postal

複数のターゲット・システム属性を使用してレコードをフィルタリングする場合は、選択したターゲット・システム属性の組合せに適用する論理演算子(ANDまたはOR)も指定する必要があります。

コネクタをデプロイする際に、ターゲット・システムの属性値および適用する論理演算子を指定する手順の詳細は、「スケジュール済タスク属性の値の指定」を参照してください。