Skip to content

Konfiguration

Die Konfiguration erfolgt in der Datei appsettings.json. Die nachfolgenden Unterkapitel beschreiben jeweils einen Toplevel-Eintrag.

Serilog

{
  "Serilog": {
    "MinimumLevel": {
      "Default": "[LEVEL]"
    },
    "WriteTo": [
      {
        "Name": "Console"
      },
      {
        "Name": "File",
        "Args": {
          "rollingInterval": "Day",
          "path": "[PATH]"
        }
      }
    ]
  }
}

Dies ist die Serilog-Konfiguration. Serilog wird insbesondere für das File-Logging gebraucht.

MinimumLevel.Default

Folgende Log-Level werden unterstützt:

  • Verbose
  • Debug
  • Information
  • Warning
  • Error
  • Fatal

Die Log-Level Verbose und Debug sollten nur für Fehlersuche gesetzt werden, da die geloggte Menge gross werden kann.

WriteTo.Args.Path

Hier wird der Pfad zum Log-File gesetzt. Bsp.: C:\\temp\\logs-cmi-document-service\\cmi-document-service-.log

Weitere Konfigurationen

Weitere Konfigurationsmöglichkeiten siehe https://github.com/serilog/serilog-settings-configuration.

MaxRequestBodySizeInMB und MaxFormBodySizeInMB

Maximale Grösser der Dateien, welche verarbeitet werden sollen.

TempFolder

Der CMI Document Service erzeugt temporäre Dateien. Standardmässig wird der System-Temp-Pfad verwendet, kann hier aber übersteuert werden. Es handelt sich um kurzlebige Dateien.

EnableMultitenancy

Default: false Steuert ob Anfragen mittels API-Key validiert werden sollen. Default mässig ist dies deaktiviert, im verteilten Betrieb sollte dies aber immer aktiviert werden.

Tenants

Ist EnableMultitenancy aktiviert, so kann pro Tenant ein API-Key definiert werden, welcher auf jedem Mandanten eingerichtet werden muss. 

{
  "Tenants" : {
    "dev1": {
      "ApiKey": "123"
    },
    "dev2": {
      "ApiKey": "456"
    }
  }
}

Worker

DotnetExecutablePath

Optional: Pfad zu dotnet

ExecutableFilePath

Pfad zur CMI.Document.Service.Worker.dll. Standardmässig liegt diese unter Worker/CMI.Document.Service.Worker.dll

PdfTools

Wird diese Konfiguration gesetzt, so kann der CMI Document Service nicht mehr unter Linux betrieben werden.

RemoteUrl

Url unter welcher PdfTools erreichbar ist

Process.ExecutableFilePath

Pfad zur CMI.Document.Service.PdfTools.exe. Standardmässig liegt diese unter PdfTools/CMI.Document.Service.PdfTools.exe

Aspose

Excel.MaxPages

Maximale Anzahl Seiten, welche das resultieren PDF eines Excels haben darf. Hat es mehr als diese Anzahl Seiten so wird das Rendering abgebrochen. Default = 100

Fonts.FontDirectories

Array von Pfaden zu Ordnern in welchen zusätzliche Schriftarten liegen, welche beim Rendering verwendet werden sollen. Die angegebenen Ordner werden nicht überwacht. Wird der Inhalt eines Ordners angepasst so muss der Service neugestartet werden.