Please enable JavaScript to view this site.

Navigation: Advanced topics > Events > Table events

Is Record Editable

Scroll Prev Next More

Description

The IsRecordEditable event occurs after the AfterTableInit event. Use this event to implement custom edit permissions.

 

This event is executed once for each record on the List page as well as on the Edit page. This event is also called before the record is deleted.

Syntax

IsRecordEditable($values,$isEditable)

Arguments

$values

an array of values to be written to the database. To access a specific field value, use $values["FieldName"].

Note: Field names are case-sensitive. If the field name is PlayerId, you should use $values["PlayerId"]. Note that $values["playerid"] or $values["PlayerID"] will not work.

 

Note: If the field was assigned an alias in the SQL query, then the $values array will get the alias instead of the field name from the database.

E.g., if you have an SQL query SELECT salesrep_id AS Inv_Salesrep ..., you should use $values["Inv_Salesrep"].

 

$isEditable

1 if record is editable, 0 if not editable

Return value

True - the record is editable.

 

False - the record is not editable.

Applies to pages

List, Edit.

Example 1

Disable editing of data in a certain table on weekends:

 

$dw = date("w", time());
$isEditable = $dw!=6 && $dw!=0;
return $isEditable;

Example 2

Enable editing of only the records with odd IDs (1,3,5 ...):

 

if ($values["ID"] & 1)
return false;
else
return true;

See also:

•About Security API

•Get Table Permissions

•User group permissions

•Choose Pages Screen

•Event: After table initialized

•"Edit as" settings

•Audit and record locking

•SQL query screen

•About SQLQuery class

 

Created with Help+Manual 7 and styled with Premium Pack Version 3 © by EC Software