Zum Inhalt springen

Vom Benutzer wählbarer Wert für Listenobjekte im Jitterbit App Builder

Anwendungsfall

In App Builder Wir können ein Datenobjekt für ein Listenfeld-Steuerelement auf einer Anwendungsseite definieren. Designer fügen diesen Datenobjekten häufig Kriterien hinzu, damit Benutzer zum Zeitpunkt der Verwendung nur aktive Datensätze auswählen. Die Herausforderung besteht darin, dass GUIDs im Laufe der Zeit häufig auf Anwendungsseiten angezeigt werden, wenn Datensätze inaktiv werden.

Der vom Benutzer wählbare Wert kann für die Verwendung in konfiguriert werden. App Builder ist kompatibel mit Listenobjekten, Radio- und Button-Gruppensteuerelementen. Mit dieser Funktion können Benutzer Informationen dazu auf der Ebene der Bedienfeldsteuerung und optional auf der Ebene des Geschäftsobjekts konfigurieren. Bei der Konfiguration auf der Ebene der Bedienfeldsteuerung (was App Builder beim Ausführen der Seite betrachtet) für ein bestimmtes Objekt führt dazu, dass nur aktive Datenzeilen zur Auswahl angezeigt werden.

Übersicht

Das zugrunde liegende Problem besteht darin, dass durch Anwenden eines aktiven Filters als Teil der Auswahlkriterien für Geschäftsobjekte die Daten für Listenwerte, die auf inaktive Datenzeilen verweisen, nicht verfügbar sind. Um dieses Problem zu lösen, muss der aktive Filter aus den Auswahlkriterien für Geschäftsobjekte entfernt und innerhalb der Listensteuerung angewendet werden. Mit diesem neuen benutzerwählbaren Ansatz hat der Benutzer beim Anzeigen von Daten Zugriff auf alle aktiven und inaktiven Datenzeilen. Wenn der Listenwert im Bearbeitungsmodus geöffnet ist, werden in der Liste nur aktive Datenzeilen zur Auswahl angezeigt.

So konfigurieren Sie

In diesem Beispiel wird Schritt für Schritt die Erstellung einer benutzerdefinierten Auswahl für ein Listenobjekt beschrieben. Die Funktion wird auch von Radio- und Buttongruppen-Steuerelementen unterstützt.

Damit die benutzerdefinierte Auswahlfunktion ordnungsgemäß funktioniert, muss sie in den Edge-Case-Einstellungen eines Bedienfelds konfiguriert werden. Das Listensteuerelement verfügt über ein neues Edge-Case-Feld namens Benutzerdefinierte Auswahl im Steuerelementsatz „Lookup (Filteroptionen)“. In diesem Feld können Sie eine Boolesche Spalte aus Ihrem Datenobjekt festlegen, die die aktive Indikatorspalte ist. Wenn das Listensteuerelement in einen Bearbeitungszustand wechselt, werden alle zurückgegebenen Zeilen, bei denen diese benutzerdefinierte Auswahlspalte als „false“ ausgewertet wird, aus der Auswahlliste ausgeschlossen. Siehe Abbildung 1.

  1. Navigieren Sie zur Anwendungsseite, die ein Listenobjekt enthält, das Sie ändern möchten.
  2. Gehen Sie zu Action Drawer > Diese Seite gestalten
  3. Wählen Sie das Panel mit dem Listensteuerelement aus.
  4. Klicken Sie auf das Popup-Symbol für das Listensteuerelement.
  5. Klicken Sie auf die Schaltfläche Edge Case Settings
  6. Legen Sie im Feld User Selectable aus dem Set Lookup (Filter Options) die Spalte fest, die Sie als aktiven Indikator angeben möchten. Beispiel: ReportsTo
  7. Klicken Sie auf Save

Abbildung 1

Um eine schnelle Entwicklung zu unterstützen, wurde dem Spalten-Popup des Geschäftsobjekts ein neuer Verwendungstyp hinzugefügt. Dieser Verwendungstyp trägt den passenden Namen Vom Benutzer wählbar. Sie können eine Spalte in Ihrem Geschäftsobjekt mit dem Verwendungstyp „Vom Benutzer wählbar“ kennzeichnen. Wenn dies geschehen ist und ein Listensteuerelement zu einem Panel hinzugefügt wird, das auf dieses Geschäftsobjekt verweist, wird der Wert „Vom Benutzer wählbare Randfalleinstellung“ für das Listensteuerelement automatisch mit diesem Spaltennamen ausgefüllt. Dieser ausgefüllte Wert auf der Panel-Steuerungsebene kann bei Bedarf manuell entfernt oder in einen anderen Wert geändert werden.

Hinweis

Die Konfiguration von „Benutzerwählbar“ am Geschäftsobjekt ist optional und wird, wenn konfiguriert, als „Hinweis“ verwendet, um ein beliebiges Panel bereitzustellen, das dann eine Listensuchquelle enthält. Siehe Abbildung 2.

  1. Navigieren Sie zur Geschäftslogikebene, zu einem Geschäftsobjekt, das Sie ändern möchten.
  2. Navigieren Sie zum SQL-Zahnradsymbol für das Geschäftsobjekt.
  3. Suchen Sie die Spalte, die Sie als „Benutzerwählbar“-Wert konfigurieren möchten.
  4. Klicken Sie auf das entsprechende Popup-Symbol für die identifizierte Spalte.
  5. Wählen Sie „Benutzerwählbar“ als Verwendungstypwert für „Erweitert (PK- und Bindungsoptionen)“ aus.
  6. Klicken Sie auf „Speichern“

Abbildung 2

Konfigurationsbeispiel

In diesem Beispiel zeigen wir Ihnen Schritt für Schritt, wie Sie die Anzeige von Kategorien in einer Liste deaktivieren, die beim Erstellen eines neuen Produkts als Inaktiv markiert sind.

  1. Gehen Sie zunächst zur Aktionsleiste > Diese Seite gestalten und klicken Sie auf das Popup-Symbol, um die Listensteuerung zu öffnen, die Sie konfigurieren möchten.

    1

  2. Klicken Sie auf den Namen des Listenobjekts im Bereich Eigenschaften der Nachschlagetabelle, um ihn zu bearbeiten.

    2

  3. In diesem Schritt können Sie eine Boolesche Spalte erstellen oder ändern, um den Status darzustellen. In unserem Beispiel hier fügen wir „Aktiv“ hinzu.

    4

  4. Klicken Sie auf das Popup-Symbol „Spalte“ und wählen Sie „Vom Benutzer wählbar“ als Wert für Verwendungstyp.

    5

  5. Navigieren Sie zurück zum Control Designer für das Listen-Control und klicken Sie im Features-Bereich auf „Edge Case Settings

    3

  6. Setzen Sie den Vom Benutzer wählbaren Wert auf die Spalte, die den Status angibt. In unserem Beispiel ist dies die Spalte „Aktiv“.

    6

  7. Navigieren Sie zurück zur Anwendungsansicht und testen Sie. In diesem Beispiel sehen Sie nun, dass die beiden nicht aktiven Kategorien (Alternative Fleischsorten und Puddings) beim Bearbeiten oder Erstellen eines Produkts nicht mehr als Optionen in der Liste angezeigt werden.

    7