Differences

This shows you the differences between two versions of the page.

--- en:infra-convert:dev:intro_preview [2020/04/21 12:31]
me
+++ en:infra-convert:dev:intro_preview [2020/06/15 16:00] (current)
me
@@ Line 34: / Line 34: @@
  • [[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]]
+ • [[en:infra-convert:dev:intro_preview#Installation/Uninstallation]]
 \\
@@ Line 46: / Line 46: @@
 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]]).
+Parameter files are written in the JavaScript Object Notation (JSON, see also [[http://www.json.org/json-en.html|here]]).
 ^    ^  File  ^  Content  ^  Description  ^
@@ Line 80: / Line 80: @@
 |< 100% 5% 25% 20% 40% >|
-^    ^  Datei  ^  Verzeichnisebene  ^  Anmerkung  ^
+^    ^  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 |
@@ Line 93: / Line 93: @@
 ^  {{ :en:infra-convert:dev:icon_dev_excel.png?nolink&80 }}  ^ *.xltx\\ *.xltm\\ *.xlt | .\ToleranceTables\ | The storage location is defined in the "settings.json |
-Für das Standard-Konfigurations-und-Vorlagenverzeichnis ("ProgramData") kann mit dem Sonder-Startparameter "forceConfigDir" ein anderes Verzeichnis vorgegeben werden. Siehe "Konfiguration und Import > [[en:infra-convert:dev:parameter|Startparameterdatei]] (erster Abschnitt)".
+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)".
 \\
@@ Line 99: / Line 99: @@
 **AppData**
-Benutzerspezifische Konfigurationen und Vorlagen werden im jeweiligen AppData-Verzeichnis des Benutzers gespeichert:
+User-specific configurations and templates are stored in the respective AppData directory of the user:
 <WRAP group>
@@ Line 109: / Line 109: @@
 </WRAP>
-Hier gilt die gleiche Verzeichnisebenenhierarchie wie für ProgramData. Insbesondere, wenn ein Benutzer Einstellungen ohne Administratorrechte beziehungsweise Schreibrechte für das ProgramData-Verzeichnis speichert, werden die Änderungen des Benutzers in das AppData-Verzeichnis geschrieben.
+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.
-Nachfolgend wird der Umgang mit Parameterdateien schrittweise erklärt. Zunächst am Beispiel eines üblichen Programmablaufs ohne Startparameteraufruf, anschließend mit Startparameteraufruf.
+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.
 \\
@@ Line 117: / Line 117: @@
 ===== Behavior without start parameter call =====
-**Programm starten**
+**Start the program**
-Im ersten Szenario wird #@IC_HTML@# regulär (ohne Administratorrechte) gestartet. Die Programmeinstellungen ("settings.json") werden aus ProgramData geladen. Die "UiAccess.json" enthält Vorgaben zum Sperren oder Ausblenden einzelner Steuerelemente.
+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 |}}
@@ Line 125: / Line 125: @@
 \\
-**Einstellungen ändern**
+**Change settings**
-Ändert der Benutzer Einstellungen (**Bearbeiten** (Menüleiste) > **Einstellungen**) und speichert diese, werden die Änderungen in seinem AppData-Verzeichnis abgelegt.
+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 |}}
@@ Line 133: / Line 133: @@
 \\
-Die gespeicherten Änderungen überlagern fortan die Einstellungen aus ProgramData.
+From now on, the saved changes override the settings from ProgramData.
 {{ :en:infra-convert:dev:arbeiten_mit_parameterdateien_v2_beispiel_03.png?nolink&800 |}}
@@ Line 139: / Line 139: @@
 \\
-> **Anmerkung** Um zu verhindern, dass ein Benutzer Einstellungen ändert, können die zugehörigen Benutzeroberflächen per UiAccess gesperrt werden.
+> **Note** To prevent a user from changing settings, the associated user interfaces can be locked via UiAccess.
 \\
-**Neues Projekt anlegen**
+**Create new project**
-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".
+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.
 {{ :en:infra-convert:dev:arbeiten_mit_parameterdateien_v2_beispiel_04.png?nolink&800 |}}
@@ Line 151: / Line 151: @@
 \\
-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.
+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.
 \\
-**Stempeln und exportieren**
+**Stamp and export**
-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).
+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).
 {{ :en:infra-convert:dev:arbeiten_mit_parameterdateien_v2_beispiel_05.png?nolink&800 |}}
@@ Line 163: / Line 163: @@
 \\
-**Programm im Administratormodus bedienen**
+**Operating the program in administrator mode**
-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.
+In the second scenario, #@IC_HTML@# 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.
 {{ :en:infra-convert:dev:arbeiten_mit_parameterdateien_v2_beispiel_06.png?nolink&800 |}}
@@ Line 171: / Line 171: @@
 \\
-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.
+When saving, however, the settings are written to the ProgramData directory. The "settings.json" in AppData will become invalid and will be deleted for the user who is working as administrator at that moment.
 {{ :en:infra-convert:dev:arbeiten_mit_parameterdateien_v2_beispiel_07.png?nolink&800 |}}
@@ Line 179: / Line 179: @@
 ===== 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]].
+Start parameters can be used to implement automatisms that facilitate the work flow with always the same work processes. This administration is necessary if #@IC_HTML@# 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 > [[en:infra-convert:dev:parameter|Startup parameter file]].
-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.
+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.
 {{ :en:infra-convert:dev:arbeiten_mit_parameterdateien_v2_beispiel_08.png?nolink&800 |}}
@@ Line 187: / Line 187: @@
 \\
-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.
+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.
-> **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]]".
+> **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 > [[en:infra-convert:dev:parameter#einstellungen|Settings]]".
 \\
-===== Installation/Deinstallation =====
+===== Installation/Uninstallation =====
 **Erst- oder Neuinstallation**
-Bei der Installation werden die folgenden Konfigurations- und Vorlagendateien mit Standardwerten in das ProgramData-Verzeichnis geschrieben.
+During installation, the following configuration and template files are written to the ProgramData directory with default values.
 {{ :en:infra-convert:dev:arbeiten_mit_parameterdateien_v2_installation_01.png?nolink&800 |}}
@@ Line 203: / Line 203: @@
 \\
-**Überinstallation**
+**Overinstallation**
-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.
+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.
 {{ :en:infra-convert:dev:arbeiten_mit_parameterdateien_v2_ueberinstallation_01.png?nolink&800 |}}
@@ Line 211: / Line 211: @@
 \\
-**Deinstallation**
+**Uninstallation**
-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.
+During uninstallation, the following configuration and template files are removed from the ProgramData directory Renamed or specially created files are not changed or deleted.
 {{ :en:infra-convert:dev:arbeiten_mit_parameterdateien_v2_deinstallation_01.png?nolink&800 |}}
@@ Line 219: / Line 219: @@
 \\
-**64-Bit- über 32-Bit-Version installieren**
+**Install 64-bit over 32-bit version**
-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:
+Installing a 64-bit version (from program version 2.0.0.0) over a 32-bit version of #@IC_HTML@# 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:
-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.
+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.
 {{ :en:infra-convert:dev:arbeiten_mit_parameterdateien_v2_installation_64_ueber_32_01.png?nolink&800 |}}
@@ Line 229: / Line 229: @@
 \\
-> **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.
+> **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.
 <WRAP noprint>

ELIAS GmbHProduktdokumentationen

User Tools

Site Tools

Differences

Page Tools

ELIAS GmbH
Produktdokumentationen