Skip to main content
Version: Next

Is new record

Is new record {( aTable )} -> Function result

ParameterTypeDescription
aTableTable🡒Table of the record to examine or Default table if this parameter is omitted
Function resultBoolean🡐True if the record is being created, False otherwise

Description

The Is new record command returns True when aTable’s current record is being created and has not yet been saved in the current process.

Compatibility Note: You can obtain the same information by using the existing Record number command, and by testing if it returns -3.
However, we strongly advise you to use Is new record instead of Record number in this case. In fact, the Is new record command ensures compatibility with future versions of 4D.

4D Server: This command returns a different result for the On Validate form event depending on whether it is executed on 4D in local mode or 4D in remote mode. In local mode, the command returns False (the record is considered as already created). In remote mode, the command returns True because, in this case, the record is already created on the server but the information has not yet been sent to the client.

Example

The following two statements are identical. The second one is strongly advised so that the code will be compatible with future versions of 4D:

 If(Record number([Table])=-3) //Not advised
  // ...
 End if
 
 If(Is new record([Table])) //Strongly advised
  // ...
 End if

See also

Modified record
Record number