KRC Configurator

General Description

Display Tab

Filter / Filter List Tab

Methods and User Methods Tabs

Templates / Templates list Tab

General / Folder layout Tab

Archive Manager Tab

History Info Tab


KRC Configurator

I. General Description

This tool allows the user to intuitively configure the registry entries that affect the behavior of KRC Navigator, Archive Manager and Upgrade Manager.

When wrong used, the settings done here may lead to undesired constellations. For instance, it is possibly to configure the Navigator not to show any folders, making that the navigation inside the file system impossible.


II. Display Tab

II.1. General Description

The user can define here various display properties, for each individual user level. This is done by choosing from supported list of properties, the desired ones for the specified level, and by altering the contents of various controls on the screen.

Observations:

No changes will be made to the registries, until the Apply button will be pressed.

The user can in any moment by pressing Restore from Registry to read again the current configuration from registry. Any changes made since last time when Apply button has been pressed, will be lost. This operation cannot be reverted.

Fig. 1 - KRC Configurator – Display Tab

II.2. Display Levels Section

It consists of 2 lists: Supported Display Levels, and Defined Display Levels,

and 2 buttons Add to defined and Remove from defined.

II.2.1. Supported display levels

These values are predefined, and the user cannot alter them.

II.2.2. Defined display levels

Here, currently defined display levels are shown. By selecting one of them, other controls from the dialog will change, to reflect various properties of the selected level. The user can change those values, in order to modify the desired properties.

II.2.3. Add to defined

When pressing this button, the current selected level, in Supported Display Levels list, will be added to the list of Defined Display Levels. This will happen only if the selected supported level is not already added to the list of defined ones. In both cases, the selection in the list of Defined Display Levels will go automatically to this level. The selection in the list of Supported Display Levels will advance circularly to the next supported level, so the user can just continue to press this button, in order to add all supported display levels to the list of defined ones.

II.2.4. Remove from defined

When pressing this button, the current selected level, in Defined Display Levels list will be deleted, together with all its related information. There is no possibility to revert this operation. The user will have to add this level again (see above), and to define again the desired properties. Anyhow, no change will be made to the registry, until Apply button is pressed (see bellow).

II.3. Properties for level: … Section

It consists of several sections, which will be described bellow

When selection changes in the list of Defined Display Levels, the name of the section changes accordingly (e.g. Properties for level: Admin). Other controls in this section may change, to reflect the properties for the selected defined display level. Changes made in this section, refers to the currently selected defined display level.

II.3.1. Supported properties

These values are predefined, and the user cannot alter them.

II.3.2. Defined properties

Here, currently defined properties for the selected defined display level will be shown.

II.3.3. Add to defined

By pressing this button, the current selected property from the Supported properties list, will be added to the list of defined ones. This will happen, only if the desired property is not already defined for this level. In both cases, the selection in the list of Defined properties will move automatically to this item. The selection in the list of Supported properties will move circularly to the next supported property, so the user can just continue to press this button, in order to define more properties.

II.3.4. Remove from defined

By pressing this button, the current selected defined property, will be deleted from the list, and consequently from the currently selected defined display level (see above).

Observation:

The user is not allowed to delete the "Label" property. This is automatically added when a new display level is defined (see above §II.2.3).

II.3.5. Up & Down buttons

With these buttons, the user can modify the order of display properties, for the currently selected defined display level. The current selected defined property is moved up & down (according to the pressed button).

Observation:

The user is not allowed to move the "Label" property, and he is not allowed to move another property in front of this one.

II.3.6. Sort by column

Here, the user can chose the initial column to sort by, for the currently selected defined display level.

II.3.7. Sort descending

When marked, the initial sorting will be descending otherwise it will be ascending.

II.3.8. Column width

The user can specify the width of the selected defined property.

II.3.9. Displayed volumes

Here, all supported volumes are shown. The marked ones will be available to the currently selected defined display level. By checking or un-checking items here, the user can define which volumes will be available for this level.

II.4. Apply button

When pressed, the currently defined configuration will be saved in the registry. The old values will be firstly deleted, and the new values will be written, to their corresponding registry keys. This action only applies to this tab.

II.5. Restore from Registry button

When pressed, the current configuration from the registry (from the last time when Apply button was pressed, or from the beginning of the program) is read and the contents of various controls updated. The changes user has made will be lost without warning. This operation cannot be reverted.

II.6. Exit

When pressed, the application will terminate. No changes will be made to the registry, unless Apply button is pressed first.


