User Interaction

Top  Previous  Next

 

Functions that involve some kind of interaction with the user are included in this category, such as showing message prompts or opening a particular user-interface dialog like Reservation Details.

 

 

 

(Back to Function Types List)

 

 

 

Function:AddEditRecord        
Result-type:Record        
Arguments:cTableName        
Description:Opens a generic Edit/Details type dialog (customizable) for the record passed.  A custom "Edit Generic Record" Add-on type Dialog Definition must be defined for the given record type, ready to enter data for a new record.  The Edit dialog will not have the browsing/add/delete controls, so only the new record can be accessed.  Returns the record reference of the record added, or NullRecord() if the record is not added (Cancel clicked or no data entered).        

 

Function:AutoCheckoutAll        
Result-type:Boolean        
Arguments:(none)        
Description:Performs the 'Auto-Checkout All of today's departures (shown or not)' function, as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.        

 

 

Function:BackupDatabase        
Result-type:Boolean        
Arguments:cFile [, fCompress]        
Description:Creates a backup of the database to the specified file (which should include the full path, file name and file extension). Compression is optional -- if fCompress is not specified then it will be compressed by default. Return indicates success of backup file creation.        

 

 

Function:CheckOnlineRequestsCustom        
Result-type:Numeric        
Arguments:bNoPrompts, bSilent        
Description:Checks online for any Custom-site reservation requests waiting to be downloaded, and returns how many new requests were found. All appropriate Online Reservations settings must be set up beforehand. The bNoPrompts flag may be set to prevent error prompts and bSilent may be set to hide the progress dialog, however the system will probably be unresponsive during this time. The default parameters are all False (show progress, show errors).        

 

 

Function:CheckOnlineRequestsEmail        
Result-type:Numeric        
Arguments:bNoPrompts, bSilent        
Description:Checks online for any reservation request E-mail messages waiting to be downloaded, and returns how many new requests were found. All appropriate Online Reservations settings must be set up beforehand. The bNoPrompts flag may be set to prevent error prompts and bSilent may be set to hide the progress dialog, however the system will probably be unresponsive during this time. The default parameters are all False (show progress, show errors).        

 

 

Function:CheckOnlineRequestsiCal        
Result-type:Numeric        
Arguments:bNoPrompts, bSilent        
Description:Checks online for any iCal file reservation requests waiting to be downloaded, and returns how many new requests were found.  All appropriate Online Reservations settings must be set up beforehand.  The bNoPrompts flag may be set to prevent error prompts and bSilent may be set to hide the progress dialog, however the system will probably be unresponsive during this time.  The default parameters are all False (show progress, show errors).        

 

 

Function:

CustTextForm

Result-type:

Boolean

Arguments:

rCustomer

Description:

Performs the 'Send a Text Message to the customer' function on the specified Customer, as from the right-click menus, showing the dialog to select a Customer-based Form (or use free-form text of preferred).  Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:Delay        
Result-type:Boolean        
Arguments:nMilliseconds        
Description:Delays all user interaction for the specified number of milliseconds (1/1000ths of a second, e.g. 5000 = 5 seconds). The maximum delay possible at once is 1 minute (60000 ms) -- use a loop if longer times are needed. Note that the accuracy of this not guaranteed, and the usable granularity is generally only 100 ms increments. This function won't return until the delay is complete, and the return value is always True.        

 

 

Function:EditCustomer        
Result-type:Boolean        
Arguments:rRecord        
Description:Opens the Customer Details dialog for the customer record passed. Returns FALSE if the dialog is closed without changes, or returns TRUE if changes are made.        

 

 

Function:EditCustomerTrans        
Result-type:Boolean        
Arguments:rRecord        
Description:Opens the Customer Transactions dialog for the customer record passed. Returns FALSE if the dialog is closed without changes, or returns TRUE if changes are made.        

 

 

Function:EditInventoryItem        
Result-type:Boolean        
Arguments:rRecord        
Description:Opens the Edit Inventory Item dialog for the POS inventory item record passed. Returns FALSE if the dialog is closed without changes, or returns TRUE if changes are made.        

 

 

