Is new record

4D - Documentation   Français   English   German   Spanish   4D v11 SQL, Command Theme List   4D v11 SQL, Command Alphabetical List   4D v11 SQL, Constant Theme List   Back   Previous   Next

version 6.5


Is new record {(aTable)} Boolean

ParameterTypeDescription
aTableTableTable of the record to examine or
Default table if this parameter is omitted
Function resultBooleanTrue if the record is being created,
False otherwise

Description

The Is new record command returns True when the 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 instructions 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.


4D - Documentation   Français   English   German   Spanish   4D v11 SQL, Command Theme List   4D v11 SQL, Command Alphabetical List   4D v11 SQL, Constant Theme List   Back   Previous   Next