Procedure For Adaptation and Translation of The Canbrass Tool

C A N A L I S S O F T W A R E
Procedure for adaptation and translation
of the CanBRASS tool
Purpose: Describe the files and procedures for translating the CanBRASS tool and then adapt them to the offering for a country.
This document applies from version 6.3 of the CanBRASS tool.
Scope of application: Adaptation and translation of Canalis software by the countries.
• Document status: Draft Validated
• Document version: 1.5
• Responsibility:
Position Name Signature Date
Drafted by Writer Fabrice Konarski
Approved by Software Manager David Guébet
Validated by Project Manager Daniel Duc
• Circulation for use:
Circulation Position Name
For action Country Software Deployment Dirk Van-Crombrugge
Manager Manager of each country
For information Project Manager Daniel Duc
• Revision Record:
Version Date Author Comments Sections modified
0.1 06/02/2006 Fabrice Konarski Creation of the document
1.0 17/03/2006 Fabrice Konarski Updating of the document following the Minor modifications
review by Dirk Van-Crombrugge throughout the document
1.1 14/06/2006 Fabrice Konarski Updating of the document following the New chapter 12 and minor
second review by Dirk Van-Crombrugge modifications on a few
other chapters
1.2 04/08/2006 Fabrice Konarski Updating of the document to complete 10.10, 14.2
explanation of the KDPdoc parameter and
modification of the tool's icon
1.3 12/03/2007 Fabrice Konarski Updating of the document to adopt as a 3, 4, 5, 9.2.2.1, 9.2.3.1 and
basis for adaptation the ini file in the 10.1, 10.14
installation directory and not that installed
on the PC. Addition of section 10.14 on
KBL management in the design guide
1.4 18/12/2008 Grégory Julliand Updating for CanBRASS 6.3 Elimination of references
to CanFAST. Updating of
info for CanBRASS
1.5 06/11/2009 Fabrice Konarski Changing images from French to English All document and add
and updating after checking chapter 10.8
Page 1/60
CONTENTS
1 REFERENCE DOCUMENTS ..............................................................................................................................................4

2 INTRODUCTION .............................................................................................................................................................4
3 ABBREVIATIONS, ACRONYMS ......................................................................................................................................4
4 LIST OF FILES TO BE ADAPTED OR TRANSLATED ..........................................................................................................4
5 PROCEDURE TO FOLLOW FOR TRANSLATING AND ADAPTING THE TOOLS ....................................................................5
6 TRANSLATION OF THE TOOL .........................................................................................................................................7
6.1 Overview .................................................................................................................................................................................... 7
6.2 Incorporation of a new language................................................................................................................................................ 7
6.2.1 Setup................................................................................................................................................................................ 7
6.2.2 Description of the file...................................................................................................................................................... 8
6.2.2.1 [LANG] section............................................................................................................................................................................... 8
6.2.2.2 [MSG] section................................................................................................................................................................................. 9
7 CUSTOMIZING THE ARTICLE.DBU FILE ........................................................................................................................10
7.1 Description ............................................................................................................................................................................... 10
7.2 Importing reference descriptions and updating the price list................................................................................................... 10
7.2.1 Setup.............................................................................................................................................................................. 10
7.3 Adding new local references .................................................................................................................................................... 14
7.4 Defining a discount for a given reference ................................................................................................................................ 15
8 CUSTOMIZING THE CANBRASS TOOL IN LINEAR MODE ............................................................................................17
8.1 Parameters setup for costing per linear metre .......................................................................................................................... 17
8.1.1 Overview ....................................................................................................................................................................... 17
8.1.2 Setup.............................................................................................................................................................................. 17
8.1.3 Management of priorities between product ranges ....................................................................................................... 17
8.1.4 Management of default options..................................................................................................................................... 18
9 CUSTOMIZING THE CANBRASS TOOL IN REFERENCE MODE .....................................................................................19
9.1 Parameters setup for costing a Canalis line.............................................................................................................................. 19
9.1.1 Overview ....................................................................................................................................................................... 19
9.1.2 Setup.............................................................................................................................................................................. 19
9.1.3 Characteristics of the Canalis line................................................................................................................................. 20
9.1.3.1 OPT parameter: Available options............................................................................................................................................... 21
9.1.3.2 CALMAX parameter: The rating of a Canalis line ...................................................................................................................... 21
9.1.4 Types of elements available for a Canalis line.............................................................................................................. 22
9.1.4.1 ALIM parameter: Choice of type of power supply for a Canalis line .......................................................................................... 22
9.1.4.2 DROIT parameter: Choice of type of straight elements for a Canalis line.................................................................................. 23
9.1.4.3 Specific feature of the DROIT parameter for the KBA range ...................................................................................................... 24
9.1.4.4 Specific feature of the DROIT parameter for the KBB range ...................................................................................................... 25
9.1.4.5 COMPL parameter: Type of complementary elements for a Canalis line ................................................................................... 26
9.1.4.6 FIX parameter: Method for fastening the busbar trunking to the structure................................................................................. 27
9.1.4.7 FIXL parameter: Method for suspension of lighting fixtures from the busbar trunking.............................................................. 28
9.1.4.8 SUPPL parameter: Supplementary equipment............................................................................................................................. 29
9.1.4.9 CHOIXLUM parameter: Type of lighting fixtures mounted under the busbar trunking.............................................................. 29
9.1.4.10 CHOIX4D parameter: Number of branches per metre .............................................................................................................. 30
9.1.4.11 MC10 parameter: KDP connection elements - Connection of lighting fixtures......................................................................... 30
9.1.4.12 FC parameter: KDP connection elements - Connection to connectors...................................................................................... 31
9.1.4.13 FM parameter: KDP connection elements - Connection between lighting fixtures ................................................................... 32
9.1.4.14 BA12 parameter: KDP connection elements by shunting – Tee splitter block (1 input/2 outputs) ............................................ 33
9.1.4.15 BA15 parameter: KDP connection elements by star connection – Tee splitter block (1 input/5 outputs) ................................. 34
9.1.4.16 CHOIXCONN parameter: Default selection of the type of branch connectors.......................................................................... 35
9.1.4.17 FERM1 parameter: Presence of a closing end-piece for the power supply of a Canalis line.................................................... 36
9.1.4.18 Summary of parameters used for each range in the ref_conf.cfg file ......................................................................................... 37
9.2 Customization of the lighting comparison ............................................................................................................................... 37
9.2.1 Comparison calculation method.................................................................................................................................... 37
9.2.1.1 Description ................................................................................................................................................................................... 37
9.2.1.2 Setup ............................................................................................................................................................................................. 38
9.2.1.3 Description of solution S1 ............................................................................................................................................................ 39
9.2.2 Activate the request for comparison with a conventional solution............................................................................... 40
9.2.2.1 Description ................................................................................................................................................................................... 40
9.2.2.2 Setup ............................................................................................................................................................................................. 41
9.2.3 Definition of prices and labour for a conventional solution ......................................................................................... 41
9.2.3.1 Description ................................................................................................................................................................................... 41
Page 2 / 60
9.2.3.2 Setup ............................................................................................................................................................................................. 41
9.3 Customization of the connector and tap-off unit offering........................................................................................................ 42
9.3.1 Definition of connector types........................................................................................................................................ 42
9.3.1.1 Description ................................................................................................................................................................................... 42
9.3.1.2 Setup ............................................................................................................................................................................................. 42
9.3.1.3 File characteristics ....................................................................................................................................................................... 43
9.4 Customization of price quotes.................................................................................................................................................. 45
9.4.1 Overview ....................................................................................................................................................................... 45
9.4.2 Setup.............................................................................................................................................................................. 46
9.4.3 Characteristics of a model file....................................................................................................................................... 46
10 CUSTOMIZING THE CNB.INI FILE ................................................................................................................................46
10.1 Description ............................................................................................................................................................................... 46
10.2 Setup......................................................................................................................................................................................... 46
10.3 Allowance for the display language ......................................................................................................................................... 47
10.4 Choice of website ..................................................................................................................................................................... 47
10.5 Designation of backup directories............................................................................................................................................ 47
10.6 Definition of user characteristics.............................................................................................................................................. 48
10.7 Preferences concerning the grouping of indivisible quantities and the display of reference designation ............................... 49
10.8 Preferences concerning the language for displaying the designation of references ................................................................ 49
10.9 Preferences concerning the display of a Help window on the tool.......................................................................................... 50
10.10 Display of the KDP range at a predetermined date............................................................................................................... 51
10.11 Display of a promotional or informative document.............................................................................................................. 51
10.12 Discounts by family .............................................................................................................................................................. 52
10.13 Preference concerning the grouping of identical product references.................................................................................... 52
10.14 Locking a mode of the CanBRASS tool ............................................................................................................................... 53
10.15 KBL management with KBB in the design guide................................................................................................................. 54
11 CHANGE OF WELCOME IMAGE WHEN STARTING THE APPLICATION ...........................................................................54
12 TRANSLATION OF THE ARTICLE.EXE UTILITY .............................................................................................................55
12.1 Overview .................................................................................................................................................................................. 55
12.2 Incorporation of a new language.............................................................................................................................................. 55
12.2.1 Setup.............................................................................................................................................................................. 55
13 ADAPTATION OF HELP ................................................................................................................................................56
13.1 Setup......................................................................................................................................................................................... 56
13.2 Translation and adaptation of Help source files....................................................................................................................... 56
13.3 Generation of Help file............................................................................................................................................................. 57
14 ADAPTATION OF THE INSTALLATION PROCEDURE......................................................................................................58
14.1 Composition of the installation program.................................................................................................................................. 58
14.2 Change of CanBRASS tool icon .............................................................................................................................................. 59
14.3 Change of name and version of the CanBRASS tool .............................................................................................................. 59
14.4 Creation of an installation procedure ....................................................................................................................................... 59
Page 3 / 60
1 REFERENCE DOCUMENTS
Index Name, version Description

Old procedure for adaptation of CanFAST and CanBRASS
[A] Comment_personnaliser_CanBRASS et CanFAST FR.doc
tools
[B] Adaptation_Devis_CanBRASS_EN.doc Procedure for customization of price quote models
2 INTRODUCTION
This document establishes the procedure for adaptation of the CanBRASS tool for estimating the cost of Canalis lines.
It provides the necessary means for adapting the tools' characteristics to the local context of a country (language, price, catalogue,
technical standards or criteria) and serves as a basis for the country for performing adaptation and translation of the tools.
The document presents a summary of the files to be adapted or translated, then describes all the tasks that can be carried out on the
tools so that they may be deployed in a country, namely:
• Translation of the tool
• Translation of reference descriptions and updating of price lists and discounts, addition of local product references
• Customization of costing per linear metre
• Customization of costing by product reference
• Parameters setup for costing
• Customization of the lighting comparison
• Customization of the connector and tap-off unit offering
• Customization of price quotes
• Other customizing
• Adaptation of Help
• Adaptation of the installation procedure
3 ABBREVIATIONS, ACRONYMS
This chapter presents all the abbreviations and acronyms used throughout the remainder of the document.
Some symbols are characterized by the fact that they are in square brackets and their characters are in small capital letters.
The list of symbols is given below:
Symbol Description
Tool installation directory. By default, the installation procedure proposes the
[INSTALL_DIR]
c:\Program Files\Schneider Electric\CanBRASS <tool version number> directory
Directory in which the tool configuration files are installed. Generally this is the
[APPDATA_DIR]
c:\Documents and Settings\<user>\Application Data\CNB63 directory
[CP_DIR] Installation program "COPY" directory
When the symbol appears, this means that an example, a comment or a

Comment, suggestion, example
suggestion allows the user to better understand the information dealt with.
4 LIST OF FILES TO BE ADAPTED OR TRANSLATED

The summary list of files to be adapted or translated is presented below.
As a reminder:
• The "Filename in French (in English)" column indicates the name of the file in French and then in English in brackets.
If the filename is the same in English and French, the filename in English is not displayed.
• The "Location" column indicates where the file is located after installation.
• The "Software used to translate the file" column specifies what software should be used to adapt or translate the file.
Page 4 / 60
• The "Trans." column indicates whether the file is to be translated or not.
• The "Adapt." column indicates whether the file is to be adapted or not.
• The "File must be renamed" column indicates whether the file must be renamed after its translation or its adaptation.
• The "Action" column indicates the type of translation or adaptation action to be performed on a file.
• The "Filename after renaming" column indicates what is the new name of the file after its translation or its adaptation.
File must Action