Function:EditJournalEntry
Result-type:Boolean        
Arguments:rRecord        
Description:Opens the Edit Journal Entry dialog for the record passed. Returns FALSE if the dialog is closed without changes, or returns TRUE if changes are made.        

 

 

Function:EditRecord        
Result-type:Boolean        
Arguments:"rRecord [, bBrowse [, bAllowAdd [, bAllowDelete]]]"        
Description:Opens a generic Edit/Details dialog (customizable) for the record passed.  A custom Dialog Definition must be defined for the given record type.  Set bBrowse to allow browsing to other records, bAllowAdd to allow adding new ones, and bAllowDelete to allow deleting records.  (All options default to False.)  Returns False if the dialog is closed without changes, or returns True if changes are made.        

 

 

Function:EditReservation        
Result-type:Boolean        
Arguments:rRecord        
Description:Opens the Reservation Details dialog for the reservation record passed. Returns FALSE if the dialog is closed without changes, or returns TRUE if changes are made.        

 

 

Function:EditReservationTrans        
Result-type:Boolean        
Arguments:rRecord [,fShowSelectRates]        
Description:Opens the Reservation Transactions dialog for the reservation record passed. Optionally may have it enter the Select Rates function immediately (show the Select Rates dialog). Returns FALSE if the dialog is closed without changes, or returns TRUE if changes are made.        

 

 

Function:EditSite        
Result-type:Boolean        
Arguments:rRecord        
Description:Opens the Site Details dialog for the site record passed. Returns FALSE if the dialog is closed without changes, or returns TRUE if changes are made.        

 

 

Function:EditUnboundTrans        
Result-type:Boolean        
Arguments:rRecord        
Description:Opens the Unbound Transactions dialog, optionally using the transaction record passed as the transaction/receipt to edit. Returns FALSE if the dialog is closed without changes, or returns TRUE if changes are made.        

 

 

Function:EditWorkOrder        
Result-type:Boolean        
Arguments:rRecord        
Description:Opens the Edit Work Order dialog for the record passed. Returns FALSE if the dialog is closed without changes, or returns TRUE if changes are made.        

 

 

Function:ExportToiCal        
Result-type:Boolean        
Arguments:Upload, bNoPrompts, bSilent        
Description:Generates the iCal files and optionally uploads them to a web site via FTP. The settings in Maintenance / Online Reservations / Other Online interfaces will be used, and must be set up beforehand. If uploading, the settings in Online Reservations - Connections & Options / iCal must also be set up. The bNoPrompts flag may be set to prevent error prompts and bSilent may be set to hide the progress dialog, however the system will probably be unresponsive during this time. The default parameters are all False (generate pages only, not silent, show errors). The return value indicates whether it was successful.        

 

 

Function:ExportVacancyToWeb        
Result-type:Boolean        
Arguments:Upload, bNoPrompts, bSilent        
Description:Generates the web site vacancy grids and optionally uploads them to a web site via FTP. The settings in File / Export to Web Vacancy will be used, and must be set up beforehand. If uploading, the settings in Online Reservations - Connections & Options / Export to Web must also be set up. The bNoPrompts flag may be set to prevent error prompts and bSilent may be set to hide the progress dialog, however the system will probably be unresponsive during this time. The default parameters are all False (generate pages only, not silent, show errors). The return value indicates whether it was successful.        

 

 

Function:FindActiveResvByScanCode        
Result-type:Record        
Arguments:cSearchText [, bTransMastersOnly [, bSelectIfMultiple]]        
Description:Searches current 'Active' reservations for the customer Scan Code passed, returns the reservation found if any.  Only looks for reservations covering yesterday or today.  Optionally only count Transaction Master reservations.  If more than one match is found, optionally open Find Reservation to select one (else returns NullRecord if multiple found).        

 

 

