Dynamisches Ändern eines Symbols im Jitterbit App Builder

Symbole sind normalerweise statisch und unveränderlich, aber manchmal müssen Sie basierend auf Daten ein anderes Symbol anzeigen. Auf einer Seite, auf der die Personen angezeigt werden, die zu einer Veranstaltung eingeladen wurden, können Sie beispielsweise ein Symbol mit einem Daumen nach unten oder einem Daumen nach oben anzeigen, um anzuzeigen, ob sie teilnehmen oder nicht. Nachfolgend finden Sie Beispiele, wie Sie ein dynamisches Symbol in Ihrer App implementieren können.

Für die Zwecke dieses Dokuments beziehen wir uns auf benannte Symbole unter Verwendung der Symbolbibliothek von Font Awesome. App Builder wird mit Font Awesome geliefert. Eine Liste der verfügbaren benannten Symbole finden Sie unter fontawesome.com.

Symbolsteuerung

Mit dem Steuerelementtyp „Icon“ können Sie den CSS-Namen eines Icons übergeben (z. B. times-circle-o) durch und sucht in der Symbolbibliothek danach, um es anzuzeigen. Es ist nicht möglich, der Symbolbibliothek etwas hinzuzufügen.

Wenn Sie nur 1 oder 2 Symbole haben, können Sie wahrscheinlich ein IIF Anweisung in Ihr Business-Objekt ein und lassen Sie dieses bestimmen, welches Symbol angezeigt werden soll. Wenn Sie beispielsweise die Teilnahme an einer Veranstaltung kennzeichnen möchten, hätten Sie etwas wie IIF(Status = Accept, 'thumbs-up', 'thumbs-down'). Dieses Szenario funktioniert gut, wenn Sie nur ein paar Optionen zur Auswahl haben, wird aber komplizierter, wenn Sie mehr Optionen berücksichtigen müssen. In unserem Beispiel möchten Sie vielleicht auch ein Fragezeichensymbol anzeigen, wenn die Person ihre Einladung noch nicht angenommen oder abgelehnt hat.

Im obigen Fall müssen Sie entweder ein größeres und komplizierteres IIF Anweisung, um den dritten Status zu berücksichtigen, oder Sie können Ihr Datenmodell ändern, um eine Spalte einzuschließen, die das Symbol speichert. Die folgenden Schritte führen Sie durch den Fall, in dem Sie Ihr Datenmodell ändern.

1. Um mit dem obigen Beispiel fortzufahren, müssen Sie ein Status Tabelle mit Spalten für StatusID, Status, Und Icon.
2. Achten Sie darauf, Informationen einschließlich der Symboltitel in das Status Tabelle für jeden Status. Zum Beispiel: Ja, Nein, Vielleicht
3. Erstellen Sie als Nächstes ein Geschäftsobjekt, das mit dem Status Tabelle. Unsere heißt Mitarbeiter (Status). Wir bringen die Icon Spalte aus dem Status Tabelle zur Verwendung.
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 Listensteuerelementtyp mit Status (Liste) StatusID Und Status um die Optionen anzuzeigen.

Die Verwendung einer Spalte ist fast immer einer IIF-Anweisung überlegen, da eine IIF-Anweisung erfordert, dass Sie eine neue Logik implementieren, wenn Sie einen neuen Status berücksichtigen müssen. Wenn Sie jedoch eine Spalte in einer Statustabelle haben, können Sie einem Benutzer erlauben, die verwendeten Symbole zu konfigurieren.

Bildrelative URL GUID

Der IIF Anweisung, die verwendet wird, um anzugeben, welches Symbol angezeigt werden soll, kann auf die relative URL GUID des Bilds verweisen. Um den GUID-Wert des Bilds zu erhalten, sehen Sie sich das Bild in App Builder und kopieren Sie den Wert aus dem Feld Relative URL, das nach .../image/ Dieser Wert kann nun in der IIF Aussage entsprechend.

Beispiel für eine relative URL GUID eines Bildes

Beispiel einer IIF-Anweisung mit Verweis auf die relative URL GUID eines Bilds

Listensteuerung

Das Listensteuerelement wird normalerweise verwendet, um eine Liste von Textwerten anzuzeigen, es kann aber auch ein Bild zusammen mit dem Text oder nur das Bild selbst anzeigen. Wenn Sie das Listensteuerelement einrichten, müssen Sie einfach zu Zusätzliche Attribute gehen und die Spalte auswählen, die Ihre ImageID als Symbol-Wert speichert. Wenn Sie den Bildzweck „Symbol“ verwenden, können Sie effektiv dynamische Symbole verwenden. Da ein Entwickler die Bildbibliothek einer Anwendung erweitern kann, ist diese Methode für ein dynamisches „Symbol“ etwas robuster als die Verwendung des Symbolsteuerelements.

Um ein Listensteuerelement für dynamische Symbole zu verwenden, benötigen Sie eine Spalte zum Speichern Ihrer ImageID in der Tabelle, die die Listenwerte bereitstellt. Auf diese Weise können Sie jeden Listenwert mit einem bestimmten Bild in der Sammlung Ihrer App verknüpfen. Auf die gleiche Weise, wie Sie einen Titelwert aus einem Listenobjekt ziehen, um ihn als Text in der Liste anzuzeigen, ziehen Sie auch eine ImageID aus dem Listenobjekt, um dieses Bild neben dem Text anzuzeigen.