Portale

Über den Portal-Designer lassen sich benutzerspezifische Masken erstellen, die nicht mit internen Geschäftsobjekten arbeiten, sondern hauptsächlich zum Laden und Manipulieren externer Daten mit Hilfe von Lobster_data Profilen dienen.

Zentrales Werkzeug des Portal-Designers ist der Formulardesigner, der auch für die Erstellung von Geschäftsobjekt-Masken verwendet wird.

Portal-Übersicht

Über den Menüpunkt "Portale" (Verwaltung - Konfigurationen) gelangt man auf die Übersichtsseite der für den eingeloggten Benutzer sichtbaren Portale:

Die Ribbon-Buttons in der Hauptkategorie 'Allgemein' der Übersicht haben folgende Funktion:

Portal-Erfassungsmaske

Die Portal-Erfassungsmaske erlaubt das Anlegen und Ändern von Portalen. Über die Ribbonknöpfe werden die allgemeinen Funktionen gesteuert.

Details zum Portal sind über vier Tab-Reiter verteilt.

Aufbau des Ribbons

Tab-Reiter "Portal"

Der Tab-Reiter "Portal" enthält allgemeine Parameter des Portals:

• Der Portalname kann frei gewählt werden. Er muss allerdings innerhalb des Systems eindeutig sein. Der Name kann später über die Sprachverwaltung lokalisiert werden. In der Sprachverwaltung muss dazu der Eintrag zum Resource Name "Portal$<NAME>" im Resource Bundle "scm.portal" bearbeitet werden.

• Per Icon URI kann über den standardisierten Icon-Browser (Schaltfläche Auswählen) ein Icon ausgewählt werden, das in der Titelleiste des Portals und ggf. für den Menüeintrag des Portals verwendet werden soll. Der Icon-Pfad kann aber auch direkt eingegeben oder editiert werden.

• Die Option Im Menü anzeigen legt fest, ob das Portal über das Hauptmenü aufrufbar sein soll. Lediglich für Portale, die ausschließlich als modale Dialoge durch andere Portale oder Erfassungsmasken aufgerufen werden sollen, wird man dieses Häkchen nicht setzen.

• Wenn die Option Im Menü anzeigen gesetzt ist, erscheint ein Eingabefeld für den Menü-Eintrag. Hier kann angegeben werden, an welcher Position im Hauptmenü-Baum der Eintrag für das Portal erscheinen soll.

  • 'Root' erscheint hier als Standardwert. Mit dieser Einstellung erscheint das Portal als Eintrag der Einstiegsebene.

  • Ein Klick auf das Burger-Menü-Symbol öffnet eine Auswahlliste vorhandener Menüeinträge, in der ein 'Elternelement' für das Portal ausgewählt werden kann.

  • Es ist auch möglich den Menüpfad einzugeben oder zu bearbeiten, der die internen Namen von Elementen unterhalb der Einstiegsebene durch Schrägstiche verkettet.

    Für unbekannte Elementnamen in einem Pfad werden automatisch Menüebenen ergänzt, die anschließend auch lokalisiert werden könnten:

    

Tab "Editor"

Dieses Tab zeigt einen Formulardesigner. Die Bedienung sowie die Schaltflächen und Komponenten des Editors werden auf der verlinkten Seite beschrieben.

Tab "Form XML"

Die hier ausgegebene XML-Struktur dient in erster Linie zur Analyse des erzeugten Form-XML Formates und kann ferner auch zum Kopieren des gesamten Portals in ein anderes Lobster Data Platform / Orchestration-System verwendet werden. Details dazu werden auf der Seite Formulardesigner beschrieben.

Tab "Renderer XML"

Die hier ausgegebene XML-Struktur entspricht der Struktur, welche veröffentlicht wurde und die ein Benutzer beim Verwenden der Maske lädt. Details dazu werden auf der Seite Formulardesigner beschrieben.

Datenfelder in Portalen

Im Kontext von Portalen ist die Definition von Datenfeldern wichtig, um die gewünschte Datenstruktur zu erzeugen oder abzubilden.

