4.3 ww.dll API Reference : API descriptions : Functions with database access : getaccessinfo
 
getaccessinfo
 
Description
getaccessinfo is provided for convenience. It simply calls getpassinfo with <access>1</access> specified and returns information regarding new and modified access records.
 
Input fields
 
XML tag
Description
<new>
Return new records since the indicated datetime. <new>1</new> (for new pass/access info) or <mod>1</mod> (for modified pass/access info) must be specified in the function call. Boolean.
<mod>
Return modified records since the indicated datetime. <new>1</new> (for new pass/access info) or <mod>1</mod> (for modified pass/access info) must be specified in the function call. Boolean.
<datetime>
Sets the datetime.
 
Return fields
 
Field
Description
pass_no
Pass number.
cluster
Cluster.
parent_no
Parent number.
swipe_no
Swipe number.
addit_no
Additional number.
last_use
Last use.
e_message
E-message.
start_date
Start date.
expires
Expires.
good_for
Good for this number of accesses.
validcount
Number of times validated.
dis_count
Like validcount, but can be reset.
total_uses
Total uses.
usesw_left
Uses left in current week.
week_refr
Used to determine when a week has passed.
usest_left
Uses left in current day.
day_refr
Used to determine when a day has passed.
points1
User-defined meaning.
points2
User-defined meaning.
money1
User-defined meaning.
money2
User-defined meaning.
blackout_s
Blackout start.
blackout_e
Blackout end.
warnings
User-defined meaning.
voided_for
Reason for void.
voided_by
Who voided.
shift_ends
Next time pass is validated.
department
Department.
category
Category.
item
Item.
amt_paid
Amount paid.
account
Account.
operator
Operator.
salespoint
Salespoint.
date_time
Date/time.
val_parent
Validate parent record.
trans_no
Transaction number.
cc_tracks
Hold some or all of the track1, 2 and 3 magnetic swipe info from card.
bl_reason
Blackout reason.
 
Example
 
Example invocation:
Returns all new access records added since 6/06/2007:

<func>getaccessinfo</func><new>1</new><mod>0</mod>
<datetime>6/06/2007</datetime>
Example return string:
OK :…recordset
<rs:data>
<z:row pass_no='1018001' cluster='195' parent_no='1018001'
swipe_no=' ' addit_no='0' e_message=''
start_date='2007-09-30T12:00:00' expires='2007-09-30T12:05:00'
good_for='1' validcount='0' dis_count='0' total_uses='1'
usesw_left='0' usest_left='0' points1='0' points2='0'
money1='0' money2='0' warnings='0' voided_for='' voided_by=''
department='TICKETS ' category='ADULT ' item='1DAY '
amt_paid='300' account='*RESRVATN*' operator='ADMIN '
salespoint='GOLF ' date_time='2007-09-30T14:57:31' val_parent='False'
trans_no='58020001' cc_tracks='' bl_reason=''/>
</rs:data>
 
See also
getpassinfo