Filename in French Software used to Filename after
Location Trans. Adapt. be (cf.
(in English) translate the file renaming
renamed chap. 5)
CNB_033.txt Notepad or software CNB_<telephone code of
[INSTALL_DIR]\DBF Yes No Yes 1
(CNB_044.txt) of the same type the country>.txt
Notepad or software 5, 6, 20,
of the same type 21, 23,
29, 30,
31, 32,
CNB.INI [APPDATA_DIR] No Yes No
33, 34,
35, 36,
37, 38,
39, 40
Notepad or software
Lin_conf.cfg [APPDATA_DIR] No Yes No 7
of the same type
Help_033.chm Word, HTML Help Help__<telephone code of
[INSTALL_DIR] Yes Yes Yes 43, 44
(Help_044.chm) Workshop the country>.chm
Notepad or software
Article.cfg [INSTALL_DIR] Yes No No 42
of the same type
CNB<version>.ico [CP_DIR] Drawing software No Yes No 45
Language directory of Install.exe of the
Setup.dat the installation program installation program
No Yes No 46
Article.exe supplied
article.DBU [INSTALL_DIR]\BD with the CanBRASS Yes Yes No 2, 3, 4, 5
tool
Notepad or software 8, 9, 10,
of the same type 11, 12,
Ref_conf.cfg [APPDATA_DIR] No Yes No 13, 14,
15, 16,
17, 18
Ref_comp.dbf [INSTALL_DIR]\DBF Excel No Yes No 19
Ref_coff.dbf [INSTALL_DIR]\DBF Excel No Yes No 22
Splash.jpg [INSTALL_DIR] Drawing software No Yes No 41
Info.jpg [INSTALL_DIR] Drawing software No Yes No 41
Modele_Impression_Rapide.xls Excel
24, 25,
Modele_Impression_Schneider.xls
[INSTALL_DIR]\MODELS Yes Yes No 26, 27,
(Fast_printing_model.xls)
28
(Schneider_printing_model.xls)
5 PROCEDURE TO FOLLOW FOR TRANSLATING AND ADAPTING THE TOOLS

This chapter presents the list of translation and adaptation actions to be performed to carry out an adaptation.
It is the main chapter of the document.
There are two ways of approaching this document to adapt and translate a tool:
1. Browse through the document sequentially, determine what you want to adapt and perform the desired adaptation or
translation actions.
2. Browse through the following table defining the list of translation and adaptation actions and, depending on the desired
action, refer to the corresponding chapter in the document to complete that action.
As a reminder, all the actions are not necessarily to be dealt with.
Below is the list of translation and adaptation actions to be performed in increasing order:
Page 5 / 60
Compulsory
Action Description of the action Chapter to refer to
action
1 Translation of the tool Yes Chapter 6 page 7 for what is to be done
Importing reference descriptions Chapter 7.2 page 10 for what is to be done
2 Yes
Chapter 7.1 page 10 for more explanations
Updating price lists Chapter 7.2 page 10 for what is to be done
3 Yes
Addition of local references Chapter 7.3 page 14 for what is to be done
4 No
Definition of a discount for each given reference or Chapter 7.4 page 15 for what is to be done
5 No
group of references Chapter 7.1 page 10 for more explanations
Allocation of a discount by product family Chapter 10.12 page 52 for what is to be done
6 No
Chapter 10.1 and 10.2 page 46 for more explanations
Parameters setup for costing per linear metre Chapter 8.1.3 and 8.1.4 page 17 for what is to be done
7 No
Chapter 8.1.2 page 17 for more explanations
Available options Chapter 9.1.3.1 page 21 for what is to be done
8 No Chapter 9.1.1, 9.1.2 page 19 and 9.1.4.18 page 37 for more
explanations
Rating Chapter 9.1.3.2 page 21 for what is to be done
explanations
Choice of power supply type Chapter 9.1.4.1 page 22 for what is to be done
explanations
Choice of type of straight elements and type of Chapter 9.1.4.2, 9.1.4.3, 9.1.4.4 page 23 and 9.1.4.5 page 26 for what
supplementary elements is to be done
11 No
Chapter 9.1.1, 9.1.2 page 19 and 9.1.4.18 page 37 for more
explanations
Method for fastening the busbar trunking to the Chapter 9.1.4.6 page 27 for what is to be done
12 structure No Chapter 9.1.1, 9.1.2 page 19 and 9.1.4.18 page 37 for more
explanations
Method of suspension for lighting fixtures Chapter 9.1.4.7 page 28 for what is to be done
explanations
Supplementary equipment Chapter 9.1.4.8 page 29 for what is to be done
explanations
Type of lighting fixtures mounted under the busbar Chapter 9.1.4.9 page 29 for what is to be done
15 trunking No Chapter 9.1.1, 9.1.2 page 19 and 9.1.4.18 page 37 for more
explanations
Number of branches per metre Chapter 9.1.4.10 page 30 for what is to be done
explanations
KDP connector system elements Chapter 9.1.4.11 to 9.1.4.15 page 30 to 34 for what is to be done
explanations
Presence of a closing end-piece for the power supply Chapter 9.1.4.17 page 36 for what is to be done
18 of a Canalis line No Chapter 9.1.1, 9.1.2 page 19 and 9.1.4.18 page 37 for more
explanations
Definition of the method for calculation of the Chapter 9.2.1 page 37 for what is to be done
19 No
lighting comparison
Request for a comparison with a conventional Chapter 9.2.2 page 40 for what is to be done
20 No
solution
Definition of prices and labour for a conventional Chapter 9.2.3 page 41 for what is to be done
21 No
solution
22 Definition of connector types No Chapter 9.3.1 page 42 for what is to be done
Selection of a connector type Chapter 9.1.4.16 page 35 for what is to be done
23 No
Chapter 9.1.2 page 19 for more explanations
Translation of the text for an existing model Chapter 9.4 page 45 for what is to be done
24 No
Documentation [B] for more explanations
Choice of columns to be printed for costing Chapter 9.4 page 45 for what is to be done
25 No
Determining the data managed by the tool and to be Chapter 9.4 page 45 for what is to be done
26 No
printed in the price quote Documentation [B] for more explanations
Addition of a new page in the model Chapter 9.4 page 45 for what is to be done
27 No
Deletion of an existing page in the model Chapter 9.4 page 45 for what is to be done
28 No
Acceptance of display language when starting the Chapter 10.3 page 47 for what is to be done
29 No
tool Chapter 10.2 page 46 for more explanations
Page 6 / 60
Choice of website to open Chapter 10.4 page 47 for what is to be done
30 No
Designation of backup directories Chapter 10.5 page 47 for what is to be done
31 No
Choice of grouping identical references Chapter 10.13 page 52 for what is to be done
32 No
Definition of default characteristics of the user Chapter 10.6 page 48 for what is to be done
33 No
Choice of grouping together indivisible quantities of Chapter 10.7 page 49 for what is to be done
34 No
a reference Chapter 10.2 page 46 for more explanations
Choice of language to display designation of Chapter 10.8 page 10.8 for what is to be done
35 Yes
references Chapter 10.2 page 46 for more explanations
Display of a Help window concerning use of the tool Chapter 10.9 page 50 for what is to be done
36 No
Display of the KDP range at a predetermined date Chapter 10.10 page 51 for what is to be done
37 No
Display of a promotional or informative document Chapter 10.11 page 51 for what is to be done
38 No
Locking a mode of the CanBRASS tool Chapter 10.14 page 53 for what is to be done
39 No
KBL management with KBB in the design guide Chapter 10.15 page 54 for what is to be done
40 No
41 Change of welcome image when starting the tool No Chapter 11 page 54 for what is to be done
42 Translation of the article utility No Chapter 12 page 55 for what is to be done
43 Translation and adaptation of Help source files No Chapter 13.2 page 56 for what is to be done
44 Generation of Help file No Chapter 13.3 page 57 for what is to be done
45 Change of tool icon No Chapter 14.2 page 59 for what is to be done
46 Change of tool name and version No Chapter 14.3 page 59 for what is to be done
47 Creation of an installation procedure Yes Chapter 14.4 page 59 for what is to be done
6 TRANSLATION OF THE TOOL

The goal of this chapter is to translate all the character strings displayed into a new language.
These character strings include the menus, buttons and the information displayed in the various windows.
The data for the tool (reference descriptions) are not taken into account in this chapter.
6.1 Overview
All the character strings for a tool are grouped together in a single text file with a .txt extension.
The file is named CNB_<country code>.TXT where <country code> represents the telephone code of the country on three
characters. It is located in the [INSTALL_DIR]\DBF directory.
The file can be opened with any text editor of the Windows Notepad type.
The telephone code for France is 33. The file is therefore named CNB_033.txt for France.
There are as many files as there are languages used. But the software manages only a single file at a time.
6.2 Incorporation of a new language

6.2.1 Setup
The files CNB_033.txt for the French language and CNB_044.txt for the English language are always supplied and installed.
For the tool to be able to manage a new language, you must:

• Copy one of these two files in the same directory with Windows Explorer. If the file in French is copied, the translation
will be performed from the French text. If the file in English is copied, the translation will be performed from the
English text.
• Rename the copied file according to the telephone code of the country. For a translation into German, the file will be
renamed CNB_049.txt, because the number 49 is the telephone code for Germany.
• Open the renamed file with a text editor of the Windows Notepad type and translate the character strings contained in the
file.
• Save the changes.
Page 7 / 60
For a change in the file's content to be taken into account in the tool, the tool must be restarted.
Once the file has been translated, this does not mean that the tool will use this new language file.
It must be indicated to the tool. To perform this operation, refer to chapter 10.3 below.
It is possible to delete the French or English files in order to keep only the translated file.
6.2.2 Description of the file

To translate the character strings correctly, the file format must be described.
The file is broken down into two parts:
• The LANG section
• The MSG section
6.2.2.1 [LANG] section

This section consists of two lines. These are:
00000=<text> , where <text> represents the name of the language;
CHARS=<def> , where <def> represents the type of alphabet used by the file language.
The purpose of this section is to define the name of the language used:
• For the "00000=<text>" line, only the part to the right of the "=" sign is to be modified to insert the name of the country's
language.
It can be checked that the value is accepted by calling up the following window via the File/User’s Environment menu.
The flag display depends on the filename and

especially the telephone code contained in the
filename.
In the example, the French flag appears because
the telephone code for France is 33 and the file is
named CNB_033.txt.
If there is no flag associated with the country
code, no flag is displayed.
[LANG]
00000=French
CHARS=LATIN
• For the "CHARS=<def>" line, only the part to the right of the "=" sign is to be set according to the language. The
possible values, which are defined in the file itself, are:
• LATIN For those countries using the same type of alphabet as France, the United Kingdom,
etc.
• EASTEUROPE For the Eastern European countries
• CYRILLIC For those countries using the Cyrillic alphabet
• GREEK For those countries using the Greek alphabet
• TURKISH For those countries using the Turkish alphabet
• BALTIC For the Northern European countries
• CHINESE For China
• CHINESE SIMPLIFIED For China
• JAPANESE For Japan
The value makes it possible to select the alphabet wanted (if it is available in the Windows system) and to display all the
characters making up that alphabet.
The possible values are very explicit for choosing an alphabet (for example, the value GREEK allows the Greek alphabet
to be selected).
To make sure that the value is correct, start the tool and check that the characters displayed are in conformity with what
is expected.
Page 8 / 60
6.2.2.2 [MSG] section
This section allows all the messages existing in the tool to be translated. Each message is noted on one line and each line is of the
form: Example
• <code> = <text> [MSG]
where: 00014=Price quote
• <code> represents the message identifier. It must never be changed. 00300=&File
• <text> is the text to translate into the language of the country.
Do not change
To be translated
The line with the code 00016 represents the name of the Excel file that will be used as default model for printing the
price quote via the Print menu.
The name of the file that is translated must always end with the characters ".xls" and the file must exist in the
[INSTALL_DIR]\MODELS directory.
Another example
[MSG]
00016=Fast_printing_model.xls
The terms "Ctrl+N", "Ctrl+O", "Ctrl+P" and "Ctrl+S" are not to be translated.
The & sign indicates that the following letter will be underlined. This means the user can access the main menu
by pressing the ALT key and the key corresponding to the letter following the & sign. For example, the
"&File" menu can be accessed by pressing the ALT key and the F key.
To access a sub-menu directly, simply press the key corresponding to the underlined letter in the menu.
The position of the & sign may be changed, but it is recommended that it be unique for the main menu and each
sub-menu of a menu. See the example below:
Translation from French

