Migration von 8.26 und älteren Versionen
Zwischen den Versionen 8.26.x und 8.27.x wurde das Konfigurationsdateiformat für VIS und die zugehörigen Plugins grundlegend geändert. Frühere Versionen verwendeten das traditionelle, auf XML basierende Konfigurationsformat des .NET Framework 4.8. Ab Version 8.27.x basiert die Konfiguration auf dem JSON-Format von .NET 8. Diese Seite beschreibt die erforderlichen Schritte beim Update eines WTS, das ein beliebiges VIS-Plugin (wie GDT, HL7 oder Universal-Plugin) enthält, von Version 8.26 oder älter auf eine neuere WTS-Version.
Ab Version 8.27.x werden VIS und alle VIS-Plugins über eine einzige Konfigurationsdatei konfiguriert:
%PROGRAMFILES%\SCHUHFRIED GmbH\Vienna Test System 8\IntegrationService\appsettings.json
Hinweis: Dies ist der Standard-Installationspfad. Wenn das Wiener Testsystem an einem anderen Ort installiert wurde, kann der tatsächliche Pfad entsprechend abweichen.
Jedes Plugin hat seinen eigenen Abschnitt in dieser Datei. Beim Migrieren bestehender VIS-Setups auf eine neuere Version müssen die Einstellungen aus den zuvor separaten Konfigurationsdateien in diese Abschnitte übertragen werden.
Es wird dringend empfohlen, vor der Durchführung der Migration die bestehenden Konfigurationsdateien zu sichern.
Migrieren der GDT-Konfiguration
Um die Konfiguration des GDT-Plugins zu migrieren, müssen die Einstellungen der Datei, die sich standardmäßig unter C:\Program Files (x86)\SCHUHFRIED GmbH\Wiener Testsystem 8\Service\Plugins\WTS.Integration.Plugins.GDT.GDTPlugin.dll.config befindet, in die oben beschriebene gemeinsame Konfigurationsdatei appsettings.json übertragen werden.
Die folgende Tabelle zeigt die Zuordnung der Einstellungen von der alten zur neuen Struktur:
8.26.x Datei: WTS.Integration.Plugins.GDT.GDTPlugin.dll.config | 8.27.x Datei: appsettings.json |
|---|---|
(nicht vorhanden in früheren Versionen) | Abschnitt: GDTPlugin; Wert: Enabled |
(nicht vorhanden in früheren Versionen) | Abschnitt: GDTPlugin; Wert: TimeoutInSec |
Abschnitt: appSettings; Wert: GDTSourceDirectory | Abschnitt: GDTPlugin; Wert: GDTSourceDirectory |
Abschnitt: appSettings; Wert: GDTOutputDirectory | Abschnitt: GDTPlugin; Wert: GDTOutputDirectory |
Abschnitt: appSettings; Wert: GDTSender | Abschnitt: GDTPlugin; Wert: GDTSender |
Abschnitt: appSettings; Wert: GDTReceiver | Abschnitt: GDTPlugin; Wert: GDTReceiver |
Abschnitt: appSettings; Wert: MandantName | Abschnitt: AppSettings; Wert:Service.MandantName |
Abschnitt: appSettings; Wert: PersonDefaultLanguage | Abschnitt: GDTPlugin; Wert: PersonDefaultLanguage |
Abschnitt: appSettings; Wert: PersonDefaultEducationLevel | Abschnitt: GDTPlugin; Wert: PersonDefaultEducationLevel (ohne Anführungszeichen) |
Abschnitt: appSettings; Wert: ExportRawScore | Abschnitt: GDTPlugin; Wert: ExportRawScore (ohne Anführungszeichen) |
Abschnitt: appSettings; Wert: PDFExportPath | Abschnitt: GDTPlugin; Wert: PDFExportPath (doppelte Backslashes) |
Wird aus den Einstellungen in der Administrationssoftware übernommen “Einstellungen –> Daten-Export/Import –> Standardordner für Datenexport” | Abschnitt: GDTPlugin; Wert: StandardExportFolder (doppelte Backslashes) |
(nicht vorhanden in früheren Versionen) | Abschnitt: GDTPlugin; Wert: StoreProcessedFailedFiles |
Abschnitt: ExportDefinitionGroup | Abschnitt: GDTPlugin; Wert: ExportDefinitionGroup (please see the picture below) |
Mapping der GDT ExportDefinitionGroup von XML auf JSON
Eine genaue Beschreibung, welche Werte in der Konfigurationsdatei gesetzt werden können, findet sich auf der Seite: GDT-Plugin.
Migrieren der HL7-Konfiguration
Um die Konfiguration des HL7-Plugins zu migrieren, müssen die Einstellungen der Datei, die sich standardmäßig unter C:\Program Files (x86)\SCHUHFRIED GmbH\Wiener Testsystem 8\Service\Plugins\WTS.Integration.Plugins.HL7.HL7Plugin.dll.config befindet, in die oben beschriebene gemeinsame Konfigurationsdatei appsettings.json übertragen werden.
Die folgende Tabelle zeigt die Zuordnung der Einstellungen von der alten zur neuen Struktur:
8.26.x Datei: WTS.Integration.Plugins.HL7.HL7Plugin.dll.config | 8.27.x Datei: appsettings.json |
|---|---|
(nicht vorhanden in früheren Versionen) | Abschnitt: HL7Plugin; Wert: Enabled |
Abschnitt: appSettings; Wert: ReceivingApplication | Abschnitt: HL7Plugin; Wert: ReceivingApplication |
Abschnitt: appSettings; Wert: ReceivingFacility | Abschnitt: HL7Plugin; Wert: ReceivingFacility |
Abschnitt: appSettings; Wert: SendingApplication | Abschnitt: HL7Plugin; Wert: SendingApplication |
Abschnitt: appSettings; Wert: SendingFacility | Abschnitt: HL7Plugin; Wert: SendingFacility |
Abschnitt: appSettings; Wert: Mode | Abschnitt: HL7Plugin; Wert: Mode |
Abschnitt: appSettings; Wert: FileShareBasePath | Abschnitt: HL7Plugin; Wert: FileShareBasePath (doppelte backslashes) |
Abschnitt: appSettings; Wert: TCPClientRemoteHost | Abschnitt: HL7Plugin; Wert: TCPClientRemoteHost |
Abschnitt: appSettings; Wert: TCPClientRemotePortORU | Abschnitt: HL7Plugin; Wert: TCPClientRemotePortORU |
Abschnitt: appSettings; Wert: TCPClientRemotePortMDM | Abschnitt: HL7Plugin; Wert: TCPClientRemotePortMDM |
Abschnitt: appSettings; Wert: TCPListenerPort | Abschnitt: HL7Plugin; Wert: TCPListenerPort |
Abschnitt: appSettings; Wert: TCPSendTimeout | Abschnitt: HL7Plugin; Wert: TCPSendTimeout |
Abschnitt: appSettings; Wert: SendAck | Abschnitt: HL7Plugin; Wert: SendAck |
Eine genaue Beschreibung, welche Werte in der Konfigurationsdatei gesetzt werden können, findet sich auf der Seite: HL7-Plugin.
Migrieren der Universal-Plugin-Konfiguration
Um die Konfiguration des Universal-Plugins zu migrieren, müssen die Einstellungen der Datei, die sich standardmäßig unter C:\Program Files (x86)\SCHUHFRIED GmbH\Wiener Testsystem 8\Service\Plugins\WTS.Integration.Plugins.Universal.UniversalPlugin.dll.config befindet, in die oben beschriebene gemeinsame Konfigurationsdatei appsettings.json migriert werden.
Die folgende Tabelle zeigt die Zuordnung der Einstellungen von der alten zur neuen Struktur:
8.26.x Datei: WTS.Integration.Plugins.Universal.UniversalPlugin.dll.config | 8.27.x Datei: appsettings.json |
|---|---|
(nicht vorhanden in früheren Versionen) | Abschnitt: UniversalPlugin; Wert: Enabled |
Abschnitt: appSettings; Wert: DefaultTestBattery | Abschnitt: UniversalPlugin; Wert: DefaultTestBattery |
Abschnitt: serviceCertificate; Wert: x509FindType | Abschnitt: UniversalPlugin; Wert: CertificateSearchKind |
Abschnitt: serviceCertificate; Wert: findWert | Abschnitt: UniversalPlugin; Wert: CertificateSearchWert |
Abschnitt: appSettings; Wert: UniversalPluginAuthUserName | Abschnitt: UniversalPlugin; Wert: UsernameToVisService (optional) |
Abschnitt: appSettings; Wert: UniversalPluginAuthPassword | Abschnitt: UniversalPlugin; Wert: PasswordToVisService (optional) |
Abschnitt: appSettings; Wert: ImportPersonsFromCSV | Abschnitt: ImportExportPlugin; Wert: ImportPersonsFromCSV |
Abschnitt: appSettings; Wert: ExportTestResultsToCSV | Abschnitt: ImportExportPlugin; Wert: ExportTestResultsToCSV |
Abschnitt: appSettings; Wert: MandantName | Abschnitt: ImportExportPlugin; Wert: MandantName |
Abschnitt: appSettings; Wert: ImportExportInterval | Abschnitt: ImportExportPlugin; Wert: ImportExportInterval (ohne Anführungszeichen) |
Abschnitt: appSettings; Wert: ExternToInternCandidatesMap | Abschnitt: ImportExportPlugin; Wert: ExternToInternCandidatesMap |
Abschnitt: appSettings; Wert: ExternPersonsCsvFilePath | Abschnitt: ImportExportPlugin; Wert: ExternPersonsCsvFilePath (doppelte Backslashes) |
Abschnitt: appSettings; Wert: ExportResultsCsvFilePath | Abschnitt: ImportExportPlugin; Wert: ExportResultsCsvFilePath (doppelte Backslashes) |
Abschnitt: appSettings; Wert: CsvExportProfile | Abschnitt: ImportExportPlugin; Wert: CsvExportProfile Abschnitt: PisaExportPlugin; Wert: CsvExportProfile |
Abschnitt: appSettings; Wert: User | Abschnitt: ImportExportPlugin; Wert: User Abschnitt: PisaExportPlugin; Wert: User |
Abschnitt: appSettings; Wert: ExportLanguage | Abschnitt: ImportExportPlugin; Wert: ExportLanguage |
Abschnitt: appSettings; Wert: StorageFolder | Abschnitt: ImportExportPlugin; Wert: StorageFolder (doppelte Backslashes) |
Wert does not exists (filled automatically by installer) | Abschnitt: ImportExportPlugin; Wert: PortalApiAddress |
Abschnitt: appSettings; Wert: enableClientTestresultListener | Abschnitt: PisaExportPlugin; Wert: enableClientTestresultListener (ohne Anführungszeichen) |
Abschnitt: appSettings; Wert: ExportInterval | Abschnitt: PisaExportPlugin; Wert: ExportInterval (ohne Anführungszeichen) |
Abschnitt: appSettings; Wert: Scoringmethod | Abschnitt: PisaExportPlugin; Wert: Scoringmethod |
Abschnitt: appSettings; Wert: WordTemplateName | Abschnitt: PisaExportPlugin; Wert: WordTemplateName |
Abschnitt: appSettings; Wert: UseWordTemplateForPDFGeneration | Abschnitt: PisaExportPlugin; Wert: UseWordTemplateForPDFGeneration (ohne Anführungszeichen) |
Abschnitt: appSettings; Wert: Endpoint | Abschnitt: PisaExportPlugin; Wert: Endpoint |
Abschnitt: appSettings; Wert: SoapAction | Abschnitt: PisaExportPlugin; Wert: SoapAction |
Abschnitt: appSettings; Wert: ClientCertificateSearchKind | Abschnitt: PisaExportPlugin; Wert: ClientCertificateSearchKind |
Abschnitt: appSettings; Wert: ClientCertificateSearchWert | Abschnitt: PisaExportPlugin; Wert: ClientCertificateSearchWert |
Eine genaue Beschreibung, welche Werte in der Konfigurationsdatei gesetzt werden können, findet sich auf der Seite: Universal-Plugin.
Das Universal-Plugin bietet ein SOAP-basiertes Webservice, welches mit dem WCF-Framework implementiert ist und sich durch traditionelle XML-Konfiguration umfangreich anpassen lässt. Zusätzlich zu den allgemeinen Plugin-Einstellungen, die in appsettings.json definiert sind, verwendet das Universal-Plugin daher eine separate Konfigurationsdatei für WCF-spezifische Einstellungen:
%PROGRAMFILES%\SCHUHFRIED GmbH\Vienna Test System 8\IntegrationService\Plugins\VTS.Integration.Plugins.Universal.dll.wcf.config
Hinweis: Dies ist der Standard-Installationspfad. Wenn das Wiener Testsystem an einem anderen Ort installiert wurde, kann der tatsächliche Pfad entsprechend abweichen.
Die Standard-WCF-Konfiguration ist so ausgelegt, dass sie die meisten Anwendungsfälle abdeckt und in der Regel bei Standardbereitstellungen unverändert bleibt.