Dynamisch Symbole in Jitterbit App Builder ändern

Symbole sind normalerweise statisch und unveränderlich, aber manchmal muss man je nach Datenlage ein anderes Symbol anzeigen. Beispielsweise könnte man auf einer Seite, die die Personen anzeigt, die zu einem Event eingeladen wurden, ein Daumen-runter- oder Daumen-hoch-Symbol anzeigen, um zu kennzeichnen, ob sie teilnehmen oder nicht. Nachfolgend finden Sie Beispiele, wie Sie ein dynamisches Symbol in Ihrer App implementieren können.

In diesem Dokument beziehen wir uns auf benannte Symbole aus der Font Awesome-Symbolbibliothek. App Builder wird mit Font Awesome sowie zusätzlichen Symbolsätzen geliefert, die unter Symbolkategorien beschrieben sind. Eine Liste der in Font Awesome verfügbaren benannten Symbole finden Sie unter fontawesome.com.

Symbol-Steuerelement

Mit dem Symbol-Steuerelement können Sie den CSS-Namen eines Symbols (z. B. times-circle-o) übergeben, und es wird in der Symbolbibliothek gesucht, um es anzuzeigen. Es ist nicht möglich, die Symbolbibliothek zu erweitern.

Wenn Sie nur 1 oder 2 Symbole haben, können Sie wahrscheinlich eine IIF-Anweisung in Ihr Business Object einfügen und diese bestimmen lassen, welches Symbol angezeigt wird. Wenn Sie beispielsweise die Teilnahme an einem Event kennzeichnen möchten, würde man etwa IIF(Status = Accept, 'thumbs-up', 'thumbs-down') verwenden. Dieses Szenario funktioniert gut, wenn man nur ein paar Optionen zur Auswahl hat, wird aber kompliziert, wenn man mehr Optionen berücksichtigen muss. In unserem Beispiel möchte man möglicherweise auch ein Fragezeichen-Symbol anzeigen, wenn die Person ihre Einladung noch nicht angenommen oder abgelehnt hat.

In diesem Fall muss man entweder eine größere und kompliziertere IIF-Anweisung erstellen, um den dritten Status zu berücksichtigen, oder man kann das Datenmodell so ändern, dass es eine Spalte enthält, die das Symbol speichert. Die folgenden Schritte zeigen den Fall, in dem man das Datenmodell ändert.

1. Um das obige Beispiel fortzusetzen, muss man eine Status-Tabelle mit Spalten für StatusID, Status und Icon erstellen.
2. Geben Sie Informationen einschließlich der Symboltitel in die Status-Tabelle für jeden Status ein. Beispiele: Ja, Nein, Vielleicht
3. Erstellen Sie anschließend ein Business Object, das sich mit der Status-Tabelle verbindet. Unseres heißt Employee (Status). Wir bringen die Icon-Spalte aus der Status-Tabelle zur Verwendung ein.
4. Um diese Informationen in Ihrer App zu verwenden, stellen Sie sicher, dass Ihr Panel auf dem gerade erstellten Objekt basiert. Erstellen Sie ein Steuerelement namens Status als List Control Type mit Status (List) StatusID und Status, um die Optionen anzuzeigen.

Die Verwendung einer Spalte ist fast immer besser als eine IIF-Anweisung, da eine IIF-Anweisung neue Logik erfordert, wenn man einen neuen Status berücksichtigen muss. Wenn man aber eine Spalte in einer Statustabelle hat, kann man einem Benutzer erlauben, die verwendeten Symbole zu konfigurieren.

Relative URL-GUID des Bildes

Die IIF-Anweisung, die angibt, welches Symbol angezeigt werden soll, kann auf die relative URL-GUID des Bildes verweisen. Um den Bildwert der GUID zu erhalten, zeigen Sie das Bild in App Builder an und kopieren Sie den Wert aus dem Feld Relative URL, das nach .../image/ angezeigt wird. Dieser Wert kann nun entsprechend in der IIF-Anweisung verwendet werden.

Beispiel einer relativen URL-GUID eines Bildes

Beispiel einer IIF-Anweisung, die auf die relative URL-GUID eines Bildes verweist

List-Steuerelement

Das List-Steuerelement wird normalerweise verwendet, um eine Liste von Textwerten anzuzeigen, kann aber auch ein Bild zusammen mit dem Text oder nur das Bild selbst anzeigen. Beim Einrichten des List-Steuerelements muss man einfach zu Zusätzliche Attribute gehen und die Spalte auswählen, die die ImageID als Icon-Wert speichert. Die Verwendung des Image Purpose „Icon" ermöglicht es, dynamische Symbole zu haben. Da ein Entwickler die Bildbibliothek einer Anwendung erweitern kann, ist diese Methode für ein dynamisches „Symbol" etwas robuster als die Verwendung des Symbol-Steuerelements.

Um ein List-Steuerelement für dynamische Symbole zu nutzen, muss man eine Spalte haben, um die ImageID in der Tabelle zu speichern, die die List-Werte bereitstellt. Auf diese Weise kann man jeden List-Wert an ein bestimmtes Bild in der Collection der App binden. Genauso wie man einen Title-Wert aus einem List-Objekt extrahiert, um ihn als Text in der Liste anzuzeigen, extrahiert man auch eine ImageID aus dem List-Objekt, um dieses Bild neben dem Text anzuzeigen.