Java "Olá Bot Web"¶

Este tutorial o guiará pelo processo de criação de uma automação web Java simples.

Pré-requisitos¶

• Conta BotCity
• BotCity Studio SDK
• Java 11 ou superior
• Maven 3 ou superior

Baixando o WebDriver¶

Para poder trabalhar com automações web, precisamos usar o WebDriver correspondente ao navegador que está sendo utilizando na automação. Para isso, é necessário que o WebDriver do navegador escolhido esteja instalado e disponível preferencialmente em seu PATH. Se você não conseguir adicionar o WebDriver necessário ao seu PATH, poderá informar o driver path via código em seu bot.

Aqui está uma lista de navegadores suportados junto com os links para você baixar o WebDriver adequado:

Siga as instruções no site do WebDriver para instalação e configuração.

Uma vez instalado o WebDriver para o navegador a ser usado, podemos prosseguir para as próximas etapas.

Criando seu Primeiro Projeto¶

A BotCity oferece um projeto modelo que inclui todas as dependências, fornece scripts e um esqueleto de código-fonte. O modelo está disponível no Github. Basta clonar o projeto na pasta que você deseja ter o código-fonte do seu robô:

git clone https://github.com/botcity-dev/bot-java-web-template

Este modelo é um projeto Java Maven que você pode importar em qualquer IDE.

Importar no Eclipse¶

Se você estiver usando o Eclipse, basta clicar em File (arquivo) e Import (importar):

Escolha Maven → Existing Maven Projects (Maven → Projetos Maven existentes ):

Clique em Next (Avançar)

Defina o caminho do Diretório Raiz do seu projeto, pressione enter e selecione o /pom.xml:

Clique em Finish (Concluir).

Instalando as Dependências¶

Os frameworks da BotCity estão disponíveis como dependências Java no repositório Nexus.

As dependências serão instaladas automaticamente com base na configuração do pom.xml.

No pom.xml do projeto criado, você encontrará uma configuração semelhante a esta:

    <repositories>
        <repository>
            <id>nexus-botcity-public</id>
            <url>https://devtools.botcity.dev:8081/repository/botcity-public/</url>
            <releases>
                <enabled>true</enabled>
            </releases>
            <snapshots>
                <enabled>true</enabled>
            </snapshots>
        </repository>
    </repositories>

    <dependencies>
        <!-- Suas outras dependências -->

        <dependency>
            <groupId>dev.botcity</groupId>
            <artifactId>botcity-framework-core</artifactId>
            <version>1.5.0</version>
        </dependency>

        <dependency>
            <groupId>dev.botcity</groupId>
            <artifactId>maestro-sdk</artifactId>
            <version>2.0.3</version>
        </dependency>
    </dependencies>

Atualizando as Dependências do Projeto¶

Para atualizar as dependências recentemente instaladas no seu repositório local, abra o menu do projeto e selecione Maven → Update Project (atualizar projeto):

Explorando o Projeto¶

├── LICENSE
├── README.md   <- Arquivo README simples para o seu projeto
├── build.bat   <- Script Batch para gerar o pacote JAR
├── build.sh    <- Script Shell para gerar o pacote JAR
├── pom.xml     <- Arquivo com as dependências do projeto
└── src
    └── main
        └── java
            └── dev
                └── botcity
                    └── main
                        └── FirstBotWeb.java <- Aqui você vai desenvolver o código do seu robô

Configurando o Caminho do WebDriver¶

Conforme mencionado anteriormente, para poder utilizar os recursos do framework web é necessário configurar o caminho do WebDriver do navegador que estamos utilizando.

Se você não tiver o caminho do WebDriver adicionado ao seu PATH, poderá adicionar manualmente o caminho no código do bot, por meio do método setDriverPath.

...
public void action(BotExecution botExecution) {

    try {
        // Configurando para rodar no modo headless ou não
        setHeadless(false);

        // Setando navegador padrão para o Firefox
        setBrowser(Browser.FIREFOX);

        // Setando o caminho do WebDriver do Firefox
        setDriverPath("<caminho para o WebDriver>");

        // Acessando o site da BotCity
        browse("https://botcity.dev");

    } catch (Exception e) {
        e.printStackTrace();
    } finally {
        // Encerra o navegador que foi aberto
        stopBrowser();
    }
}
...

Testando seu Projeto Localmente¶

FirstBotWeb.java é um esqueleto de robô que fornece os métodos básicos.

Execute esta classe como um aplicativo Java e o site da BotCity será aberto em uma nova instância do navegador que foi configurado.

Aqui está uma captura de tela do resultado esperado:

Conclusão¶

Neste tutorial você aprendeu:

• As dependências necessárias para desenvolver automações usando o framework Web Java da BotCity e como instalá-las.

• Como criar novos projetos de WebBot usando o modelo da BotCity.

• Como instalar e executar seu novo projeto localmente.

Divirta-se automatizando 🤖

Próximos Passos¶

Agora é hora de carregar seu projeto com o BotCity Studio e começar a criar suas automações com Visão Computacional e toda a produtividade que nossa ferramenta oferece.