Function:FindCustomer        
Result-type:Record        
Arguments:[cFilterBy [, cSearchText [, bCancelAdds [, bAutoUseScanned ]]]]        
Description:Opens the Find Customer dialog, optionally with a starting Filter By selection and Search Text (note that the Filter By argument must exactly match the selection in the dialog's drop-down list). If bCancelAdds is True, then the Cancel button shows 'Cancel / Add New' but it doesn't actually add one in this function. If bAutoUseScanned is True, then 'Use' will be automatic if a unique Scan Code is matched.  Returns the customer's record if one is selected to 'Use', or a Null record if the dialog is closed with Cancel.        

 

 

Function:FindCustomerByScanCode        
Result-type:Record        
Arguments:cSearchText [, bSelectIfMultiple]]        
Description:Searches for customer by the Scan Code passed, returns the customer found.  If more than one match is found, optionally open Find Customer to select one (else returns NullRecord if multiple found).        

 

 

Function:FindInventory        
Result-type:Record        
Arguments:[cSearchText]        
Description:Opens the Find Inventory Item dialog, optionally with starting Search Text. Returns the item's record if one is selected to 'Use', or a Null record if the dialog is closed with Cancel.        

 

 

Function:FindReservation        
Result-type:Record        
Arguments:[cFilterBy [, cSearchText [, bAutoUseScanned[, bAutoUseTransMasters ] ]]]        
Description:Opens the Find Reservation dialog, optionally with a starting Filter By selection and Search Text (note that the Filter By argument must exactly match the selection in the dialog's drop-down list).  If bAutoUseScanned is True, then 'Use' will be automatic if a unique Scan Code is matched. Optionally only consider Transaction Masters for Auto-Use.  Returns the reservation's record if one is selected to 'Use', or a Null record if the dialog is closed with Cancel.        

 

 

Function:FindVendor        
Result-type:Record        
Arguments:[cFilterBy [, cSearchText [, bCancelAdds]]]        
Description:Opens the Find Vendor dialog, optionally with a starting Filter By selection and Search Text (note that the Filter By argument must exactly match the selection in the dialog's drop-down list). If bCancelAdds is True, then the Cancel button shows 'Cancel / Add New' but it doesn't actually add one in this function. Returns the vendor's record if one is selected to 'Use', or a Null record if the dialog is closed with Cancel.        

 

 

Function:FtpUploadFile        
Result-type:Boolean        
Arguments:cFile, cServer, cRemoteDir, cUser, cPassword, nPort, bPassive [, bShowProgress [, bShowPrompts [, bSSL [, bSSLImplicit [, bSSH]]]]]        
Description:Uploads a file to an FTP server.  Defaults are to show progress dialog (bShowProgress=.T.) and show any error prompts (bShowPrompts=.T.)  The return value indicates whether it was successful.        

 

 

Function:GetFormSubjectForRecord        
Result-type:Text        
Arguments:cFormName, rRecord        
Description:Gets the 'Subject' for the given named form, for the given record. The Printer type for the form must be 'Text output (or E-mail)', for instance an E-mail type form, and the form must have the 'Subject expression' filled in (or else the result is blank).        

 

 

Function:GetFormTextForRecord
Result-type:Text        
Arguments:cFormName, rRecord [, nWhat[, dStarting[, bShowPrevious [,dEnding ]]]]        
Description:Gets the formatted text for the given named form, for the given record.  If the Form Type is not E-mail or Text Message, then the Printer Type must be 'Text output (or E-mail)'.  Optionally include print-some options: 0=All, 1=new, 2=since zero bal, 3=since zero or credit bal, 4=since date, 5 = between dates.  If since date or between dates, starting date must be included.  If between date, ending date must be included.  Can also set bShowPrevious for whether Previous Balance and Balance Due is shown (defaults to True).

 

 

Function:GetStatusBarText        
Result-type:Text        
Arguments:(none)        
Description:Gets the current text on the program's Status Bar.        

 

 

Function:IsAnyDialogOpen        
Result-type:Boolean        
Arguments:(none)        
Description:Returns True if there are any dialog windows or message prompt windows open. This can be used to determine whether the user is in the middle of something, or the system is waiting for the user to respond.        

 

 

Function:LogIn        
Result-type:Boolean        
Arguments:cOperator, cPassword        
Description:Log in with the specified operator name and password. Returns True if the login was successful        

 

 

Function:LogOut        
Result-type:Boolean        
Arguments:(none)        
Description:Log out any current operator. Returns True if there was a previous operator logged in.        

 

 

Function:MenuCommand        
Result-type:Boolean        
Arguments:nCommandID        
Description:Execute a main menu command, as if the operator selected it. Note that operator level and other authorization level checking may or may not be performed, so use this function cautiously. Also note that menu commands are numeric command IDs, which could change in future versions. This function won't return until the command is complete, and the return value is always True.  You can find the command values in the Expression builder (e.g. Insert Expression Element) -- select Fixed List Values, Menu Command Values.        

 

 

Function:MessageBox        
Result-type:Numeric        
Arguments:cMessage [, nButtons [, nIcon]]        
Description:Shows a message in a prompt window. The nButtons parameter can be 0 for OK, 1 for OK & Cancel, 2 for Yes & No, or 3 for Yes, No, & Cancel. The nIcon parameter can be 0 for none, 1 for Warning/Exclamation, 2 for Error/Stop, or 3 for Information. Returns the button clicked : 0 = Cancel, 1 = OK, 2 = Yes, 3 = No.        

 

 

Function:OpenCashDrawer        
Result-type:Boolean        
Arguments:(none)        
Description:Opens the cash drawer, if present. Returns True if the drawer is present and there are no errors.        

 

 

Function:PointOfSaleEntry        
Result-type:Boolean        
Arguments:rRecord        
Description:Opens the Point of Sale dialog, optionally using the transaction record passed as the transaction/receipt to edit. Returns FALSE if the dialog is closed without changes, or returns TRUE if changes are made.        

 

 

Function:PointOfSaleEntryCust        
Result-type:Boolean        
Arguments:rRecord        
Description:Opens the Point of Sale dialog for the designated customer. Transactions will be added to the customer, and don't necessarily need to be paid. Returns FALSE if the dialog is closed without changes, or returns TRUE if changes are made.        

 

 

Function:PointOfSaleEntryResv        
Result-type:Boolean        
Arguments:rRecord        
Description:Opens the Point of Sale dialog for the designated reservation. Transactions will be added to the reservation, and don't necessarily need to be paid. Returns FALSE if the dialog is closed without changes, or returns TRUE if changes are made.        

 

 

Function:PrintFormForRecord        
Result-type:Boolean        
Arguments:cFormName, rRecord, bPreview, bShowDialog[, nWhatToPrint[, dStarting[, bShowPrevious [, dEnd ]]]]        
Description:Prints the given named form for the given record.  Must indicate whether a Print Preview window is shown and whether a Printer Setup dialog is shown before printing.  You may also specify what transactions to print: 0=All, 1=New (most recent), 2=unbalanced (since last 0 balance), 3=unpaid (since last 0 or credit balance), 4=since date (also must specify the starting date), 5=between dates (specify start and end dates). Can also set bShowPrevious for whether Previous Balance and Balance Due is shown (defaults to True).

 

 

Function:PrintFormForThisList        
Result-type:Boolean        
Arguments:cFormName, bPreview, bShowDialog[, nWhatToPrint[, dStarting[, bShowPrevious [, dEnd ]]]]        
Description:Prints the given form for the record list in the current context (e.g. ThisListRec/Count).  Must indicate whether a Print Preview window is shown and whether a Printer Setup dialog is shown before printing.  You may also specify what transactions to print: 0=All, 1=New (most recent), 2=unbalanced (since last 0 balance), 3=unpaid (since last 0 or credit balance), 4=since date (also must specify the starting date), 5=between dates (specify start and end dates).  Can also set bShowPrevious for whether Previous Balance and Balance Due is shown (defaults to True).        

 

 

Function:QueueEmail        
Result-type:Boolean        
Arguments:cFromName, cFromAddress, cToName, cToAddress, cSubject, cBody [,cFile, bFixedPitch, cCC, cBCC, fSkipAutoBCC, rRecord]        
Description:Queues up an E-mail message for batch sending, using the internal SMTP functionality.  The Online Setup for the SMTP settings must be configured and enabled.  If the From name & address are blank, it will use the defaults from the SMTP settings.  Optionally can include one or more file attachments (the full path must be specified for each -- use the '|' character between multiple file names).  The return value indicates whether it was queued successfully.  Use ResetEmailQueue() before sending, and SendQueuedEmails() to initiate the batch sending after all E-mails are queued.  An optional record can be supplied so that any audit trail entry generated appears in that record's audit trail.        

 

 

Function:QueueText        
Result-type:Boolean        
Arguments:cToPhone, cBody [,rRecord]        
Description:Queues up a text message for batch sending.  The Text Messaging Setup must be configured and enabled.  The return value indicates whether it was queued successfully.  Use ResetTextQueue() before sending, and SendQueuedTexts() to initiate the batch sending after all messages are queued.  An optional record can be supplied so that any audit trail entry generated appears in that record's audit trail.        

 

 

Function:ResetEmailQueue        
Result-type:Boolean        
Arguments:(none)        
Description:Resets the Batch E-mail queue.  For use with QueueEmail() and SendQueuedEmails() functions.  Return value is always True.        

 

 

Function:ResetTextQueue        
Result-type:Boolean        
Arguments:(none)        
Description:Resets the Batch Texting queue.  For use with QueueText() and SendQueuedTexts() functions.  Return value is always True.        

 

 

Function:

ResvAddGuest

Result-type:

Boolean

Arguments:

rReservation

Description:

Performs the 'Add a Guest to this Reservation' function on the specified reservation, as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvAddNewMaster

Result-type:

Boolean

Arguments:

rReservation

Description:

Performs the 'Add New Linked Master reservation' function on the specified reservation, as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvAddNonSynced

Result-type:

Boolean

Arguments:

rReservation

Description:

Performs the 'Add Non-Synchronized reservations' function on the specified reservation, as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvAddSubmember

Result-type:

Boolean

Arguments:

rReservation

Description:

Performs the 'Add Sub-member reservations' function on the specified reservation, as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvAddSynced

Result-type:

Boolean

Arguments:

rReservation

Description:

Performs the 'Add Synchronized reservations' function on the specified reservation, as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvAssignSite

Result-type:

Boolean

Arguments:

rReservation

Description:

Performs the 'Assign or Change Site' function on the specified reservation, as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvCancel

Result-type:

Boolean

Arguments:

rReservation

Description:

Performs the 'Cancel Reservation' function on the specified reservation (or change cancel reason, if already canceled), as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvChangeCustomer

Result-type:

Boolean

Arguments:

rReservation

Description:

Performs the 'Change Customer' function on the specified reservation, as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvCheckIn

Result-type:

Boolean

Arguments:

rReservation

Description:

Performs the 'Check In' function on the specified reservation, as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvCheckOut

Result-type:

Boolean

Arguments:

rReservation

Description:

Performs the 'Check Out' function on the specified reservation, as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvConfirm

Result-type:

Boolean

Arguments:

rReservation

Description:

Performs the 'Confirm Reservation' function on the specified reservation, as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvEmailCustReceipt

Result-type:

Boolean

Arguments:

rReservation

Description:

Performs the 'E-mail Customer Form' function on the specified reservation, as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvEmailReceipt

Result-type:

Boolean

Arguments:

rReservation

Description:

Performs the 'E-mail Reservation Receipt or other Form' function on the specified reservation, as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvGuarantee

Result-type:

Boolean

Arguments:

rReservation

Description:

Performs the 'Guarantee Reservation' function on the specified reservation, as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvLinkAsNonSynced

Result-type:

Boolean

Arguments:

rReservation

Description:

Performs the 'Link this reservation to another, as Non-Synchronized' function on the specified reservation, as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvLinkAsSubMember

Result-type:

Boolean

Arguments:

rReservation

Description:

Performs the 'Link this reservation to another, as Sub-member' function on the specified reservation, as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvLinkAsSynced

Result-type:

Boolean

Arguments:

rReservation

Description:

Performs the 'Link this reservation to another, as Synchronized' function on the specified reservation, as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvNewBlockDate

Result-type:

Boolean

Arguments:

rReservation, dDate [, nPeriod]

Description:

Performs the 'This is New Blocked Date' function on the specified reservation, on the specified date (optionally with schedule period), as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvNewLastDate

Result-type:

Boolean

Arguments:

rReservation, dDate [, nPeriod]

Description:

Performs the 'This is New Last Date' function on the specified reservation, on the specified date (optionally with schedule period), as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvNewStartDate

Result-type:

Boolean

Arguments:

rReservation, dDate [, nPeriod]

Description:

Performs the 'This is New Start Date' function on the specified reservation, on the specified date (optionally with schedule period), as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvPrintCustEnvelope

Result-type:

Boolean

Arguments:

rReservation

Description:

Performs the 'Print Customer Envelope or Form' function on the specified reservation, as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvPrintCustReceipt

Result-type:

Boolean

Arguments:

rRecord

Description:

Performs the 'Print Customer Receipt' function on the specified reservation or customer record, as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvPrintReceipt

Result-type:

Boolean

Arguments:

rReservation

Description:

Performs the 'Print Reservation Receipt or Form' function on the specified reservation, as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvQuickInfoText

Result-type:

Text

Arguments:

rReservation, dDate [, nPeriod]

Description:

Gets the default Quick-Info window text for the specified Reservation, on the specified date (optionally with schedule period).

 

 

Function:

ResvRemoveBlockDate

Result-type:

Boolean

Arguments:

rReservation

Description:

Performs the 'Remove Blocked Dates' function on the specified reservation, as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvShowConflicting

Result-type:

Boolean

Arguments:

rReservation

Description:

Performs the 'Show Conflicting Reservations' function on the specified reservation, as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvSplitAtDate

Result-type:

Boolean

Arguments:

rReservation, dDate [, nPeriod]

Description:

Performs the 'Split Reservation at this date' function on the specified reservation, on the specified date (optionally with schedule period), as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvTextForm

Result-type:

Boolean

Arguments:

rReservation

Description:

Performs the 'Send a Text Message to the customer' function on the specified Reservation, as from the right-click menus, showing the dialog to select a Form (or use free-form text of preferred).  Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

ResvTipText

Result-type:

Text

Arguments:

rReservation

Description:

Gets the default mouse-over tip text for the specified Reservation

 

 

Function:

SaveDatabase

Result-type:

Boolean

Arguments:

(none)

Description:

Saves the database (making sure all changes are broadcast to other workstations and saved to log, etc.). Return value is always True

 

 

 

Function:SendEmail        
Result-type:Boolean        
Arguments:bPreview, cFromName, cFromAddress, cToName, cToAddress, cSubject, cBody [,cFile, bFixedPitch, cCC, cBCC, fSkipAutoBCC]        
Description:Sends an E-mail message, using the internal SMTP functionality.  The Online Setup for the SMTP settings must be configured and enabled.  If the bPreview flag is set, the message will be shown in a window first, where it can be edited.  If the From name & address are blank, it will use the defaults from the SMTP settings.  Optionally can include one or more file attachments (the full path must be specified for each -- use the '|' character between multiple file names).  The return value indicates whether it was successful.

 

 

Function:SendEmailForRec        
Result-type:Boolean        
Arguments:rRecord, bPreview, cFromName, cFromAddress, cToName, cToAddress, cSubject, cBody [,cFile, bFixedPitch, cCC, cBCC, fSkipAutoBCC]        
Description:Sends an E-mail message, using the internal SMTP functionality.  This version includes the record you're sending it for, so it will appear in that record's Audit Trail. The Online Setup for the SMTP settings must be configured and enabled.  If the bPreview flag is set, the message will be shown in a window first, where it can be edited.  If the From name & address are blank, it will use the defaults from the SMTP settings.  Optionally can include one or more file attachments (the full path must be specified for each -- use the '|' character between multiple file names).  The return value indicates whether it was successful.

 

 

Function:SendMessageToWorkstation        
Result-type:Boolean        
Arguments:nWorkstationID, cText        
Description:Sends a text message to the designated workstation.  This is primarily for custom use -- by default, the message is simply displayed as a pop-up, however you can also intercept it to create custom functionality using an Event Action ("Network Text Message Received" -- the sending WS will be in ThisValue(), the message will be in ThisTextValue() ).

 

 

Function:SendPoleDisplayCommand        
Result-type:Boolean        
Arguments:cCommand        
Description:Sends a command to the Pole Display, if present (Point of Sale option required). The command string must include any control sequences necessary, as 'escape' values like -. Returns True if no errors occur and the pole display is enabled.        

 

 

Function:SendQueuedEmails
Result-type:Boolean        
Arguments:bSkipAuditTrail        
Description:Sends the Queued E-mails, using normal Batch E-mail settings for the number to send at a time and pausing between sub-batches.  Resets the Batch E-mail queue after sending, whether it's successful or not.  For use with the QueueEmail() function.  Return value indicates whether all were sent successfully. There is no information about which ones were sent successfully, if any, if there is an error.  Can optionally skip adding each one to the audit trail.        

 

 

Function:SendQueuedTexts
Result-type:Boolean        
Arguments:bSkipAuditTrail        
Description:Sends the Queued Text messages, using normal Batch Texting settings for the number to send at a time and pausing between sub-batches.  Will remove all sent messages from the Queue.  If some are not sent (canceled or error), it will ask whether to leave them in the queue or not (call this function again to continue sending).  For use with the QueueText() function.  Return value indicates whether all were sent successfully.  Can optionally skip adding each one to the audit trail.        

 

 

Function:SendText        
Result-type:Boolean        
Arguments:bPreview, cToPhone, cBody        
Description:Sends a text message.  The Text Messaging Setup must be configured and enabled.  If the bPreview flag is set, the message will be shown in a window first, where it can be edited.  The return value indicates whether it was successful.

 

 

Function:SendTextForRec        
Result-type:Boolean        
Arguments:rRecord, bPreview, cToPhone, cBody        
Description:Sends a text message.  The Text Messaging Setup must be configured and enabled.  This version includes the record you're sending it for, so it will appear in that record's Audit Trail. If the bPreview flag is set, the message will be shown in a window first, where it can be edited.  The return value indicates whether it was successful.

 

 

Function:SetStatusBarText        
Result-type:Boolean        
Arguments:cText        
Description:Sets the text on the program's Status Bar. If cText is blank, sets the default text (e.g. 'For Help, press F1'). Always returns True.        

 

 

Function:ShellExecute        
Result-type:Boolean        
Arguments:cOperation, cFile, cParams, cDir        
Description:Uses the system 'ShellExecute' function to open a document, execute a program, explore a folder or other functions. See Windows development specifications for details.        

 

 

Function:ShowDataFields        
Result-type:Boolean        
Arguments:cTableName
Description:Opens a Data Field Definitions dialog for the given table.  Return value is always True -- always assume changes could have been made.        

 

 

Function:ShowQuery        
Result-type:Record        
Arguments:cQueryName [, dStart [, dEnd[, cSearch[, bUseDates[, bAsSearch]]]]]        
Description:Shows a query in a dialog window, with optional start & end dates and search text.  If you don't want From & To date selections on the dialog, set bUseDates to False (dStart and dEnd will still be used for the query, but the user won't be able to change them).  If you want the query to operate like a Search function and return the record by the user, then set bAsSearch to True.  The return value will be the record selected from the query list (or it will be a Null record if it was canceled or if bAsSearch is False).        

 

Function:ShowRawData        
Result-type:Boolean        
Arguments:cTableName [, bAdd [, bSort [, bMove [, bDelete [, bShowLinksAsIndex [, bPickList]]]]]]        
Description:Opens a Raw Data Tables dialog for the given table.  Optionally allow adding, moving, sorting or deleting records in the table (all options default to False if not provided).  If it's a Pick List, set bPickList.  Can also show allow showing links as index values instead of the relative text.  Return value is True if data changes have been made.        

 

 

Function:ShowRecordList        
Result-type:Boolean        
Arguments:cTableName, cFieldList [, bAllowAdd [, bAllowDelete]]        
Description:Opens a 'Setup' type dialog for the given table, showing a list of records in the table and allowing adding/editing/deleting/etc.  Must also provide a list of Field ID's to show in the list (comma-separated text ID's). Set bAllowAdd to allow adding new ones, and bAllowDelete to allow deleting records.   In order to Edit a record in the list, an "Edit Generic Record" Add-on type Dialog Definition must exist for the record (table) type.  Return value is True if any data changes have been made.        

 

 