to English or vice versa
00300=&Fichier 00300=&File
08050=&Impression 08050=&Printing
00340=&Vue 00340=&View
00380=&Aide 00380=&Help
The \t, %APP, \n, %1, %2, %3 and *.* signs are not to be translated.
The line with code 00015 represents the name of the Help file for the tool.
The filename must always end with the characters ".chm" and the file must exist in the [INSTALL_DIR]
directory. It is this file that will be displayed when the user calls up the tool's Help facility via the Help menu or via the
F1 key.
Page 9 / 60
7 CUSTOMIZING THE ARTICLE.DBU FILE
It is possible to import the descriptions of product references and update price lists, add new product references and/or position a
discount for a given product reference.
7.1 Description
All the descriptions of the product references and the price lists and associated discounts are grouped together in a single file having
the dbu extension.
The file is named article.DBU and is located in the [INSTALL_DIR]\BD directory. It can be opened with Excel, but a proprietary
Schneider software called article.exe must be used to translate the reference descriptions (software supplied with the CanBRASS
tool).
7.2 Importing reference descriptions and updating the price list

7.2.1 Setup
To import the descriptions and prices of the product references, you must:
1. Have the article.exe software supplied with the CanBRASS tool. A prerequisite is therefore to install this tool. Once installed, the
article.exe software is located in the [INSTALL_DIR] directory of the CanBRASS tool.
2. Have an Excel source file defining the references used by the tool (reference codes, descriptions, prices, etc.) in the language of the
country. Then you must have saved this file in text format (.txt) with Excel ("Text (separator: tab) (*.txt)" format).
3. Start the article.exe software via Windows Explorer by double-clicking on its name.
4. Once the software is started, open the article.dbu file by selecting the Database/Open menu.
If the window that appears is in French, it is possible to change the

language via the Display/Language menu.
Page 10 / 60
5. In the file opening window, select the article.dbu file and click on the
Open button.
6. The file opening window closes and the result appears in the following form:
7. Click on the "Price lists" tab, then select the first line in the list. To be done only for updating the price list.
8. Enter the name of the price list and the currency at the bottom of the screen, then click on the "Validate" button. To be done only
Page 11 / 60
for updating the price list.
9. The name of the price list and the currency are saved in the article.dbu file and the values are displayed
as in the following window. To be done only for updating the price list.
10. Click on the menu Database / Import update file…
11. Select your source text file (stored on your hard disk) which appears in the window below
and click on the Open button. For example, the "2009 English price list.txt" file is selected.
Page 12 / 60
12. The following window appears. In this window, establish a correspondence between the columns in your source text file (left-
hand part of the window presenting the reference codes, their descriptions and their prices) and those in the article.dbu file (right-
hand part of the window), and click on the OK button. This has the effect of importing the descriptions of the product references
and the prices into the article.dbu file.
Title of the columns of your source text file
In our example, for the source text file:
Title of columns of the article.dbu file The title of the 1st column is "REF" for the reference code.
That of the 2nd column is "DESCRIPTION" for their description.
That of the 3rd column is "UNIT PRICE" for their price.
In the source text file, the title of the column

corresponding to the references (here "REF") must always
correspond to the "Reference" column of the article.dbu file.
The same applies for the descriptions column (here "DESCRIPTION")
corresponding to the "Label 1" column and the price column (here
"UNIT PRICE") corresponding to the "2009 Price List" price column
in our example.
The number of columns to be imported with the tool is limited to

10.
The fact of importing into the "Label 1" column of the article.dbu file imports the descriptions of the references.
The fact of importing into the first price list column ("2009 Price List" in our example) of the article.dbu file imports the
prices of the product references.
The Excel file defining the references used by the tool must always begin with the column presenting the
product references.
Accordingly, the Excel file saved in text format will also have the reference codes as first column.
When importing descriptions into the article.dbu file, if all the items of the article.dbu file are identical
to the items of the text file to be imported, nothing happens.
13. When data import is completed, the following window appears. Click on the
OK button.
Page 13 / 60
14. Close the article.exe software.
7.3 Adding new local references

Local references are used by the CanBRASS tool only in graphics mode.
To add new local references, you must:
1. Have the Excel file defining the local references that will be used by the tool (reference codes, descriptions, prices, etc.). Then you
must have saved this file in text format (.txt) with Excel ("Text (separator: tab) (*.txt)" format).
In our example, this is the file "Local_Ref.txt". The first column must always begin with the title "Reference", with below it the
code of the references to be added.
To add a local reference, the "+" sign

must be placed before the code of the
reference.
To delete an existing local reference,

the "-" sign must be placed before
the code of the reference.
2. Start the article.exe software and open the article.dbu file (see previous chapter to learn how to use the article.exe tool).
3. Click on the menu Database / Import update file…
4. Select your text file (stored on your hard disk) and click on the Open button. In our example, the "Local_Ref.txt" file is to be
selected.
5. The following window appears. In this window, establish a correspondence between the columns in your text file (left-hand part of
the window presenting the reference codes, their descriptions and their prices) and those in the article.dbu file (right-hand part of
the window), and click on the OK button.
This has the effect of importing the descriptions of the product references and the prices into the article.dbu file.
Title of columns of the article.dbu file
The name of the price list can be

changed in the tools.
For CanBRASS, there is no restriction
because the tool allows a price list to
be selected from several lists.
6. Once the import is completed, the new local references can be viewed in the "Local" tab of the article.exe tool.
In our example, the local references KBA_1,

KBA_2 and KBA_3 have been created in the
"Local" tab.
7. Close the article.exe software.
Page 14 / 60
7.4 Defining a discount for a given reference
There are two ways of defining discounts:

• Discount by family
• Discount by product reference
To set the "discount by product reference" method, you must:

• Close the tool.
• In the CNB.INI file, set the UseTC parameter to 1 in the Database section.
• Save the changes. [Database] Example
UseTC=1
To set the "discount by family" method, you must:
• Close the tool.
• In the CNB.INI file, set the UseTC parameter to 0 in the Database section or delete the line on which this parameter is
located.
The two discount calculation methods cannot be used at the same time.
The "discount by family" method is described further on in the document in Chapter 10.11 below.
The "discount by product reference" method is described below.
This method makes use of the article.exe tool to save the discounts for each product reference in the article.dbu file.
To create discounts by product reference, you must first create the discount codes with the desired discount rate, then assign this
discount code to a product reference or a group of references.
To define discount codes by product reference, you must:

1. Start the article.exe software and open the article.dbu file (see previous chapter to learn how to use the article.exe tool).
2. Click on the "Discount code" tab, and press the "F9" key to unshade the Record/ Add menu.
2. Click on the "Record / Add" menu to display the entry field for a discount code. It is then possible to enter the discount code, its
description, and its discount rate in a range between 0 and 1. As a reminder, a rate of 0.8 is equivalent to a 20% discount.
Then confirm the entry by clicking on the "Validate" button. The discount code is then created.
3. Click on the Standard tab, and choose a product reference to which you want to apply the discount code. Enter the discount code
and click on the Validate button.
4a. If there are few product references to which a discount code is to be applied, repeat step 3 for all these references.
Page 15 / 60
4b. If there are numerous product references to which a discount code is to be applied, it is recommended to:
• Create an Excel file with a Reference column and another column for the Discount code. Save this file in text format ("Text
(separator: tab) (*.txt)" format).
Instead of creating an Excel file, it is possible to

export the article.dbu file with the article.exe tool via
the "Database / Export to text file" menu
and enter the discount codes in the exported text file.
The "REF" and "Discount" titles are

examples.
• Click on the Database / Import update file… menu in the article.exe tool.
• Select your text file (stored on your hard disk) and click on the Open button. In our example, the "code_remise.txt" file is to be
selected.
• The following window appears. In this window, establish a correspondence between the columns in your text file (left-hand
part of the window presenting the reference codes and the discount code) and those in the article.dbu file (right-hand part of
the window), and click on the OK button.
This has the effect of importing the descriptions of the product references and the discount codes into the article.dbu file.

Title of columns of the article.dbu file
• Once the import is completed, the discount codes are assigned to the product references in the "Standard" tab of the article.exe
tool.
Page 16 / 60
To display the Discount
column, click on the
Display / Fields / Discount
menu.
• Close the article.exe software.
8 CUSTOMIZING THE CANBRASS TOOL IN LINEAR MODE

8.1 Parameters setup for costing per linear metre
8.1.1 Overview
The parameters setup for costing is described in the lin_conf.cfg file located in the [APPDATA_DIR] directory.
The file is a text file and can be opened with any text editor of the Windows Notepad type.
The lin_conf.cfg settings file makes it possible to:

• Manage priorities between product ranges (e.g. adopt KV by default rather than KS in the rising main…);
• Set certain options by default: It is possible to choose by default a set of foils and the flexible cover when the user
chooses a traditional connection in KT (this is a way of promoting the package offering in LTT).
8.1.2 Setup
To set the file parameters, you must:
• Close the CanBRASS tool.
• Open the lin_conf.cfg file with a text editor.
• Set the values wanted for each product family, or modify the default values as described in the following sections depending
on the parameters (chapter 8.1.3 below and 8.1.4 below).
• Save the changes in the lin_conf.cfg file.
8.1.3 Management of priorities between product ranges

These priorities are set by applications (Transmission/Connection, Storey distribution, Power distribution, Lighting distribution).
Priorities are then set for a given rating.
The file is of the following form in the case of power distribution:

;----------------------------------------------------------------
; Distribution de puissance
; Power distribution
;----------------------------------------------------------------
[2]
KNA=1
KSA=2
KTA=3
KHF=4
In this example, KNA takes priority over KSA (for a 100 A rating, KN and KS are possible but "KNA 100A" will appear as first
choice and "KSA 100A" as second, and so on).
Page 17 / 60
For KSA to take priority over KNA, the following is required:
;----------------------------------------------------------------
;----------------------------------------------------------------
[2]
KNA=2
KSA=1
KTA=3
KHF=4
To eliminate an offering in the tool, a semi-colon must be placed before each root (example on the KT offering):
;----------------------------------------------------------------
;----------------------------------------------------------------
[2]
KNA=1
KSA=2
;KTA=3
KHF=4
8.1.4 Management of default options

The following parameters can be customized:
[x] where x can take the values 0, 1, 2 or 3. (0 = Transmission/Connection, 1 = Storey distribution, 2 = Power
distribution, 3 = Lighting distribution): See previous chapter.
K??=1 Order of preference for each proposed product
;K??= Masked product (if everything is masked, then the application is too)
[KT-x] For each application of KT in which x represents the application number (x can take the values 0, 1 or 2)
PACK=0 / 1 Upstream connection on Trihal transformer + KT option
TRF=0 / 1 Upstream connection on dry transformer
TRF1=0 / 1 Upstream connection on immersed transformer
PACK1=0 / 1 Upstream connection on Okken switchboard, KT option
TBL=0 / 1 Upstream connection on switchboard
CBL=0 / 1 Upstream connection by cables
TRESS=0 / 1 Accessory for connection on switchboard (can be viewed when TBL equals 1): All upstream braids
CLINQ=0 / 1 Accessory for connection on switchboard (can be viewed when TBL equals 1): All upstream foils
CAP=0 / 1 Accessory for connection on switchboard (can be viewed when TBL equals 1): Upstream cover
PACK2=0 / 1 Downstream connection on Package interface (Okken switchboard, KT option)
TBL2=0 / 1 Downstream connection on another switchboard
TRESS2=0 / 1 Accessory for connection on switchboard (can be viewed when TBL2 equals 1): All downstream braids
CLINQ2=0 / 1 Accessory for connection on switchboard (can be viewed when TBL2 equals 1): All downstream foils
CAP2=0 / 1 Accessory for connection on switchboard (can be viewed when TBL2 equals 1): Downstream cover
selected
[KV-x] For each application of KV in which x represents the application number (x can take the values 0 or 1)
TBL2=0 / 1 Downstream connection on switchboard
CBL2=0 / 1 Downstream connection by cables
[KS-x] For each application of KS in which x represents the application number (x can take the values 1 or 2)
CBL=0 / 1 Terminal upstream connection by cables
CTRL=0 / 1 Central upstream connection by cables
TRANSP=1 Description of the line (sloping part). The "Length of sloping part" function for the KS rising mains
alone is present or absent when there is a semi-colon before the line.
[KH-2] For an application of KH in power distribution

TBLAC=0 / 1 Connection on switchboard, bars in the axis
TBLAK=0 / 1 Connection on switchboard, perpendicular bars
Page 18 / 60
BARR=0 / 1 Connection accessory (can be viewed when TBLAC or TBLAK equals 1): Flexible busbars
CAP=0 / 1 Connection accessory (can be viewed when TBLAC equals 1): Covers
[KN-2] For an application of KN in power distribution

CBL=0 / 1 Terminal upstream connection by cables
CTRL=0 / 1 Central upstream connection by cables
CHOIXTRAP=1 / 2 Choice of number of tap-off points by default (1 = 1 every 1 m and 2 = 2 every 1 m)
[KB-3] For an application of KBA-KBB in lighting distribution

CBL=0 / 1 Upstream connection by cables (selected by default if = 1)
CHOIXTRAP=1 / 2 Choice of number of tap-off points by default on the straight element KBA (1 = 1 every 1.5 m and 2 = 1
every 1 m)
;CHOIXTRAP= Possibility of masking the choice of tap-off points in KBA (therefore = 2)
[KD-3] For an application of KDP in lighting distribution

CHOIXTRAP=1 / 2 Choice of number of tap-off points by default on the straight element (1 = 1 every 1.5 m and 2 = 1 every 3
m)
With costing per linear metre, all the check boxes present in the screens can be checked or not, by default.
For all the parameters except CHOIXTRAP:

If the parameter equals 0, the check box is not checked by default
If the parameter equals 1, the check box is not checked by default
Example 1 on KT in power distribution:

[KT-2]
TBL=0
TRESS=0
CLINQ=0
CAP=0
CBL=0
Example 2 on KT in power distribution:

[KT-2]
TBL=1
TRESS=0
CLINQ=1
CAP=0
CBL=0
9 CUSTOMIZING THE CANBRASS TOOL IN REFERENCE MODE

9.1 Parameters setup for costing a Canalis line
9.1.1 Overview
The parameters setup for costing is described in the ref_conf.cfg file located in the [APPDATA_DIR] directory.
Via this file, it is possible to configure, for each product family (KNA, KDP, etc. – see summary in chapter 9.1.4.18):
• The characteristics of the Canalis line (rating, etc.);
• The types of elements available (straight elements, fasteners, etc.).
9.1.2 Setup
Page 19 / 60
• Open the ref_conf.cfg file with Notepad.
• Set the values wanted for each product family, or modify the default values as described in the following sections depending
on the parameters.
• The OPT parameter which represents the options available for the product (chapter 9.1.3.1).
• The CALMAX parameter which represents the maximum authorized rating for the product (chapter 9.1.3.2).
• The ALIM parameter which represents the choice of power supply type (chapter 9.1.4.1).
• The FERM1 parameter which determines whether closing end-pieces for the power supplies are available or not
(chapter 9.1.4.17).
• The DROIT parameter which represents the choice of type of straight elements (chapters 9.1.4.2, 9.1.4.3 and 0).
• The COMPL parameter which represents the type of complementary elements (2-metre element) - (chapter
9.1.4.5).
• The FIX parameter which represents the method for fastening the busbar trunking to the structure (chapter 9.1.4.6).
• The FIXL parameter which represents the method for fastening the lighting fixtures to the busbar trunking (chapter
9.1.4.7).
• The SUPPL parameter which represents the supplementary equipment (chapter 9.1.4.8).
• The CHOIXLUM parameter which represents the type of lighting fixtures mounted on the busbar trunking (chapter
0).
• The CHOIX4D parameter which represents the number of branches per metre (chapter 9.1.4.10).
• The MC10 parameter which represents connection of the lighting fixtures (chapter 9.1.4.11).
• The FC parameter which represents connection of the connectors (chapter 9.1.4.12).
• The FM parameter which represents the connection between lighting fixtures (chapter 9.1.4.13).
• The BA12 parameter which represents the existence or not of a T splitter block (chapter 9.1.4.14).
• The BA15 parameter which represents the existence or not of a star splitter block (chapter 9.1.4.15).
• The CHOIXCONN parameter which represents the default selection of a connector type (chapter 9.1.4.16).
• Save the changes in the ref_conf.cfg file and close the file.
9.1.3 Characteristics of the Canalis line

For each product family, the characteristics of the Canalis line are managed by two parameters which are:
• The OPT parameter representing the options available for the product.
• The CALMAX parameter representing the maximum authorized rating for the product.
The characteristics of the line are represented in the tool in the left-hand part of the data entry window displayed during creation of a
Canalis line. These characteristics are always located in the same place in the main window of the tool.
The following figure gives an example for correct identification of the characteristics on screen:
Page 20 / 60
9.1.3.1 OPT parameter: Available options
The options available on a product are managed by the word OPT.
Each product has its own options which are independent of the others.
An option is defined in the following form: OPT<num>=<select>

where <num> represents the option number;
<select> represents the status of the option during creation of a Canalis line.
• The value 0 indicates that the option has not been selected.
• The value 1 indicates the contrary.
If the figure representing the selection status of an option (word <select>) is the same for all the options of a product,
then the OPT0 option is selected by default.
The following table presents all the options available for each product:
Option available Value associated with this option (value displayed in the tool)
For the KDP range
OPT0 None
For the KBA range
OPT0 None
OPT1 Painting
OPT2 Bus
OPT3 Painting + bus
For the KBB range
OPT0 None
OPT1 Painting
OPT2 Bus
OPT3 Painting + bus
OPT4 Specific earth
For the KNA range
OPT0 None
OPT1 Bus (not valid for the 160 A rating)
For the KSA range
OPT0 None
For the KBX range
OPT0 None
Possible actions:
• Remove an option. This is done by deleting the corresponding line in the ref_conf.cfg file. It is also possible to place the file line
as commentary by adding a semi-colon at the start of the file line.
• Select a default option. To select a default option when creating a Canalis line, the value of <select> should be set to 1. For
example, if there is OPT3=1, the OPT3 option will be selected by default.
Example of declaration of option for the KBA product family.
[KBA] The value OPT1 ("White") is

OPT0=0 no longer proposed.
;OPT1=0
OPT2=0
OPT3=1
9.1.3.2 CALMAX parameter: The rating of a Canalis line

The rating of a Canalis line for each product is managed by the word CALMAX.
In fact, the word CALMAX defines the maximum authorized rating for each product.
A rating is defined in the following form: CALMAX=<val_max>

where <val_max> represents the maximum authorized rating.
The following table presents all the ratings available for each product:
Rating available
For the KDP range
20 (fixed value unmodifiable in the tool)
Page 21 / 60
For the KBA range
25, 40
For the KBB range
25, 40
For the KNA range
40, 63, 100, 160
For the KSA range
100, 160, 250, 400, 500, 630, 800, 1000
For the KBX range
25 (fixed value unmodifiable in the tool)
It is not possible to add new ratings to a product because they are defined by the Schneider catalogue.
However, it is possible to reduce the range of ratings proposed for each product.
Possible actions:
• Remove a rating. This is done by initializing the value of CALMAX to a value less than the rating to be removed.
• Remove the CALMAX parameter by placing a semi-colon at the start of the line. The product family is no longer displayed in the
tool and it is impossible to create a Canalis line on this type of family. The same applies if CALMAX equals zero.
Examples of declaration of a rating for the KSA product family.
[KSA] [KSA] Only the 100, 160 and

CALMAX=1000 All the ratings CALMAX=300 230 A ratings are
are available. available.
9.1.4 Types of elements available for a Canalis line

These line characteristics are represented in the tool during creation of a Canalis line.
9.1.4.1 ALIM parameter: Choice of type of power supply for a Canalis line
The choice of type of power supply of a Canalis line for each product is managed by the word ALIM.
The type of power supply is defined in the following form: ALIM<num>=<val>

where <num> represents the power supply number;
<val> can take the values:
0 to indicate that the value is not selected by default;
1 to indicate that the value is selected by default;
Page 22 / 60
2 to indicate that the value is not selected by default and to authorize scroll boxes on the entry of quantities;
3 to indicate that the value is selected by default and to authorize scroll boxes on the entry of quantities.
If all the values for a power supply are at 0, then the first ALIM line of the ref_conf.cfg file is selected
by default for a given product family.
It is not possible to add new options to a product because they are defined by the Schneider catalogue.
However, it is possible to:
• Reduce the range of power supplies proposed for each product by placing a semi-colon before the line;
• Modify the selection of elements in the option window.
Examples of declaration of power supply for the KBA product family.
[KBA]
ALIM1=1
ALIM2=0
[KBA]
ALIM1=2
ALIM2=3
Specific feature for the KSA range.

ALIM0 equals "power supply end-piece" (100 A) when the rating equals 100 A exclusively
ALIM1 equals "at end" when the rating is less than or equal to 250 A
ALIM1 equals "at end left" when the rating is strictly greater than 250 A
ALIM2 equals "central" for all ratings
ALIM3 equals "at end right" when the rating is strictly greater than 250 A
9.1.4.2 DROIT parameter: Choice of type of straight elements for a Canalis line
The choice of type of straight elements for a Canalis line for each product is managed by the word DROIT.
The type of straight elements is defined in the following form: DROIT<num>=<val>

where <num> represents the straight element number;
If all the values for a straight element are at 0, then the first DROIT line of the ref_conf.cfg file is selected
• Reduce the range of straight elements proposed for each product by placing a semi-colon before the line;
• Modify the selection of elements in the option window.
Page 23 / 60
Examples of declaration of a straight element for the KDP product family.
[KDP]
DROIT1=0
DROIT2=0
DROIT3=0
DROIT4=0
DROIT5=0
DROIT6=0
[KDP]
DROIT1=0
DROIT2=0
DROIT3=0 By default
DROIT4=1
DROIT5=0
DROIT6=0
9.1.4.3 Specific feature of the DROIT parameter for the KBA range
In this range, the straight elements are defined by 4 values, namely DROIT0, DROIT1, DROIT2 and DROIT3.
But these values are grouped together in 2 groups:
• The first contains the value DROIT0. This group is available (and displayed in the tool) only when there is only a single
lighting fixture at least every 6 m of line.
• The second contains the values DROIT1, DROIT2 and DROIT3. This group is always used and displayed in the tool.
The only restriction concerns the value DROIT1 ("2 branches per element") which is available when the rating equals 25
A.
A distinction must therefore be made between 2 groups to display possible straight element values.
• 1st group:
DROIT0 equals "3 m - 0 tap-offs".
The values are:
0 to indicate that the value "Do not optimize" is selected by default.
1 to indicate that the value "Use length without outlet" is selected by default.
A value of 2 or 3 for DROIT0 is equivalent to value 1 with, in addition, the display of scroll boxes to increment the
quantity.
• 2nd group:
DROIT1 equals "2 tap-offs per element".
The values are:
Page 24 / 60
Below is an example illustrating this feature:

Ref_conf.cfg file
With Gives
[KBA]
DROIT1=0
DROIT2=1
DROIT3=0
DROIT0=1
The same file configuration with a line length of 5 m instead of 6 m gives the following dialogue box in which DROIT0 (which
corresponds to the message "3 m – 0 tap-offs") has disappeared because there is not 1 lighting fixture every 6 m of line:
If a semi-colon is positioned at the start of the DROIT0 line in the ref_conf.cfg file, the message
"3 m – 0 tap-offs" never appears.
9.1.4.4 Specific feature of the DROIT parameter for the KBB range
In this range, the straight elements are defined by 2 values, namely DROIT0 and DROIT2.
But these values are grouped together in 2 groups:
• The first contains the value DROIT0. This group is available (and displayed in the tool) only when there is only a single
lighting fixture at least every 6 m of line.
• The second contains the value DROIT2. This group is always used and displayed in the tool.
A distinction must therefore be made between 2 groups to display possible straight element values.
• 1st group:
DROIT0 equals "3 m - 0 tap-offs".
The values are:
0 to indicate that the value "Do not optimize" is selected by default.
1 to indicate that the value "Use length without outlet" is selected by default.
A value of 2 or 3 for DROIT0 is equivalent to value 1 with, in addition, the display of scroll boxes to increment the
quantity.
• 2nd group:
DROIT2 equals "3 m – 3 tap-offs" implying 3 branches per 3-metre element.
The values are:
Page 25 / 60
Below is an example illustrating this feature:
Ref_conf.cfg file With Gives
[KBB]
DROIT2=0
DROIT0=1
The same file configuration with a line length of 5 m instead of 6 m gives the following dialogue box in which DROIT0 (which
corresponds to the message "3 m – 0 tap-offs") has disappeared because there is not 1 lighting fixture every 6 m of line:
If a semi-colon is positioned at the start of the DROIT0 line in the ref_conf.cfg file, the message
"3 m – 0 tap-offs" never appears.
9.1.4.5 COMPL parameter: Type of complementary elements for a Canalis line

The type of complementary elements for a Canalis line straight elements for each product is managed by the word COMPL.
The type of complementary elements is defined in the following form: COMPL<num>=<val>

where <num> represents the complementary element number;
If all the values for a straight element are at 0, then the first COMPL line of the ref_conf.cfg file is selected
It is just possible to eliminate the presence of the complementary element proposed for each product by placing a
semi-colon before the line.
Examples of declaration of a complementary element for the KBB product family.
[KBB]
COMPL1=0
[KBB]
;COMPL1=0
Page 26 / 60
Specific feature for the KBA range
COMPL1 indicates a 2-metre straight element with 2 branches if the rating is 25 A and with no option.
COMPL2 indicates a 2-metre straight element with 3 branches in the other cases.
The message on screen ("Additional element – 2 m") is the same for all the characteristics. Only the reference will
change.
9.1.4.6 FIX parameter: Method for fastening the busbar trunking to the structure
The fastening method for each product is managed by the word FIX.
The method is defined in the following form: FIX<num>=<val>

where <num> represents the fastening method number;
If all the values for a fastening method are at 0, then the first FIX line of the ref_conf.cfg file is selected
• Reduce the range of fastening methods proposed for each product by placing a semi-colon before the line;
• Modify the selection of the fastening method in the option window.
Meaning of FIX parameters according to the range

For KBA/KBB For KDP
FIX1= By rod FIX1 = Perforated sheet metal cable tray
FIX2 = By steel cable 3m (supplied) FIX2 = Welded meshed cable tray
FIX3 = By chain FIX3 = Metal frame
FIX4 = Wall and false floor FIX4 = Wood or concrete slab
FIX5 = Adjustable for threaded rod FIX5 = No fixing unit (VDI support) For KN
For KS FIX1 = All fixing methods
FIX1 = All fixing methods FIX2 = Wall (max. fixing distance = 2 m)
FIX5 = Adjustable for threaded rod
Examples of declaration of busbar trunking fastening method for the KBB product family.
[KBB]
FIX1=0
FIX2=0
FIX3=0
FIX4=0
FIX5=0
FIX2 ("by steel cable 3m

[KBB] (supplied)") has disappeared
FIX1=2 from the options.
;FIX2=2
FIX3=2
FIX4=3
FIX5=2
By default
Page 27 / 60
Specific feature for the KDP range
The option "No fixing unit (VDI support)" can never be selected by default. In other words, there is no
FIX5 parameter for the KDP range.
9.1.4.7 FIXL parameter: Method for suspension of lighting fixtures from the busbar trunking
The suspension method for each product is managed by the word FIXL.
The method is defined in the following form: FIXL<num>=<val>

where <num> represents the suspension method number;
2 to indicate that the value is not selected by default and to authorize scroll boxes on the entry of
quantities;
If all the values for a suspension method are at 0, then the first FIXL line of the ref_conf.cfg file is selected by default
for a given product family.
• Reduce the range of suspension methods proposed for each product by placing a semi-colon before the line;
• Modify the selection of the suspension method in the option window.
Meaning of FIX parameters according to the range

For KBA/KBB
FIXL1= Directly under
FIXL2 = Directly suspended
FIXL3 = Suspended on chain
Examples of declaration of lighting fixture suspension method for the KBB product family.
[KBB]
FIXL1=0
FIXL2=0
FIXL3=0
[KBB]
FIXL1=0
FIXL2=0
FIXL3=1
Page 28 / 60
9.1.4.8 SUPPL parameter: Supplementary equipment
The supplementary equipment for each product is managed by the word SUPPL.
The method is defined in the following form: SUPPL=<val>

where <val> can take the values:
1 to indicate that all the equipment can be selected by the user;
0 to indicate that just a selection of supplementary equipment is available (restricted choice)
It is just possible to eliminate the presence of the supplementary equipment proposed for each product by placing a
It is not possible to choose the type of supplementary equipment one wants to select when in restricted choice mode.
Examples of declaration of supplementary equipment for the KBB product family.
[KBB]
SUPPL=1
[KBB]
SUPPL=0
9.1.4.9 CHOIXLUM parameter: Type of lighting fixtures mounted under the busbar trunking
The type of lighting fixtures for each product is managed by the word CHOIXLUM.
The method is defined in the following form: CHOIXLUM=<val>

1 to select fluorescent tubes by default;
2 to select balloon-type lighting fixtures by default.
Any other value of <val> will cause the value 1 to be adopted, it being specified that fluorescent tubes will be adopted by default.
It is just possible to select one default value.
This parameter is valid only for the KBA and KBB ranges.
Page 29 / 60
Examples of declaration of lighting fixture type for the KBB product family.
[KBB]
CHOIXLUM=1
[KBB]
CHOIXLUM=2
9.1.4.10 CHOIX4D parameter: Number of branches per metre

The number of branches per metre for each product is managed by the word CHOIX4D.
The method is defined in the following form: CHOIX4D=<val>

1 to select the value 2 by default, namely 2 branches per metre;
2 to select the value 4 by default, namely 4 branches per metre.
Any other value of <val> will cause the value 1 to be adopted, it being specified that 2 branches per metre will be adopted by default.
This parameter is valid only for the KSA range.
Example of declaration of the number of branches per metre for the KSA product family.
[KSA]
CHOIX4D=2
9.1.4.11 MC10 parameter: KDP connection elements - Connection of lighting fixtures

The connection of lighting fixtures for a Canalis line for each product is managed by the word MC10 (male connector).
Page 30 / 60
The connection of lighting fixtures is defined in the following form: MC10=<val>
0 to indicate that the quantity cannot be modified and is set to 0;
2 to indicate that the quantity can be modified and is set to 0, and to authorize scroll boxes on the entry of
quantities.
Any value other than the value 2 amounts to adopting the value 0 so as not to modify the quantity and to set it to 0.
This parameter is valid only for the KDP range with a lighting fixture power supply by shunting or star connection via
prefabricated connectors.
This parameter is validated in the "Prefabricated connectors" window by choosing the "Link traditional light/distributor block"
combo-box.
Examples of declaration of lighting fixture connection for the KDP product family (by shunting or star connection).
[KDP]
MC10=0
[KDP]
MC10=2
9.1.4.12 FC parameter: KDP connection elements - Connection to connectors

The connection to connector for a Canalis line for each product is managed by the word FC (female connector).
The connection to connector is defined in the following form: FC<num>=<val>

where <num> represents the various connector choices and takes the values 10, 30, 50
quantities.
Page 31 / 60
• Reduce the range of choices of connections to connector by placing a semi-colon before the line;
• Modify the default value of each choice of connection to connector.
This parameter is validated in the "Prefabricated connectors" window by choosing the "Link Canalis connector/male plug" combo-
box.
Examples of declaration of connection to connector for the KDP product family (by shunting or star connection).
[KDP]
FC10=2
FC30=2
FC50=2
[KDP]
FC10=0
FC30=2
;FC50=2
The 5 meter length is
no longer proposed.
9.1.4.13 FM parameter: KDP connection elements - Connection between lighting fixtures

The connection between lighting fixtures for a Canalis line for each product is managed by the word FM (female-male connector).
The connection between lighting fixtures is defined in the following form: FM<num>=<val>
where <num> represents the various connection choices and takes the values 20, 30, 40, 50, 70, 90
quantities.
• Reduce the range of choices of connections by placing a semi-colon before the line;
• Modify the default value of each choice of connection between lighting fixtures.
Page 32 / 60
This parameter is validated in the "Prefabricated connectors" window by choosing the "Link light male plug/distrib. Block or tee/tee"
combo-box.
Examples of declaration of connection between lighting fixtures for the KDP product family (by shunting or star
connection).
[KDP]
FM20=2
FM30=2
FM40=2
FM50=2
FM70=2
FM90=2
The 5 meter length is

no longer proposed.
[KDP]
FM20=0
FM30=2
FM40=2
;FM50=2
FM70=2
FM90=2
9.1.4.14 BA12 parameter: KDP connection elements by shunting – Tee splitter block (1 input/2 outputs)
The presence of a Tee splitter block is managed by the word BA12.
The presence of a Tee splitter block is defined in the following form: BA12=<val>
quantities.
This parameter is valid only for the KDP range with a lighting fixture power supply by shunting via
It is possible to mask the power supply of lighting fixtures in KDP by shunting by placing a semi-colon at the start of the
BA12 line in the ref_conf.cfg file.
combo-box.
Page 33 / 60
Examples of declaration of lighting fixture connection for the KDP product family (by shunting).
[KDP]
BA12=0
Power supply by
[KDP] shunting is masked.
;BA12=2
9.1.4.15 BA15 parameter: KDP connection elements by star connection – Tee splitter block (1 input/5 outputs)
The presence of a Tee splitter block is managed by the word BA15.
The presence of a Tee splitter block is defined in the following form: BA15=<val>
quantities.
This parameter is valid only for the KDP range with a lighting fixture power supply by star connection via
It is possible to mask the power supply of lighting fixtures in KDP by star connection by placing a semi-colon at the start
of the BA15 line in the ref_conf.cfg file.
combo-box.
Page 34 / 60
Examples of declaration of lighting fixture connection for the KDP product family (by star connection).
[KDP]
BA15=0
[KDP]
;BA15=2
Power supply by star

connection is
masked.
9.1.4.16 CHOIXCONN parameter: Default selection of the type of branch connectors

The type of connector selected by default for each product is managed by the word CHOIXCONN.
The method is defined in the following form: CHOIXCONN=<val>

0 to select nothing and display a check-box alongside the name of the group;
1 to select group 1 and a connector of this group, and to display a check-box alongside the name of the
group;
2 to select group 2 and a connector of this group, and to display a check-box alongside the name of the
group.
Any other value of <val> will cause the value 0 to be adopted, it being specified that no connector will be selected.
It is possible to:
• Delete the selection of a connector type by placing a semi-colon before the CHOIXCONN line, or by
setting the parameter to the value 0;
• Modify the default selection of a connector.
Page 35 / 60
Examples of declaration of selection of a connector type for the KBB product family.
[KBB]
CHOIXCONN=0
No check-box is selected.
[KBB] By default
CHOIXCONN=2
9.1.4.17 FERM1 parameter: Presence of a closing end-piece for the power supply of a Canalis line
The presence of a closing end-piece for the power supply of a Canalis line for each product is managed by the word FERM1.
It is defined in the following form: FERM1=0
This parameter applies only for the KSA range.
It is just possible to eliminate the presence of the power supply end-piece proposed for each product by placing a
Examples of declaration of a closing end-piece for the KSA product family.
[KSA]
ALIM0=1
ALIM1=0
ALIM2=0
ALIM3=0
FERM1=0
[KSA]
ALIM0=1
ALIM1=0
ALIM2=0
ALIM3=0 The closing end-piece
;FERM1=0 has disappeared.
Page 36 / 60
9.1.4.18 Summary of parameters used for each range in the ref_conf.cfg file
The table below shows all the parameters of the ref_conf.cfg file and their use for each product range:
Parameter Range
KDP
KDP KDP by star
Name Use KSA KNA KBB KBA
direct shunting connecti
on
Definition of the options available for a product
OPT X X X X X X X
range
CALMAX Choice of maximum rating for a Canalis line X X X X X X X
Choice of type of power supply for a Canalis
ALIM X X X X X X X
line
Presence of a closing end-piece for the power
FERM1 X
supply of a Canalis line
Choice of type of straight elements for a
DROIT X X X X X X X
Canalis line
Type of complementary elements for a Canalis
COMPL X X X
line
Method for fastening the busbar trunking to the
FIX X X X X X X X
structure
Method for suspension of lighting fixtures from
FIXL X X
the busbar trunking
SUPPL Supplementary equipment X X X X X X X
Type of lighting fixtures mounted under the
CHOIXLUM X X
busbar trunking
CHOIX4D Number of branches per metre X
KDP connection elements - Connection of
MC10 X X
lighting fixtures
KDP connection elements - Connection to
FC X X
connectors
KDP connection elements - Connection
FM X X
between lighting fixtures
KDP connection elements by shunting – Tee
BA12 X
splitter block
KDP connection elements by star connection –
BA15 X
Tee splitter block
Choice of connector type and selection of a
CHOIXCONN X X X
default connector
When a parameter is not commonly used for a range, the cell is grey.
When a parameter is used to define a range, a cross is present in the corresponding cell.
As a reminder, there is no need to define parameters for a range when, by default, at delivery of a version of
the tool, these parameters are not defined.
9.2 Customization of the lighting comparison

This chapter applies to the CanBRASS tool in reference mode.
It is possible to perform 3 actions:

• Change the calculation rules set out under the "QTE" column of the ref_comp.dbf file.
• Delete an IT item (i.e. a line of a solution indicating a characteristic taken into account in the comparison, for example a
25A power supply box. See following pages for more information) under Excel implying the deletion of the element in
the comparison.
• Activate or not the request for display of the comparison for the KBA and KDP ranges.
9.2.1 Comparison calculation method

9.2.1.1 Description
The parameters setup for the connector and tap-off unit offering is described in the ref_comp.dbf file which is located in the
[INSTALL_DIR]\DBF directory.
The file is in Dbase format but can be opened with Excel.
This file contains a set of conventional installation solutions (with cable) and provides a basis for comparison of these solutions with
Page 37 / 60
the Canalis solution. This comparison thus makes it possible to assess the cost of installation of a Canalis busbar trunking and a
conventional cable tray solution.
By means of this file, it is possible to modify the conventional installation solutions and their formulas used.
This comparison is performed only on the KBA and KDP ranges.
When the user wants to estimate the cost of a KDP or KBA range and once he has entered the length of the line and the number of
lighting fixtures or connections, the user is prompted to run the Canalis/conventional solution comparison for lighting distribution. By
clicking on the "Yes" button, the window showing the comparison is displayed. The information displayed is based on the
ref_comp.dbf file.
Unless specially needed (extreme case, for example, in which the prices in a country meant that the comparison would not be
interesting enough to adopt a Canalis solution), there is no need to modify this file.
9.2.1.2 Setup
• Open the ref_comp.dbf file with Excel.
• Set the values wanted for each solution, i.e.:

• Change the calculation rules set out under the "QTE" column of the ref_comp.dbf file.
• Delete a line of a solution (delete an IT item) under Excel implying the deletion of the element in the
comparison.
Do not change the remainder of the information, nor add new solutions
or extra Excel lines to an existing solution.
• Save the changes in the ref_comp.dbf file in "DBF4 (dBASE IV)" format.
The following table explains the various columns of the file:
Name of
column
Possible values Explanations
under
Excel
PROD KBA This column defines the range to which the
KDP (all KDP solutions) solution will be compared.
KDP1 (KDP direct) E.g.: if KBA then the solutions will appear
KDP2 (KDP shunting) during costing in KBA
KDP3 (KDP star)
It is possible to make combinations:
• KDP1-KBA (for KDP direct and KBA)
• KDP2-KDP3 (for KDP shunting and
star)
SOLUTION S1 Solution concerned. The descriptions of
S2 these solutions correspond to messages S1
…S10 to S10 in the CNB_<telephone code>.txt file
Note: Cells whose content is of the "*

<text> *" type are commentary cells and
are not read by the tool.
PARAM LNPE Allows distinction between an item and/or a
3LNPE formula depending on the polarity.
LIB IT01 Item concerned. The descriptions of these
IT02 items correspond to messages IT01 to IT40
…IT40 in the CNB_<telephone code>.txt file
Page 38 / 60
QTY The authorized operators are: Calculation formula for the quantity of
"+", "-", "*", "/", "=" items according to the line's parameters.
The authorized parameters are:
[length] Length of the line in m Do not enter brackets, the "=" sign can set a
(entered by the user) priority (e.g. 3+1=*2 equals 8)
[step] Installation spacing of the line in m
• Entered by the user in KBA (by default 3 m), entered with By default, the result is rounded off to the
the length of the line by the "…" button. nearest integer value, unless the "%" sign is
• Defined as 0.5 m in KDP. explicitly added at the end of the formula
[tapoff] No. of connections or branches (e.g. Qty per linear metre)
• This is the number of lighting fixtures entered by the user in
KBA and KDP direct.
• It is the number of connections entered by the user in KDP
(shunting or star connection).
[lampfix] No. of fasteners per lighting fixture (defined by the tool)
• Defined as 2 fasteners in KBA.
• Not used in KDP.
[lamp] • No. of lighting fixtures
Not used in KBA and KDP direct
• This is the total number of lighting fixtures entered by the
user by clicking on the "Setting of lighting zones" button.
This represents the amount of lighting fixtures for each area.
[te] No. of Tee connectors
• Not used in KBA and KDP direct.
• This is the number of Tee connectors deduced from the
number of lighting fixtures per area in KDP by shunting.
• If there are several lamps in an area, this represents the
number of lighting fixtures in the area minus 1.
• If there is only one lighting fixture defined for the area,
there are zero Tee connectors because this is not
necessary.
• The number of Tee connectors is set at 1 in KDP in star
connection.
TYP U Information concerning the item: unit
lm quantity or per linear metre
VAL Canalis references For Canalis solutions, the item corresponds
to a product reference. The price and
installation time will be retrieved from the
current price database (article.dbu file).
(empty) For conventional solutions, the field is left
empty by default. The price of each item is
entered from the application, in the "Other
prices" dialogue box of the comparison.
IT?? The price of this item may be the same as
that of another. Only the descriptions will
be different.
Step=? Value in metres of the line's installation
spacing, as used in the formulas.
9.2.1.3 Description of solution S1

Let us take the example of solution S1 to better understand the file and identify the key information in this file.
The excerpt from the ref_comp.dbf file for this solution is:
Page 39 / 60
Through the "PROD" column, it can be seen that this solution applies only in the case of costing of a KBA line.
After entering the information concerning the line, as follows:
The Length parameter of the ref_comp.dbf file represents this value.
The TapOff parameter of the ref_comp.dbf file represents this value.
Simply click on the "Continue" button, then on the "Yes" button in reply to the following question:
The window corresponding to the comparison then appears:
Description of S1
Description of IT01
Description of IT02
Description of IT04
Description of IT24
Description of IT05
Description of IT06
Description of IT07
9.2.2 Activate the request for comparison with a conventional solution

We have just seen that the comparison could be presented for the KDP and KBA ranges. At this point, the tool prompts the user to
confirm whether or not he wants to display the comparison of a Canalis solution with a conventional solution. This is the default
processing operation.
But this processing operation can be parameterized.
9.2.2.1 Description
The request to display the comparison with a conventional solution is described in the CNB.INI file located in the [CP_DIR] directory
(only for testing, a check can be performed with that in the [APPDATA_DIR] directory).
The file is in text format and can be read with any text editor of the Windows Notepad type.
Page 40 / 60
9.2.2.2 Setup
To set the request parameters, you must:
• Open the CNB.INI file with Notepad.
• Set the Disabled parameter of the Comp section to the following value:
• 0 for the tool to ask the user whether the comparison should be displayed or not.
• 1 for the tool not to ask the user whether the comparison should be displayed or not.
• Save the changes in the CNB.INI file.
Example
CNB.INI file
[Comp]
Disabled=0
CNB.INI file
The question is no longer put to the user.
[Comp]
Disabled=1
9.2.3 Definition of prices and labour for a conventional solution

It is possible to define the default unit net price and labour for a conventional solution.
When the tool has just been installed, these values are set to zero. The user can change them at any time.
9.2.3.1 Description
The definition of prices and labour for a conventional solution is described in the CNB.INI file located in the [CP_DIR] directory (only
for testing, a check can be performed with that in the [APPDATA_DIR] directory).
The file is in text format and can be read with any text editor of the Windows Notepad type.
9.2.3.2 Setup
To set the request parameters, you must:
• Open the CNB.INI file with Notepad.
• Set the following parameters of the Comp section:

• IT19
• IT20
• IT21
• IT22
• IT23
• IT24
• IT25
• IT26
• IT27
• IT29
• IT30
• IT31
• IT33
• IT35
• IT37
• LT
For the changes to be taken into account, you should, if necessary, close and restart the tool, because the
CNB.INI file is read by the tool when it is started.
Page 41 / 60
Parameters IT19 to IT37 are defined as follows: <param>=<price> ;<LT>
Where <param> represents the name of the parameter;
<price> represents the unit net price in cents (e.g. the value 100 equals 1 euro, assuming that the currency is
the euro).
<LT> represents the labour time in hours divided by 100 (e.g. the value 80 equals 0.8 hours of labour time).
To find out what the IT parameter corresponds to, simply search for the value of this parameter
in the CNB_<telephone code>.txt language file.
For example, IT19 corresponds to "Cable U1000R02V 3 x 1.5 mm²".

Therefore, when you have "IT19=500 ;10" and the currency is the euro, this means that 1 metre of cable costs 5 euros
and requires 0.1 hour to be installed.
The MO parameter is defined as follows: MO=<rate>

where <rate> represents the hourly rate for one hour of labour time.
The values of the parameters are displayed in the tool by the "Net price and labour time of traditional
solutions" window when you click on the "Other prices" button of the "Canalis/Cable comparative" window.
CNB.INI file
[Comp]
MO=2600
IT19=24;5
IT20=27;5
IT21=9,15;2
IT22=658,54;60
IT23=115,85;10
IT24=163,11;20
IT25=152,44;20
IT26=167,68;20
IT27=9,15;0
IT29=25,91;30
IT37=73,17;42
9.3 Customization of the connector and tap-off unit offering

The connector and tap-off unit offering can be customized by:
• defining the connector types;
• selecting a default connector type.
It applies to the CanBRASS tool in linear metre mode and for each product reference.
9.3.1 Definition of connector types

9.3.1.1 Description
Customization of the offering is described in the ref_coff.dbf file located in the [INSTALL_DIR]\DBF directory.
The file is in Dbase format but can be opened with Excel.
Via this file, it is possible to configure, for each product family (KNA, KDP, etc.) the tap-off units and connectors.
9.3.1.2 Setup
Page 42 / 60
• Open the ref_coff.dbf file with Excel.
• Set the values wanted for each range, i.e.:

• If necessary, change the characteristics of a connector (descriptive text of the TYP1 or TYP2 column
representative of the description of the connector).
• Remove a tap-off unit or a tap-off unit range (elimination of a group or sub-group) by deleting the
corresponding line(s) under Excel. This then implies removal of the connector from the offering.
• Remove the second rating out of the 2 proposed, i.e. for the selected tap-off unit empty the cells of columns
CAL2, IP2, TYP2 and REF2.
• Remove the first rating out of the 2 proposed, i.e. for the selected tap-off unit copy the values from the cells of
columns CAL2, IP2, TYP2 and REF2 into CAL1, IP1, TYP1 and REF1 and empty the cells of columns CAL2,
IP2, TYP2 and REF2.
Do not change the remainder of the
information or add extra Excel lines.
• Save the changes in the ref_coff.dbf file in "DBF4 (dBASE IV)" format.
For the CanBRASS tool, the local tap-off units must be added in the article.dbu file (tap-off units visible after
import in the "Local" tab by running article.exe (see chapter 7.3 above for more explanations).
9.3.1.3 File characteristics

The file takes the following form with 12 columns:
The title and description of each column of the file are detailed below:
• PROD column: This indicates the product range concerned by the tap-off unit (KBA, KDP, KN or KS).
• PARAM column: This specifies the tool concerned by the connector or the tap-off unit.
The possible values are:
• Lin. In this case, the offering is reserved for costing per linear metre.
• Ref. In this case, the offering is designed for costing by product reference.
• (empty). In this case, the offering is designed for the CanBRASS tool.
• ***. In this case, no tool uses this tap-off unit.
The values to be noted are the "Ref" value and no value (empty cell).
• POS column: This defines the order of display of the tap-off units in the "connectors and tap-off units" dialogue boxes
of the tool, with the syntax d-s.
• The first figure d, from 1 to 4, specifies the order of display of the group of tap-off units for each product range.
• The second figure s, from 1 to 3, specifies the order of display of the sub-group for each group in the combo-
box, or is equal to 0 if there is no associated sub-group.
Page 43 / 60
1st figure d from 1 to 4:
Tap-off unit group number 1

2nd figure s from 1 to 3:
Sub-group number 1
Sub-group number 2
Sub-group number 3
If the sub-group number is at 0, the combo-box is

not displayed.
• FCT column: This identifies the tap-off unit by a function number. These numbers are unique for each product range.
• POL column: This identifies the various types of polarity to be displayed in the tool for each group or sub-group
number.
• IP1 or IP2 column: This specifies the tap-off unit's degree of protection to be displayed in the tool for each group or
sub-group number (2 possible choices).
Page 44 / 60
• CAL1 or CAL2 column: This specifies the tap-off unit's rating to be displayed for IP1 or IP2 respectively in the tool for
each group or sub-group number.
• TYP1 or TYP2 column: This specifies the description of the tap-off unit to be displayed for IP1 or IP2 respectively in
the tool for each group or sub-group number.
Description of each
tap-off unit:
1 line per tap-off
unit.
• REF1 or REF2 column: This defines the tap-off unit's reference to be taken into account for costing the Canalis line for
IP1 or IP2 respectively.
The description of each tap-off unit is displayed in the order in which they are defined in the ref_coff.dbf file for each
group or sub-group.
The character strings corresponding to the choice of connectors and tap-off units can be modified in the
CNB_<telephone code>.txt file.
9.4 Customization of price quotes

9.4.1 Overview
Printing of a price quote is performed from an Excel file serving as a model, using the Microsoft Excel software.
At tool installation, the following model files are proposed by default:

• In French:
• Modele_Impression_Rapide.xls
• Modele_Impression_Schneider.xls
• In English:
• Fast_printing_model.xls
• Schneider_printing_model.xls
All these files are Excel files in "Microsoft Excel 2000 workbook" format located in the [INSTALL_DIR]\MODELS directory.
By means of these files, it is possible to configure and customize printing of a price quote:
• By modifying the content of the existing model files.
• By creating new model files from the existing models.
Page 45 / 60
9.4.2 Setup
To customize the content of a model file, you must:
• Open one of the existing model files with Excel.
• Change its content by:

• Translating the text of the model price quote contained in the file;
• Choosing the columns to be printed in costing;
• Determining the data managed by the tool that you want to print on the price quote;
• Adding a new page in the price quote;
• Deleting an existing page.
• Save the changes in the model file.
To create new files, you must start again from the existing Modele_Impression_Rapide.xls file in French or
Fast_printing_model.xls in English, then adapt and/or translate it.
The procedure to follow is therefore as follows:
• Copy one of these two files, then rename it with Windows Explorer.
• Apply the procedure described in detail above to customize the content of a model file.
To modify a model file, the CanBRASS tool must not be running.
Also, conversely, before running the tool, it must be ensured that the model file is indeed closed under Excel and that
Excel is closed.
9.4.3 Characteristics of a model file

The complete adaptation of model price quote files is explained in the document entitled
Adaptation_Devis_CanBRASS_EN.pdf.
10 CUSTOMIZING THE CNB.INI FILE

10.1 Description
Parameters setup for the CanBRASS tool is described in the CNB.INI file located in the [CP_DIR] directory (only for testing, a check
can be performed with that in the [APPDATA_DIR] directory).
10.2 Setup
• Open the CNB.INI file with a text editor.
• Perform the following actions if need be:

• Allowance for the display language
• Choice of website
• Designation of backup directories for the generated files
• Preference concerning the grouping of identical product references
• Definition of user characteristics
• Preferences concerning the grouping of indivisible quantities
Page 46 / 60
• Preferences concerning the display of a Help window on the tool
• Display of the KDP range at a predetermined date
• Display of a promotional or informative document
• Discounts by family
• Change of SplashScreen when starting the tool
10.3 Allowance for the display language

Once the CNB_<telephone code of country>.txt file has been created, it can be specified that the tool should use this file when it is
started rather than that in French or English.
To do this, the ID parameter must be set to the value corresponding to the telephone code of the country in the Language section.
Example of customization of the display language
CNB.INI file
[Language]
ID=33
CNB.INI file
As a reminder:
[Language] The flag is defined by the value of this ID parameter.
ID=044 The text "English UK" is located in the
CNB_<telephone code of country>.txt text file in the
form:
[LANG]
00000=English UK
10.4 Choice of website

In the tool, the Help/Website menu allows Internet Explorer to be opened on a default Web address (the Schneider site is chosen by
default).
To change this default Web address, the Web parameter must be set to the value of the website wanted in the Language section.
Example of customization of the website
CNB.INI file
[Language]
Web= www.schneider-electric.com
10.5 Designation of backup directories

The backup directories represent the default location on the disk where the files representing the various projects will be saved (files
with .ref extension) together with the price quote generation files in xls, csv and xml format.
It is possible to set these directories in CanBRASS by:

• Setting the Projects parameter to the value corresponding to the backup directory for the .ref, .xls and .csv files in the
Database section.
For the backup directories defined in the CNB.INI file to be taken into account, these directories must exist on the
computer on which the tool is installed, or otherwise the tool retrieves the default values defined in the tool itself.
In no case will the tool create directories if they do not exist.
Page 47 / 60
By default, at first starting of the tool, the Projects parameters defined in the
CNB.INI file are not written to the file and the tool takes the default values defined
in the tool itself.
It is only when the backup directories are modified that the parameters are written to the
CNB.INI file.
Example of customization of the default backup directories
CNB.INI file
[Database]
Projects=C:\Documents and Settings\fko\Mes
documents\Devis CanBRASS
10.6 Definition of user characteristics

The user characteristics allow the person using the tool to be identified. This information is displayed in the CanBRASS tool and by
selecting the File/User’s environment menu, then the User tab.
To set default values, you must:

• Set the Name parameter to the value corresponding to the name of the person in the User section.
• Set the Dept parameter to the value corresponding to the name of the department in which the person in the User section
works.
• Set the Phone parameter to the value corresponding to the phone number of the person in the User section.
• Set the Fax parameter to the value corresponding to the fax number of the person in the User section.
• Set the EMail parameter to the value corresponding to the email address of the person in the User section.
By default, at first starting of the tool, only the Name parameter defined in the
CNB.INI file is written to the file. The other values remain empty.
It is only when these values are modified that the parameters are written to the CNB.INI file.
Example of customization of the user characteristics
CNB.INI file
[User]
Name=Schneider Electric
Dept=Service 1
Phone=07.12.11.12.13
Fax=07.12.11.12.14
Email=name@schneider.com
Page 48 / 60
10.7 Preferences concerning the grouping of indivisible quantities and the display of reference designation
The tool allows a product reference to be ordered in quantities that are indivisible or not. It is possible to group together indivisible
quantities.
To define this grouping, you must:

• Set the Packaging parameter to the value corresponding to grouping of indivisible quantities or not in the Database section.
• The value 0 does not group together the indivisible quantities for a product reference.
• The value 1 groups them together.
By default, at first starting of the tool, the Packaging parameter and the Database section defined in the
CNB.INI file is not written to the file and the tool takes the value 0 as default value.
It is only when the value is modified in the tool that the parameter is written to the CNB.INI file.
Example of customization of the grouping together of indivisible quantities for a product reference
CNB.INI file
[Database]
Packaging=0
10.8 Preferences concerning the language for displaying the designation of references
The tool displays in the bill of materials the references code and their designations. You can display the designations of references in
3 different languages:
• Local (meaning that the designations are displayed into the country language where the tool will be distributed)
• UK (meaning that the designations are displayed into the English language)
• Optional (meaning that the designations are displayed into a second country language where the tool will be distributed)
The “Local” option corresponds to the “Label 1” column title in the article.exe window.
The “UK” option corresponds to the “Label 2” column title in the article.exe window.
The “Optional” option corresponds to the “Label 3” column title in the article.exe window.
To define the language for displaying the designations of references, you must:
• Set the LANG_DESIGN parameter to the value corresponding to the language to display in the Database section.
• The value “LOCAL” is for the “Local” option.
• The value “UK” is for the “UK” option.
• The value “OPTION” is for the “Optional” option.
Note that this section is only dedicated to the display of the references designations into a language.
The language of the Software CanBRASS stays the same when you modify the language of the references designations.
In the CanBRASS tool, when another language is selected, the software has to be closed and reopened to take into
the modifications.
Page 49 / 60
Example of customization of the references designations
With article.exe window
The designation of reference

KBA25ABG4 is defined in 3
languages in “Label 1” to “Label 3”
column.
CNB.INI file
[Database]
LANG_DESIGN=LOCAL
CNB.INI file
[Database]
LANG_DESIGN=UK
CNB.INI file
[Database]
LANG_DESIGN=OPTION
10.9 Preferences concerning the display of a Help window on the tool

The tool allows 2 types of Help windows to be displayed:
• A window displayed at starting of the tool.
• A window displayed when starting to create a Canalis line, irrespective of the type of line.
To define the display of a Help window, you must:

• Set the Hlp parameter to the value corresponding to the display of the Help window for starting the tool in the Ref section
for CanBRASS in reference mode and in the Linear section for CanBRASS in linear mode.
• The value 0 displays the Help window.
• The value 1 does not display it.
• Set the Hlp2 parameter to the value corresponding to the display of the Help window for creation of a Canalis line in the
Ref section for CanBRASS in reference mode and in the Linear section for CanBRASS in linear mode.
• The value 0 displays the Help window.
• The value 1 does not display it.
By default, at first starting of the tool, the Hlp and Hlp2 parameters defined in the CNB.INI file
are not written to the file and the tool takes the value 0 as default value to display
the Help windows.
Page 50 / 60
Example of customization of the display of a Help window
CNB.INI file
[Ref]
Hlp=0
Hlp2=0
10.10 Display of the KDP range at a predetermined date

The tool allows the KDP range to be masked until a defined date for CanBRASS in reference mode.
To define the display of the KDP range, you must:

• Set the KDPday parameter to the value corresponding to the date of display of the KDP range in the Ref section. The date
must be in DD/MM/YYYY format.
By default, at first starting of the tool, the parameter is not defined in the
CNB.INI file, and the range is always displayed in the tool.
10.11 Display of a promotional or informative document

A document can be displayed on starting the tool from the date displayed by the KDPday parameter.
The document is represented by a filename that a third-party application will run after starting the tool. All file formats are accepted.
Simply make sure that the third-party application that will display the document will be installed on the computer on which the tool
will be installed.
To define display of the document at a given date, you must:

• Set the KDPdoc parameter to the value corresponding to the name of the file representing the document in the Ref section.
The filename is written without specifying a disk or directory.
• Set the KDPday parameter to the value corresponding to the date of display of the KDP range in the Ref section. The date
must be in DD/MM/YYYY format.
For the file to be installed with the tool, it must be positioned in the "COPY" directory of the
installation procedure.
After installation, the file is located in the [INSTALL_DIR] directory.
By default, at first starting of the tool, the parameter is not defined in the
CNB.INI file, and no document appears.
When the parameter is present, the file is displayed at each start-up of the tool until the Help window
displayed at opening is masked by the user.
Page 51 / 60
10.12 Discounts by family
It is possible to define discounts by family. These values are defined by default but can be modified by the tool.
Discounts are used in calculating the price as follows: Net price = List price x family discount.
To define discounts by family, you must:

• Set the discount factor for each product family (i.e. KDP, KBA, KBB, KNA, KSA, KBX) in the Ref section for
CanBRASS in reference mode and in the Linear section for CanBRASS in linear mode.
Example of discount by family for CanBRASS in reference mode
CNB.INI file
[Ref]
KDP=0.25
KBA=0.5
KBB=0.4
KNA=0.25
KSA=1.0
10.13 Preference concerning the grouping of identical product references

The CanBRASS tool in reference mode allows identical references to be grouped together or not.
To do this, the RefGrp parameter must be set to the value corresponding to grouping of the references or not in the Ref section:
• The value 0 does not group the references together.
• The value 1 groups them together.
By default, at first starting of the tool, the RefGrp parameter defined in the CNB.INI file is not written to the
file and the tool takes the default value defined in the tool itself.
Page 52 / 60
Example of customization of the grouping together of product references for CanBRASS in reference mode
CNB.INI file
[Ref]
RefGrp=1
10.14 Locking a mode of the CanBRASS tool

It is possible not to have one of the operating modes of the CanBRASS tool displayed.
To do this, you must:

• Set the NoML parameter to the value wanted in the Database section for the linear mode
• The value 0 allows the linear mode to be displayed and selected if need be.
• The value 1 deletes the linear mode from CanBRASS.
• Set the NoRF parameter to the value wanted in the Database section for the reference mode.
• The value 0 allows the reference mode to be displayed and selected if need be.
• The value 1 deletes the reference mode from CanBRASS.
• Set the No3D parameter to the value wanted in the Database section for the graphics mode.
• The value 0 allows the graphics mode to be displayed and selected if need be.
• The value 1 deletes the graphics mode from CanBRASS.
Example of locking of the graphics tool
CNB.INI file
[Database]
No3D=1
The button for

graphics mode is not
displayed.
Page 53 / 60
10.15 KBL management with KBB in the design guide
In CanBRASS in reference mode, it is possible, when a KBL lighting fixture is selected, not to have the window for choice between
the KBA and KBB ranges displayed in the design guide and hence to associate the KBL exclusively with the KBA range.

• Set the GDEGDC parameter to the value wanted in the Ref section.
• The value 1 allows a choice to be made between KBA and KBB when a KBL lighting fixture is chosen.
• The value 0 authorizes only KBA when a KBL lighting fixture is chosen.
Example of KBL management in the design guide
CNB.INI file
[Ref]
GDEGDC=1
CNB.INI file
[Ref]
GDEGDC=0
Direct access to
KBA line creation
11 CHANGE OF WELCOME IMAGE WHEN STARTING THE APPLICATION

The CanBRASS tool allows a pattern or a splashScreen (welcome image) to be displayed when opening the tool.
This image is a compressed bitmap (file with .jpg extension).
To change the image to be displayed, you must:

• Create a jpg file or retrieve the file you want.
• Rename it splash.jpg.
• Place it in the "COPY" directory of the installation program.
After installation, this file is placed in the [INSTALL_DIR] directory.
Page 54 / 60
12 TRANSLATION OF THE ARTICLE.EXE UTILITY
The goal of this chapter is to translate all the character strings displayed in the article.exe utility into a new language.
These character strings include the menus, buttons and the information displayed in the various windows.
The data for the tool (reference descriptions) are not taken into account in this chapter.
This chapter applies only to the CanBRASS tool in which the article.exe utility is supplied.
12.1 Overview
All the character strings of the utility are grouped together in a single text file with a .cfg extension.
The file is named article.cfg. It is located in the [INSTALL_DIR] directory.
The file can be opened with any text editor of the Windows Notepad type.
12.2 Incorporation of a new language

12.2.1 Setup
For the tool to be able to manage a new language, you must:
• Open the article.cfg file with a text editor of the Windows Notepad type
• Create a section [Lang3] by copying all the content of section [Lang1] if translation is performed from French, or all the
content of section [Lang2] if translation is performed from English.
If a [Lang3] section already exists, then a [Lang4] section must be created, and so on.
I
• In the "0000=<name of language>" field, put the name of the language into which the tool is translated. This name
appears in the tool in the "Display/Language" menu.
Example with French
IL
article.cfg file
[Lang1]
0000=Français
0001=33
• In the "0001=<telephone code of country>" field, put the telephone code of the country in which the tool is translated.
• Translate the other character strings contained in the file.

Each line of the file is of the form "identifier = text to be translated". The "identifier" field must not
be modified.
[Lang1] Example
0160=Exit
0200=Article
Do not change
To be translated
• Initialize the Lang parameter of the Config section with the number of the language (located in the language section)
that you want to see displayed by default when starting the article.exe utility.
Page 55 / 60
Example with French selected by default
IL
article.cfg file
[Config]
Lang=1
[Lang1]
0000=Français
0001=33
For a change in the file's content to be taken into account in the utility, the utility must be restarted.
13 ADAPTATION OF HELP
The Help facility proposed by the tool is in CHM format. To obtain this type of format, you must use a software called HTML Help
Workshop, a Microsoft freeware, which reads and assembles all the source files of the Help facility in a single file with the .chm
extension.
All the files used in the Help facility have been produced under Microsoft Word and then saved in HTML format. This type of file
gives greater adaptability and better legibility than an RTF format.
13.1 Setup
To adapt and generate a Help file, you must:
• Translate and adapt the Help source files created with the Microsoft Word software.
• Generate a new CHM file.
Before starting adaptation of the Help facility, you must have installed the Microsoft Word and HTML Help Workshop
software.
13.2 Translation and adaptation of Help source files

The procedure to follow for translating and adapting the Help files is as follows:
• Choose from which language the translation and adaptation will be performed.
The Help source files are provided in French and English. The first action is therefore to choose from which language
translation of the Help files will be performed.
• Create a directory which will receive all the Help source files in the chosen language.
• For each source file (in HTML format and having the htm extension):
• Open the source file with the Word software.
• Check the bookmarks used in the original version and especially their position in the HTML source document
(see diagram at the end of this chapter to find out how to do this).
• Translate the texts contained in the file.
• Create the bookmarks (a bookmark is a set of words used as a reference) by:
• Selecting the words that will form the bookmark.
• Clicking on the Bookmark menu in the Insert menu.
• Typing the name of the bookmark in the "Name of bookmark" field.
• Clicking on the "Add" button.
• Create the hypertext links (underlined text in colour which directs you, upon a mere click, to a file or a location
within a file - in this case the links direct you to the bookmarks) by:
• Selecting the text to be displayed as a hypertext link.
• Clicking on the Insert/Hypertext link menu.
Page 56 / 60
• Entering in the "File or URL" field the access path of the file to which the hypertext link is to refer
(you can also click on the "Browse" button to select the file from the list of files). If the link is in the
same file, leave the field empty.
• Entering in the "Location in the file" field the name of the bookmark you want to reach via the
hypertext link.
• Clicking on the OK button.
• Insert the new schemas to replace the existing ones if necessary. Some schemas are displayed in the French or
English language supplied by default with the tool. The insertion of these new schemas makes it possible to
have screen copies of the tool in the language of the country.
• Save the source file in "HTML document" format.
When all the source files have been adapted and translated, the Help file has to be generated in CHM format.
To see the existing bookmarks in a file, you must click on the Insert/Bookmark menu, then select a
bookmark name from the list and click on the "Go to" button. The text corresponding to the bookmark will then be
selected in the Word document.
13.3 Generation of Help file

To generate the file, you must:
• Start the HTML Help Workshop software.
• Open the file with an hhp extension.
• Double-click on the "Compiled file" line and change the chm filename in the "Compiled file" entry field of the "Options"
window and click on the OK button.
Page 57 / 60
• Double-click on the "Navigation" line and in the "Help - <tool name and version> - November 2009" text displayed in
the "Title bar text" entry field of the "Window Types" window:
• Translate the following text in bold "Help - <tool name and version> - November 2009".
• If necessary, insert your tool name and the version wanted in the "Language" entry field of the "Options"
window.
• Click on the OK button.
• Compile the file (File/Compile menu). The Help file created is called "Help_<telephone code of country>.chm".
14 ADAPTATION OF THE INSTALLATION PROCEDURE

The tool is designed to be adapted locally in a simple and independent manner. It is then possible to create an installation CD.
Before creating a new tool installation procedure, the composition of the installation program must be presented.
14.1 Composition of the installation program

The installation program consists of a language directory, a "COPY" directory and 2 files (attached is an example in French):
Comment:
• There are 2 language directories by default: the English and Français directories corresponding to the respective
installation languages of the CanBRASS tool.
• The COPY directory corresponds to the directory containing all the files that have been translated and/or adapted for the
country (refer to section 4 List of files to be adapted or translated above).
• The Install.exe file is the execution file that can be used to start software installation.
• The autorun.inf file is a text file and can be used to start the Install.exe file automatically when the CD containing the
installation program is inserted.
Page 58 / 60
The various language directories (English, etc.) represent the language in which the tool will be installed,
i.e. the messages and windows of the installation program will be in the language selected at the start of
installation from the possible languages.
The language used by the tool installation software should not be confused with the language used by the tool.
14.2 Change of CanBRASS tool icon

It is possible to change the tools icon.

• Create an ico file or retrieve the file you want.
• Rename the file as CNB<version>.ico (e.g. CNB63.ico for CanBRASS version 6.3).
In fact, the filename must be the same as that of the execution file without the extension.
For example, one should have the file CNB63.ico because one has the CNB63.exe file for CanBRASS.
• Place this file in the "COPY" directory so that it may be taken into account by the installation program.
Restriction on Windows Vista : The icon of software is not modified in the Start menu of Windows,
but is modified in the toolbar listing the running programs on the PC.
14.3 Change of name and version of the CanBRASS tool

It is possible to change the name and version of the tools.
• In Windows Explorer, copy the setup.dat file located in the CanBRASS language directory into the directory in which
the install.exe file is located.
• In Windows Explorer, drag the copied setup.dat file over the Install.exe file. The Install.exe program then authorizes
direct modification of the application name and version and displays the following window:
.
• Click on the Modify button.

• Change the application name and version.
• Click on the Apply button.
• Click on the Exit button.
• In Windows Explorer, cut the setup.dat file located in the directory in which the install.exe file is located and paste it
into the CanBRASS language directory.
The change of tool name and version takes effect in the shortcut name in the Start menu, in
the About CanBRASS window and in the title bar of the tool, in the Windows "Add or Remove Programs" window.
14.4 Creation of an installation procedure

Once all the files have been translated or adapted, a new installation procedure has to be defined taking into account these adapted and
translated files.
Page 59 / 60
To produce a new procedure, you must:
• Copy all the files translated and/or adapted during the adaptation phase into the COPY directory (refer to section 4 List of
files to be adapted or translated above).
• Place the new procedure on any type of medium and deploy it.
If the installation procedure has only a single language directory, the choice of language to be used for
installation is not requested of the user and installation of the tool is started immediately when the
Install.exe file is run.
ooOoo
Page 60 / 60

Procedure For Adaptation and Translation of The Canbrass Tool

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Procedure For Adaptation and Translation of The Canbrass Tool

Uploaded by

Copyright:

Available Formats

C A N A L I S S O F T W A R E

Procedure for adaptation and translation

of the CanBRASS tool

Scope of application: Adaptation and translation of Canalis software by the countries.

• Document status: Draft Validated

• Document version: 1.5

1 REFERENCE DOCUMENTS ..............................................................................................................................................4

Index Name, version Description

The list of symbols is given below:

When the symbol appears, this means that an example, a comment or a

4 LIST OF FILES TO BE ADAPTED OR TRANSLATED

File must Action

5 PROCEDURE TO FOLLOW FOR TRANSLATING AND ADAPTING THE TOOLS

It is the main chapter of the document.

As a reminder, all the actions are not necessarily to be dealt with.

6 TRANSLATION OF THE TOOL

6.2 Incorporation of a new language

For the tool to be able to manage a new language, you must:

• Save the changes.

6.2.2 Description of the file

6.2.2.1 [LANG] section

The flag display depends on the filename and

Translation from French

7.2 Importing reference descriptions and updating the price list

If the window that appears is in French, it is possible to change the

10. Click on the menu Database / Import update file…

In the source text file, the title of the column

The number of columns to be imported with the tool is limited to

7.3 Adding new local references

To add a local reference, the "+" sign

To delete an existing local reference,

3. Click on the menu Database / Import update file…

Title of the columns of your source text file

Title of columns of the article.dbu file

The name of the price list can be

In our example, the local references KBA_1,

There are two ways of defining discounts:

To set the "discount by product reference" method, you must:

To define discount codes by product reference, you must:

Instead of creating an Excel file, it is possible to

The "REF" and "Discount" titles are

Title of the columns of your source text file

• Close the article.exe software.

8 CUSTOMIZING THE CANBRASS TOOL IN LINEAR MODE

The lin_conf.cfg settings file makes it possible to:

• Open the lin_conf.cfg file with a text editor.

• Save the changes in the lin_conf.cfg file.

8.1.3 Management of priorities between product ranges

The file is of the following form in the case of power distribution:

8.1.4 Management of default options

[KH-2] For an application of KH in power distribution

[KN-2] For an application of KN in power distribution

[KB-3] For an application of KBA-KBB in lighting distribution

[KD-3] For an application of KDP in lighting distribution

For all the parameters except CHOIXTRAP:

Example 1 on KT in power distribution:

Example 2 on KT in power distribution:

9 CUSTOMIZING THE CANBRASS TOOL IN REFERENCE MODE

• Open the ref_conf.cfg file with Notepad.

9.1.3 Characteristics of the Canalis line

An option is defined in the following form: OPT<num>=<select>

Example of declaration of option for the KBA product family.

[KBA] The value OPT1 ("White") is