III. Filter / Filter List Tab

III.1. General Description

The user can define here various filters to be applied when displaying content of directories, for each individual user level. This is done by choosing from supported list of filters, the desired ones for the specified level, and by altering the contents of various controls on the screen.

Observations:

No changes will be made to the registries, until the Apply button will be pressed.

The user can in any moment by pressing Restore from Registry to read again the current configuration from registry. Any changes made since last time when Apply button has been pressed, will be lost. This operation cannot be reverted.

Fig. 2 - KRC Configurator – Filter / Filter List Tab

III.2. Filter Levels Section

It consists of 2 lists: Supported Filter Levels, and Defined Filter Levels,

and 2 buttons Add to defined and Remove from defined.

III.2.1. Supported filter levels

These values are predefined, and the user cannot alter them.

III.2.2. Defined filter levels

Here, currently defined display levels are shown. By selecting one of them, other controls from the dialog will change, to reflect various properties of the selected level. The user can change those values, in order to modify the desired properties.

III.2.3. Add to defined

When pressing this button, the current selected level, in Supported Display Levels list, will be added to the list of Defined Display Levels. This will happen only if the selected supported level is not already added to the list of defined ones. In both cases, the selection in the list of Defined Display Levels will go automatically to this level. The selection in the list of Supported Display Levels will advance circularly to the next supported level, so the user can just continue to press this button, in order to add all supported display levels to the list of defined ones.

III.2.4. Remove from defined

When pressing this button, the current selected level, in Defined Display Levels list will be deleted, together with all its related information. There is no possibility to revert this operation. The user will have to add this level again (see above), and to define again the desired properties. Anyhow, no change will be made to the registry, until Apply button is pressed (see bellow).

III.3. Available filters

In this section, the filters available at specific filter levels can be defined.

This section consists of 2 lists: All available filters and Filters for level: xxx and 3 buttons: Remove from all available, Make available to level and Disable for level.

III.3.1. All available filters section

Here, all the filters that can be defined for specific filter levels are shown. A filter can be defined for several or none of the defined filter levels defined. When selection changes in this list, the Properties for filter: … section will be updated accordingly (see §III.5).

III.3.2. Remove from all available button

Now the currently selected item in the list of All available filters will be permanently removed from the list of available filters. If the filter was already defined for some filter levels, a confirmation dialog will additionally occur.

III.3.3. Filters for level: … section

Here, the defined filters for the currently selected filter level in the Defined filter levels are displayed. The default filter (the one used when a switch to this filter levels occurs) is shown checked.

III.3.4. Make available to level button

By pressing this button, the currently selected filter in the All available filters list will be added to the currently selected filter level in the Defined filter levels list. This will be indicated by adding this filter to the Filters for level: … list.

III.3.5. Disable for level button

By pressing this button, the currently selected filter in the Filters for level: … list will be added to the currently selected filter level in the Defined filter levels list. This will be indicated by adding this filter to the Filters for level: … list.

III.4. Define new filter section

A new filter can be defined by entering a new name and the pressing the Add to all available filters button, in this section. Now, the new defined filter name will be added to the All available filters list. Also this new added filter will be selected in the list, so the user can start defining properties for it (see $III.5). If a filter with the same name is already defined, it will only be selected.

III.5. Properties for filter: … section

In this section, the properties for the currently selected filter in the All available filters list will be displayed. By modifying these properties, the user can decide which and how the items will be displayed when this filter is selected.

Observation:

Properties in this section are filter dependent that means that, if a filter is defined in several filter levels, the display will be the same if the same filter is selected.

III.5.1. Mask

Represents the mask to be applied when filtering items (e.g. file names) to be displayed in the BOF Navigator.

III.5.2. Comment

Represents a string from the KUKA language database, to be displayed in the selection dialog from BOF (File -> Filter menu, when available).

III.5.3. Fast delete template

This property is not used.

III.5.4. Show explode

When checked, the dat and src files will be displayed separately. When not, both files will be displayed as a unit.

III.5.5. Attributes

-	System: when checked, the system files will be displayed when this filter is selected.

-	Hidden: when checked, the system files will be displayed when this filter is selected.

III.5.6. Type

Here, the item types to be displayed when this filter is selected can be defined, by checking the corresponding checkboxes. The user must pay attention when defining these values since undesired behavior may occur (e.g. by not selecting the Dir type, no directories will be displayed, making thus impossible to navigate through the directory structure).

