レシピをインストールする前に
Oracle Integrationを使用してPeopleSoftに正常に接続し、PeopleSoftとOCI Identity and Access Managementの間でユーザー・アカウントを同期するには、PeopleSoftインスタンスで特定の構成タスクを実行する必要があります。
- 統合ゲートウェイおよびロード・コネクタを定義します。
- ゲートウェイURLを構成し、ドメインをアクティブ化します。
- PeopleTools > Integration Broker > 構成 > 統合ゲートウェイに移動します。
- デフォルトのgatway URLをそのまま使用するか、使用するURLを入力します。
- Pingゲートウェイをクリックします。
ゲートウェイがアクティブであることを示すメッセージが表示されます。
- 非同期メッセージを処理するには、1つのアプリケーション・サーバー・ドメインがアクティブである必要があります。 「Integration Brokerドメイン」ペインで、使用する適切なドメインをアクティブ化します。
- 「保存」をクリックします。
- ゲートウェイ・コネクタをロードします。
- PeopleTools > Integration Broker > 構成 > 統合ゲートウェイに移動します。
- 既存のゲートウェイを検索します。 検索基準を満たすゲートウェイがない場合は、「新しい値の追加」リンクをクリックします。
- 統合ゲートウェイIDフィールドに、統合ゲートウェイIDを入力します。たとえば、:
IAM_LOCALをクリックし、追加をクリックします。 - 「ローカル・ゲートウェイ」チェック・ボックスを選択し、URLフィールドに前のステップで構成したゲートウェイURLを入力します。
- 「ゲートウェイ接続のロード」をクリックします ロードされたすべてのゲートウェイ・コネクタが「コネクタ」領域に表示されます。
- 「保存」をクリックして、ゲートウェイ情報を保存します。
- ゲートウェイURLを構成し、ドメインをアクティブ化します。
- 統合ゲートウェイのプロパティを構成します。
- PeopleTools > Integration Broker > 構成 > 統合ゲートウェイに移動します。
- ステップ1bで定義したゲートウェイを検索します。
- ゲートウェイを開き、統合ゲートウェイの「URL」フィールドの横にある「ゲートウェイ設定プロパティ」リンクをクリックします。
- 表示された「ゲートウェイ・プロパティのサインイン」ページで、「ユーザーID」および「パスワード」と入力し、OKをクリックします。
- 表示された「PeopleSoftノード構成」ページで、「拡張プロパティ・ページ」リンクをクリックします。
- 表示されたエディタでゲートウェイのプロパティを構成します。
次の統合ゲートウェイ・プロパティを構成する必要があります:
提供されているコネクタ構成ig.isc.serverURL=PeopleSoft_server_name:port ig.isc.userid=username ig.isc.password=password ig.isc.toolsRel=PeopleTools_version- 提供されたパスワード暗号化ユーティリティを使用して、
ig.isc.passwordの暗号化されたパスワードを生成します。
- OKをクリックして、プロパティを保存します。
- 「保存」をクリックして、統合ゲートウェイ構成を保存します。
- インテグレーションを設定します。
- ノードを定義します。
ノードは、統合で役割を果たす組織、アプリケーション、またはシステムを表します。 たとえば、ノードは、顧客、ビジネス・ユニット、サプライヤ、その他の取引先、外部またはサードパーティのソフトウェア・システムなどを表すことができます。
- PeopleTools > Integration Broker > 統合設定 > ノード定義に移動します。
- 既存のノードを検索します。 検索基準を満たすノードがない場合は、「新しい値の追加」リンクをクリックします。 「ノード名」と入力し、「追加」をクリックします。
- 「ノード定義」タブをクリックしてノードを定義します:
- 「説明」フィールドに説明を入力します。
- 「ノード・タイプ」ドロップダウン・フィールドで、PIAを選択します。
- 「デフォルト・ユーザーID」と入力します。
- 「アクティブ・ノード」チェックボックスを選択します。
- 「コネクタ」タブをクリックして、コネクタを定義します。
- 「ゲートウェイID」を指定するか、ボタンをクリックして、ステップ1bで定義したゲートウェイIDを検索します。
- 「コネクタID」を指定するか、ボタンをクリックして、ステップ1bで定義したコネクタIDを検索します。
コネクタのプロパティは、次の表に示すようにロードされます。
フィールド アクション/説明 HEADER プロパティ名: sendUncompressed
必須: このオプションを有効にします。
値: Y
データ型: STRING
説明: 説明テキスト・エントリはオプションです。
HEADER プロパティ名: Content-Type
値: text/xml
データ型: STRING
説明: 説明テキスト・エントリはオプションです。
HTTPPROPERTY プロパティ名: メソッド
必須: このオプションを有効にします。
値: POST
データ型: STRING
説明: 説明テキスト・エントリはオプションです。
PRIMARYURL プロパティ名: URL
必須: このオプションを有効にします。
値: 統合サーバーを指すURL。 たとえば:
https://IntegrationServer_Host:Port/ic/api/integration/v2/flows/rest/project/ORCL-R-PEOPLESOFT_IAM_USER_SYNC/PEOPLESOFT-IAM-USER-SYNC/1.0/persondetailsデータ型: STRING
説明: 説明テキスト・エントリはオプションです。
HEADER プロパティ名: 認証
必須: このオプションを有効にします。
値: 統合サーバーを起動するための認可として使用されるユーザー名とパスワード。 ユーザー名とパスワードをエンコードするには、次の形式とエンコーディング・フロー・サービスを使用:
"Basic" (+ Base64Encode service using username + ":" + password)ユーザー名とパスワードをエンコードするには、次のユーティリティ・フロー・サービスを使用:
wm.adapter.peoplesoft.outbound.utils.encoding。エンコーディング・サービスの入力は、次のようにユーザー名とパスワードから構成される文字列です:"username"+":"+"password"。 たとえば、ユーザー名が"name"で、パスワードが"pwd"の場合、エンコーディング・サービスの入力は"name:pwd"になります。 これらの値のエンコーディング・フロー・サービスの結果は、"bmFtZTpwd2Q"になります。 したがって、「認証」フィールドの値は"Basic bmFtZTpwd2Q"になります。データ型: このフィールドは空白のままにします。
説明: 説明テキスト・エントリはオプションです。
- ノードのPingをクリックします。 結果が成功することを確認します。
- 「戻る」をクリックします。
- 「保存」をクリックします。
指定されたノードが作成されます。
- メッセージを定義します。
メッセージ定義は、フィールド、フィールド・タイプ、フィールド長など、送信されるデータの物理的な説明を提供します。
- PeopleTools > Integration Broker > 統合設定 > メッセージ定義に移動します。
- 既存のメッセージを検索します。 検索基準を満たすメッセージがない場合は、「新しい値の追加」リンクをクリックします。
- 「新規メッセージの追加」ウィンドウで、次の手順を実行します:
- 「タイプ」ドロップダウン・リストから、「行セット」を選択します。
- 「メッセージ名」フィールドに、メッセージの名前を入力します。 たとえば:
COUNTRY_SYNC。 - 「メッセージ・バージョン」フィールドに、バージョンを入力します。 たとえば:
VERSION_1 - 「追加」をクリックします。
- 「メッセージ定義」タブをクリックし、メッセージを定義します。
- 「説明」フィールドにメッセージの説明を入力します。
- 「所有者ID」ドップダウン・リストから、「エンタープライズ・コンポーネント」を選択します。
- 「ルートへのレコードの追加」リンクをクリックして、ルート・ノードにレベル0レコードを追加します。
- レコード・リンクをクリックすると、レベル0のレコードまたはその子レコードにレコードを追加することもできます。
- 「保存」をクリックします。
指定されたメッセージが作成されます。
- メッセージ・キューを定義します。メッセージ・キューは、異なるサービス操作のグループを相互に分離します。 プラグイン用のメッセージを処理するために排他的に作成する必要があります。 既存のメッセージ・キューを選択することもできます。 データのエクスポート元となるレコードにメッセージが存在しない場合は、メッセージを作成する必要があります。 既存のメッセージの変更が必要になる場合があります。
- サービスを定義します。PeopleSoft Integration Brokerを使用すると、既存のコンポーネント・インタフェースを取得し、コンポーネント・インタフェースの起動に使用できるサービスを作成できます。
- PeopleTools > Integration Broker > 統合設定 > サービス定義に移動します。
- 既存のサービスを検索します。 検索基準を満たすサービスがない場合は、「新しい値の追加」リンクをクリックします。
- サービス名を入力し、「追加」ボタンをクリックします。
- サービス・ウィンドウで、サービス情報を入力します。
- 説明フィールドにサービスの説明を入力します。
- 「オブジェクト所有者ID」ドロップダウン・フィールドで、「エンタープライズ・コンポーネント」を選択します。
- サービス・オペレーション領域で、サービス・オペレーションを定義します。 「サービス・オペレーション」と入力し、「操作タイプ」ドロップダウン・リストから操作のタイプを選択し、「追加」をクリックします。
サービス操作を定義するには、ステップ3eに従います。
- 「保存」をクリックします。
指定されたサービスが作成されます。
- サービス・オペレーションを定義します。
サービス・オペレーション定義は、操作に関する一般情報(名前、説明など)で構成されます。 また、操作タイプも指定し、操作の処理方法(同期または非同期)を決定します。 さらに、サービス・オペレーションの方向(インバウンドまたはアウトバウンド)を決定するルーティングも含まれます。 サービス・オペレーションには1つ以上のハンドラがあり、このハンドラにはメッセージの送受信、メッセージ・コンテンツの操作、およびその他の関数のプログラミング・ロジックが含まれ、実行されます。
Integration Broker (IB)を使用すると、サービス・オペレーションを定義およびカスタマイズできます。 サービス・オペレーションを定義するステップは、すべてのIBアクティビティで同じです。 ただし、使用するIBアクティビティに基づいて、次の中から適切な操作タイプを選択する必要があります:
非同期 - 一方向: IBRequestアクティビティ用。
サービス・オペレーションを定義するには、次の手順に従います:
- PeopleTools > Integration Broker > 統合設定 > サービス・オペレーション定義に移動します。
- 既存のサービス・オペレーションを検索します。 検索基準を満たすサービス操作がない場合は、「新しい値の追加」リンクをクリックします。
- 「新規サービス・オペレーションの追加」ペインで、次の詳細を入力します:
- サービスを指定するか、ボタンをクリックして、ステップ3dで定義したサービスを検索します。
- 「サービス・オペレーション」名を指定します。
- ドロップダウン・リストから適切な「操作タイプ」を選択します。
- 「追加」をクリックします。
- 「一般」タブをクリックし、次の詳細を入力します:
- 「オペレーション定義」と入力します。
- 「オブジェクト所有者ID」ドロップダウン・リストから、「エンタープライズ・コンポーネント」を選択します。
- 「バージョン」と入力します。
- 「アクティブ」チェックボックスを選択します。
- Message.Versionを指定するか、ボタンをクリックして、ステップ3bで定義したメッセージを検索します。
- 「キュー名」を指定するか、ボタンをクリックして、ステップ3cで定義したメッセージ・キューを検索します。
- 「ルーティング」タブをクリックします。 「ルーティング名」と入力し、「追加」をクリックします。
- ステップ3fに従ってルーティングを定義します。
- 定義し、使用するルーティングを選択するには、「選択済」チェック・ボックスを選択します。
- 「保存」をクリックします。
指定されたサービス・オペレーションが作成されます。
- ルーティングを定義します。
ルーティング定義によって、統合の送信者とレシーバが決まります。 ルーティング定義を使用すると、インバウンドおよびアウトバウンド変換を指定して、データ構造を送信または受信システムが理解できるものに変換できます。
Integration Brokerでは、工順を定義およびカスタマイズできます。 ルーティングを定義するステップは、すべてのIBアクティビティで同じです。 ただし、使用するIBアクティビティに基づいて、適切な送信元ノードと受信元ノードを選択する必要があります。
工順を定義する手順は、次のとおりです:
- PeopleTools > Integration Broker > 統合設定 > ルーティング定義に移動します。
- 既存の工順を検索します。 検索基準を満たすルーティングがない場合は、「新しい値の追加」リンクをクリックします。
- 「ルーティング名」と入力し、「追加」をクリックします。
- 「ルーティング定義」タブをクリックし、ルーティングを定義します:
- 「サービス・オペレーション」を指定するか、ボタンをクリックして、ステップ3eで定義したサービスを検索します。
- 「バージョン」と入力します。
- 「説明」と入力します。
- 「送信者ノード」を指定するか、ボタンをクリックして、ステップ3aで定義したノードを検索します。
- 受信ノードを指定するか、ボタンをクリックして、ステップ3aで定義したノードを検索します。
- 「オブジェクト所有者ID」ドロップダウン・リストから、「PeopleTools」を選択します。
- 「コネクタ・プロパティ」タブをクリックし、次の情報を入力します:
- 「ゲートウェイID」を指定するか、ボタンをクリックして、ステップ1で定義したゲートウェイを検索します。
- 「コネクタID」を指定するか、ボタンをクリックして、ステップ2で定義したコネクタを検索します。
- 「保存」をクリックします。
指定されたルーティングが作成されます。
- ノードを定義します。
ノート:
スキーマ・ペイロードは、PeopleSoft個人ノードから取得できます。 次のファイルのXMLペイロードと同様である必要があります: PersonBasicSync.xml。 XMLペイロードがOracle Integration RESTトリガー・リクエストと一致していることを確認します。