Parent | Child | Previous | Next

REPORT.FAX Function

Syntax

Return as P = Report.Fax(C LayoutName [,C Filter [,C Order ,P Options ]])

Arguments

LayoutName

The name of the report to fax.

Filter

Optional. Default = ".T." (All records). A character filter expression that evaluates to a logical value and selects records for the report.

Order

Optional. Default = record order. A character order expression that sorts selected records.

Options

A dot variable containing required and optional information for the Fax Service.

Argument: Required? and Description
FaxNumber: The fax number to dial. Character Type. Required.
RecipientName: The recipient's name. Character. Required.
HasCoverPage: "Yes", "No". Character. Not Required.
CoverPage: Path and filename of cover page file. Character. Not Required.
CvrPageSubject: Message subject. Character. Not Required.
CvrPageNote.: Message note. Character. Not Required.
QueueFax: "Yes", "No". Character. Required.
SenderName: Sender's name. Character. Not Required.
SenderCompany: Sender's company. Character. Not Required.
SenderAddress: Sender's address. Character. Not Required.
SenderTitle: Sender's title. Character. Not Required.
SenderDepartment: Sender's department. Character. Not Required.
SenderOffice: Sender's office. Character. Not Required.
SenderHomePhone: Sender's home phone. Character. Not Required.
SenderOfficePhone: Sender's office phone. Character. Not Required.
SenderFax: Sender's fax. Character. Not Required.
BillingCode: Billing code. Character. Not Required.

Returns

ReturnPointer: A dot variable that contains the .Error.text element.

Description

Generates a report and adds it to the Windows Fax Service queue.

Discussion

The REPORT.FAX() method generates a report and queues it for fax transmission by the Windows Fax Service. Note : The fax driver first creates a PDF file, then faxes the PDF image. Because Adobe Acrobat is used to create the PDF file, the REPORT.FAX() method exposes a bug that leaves Adobe Acrobat running after the fax transmission.

Example

Dim return as P
Dim FaxOptions as P
FaxOptions.FaxNumber = "916032510721"
FaxOptions.RecipientName = "Pawan Deshpande"
FaxOptions.RecipientCompany = "Alpha Software, Inc"
FaxOptions.HasCoverPage = "yes"
FaxOptions.CoverPage = "C:\Documents and Settings\AllUsers.WINNT\Documents\My Faxes\Common Coverpages\urgent.cov"
FaxOptions.CvrPageSubject = "Hello World"
FaxOptions.CvrPageNote = "This is the note text"
'FaxOptions.QueueFax = "no"
' Billing Code is an optional parameter
FaxOptions.BillingCode = ""
return = Report.Fax("report1","","",FaxOptions)
if return.Error.text  "" then
    ui_msg_box("Error",return.Error.text)
end if