UpdateEx メソッド
入力キー パラメーター (key1、key2、... keyn) に基づいてプロパティを更新するために使用されます。 を使用 UpdateExする場合、コレクション内の項目を削除することはできません。 削除には別のメソッドを使用します。 詳細については、「 DeleteOnly メソッド」を参照してください。
UpdateEx (key1, key2, ... keyn, correctionMode, interactiveMode,
properties)
| パラメーター | 説明 |
|---|---|
key |
サーバー データベースに存在している必要があるパラメーターのセット。存在していない場合、エラーが発生します。 これらのキーは、特定のコンポーネント インターフェイスに定義された一連の Get キーに対応します。 |
correctionMode |
ブール型のフラグ。 True に設定すると、フィールド値を更新するか、コレクションに新しいアイテムを挿入することによって、有効日が指定されたアイテムを含むコンポーネント インターフェイスへの変更が許可されます。 具体的には、EFFDT が現在の有効日よりも前のアイテムに対する変更が許可されます。 このフラグを TRUE に設定しない場合、これらの項目への変更により、PeopleSoft サーバーからエラーが返されます。 引数は correctionMode 、有効な日付の項目を含むコンポーネント インターフェイスに対してのみ公開されます。 それ以外の場合は、引数の一部として表示されません。運用環境では、 を TRUE に設定 correctionMode しないようにする必要があります。 (これは PeopleSoft からの推奨事項でもあります)。過去の EFFDT キーによって決定されたとおりに既に発生したイベントは変更しないでください。 これによって監査記録を作成できるようになります。 の UpdateEx フラグをcorrectionMode使用すると、この安全メカニズムをバイパスできます。 アイテム内のフィールドを設定し、更新されたアイテムを (削除ではなく) 追加することによって、過去のイベントを非アクティブにすることをお勧めします。 |
interactiveMode |
エラー処理に使用されるフラグ。 コンポーネント インターフェイスのプロパティにアクセスする場合、BizTalk Adapter for PeopleSoft Enterprise では、コンポーネント インターフェイス内の個々のフィールドの読み取りと書き込みを行う PeopleSoft 提供の API が使用されます。ただし、これらの変更は、一度に 1 つずつ PeopleSoft サーバーに反映されません。 代わりに、psjoa.jar (BizTalk Adapter for PeopleSoft Enterprise が操作する) がすべての変更をパッケージ化し、1 つのパッケージで変更をサーバーに送信します。 個別の更新が失敗した場合、汎用エラーが返されます。このエラーは、実際のエラーを特定しません。 対話モードを TRUE に設定することで、すべてのフィールド更新がサーバーに個別に送信されます。 これによってパフォーマンスに大きな影響が及びますが、更新が失敗した場合 (たとえば、フィールドの設定に無効な値が使用された場合) には、具体的なエラー情報が提供されます。 は interactiveMode 最大のパフォーマンスを提供し、フィールドの更新レベルでエラー報告を提供します。 この機能を正しく使用するには、FALSE に設定された通常の呼び出し interactiveMode を行うことをお勧めします。 パフォーマンスへの影響はありません。 エラーが返された場合は、 フラグを TRUE に設定して同じ呼び出しを interactiveMode 再試行できます。 呼び出しが失敗した場合、サーバーはより正確なエラー メッセージを返します。 |
この関数を呼び出す場合、キーに対応するレコードのプロパティが、入力パラメーターのプロパティに置き換えられます。 元のレコードを含むすべてのコレクションは削除され、入力パラメーターで指定されたものに置き換えられます。 これらのコレクションのサイズは、既存のすべてのコレクション項目を削除してから、指定されたコレクション項目を挿入するプロシージャ UpdateEx を使用して一致する必要はありません。
コンポーネント インターフェイスのプロパティに有効日が指定されたアイテムが含まれている場合、元のリストは置き換えられるので、プロパティ パラメーターにすべての将来の有効日が指定されたアイテムが含まれている必要があります。 これによって、有効日が指定されたアイテムの追加と削除のメカニズムが提供されますが、プロパティに過去の有効日が指定されたアイテムも含まれている場合、過去の有効日が指定されたアイテムは変更できないのでエラーが返されます。 現在の有効日が指定されたアイテムも含まれている場合、そのアイテムは無視されます。 これにより、クライアントは パラメーターを False に設定して を呼び出Get()getHistoryItemsし、将来有効な日付の項目を変更したり、将来有効な日付の新しい項目を追加したり、関数のパラメーターとして 構造体をUpdateEx()渡すことができます。
1 つのインスタンスしか存在できない場合と同様に、コンポーネント インターフェイスにキーがない場合、 UpdateEx() メソッドの形式は次のようになります。
UpdateEx(correctionMode, interactiveMode, properties)
注意
コンポーネント インターフェイスの PeopleSoft およびSave関数が有効になっている場合、BizTalk Adapter for PeopleSoft Get Enterprise UpdateEx() メソッドが提供されます。