Skip to content

Change log

v.4.9

Features

Allgemein

  • Neu kann die Konfiguration getestet werden. Details siehe hier.
  • Die Struktur der Dokumentation wurde überarbeitet.
  • Das Release wird mit Azure trusted Sign signiert.

Abraxas

  • Neues Feld GesetzlicheWohngemeinde für das Mapping der natürlichen Person.
  • Neues Feld Allianzname für das Mapping der natürlichen Person.
  • Neu wird auch die Wegzugsadresse synchronisiert.

ZSD

  • Neuer EWK-Provider ZSD.

Bug Fixes

Abraxas

  • Die Spalte "Schlüssel" bei den Suchergebnissen wird zuletzt angezeigt.

Innosolv

  • Bei der Ermittlung der Korrespondenzsprache wurde bisher ein falscher Wert verwendet. Dies wurde korrigiert – neu wird die korrekte Korrespondenzsprache berücksichtigt (Typ Subjekt.KorrSprache).

v.4.8

Bug Fixes

Allgemein

  • Fremdschlüssel-Generierung für Adressen: Die Logik zur Generierung von Fremdschlüsseln für synchronisierte Adressen eines Kontakts wurde grundlegend überarbeitet. Anstelle eines Inkrements wird nun ein Hash basierend auf relevanten Adressdaten (z. B. Strasse, PLZ, Adressart – je nach EWK-Provider unterschiedlich) generiert. Der Hash wird verglichen, um sicherzustellen, dass keine Duplikate entstehen, selbst wenn ein Kontakt erneut ab EWK aktualisiert wird. Dadurch wird eine konsistente und eindeutige Fremdschlüssel-Vergabe gewährleistet. Die Migration zum neuen Fremdschlüssel für Adressen erfolgt automatisch bei der nächsten Synchronisation des Kontakts. Betroffen sind die EWK-Provider Geres, Abraxas und NSP Infoma.

NSP Infoma

  • Ein Schreibfehler wurde korrigiert, bei dem "NSP Infoma" fälschlicherweise als "NSP Informa" angezeigt wurde.

v.4.7

Features

Innosolv

  • Neu kann die ID Systemrolle konfiguriert werden (siehe hier). Dabei wird 7028 als Standard-Wert verwendet.
  • Einführung des Feldes "Nationalität (Einwohner)", welches die Möglichkeit bietet, die Nationalität direkt über den Einwohner und nicht mehr über das Subjekt zuzuordnen.

Bug Fixes

  • Abhängigkeiten wurden auf die neusten Versionen aktualisiert

v.4.6

Bug Fixes

  • Abhängigkeiten wurden auf die neusten Versionen aktualisiert

v.4.5

Features

  • Das Config-UI wurde Layout-technisch überarbeitet und auf dem neusten Stand gebracht.

v.4.4

Features

Abraxas

  • Neu kann der Anmelde-Scope konfiguriert werden (siehe hier)

Bug Fixes

Innosolv

  • Das Mapping zum Gebiet wurde korrigiert und ist erst ab CMI Version 24.2 verfügbar.

v.4.3

Features

Abraxas

  • Neu wird der geplante Task für die Abraxas-EWK unterstützt.

Bug Fixes

Allgemein

  • Die Prüfung, ob der angemeldete Benutzer das Recht für die Verwendung der Config-UI hat, erfolgt neu bei jedem Request.

Geres

  • Ein Fehler beim Mapping des Rufnamens wurde behoben.

v.4.2

Bug Fixes

Innosolv

  • Das Mapping zum Gebiet ist erst ab CMI Version 24.2 verfügbar

v.4.1

Features

Allgemein

  • Die AHV-Nummer wird neu im Format XXX.XXXX.XXXX.XX angegeben

Bug Fixes

Innosolv

  • Das Mapping zum Gebiet wurde korrigiert

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