英語で読む

次の方法で共有


DeleteOnly メソッド

コレクション内のアイテムを削除できます。

構文

DeleteOnly(key1, key2, ..., keyn, correctionMode, interactiveMode,  
    properties)  

パラメーター

パラメーター 説明
key 指定する必要があるパラメーター セットです。 このキー セットはサーバー データベースに存在する必要があります。存在しない場合、エラーが発生します。 これらのキーは、特定のコンポーネント インターフェイスに定義された一連の Get キーに対応します。
correctionMode ブール型のフラグ。 true に設定すると、コレクションの有効日が過去になったアイテムを削除できます。 具体的には、EFFDT が現在の有効日より前になっているアイテムを削除できます。 このフラグを TRUE に設定しない場合、これらの項目への変更により、PeopleSoft サーバーからエラーが返されます。 メモ: 引数は correctionMode 、有効な日付の項目を含むコンポーネント インターフェイスに対してのみ公開されます。 それ以外の場合、引数の一部として表示されません。
interactiveMode エラー処理に使用されます。

コンポーネント インターフェイスでプロパティにアクセスする場合、BizTalk Adapter for PeopleSoft Enterprise では、PeopleSoft から提供されている API を使用してコンポーネント インターフェイス内の個々のフィールドを読み書きします。ただし、これらの変更は一度に 1 つずつ PeopleSoft サーバーに伝達されるわけではありません。 代わりに、psjoa.jar (BizTalk Adapter for PeopleSoft Enterprise と対話) が、すべての変更を 1 つのパッケージにしてサーバーに送信します。 個別の更新が失敗した場合、汎用エラーが返されます。このエラーは、実際のエラーを特定しません。 対話モードを TRUE に設定することで、すべてのフィールド更新がサーバーに個別に送信されます。 これによってパフォーマンスに大きな影響が及びますが、更新が失敗した場合 (たとえば、フィールドの設定に無効な値が使用された場合) には、具体的なエラー情報が提供されます。

パラメーターは interactiveMode 最大のパフォーマンスを提供し、フィールド更新レベルでエラー報告を提供します。 この機能を正しく使用するには、FALSE に設定された通常の呼び出し interactiveMode を行うことをお勧めします。 パフォーマンスへの影響はありません。 エラーが返された場合は、interactiveMode フラグを TRUE に設定して同じ呼び出しを再試行できます。 呼び出しが失敗した場合、サーバーはより正確なエラー メッセージを返します。
properties サーバーに存在する構造のサブセットが入ります。 リーフであるアイテムはすべて削除されます。

注釈

プロパティのデータ型 CreateEx は、このコンポーネント インターフェイスの メソッドまたは UpdateEx メソッドと同じですが、重要なのはキー値のみです。 キー以外の値は無視されます。 キー値はサーバーのキー値と一致する必要があります。一致しない場合、例外が発生します。

次に、キー値の使用方法を示します。 コレクションに次のアイテムがあるとします。

  • item0

  • item1

  • item2

  • item3

    プロパティの item1 と item3 のキーを指定すると、item1 と item3 を削除できます。

  • item1

  • item3

    呼び出し後、サーバーのコレクションには次のアイテムが残ります。

  • item0

  • item2

    2 番目の例では、他のコレクションが入ったアイテムを示します。

  • item0

    • item0a
  • item1

    • item1a

    • item1b

    • item1c

  • item2

    • item2a

    • item2b

    item1b と item2 へのキーを指定することで item1b とすべての item2 を削除できます。

  • item1

    • item1b
  • item2

    item2 の空のサブコレクションを指定することで、item2 をリーフにし、そのサブブランチ全体が削除されます。 呼び出し後、サーバーには次のアイテムが残ります。

  • item0

    • item0a
  • item1

    • item1a

    • item1c

参照

付録 A: コンポーネント インターフェイス メソッド