Configuring Document Footers

From NEOSYS User Support Wiki
Jump to navigationJump to search

List of macro variables available

The following codes are available:

  • %USERNAME% - of the user who created the document
  • %EMAIL% - of the user
  • %SIGNATURE% - shows the image file uploaded for the users signature if any
  • %USERCODE% - of the user
  • %AGENCY% - the "client mark" usually an abbreviated version of the NEOSYS licenced company name. Not client configurable. Refer Configuring Client Security mark
  • %COMPANY% - company name taken from the Company File.
  • %COMPANYCODE% - from the Company File. Useful for configuring logo per company/division (e.g. src=%COMPANYCODE%logo.jpg)
  • %DATE% - normally the date the document was actually created (user's local date)
  • %TIME% - similar to date
  • %WORKSTATION% - usually IP number.

The following obsolete codes are also supported for backward compatibility but should be replaced by the newer forms above where-ever possible.

  • %USER
  • %USERNAME
  • %AGENCY

While configuring footer for invoices of a company, use %COMPANY% instead of %AGENCY%, since %AGENCY% is the client security mark which is common to all or most companies. The client security mark shouldn't be used as company name as %AGENCY% may be present in many other configurations.

Configuring Document Footers with a Company Stamp/Signature (JPEG image)

Location of JPEG Images for Company Stamp/Signature

Make sure the JPEG image is located in the neosys/data/xxx folder (where "xxx" is the database code)

Single Company Installation

Invoice footer

In the Media / Job Configuration File, Scroll down to the Invoice Footer field under the Invoicing section and add the script

<img src = imagename.jpg></img> 

where "imagename.jpg" is the name of the JPEG image.


Note: While reprinting invoices, footers remain as they were when the invoice was created.

Booking Orders

In the "Media Types File", add a new line in the "Order Footer" and add the script

<img src = imagename.jpg></img> 

where "imagename.jpg" is the name of the JPEG image.


Multiple Company Installation

Invoice footer

In the Media / Job Configuration File, Scroll down to the Invoice Footer field under the Invoicing section and add the script

<img src = imagename%COMPANYCODE%.jpg></img> 

and "imagename%COMPANYCODE%" will be converted to "imagenameXYZ" where "XYZ" stands for the company code in capitals.

Booking Orders

In the "Media Types File", add a new line in the "Order Footer" and add the script

<img src = imagename%COMPANYCODE%.jpg></img> 

and "imagename%COMPANYCODE%" will be converted to "imagenameXYZ" where "XYZ" stands for the company code in capitals.

Configuring Personal Signatures (JPEG image) to appear on Document Footers

Users can configure their personal signatures on the USER FILE by uploading a JPEG image of the same as shown below :

User1.jpg


  1. Browse for the required file and click on upload:
    User2.jpg
  2. Once the desired file is uploaded successfully, a file upload summary would be displayed as follows :
    User3.jpg
  3. Once you close the file upload summary, you would see a preview of the uploaded JPEG image.
    User4.jpg
  4. If you would like to delete the uploaded image, click the "Delete" button to do so.
  5. To replace the uploaded image with a new one, you may simply click "Upload" and upload a new image which would overwrite the previous one.

General Guidelines for uploading Signature Image Files

To ensure that the signature appears correctly on NEOSYS documents, the following guidelines must be followed:

  1. Signature image files should be scanned at 96 dpi for proper alignment on documents
  2. Avoid margins / white spaces around the image i.e. the free blank space around the signature should be cropped out using MS Paint or similar software

Procedure for cropping signature image files in Microsoft Paint

  1. Open the Signature image file in Paint.
    ( Right click on the image file -> Open with -> Paint )

    Mspaint-1.jpg

  2. Click on the Select Button and select the "Rectangular Selection" option

    Mspaint-2.jpg

  3. Using the mouse pointer, select only the signature part of the image avoiding unnecessary white spaces and click on CROP

    Mspaint-3.jpg

  4. Now, click on Resize -> Pixels and enter the appropriate dimensions and click on OK

    Mspaint-3b.jpg

  5. Save the image (Control + S)
  6. Exit Paint application
  7. Open/View the image. It should be cropped now :
    Cropped Signature Image File