Table of Contents
admin

Konfigurationsdateien

PRODUCT_NAME ist "idgard Sync". USER_NAME ist der Windows-Benutzername des aktuellen Benutzers.

Es gibt einen speziellen Konfigurationsordner: C:\Users\USER_NAME\AppData\Local\PRODUCT_NAME\config, Konfigurationsdatei(en) (zum Beispiel: .json, .config, .xml, .ini) in den Konfigurationsordner kopieren und Anwendung neustarten.

Konfigurationsdateien sind ein Teil des Bereitstellungsleitfaden.

Allgemeine Verwendung von Konfigurationsdateien:

  1. Navigieren Sie im Windows-Explorer zu %LocalAppData%/PRODUCT_NAME/.
  2. Erstellen Sie einen Ordner config, falls dieser noch nicht existiert.
  3. Erstellen Sie eine neue JSON-Datei mit dem Namen der Konfiguration, z. B. my-config.json.

Verhalten (_behavior Eigenschaft)

Alle JSON-Konfigurationsdateien erfordern eine _behavior-Einstellung, die steuert, wie die Konfiguration beim Start angewendet wird. Nicht jede Einstellung unterstützt alle _behavior-Varianten.

Wenn keine _behavior gesetzt wird, oder der Wert nicht vorhanden ist, wird once verwendet.

Wert Beschreibung
once (Standard) Liest die Konfigurationsdatei, importiert die Werte und löscht anschließend die Datei. Der Benutzer kann die Werte danach in den App-Einstellungen ändern.
always Liest die Konfigurationsdatei, importiert die Werte und behält die Datei. Die Werte überschreiben bei jedem Start die Benutzereinstellungen.
OnceIfNotSet Wie once, jedoch wird ein Wert nur importiert, wenn noch keine App-Einstellung dafür vorhanden ist.

Web-Proxy

Konfiguration eines Web-Proxy via Konfigurationsdatei.

  • Dateiname der Konfigurationsdatei: proxy.json
  • Unterstützte _behavior: once, always und OnceIfNotSet.

Beispiel für proxy.json.

{
    "_behavior": "once",
    "ProxyAddress": "my.proxy-server.tld",
    "ProxyPort": 8080
}

Konfigurieren Sie ProxyAddress (kann eine IP-Adresse oder eine URL sein) und ProxyPort entsprechend Ihren Anforderungen.

Die Verwendung des Proxys ist außerdem in den Log-Dateien sichtbar:

[YYYY-mm-dd HH:MMM:ss.fff INF] Parsing the proxy config file 'C:\Users\USER_NAME\AppData\Local\PRODUCT_NAME\config\proxy.json' was successful. Address: my.proxy-server.tld, Port: 8080