OSI

Notwendige Schritte

Ablaufübersicht

Für die Nutzung eines OSI-Servicekontos bzw. OSI-Bürgerportals ist die Nutzungsvereinbarung mit einem entsprechenden Anbieter notwendig. Dieser Schritt muss eigenständig erfolgen und ist Voraussetzung für die Anbindung Ihres MACH formsolutions Mandanten.

einmalig

  • Anbieter des Bürgerportals bzw. Servicekontos kontaktieren
    Sie erhalten ggf. technische Informationen zu den für die jeweilige Schnittstelle erforderlichen Mandanten-Einstellungen.

  • MACH formsolutions:

    • Mandantenrechte / Lizenzierung klären

    • Konfiguration MACH formsolutions Mandant

    • Herunterladen der Metadaten

  • Übermittlung der Metadaten an den Anbieter des Bürgerportals bzw. Servicekontos

wiederkehrend

  • MACH formsolutions: Veröffentlichungskonfiguration

Anbindung an MACH formsolutions

Modulkonfiguration des MACH formsolutions Mandanten und Herunterladen der Metadaten

Veröffentlichungskonfiguration

Wählen Sie in der Veröffentlichungskonfiguration Ihrer Assistenten die Login-Anforderung "Anmeldung mit Bürgerportal" und die Option "OSI" aus.

Zwischenspeichern von Assistenten

Die Vorbefüllungsdaten, die durch die OSI-Schnittstelle geliefert werden, sind aus Gründen der Datensparsamkeit und Datensicherheit für nur jeweils eine Session gültig. Sollte der Antragsstellende den vorbefüllten Assistenten schließen, dann muss dieser sich gegebenenfalls erneut authentifizieren.
Daher ist das Zwischenspeichern von Assistenten mit durch die OSI-Schnittstelle erfülltem Vertrauensniveau nicht möglich.

Veröffentlichung mit zusätzlichen Parametern

Gegebenenfalls werden für die weitere Verarbeitung und Zuordnung des Onlinedienstes zusätzliche Parameter benötigt, zum Beispiel bei Anbindung an die OZG-Cloud.
Die Parameter hängen Sie an den vom Formularserver generierten Veröffentlichungslink an, wenn Sie den Link publizieren. Also wenn Sie den Link beispielsweise auf Ihrer Webseite publizieren oder per E-Mail verschicken.

Zu den bekannten / üblichen Parametern gehören zum Beispiel:

  • anliegenId

  • zustaendigeStelle

  • kommunalverwaltungId

Aufbau des Veröffentlichungslinks mit Parametern

Ein Parameter besteht für gewöhnlich aus dem Schlüsselnamen und dem zugehörigen Wert. Alle Schlüssel-Wert-Paare werden aneinander gehängt, jeweils mit einem &-Zeichen als Trenner.
Beispiel: anliegenId=000&zustaendigeStelle=000&kommunalverwaltungId=000

Die Parameterkette wird am Ende des Veröffentlichungslinks angehängt, mit einem Fragezeichen ? zwischen dem generierten Link und den Parametern.
Beispiel: formulare.musterhausen.de/metaform/Form-Solutions/sid/assistant/abcdef0123456789fedcba98?anliegenId=000&zustaendigeStelle=000&kommunalverwaltungId=000

Ein Link darf immer nur ein einziges Fragezeichen enthalten. Wenn Sie einen Veröffentlichungslink vorliegen haben, der schon ein Fragezeichen enthält, und Sie weitere Parameter anhängen möchten, stellen Sie den zusätzlichen Parametern ein &-Zeichen voran, statt einem Fragezeichen ?.
Beispiel: formulare.musterhausen.de/metaform/Form-Solutions/sid/assistant/abcdef0123456789fedcba98?p1=a&p2=b&anliegenId=000&zustaendigeStelle=000&kommunalverwaltungId=000