Eingabetypen – UI-Elemente

Die Elemente der Nutzeroberfläche (UI) sind die Eingabesteuerelemente, die verwendet werden, um während der Erstellung eines Bots Eingaben in einer Aktion zu erhalten.

Die folgenden Beispiele zeigen die unterstützten Eingabetypen. Erstellen Sie mit den UI-Elementen Entwürfe für die Nutzeroberfläche (UI) und schließlich die Control Room-Schnittstellen. Wenn Sie z. B. eine Texteingabe benötigen, verwenden Sie TEXT, wenn Sie ein Optionsfeld benötigen, wählen Sie RADIO usw. Dieses Thema basiert auf dem Beispiel SampleUI, das im Paket-SDK an der folgenden Stelle verfügbar ist: <PackageSDK>\src\main\java\com\automationanywhere\botcommand\samples\commands\ui\SampleUI.java.

  1. Vergewissern Sie sich, dass Sie die folgenden Pakete importiert haben, damit alle Funktionen wie im Beispiel beschrieben funktionieren.
    import com.automationanywhere.commandsdk.annotations.Idx;
    import com.automationanywhere.commandsdk.annotations.Pkg;
    import com.automationanywhere.commandsdk.annotations.rules.CodeType;
    import com.automationanywhere.commandsdk.annotations.rules.VariableType;
  2. Fügen Sie die Anmerkung @BotCommand hinzu, um eine Klasse als Aktion im Control Room zu erstellen. Weitere Informationen zu Anmerkungen finden Sie unter Anmerkungen.
    @BotCommand
  3. Fügen Sie die Anmerkung @CommandPkg hinzu, um alle UI-bezogenen Komponenten zu definieren: labels, description und name.
    @CommandPkg(label = "UI Demo", description = "Demonstrates the provided UI elements", name = "uiDemo")
  4. Erstellen Sie eine Klasse und definieren Sie die Felder wie unten beschrieben.
    1. Versehen Sie die Methode mit der Anmerkung @Execute, um die Methode während der Kompilierung auszuführen.
    2. In diesem Beispiel werden @Idx und @Pkg als Mitglied der Klasse verwendet, daher sollten Sie set- und get-Methoden verwenden, um sie zu definieren.
      1. @Idx – Definiert den Index einer Aktion.
      2. @Pkg – Definiert alle Parameter und Mitgliedsvariablen, die in der Schnittstelle angezeigt werden. Muss von @Idx begleitet werden, andernfalls wird diese Anmerkung ignoriert.
      3. @Inject – Um unter Verwendung der Mitgliedsklasse Werte von der Nutzeroberfläche zu erhalten, ist @Inject auf Feldebene erforderlich.
        @BotCommand
        @CommandPkg(label = "UI Demo", description = "Demonstrates the provided UI elements", name = "uiDemo")
        public class SampleUI {
                @Idx(index = "1", type = TEXT)
                @Pkg(label = "Text type")
                @Inject
                String text;
        
            @Execute
            public String getText() {
                return text; 
            } 
            public void setText(String text)  {
                this.text = text; 
            }
        }
  5. Ziehen Sie die Aktion auf die Leinwand. Anschließend können Sie eine Zeichenfolge in das Textfeld eingeben. Es wird ein Eingabefeld ähnlich wie hier abgebildet geöffnet.

    Das Bild zeigt den Text des UI-Elements „SDK-Demo“ an.

UI-Element – Zahlenfeld

Erstellen Sie mit dem Typ Ziffer ein UI-Element, das eine Zahl akzeptiert. Anhand des folgenden Beispiels können Sie ein Feld erstellen, das nur Zahlen akzeptiert.

@BotCommand
@CommandPkg(label = "UI Demo", description = "Demonstrates the provided UI elements", name = "uiDemo")
public class SampleUI {
        @Idx(index = "2", type = NUMBER)
        @Pkg(label = "Number type")
        @Inject
        String num;

    @Execute
    public String getNum() {
        return num; 
    } 
    public void setNum(String num)  {
        this.num = num; 
    }
}
Andere UI-Elemente

Es ist möglich, andere UI-Komponenten zu erstellen, etwa: Boolescher Wert, Optionsfeld, Ziffer, Variable, Code, Wörterbuch, Liste, Datum/Zeit usw. Eine vollständige Liste der unterstützten UI-Elemente finden Sie unter <PackageSDK>\src\main\java\com\automationanywhere\botcommand\samples\commands\ui\SampleUI.java.

Unterstützte UI-Validierungen
Die folgenden UI-Validierungen werden ebenfalls unterstützt:
  • @NotEmpty bedeutet, dass das UI-Feld zum Zeitpunkt des Bot-Designs eine Eingabe erfordert.
  • @LocalFile bezieht sich auf eine lokale Datei auf einem Nutzerrechner.
  • @NumberIntegers bezieht sich auf einen Zahlenwert, den Sie bereitstellen können, z. B. einen Float- oder Double-Eingabetyp.