Skip to content

Konfiguration

Konfiguration

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

Hinweis: Pfadangaben müssen mit doppelte Backslashes geschrieben werden.

Logging

Für das Logging wird Serilog eingesetzt. Details siehe: https://github.com/serilog/serilog-settings-configuration.

Im folgenden ist eine mögliche Serilog-Konfiguration dargestellt:

"Serilog": {
    "MinimumLevel": {
      "Default": "Debug",
      "Override": {
        "Microsoft": "Warning",
        "System": "Warning"
      }
    },
    "WriteTo": [
      {
        "Name": "RollingFile",
        "Args": { 
            "pathFormat": "C:\\temp\\logs\\gis_gr_api_log-{Date}.txt"
        }
      }
    ]
  },

Unter WriteTo muss der Pfad (pathFormat) angepasst werden.

ServerService

Die API ist ab der Version 1.1 Multi-Mandanten fähig. Der Mandant muss über den folgenden Header mitgeliefert werden ("x-vrsg-tenant"), ansonsten gibt es einen Fehler, der verlangt, dass dieser Mandant konfiguriert werden muss.

    "ServerService": {
      "Mandante": [
        {
          "Mandant": "177778113432781596",
          "PrivateUrl": "http://localhost:10003"
        },
        {
          "Mandant": "177778113432781597",
          "PrivateUrl": "http://localhost:10004"
        }
      ]
    }
Eintrag Beispiel Beschreibung
Mandant "default" Name des CMI-Mandanten (wird über Request-Header ans API übermittelt)
PrivateUrl "default" Url zum Private Owin Endpunkt des CMI Server Service

StsService

"StsService": {
        "StsUrl": "http://localhost",
        "ClientSecret": "123456",
        "AcrValues": "tenant:local",
        "ProviderId": "vrsg",
        "AdminBenutzerId":  "gever" 
    },
Eintrag Beispiel Beschreibung
StsUrl "http://localhost" Url zum STS-Server
ClientSecret "123456" Secret aus der STS-Konfiguration
AcrValues "tenant:local" ApiServerId aus der STS-Konfiguration für den entsprechenden CMI AXIOMA Mandanten
ProviderId "abraxas" AuthenticationType aus der STS-Konfiguration in der Sektion OpenIdConnectIdps
AdminBenutzerId "test" BenutzerId eines CMI AXIOMA Benutzers welcher das Recht hat Benutzer und BenutzerExternerProvider zu lesen

AbraxasService

"AbraxasService": {
        "AbraxasServiceDocumentUrl": "https://pre.portal.vrsg.ch/services/ecm/api/documents/",
        "CheckInComment": "",
        "DokumentStatus": "Zwischenversion",
        "AktivitaetVorlagenPfad": "Global\\test\\aktivitaet1",
        "AktivitaetsTypGuid": "58f38c15d54743488604f6d4ee9138eb"
    }
Eintrag Beispiel Beschreibung
AbraxasServiceDocumentUrl "https://pre.portal.vrsg.ch/services/ecm/api/documents/" Url zum ECM Dokumenten Service
CheckInComment "Angelegt durch Digitalen Posteingang" Default CheckInComment beim erstellen eines Dokumentes aus dem Digitalen Posteingang
DokumentStatus "Zwischenversion" Dokumentstatus des erstellten Dokuments aus dem Digitalen Posteing. Mögliche Werte sind: Zwischenversion und Hauptversion
AktivitaetVorlagenPfad "Global\\test\\aktivitaet1" Der Pfad zu einer Globalen Aktivitäts-Objektvorlage (Konfiguration via CMI Axioma). Dieser Vorlage wird lediglich das Geschäft, das Dokument und der Aktivitätstyp von aussen mitgegeben. Andere Pflichtfelder müssen in der Vorlage gesetzt werden. Wenn gewünscht, wird beim Ablegen eines Dokuments eine Notifikation im Form dieser Aktivität ausgelöst.
AktivitaetsTypGuid "58f38c15d54743488604f6d4ee9138eb" Guid des Aktivitätstyp, der für die Erstellung der Aktivität verwendet wird (siehe oben). Die Objektvorlage und der Aktivitätstyp müssen zusammenpassen.