4D v18
entity.touched( )
- 4D Language Reference
-
- ORDA - Entity
-
- entity.{attributeName}
- entity.save( )
- entity.drop( )
- entity.lock( )
- entity.reload( )
- entity.unlock( )
- entity.getKey( )
- entity.diff( )
- entity.touched( )
- entity.touchedAttributes( )
- entity.clone( )
- entity.getSelection( )
- entity.first( )
- entity.last( )
- entity.next( )
- entity.previous( )
- entity.indexOf( )
- entity.toObject( )
- entity.fromObject( )
- entity.getStamp( )
- entity.isNew( )
- entity.getDataClass( )
entity.touched( )
The entity.touched( ) method tests whether or not an entity attribute has been modified since the entity was loaded into memory or saved.
If an attribute has been modified or calculated, the method returns true, else it returns false. You can use this method to determine if you need to save the entity.
This method returns false for a new entity that has just been created (with dataClass.new( )). Note however that if you use a method which calculates an attribute of the entity, the entity.touched( ) method will then return true. For example, if you call entity.getKey( ) to calculate the primary key, the entity.touched( ) method returns true.
In this example, we check to see if it is necessary to save the entity:
C_OBJECT($emp)
$emp:=ds.Employee.get(672)
$emp.firstName:=$emp.firstName // Even if updated with the same value, the attribute is marked as touched
If($emp.touched()) //if at least one of the attributes has been changed
$emp.save()
End if // otherwise, no need to save the entity
Product: 4D
Theme: ORDA - Entity
4D Language Reference ( 4D v18)
