User Tools

Site Tools


en:infra-convert:dev:intro_v2
Administrator’s Manual infra CONVERT > Introduction

Overview (program version 2)


infra CONVERT can be adapted very flexibly to the most diverse needs. Behaviour and appearance can be predefined with parameter files.


The configuration and template files

A distinction is made between configuration files, which influence the program behavior, and template files. Project templates are read in when a new project is created and stored in it. Other templates are read during runtime.

Parameter files are written in the JavaScript Object Notation (JSON, see also here).

File Content Description
Transfer on program start
settings.json Program or basic settings Configuration and import > "Settings" Parameter file
UiAccess.json Accessibility of the user interface controls (lock or hide controls) Configuration and import > "UiAccess" Parameter file
Transfer when creating a new project
SpecialCategories.json Categories Configuration and import > Parameter file "SpecialCategories"
CharacteristicTags.json Tags Configuration and import > Parameter file "CharacteristicTags"
StampTemplates.json Stamp templates Configuration and import > Parameter file "StampTemplates"
CharacteristicClasses.json Classes Configuration and import > Parameter file "CharacteristicClasses"
Read during runtime
*.json Tolerance tables (several files) Configuration and import > Parameter file “Settings” > List of the settings > “Project settings > Tolerance tables” menu

Configuration and import > Tolerance tables
*.xltx
*.xltm
Excel test report templates Configuration and import > Parameter file “Settings” > List of the settings > “Settings > Export” menu

User Manual > More > Create and customize Excel templates


The directories for configuration and template files

ProgramData

The default directory for configuration and template files is

%ProgramData%\ELIAS GmbH\infra-convert\

Here the files are assigned to the following directory levels:

File Directory level Note
Configuration
settings.json .\ The storage location can be set by start parameter
UiAccess.json .\JsonData\ The storage location can be set by start parameter

Die Verwendung der Datei ist optional
Projektvorlagen
SpecialCategories.json .\JsonData\ The storage location can be set by start parater
CharacteristicTags.json .\JsonData\ The storage location can be set by start parameter
StampTemplates.json .\JsonData\ The storage location can be set by start parameter
CharacteristicClasses.json .\JsonData\ The storage location can be set by start parameter
Weitere Vorlagen
*.json .\ExcelReports\ The storage location is defined in the “settings.json
*.xltx
*.xltm
.\ToleranceTables\ The storage location is defined in the “settings.json

For the standard configuration and template directory (“ProgramData”) another directory can be specified with the special start parameter “forceConfigDir”. See “Configuration and Import > Startup parameter file (first paragraph)”.


AppData

User-specific configurations and templates are stored in the respective AppData directory of the user:

%AppData%\ELIAS GmbH\infra-convert\

The same directory level hierarchy applies here as for ProgramData. In particular, if a user saves settings without administrator rights or write access to the ProgramData directory, the user's changes are written to the AppData directory.

In the following, the handling of parameter files is explained step by step. First, using the example of a normal program run without a start parameter call, then with a start parameter call.


Behavior without start parameter call

Start the program

In the first scenario, infra CONVERT is started regularly (without administrator rights). The program settings (“settings.json”) are loaded from ProgramData. The “UiAccess.json” contains settings for locking or hiding individual controls.


Change settings

If the user changes settings (Edit (menu bar) > Settings) and saves them, the changes are stored in his AppData directory.


From now on, the saved changes override the settings from ProgramData.


Note To prevent a user from changing settings, the associated user interfaces can be locked via UiAccess.


Create new project

The user creates a new project based on the project templates for categories, tags, stamp templates and classes. The available tolerance tables are listed for the user and are available for use. He then loads two drawing sheets, here from a “Workspace” directory.


The user can customize the definitions for categories, tags and stamp templates in the user interface (Edit (menu bar) > Project Settings). The changes are saved in the project. The definitions of classes cannot be changed afterwards. Saving the definitions in the project ensures the interchangeability of projects.


