Business Objekte werden im Modul ‘Business Objekte’ verwaltet. Der Hauptbildschirm listet alle vorhandenen Business Objekte in Tabellenform auf. Oben links kannst du zwischen serverseitigen und clientseitigen Business Objekten wechseln.

Klicke auf ‘+’ in der oberen rechten Ecke, um ein neues von Grund auf zu erstellen. Dies öffnet den folgenden Bildschirm:

Wähle zuerst einen Namen für dein clientseitiges Business Objekt und definiere eine Beschreibung (optional). Füge einige Tags hinzu, damit du in den Übersichten und im UI Designer nach den Tags suchen kannst.

Du kannst dann beliebige Konnektoren, Plugins, serverseitige Business Objekte, clientseitige Business Objekte oder verwaltete Bibliotheken auf der linken Seite auswählen. Es öffnet sich ein Dialog, in dem du es auswählen kannst. Jedes ausgewählte Element erscheint in der Liste darunter, von wo aus du es auch wieder entfernen kannst, indem du auf das Löschsymbol unter ‘Aktionen’ klickst.

Wenn du fertig bist, verlasse den Bildschirm, indem du auf den ‘Speichern’-Button klickst und kehre zur Übersichtsseite zurück. Dein neues Business Objekt erscheint in der Tabelle.

Verwendung von clientseitigen Business Objekten

Du kannst sehen, welche Anwendungen oder Schnittstellen das Business Objekt verwenden. Klicke dazu auf das entsprechende Symbol innerhalb der Business Objekt-Übersicht unter ‘Aktionen’.

Es öffnet sich ein Popup, das alle verwendeten Anwendungen anzeigt:

Durch Klicken auf einen Eintrag öffnet sich die Anwendung, sodass du sie direkt bearbeiten kannst.

Zugriff auf Eingabe- und Ausgabeparameter von clientseitigen Business Objekten

Du kannst auf deine Eingabeparameter über oPayload zugreifen.<myInputParameter>.

Um die Ausgabeparameter zu verwenden, musst du ein Objekt zurückgeben, das deine Parameter als Eigenschaften hat. Z.B.

return {
  myOutputParameter : myOutputValue
}

Da clientseitige Business Objekte und ihre Inhalte asynchron aufgerufen werden, kann es vorkommen, dass ein Connector-Aufruf aufgerufen wird, der noch nicht abgeschlossen ist und undefiniert oder null zurückgegeben wird.

Um dies zu vermeiden, musst du stattdessen fnSuccess aufrufen.

fnSuccess ({
  myOutputParameter : myOutputValue  
})

Es muss in deinem letzten Callback/deiner letzten Funktion deines clientseitigen Business Objekts aufgerufen werden und gibt die Daten zurück.

Im Fehlerfall kann Folgendes angegeben werden:

fnError ("My error message")