Program Report Text Import

Reference Contents > Advanced Functions > Program Report Text Import

This window is opened by operating the Load tool on the Program Maintenance Reports Toolbar toolbar on the Program Faults, Feature Enhancements, Requests and Reports Maintenance window.

It enables you to load a record from a text version, typically from the body of an email.

Button	Action
Load into Maintenance Window	After pasting in a report text to the field above, click to parse the data and load into the maintenance window.

See also: –

Program Faults, Feature Enhancements, Requests and Reports Maintenance Program Maintenance Reports Toolbar

Compiled in Program Version 5.10. Help data last modified 20 Oct 2001 21:53:00.00. Class wBugText last modified 18 Feb 2015 01:54:36.

Reference Contents > Advanced Functions > Program Report Text Import

The post Advanced Functions: Program Report Text Import appeared first on Caliach.

SQL Statement Manager

Reference Contents > Advanced Functions > SQL Statement Manager

The SQL Statement Manager window allows you to inspect and add SQL objects in the Extras/Statements.db database. This objects include Dynamic Queries, Sort Sets, Where Shortcuts, Join Shortcuts and Statement Shortcuts. They are are processed by Caliach Vision when running reprots for example and they are done in this way so they can be witten differently for alternative server engines to do the thing which may involve different syntax for different SQL dialects.

TIP: This window requires a large display to function . If you don’t have one, you should.

WARNING: This window does not operate in a typical manner with a Save and Revert button. Any changes are applied immediatly to Statements.db on leavind the field.

Common to all tab panes on the window are the following:

Button	Action
Add	Add a duplicate of the object. You will be asked to enter a new unique name that can not start with Cal_ which is reserved for Caliach.
Delete	Delete the object and all its components.
Rename	Click to rename the object. You will be prompted for a new unique name that can not start with Cal_ which is reserved for Caliach.

The window has 3 tab panes.

Dynamic Queries 
Sort Sets 
Shortcuts 

Dynamic Queries

Dynamic queries provide the main mechanism for constructing SQL select statements for collecting data from the database. They are typically used in selection windows.

The following make up the Select Statement constructions.

Button	Action
Test Build and DB Prepare	This tests the normal build process and then a prepare of the resulting SQL and reports the results. NOTE: This prepare is applied to current main database connection and NOT the database backend selected on the right.

Back to top

Sort Sets

Sort Sets are definitions for the ordering of data and it’s presentation on reports, etc.

Field	Description
Sort sets	List of all defined Sort Sets, typically for report selection windows.
Name	The name of the sort sets.
Description	A description for the sort sets.
Message	If a messege is entered the sort set will not be used. Instead, this message will be displayed. This is used to disable sort sets until problems are resolved.
Sort options list	List of options for the selected sort set. Select to maintain details on the right.
Sort Option Details	Each sorting alternative has SQL parts to it and report sort parts to it so that the data is returned from the server in an appropriate order and that the report is set to recognise this for subtotalling.
Description	A description for the sort set option that will be used on reports.
Order By clause	The ORDER BY clause without the ORDER BY keyword.
Comments	Programmer comments.
Order	The order of the sort column.
Column	The sort column name.
Descending	In descending order by default.
Uppercase	Sort by uppercase characters.
New page	New page on reports when subtotal changes.
Subtotal	Subtotal on reports when column value changes.

Back to top

Shortcuts

Named standard shortcuts for where clauses, join clauses and full SQL statements.

There are 4 sections to this tab pane.

Where Shortcuts

Join Shortcuts

Join Shortcuts substitute into FROM clauses to a SQL statement.

Statement Shortcuts

Statement Shortcuts are complete SQL statements.

Button	Action
Test Build and DB Prepare	This tests the normal build process and then a prepare of the resulting SQL and reports the results. NOTE: This prepare is applied to current main database connection and NOT the database backend selected on the right.

Special Functions

Field	Description
Start from date and time	The starting date time that synchronisation data will be collected.

