FAX Header

A fax header provides information required to send a fax such as the telephone number of the recipient's fax machine. A header specified in the Fax Header field serves as a template for actual fax headers; the template can contain keywords that TaskMan replaces with specific values at run time. For example, when you send a fax of a packing slip to a customer, the keyword BG~FAXNUM~ is replaced with the customer's fax telephone number specified in the Destination field on the Customer Document Profile form for the customer and the Packing Slip task.

These substitution keywords are available:

  • BG~ERRFILE~: A file in which any error messages are recorded. The keyword applies only to Windows Fax and Infor Framework Fax Service. Error messages are added to the end of the file if it exists; otherwise, the file is created. The content of the file is copied into the Background Task History record for the report task.
  • BG~FAXNUM~: The telephone number of the fax machine to which the document is sent. The keyword is replaced with the number specified in the Destination field on the Customer Document Profile form or the Vendor Document Profile form.
  • BG~FAXSERVER~ The name of the fax server machine. The keyword applies only to Windows Fax and Infor Framework Fax Service. If BG~FAXSERVER~ is omitted from a fax header or if the Fax Server field on the Intranets form is blank, then the default fax server name at run time is as follows:
    • If Windows Fax is configured, then the server name is the name of the TaskMan machine. Windows Fax uses a modem on the TaskMan machine.
    • If Infor Framework Fax Service is used, the server name is the name of the machine on which the service runs.
  • BG~FAXTOCOMPANY~: The name of the company to which the fax is sent; the name is printed on the fax cover sheet. The keyword is replaced with the name specified in the Cover Sheet Company field on the Customer Document Profile form or the Vendor Document Profile form. The keyword does not apply to Windows Fax and Infor Framework Fax Service.
  • BG~FAXTONAME~ The name of the individual to whom the fax is sent; the name is printed on the fax cover sheet. The keyword is replaced with the name specified in the Cover Sheet Contact field on the Customer Document Profile form or the Vendor Document Profile form. The keyword does not apply to Infor Framework Fax Service.
  • BG~OUTPUTFILE~ The report output file created in the directory <TaskMan_Directory>\Report\OutputFiles\<user> on the TaskMan machine. With Infor Framework Fax Service, the file is accessed directly from this directory. Third-party software may access it differently.

    To code line breaks in a fax header, use " \n"; TaskMan replaces " \n" with a new line. The leading blank space is required.

Fax Service Sample Fax Headers Using Keywords
Windows Fax -d " BG~OUTPUTFILE~" -n BG~FAXNUM~ -f " BG~ERRFILE~"

 Quotation marks are required around keywords whose values may contain a space.

Infor Framework Fax Service SendFax.exe -d " BG~OUTPUTFILE~" -n BG~FAXNUM~ -f " BG~ERRFILE~" -s "BG~FAXSERVER~"

Quotation marks are required around keywords whose values may contain a space.

Third-party software You can include other parameters specific to third-party software. However, only the fax number, contact name, company name, and output-file name can be set at run time by the system. Other parameter values must be hard-coded in the fax header.