ELIAS GmbH
Produktdokumentationen

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
~~NOTOC~~

<WRAP noprint>

> Administrator’s Guide #@IC_HTML@# > Introduction

<WRAP group>
<WRAP column 70%>
====== Overview ======

----
</WRAP>
<WRAP column 10,5%>
> {{:en:infra-convert:icon_preview.png?nolink&0x35}}
</WRAP>
<WRAP column 15%>
Preview of #@IC_HTML@# v2
</WRAP>
</WRAP>

#@IC_HTML@# can be adapted very flexibly to the most diverse needs. Behaviour and appearance can be predefined with parameter files.

{{ :en:infra-convert:dev:arbeiten_mit_parameterdateien_v2_beispiel_00.png?nolink&800 |}}

\\ 

<WRAP noprint>
<WRAP group>
<WRAP column 45%>
//**__Content__**//

 • [[en:infra-convert:dev:intro_preview#The configuration and template files]]\\ 
 • [[en:infra-convert:dev:intro_preview#The directories for configuration and template files]]\\ 
 • [[en:infra-convert:dev:intro_preview#Behavior without start parameter call]]\\ 
 • [[en:infra-convert:dev:intro_preview#Behavior at start parameter call]]\\ 
 • [[en:infra-convert:dev:intro_preview#Installation/Deinstallation]]

\\ 

</WRAP>
</WRAP>
</WRAP>

===== 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 [[http://www.json.org/json-de.html|here]]). 

^    ^  File  ^  Content  ^  Description  ^
^ Transfer on program start ^^^^
^  {{ :en:infra-convert:dev:icon_dev_einstellungen.png?nolink&80 }}  ^ settings.json | Program or basic settings | Configuration and import > [[en:infra-convert:dev:settings|"Settings" Parameter file]] |
^  {{ :en:infra-convert:dev:icon_dev_uiaccess_2.png?nolink&80 }}  ^ UiAccess.json | Accessibility of the user interface controls (lock or hide controls) | Configuration and import > [[en:infra-convert:dev:uiaccess|"UiAccess" Parameter file]] |
^ Transfer when creating a new project ^^^^
^  {{ :en:infra-convert:dev:icon_dev_kategorien.png?nolink&80 }}  ^ SpecialCategories.json | Categories | Configuration and import > [[en:infra-convert:dev:specialcategories|Parameter file "SpecialCategories"]] |
^  {{ :en:infra-convert:dev:icon_dev_kennzeichnungen.png?nolink&80 }}  ^ CharacteristicTags.json | Tags | Configuration and import > [[en:infra-convert:dev:characteristictags|Parameter file "CharacteristicTags"]] |
^  {{ :en:infra-convert:dev:icon_dev_stempelvorlagen.png?nolink&80 }}  ^ StampTemplates.json | Stamp templates | Configuration and import > [[en:infra-convert:dev:stamptemplates|Parameter file "StampTemplates"]] |
^  {{ :en:infra-convert:dev:icon_dev_klassen.png?nolink&80 }}  ^ CharacteristicClasses.json | Classes | Configuration and import > [[en:infra-convert:dev:characteristicclasses|Parameter file "CharacteristicClasses"]] |
^ Read during runtime ^^^^
^  {{ :en:infra-convert:dev:icon_dev_toleranztabellen.png?nolink&80 }}  ^ *.json | Tolerance tables (several files) | Configuration and import > Parameter file "Settings" > [[en:infra-convert:dev:settings#list_of_the_settings|List of the settings]] > “Project settings > Tolerance tables” menu\\ \\ Configuration and import > [[en:infra-convert:dev:toltab|Tolerance tables]] |
^  {{ :en:infra-convert:dev:icon_dev_excel.png?nolink&80 }}  ^ *.xltx\\ *.xltm\\ *.xlt | Excel test report templates | Configuration and import > Parameter file "Settings" > [[en:infra-convert:dev:settings#list_of_the_settings|List of the settings]] > “Settings > Export” menu\\ \\ User Manual > More > [[en:infra-convert:user:exceltemp|Create and customize Excel templates]] |

\\ 

===== The directories for configuration and template files =====

**ProgramData**

The default directory for configuration and template files is

<WRAP group>
<WRAP indent>
<WRAP column 42%>
<code>%ProgramData%\ELIAS GmbH\infra-convert\</code>
</WRAP>
</WRAP>
</WRAP>

Here the files are assigned to the following directory levels:

|< 100% 5% 25% 20% 40% >|
^    ^  File  ^  Directory level  ^  Note  ^
^ Configuration ^^^^
^  {{ :en:infra-convert:dev:icon_dev_einstellungen.png?nolink&80 }}  ^ settings.json | .\ | The storage location can be set by start parameter |
^  {{ :en:infra-convert:dev:icon_dev_uiaccess_2.png?nolink&80 }}  ^ UiAccess.json | .\JsonData\ | The storage location can be set by start parameter\\ \\ Die Verwendung der Datei ist optional |
^ Projektvorlagen ^^^^
^  {{ :en:infra-convert:dev:icon_dev_kategorien.png?nolink&80 }}  ^ SpecialCategories.json | .\JsonData\ | The storage location can be set by start parater |
^  {{ :en:infra-convert:dev:icon_dev_kennzeichnungen.png?nolink&80 }}  ^ CharacteristicTags.json | .\JsonData\ | The storage location can be set by start parameter |
^  {{ :en:infra-convert:dev:icon_dev_stempelvorlagen.png?nolink&80 }}  ^ StampTemplates.json | .\JsonData\ | The storage location can be set by start parameter |
^  {{ :en:infra-convert:dev:icon_dev_klassen.png?nolink&80 }}  ^ CharacteristicClasses.json | .\JsonData\ | The storage location can be set by start parameter |
^ Weitere Vorlagen ^^^^
^  {{ :en:infra-convert:dev:icon_dev_toleranztabellen.png?nolink&80 }}  ^ *.json | .\ExcelReports\ | The storage location is defined in the "settings.json |
^  {{ :en:infra-convert:dev:icon_dev_excel.png?nolink&80 }}  ^ *.xltx\\ *.xltm\\ *.xlt | .\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 > [[en:infra-convert:dev:parameter|Startup parameter file]] (first paragraph)".

\\ 

**AppData**

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

<WRAP group>
<WRAP indent>
<WRAP column 38%>
<code>%AppData%\ELIAS GmbH\infra-convert\</code>
</WRAP>
</WRAP>
</WRAP>

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, #@IC_HTML@# 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.

{{ :en:infra-convert:dev:arbeiten_mit_parameterdateien_v2_beispiel_01.png?nolink&800 |}}

\\ 

**Change settings**

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

{{ :en:infra-convert:dev:arbeiten_mit_parameterdateien_v2_beispiel_02.png?nolink&800 |}}

\\ 

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

{{ :en:infra-convert:dev:arbeiten_mit_parameterdateien_v2_beispiel_03.png?nolink&800 |}}

\\ 

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

\\ 

**Neues Projekt anlegen**

Der Benutzer legt ein neues Projekt auf Basis der Projektvorlagen für Kategorien, Kennzeichnungen, Stempelvorlagen und Klassen an. Die verfügbaren Toleranztabellen werden für den Benutzer gelistet und stehen zur Verwendung bereit. Anschließend lädt er zwei Zeichnungsblätter, hier aus einem Verzeichnis "Workspace".

{{ :en:infra-convert:dev:arbeiten_mit_parameterdateien_v2_beispiel_04.png?nolink&800 |}}

\\ 

Der Benutzer kann die Definitionen für Kategorien, Kennzeichnungen und Stempelvorlagen in der Benutzeroberfläche anpassen (**Bearbeiten** (Menüleiste) > **Projekteinstellungen**). Die Änderungen werden im Projekt gespeichert. Die Definitionen von Klassen können im Nachhinein nicht mehr geändert werden. Mit dem Speichern der Definitionen im Projekt wird die Austauschbarkeit von Projekten sichergestellt.

\\ 

**Stempeln und exportieren**

Der Benutzer stempelt die Zeichnung und erstellt den Prüfplan. Er speichert das Projekt (*.icpx) und exportiert schließlich den fertiggestellten Prüfplan als Excel-Datei (*.xlsx) und die gestempelten Zeichnungsblätter als PDF (*.pdf) in von ihm bestimmte Verzeichnisse, für eine einfachere Darstellung hier nach "Workspace". Vorlage für den Prüfbericht ist eine Excel-Vorlagendatei (*.xltx).

{{ :en:infra-convert:dev:arbeiten_mit_parameterdateien_v2_beispiel_05.png?nolink&800 |}}

\\ 

**Programm im Administratormodus bedienen**

Im zweiten Szenario wird #@IC_HTML@# mit Administratorrechten gestartet. Der Administratormodus ist dafür vorgesehen, Konfigurationen für alle Benutzer anzupassen. Beim Start werden die Einstellungen wie im regulären Modus geladen.

{{ :en:infra-convert:dev:arbeiten_mit_parameterdateien_v2_beispiel_06.png?nolink&800 |}}

\\ 

Beim Speichern werden die Einstellungen jedoch in das ProgramData-Verzeichnis geschrieben. Die "settings.json" in AppData wird damit für den, in dem Moment als Administrator arbeitenden Nutzer, hinfällig und gelöscht.

{{ :en:infra-convert:dev:arbeiten_mit_parameterdateien_v2_beispiel_07.png?nolink&800 |}}

\\ 

===== Behavior at start parameter call =====

Mit Startparametern können Automatismen realisiert werden, welche den Arbeitsfluss bei stets gleichartigen Arbeitsabläufen erleichtern. Diese Administration ist zum einen nötig, wenn #@IC_HTML@# in ein CAQ/MES-System eingebunden ist und zum anderen sinnvoll, wenn dem Benutzer Standardeinstellungen und -arbeitsabläufe vorgegeben werden sollen. Die verfügbaren Startparameter sind, mit Ausnahme von "forceConfigDir", in einer Startparameterdatei zusammengefasst, siehe Konfiguration und Import > [[en:infra-convert:dev:parameter|Startparameterdatei]].

Das folgende Beispiel zeigt einige Möglichkeiten zum Arbeiten mit Startparameteraufruf. In der Startparameterdatei wird auf eine "settings.json", eine "UiAccess.json" sowie vier Projektvorlagendateien verwiesen; der Speicherort für die Toleranztabellen ist in der "settings.json" angegeben. Für eine einfachere Darstellung werden alle Dateien aus einem Verzeichnis "Config" geladen, dieses kann zum Beispiel auf einem Unternehmensserver liegen. Aufteilung und Verteilung der Speicherorte sind jedoch beliebig.

{{ :en:infra-convert:dev:arbeiten_mit_parameterdateien_v2_beispiel_08.png?nolink&800 |}}

\\ 

Es werden stets die in der Startparameterdatei angegebenen Speicherorte bevorzugt, die dort liegenden Dateien erwartet und ausgelesen. Eine Ausnahme bildet die "settings.json". Zunächst wird die "settings.json" aus ProgramData gelesen. Diese wird von der per Startparameter übergebenen "settings.json" und anschließend, falls vorhanden, von der aus AppData geladenen "settings.json" überlagert. Die jeweils zuletzt geladene Definition ist somit führend.

> **Anmerkung** Soll die per Startparameter übergebene "settings.json" Vorrang vor der benutzerdefinierten "settings.json" aus AppData haben, kann dies als Option am Startparameterbefehl angegeben werden. Siehe "Konfiguration und Import > Startparameterdatei > [[en:infra-convert:dev:parameter#einstellungen|Einstellungen]]".

\\ 

===== Installation/Deinstallation =====

**Erst- oder Neuinstallation**

Bei der Installation werden die folgenden Konfigurations- und Vorlagendateien mit Standardwerten in das ProgramData-Verzeichnis geschrieben.

{{ :en:infra-convert:dev:arbeiten_mit_parameterdateien_v2_installation_01.png?nolink&800 |}}

\\ 

**Überinstallation**

Bei der Installation einer neuen über eine ältere Version (Update) oder einer Reparatur werden Toleranztabellen und Excel-Vorlagendateien mit Standardvorlagen überschrieben, sofern der Dateiname dem Standard bei der Installation entspricht. Umbenannte oder eigens erstellte Dateien werden nicht geändert oder gelöscht.

{{ :en:infra-convert:dev:arbeiten_mit_parameterdateien_v2_ueberinstallation_01.png?nolink&800 |}}

\\ 

**Deinstallation**

Bei der Deinstallation werden die folgenden Konfigurations- und Vorlagendateien aus dem ProgramData-Verzeichnis entfernt. Umbenannte oder eigens erstellte Dateien werden nicht geändert oder gelöscht.

{{ :en:infra-convert:dev:arbeiten_mit_parameterdateien_v2_deinstallation_01.png?nolink&800 |}}

\\ 

**64-Bit- über 32-Bit-Version installieren**

Die Installation einer 64-Bit-Version (ab Programmversion 2.0.0.0) über eine 32-Bit-Version von #@IC_HTML@# verhält sich wie eine reguläre, oben beschriebene, Überinstallation. Die 64-Bit-Version wird nach "C:\Program Files" installiert, das Installationsverzeichnis der 32-Bit-Version aus "C:\Program Files (x64)" wird gelöscht. Hinsichtlich Parameterdateien gilt es lediglich, den folgenden Aspekt zu beachten:

Beim jeweils ersten Programmstart durch einen Benutzer nach wird geprüft, ob sich Parameterdateien im VirtualStore-Verzeichnis des Benutzers befinden. Falls vorhanden, werden diese in das AppData-Verzeichnis des Benutzers kopiert. Dabei wird nur die Differenz zwischen den beiden "settings.json" in AppData und ProgramData in AppData abgelegt. In den meisten Fällen werden nicht alle vier Projektvorlagendateien im VirtualStore zu finden sein, sondern nur "SpecialCategories.json" und "CharacteristicTags.json". Wir empfehlen grundsätzlich, die Projektvorlagendateien nicht in AppData zu pflegen, sondern zentral in ProgramData. Bei einem Nutzer pro Rechner können Sie einfach die Parameterdateien händisch aus AppData nach ProgramData kopieren, bei mehreren Nutzern sollten Sie sich entsprechend einigen.

{{ :en:infra-convert:dev:arbeiten_mit_parameterdateien_v2_installation_64_ueber_32_01.png?nolink&800 |}}

\\ 

> **Anmerkung** Was ist der VirtualStore? − Der VirtualStore wird bei 32-Bit-Programmen vom Windows-Betriebssystem automatisch als Ersatz herangezogen, wenn ein Programm von einem Benutzer ohne Schreibrechte für das ProgramData-Verzeichnis ausgeführt wird und dieser Einstellungen speichert. Dieser Mechanismus wird als UAC-Virtualisierung bezeichnet (UAC = User Account Control). Ob eine UAC-Virtualisierung angewendet wird, kann im TaskManager auf der Seite **Details** eingesehen werden. Üblicherweise ist die Spalte "UAC-Virtualisierung" ausgeblendet, kann aber einfach durch Rechtsklick auf die Kopfzeile hinzugefügt werden. Das VirtualStore-Verzeichnis findet sich unter "%LocalAppData%\VirtualStore\ProgramData\ELIAS GmbH". Der Ordner "ELIAS GmbH" ist normalerweise ein ausgeblendetes Element.

<WRAP noprint>

----

<WRAP group>
<WRAP col2>

<WRAP rightalign>
**Go to previous page**\\ 
Introduction > [[en:infra-convert:dev:Wiki|Tips on the Administrator’s Guide]]
</WRAP>

**Go to next page**\\ 
Configuration and Import > [[en:infra-convert:dev:parameter|Startup parameter file]]

</WRAP>
</WRAP>

</WRAP>
ELIAS GmbHProduktdokumentationen

User Tools

Site Tools

Page Tools

ELIAS GmbH
Produktdokumentationen