Button	Action
Export	Click to Export all data to an XML file.
Re-Organise and Analyse	Runs a routine to seek out lost orphans and remove them, check and correct synchronisation columns and then analyze the database.
Build Sync Data	Builds a syncronisation table from the date and time entered.

Back to top

Compiled in Program Version 5.10. Help data last modified 6 Jan 2015 06:46:48.00. Class wSqlStateMng last modified 2 Oct 2017 04:24:20.

Reference Contents > Advanced Functions > SQL Statement Manager

The post Advanced Functions: SQL Statement Manager appeared first on Caliach.

Program Faults, Feature Enhancements, Requests and Reports Maintenance

Reference Contents > Advanced Functions > Program Faults, Feature Enhancements, Requests and Reports Maintenance

This feature enables you to review and maintain report records on the program and send them directly to Caliach Support by email.

You can report faults that you believe exist in the program or put forward enhancements that you think would improve your ability to use the program effectively.

This feature also allows you to review the current status of reports, faults fixed and feature enhancements made. To do this the WishBugs.bug file must be in the Custom directory of your Caliach Vision installation. When you Upgrade via the Internet using the Change Management System Upgrade via the Internet window, you have the option to download the latest official datafile.

When you make a report, particularly if it is believed to be a program fault, you should put down as much detail as possible including the sequence of events and data that lead to the circumstances that you find inappropriate. A fault cannot be acknowledged by engineers unless they can reproduce the problem. So sufficient information must be provided to do this. Saying something like “XXX doesn’t work’ is insufficient.

To maintain or review the date use the Program Maintenance Reports Toolbar toolbar tool functions.

Button	Action
Revert to Saved	To revert any changes to the previously saved version.
Save as Shown	To save the changes you have made to the data file.

See also: –

Program Maintenance Reports Toolbar

Compiled in Program Version 5.10. Help data last modified 4 Jun 2012 04:47:00.00. Class wBugWish last modified 10 Oct 2017 11:48:00.

Reference Contents > Advanced Functions > Program Faults, Feature Enhancements, Requests and Reports Maintenance

The post Advanced Functions: Program Faults, Feature Enhancements, Requests and Reports Maintenance appeared first on Caliach.

String Maintenance

Reference Contents > Advanced Functions > String Maintenance

Throughout Caliach Vision text is embedded in the program code. Text is used for three particular uses:
1. Messages accompanied by an OK button or Yes and No buttons or Working messages that tell you that a list is being built, a report printed, etc.
2. Text that are either placed into Caliach Vision data field values or are used in reports or other responses to actions the program makes.
3. Help or reference texts that relate to some program function E.g. Custom G/L Report methods.

Normally these texts would be written in to the program code. However, Caliach have removed them to allow the user the ability to change the wording and to provide for language variants. The term string refers to a string of characters. Most characters in the keyboard set are permissible, but some have special significance.

Caliach Vision MUST have access to the string data file Strings.stb which must be in the Extras directory.

The data file is a normal special lookup data file with a single data list within it. Each individual String record has an identification code which is used by the program to reference the line and extract the text stored. With ordinary string functions such as $ctask.tEnv.$Str(), messages, etc. the string number is in the range 10000 through 19999 which is converted to a string code of s0000 through s9999.

The string interpretation functions within Caliach Vision operate a parameter substitution standard that will embed data into the string at an appropriate place. Placeholders are embedded in the strings and take the form of %1, %2, up to %6. So the string with text “Downloading file %1” may evaluate to “Downloading file ftp.caliach.com/Internet/ftp/support/Vision/Updates/V101/ProgCode.upt” when it is displayed to the user.

The Maintenance window lists all strings. You can edit each one within the list by selecting the line, then clicking and pausing in the text column. The toolbar provides full functionality. (See the toolbar help for instructions.)

