Skip to content

Change log

v.4.0

Breaking Changes

  • Runtime auf .NET 8.0 aktualisiert. Das Windows Hosting Bundle für diese Version muss installiert werden. Download hier

Features

  • Die neueste Funktion ermöglicht die Definition eines API-Schlüssels sowie von Hosts für den Health-Endpoint. Dadurch können nur autorisierte Hosts den Health-Endpoint aufrufen (siehe Dokumentation).
  • Neu prüfen die Health-Checks ob die Verbindung zur Datenbank erfolgreich ist.

Innosolv

Beim Provider Innosolv können neu folgende felder bezogen werden:

  • Anderer Name (einwohner/einwohnername/AndererName)
  • Einreisedatum (einwohner/zuzug/letzteeinreise)
  • Geburtsort (einwohner/einwohner/geburtsort)
  • Homepage (Internet/WWW))
  • ID_Subjekt (basis/subjekt/ID_Subjekt)
  • Ledigname (einwohner/einwohnername/ledigername)
  • Name-Einwohner (einwohner/einwohnername/name)
  • Rufname (einwohner/einwohnername/rufname)
  • Subjektart (basis/subjekt/subjektart)
  • Subjekttyp (basis/subjekt/subjekttyp)
  • Todesort (einwohner/einwohner/todesort)
  • UnternehmensId (basis/subjekt/unternehmensid)
  • UnternehmensId-Kategorie(basis/subjekt/unternehmensid_kategorie)
  • Vornamen (einwohner/einwohnername/vornamen)
  • Wegzugdatum Wegzugdatum (einwohner/wegzug/wegzugdatum)
  • ZemisNr (einwohner/einwohner/zemisnr)
  • Zuzugsdatum (einwohner/zuzug/zuzugdatum)

v.3.0

Zusammenfassung

  • CMI Mindestversion: 23.0.2
  • STS 2.0 wird nicht mehr unterstützt

  • Neu wird eine Datenbank für den Betrieb benötigt

  • Der Service unterstützt mehrere Mandanten

    • Die URL in CMI muss mit dem Mandanten ergänzt werden
  • Config-UI für die fachliche Konfiguration der Schnittstelle
    • Neu wird auch der geplante Task im Config-UI konfiguriert

  • Die STS Client ID wird für die Hintergrundaufgaben (Service) und das Config UI separat konfiguriert

  • Neuer EWK-Provider Abraxas PER und Innosolv

Bug Fixes

  • GERES: Weggezogene Kontakte werden beim erneuten Synchronisieren auf Inaktiv gesetzt
  • Das Verhalten der Adresssynchronisierung von NSP und GERES wurde angepasst. Dieses ist in der jeweiligen Provider-Dokumentation dokumentiert

Mehrere CMI Mandanten

Der Service unterstützt mehrere Mandanten. Diese können im appsettings.json konfiguriert werden. Details siehe hier.

Neu muss auch der Mandantenname in der URL im CMI konfiguriert werden ( siehe Konfiguration CMI). Zum Beispiel muss die URL https://ccservice.cmiag.ch:5000 zu https://ccservice.cmiag.ch:5000/MANDANTEN-ID geändert werden.

Verwendung Datenbank

Neu braucht der Service eine Datenbank. Dabei wird MSSQL oder PostgreSql unterstützt. Details zur Einrichtung sind hier zu finden.

Anpassung appsettings.json ContactSyncService-Konfiguration-Serverseitig

  • Tenant.Security.Authority heisst nun Tenant.Security.CmiStsUri
  • Die STS Client ID wird für die Hintergrundaufgaben (Service) und das Config UI separat konfiguriert
  • Tenant.Caching.Enabled ist nicht mehr konfigurierbar. Der Cache kann nicht deaktiviert werden
  • Das komplette JSON-Objekt Tenant wurde im JSON-Objekt Tenants verschoben. Details siehe hier

Konfiguration der STS Client ID in Version 2:

"[Tenant-Key]": {
  "Security": {
    "Authority": "[STS-URL]",
    "Client_secret": "[STS-CLIENT-SECRET]",
    "Impersonated_user": "[IMPERSONATED-USERNAME]",
    "Client_id": "[STS-CLIENT-ID]",
    "Acr_Values": "[STS-API-SERVER-ID]",
  }
}

Konfiguration der STS Client ID in Version 3:

Impersonated_user und Acr_Values sind Parameter des CMI STS 2 und werden nicht mehr unterstützt.

"[Tenant-Key]": {
  "Security": {
    "CmiStsUri": "[STS-URL]",
    "Service": {
      "Client_secret": "[STS-CLIENT-SECRET]",
      "Client_id": "[STS-CLIENT-ID]"
    },
    "ConfigUi": {
      "Client_id": "[STS-CLIENT-ID]"
    }
  }
}

Fachliche Konfiguration gezügelt (Config-UI)

Neu ist die fachliche Konfiguration (Mappings, Providereinstellungen, geplanter Task) nicht mehr in CMI, sondern der ContactSync Service bietet neu eine Config-UI. Die Dokumentation der Config-UI ist hier zu finden.

Die Daten müssen manuell gezügelt werden. Folgendermassen kann eine einfache Migration gemacht werden:

  1. CMI R23 und ContactSyncService >= 3 ist installiert
  2. Auf der Datenbank die Query SELECT CNF_DATA FROM CNF WHERE CNF_KEY LIKE '%[PROVIDER]%' ausführen (wobei [PROVIDER] ein Platzhalter für den jeweiligen Provider ist) und die CNF_DATA in einer Datei abspeichern
  3. Config-UI öffnen und den enstsprechenden Provider auswählen
  4. Über die Menüfunktion "Import" das JSON vom Schritt 2 einfügen und importieren

> 2.X

  • Breaking changes beim API-Interface. Voraussetzung ist MetaTool Release >R22
  • Die Konfiguration wurde geändert. Migration muss manuell von der Version 1.X gemacht werden
  • Dotnet 6