CreateEx メソッド
- [アーティクル]
-
-
一意なキーと指定されたプロパティを使用して新しいレコードを作成します。
CreateEx
(key1, key2, ..., keyn, interactiveMode, properties)
パラメーター |
説明 |
Key in/out parameter |
個々のキー パラメーター (key1、key2、... keyn)。このパラメーターは必須です。
このキー セットは、サーバー データベースに存在しないものである、つまり、一意である必要があります。
これらのキーは、特定のコンポーネント インターフェイスで定義された CreateEx Keys のセットに対応します。 |
interactiveMode |
エラー処理。
コンポーネント インターフェイスでプロパティにアクセスする場合、Microsoft BizTalk Adapter for PeopleSoft Enterprise では、PeopleSoft から提供されている API を使用してコンポーネント インターフェイス内の個々のフィールドを読み書きします。ただし、これらの変更は一度に 1 つずつ PeopleSoft サーバーに伝達されるわけではありません。 代わりに、psjoa.jar (BizTalk Adapter for PeopleSoft Enterprise と対話) が、すべての変更を 1 つのパッケージにしてサーバーに送信します。
個別の更新が失敗した場合、汎用エラーが返されます。このエラーは、実際のエラーを特定しません。 対話モードを TRUE に設定することで、すべてのフィールド更新がサーバーに個別に送信されます。 これによってパフォーマンスに大きな影響が及びますが、更新が失敗した場合 (たとえば、フィールドの設定に無効な値が使用された場合) には、具体的なエラー情報が提供されます。
interactiveMode は最大のパフォーマンスを発揮し、フィールド更新レベルでエラーを報告します。 この機能を正しく使用できるように、interactiveMode を FALSE に設定して通常の呼び出しを行うことをお勧めします。 パフォーマンスへの影響はありません。 エラーが返された場合は、interactiveMode フラグを TRUE に設定して同じ呼び出しを再試行できます。 呼び出しが失敗した場合、サーバーはより正確なエラー メッセージを返します。 |
properties |
コンポーネント インターフェイスのすべてのプロパティを含む構造体。 メソッドが CreateEx 呼び出されると、これらのプロパティは、指定したキーで作成されたレコードに挿入されます。 |
状況によっては、明示的なキーのセットを使用せずに を呼び出 CreateEx()
すのが一般的ですが、関数は CreateEx
キーを返します。 この動作は、サーバーで実行される PeopleCode でサポートされています。 たとえば、注文書を作成する場合、クライアントには次に利用できる PO 番号がわからないことがあります。 PO 番号キーに NEXT を指定して呼び出すことで PeopleCode が実行され、次に利用できる PO 番号が設定されます。 この情報は、in/out キー パラメーターを使用して呼び出し元のクライアントに返される必要があります。
注意
このメカニズムを機能させるには、キーもレベル 0 のプロパティである必要があります。 それ以外の場合は、元のキーが返されます。
コンポーネント インターフェイスの PeopleSoft Create 関数と Save 関数が有効になっている場合は、BizTalk Adapter for PeopleSoft Enterprise CreateEx()
メソッドが提供されます。
付録 A: コンポーネント インターフェイス メソッド