TIP: To edit cells in the list, select the line and click in the cell and hover the mouse over the cell. I.E. click once and pause with no mouse movement. The cell will then expand into an editable box in which you can enter different data. On leaving the box with any action like a tab or click elsewhere, the data is verified and the list returns to normal with the new data shown in the cell.

See also: –

String Maintenance Toolbar

Compiled in Program Version 5.10. Help data last modified 24 Apr 2012 10:29:00.00. Class wStringMaint last modified 27 Sep 2017 03:42:36.

Reference Contents > Advanced Functions > String Maintenance

The post Advanced Functions: String Maintenance appeared first on Caliach.

Change Management System Upgrade via the Internet

Reference Contents > Advanced Functions > Change Management System Upgrade via the Internet

With this function you can directly download the latest maintenance release Change Management System file from Caliach’s secure internet server using FTP.

FTP is File Transfer Protocol and uses the internet to move files from a server to a client and visa versa. FTP services are built in to Omnis Studio.

To operate this you need to enter the username and password you have chosen when registering your license with Caliach. You can save your username in the Company Details Maintenance window Others tab pane.

To operate this feature enter your username and password which is case-sensitive and click on the button. You may wish to choose alternative options to the default. If you are permanently connected to the internet, the transfer will start immediately, if not your computer’s internet dial-up will be initiated.

Button	Action
Download Upgrade	Initiates the download. If files already exist you will be warned and offered the opportunity to cancel.

See also: –

Change Management System Class Mover Program Faults, Feature Enhancements, Requests and Reports Maintenance

Compiled in Program Version 5.10. Help data last modified 4 Jun 2012 04:47:00.00. Class wCmsNetUpdate last modified 30 Oct 2017 03:35:48.

Reference Contents > Advanced Functions > Change Management System Upgrade via the Internet

The post Advanced Functions: Change Management System Upgrade via the Internet appeared first on Caliach.

String Entry from Text

Reference Contents > Advanced Functions > String Entry from Text

This window is opened from the String Maintenance window and enables you to add strings from a text source. You should ensure that the string code is unique.

Button	Action
Convert Text to Strings	Converts the text to strings.

See also: –

String Maintenance String Maintenance Toolbar

Compiled in Program Version 5.10. Help data last modified 20 Oct 2001 21:56:00.00. Class wStringTextEntry last modified 18 Feb 2015 01:54:54.

Reference Contents > Advanced Functions > String Entry from Text

The post Advanced Functions: String Entry from Text appeared first on Caliach.

Create New Database and Copy Data

Reference Contents > Advanced Functions > Create New Database and Copy Data

This window can be used to create a new empty database, create a new copy of the current database you are logged into or it can be used to clean out to empty a copy database.

In the upper portion of the window confirms the identity of the database you are currently logged into. If it is not you intention to copy from this database, operate File — Change Database to ensure you start from the correct database.

You will need to have Logon Settings for the target database. This can be for any of the DBMS engines you available to you.

The User ID and Password fields will be enabled only

Button	Action
Change Settings	Click to change or add logon settings. This opens the Database Connection Settings window.
Create or Overwrite Database to Empty	To create or overwrite the target database that is then left empty of data. If you are overwriting, the target database will first be dropped (deleted entirely) before being re-built.
Create or Overwrite Database and Copy Data	To create or overwrite the target database. If you are overwriting, the target database will first be dropped (deleted entirely) before being re-built. You current data will then be coppied table-by-table. The result will be a cloned database of the source.
Create/Renew Play Data	With a PostgreSQL database you can create a databaseplay database. If it already exists it will be dropped first and recreated. You must be the only connection to the current database. This process is much faster than using the other Create processes on this window. NOTE: This process creates or renews a duplicate database named the same as your current database plus the 4 letters “play”. It can only be run if you have exclusive use of the current database and that there are no connections to the play database. The process also performs the following on the databaseplay database: Truncates the tables USLFILE (User session log) and USTFILE (User tokens) Sets the Company name suffix to PLAY Sets the multi-company name suffixes to PLAY

