From 52a66b56943604bdc520ecea409872f3d8b8b5a9 Mon Sep 17 00:00:00 2001
From: KoCoPST <160596791+KoCoPST@users.noreply.github.com>
Date: Tue, 20 Feb 2024 17:10:05 +0100
Subject: [PATCH] =?UTF-8?q?WSDL=20und=20XSD=20f=C3=BCr=20QR-Code=20Funktio?=
=?UTF-8?q?n=20hinzugef=C3=BCgt?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
SOAP-Endpunkt:
```xml
Service mit herstellerspezifischen Operationen
Version="1.0.0">
Herstellerspezifische Operationen gemäß WSDL 1.0.0
```
Request:
```xml
?
?
?
?
?
?(string maxLength 512, muss umdefiniert werden, weil 48 zu wenig ist; charset=(ISO 18004 oder ISO 16022))
? (mininclusiv = 5 maxinclusiv = 60)
```
Ablauf:
| Nr. | Aufruf Technischer Use Case oder Interne Operation | Beschreibung | Kommentare |
| ----- | --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| Nr. 1 | checkArguments | Die übergebenen Werte werden auf Konsistenz und Gültigkeit überprüft. Treten hierbei Fehler auf, so bricht die Operation mit Fehler 4000 ab. | nur Schemaprüfung (charSet hat nur 2 gültige Werte. Es wird versucht dies im Schema abzubilden. Alternativ muss dies in der Fascade geprüft werden.) |
| Nr. 2 | TUC_KON_000 „Prüfe Zugriffsberechtigung“ | Prüfung der Zugriffsberechtigung durch den Aufruf TUC_KON_000 { mandantId = $context.mandantId; clientSystemId = $context.clientsystemId; workplaceId = $context.workplaceId; ctId = $CtId; needCardSession=false; allWorkplaces=false }Tritt bei der Prüfung ein Fehler auf, so bricht die Operation mit dem Fehlercode aus TUC_KON_000 ab. | |
| Nr. 3 | TUC_KON_051a „Mit Anwender über Kartenterminal interagieren QR“ | Aufruf TUC_KON_051( ctId = $CtId; displayMessage = $DisplayMsg; waitTimer = $TimeOut; charSet = $charset) | |
TUC_KON_051a „Mit Anwender über Kartenterminal interagieren QR“:
| Element | Beschreibung |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Name | TUC_KON_051a „Mit Anwender über Kartenterminal interagieren QR“ |
| Beschreibung | Der TUC ermöglicht es, QR-Code und Data-Matrix-Code an das Display eines Kartenterminals zu senden. |
| Auslöser | herstellerspezifische Außenoperation DisplayQRCode |
| Vorbedingungen | • KT ist in CTM_CT_LIST vorhanden
• CT.CORRELATION = „aktiv“
• CT.CONNECTED = Ja
• CT.IS_PHYSICAL = Ja |
| Eingangsdaten | • ctId (Kartenterminalidentifikator)
• displayMessage – mandatory (Text zur Darstellung am KT, Länge durch KT begrenzt);
• waitTimer – mandatory (Wartezeit bis zur ersten Eingabe in Sekunden)
• charSet – mandatory (definiert "Character Set Index Value" des SICCT-Befehls) |
| Komponenten | Konnektor, Kartenterminal |
| Ausgangsdaten | opResult [OK] oder SOAP-Fault |
| Nachbedingungen | |
| Standardablauf | 1\. KT-Lock von TUC_KON_051 reservieren.
2\. Der Konnektor MUSS via SICCT OUTPUT am CT displayMessage zur Anzeige bringen. Nach einer Wartezeit von waitTimer Sekunden MUSS der Konnektor die Anzeige des KT leeren. Für den SICCT OUTPUT Befehl muss das übergebene charset verwendet werden.
wenn:
charset = ISO 18004, dann "Character Set Index Value" = '30'
charset = ISO 16022, dann "Character Set Index Value" = '40'
3\. KT-Lock von TUC_KON_051 frei geben. |
| Varianten/ Alternativen | Ist das Kartenterminal-Display durch einen anderen, zeitgleich im Konnektor ablaufenden Vorgang reserviert, wird Fehler 4039 geworfen. |
| Fehlerfälle | (wie in TUC_KON_051)
Fehler in den folgenden Schritten des Ablaufs führen zum Aufruf von
TUC_KON_256 { topic = "CT/ERROR"; eventType = $ErrorType; severity = $Severity; parameters = („CtID=$ctId, Name=$CT.HOSTNAME, Error=$Fehlercode, Bedeutung=$Fehlertext“) }
(->1) Display und PinPad des Kartenterminals sind aktuell belegt (PIN, Eingabe, andere Ausgabe etc.), Fehlercode: 4039
(->1) Kartenterminal antwortet mit einer spezifischen Fehlermeldung, Fehlercode |
| Nichtfunktionale Anforderungen | keine |
| Zugehörige Diagramme | keine |
---
conn/CardTerminalService2DCode_v1_0_0-1.wsdl | 60 +++++++++++++++
conn/CardTerminalService2DCode_v1_0_0-1.xsd | 78 ++++++++++++++++++++
2 files changed, 138 insertions(+)
create mode 100644 conn/CardTerminalService2DCode_v1_0_0-1.wsdl
create mode 100644 conn/CardTerminalService2DCode_v1_0_0-1.xsd
diff --git a/conn/CardTerminalService2DCode_v1_0_0-1.wsdl b/conn/CardTerminalService2DCode_v1_0_0-1.wsdl
new file mode 100644
index 0000000..36be16c
--- /dev/null
+++ b/conn/CardTerminalService2DCode_v1_0_0-1.wsdl
@@ -0,0 +1,60 @@
+
+
+
+ Beschreibung: Dienst zur Anzeige von 2D Codes auf Kartenterminals
+ version=1.0.0
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/conn/CardTerminalService2DCode_v1_0_0-1.xsd b/conn/CardTerminalService2DCode_v1_0_0-1.xsd
new file mode 100644
index 0000000..73c0561
--- /dev/null
+++ b/conn/CardTerminalService2DCode_v1_0_0-1.xsd
@@ -0,0 +1,78 @@
+
+
+
+
+
+ Copyright (c) 2023, CGM Deutschland AG. Alle Rechte
+ vorbehalten.
+ Beschreibung: Dienst zur Anzeige von 2D Codes auf Kartenterminals
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+