CardRangeAction Property

The action to be taken with the card range specified by the Start and End properties.

Syntax

 server.getCardRangeAction(index, [callback])

Default Value

Callback

The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).

The callback for the getCardRangeAction([callback]) method is defined as:

function(err, data){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'data' is the value returned by the method.

The callback for the setCardRangeAction([callback]) method is defined as:

function(err){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'err' has 2 properties which hold detailed information:

err.code
err.message

Remarks

The action to be taken with the card range specified by the CardRangeStart and CardRangeEnd fields. Possible values are:

A - Add the card range to the cache (default value)
D - Delete the card range from the cache
M - Modify the card range data (2.2.0 only)

If the SerialNumber was not included in the Card Range Request, the Action will be A (add) for all ranges returned. If no action is returned for the card range (empty value), it can be assumed that the action for the range is A. Note that the card ranges must be processed in the order returned.

The index parameter specifies the index of the item in the array. The size of the array is controlled by the CardRangeCount property.

This property is read-only and not available at design time.

Data Type

String