Webform

Last modified by jklein on 2025/02/10 12:37

Mit dem Webform-Produkt haben Sie die Möglichkeit, schnell und unkompliziert Web Formulare zu erstellen. Diese HTML-Formulare enthalten Eingabefelder, über die Informationen von Nutzern abgefragt werden können. Die eingegebenen Daten werden anschließend an den SICS übermittelt, wo sie mithilfe des AESB weiterverarbeitet und in die erforderlichen Datenbanken und Systeme integriert werden können.

Installationsvoraussetzungen

Für die Installation und Verwendung des Webform-Produkts benötigen Sie mindestens:

  • ASP.NET Core Runtime Version 8.0.12
  • DotNet Framework Version 8.0.12

Warning  Warning:  

Diese Systemanforderungen für das Webform-Produkt sind höher als die Standard-Systemanforderungen für AESB generell. Prüfen Sie daher vor der Installation des Webform-Produkts Ihre Systemanforderungen erneut.

Funktionsweise

Im Workspace Produkte können Sie sich alle Komponenten anzeigen lassen, aus denen sich das Produkt zusammensetzt. Wählen Sie dafür das Webform-Produkt aus und klicken Sie im rechten Fenster auf den Button Zusammenfassung anzeigen. Nun werden Ihnen alle Komponenten eingeblendet, die in der Produkt-Installation enthalten sind.

Zusammenfassung der Webform-Komponenten

Zusammenfassung der Webform-Komponenten

Komponente 

Funktion 

Webform Microservice

Als Webform wird das Microservice-Paket benannt, welches bei der Produkt-Installation erstellt wird. Auf Basis des Microservice-Pakets wird dann die Microservice-Instanz Webform Microservice erstellt.

Die Web Formulare können farblich individuell gestaltet und an das Corporate Design des Unternehmens angepasst werden. Die Sprache der Benutzeroberfläche wird automatisch aus den Browsereinstellungen übernommen. Zudem bieten die Formulare die Möglichkeit, in verschiedene Abschnitte unterteilt zu werden und Weiterleitungen nach dem Absenden der Eingaben flexibel zu konfigurieren.

Beispiel eines Web Formulars in der Benutzeransicht

Beispiel eines Web Formulars in der Benutzeransicht

Installation

Wählen Sie im Tab Übersicht das Produkt Webform aus. Klicken Sie anschließend in der Ribbonleiste auf den Button Installieren, um die Installation der aktuellsten Version des Webform-Produkts zu starten. Nun öffnet sich der Installations-Wizard. 

Hinweis  Note:  

Die grundlegenden Funktionen des Installations-Wizards sind im allgemeinem Abschnitt zum Produkt-Arbeitsbereich aufgeführt und werden deshalb hier nicht genauer erklärt. 

Klicken Sie auf den Button Weiter, um die Installation fortzusetzen. 

Konfiguration des Webform-Microservice

Im zweiten Schritt müssen Sie die Konfiguration des Web Formulars vornehmen. Wählen Sie dafür zu Beginn einen Namen für die Microservice-Vorlage oder übernehmen Sie den Standard-Vorlagennamen. 

Haupteinstellungen

In den Haupteinstellungen können Sie zunächst die Formular-Informationen und das Formular-Aussehen individuell konfigurieren. Als Verbindungsinformationen müssen Sie den Port und die Routing-Einstellungen festlegen, damit das Web Formular erreicht werden kann und Formular-Eingaben eines Nutzers übermittelt werden können.

Warning  Warning:  

Um die Werte aus dem Web Formular weiterverarbeiten zu können, muss das Routing für einen PowerShell-Microservice in den Routing-Einstellungen eingetragen sein. Mehr Informationen dazu finden Sie im Abschnitt Weiterverarbeitung.

Nun können Sie Sektionen hinzufügen.

Sektionen

Erstellen Sie eine Sektion und benennen Sie die Sektion. Jede Sektion kann optional mit zusätzlichen Informationen ergänzt werden. Sie können zwischen drei verschiedenen Sektionsarten wählen:

  • Überschriftssektion = Die Sektion wird mit Titel und Beschreibung dargestellt
  • Statischer Text = Die Sektion wird mit einem statischen Anzeigetext dargestellt
  • Leerzeile = Die Sektion wird nur mit den Eingabefeldern ohne zusätzliche Informationen dargestellt

Nun können Sie der Sektion beliebig viele Eingabefelder hinzufügen.

Erstellen einer Sektion im Webform-Produkt

Erstellen einer Sektion

Eingabefelder

Erstellen Sie ein Eingabefeld und vergeben Sie einen Namen für das Feld. Nun können Sie das Feld konfigurieren und eine der folgenden Feldarten wählen:

  • String 
  • Password
  • Boolean
  • Integer
  • Floating Point Number
  • Enumeration
  • Date
  • Static Text
  • Blank Field
  • RatingScale

Hinweis  Note:  

Einige Konfigurationsmöglichkeiten sind nur bei bestimmten Feldarten verfügbar.

Konfiguration von Eingabefeldern

Konfiguration von Eingabefeldern

Weiterverarbeitung

Die einfachste Art der Weiterverarbeitung der Formular-Daten, ist die Weiterverarbeitung mit PowerShell-Microservices oder mit Workflows. Dazu müssen Sie in den Haupteinstellungen den Virtual Router VMSMN für die Weiterverarbeitung per PowerShell-Microservice oder WF für die Weiterverarbeitung per Workflow auswählen.

Die ICQL-Nachricht, auf die Sie für die Weiterverarbeitung zugreifen können, entspricht folgendem Aufbau:

<ICQL>
    <HtmlFormsMicroService>
        <SubmitResultMessage>
            <SectionName>
                <FieldName> value </FieldName>
            </SectionName>
        </SubmitResultMessage>
    </HtmlFormsMicroService>
</ICQL>

 

© Aagon GmbH 2025
Besuchen Sie unsere Aagon-Community