Stamp and export

The user stamps the drawing and creates the test plan. He saves the project (*.icpx) and finally exports the completed test plan as Excel file (*.xlsx) and the stamped drawing sheets as PDF (*.pdf) to directories he has specified, for easier viewing here to “Workspace”. The template for the test report is an Excel template file (*.xltx).


Operating the program in administrator mode

In the second scenario, infra CONVERT is started with administrator rights. The administrator mode is intended to adjust configurations for all users. At startup, the settings are loaded as in regular mode.


When saving, however, the settings are written to the ProgramData directory.


Behavior at start parameter call

Start parameters can be used to implement automatisms that facilitate the work flow with always the same work processes. This administration is necessary if infra CONVERT is integrated into a CAQ/MES system and is also useful if standard settings and workflows are to be given to the user. The available start parameters are, with the exception of “forceConfigDir”, summarized in a start parameter file, see Configuration and Import > Startup parameter file.

The following example shows some possibilities for working with start parameter calls. The start parameter file refers to a “settings.json”, a “UiAccess.json” and four project template files; the location for the tolerance tables is specified in the “settings.json”. For a simpler representation, all files are loaded from a “Config” directory, this can be located on a company server, for example. However, the location and distribution of the storage locations are arbitrary.


The storage locations specified in the start parameter file are always preferred, the files located there are expected and read out. An exception is the “settings.json”. First the “settings.json” is read from ProgramData. This is overlaid by the “settings.json” passed by the start parameter and then, if available, by the “settings.json” loaded from AppData. The last loaded definition is therefore the leading one.

Note If the “settings.json” passed by start parameter should have priority over the user-defined “settings.json” from AppData, this can be specified as an option at the start parameter command. See “Configuration and Import > Startup Parameter File > Settings”.


Installation/Uninstallation

Initial or new installation

During installation, the following configuration and template files are written to the ProgramData directory with default values.


Overinstallation

When installing a new version over an older version (update) or a repair, template files in ProgramData are overwritten with standard templates, provided that the file name corresponds to the standard during installation. Renamed or specially created files are not changed or deleted.


Uninstallation

During uninstallation, the following configuration and template files are removed from the ProgramData directory Renamed or specially created files are not changed or deleted.


Install 64-bit over 32-bit version

Installing a 64-bit version (from program version 2.0.0.0) over a 32-bit version of infra CONVERT behaves like a regular over-installation as described above. The 64-bit version is installed to ” C:\Program Files”, the installation directory of the 32-bit version from “ C:\Program Files (x64)” is deleted. With regard to parameter files, only the following aspect must be observed:

The first time the program is started by a user, it checks whether parameter files are located in the user's VirtualStore directory. If there are, they are copied to the AppData directory of the user. Only the difference between the two “settings.json” in AppData and ProgramData in AppData is stored. In most cases not all four project template files will be found in the VirtualStore, but only “SpecialCategories.json” and “CharacteristicTags.json”. We generally recommend that you do not maintain the project template files in AppData, but centrally in ProgramData. With one user per computer, you can simply copy the parameter files manually from AppData to ProgramData, with multiple users you should agree accordingly.


Note What is the VirtualStore? - The VirtualStore is automatically used by the Windows operating system as a replacement for 32-bit programs when a program is run by a user without write permission to the ProgramData directory and that user saves settings. This mechanism is called UAC (User Account Control) virtualization. Whether UAC virtualization is applied can be seen in the TaskManager on the Details page. Usually the column “UAC Virtualization” is hidden, but can be added simply by right-clicking on the header. The VirtualStore directory can be found under “%LocalAppData%\VirtualStore\ProgramData\ELIAS GmbH”. The folder “ELIAS GmbH” is normally a hidden item.

Go to previous page
Introduction > Overview (program version 1)

Go to next page
Installation > Installation

en/infra-convert/dev/intro_v2.txt · Last modified: 2022/05/24 14:16 by me