III.6. Apply button

When pressed, the currently defined configuration will be saved in the registry. The old values will be firstly deleted, and the new values will be written, to their corresponding registry keys. This action only applies to this tab.

III.7. Restore from Registry button

When pressed, the current configuration from the registry (from the last time when Apply button was pressed, or from the beginning of the program) is read and the contents of various controls updated. The changes user has made will be lost without warning. This operation cannot be reverted.

III.8. Exit

When pressed, the application will terminate. No changes will be made to the registry, unless Apply button is pressed first.


IV. Methods and User Methods Tabs

IV.1. General Description

Here, the user can configure how the KUKA Navigator will behave, depending on the system state, item state, user level a.s.o.

Also separated in the tool these tabs are presented together, since the only difference is represented by the methods to be configured in each of them.

Observations:

No changes will be made to the registries, until the Apply button will be pressed.

The user is able at any moment, by pressing Restore from Registry button, to read again the current configuration from registry. Any changes made since last time when Apply button has been pressed, will be lost. This operation cannot be reverted.

Fig. 3 - KRC Configurator - Methods Tab

IV.2. Available methods

In this section, all the configurable actions to be accomplished by the KUKA Navigator module are displayed. The user has to select one entry in this list, and then he can start configure the selected action.

On the bottom left corner of this tab page, the so called "modul proc", internal id of the action is displayed. The user cannot alter this value.

IV.3. Properties for: … section

Here, the configuration possibilities for the currently selected action are displayed.

If at a specific moment in time, an action is configured to be disabled, all the possibilities to execute that command will also be disabled, i.e. menu and soft keys will be disabled, the context menu will not contain the action anymore, if a key combination is assigned to this action, it will also not be possible to execute it.

IV.3.1. System conditions

System conditions refer to the state of the whole system. Some examples are: current operation mode, currently selected drive in the tree, the state of the robot and submit interpreters, a.s.o.

Observation: The conditions in this section are actually neglected, i.e. an action (method) method will be disabled if the condition is checked and becomes true. For instance, in the figure, DeleteFileFolder action will be disabled if the current drive is a CD drive, or the operation mode is currently extern or unknown.

If the user selects an entry in this list, a brief description of this condition will appear at the bottom of the list.

IV.3.2. Item conditions

Item conditions refer to the state of the currently selected item (items) in the items list. Some examples are: current edit mode for the selected file, if the file is selected in the robot or submit interpreter, item type, a.s.o.

Observation: The conditions in this section are actually neglected, i.e. an action (method) method will be disabled if the condition is checked and becomes true. For instance, in the figure, DeleteFileFolder action will be disabled if the currently selected item in the item list is selected in the robot or submit interpreter, if it is opened in a known edit mode, or no item is selected at all.

If the user selects an entry in this list, a brief description of this condition will appear at the bottom of the list.

IV.3.3. Ask user before run

By checking the desired user level, one can configure if before actually executing the selected action, a safety question should be put to the user.

In the figure, for the DeleteFileFolder action a safety question will be put to users in all user levels.

IV.3.4. Enable for user

Here various actions can be completely disabled for specific user levels.

In the figure, DeleteFileFolder action will only be enabled for expert and administrator users.

Observation: The user has to pay attention not to configure interdependent conditions leading thus to permanent unavailability of some commands. For instance, if as item conditions all SelSingle, SelMulti and SelNone entries are checked, the corresponding action will always be disabled, since at least one of these conditions is true at any moment in time. There is no automatic built-in check for such cases, and invalid configurations will not be detected.

IV.4. Apply button

When pressed, the currently defined configuration will be saved in the registry. The old values will be firstly deleted, and the new values will be written, to their corresponding registry keys. This action only applies to this tab.

IV.5. Restore from Registry button

When pressed, the current configuration from the registry (from the last time when Apply button was pressed, or from the beginning of the program) is read and the contents of various controls updated. The changes user has made will be lost without warning. This operation cannot be reverted.

IV.6. Exit

When pressed, the application will terminate. No changes will be made to the registry, unless Apply button is pressed first.


V. Templates / Templates list Tab

V.1. General Description

Newly created items by means of Navigator, will not be completely empty. Instead, they will be copies of the so-called "Templates". These are actually predefined files, designed for specific purposes (e.g. modules, cell files, etc).

By means of this configuration panel, the user can decide which templates will be available depending on the current directory and the current user level. Also the possibility to create a new template from is provided.

Observations:

No changes will be made to the registries, until the Apply button will be pressed.

The user is able at any moment, by pressing Restore from Registry button, to read again the current configuration from registry. Any changes made since last time when Apply button has been pressed, will be lost. This operation cannot be reverted.

Fig. 4 - KRC Configurator - Templates Tab

V.2. Directories list section

Here, the user can configure the directories for which templates will be defined.

If a certain directory does not appear in this list, then the templates from the DEFAULT section will be available. If a directory appears in this list, only the templates defined will be available. If no template is defined, the possibility to create a new item will be disabled (see also §IV, about how to enable / disable methods).

Observation: The KRC:\ drive refers to the path: %InstallationDir%\Krc\Roboter\Krc\

V.3. Available templates section

This section consists of 2 main lists defining the set of all available templates and the set of defined templates for the currently selected directory. The user can enable or disable a template from the available ones for the currently selected directory, or he can completely delete a template from the list of all available templates.

V.4. Define new template section

Here, the user can define its own templates, and add them to the list of all available templates. The process of creation a new template is a 2-step process. In the first step, the user is only required to define the name of his new template, and add it to the list of all available templates. For the second step, please see §V.5.

V.5. Properties for template: … section

In this area, the user can alter the properties for the currently selected template in the list of all available templates.

The following properties can be altered:

V.5.1. Mask

Mask represents a filter to be applied to the names allowed for a new file based on this template.

Some examples are:

-	"*" – any char will be allowed in the name;

-	"myName[0-99]" – only names of the form myName00 – myName99 will be allowed. The user is not permitted to change the "myName" part of the file name.

V.5.2. Comment

This is actually a data base key to allow translations in various languages of the description of this template. The Navigator displays this, when the user wants to create a new item, together with the template name.

V.5.3. Full path

Denotes the full path to the file representing this template. Creating a new item means to copy the file specified here to the location where the new file is to be created, and rename it with the name of the new file.

V.5.4. Define for users section

Here the user can enable or disable the template depending on the user level.

V.5.5. Attributes

Changes in this section, have no influence on the behavior of the module.

V.6. Apply button

When pressed, the currently defined configuration will be saved in the registry. The old values will be firstly deleted, and the new values will be written, to their corresponding registry keys. This action only applies to this tab.

V.7. Restore from Registry button

When pressed, the current configuration from the registry (from the last time when Apply button was pressed, or from the beginning of the program) is read and the contents of various controls updated. The changes user has made will be lost without warning. This operation cannot be reverted.

V.8. Exit

When pressed, the application will terminate. No changes will be made to the registry, unless Apply button is pressed first.


VI. General / Folder layout Tab

VI.1. General Description

In this section, the way Navigator handles creation and deletion of folders can be configured.

Fig. 5 - KRC Configurator – General / Folder layout Tab

VI.2. Predefined tree section

Here the paths were the users are allowed to create new folders can be defined.

If for a specific folder, the corresponding check box is checked, the user is allowed to define a new folder inside it. If not, the user is not allowed to change the structure of this folder.

If a folder occurs in the list, the user is not allowed to delete it.

If a folder does not occur in the list, the user has full access to it.

Observations

1.	In this section, only the creation and deletion of folders can be configured. The user can still create a new item inside a folder when there is a template defined for it. For more details about creating items, see also §V.

2.	KRC: stands for %InstallationDir%\Krc\Roboter\Krc\

VI.3. General preferences section

Changes in this section, have no influence on the behavior of the module.

VI.4. Apply button

When pressed, the currently defined configuration will be saved in the registry. The old values will be firstly deleted, and the new values will be written, to their corresponding registry keys. This action only applies to this tab.

VI.5. Restore from Registry button

When pressed, the current configuration from the registry (from the last time when Apply button was pressed, or from the beginning of the program) is read and the contents of various controls updated. The changes user has made will be lost without warning. This operation cannot be reverted.

VI.6. Exit

When pressed, the application will terminate. No changes will be made to the registry, unless Apply button is pressed first.


VII. Archive Manager Tab

VII.1. General Description

In this section, the behavior of the Archive Manager can be configured. The user can define here where, how and what items will be archived and restored for specific archive configurations.

Fig. 6 - KRC Configurator – Archive Manager Tab

VII.2. Archive paths

Here, symbolic names for archive paths can be defined. The symbolic name can then be used in the menu initialization file (e.g. MenuKey.ini).