Formular-Elemente ohne Angabe eines Datenfelds (ohne Text in der Datenfeld-Eigenschaft) werden ignoriert. Für ein Element, das andere Elemente enthält (siehe Element Container) bedeutet das, dass der Container nicht in der Datenstruktur erscheint, während enthaltene Elemente mit Angaben eines Datenfelds sehr wohl erscheinen können.

Anstelle den Text der Datenfeld-Eigenschaft zu entfernen, kann man auch den Wert 'Überspringen' setzen, indem man auf die Schaltfläche rechts neben der Eigenschaft klickt:

• Anstelle des Datenfelds erscheint der Text 'Überspringen', in der Eigenschaft, die schreibgeschützt ist, bis die Schaltfläche erneut gedrückt wird.

• Alternativ kann man auch die Zeichenfolge $skip$ für die Datenfeld-Eigenschaft eingeben. Diese Eingabe wirkt wie ein Klick auf die Schaltfläche.

• Existiert beim Umstellen auf 'Überspringen' ein Eintrag für das Datenfeld, bleibt dieser unsichtbar gespeichert. Er wird reaktiviert, wenn die Schaltfläche erneut geklickt wird.

 WICHTIG  Für Elemente, die keine anderen Elemente mit Datenfeld-Einträgen enthalten, wirkt die Auswahl von 'Überspringen' wie das Angaben keines Datenfelds. Ein Element Container verhält sich dagegen wesentlich anders, da das 'Überspringen' nicht nur den Container sondern auch alle darin enthaltenen Felder mit Datenfeldeinträgen aus der Datenstruktur entfernt.

Siehe auch Einblick in die Elementdatentechnik

Anwendungsbeispiele für Portale

{
    "fahrzeugDetails": {
        "fahrzeugID": "12345",
        "fahrzeugName": "Gabelstapler UH8"
    },
    "fahrerInfo": {
        "vorname": "Max",
        "nachname": "Mustermann"
    }
}

{
    "tasks": [
        {
            "beschreibung": "Projektplan erstellen",
            "erledigt": true
        },
        {
            "beschreibung": "Umsetzung der Meilensteine",
            "erledigt": true
        },
        {
            "beschreibung": "Testen der neuen Programmfunktionen",
            "erledigt": false
        }
    ]
}

Anbindung von Lobster_data-Profilen als mögliche Daten-Transaktionsschicht

Portale an sich haben – im Gegensatz zu Geschäftsobjektmasken – keine Möglichkeit, automatisch Daten in Lobster Data Platform / Orchestration zu speichern. Portale dienen lediglich dazu, eine definierte Datenstruktur zu laden, zu befüllen oder zu erzeugen. Woher diese Daten kommen oder was mit ihnen anschließend passiert, wird in der Regel über Lobster_data-Profile gesteuert. Mit einer Ausnahme: Wird ein Portal von einem anderen Dialog gerufen, werden dessen Daten weiterverarbeitet.

Die Kommunikation zwischen einem Portal und Lobster_data-Profilen wird über Verhaltensweisen und Aktionen gesteuert. Sollen beispielsweise beim Öffnen des Portals Daten von einem Profil abgeholt werden, kann dies mit dem Verhalten "Profil aufrufen" auf Formularebene (Ereignis: "Formulardaten geladen") geschehen. Um die Daten, welche vom Profil zurückgeliefert werden, in das Portal zu laden, muss in demselben Verhalten die Aktion "Elementdaten setzen" auf das Formular angewendet werden.

Das Zurückschreiben bzw. Übergeben der Daten an ein anderes System passiert ebenfalls über den Aufruf eines Lobster_data-Profils. Dabei gilt, dass dem Profil stets die Daten eines verknüpften Elements als Eingangsdaten mitgeliefert werden. Wird kein Element verknüpft, werden die Daten des gesamten Portals (siehe oberes Beispiel für Datenstrukturen) mitgegeben.

Das nachfolgende Beispiel zeigt ein Standardszenario "Laden, Manipulieren und Zurückschreiben von Daten".

Auf diese Weise lassen sich sämtliche von Lobster Data Platform / Orchestration unabhängige Datentransaktionen zu beliebigen Systemen und Datenbanken realisieren.

• Einblick in die Elementdatentechnik