Function:

ShowUnassignedForDate

Result-type:

Boolean

Arguments:

dDate

Description:

Performs the 'View Unassigned reservations for this date' function on the specified date, as from the right-click menus, with all appropriate validations and prompts. If site is available, will make it unavailable, and vice versa. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

SiteAdvanceNext

Result-type:

Boolean

Arguments:

rSite, dDate [, nPeriod]

Description:

Performs the 'Advance Next Reservation to this date' function on the specified site on the specified date (optionally with schedule period), as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

SiteBlockPrevious

Result-type:

Boolean

Arguments:

rSite, dDate [, nPeriod]

Description:

Performs the 'Block Previous Reservation to this date' function on the specified site on the specified date (optionally with schedule period), as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

SiteChangeAvailable

Result-type:

Boolean

Arguments:

rSite, dDate

Description:

Performs the 'Make Site Available (or Unavailable) this date' function on the specified site on the specified date, as from the right-click menus, with all appropriate validations and prompts. If site is available, will make it unavailable, and vice versa. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

SiteChangeDirty

Result-type:

Boolean

Arguments:

rSite

Description:

Performs the 'Site Is Dirty/Clean' function on the specified site, as from the right-click menus, with all appropriate validations and prompts. If currently Dirty, makes it Clean, and vice versa. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

