Zum Inhalt springen

Wiki-Quellcode von FIT-Connect

Zuletzt geändert von MACH ProForms GmbH am 29.01.2025
Zeige letzte Bearbeiter
1 {{toc start="2"/}}
2
3 == Was ist "FIT-Connect"? ==
4
5 Mit der Einführung des Moduls FIT-Connect haben Sie eine weitere Möglichkeit Einreichungen von Assistenten an die zuständige Stelle zu übermitteln.
6 FIT-Connect ist ein Transport-Service, der z.B. die Einreichung über einen Webservice ersetzen kann.
7
8 == Notwendige Schritte ==
9
10 === Ablaufübersicht ===
11
12 * Self-Service-Portal:
13 ** Registrierung
14 ** Zustellpunkte und „Subscriber-Clients“ anlegen
15 * MACH formsolutions:
16 ** Mandantenrechte / Lizenzierung klären
17 ** Konfiguration MACH formsolutions Mandant
18 ** Veröffentlichungskonfiguration
19
20 === Registrierung auf dem Self-Service-Portal (SSP) der FITKO ===
21
22 Für die Nutzung der Funktionalität registrieren Sie sich für FIT-Connect auf dem Self-Service-Portal (SSP) der FITKO, um dort die Konfigurationen einzustellen.
23 [[Accountregistrierung und Client-Verwaltung | FIT-Connect>>https://docs.fitko.de/fit-connect/docs/getting-started/account]]
24
25 === Zustellpunkte und Clients anlegen im Self-Service-Portal (SSP) der FITKO ===
26
27 Nachdem die Registrierung erfolgt ist, können Sie Zustellpunkte und Clients im System von FIT-Connect anlegen. [[Client-Verwaltung | FIT-Connect>>https://docs.fitko.de/fit-connect/docs/getting-started/account/#client-verwaltung]]
28 Hiermit werden Zustellpunkte z.B. für bestimmte Behörden definiert.
29 Die Informationen zu diesen Onlinedienst-Clients tragen Sie bei der Veröffentlichungskonfiguration von Assistenten ein, um die Einreichung korrekt adressiert an FIT-Connect weitergeben zu können.
30
31 (% class="box warningmessage" %)
32 (((
33 Achtung: Das FIT-Connect Geheimnis des Sender-Clients wird aktuell nur bei der Anlage des Clients angezeigt. Notieren Sie sich dieses Geheimnis an geeigneter Stelle.
34 )))
35
36 === Konfiguration MACH formsolutions Mandant ===
37
38 ==== Voraussetzungen ====
39
40 * Mandantenrechte "Modulkonfiguration"; "FIT-Connect"
41 * Benutzerrecht "Ressourcen verwalten"
42
43 ==== Konfiguration ====
44
45 Rufen Sie den Menüpunkt auf: Einstellungen > Eigene Daten bearbeiten > Module > Erweiterte Modulkonfiguration > FIT-Connect-Konfiguration
46
47 [[image:firconnect_modulkonfig.png||alt="Modulkonfiguration Fit-Connect"]]
48
49 Vergeben Sie für die FIT-Connect Konfiguration eine Bezeichnung und eine Versionsnummer.
50 Die Adressen (URLs), die hier angegeben werden müssen, finden Sie im Artikel [[Betriebsumgebungen | FIT-Connect>>https://docs.fitko.de/fit-connect/docs/getting-started/environments/]].
51
52 * **URL für die Einreichung:** Hier wird die URL der FIT-Connect Umgebung eingetragen.
53 * **FIT-Connect Kunden-Nr.:** Der Sender-Client, der Absender.
54 * **FIT-Connect Geheimnis:** Dieses Geheimnis ist eine Art Passwort und wird bei der Anlage des Sender-Clients im Self-Service-Portal von FIT-Connect erzeugt.
55 Achtung: Dieses wird aktuell nur bei der Anlage des Clients angezeigt und danach nur noch verborgen. Notieren Sie sich dieses Geheimnis an geeigneter Stelle.
56 * **URL zur Authentifizierung:** Geben Sie hier die URL für die Authentisierung der Zugangsdaten an. Hier ist zu beachten, dass die URL in der FIT-Connect Dokumentation als OAUTH Token URL bezeichnet wird und mit "/token" endet (z.B.: "https:~/~/auth-refz.fit-connect.fitko.net/token"). Dieser letzte Teil ("/token") soll bei der Angabe im obigen Dialog nicht mit angegeben werden.  
57
58 === Veröffentlichungskonfiguration ===
59
60 Die Einreichung mit FIT-Connect konfigurieren Sie über die Option „Einreichung über FIT-Connect“.
61
62 [[image:firconnect_veroeffentlichungsk.png||alt="FIT-Connect Konfigurationsdialog der Veröffentlichung"]]
63
64
65 Der Button „Konfigurieren“ führt Sie in den Dialog zur Eingabe der Zustellpunkt-Parameter.
66
67 [[image:firconnect_veroeffentlichung_zustellpunkt.png]]
68
69 * **FIT-Connect Einreichung aktivieren:** Die Einreichung über FIT-Connect kann aktiviert und deaktiviert werden.
70 Wenn FIT-Connect aktiviert wurde, dann wird die Methode "Einreichung per Webservice" übersprungen und die Übermittlung der Antragsdaten erfolgt nur durch FIT-Connect.
71 * **Zustellpunkt-ID:** Die Zustellpunkt-ID entnehmen Sie der Konfiguration des Zustellpunkts, der für Ihre jeweilige Behörde im Self-Service-Portal (SSP) der FITKO hinterlegt wurde.
72 * **Leistungsschlüssel:** Hier muss der Leistungsschlüssel eingetragen werden, der zu dem Assistenten die Leistung in der Behörde beschreibt.
73 Bei der Anlage des Zustellpunkts wurden Leistungsschlüssel definiert, die beschreiben, welche Leistungen durch die Behörde angeboten werden. Da eine Behörde mehrere Leistungen anbieten kann, kann am Zustellpunkt eine Liste von Leistungsschlüsseln hinterlegt werden. Der Leistungsschlüssel, der hier angegeben werden muss, soll so angegeben werden, wie er im Leistungskatalog im FIM-Portal definiert ist. Falls die Leistung nicht in diesem Leistungskatalog aufgeführt ist, muss eine Einigung zwischen Sender und Empfänger über die Verwendung eines individuellen Leistungsschlüssels herbeigeführt werden.
74 Der Leistungsschlüssel muss einem Schlüssel aus der Liste der hinterlegten Werte entsprechen, sonst wird die Einreichung abgelehnt.
75 * **Fachdatenschema:** Hier kann der URN des Fachdatenschemas angegeben werden, welches in der Behörde zum Einsatz kommt, um die Daten einzulesen und zu verarbeiten. Diese Information wird bei der Anlage des Zustellpunkts im Self-Service-Portal (SSP) der FITKO hinterlegt. Falls der Zustellpunkt das Standard-Format der Einreichung von MACH formsolutions akzeptiert, dann kann am Zustellpunkt bei der URN folgendes Fachdatenschema**{{info}}urn:de:mach:proforms:formsolutions:assistant{{/info}}** hinterlegt werden. In diesem Fall kann das entsprechende Feld in dem obigen Dialog leer bleiben.
76 Bei der Einreichung wird geprüft, ob das hier eingegebene Schema vom Zustellpunkt unterstützt wird, anderenfalls wird die Einreichung abgelehnt.
77
78 ==== Dynamische Konfiguration ====
79
80 Zustellpunkt-ID und Leistungsschlüssel können auch durch Regeln im Assistentenbau dynamisch gesetzt werden.
81 Hierzu werden Formularfelder mit den technischen Bezeichnern **fs-destinationId **und **fs-leikaId **verwendet. Wenn diese Felder im Assistent existieren und befüllt sind, dann wird der Wert aus diesen Feldern für die Einreichung herangezogen und die Eingaben aus dem obigen Dialog überschrieben.