See also: –

Database Connection Settings

Compiled in Program Version 5.10. Help data last modified 16 Dec 2016 05:57:00.00. Class wDataFileNew last modified 10 Oct 2017 11:48:09.

Reference Contents > Advanced Functions > Create New Database and Copy Data

The post Advanced Functions: Create New Database and Copy Data appeared first on Caliach.

Find Text In Strings

Reference Contents > Advanced Functions > Find Text In Strings

This dialogue window is used to enter a text to search for. Enter the value and confirm with an OK.

Button	Action
Cancel	Aborts the process currently in session. The keyboard equivalent is the Esc key for Windows computers and Command-.(full stop or period) for the Mac.
OK	The OK button updates the data you have entered, or confirms the selection and/or processes the function you have called.

See also: –

String Maintenance String Maintenance Toolbar Help Contents Maintenance Help Manager Options Menu

Compiled in Program Version 5.10. Help data last modified 17 May 2012 03:54:00.00. Class wFindText last modified 11 Jul 2016 12:07:33.

Reference Contents > Advanced Functions > Find Text In Strings

The post Advanced Functions: Find Text In Strings appeared first on Caliach.

Language Management

Reference Contents > Advanced Functions > Language Management

This feature enables you to customise the language embedded in windows, reports and menus, etc. In effect it gives you an opportunity to create an alternative language version of Caliach Vision.

Caliach Vision can be translated into alternative languages. Caliach write in UK English. However, alternative languages can be accommodated using various tools.

The following table shows the material and areas that are language-sensitive and the tools appropriate for translation of the program environment. This is not to be confused with translation of data texts which is the Language Swap System.

Caliach Vision is designed to be code-independent of text language. To ensure this is the case a number of approaches have been taken. Help is held in lookup files independent of the operating program and main datafile. Text strings that occur in the program, such as messages and data defaults are similarly held in an independent lookup file.

There are other areas of language-sensitive text not held independently of the operating programs. These are texts directly associated with windows, reports, files and fields. For example, window titles, literal texts and the descriptions of fields, etc.. For the translation of these texts we have to make use of the Omnis Studio object-oriented architecture to convert the standard English version of Caliach Vision into a translated version using a stored translation of the texts.

The remainder of this section is centred solely on this area of language translation.

Language Management

A special feature is available to store and manage translated class object texts. Alternative language translations can be entered. These are then stored in a special data file named Translate.df1, automatically created in the Custom directory.

The translation texts can be applied to the program classes, even when using a runtime version of Omnis Studio. Once these texts are applied this version of Caliach Vision becomes a language edition.

NOTE: Caliach will not provide support for use of this feature, or the consequences of its use, unless you are an authorised Translating Distributor.

The Language Management feature of Caliach Vision and associated programs uses Omnis Notation object-oriented technology. Each text is associated and keyed to a notation reference. These references are like an pathname and contain the names of objects.

WARNING: If in the future a program class is modified such that object reference paths change or names change within the path, the reference will be broken and the translation will fail. Caliach DO NOT guarantee that this will not happen and it is the responsibility of the translator to repair any damage so caused.

When the Language Management window opens and there is no Translate.df1 file in the Custom directory, you will be asked if one should be created. If you answer No, the window will close.

The window has 3 tab panes.

Program Classes 
Object Texts 
Mass Change 

Program Classes

This pane shows selected program classes from which you can select for a language analysis.

To operate the window, select a class from the class type list. The class list will then be populated with a list of all classes in your Vision.lbs library.

You then select one or more of the classes in the list and switch to the Object Text tab pane. A list of all objects with texts in the selected classes will be built.

WARNING: Take care this can take a long time if many classes are involved. Caliach Vision typically has approximately 50,000 text phrases in 1190+ classes.

Back to top

Object Texts

This pane lists the class object texts for the selected classes and enables you to set a language alternative for each.