SiteExtendPrevious

Result-type:

Boolean

Arguments:

rSite, dDate [, nPeriod]

Description:

Performs the 'Extend Previous Reservation to this date' function on the specified site on the specified date (optionally with schedule period), as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

SiteFindReservations

Result-type:

Boolean

Arguments:

rSite

Description:

Performs the 'Find all Reservations for this site' function on the specified site, as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

SiteQuickInfoText

Result-type:

Text

Arguments:

rReservation [, dDate]

Description:

Gets the default Quick-Info window text for the specified Site, (optionally on a particular date).

 

 

Function:

SiteShowResvsForDates

Result-type:

Boolean

Arguments:

rSite, dFromDate, dToDate

Description:

Performs the 'Multiple Reservation Details' function on the specified site for the specified date range, as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:

SiteTipText

Result-type:

Text

Arguments:

rSite

Description:

Gets the default mouse-over tip text for the specified Site

 

 

Function:

SiteWorkOrders

Result-type:

Boolean

Arguments:

rSite

Description:

Performs the 'Site work orders' function on the specified site, as from the right-click menus, with all appropriate validations and prompts. Returns FALSE if error or if the function is closed without changes, or returns TRUE if changes are made.

 

 

Function:StartNewReservation
Result-type:Record        
Arguments:rCustomer, rSite [, dFirstNight [, fLastNight]]        
Description:Start a new reservation (open New Reservation dialog), optionally providing the customer, site, first night and last night. The Site and/or Customer may be NullRecord() to start without a customer or site specified.  Returns the new reservation created, or NullRecord() if it was not created.        

 

 

Function:TimeLastDialogClosed        
Result-type:Date/Time        
Arguments:(none)        
Description:Returns the date and time that the last user-interface dialog was closed. This can be used to determine when the user was last doing something on the computer that required interaction.        

 

 

Function:TimeOfLastInput        
Result-type:Date/Time        
Arguments:(none)        
Description:Returns the date and time that the user last moved the mouse or closed a dialog. This can be used to determine when the user was last doing something on the computer.        

 

 

Function:ValidatePhoneNumberForTexting        
Result-type:Boolean        
Arguments:cText        
Description:Checks a phone number in cText for being properly formatted for texting according for Text Messaging Setup.  Returns FALSE if an error is found        

 

 

 

 


Page URL https://CampgroundMaster.com/help/userinteraction.html

Campground Master Home