Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/morgannadev/automacao_web_orangehrm
Automação web que realiza cadastro de pessoas no sistema OrangeHRM com informações de uma fila de itens em lote.
https://github.com/morgannadev/automacao_web_orangehrm
Last synced: 13 days ago
JSON representation
Automação web que realiza cadastro de pessoas no sistema OrangeHRM com informações de uma fila de itens em lote.
- Host: GitHub
- URL: https://github.com/morgannadev/automacao_web_orangehrm
- Owner: morgannadev
- License: mit
- Created: 2024-09-17T16:47:21.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-09-17T17:39:02.000Z (4 months ago)
- Last Synced: 2024-11-01T15:44:15.169Z (2 months ago)
- Language: Python
- Size: 3.3 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Descrição do projeto
Neste projeto, vamos criar uma automação RPA com Python e utilizando as ferramentas da BotCity que realizará consulta de meetups de comunidades no site meetup.com de acordo com alguns parâmetros, como tecnologia, distância e local.
# Preparar o ambiente
Para executar este projeto, você deverá fazer a etapa de [pré-requisitos desta documentação](https://documentation.botcity.dev/pt/getting-started/prerequisites/), que basicamente são os itens abaixo.
## Pré-requisitos:
- [Conta BotCity](https://developers.botcity.dev/app/signup);
- [BotCity Studio SDK](https://documentation.botcity.dev/pt/getting-started/botcity-studio-sdk/);
- [Python 3.7 ou superior](https://www.python.org/downloads/);
- [Java 11 ou superior](https://www.oracle.com/java/technologies/downloads/);
- Ter uma IDE instalada, por exemplo: [Visual Studio Code](https://code.visualstudio.com/download) ou [PyCharm](https://www.jetbrains.com/pycharm/download/).
Ao instalar o BotCity Studio SDK, caso aconteça algum problema, você pode usar a ferramenta de diagnóstico para validar o que pode ter acontecido. Para acessar essa ferramenta, verifique [este link](https://documentation.botcity.dev/pt/getting-started/botcity-studio-sdk/#ferramenta-de-diagnostico) da documentação.
# Antes de executar
Atenção aos passos que deverá seguir obrigatoriamente após fazer o fork e clone do projeto em seu computador.
## 01. Crie ambiente virtual (opcional)
Você pode utilizar ambiente virtual com o Python, se preferir. E para criá-lo, execute o seguinte comando:
```
python -m venv venv
```
Após a criação, é necessário ativá-lo. Para isso, execute o comando abaixo:
```
venv\Scripts\activate
```
## 02. Instale as dependências do `requirements.txt`
Para fazer a instalação das dependências do projeto, você deve executar no terminal da sua IDE o comando abaixo, a partir da pasta do projeto:
```
pip install --upgrade -r requirements.txt
```
## 03. Valide permissionamento
Para executar no seu computador ou máquina virtual, garanta que você tem permissão para rodar scripts, códigos etc.
## 04. Criar as credenciais
No código, fazemos o login no site do OrangeHRM com as credenciais salvas com segurança pelo Orquestrador. Para fazer essa configuração, siga [o passo a passo da documentação](https://documentation.botcity.dev/pt/maestro/features/credentials/).
## 05. Crie o Datapool
Dentro da pasta `resources`, tem um arquivo csv de exemplo que você pode utilizar no datapool. Para criar e configurar essa fila de execução (datapool), siga [o passo a passo da documentação](https://documentation.botcity.dev/pt/maestro/features/datapool/).
# Para executar local
Se você quiser testar primeiramente no seu computador ou máquina virtual, você deverá:
## 01. Adicione a chamada de login no Orquestrador
Como você irá utilizar a parte de buscar as credenciais no Orquestrador, será necessário adicionar o seguinte código para o login:
```
maestro.login(
server="https://developers.botcity.dev",
login="",
key=""
)
```
Siga [essa parte da documentação](https://documentation.botcity.dev/pt/maestro/maestro-sdk/setup/#utilizando-as-informacoes-do-workspace) para verificar como saber as informações de login e key.
## 02. Execute o robô
Você pode executar clicando no botão de play ou de execução da sua IDE favorita, ou ainda executar o comando abaixo no seu terminal:
```
python bot.py
```
# Para executar no BotCity Orquestrador
Quando estamos executando o robô no Orquestrador, podemos retirar o código do item anterior. Lembre-se de seguir as orientações da [documentação](https://documentation.botcity.dev/pt/tutorials/orchestrating-your-automation/) para fazer o deploy da sua automação no Orquestrador e executar com apoio do Runner.
# Próximos passos
Há diversas possibilidades de melhorias neste projeto e deixo à disponibilidade da comunidade para explorarmos essas melhorias e implementarmos. Algumas sugestões:
- Verificar se há necessidade de refatorar o código;
- Criar notificação por alertas ou outros meios para avisar do cadastro feito;
- Entre outros.
Fiquem à vontade de mandar sugestões e correções pelas issues do projeto.