4.3 ww.dll API Reference : API descriptions : Functions with database access : getliabilityinfo
 
getliabilityinfo
 
Description
getliabilityinfo looks up the description, minimum age to accept, the expiration days/date and the text of the Liability form(s) assigned to a particular item via <department><category><item> parameters. If the item specified does not have a Liability form associated with it, ww.dll returns, “ERR:Function getliabilityinfo did not return information.” By including the optional <guest_no> parameter in the call, ww.dll returns either 1 (true) or 0 (false) in a column called Accepted to denote whether the guest has accepted the Liability form and whether it is still valid. If the form has expired for the guest, ww.dll returns 0 (false).
 
Input fields
 
XML tag
Description
<department>
<item> department.
<category>
<item> category.
<item>
Item.
<guest_no>
Optional. By including the optional <guest_no> parameter in the call, ww.dll returns either 1 (true) or 0 (false) in a column called Accepted to denote whether the guest has accepted the Liability form and whether it is still valid. If the form has expired for the guest, ww.dll returns 0 (false).
 
Return fields
If the item specified does not have a Liability form associated with it, ww.dll returns: ERR:Function getliabilityinfo did not return information. By including the optional <guest_no> parameter in the call, ww.dll returns either 1 (true) or 0 (false) in a field called accepted to denote whether the guest has accepted the Liability form and whether it is still valid. If the form has expired for the guest, ww.dll returns 0 (false).
 
Field
Description
pri_key
Primary key.
department
Department.
category
Category.
item
Item.
liability
Liability.
sortorder
Sort order.
last_mod
Last modified.
descrip
Description.
liab_text
Liability text.
exp_static
0=expires exp_days days after acceptance, 1=expires on exp_date
exp_days
See exp_static.
exp_date
See exp_static.
accept_age
Guest age required to accept the form.
hidden
Hidden.
accepted
Boolean to denote whether the guest has accepted the Liability form and whether it is still valid. Only returned if optional <guest_no> parameter is included in the call.
 
Example
 
Example invocation:
<func>getliabilityinfo</func><department>pufrentals</department>
<category>pufrntpkgs</ category ><item>bascskipkg</item><guest_no>577000000</guest_no>
 
Example return string:
OK :…recordset
<rs:data>
            <z:row pri_key='4000000' department='PUFRENTALS' category='PUFRNTPKGS'
               item='BASCSKIPKG' liability='1000000' sortorder='1' last_mod='25'
               c7='1000000' descrip='SKIING                   ' liab_text='Skiing is
dangerous so be careful.'
               exp_static='False' exp_days='365' exp_date='2007-06-06T23:59:59'
               accept_age='18' hidden='False' c15='17' accepted='0'/>
</rs:data>
 
See also
acceptliability