~~NOTOC~~ > Administratorhandbuch #@IC_HTML@# > Einleitung ====== Übersicht ====== ---- > {{:de:infra-convert:icon_preview.png?nolink&0x35}} Vorschau auf #@IC_HTML@# v2 #@IC_HTML@# kann sehr flexibel an die verschiedensten Bedürfnisse angepasst werden. Verhalten und Erscheinungsbild können mit Parameterdateien vorgegeben werden. {{ :de:infra-convert:dev:arbeiten_mit_parameterdateien_v2_beispiel_00.png?nolink&800 |}} \\ //**__Inhalt__**//  • [[de:infra-convert:dev:intro_preview#Die Konfigurations- und Vorlagendateien]]\\  • [[de:infra-convert:dev:intro_preview#Die Verzeichnisse für Konfigurations- und Vorlagendateien]]\\  • [[de:infra-convert:dev:intro_preview#Verhalten ohne Startparameteraufruf]]\\  • [[de:infra-convert:dev:intro_preview#Verhalten bei Startparameteraufruf]]\\  • [[de:infra-convert:dev:intro_preview#Installation/Deinstallation]] \\ ===== Die Konfigurations- und Vorlagendateien ===== Unterschieden werden Konfigurationsdateien, die das Programmverhalten beeinflussen, und Vorlagendateien. Projektvorlagen werden beim Anlegen eines neuen Projekts eingelesen und in diesem gespeichert. Auf weitere Vorlagen wird während der Laufzeit zugegriffen. Parameterdateien sind in der JavaScript Object Notation gefasst (JSON, siehe auch [[http://www.json.org/json-de.html|hier]]). |< 100% 5% 25% 30% 30% >| ^ ^ Datei ^ Inhalt ^ Beschreibung ^ ^ Konfiguration ^^^^ ^ {{ :de:infra-convert:dev:icon_dev_einstellungen.png?nolink&80 }} ^ settings.json | Programm- beziehungsweise Grundeinstellungen | Konfiguration und Import > [[de:infra-convert:dev:settings|Parameterdatei "Settings"]] | ^ {{ :de:infra-convert:dev:icon_dev_uiaccess_2.png?nolink&80 }} ^ UiAccess.json | Zugänglichkeit der Steuerelemente der Benutzeroberfläche (Steuerelemente sperren oder ausblenden) | Konfiguration und Import > [[de:infra-convert:dev:uiaccess|Parameterdatei "UiAccess"]] | ^ Projektvorlagen ^^^^ ^ {{ :de:infra-convert:dev:icon_dev_kategorien.png?nolink&80 }} ^ SpecialCategories.json | Kategorien | Konfiguration und Import > [[de:infra-convert:dev:specialcategories|Parameterdatei "SpecialCategories"]] | ^ {{ :de:infra-convert:dev:icon_dev_kennzeichnungen.png?nolink&80 }} ^ CharacteristicTags.json | Kennzeichnungen | Konfiguration und Import > [[de:infra-convert:dev:characteristictags|Parameterdatei "CharacteristicTags"]] | ^ {{ :de:infra-convert:dev:icon_dev_stempelvorlagen.png?nolink&80 }} ^ StampTemplates.json | Stempelvorlagen | Konfiguration und Import > [[de:infra-convert:dev:stamptemplates|Parameterdatei "StampTemplates"]] | ^ {{ :de:infra-convert:dev:icon_dev_klassen.png?nolink&80 }} ^ CharacteristicClasses.json | Klassen | Konfiguration und Import > [[de:infra-convert:dev:characteristicclasses|Parameterdatei "CharacteristicClasses"]] | ^ Weitere Vorlagen ^^^^ ^ {{ :de:infra-convert:dev:icon_dev_toleranztabellen.png?nolink&80 }} ^ *.json | Toleranztabellen (mehrere Dateien) | Konfiguration und Import > Parameterdatei "Settings" > [[de:infra-convert:dev:settings#liste_der_einstellungen|Liste der Einstellungen]] > Menü „Projekteinstellungen > Toleranztabellen“\\ \\ Konfiguration und Import > [[de:infra-convert:dev:toltab|Toleranztabellen]] | ^ {{ :de:infra-convert:dev:icon_dev_excel.png?nolink&80 }} ^ *.xltx\\ *.xltm\\ *.xlt | Excel-Prüfberichtsvorlagen | Konfiguration und Import > Parameterdatei "Settings" > [[de:infra-convert:dev:settings#liste_der_einstellungen|Liste der Einstellungen]] > Menü „Einstellungen > Export“\\ \\ Benutzerhandbuch > Weiteres > [[de:infra-convert:user:exceltemp|Excel-Vorlagen erstellen und anpassen]] | \\ ===== Die Verzeichnisse für Konfigurations- und Vorlagendateien ===== **ProgramData** Das Standardverzeichnis für Konfigurations- und Vorlagendateien ist: %ProgramData%\ELIAS GmbH\infra-convert\ Hierin sind die Dateien den folgenden Verzeichnisebenen zugeordnet: |< 100% 5% 25% 20% 40% >| ^ ^ Datei ^ Verzeichnisebene ^ Anmerkung ^ ^ Konfiguration ^^^^ ^ {{ :de:infra-convert:dev:icon_dev_einstellungen.png?nolink&80 }} ^ settings.json | .\ | Der Speicherort kann per Startparamater festgelegt werden | ^ {{ :de:infra-convert:dev:icon_dev_uiaccess_2.png?nolink&80 }} ^ UiAccess.json | .\JsonData\ | Der Speicherort kann per Startparamater festgelegt werden\\ \\ Die Verwendung der Datei ist optional | ^ Projektvorlagen ^^^^ ^ {{ :de:infra-convert:dev:icon_dev_kategorien.png?nolink&80 }} ^ SpecialCategories.json | .\JsonData\ | Der Speicherort kann per Startparamater festgelegt werden | ^ {{ :de:infra-convert:dev:icon_dev_kennzeichnungen.png?nolink&80 }} ^ CharacteristicTags.json | .\JsonData\ | Der Speicherort kann per Startparamater festgelegt werden | ^ {{ :de:infra-convert:dev:icon_dev_stempelvorlagen.png?nolink&80 }} ^ StampTemplates.json | .\JsonData\ | Der Speicherort kann per Startparamater festgelegt werden | ^ {{ :de:infra-convert:dev:icon_dev_klassen.png?nolink&80 }} ^ CharacteristicClasses.json | .\JsonData\ | Der Speicherort kann per Startparamater festgelegt werden | ^ Weitere Vorlagen ^^^^ ^ {{ :de:infra-convert:dev:icon_dev_toleranztabellen.png?nolink&80 }} ^ *.json | .\ExcelReports\ | Der Speicherort wird in der "settings.json" festgelegt | ^ {{ :de:infra-convert:dev:icon_dev_excel.png?nolink&80 }} ^ *.xltx\\ *.xltm\\ *.xlt | .\ToleranceTables\ | Der Speicherort wird in der "settings.json" festgelegt | Für das Standard-Konfigurations-und-Vorlagenverzeichnis ("ProgramData") kann mit dem Sonder-Startparameter "forceConfigDir" ein anderes Verzeichnis vorgegeben werden. Siehe "Konfiguration und Import > [[de:infra-convert:dev:parameter|Startparameterdatei]] (erster Abschnitt)". \\ **AppData** Benutzerspezifische Konfigurationen und Vorlagen werden im jeweiligen AppData-Verzeichnis des Benutzers gespeichert: %AppData%\ELIAS GmbH\infra-convert\ 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. Nachfolgend wird der Umgang mit Parameterdateien schrittweise erklärt. Zunächst am Beispiel eines üblichen Programmablaufs ohne Startparameteraufruf, anschließend mit Startparameteraufruf. \\ ===== Verhalten ohne Startparameteraufruf ===== **Programm starten** 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. {{ :de:infra-convert:dev:arbeiten_mit_parameterdateien_v2_beispiel_01.png?nolink&800 |}} \\ **Einstellungen ändern** Ändert der Benutzer Einstellungen (**Bearbeiten** (Menüleiste) > **Einstellungen**) und speichert diese, werden die Änderungen in seinem AppData-Verzeichnis abgelegt. {{ :de:infra-convert:dev:arbeiten_mit_parameterdateien_v2_beispiel_02.png?nolink&800 |}} \\ Die gespeicherten Änderungen überlagern fortan die Einstellungen aus ProgramData. {{ :de:infra-convert:dev:arbeiten_mit_parameterdateien_v2_beispiel_03.png?nolink&800 |}} \\ > **Anmerkung** Um zu verhindern, dass ein Benutzer Einstellungen ändert, können die zugehörigen Benutzeroberflächen per UiAccess gesperrt werden. \\ **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". {{ :de: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). {{ :de: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. {{ :de: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. {{ :de:infra-convert:dev:arbeiten_mit_parameterdateien_v2_beispiel_07.png?nolink&800 |}} \\ ===== Verhalten bei Startparameteraufruf ===== 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 > [[de: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. {{ :de: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 > [[de: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. {{ :de: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 Vorlagendateien im ProgramData-Verzeichnis mit Standardvorlagen überschrieben, sofern der Dateiname dem Standard bei der Installation entspricht. Umbenannte oder eigens erstellte Dateien werden nicht geändert oder gelöscht. {{ :de: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. {{ :de: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) ü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. {{ :de: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. ---- **Zurückblättern**\\ Einleitung > [[de:infra-convert:dev:Wiki|Tipps zum Administratorhandbuch]] **Weiterblättern**\\ Konfiguration und Import > [[de:infra-convert:dev:parameter|Startparameterdatei]]