entitySelection.drop( )

4D v19.8


entitySelection.drop ( {mode} ) -> 戻り値

引数	型	説明
mode	倍長整数	dk stop dropping on first error: 最初にドロップできなかったエンティティでメソッドの実行を止める
戻り値	EntitySelection	成功した場合にはからのエンティティセレクション、そうでない場合にはドロップできなかったエンティティを格納したエンティティセレクション

説明

entitySelection.drop( ) メソッドは、データストア内でデータクラスにリレートされているテーブルのエンティティセレクションに所属しているエンティティを削除します。エンティティセレクションはメモリ内に残ります。

注: エンティティの削除は恒久的なものであり、取り消しはできません。ロールバックで戻すことができるように、このアクションはトランザクション内で呼び出すことが推奨されています。

entitySelection.drop( ) の実行中にロックされたエンティティに遭遇した場合、そのエンティティは削除されません。デフォルトでは、メソッドはエンティティセレクション内の全てのエンティティを処理し、エンティティセレクション内にドロップ不可なエンティティを返します。最初に遭遇したドロップ不可なエンティティでメソッドの実行を止めたい場合は、mode 引数にdk stop dropping on first error 定数を渡します。

例題

dk stop dropping on first error オプションを使用しない場合の例:

 C_OBJECT($employees;$notDropped)

 $employees:=ds.Employee.query("firstName=:1";"S@")

 $notDropped:=$employees.drop() // $notDropped はドロップされなかったエンティティを全て格納したエンティティセレクション

 If($notDropped.length=0) //削除アクションは成功、全てのエンティティが削除された

    ALERT("You have dropped "+String($employees.length)+" employees") //ただしドロップされたエンティティはメモリの中には残っています

 Else

    ALERT("Problem during drop, try later")

 End if

dk stop dropping on first error オプションを使用した場合の例:

 C_OBJECT($employees;$notDropped)

 $employees:=ds.Employee.query("firstName=:1";"S@")

 $notDropped:=$employees.drop(dk stop dropping on first error) //$notDropped はドロップできなかった最初のエンティティを格納したエンティティセレクション

 If($notDropped.length=0) //削除アクションは成功、全てのエンティティが削除された

    ALERT("You have dropped "+String($employees.length)+" employees") //ただしドロップされたエンティティはメモリの中には残っています

 Else

    ALERT("Problem during drop, try later")

 End if

参照

entitySelection.add( )