Tipos de entrada: elementos de la interfaz de usuario

Los elementos de la interfaz de usuario (UI) corresponden a los controles de entrada que se usan para recibir entradas en una acción mientras se crea un bot.

Los siguientes ejemplos muestran los tipos compatibles de entrada. Utilice los elementos de la UI para crear diseños de interfaz de usuario (UI) con el fin de crear las interfaces de Control Room. Por ejemplo, si necesita una entrada como texto, utilice TEXT, si necesita un botón de opción, seleccione RADIO, etc. Este tema se basa en la muestra de SampleUI disponible en el Paquete SDK en la siguiente ubicación: <PackageSDK>\src\main\java\com\automationanywhere\botcommand\samples\commands\ui\SampleUI.java.

  1. Asegúrese de que importó los siguientes paquetes para garantizar que todas las funcionalidades funcionan como se describe en el ejemplo.
    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. Agregue la anotación @BotCommand para hacer una clase como una Acción en Control Room. Para obtener más información sobre anotaciones, consulte Anotaciones.
    @BotCommand
  3. Agregue la anotación @CommandPkg para definir todos los componentes relacionados con la interfaz de usuario: etiquetas, descripción y nombre.
    @CommandPkg(label = "UI Demo", description = "Demonstrates the provided UI elements", name = "uiDemo")
  4. Cree una clase y defina los campos como se describe a continuación.
    1. Anote el método con @Execute para ejecutar el método durante la compilación.
    2. En este ejemplo, se utilizan @Idx y @Pkg como miembros de la clase, por lo que debe utilizar set y los método get para definirlos.
      1. @Idx: Define el índice de una acción.
      2. @Pkg: Define todos los parámetros y variables de miembro que se muestran en la interfaz. Debe ir acompañado de la etiqueta @Idx, si no es así, se ignora esta anotación.
      3. @Inject: Para recibir el valor de la UI utilizando la clase miembro, se necesita @Inject en los niveles de campo.
        @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. Arrastre la acción al lienzo y podrá ingresar una cadena en el campo de texto. Verá un cuadro de entrada similar a esta imagen.

    La imagen muestra SDK Demo del texto del elemento de la interfaz de usuario

Elemento de interfaz de usuario: campo Número

Utilice el tipo de Número para crear un elemento de interfaz de usuario que acepte un número. Utilizando el siguiente ejemplo, podrá crear un campo que solo acepte números.

@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; 
    }
}
Otros elementos de la interfaz de usuario

Es posible crear otros componentes de la interfaz de usuario como: Booleano, Radiobutton, Número, Variable, Código, Diccionario, Lista, Fecha/Hora, etc. Para obtener una lista completa de los elementos compatibles de la interfaz de usuario, consulte <PackageSDK>\src\main\java\com\automationanywhere\botcommand\samples\commands\ui\SampleUI.java.

Validaciones compatibles de la interfaz de usuario
También son compatibles las siguientes validaciones de la interfaz de usuario:
  • @NotEmpty significa que el campo UI necesita una entrada en el momento de diseño del bot.
  • @LocalFile se refiere a un archivo local de una computadora de usuario.
  • @NumberIntegers se refiere a un valor numérico que el usuario puede proporcionar, por ejemplo, un tipo de entrada flotante o doble.