サポート・ビジネス・オブジェクトを作成するには、次の手順で行います。
PeopleSoft Application Designer を使用して、コンポーネント・インターフェースからクラス構造を作成します。コンポーネント・インターフェースに対応するビジネス・オブジェクトは、データを処理するためにこれらのクラスが必要です。データは PeopleSoft API の一部です。
生成されたクラスの作成および使用を支援するために、このセクションでは次について説明します。
コンポーネント・インターフェースから API を生成するには、次を実行します。
%ProductDir%¥connectors¥PeopleSoft¥dependencies
%ProductDirS% directory:
コンポーネント・インターフェースのクラス・ファイル
¥connectors¥PeopleSoft¥dependencies¥PeopleSoft¥Generated¥CompIntfc
セッション固有のクラス・ファイル
¥connectors¥PeopleSoft¥dependencies¥PeopleSoft¥Generated¥PeopleSoft
画面のショットなどの、API 生成プロセスのさらに詳細な説明については、"API ファイルのビルド"を参照してください。
「PeopleSoft API」メニュー (「Build メニューのサブメニュー) を使用してサンプルの EMER_CONTACT_PROFILE コンポーネント・インターフェースからクラス構造を作成する場合は、以下のものがあります。
コネクターはこのクラス名を使用して、PeopleSoft のコンポーネント・インターフェースを検索およびインスタンス化します。クラス名は、ビジネス・オブジェクト・レベルでアプリケーション固有情報の CiName プロパティーに格納されます。詳細については、"ビジネス・オブジェクト・レベルのアプリケーション固有情報"を参照してください。
コネクターが使用する、生成されたメソッドは次のとおりです。
生成されたクラスにはそれぞれ getFieldName() メソッドがあり、このメソッドによりコネクターがコンポーネント・インターフェースの各単純フィールドのデータ値を取得し、それを対応するビジネス・オブジェクト属性にロードすることができます。
例えば、図 7 の右半分に示すように、EMER_CONTACT_PROFILE コンポーネントの FINDKEYS には 7 つのフィールドがリストされています。これらのフィールドには、EMPLID、NAME、および DEPTID が含まれています。これらのフィールドからデータを取得するために、コネクターは getEmpId()、getName()、および getDeptId() メソッドを使用します。値を取得後、コネクターはそれらの値を EmpId、ContactName、および DeptId ビジネス・オブジェクト属性にロードします。
コレクションの単純なフィールドの値を戻すために、コネクターは最初にコレクションを戻し、次にその中のフィールドを戻します。例えば、EMERGENCY_CNTCT コレクションの CONTACT_NAME フィールドと SAME_ADDRESS_EMPL フィールド内の値を取得するために、コネクターは最初に getEmergencyCntct() メソッドを実行します。次に、getContactName() と getSameAddressEmpl() メソッドを実行します。詳細については、"getCollectionName() メソッド"を参照してください。
生成されたクラスにはそれぞれ setFieldName() メソッドがあり、このメソッドによりコネクターが、対応するビジネス・オブジェクト属性の値に基づいてコンポーネント・インターフェースの各単純フィールドのデータ値を設定できます。
例えば、EmpId、ContactName、および DeptId ビジネス・オブジェクト属性から EMPLID、NAME、および DEPTID フィールドにデータをそれぞれロードするために、コネクターはそれぞれについて setEmpId()、setName()、および setDeptId() メソッドを使用します。
指定された従業員の緊急連絡先のコレクションを戻すために、コネクターは EmerContactProfile クラス内の getEmergencyCntct() メソッドを使用します。コネクターが複数行を処理する方法は、ビジネス・オブジェクト・レベルのアプリケーション固有情報の設定により異なります。
EFFDT パラメーターの詳細については、"ビジネス・オブジェクト・レベルのアプリケーション固有情報"を参照してください。
従業員の各緊急連絡先の電話のタイプと電話番号のコレクションを戻すために、コネクターは EmerContactProfileEmergencyCntct クラス内の getEmergencyPhone() メソッドを使用します。すべてのレコードを取得すると、コネクターはそれらをビジネス・オブジェクトの配列属性 EmergencyPhone[n] にロードします。
コレクション内のレコードを検索するときに、最新の有効期限を持つレコードのみを戻すには、コネクターは EmerContactProfile クラス内の CurrentItem() メソッドを使用します。コネクターは、ビジネス・オブジェクト・レベルのアプリケーション固有情報の EFFDT パラメーターの評価が true の場合のみ、このメソッドを使用します。
コレクション内のレコードを検索するときに、指定されたレコード番号のレコードのみを戻すためには、コネクターは EmerContactProfile クラス内の Item(index) メソッドを使用します。コネクターは、ビジネス・オブジェクト・レベルのアプリケーション固有情報の EFFDT パラメーターの評価が false の場合のみ、このメソッドを使用します。デフォルトでは、このメソッドは検索した最初の行を戻します。