Several paths for one symbolic name can be defined. For instance, for the Disk symbolic name, A:\Archive.zip and C:\Temp\Archive.zip may be both defined. The effect is, that when archiving, the resulting archive will be copied to all configured paths. If .zip extension is added, the archive will be produced compressed in zip format. If not, the configured files will only be copied to the destination path.

The same symbolic names are used for both archiving and restoring. Even if it is possible archive on multiple paths, obviously this is not the case when restoring. Thus, only one path can be checked in the Defined paths for: … list, giving thus the path that will be used in the restore operation.

The Navigator will also display the symbolic names under the ARCHIVE:\ drive. Based on the above algorithm, the path used for restoring will also be used for exploring.

VII.3. Archive configurations

An archive configuration represents actually a collection from files and registry entries that will be archived and restored. The name of the configuration can then be used in the menus initialization file.

The changes made in this section will apply to the currently selected configuration in the list of available archive configurations.

VII.3.1.  Registry sources

Registry sources are full registry paths that can be defined to be archived and restored.

Since this is a time consuming operation, only entries related to KUKA KRC software can be entered here.

VII.3.2.  File sources

Under file sources the user can define which files will be exactly archived and restored for this archive configuration.

When defining file sources, the user has the following possibilities:

-	define a specific file with the full path;

-	define whole directories to be recursively archived and restored;

-	define search filters (e.g. "myFiles*.bkp");

-	exclude specific files and directories from being archived/restored, by un-checking the corresponding entries in the File sources for: … list.

Example:

The entry:

miFH_ArchivAll = All, 32, FILEHANDLER,All;Disk

defines a menu item with the name "All". When selected, this will send the action with the id 32 (see also §IV), to the module FILEHANDLER (Navigator), with the parameter: All;Disk. That means, that all files and registry entries defined for the Archive configuration All will be archived on all paths defined for the symbolic name Disk.

VII.4. Apply button

When pressed, the currently defined configuration will be saved in the registry. The old values will be firstly deleted, and the new values will be written, to their corresponding registry keys. This action only applies to this tab.

VII.5. Restore from Registry button

When pressed, the current configuration from the registry (from the last time when Apply button was pressed, or from the beginning of the program) is read and the contents of various controls updated. The changes user has made will be lost without warning. This operation cannot be reverted.

VII.6. Exit

When pressed, the application will terminate. No changes will be made to the registry, unless Apply button is pressed first.


VIII. History Info Tab

VIII.1. General Description

Before doing a restore operation, the Archive Manager can be configured to create a History element. Also various aspects of the Archive Manager behavior when archiving and restoring can be configured.

Fig. 7 - KRC Configurator – History Info Tab

VIII.2. Comparison criteria

These criteria can be configured to be checked by Archive Manager when restoring. If a difference occurs (e.g. an archive from another robot is to be restored), then the user will be asked whether he wants to ignore it or give up.

VIII.2. History path

This is the path where the Archive Manager will save the history information, if configured.

VIII.3. Max nr. Of history traces

In order to preserve disk space, a maximum number of history traces to be saved can be configured. when this number is reached, then the oldest history point will be replaced by the new one.

VIII.4. Enable feedback

When selected, the Archive Manager will be allowed to request feedback from the user in case of errors. This setting is required if for instance comparison criteria are to be checked.

VIII.5. Generate info file when archiving

This entry controls whether the am.ini file should be generated or not. This entry is required if there is a need to archive on multiple disks.

VIII.6. Enable disk counting when archiving

This controls whether archiving on multiple disks is allowed or not. Not that the previous entry should also be checked.

VIII.7. Delete robot directory before restoring

When checked, the Archive Manager will delete the KRC:\R1 before restoring. Since this action might lead to undesired effects, when this item is enabled, the following two items are automatically enabled.

VIII.8. Save history before restoring

When checked, the Archive Manager will save the actual configuration before doing the restore operation.

VIII.9. History

When checked, the Archive Manager will additionally save a copy of the archive as a history point.

VIII.10. Apply button

When pressed, the currently defined configuration will be saved in the registry. The old values will be firstly deleted, and the new values will be written, to their corresponding registry keys. This action only applies to this tab.

VIII.11. Restore from Registry button

When pressed, the current configuration from the registry (from the last time when Apply button was pressed, or from the beginning of the program) is read and the contents of various controls updated. The changes user has made will be lost without warning. This operation cannot be reverted.

VIII.12. Exit

When pressed, the application will terminate. No changes will be made to the registry, unless Apply button is pressed first.