英語で読む

次の方法で共有


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: コンポーネント インターフェイス メソッド