Advanced Functions: String Maintenance

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.

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