entity.touchedAttributes( )

4D v19.8


entity.touchedAttributes -> 戻り値

引数	型	説明
戻り値	コレクション	触れられた属性の名前、あるいは空のコレクション

説明

entity.touchedAttributes( ) メソッドは、エンティティがメモリに読み込まれた時点から変更された属性の名前を返します。

これはストレージあるいはリレートエンティティ型の属性に適用されます(dataClassAttribute.kind 参照)。

リレートされたエンティティが触れられていた場合(例: 外部キーなど)、リレートされたエンティティとそのプライマリーキーの名前が返されます。

どのエンティティ属性も触れられていなかった場合、メソッドは空のコレクションを返します。

例題 1

 C_COLLECTION($touchedAttributes)

 <p>C_OBJECT($emp)

 

 $touchedAttributes:=New collection

 $emp:=ds.Employee.get(725)

 $emp.firstName:=$emp.firstName //同じで値で更新されていた場合でも、属性は触れられていたとマークされます

 $emp.lastName:="Martin"

 $touchedAttributes:=$emp.touchedAttributes()

  //$touchedAttributes: ["firstName","lastName"]

例題 2

 C_COLLECTION($touchedAttributes)

 C_OBJECT($emp;$company)

 

 $touchedAttributes:=New collection

 

 $emp:=ds.Employee.get(672)

 $emp.firstName:=$emp.firstName

 $emp.lastName:="Martin"

 

 $company:=ds.Company.get(121)

 $emp.employer:=$company

 

 $touchedAttributes:=$emp.touchedAttributes()

 

  //collection $touchedAttributes: ["firstName","lastName","employer","employerID"]

この場合において:

firstName および lastName はストレージ型です
employer はリレートエンティティ型です
employerID は、employer リレートエンティティの外部キーです

参照

entity.touched( )