Show/Hide Toolbars

Jim2® Business Engine Help File

Toolsglobalvar

 

A global variable is a variable that is accessed globally throughout the program. A group of global variables is called a global state or global environment because, when combined, they define various aspects of a program or the environment when the program runs. Once declared, they remain in memory throughout the runtime of the program. This means that they can be changed by any function at any point, and may affect the program as a whole.

 

Example

Jim2 has a unique way of including the company logo in selected reports without having to set it up within each report, or use expensive preprinted letterhead.

 

The position of the company logo is determined by global variables. Specify how many report units (millimetres) from the left edge of the report, and how many report units from the top of the report the logo is to be printed. Within the scripts there is a default position which is also documented in the comments of each variable. See ChequeRemittanceLogoLeft (highlighted in the image below).

 

Globalvariables

Not the full list is showing here. Comment explains the use of the global variable.

 

Following are some global variables explained more fully here.

 

Jim2 Global Variable

Type

Default Value

HideJimLogo

Boolean

False. If changed to True, this hides the Jim2 logo on reports.

InvoiceMasterForceBilledVisible

Boolean

False. If changed to True, this hides detailed pricing but displays price in the summary section on an invoice.

InvoiceMasterForceMeterGrouping

Boolean

False. If a machine or master (in Managed Print Services) is billed using meter kits, the invoice summary section of the invoice will use the same grouping as the jobs it contains. The summary will contain one line for black that contains details for both the black and black overs meter. If kitting is not used, each meter line will have its own summary.

 

If changed to True, grouping on the actual jobs is ignored. The grouping on the current meter setup is used to determine what summary sections will be displayed. Kitting on jobs is irrelevant. This will change the meter setup today, which will affect any invoice that was generated in the past.

UseInvoiceNoEmailFilename

Boolean

True. Overrides the PDF file name of the attached invoice with the company name and subject, or just the subject.

 

The following global variables can be used to make changes to statements:

 

Jim2 Global Variable

Type

Value

StatementHideDueNow

Boolean

True. If changed to False, Due Now will appear on statements.

StatementHideFullyPaidCurrent

Boolean

True. If changed to False, will show Fully Paid in Current.

StatementExcludePrepaymentsInDueNow

Boolean

True. If changed to False, prepayments will show in Due Now.

StatementHidePayments

Boolean

True. If changed to False, payments will not be hidden.

 

The following global variables can change current defaults on existing invoice and quote reports:

 

Jim2 Global Variable

Type

Value

InvoicePrice

string

PriceTP shows including GST. Change to TF to show excluding GST.

InvoiceShowDiscount

True

True. Change to False to turn off the Discount column on an invoice as well as a quote.

 

And here are a few other global variables that can be added to the database,:

 

Jim2 Global Variable

Type

Value

HideKitHeaderColumnNames

Boolean

True (by default the headers show – add this to hide kit header column names).

CubicWeightRate

float

250 (change this value to suit industry standard for cubic weight if it differs from 250 kilograms per cubic metre). The cubic weight is in kilograms and is calculated by measuring and multiplying the length, height and width of the parcel. The result is then multiplied by the industry standard cubic weight conversion factor of 250.

ReversePaymentsOnInvoiceUnprint

Boolean

False (set to True to always reverse payment on unprint invoice).

SuppressSQLVerMsg

Boolean

Set to True to suppress the SQL version warning message.

 

warning1

This variable may be removed by upgrades, and may need to be manually added again after an upgrade.

SuppressWindowsVerMsg

Boolean

Set to True to suppress the Windows version warning message.

 

warning1

This variable may be removed by upgrades, and may need to be manually added again after an upgrade.

JobPickingSlipHidecomments

Boolean

Set to False to hide job comments in Job – Picking Slip Report.

PostIntoFuturePeriods

Boolean

True. Opens new financial year.

 

Quality

This allows to temporarily trade for more than the 2 years allowed by Jim2. This is effectively bypassing Jim2's financial period date control, allowing users to post transactions into any financial year. It is strongly recommended that this global variable be deactivated as soon as possible to avoid this.

 

Further information

Add or Edit a Global Variable

Manage Report Behaviour with Global Variables

Hide Jim2 logo on reports