Tipos de entrada - Elementos UI

Os elementos da interface do usuário (IU) são os controles de entrada usados para receber entradas em uma ação enquanto se constrói um bot.

Os exemplos a seguir mostram os tipos de entrada suportados. Use os elementos de interface de usuário (IU) para criar projetos de interface de usuário (UI) para construir a interface da Control Room. Por exemplo, se você precisar de uma entrada como texto, então use TEXT, se você precisar de um botão de rádio, selecione RADIO, e assim por diante. Este tópico é baseado na amostra SampleUI disponível dentro do Pacote SDK no seguinte local: <PackageSDK>\src\main\java\com\automationanywhere\botcommand\samples\commands\ui\SampleUI.java.

  1. Você deverá ter importado os seguintes pacotes para garantir que todas as funcionalidades operem conforme descrito no exemplo.
    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. Adicione a anotação @BotCommand para tornar uma classe em uma Ação na Sala de Controle. Para mais informações sobre as anotações, consulte Anotações.
    @BotCommand
  3. Adicione a anotação @CommandPkg para definir todos os componentes relacionados com a IU - rótulos, descrição e nome.
    @CommandPkg(label = "UI Demo", description = "Demonstrates the provided UI elements", name = "uiDemo")
  4. Crie uma classe e defina os campos conforme descrito abaixo.
    1. Anote o método com @Execute para executar o método durante a compilação.
    2. Nesta mostra, @Idx e @Pkg são usados como membro da classe, portanto você deve usar os métodos set and get para defini-lo.
      1. @Idx - Define o índice de uma ação.
      2. @Pkg - Define todos os parâmetros e variáveis de membros mostrados na interface. Deve ser acompanhado por @Idx, do contrário esta anotação é ignorada.
      3. @Inject - Para receber valor da IU utilizando a classe dos membros, @Inject é obrigatório no nível do 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. Arraste a ação para a tela e você será capaz de inserir um string no campo de texto. Você verá uma caixa de entrada semelhante a esta imagem.

    A imagem mostra o texto do elemento UI SDK Demo

Elemento UI - Campo numérico

Use o tipo Número para criar um elemento UI que aceite um número. Usando a amostra abaixo, você poderá criar um campo que aceitará apenas 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; 
    }
}
Outros elementos da UI

É possível criar outros componentes da IU como: Booliano, Botão de rádio, Número, Variável, Código, Dicionário, Lista, Data/Hora, e assim por diante. Para obter uma lista completa de elementos de IU suportados, consulte <PackageSDK>\src\main\java\com\automationanywhere\botcommand\samples\commands\ui\SampleUI.java.

Validações UI suportadas
As seguintes validações da IU também são suportadas:
  • @NotEmpty significa que o campo UI precisa de uma entrada no momento da criação do bot.
  • @ LocalFile refere-se a um arquivo local de uma máquina do usuário.
  • @NumberIntegers refere-se a um valor numérico que você pode fornecer, como, por exemplo, um flutuador ou um tipo de entrada dupla.