WARNING: Special care must be taken with square-bracket notation. Square-bracket notation is effectively calculated text. When Omnis displays or prints a square-bracketed piece of text it evaluates the text between the square brackets as though it were an Omnis calculation. For example, ‘One plus One equals [1+1]’ would print ‘One plus One equals 2’. Another common example is ‘Page [#P]’, where #P is the page number Omnis variable, [#P] evaluates to the page number at runtime. Care must be taken with square-bracket texts not to effect anything other than quoted text within them, otherwise the alternative text will fail to be applied to the class.

WARNING: Another type of text calculation to be careful of are Notation strings. For example: ‘$clib.$windows.wPtmEdit.$desc’ which returns the description text for the window class named in the field wPtmEdit.

For each text you want to change, simply enter an alternate text. After completing your changes click on the Save to Disk button. To apply the alternative text, click on the Apply Alternatives. You cannot reverse this process.

Button	Action
Export	Creates a tab-delimited text file of the listed texts.
Import	Imports into the list alternative texts from a tab-delimited text file previously exported and amended.
Save to Disk	Saves any changes that you have made to alternative texts. There is a system option optLangLocalPriority that blocks language edition translation updates from overwriting texts that have been localised.
Apply Alternatives	Apply alternative texts listed to the program classes. Operating this tool will replace the current object texts in the current library’s classes with any alternative texts shown in the list. This is effectively the translation process of the current library. Without using this tool any change to the data listed will only be recorded in the data file Translate.df1. If the alternative text is regarded as illegal by Omnis Studio, no transfer will take place.
Cancel	Aborts the process currently in session. The keyboard equivalent is the Esc key for Windows computers and Command-.(full stop or period) for the Mac.
OK	The OK button updates the data you have entered, or confirms the selection and/or processes the function you have called.

Back to top

Mass Change

Enables you to set up a list of global changes of words or parts of words and apply that change to the entire program.

Button	Action
UK to US Standard	Lists the standard UK english to US english word list.
Show Set Names	Lists the available language sets in the Language.df1 file in the Custom directory.
Find and Save Language Set	Searches all classes and the string file for the words in the Language Set and saves references to them in the data file. This reference list can then be used to Apply Language Change.
Test Language Change	To test apply the stored language conversion and log results.
Apply Language Change	To apply the stored language conversion to the current program and log results. This is NOT REVERSIBLE.

Back to top

Compiled in Program Version 5.10. Help data last modified 28 Jan 2013 08:59:00.00. Class wLanguage last modified 23 Sep 2017 10:50:56.

Reference Contents > Advanced Functions > Language Management

The post Advanced Functions: Language Management appeared first on Caliach.

License Details and Authentication

Reference Contents > Advanced Functions > License Details and Authentication

This window enables you to activate your Caliach Vision software. It will be presented automatically when running the program for the first time after installation. You should enter the details illustrated on your license document which will have been faxed or sent to you.. Use the exact characters shown or authentication will fail. It is case-sensitive. You cannot alter the company name prefix. Within any Caliach Vision data file you may add any company name suffix (e.g. Ltd or Inc).

Button	Action
Demonstration	Click this button to automatically load a demonstration license.
Print Order Form	To print a copy of the License Order form. Right-click to select report destination. You will be presented with the License Application Data Entry window in which you can enter the details of your registration and order. This is then printed, signed and faxed to your distributor.
Re-license Omnis Studio	Click to re-license the currently running Omnis Studio.
Close	To close the window.
Save	To save the license to the Caliach.inf file in the Extras directory. If any entry is wrong it will not be saved. The Caliach.inf file is a text file and can be modified with a text editor if need be.

See also: –

License Application Data Entry

Compiled in Program Version 5.10. Help data last modified 26 May 2004 10:00:00.00. Class wLicense last modified 24 Mar 2016 09:20:27.

Reference Contents > Advanced Functions > License Details and Authentication

The post Advanced Functions: License Details and Authentication appeared first on Caliach.