Central de ajuda do SRS Cloud

Conteúdo

INTRODUÇÃO SRS

O Smart Robotics System (SRS) tem como objetivo facilitar o controle e a administração de projetos automatizados pela área de negócio. Através dele é possível monitorar, cadastrar novos processos e acessar relatórios de todas as execuções e suas atividades.

As principais características:

  • Monitorar o ciclo de vida do robô
  • Visualizar os logs de execução dos robôs
  • Visualizar os logs de fila
  • Auxiliar na identificação de falhas
  • Auxiliar na análise do desempenho dos robôs

CONCEITOS E DEFINIÇÕES

Workflow / Tarefa / Parâmetro

Workflow

Nosso Workflow possui uma sequência pré definida e coordenada das atividades, que são executadas de forma organizada para atingir um objetivo específico. Contendo representações gráficas e descritivas de como um conjunto de ações estão sendo realizadas.

 

Eles desempenham um papel fundamental que seguem uma determinada ordem para alcançar o resultado, garantido que as atividades sejam realizadas de maneira eficiente e controlada.  

  • Sequência Lógica: As tarefas podem ser dispostas em uma ordem lógica, com cada uma dependendo da conclusão da anterior ou serem acionadas conforme a necessidade do usuário.
  • Responsabilidades: Indica quem é responsável por criar ou realizar manutenção em cada tarefa no processo.
  • Regras e Regulamentos: Pode incluir regras, políticas ou regulamentos que devem ser seguidos durante a execução do workflow.
  • Controles de Qualidade: Pode definir critérios de qualidade ou verificações para garantir a execução correta.
  • Prazos e Temporalidade: Pode especificar prazos agendados para a iniciação das atividades individuais e para o workflow como um todo.
  • Integrações e Interações: Considera como as atividades se relacionam com outras partes do processo ou sistemas externos.
  • Objetivo Final: Define claramente o resultado ou objetivo que deve ser alcançado ao final do workflow.
 

Tarefa

As tarefas são atividades específicas que compõem um Workflow. Essas atividades podem incluir inserção de dados, criação de relatórios de despesas, aprovação de propostas, desenvolvimento de um código de programação, realização de apresentações, envio de e-mails de acompanhamento, entre muitas outras ações realizadas tanto em ambientes pessoais quanto profissionais. O gerenciamento eficaz de tarefas é fundamental para alcançar objetivos, concluir projetos com sucesso e manter a alta produtividade.

Veja mais em Cadastro Tarefas

Parâmetro

Os parâmetros são configurações ou informações específicas que são necessárias para a execução de um workflow (ou processo de automação de tarefas) em um sistema. Eles podem incluir informações como datas, horários, usuários, credenciais, campos de filtro, opções de visualização, entre outros.

Além disso, os parâmetros também podem ser utilizados para personalizar a forma como o workflow se comporta, como por exemplo, quais informações são exibidas em uma interface de usuário.

Em alguns sistemas de workflow, um “parâmetro de portal” pode se referir a informações ou dados específicos que são fornecidos como entrada em um processo de workflow.

Fila /Execução

Fila

A definição de filas refere-se a uma estrutura em que tarefas precisam ser executadas, onde podem ser priorizadas, realocadas e removidas.

Listamos algumas principais definições:

  • Armazenamento Ordenado: As filas armazenam tarefas ou trabalhos em uma ordem específica, geralmente em uma estrutura do tipo “primeiro a entrar, primeiro a sair” (FIFO) ou com base em prioridades atribuídas.
  • Priorização (Opcional): Em algumas situações, os itens podem ser priorizados na fila com base em critérios específicos, como urgência, importância ou outras métricas relevantes.
  • Controle de Fluxo: Filas de tarefas são frequentemente usadas para controlar o fluxo de trabalho e garantir que as tarefas sejam executadas de maneira ordenada e eficiente.
  • Monitoramento: Monitoramento com o status e logs, identificar e acompanhar sua performance.
  • Escalonamento: As tarefas podem ser escalonadas para agentes humanos quando necessário.
  • Eficiência: O uso de filas de tarefas ajuda a otimizar o uso de recursos, garantindo que as tarefas sejam realizadas de maneira ordenada e que nenhum trabalho seja perdido ou esquecido.

Execução

Nossos status de execução de filas consistem nas seguintes categorias:

  • Encerrada com sucesso: Foi executada com sucesso e todas as etapas planejadas foram concluídas. 
  • Encerrada com falha: O processamento encontrou um erro ou problema que impediu a conclusão bem-sucedida. Os erros são registrados e podem exigir intervenção para resolução. 
  • Execução cancelada: Neste caso pode ser cancelada antes ou durante a execução. Isso geralmente ocorre quando não é mais necessária ou é duplicada.
  • Início Execução: Está aguardando processamento.

Agendamento / Execução Manual

O agendamento de tarefas é o processo de programar a execução automática de atividades dentro de um fluxo de trabalho, em momentos específicos ou conforme um cronograma predefinido. Isso permite definir o momento exato para o início de uma tarefa, seja em um horário específico do dia, em uma data futura, ou em intervalos regulares.

As tarefas podem ser agendadas para execução repetida em um cronograma fixo, como diariamente, semanalmente ou mensalmente, o que é particularmente útil para atividades recorrentes, como a geração de relatórios.

Essa funcionalidade permite eliminar a necessidade de intervenção manual para iniciar tarefas, economizando tempo e reduzindo erros humanos. Além disso, as tarefas agendadas podem ser monitoradas, e há a possibilidade de ajustar ou interromper essas tarefas conforme necessário.

Sistema / Credencial

Sistema

Um sistema de workflows permite que as organizações automatizem tarefas, com base em regras predefinidas pelo usuário. Incluem recursos de gestão de documentos para rastrear e gerenciar documentos e informações de acessos relacionados aos processos.

Para garantir a segurança que permite definir quem pode acessar, visualizar e modificar informações e processos.

Credencial

A definição de credencial refere-se à especificação das informações de autenticação e autorização necessárias para acessar sistemas, workflows e os demais recursos que são parte integrante. As credenciais são essenciais para garantir que o workflow possa acessar e interagir com sistemas externos de forma segura e confiável

Alguns dos passos para a definição de credencias em workflows são:

  • Identifique os Requisitos de Acesso: Determine quais sistemas, aplicativos ou recursos externos o workflow precisa acessar, como bancos de dados, APIs, sistemas de e-mail, servidores, entre outros.
  • Defina os Tipos de Credenciais Necessárias: Identifique os tipos de credenciais necessárias para cada sistema ou recurso, incluindo nomes de usuário, senhas, tokens de autenticação, chaves de API ou outras informações de autenticação.
  • Integre as Credenciais no Workflow: Durante a configuração do workflow, integre as credenciais necessárias por meio de parâmetros ou variáveis, garantindo que sejam armazenadas de forma segura e criptografada.
  • Defina Controles de Acesso: Implemente controles de acesso apropriados para limitar quem pode visualizar ou modificar as informações de autenticação.
  • Implemente Políticas de Rotação de Credenciais: Estabeleça políticas de rotação regular de senhas e outras credenciais, definindo prazos de validade para garantir que sejam atualizadas periodicamente e permaneçam seguras.
  • Monitoramento e Auditoria das Credenciais: Contém procedimentos de monitoramento e auditoria para acompanhar o uso das credenciais e relatar atividades suspeitas.
  • Mantenha-se Atualizado: Atualize as credenciais no sistema de gerenciamento conforme necessário ou ative a renovação automática de senhas à medida que expiram ou mudam.

Usuários / Perfis

Usuários

A definição de usuários é crucial para atribuir funções e permissões adequadas, garantindo que cada pessoa ou grupo tenha acesso e controle apropriados em processos automatizados. Os passos incluem identificação de usuários, mapeamento de funções, atribuição de permissões, configuração de acesso seguro, personalização de fluxos e monitoramento.

Perfis

Monitorar perfis nos sistemas de workflows é essencial para garantir que o acesso e as permissões permaneçam alinhados com as políticas de segurança e as necessidades da organização. Contém um controle centralizado no Perfil “Admin” que permite gerenciar todos os perfis de usuário. Isso inclui a capacidade de adicionar, modificar ou remover perfis conforme necessário.

Podendo revisar as permissões concedidas a cada perfil para garantir que elas permaneçam relevantes ou remover qualquer acesso desnecessário. Acompanhe o acesso de cada perfil, incluindo quais áreas do sistema eles podem acessar e quais ações podem executar. Isso ajuda a identificar qualquer acesso não autorizado.

É possível realizar auditorias regulares dos perfis para garantir que as permissões estejam alinhadas com as políticas e as necessidades da organização.

 

FUNÇÕES DE ACESSO

Acesso

O acesso ao SRS se dá através da página de login https://srscloud.com.br/ Clicando no botão “Entrar” para realizar o acesso.

Siga as seguintes etapas:

1- Preencha os campos com os dados solicitados.

2- Conclua, clicando em “Enviar”.

Cadastramento de Primeiro Acesso

Para efetuar o cadastro, clique no botão “Cadastre-se” e preencha os campos com seu nome, sobrenome, endereço de e-mail, domínio da empresa e, em seguida, clique em “Enviar”.

Ao enviar, uma mensagem automática aparecerá na tela com o seguinte texto:

“Muito obrigado pelo cadastro, você receberá um e-mail com as instruções para os próximos passos.”

O e-mail indicado é o mesmo cadastrado pelo usuário.

Acesse o correio eletrônico indicado e verifique o e-mail recebido do srscloud@automatebrasil.com.br para seguir com orientações recebidas.

Com seu nome de usuário e senha, você poderá usar o aplicativo SRS. Basta fazer login e seguir as instruções subsequentes.

No primeiro acesso a troca de senha será obrigatória. Portanto nos campos destacados abaixo preencha com a senha atual (fornecida no e-mail) e nos campos “Nova senha” preencha com uma senha segura e repita a mesma senha no campo “Confirmação” em seguida clique em “Trocar senha”.

Ao enviar, uma mensagem automática aparecerá na tela com o seguinte texto: “Senha atualizada com sucesso.”

Redefinir Senha

Para realizar a recuperação de login e senha clicando no campo “Esqueci minha senha”.

No campo destacado preencher com o e-mail e clicar em “Redefinir sua senha”;

Acesso expirado

O tempo de acesso quando expira apresenta uma mensagem na tela de login já com as instruções dos próximos passos para ter a liberação novamente. 

Acesso ao perfil

Na aba de Perfil é possível realizar alterações nas informações pessoais, cadastrar Empresa, realizar downloads, pesquisas de dúvidas e sair do sistema. 

No campo “Meu Perfil”, você pode selecionar a imagem do seu avatar, editar seu nome, sobrenome e e-mail, além de gerar um token de acesso.

No campo “Empresa”, é possível inserir informações da empresa, como Razão Social, Nome Fantasia, CNPJ, Endereço e site.

No campo “Licença”, você pode gerenciar a licença do SRS Cloud, onde encontrará informações sobre o ambiente, data de cadastro e vencimento da licença, dias restantes até a expiração, quantidade de usuários no portal e bots em execução, status dos usuários ativos na plataforma e máquinas ativas, além de poder monitorar seus créditos para uso do Raas.

NAVEGAÇÃO MENU HOME PAGE

A Home Page apresenta o Menu lateral à esquerda, painel principal no centro.

No painel principal, são exibidas as principais atividades:

CampoDescrição
Itens na filaOnde destaca a quantidade de itens na fila e a quantidade de itens que estão sendo processados.
ExecuçõesMostra número de execuções realizadas, juntamente com o número das que estão em andamento e as que apresentaram falha.
Workflows AtivosNúmero de workflows ativos
Bot SRS AtivosNúmero de Bots SRS ativos, juntamente com a informação do número de bots permitidos pela licença.
UsuáriosNúmero de usuários ativos, juntamente com a informação do número de usuários permitidos pela licença.
Itens processadosIndicador da quantidade de itens processados e o número de falhas.
Esforço humano economizadoEssa métrica indica o total de horas de trabalho que foram economizadas devido a melhorias ou automação de processos. Em outras palavras, mostra quanto tempo os funcionários deixaram de gastar em tarefas que foram automatizadas.
Crédito Micro Serviços disponívelConsumo em valores e o vencimento.
Atividades por WorkflowGráfico representando as atividades por workflow.
Tempo poupado por workflowGráfico representando o tempo poupado em minutos por workflow

Sendo possível extrair esses dados em três formatos de arquivo: SVG, PNG e CSV.

Atividades por Workflow

Tempo poupado por Workflow

Neste gráfico podemos visualizar o tempo poupado por um workflow, que nos permite analisar os processos, comparando as horas de trabalho para minutos.

MEUS WORKFLOWS

workflows

Esta página apresenta os processos disponibilizados para o usuário. Aqui é possível visualizar detalhes das execuções ou comandar a execução de processos.

Detalhe do Workflow

O detalhe do Workflow tem uma abordagem moderna e eficaz para gerenciar e otimizar os workflows, aproveitando a automação para aprimorar a eficiência, reduzir erros e tomar decisões informadas com base em dados em tempo real.

CAMPO

DESCRIÇÃO

Itens na Fila

Este recurso permite visualizar a quantidade de filas 

Processados 

O número de trabalhos com o status sucesso

Tempo economizado 

Detalha as horas trabalhadas com a jornada esperada

Falhas

Acompanhamento das filas processadas com falha

Tempo de execução

Duração do tempo de execução da máquina.

Agendamentos

Retrata quais os agendamentos que estão programados listando os agendamentos. 

Perfis com acesso

Detalha os perfis de usuários que estão cadastrados para acesso.

Sistemas utilizados

Lista os sistemas cadastrado do seu workflow

Descendo a tela, no campo “Tarefas’” podemos visualizar as tarefas que fazem parte deste Workflow, cada linha representa uma tarefa e detalha as principais informações:

Para iniciar a execução, clique no campo “Ação“, que é representado pelo botão:

Mais abaixo, no campo “Fila”, é possível visualizar as filas que estão pendentes/aguardando a execução:

Onde podemos priorizar as filas de acordo com a ordem em que devem ser concluídas:

No campo “Itens processados”, um painel é mostrado listando as tarefas ordenando as execuções que foram atendidas.

Na coluna “status” podemos visualizar as 3 opções de status de fila:

Para realocar alguma fila basta ir até a coluna “Realocar” e clicar no botão:

Que ficará novamente com o status de aguardando para ser novamente processada ou atendida:

No bloco “Histórico de Execução” podemos acompanhar os históricos das execuções.

Destacando o status de cada tarefa com:

BOTSTORE

Para acessar nossos serviços BotStore, basta clicar na opção “BotStore” no menu lateral esquerdo de nossa plataforma. Aqui, você terá acesso a uma variedade de informações essenciais para melhorar sua experiência e compreensão do nosso serviço:

Teste aqui

Realize testes para aprimorar sua compreensão do serviço e experimentá-lo de acordo com seus requisitos. Ao clicar no botão de teste, você tem a oportunidade de experimentar o serviço de forma interativa.

 Isso permite que você defina parâmetros específicos, como:

  • Período: Aqui, você pode escolher o intervalo de tempo que deseja analisar ou testar para avaliar o serviço em diferentes cenários.

  • Workflow: Selecione o fluxo de trabalho (workflow) que deseja aplicar ao teste. Isso permite que você simule diferentes processos ou caminhos que suas consultas podem seguir.

  • Tarefa: Escolha a tarefa específica que deseja testar dentro do workflow selecionado. Isso ajuda a focar em aspectos particulares do serviço que podem ser relevantes para suas necessidades.

Valor por consulta

Visualize detalhes precisos sobre o custo de cada consulta realizada, permitindo um acompanhamento transparente dos seus gastos.

Consultas realizadas

Acompanhe o número de consultas que você realizou, fornecendo insights sobre a frequência e a extensão do uso do nosso serviço.

Valor consumido

Saiba exatamente quanto você gastou em consultas, facilitando o controle financeiro e o planejamento do seu orçamento.

Histórico de consumo

Acesse um histórico completo de seu consumo, permitindo uma análise detalhada e a identificação de tendências ao longo do tempo.

Ligação assíncrona

A ligação do BotStore seguira de forma assíncrona, garantindo que os processos possam ser executados simultaneamente, sem a necessidade de aguardar a finalização de etapas anteriores. Esse modelo otimiza o fluxo de trabalho, melhora a eficiência e reduz o tempo de espera entre as interações, possibilitando maior escalabilidade e agilidade na execução das atividades.

Aqui está a demonstrção, exemplificando como será a ligação:

				
					 #### Exemplo de código 
import requests
import json

url=" https://servico.srscloud.com.br/service/teste" #Chamada do serviço


parametrosEntrada = {
'Texto': 'Teste',
'Numero': '1234',
'Json': '',
'Lista': '',
'Checkbox': '',
'Calendario': ''
}

parametrosEntrada = json.dumps(parametrosEntrada) #converte o json em texto para enviar

payload = {
    'Token': '', #Insira seu token de usuário
    'Origem': json.dumps({'NomeOrigem': 'SRS', 'Origem': 'PortalClient', 'OrigemId': 'be5b5c10-b450-4d02-9331-8fe2f33454eb'}),
    'Retorno': 1, #Se for 1 é assíncrono
    'ParametrosEntrada': parametrosEntrada
    }

response = requests.post(url, data=payload) #envio via POST
print(json.loads(response.text))
				
			
				
					url="https://servico.srscloud.com.br/service/consulta_andamento" #Chamada do serviço

payload = {
    'Token': '',#Insira seu token de usuário
    'ParametrosEntrada': json.dumps({'BotStoreId': '67407a951b86da1fc201c140'})
    }

response = requests.post(url, data=payload) #envio via POST
print(json.loads(response.text))
				
			

AGENDAMENTO

Na seção de agendamento, é possível criar novos agendamentos e monitorar os existentes. Aqui, você encontrará informações detalhadas sobre os intervalos de cada tarefa, seus horários de início e término, além de uma descrição do status que fornece as principais categorias selecionadas para a execução das atividades.

Novo Agendamento

Para realizar um agendamento siga o seguinte passo a passo:

  • Clique no botão “NOVO” localizado no canto superior direito da página para iniciar o processo de agendamento.
  • Uma nova janela será exibida, oferecendo a flexibilidade de agendar de acordo com as configurações e regras específicas de cada robô. Nessa janela, você encontrará os seguintes campos para preencher:
    • Nome: Atribua um nome significativo ao seu agendamento para facilitar a identificação e o gerenciamento.
    • Status do Agendamento: Selecione o status do agendamento, definindo se ele estará ativo ou desativado.
    • Workflow: Selecione o workflow que deseja agendar para execução automática.
    • Tarefa: Escolha a tarefa específica dentro do workflow que será executada de acordo com o agendamento.
    • Máquina: Selecione a máquina na qual a tarefa será executada.
    • Intervalo: Escolha o intervalo desejado para o agendamento, como mensal, semanal, diário ou em minutos.
    • Período: Defina a data e hora de início do agendamento, bem como a data e hora de término.

Editar agendamento

Para editar um agendamento, basta clicar no botão “Editar”, onde você pode fazer alterações e escolher se deseja ativar ou desativar o agendamento.

Lembre-se de clicar no botão “Salvar” após concluir as edições necessárias.

Após o cadastro ou edição, esses agendamentos ficam imediatamente disponíveis para uma fácil visualização.

CADASTROS

Dentro da categoria ‘Cadastros’, você encontrará  uma lista de funções de gerenciamento com base nas demandas específicas:

Workflows

Na aba “Workflows” temos as funções para “Exportar”, “Importar” e cadastrar um “Novo” Workflow.

Exportar / Importar 

Ao exportar um Workflow, ele pode ser importado em outro ambiente. Importante notar que, se o Workflow a ser importado tiver o mesmo Alias que outro Workflow já existente no ambiente de destino, a importação irá atualizar as informações do Workflow existente em vez de criar um novo.

Novo Workflow

No botão ‘Novo’, é possível criar um novo workflow, onde será exibida uma nova tela para cadastro:

Dentro dessa tela, você poderá definir uma série de características essenciais para o novo workflow:

Campo

Descrição

Nome

Nome descrição.

Alias

Serve como identificador único para cada fluxo de uma empresa, o Alias é importante para localizar rapidamente o workflow desejado.

Cor

Defina uma cor que esteja associada a esse workflow. A cor pode ajudar a diferenciar os fluxos de trabalho de forma visual.

Expurgo

Período de tempo em que os dados relacionados a este workflow ficarão disponíveis antes de serem automaticamente apagados.

Timeout

Tempo máximo de tolerância para uma requisição sem resposta, se excedido, a execução será automaticamente cancelada.

Tarefas: Aba para criação e gerenciamento de Tarefas dentro de um Workflow.

É possível criar ou editar uma Tarefa dentro do workflow nesta seção, ambas as ações, exigem as mesmas informações clicando em “Novo” ou na “Tarefa”:

Exemplo dentro da Tarefa:

Campo

Descrição

Nome

Nome descrição.

Alias

Cada tarefa deve ser associada a um Alias exclusivo para facilitar sua identificação.

Plataforma

É necessário especificar a plataforma na qual a tarefa será executada, por exemplo: ‘Automate Enterprise’.

Máquina de Execução

Você pode configurar a máquina na qual a tarefa será executada, permitindo a definição de máquinas diferentes para tipos de execução distintos, como: manual ou agendada.

Chamada do Programa Local

Esta configuração indica como a tarefa acessará o sistema. Ela consiste em acessar o caminho informado através da máquina. Por exemplo, no caso do ‘Automate’, você pode especificar o ID do workflow, enquanto em um ‘Script Python’, você definirá o endereço ou diretório do projeto.

Informações de SLA e FTE

Aqui, você pode definir as informações relacionadas ao SLA, que é o intervalo máximo de tempo entre a entrada da requisição e a sua entrega, bem como FTE, que indica o equivalente a tempo integral necessário para concluir a tarefa.

SLA e FTE (Esforço humano economizado)

  • SLA (Acordo de Nível de Serviço): refere-se ao compromisso estabelecido entre uma equipe ou empresa e seus clientes (internos ou externos) sobre o nível de serviço esperado. O SLA define metas claras para o tempo de resposta, qualidade ou quantidade de trabalho a ser entregue, entre outros parâmetros. Em resumo, envolve o tempo que uma automação leva para concluir uma tarefa ou o volume de trabalho que ela deve processar dentro de um determinado período. Exemplos de SLA no contexto de automação:
    • Tempo de resposta: A automação deve processar uma tarefa em menos de 5 minutos.
    • Volume de trabalho: O processo automatizado precisa completar 500 operações por dia.
 
  • FTE (Esforço humano economizado): indica o total de horas de trabalho que foram economizadas graças à automação de processos. Em outras palavras, mostra quanto tempo os funcionários deixaram de gastar em tarefas que foram automatizadas.

FTE = Employee_hours_saved / Total_working_hours

  • Employee_hours_saved: Representa o total de horas de trabalho economizadas devido à automação, ou seja, as horas de trabalho dos funcionários que não foram mais necessárias graças à automação de processos.
  • Total_working_hours: É o número total de horas que um funcionário em tempo integral trabalha durante o período de análise (por exemplo, em uma semana ou um mês).

Dentro da Tarefa, contém a aba “Parâmetros”, que serve na visualização e no gerenciamento de parâmetros necessários para a execução.

Na aba ‘Agendamentos’, contém os  Agendamentos vinculados a Tarefa que podem ser gerenciados e visualizados.

Sistemas e Perfis

Dentro da categoria ‘Sistemas’, cada sistema inclui informações de acesso, como: login, senha e credenciais. Além disso, você terá a possibilidade de controlar quais sistemas cada workflow pode acessar, fornecendo assim um nível de controle sobre quem pode ver as informações.

Em ‘Perfis‘, é possível configurar permissões e acesso aos workflows para cada perfil de usuário.

Dica: É importante notar que apenas o administrador tem acesso a todas as informações, enquanto os outros perfis têm acesso limitado, com base em permissões definidas pelo administrador.

Sistemas

Durante a execução de uma tarefa, pode ser necessário fornecer credenciais de login. Nesse caso, você tem a opção de criar um sistema dentro da sessão para facilitar esse processo.

Na aba “Sistemas”, você encontrará as seguintes características:

Campo

Descrição

Nome

Nome descrição.

Alias

Um Alias exclusivo que ajuda a identificar o sistema de forma única.

Acesso

Define a forma de acesso ao sistema, por exemplo, autenticação por e-mail e senha.

Interface

Especifica o tipo de interface utilizada para acessar o sistema, que pode ser um terminal, um navegador da web ou um arquivo de banco de dados, entre outros.

Caminho

Indica a URL ou diretório associado ao sistema, fornecendo informações sobre onde encontrá-lo.

Corporativo

Marcar esta opção significa que o sistema tem um responsável técnico designado, caso seja necessário suporte técnico.

Acesso Exclusivo

Quando essa opção é ativada, o sistema permite apenas um usuário por vez. Se o mesmo usuário tentar acessar o sistema de uma máquina diferente, a sessão será derrubada. Portanto, são necessários dois usuários diferentes ao acessar o sistema de máquinas distintas.

Essas configurações tornam mais fácil e seguro gerenciar o acesso aos sistemas durante a execução dos processos.

Credenciais:

As credenciais podem ter 3 tipos de situações:

Senhas:

Se a opção ‘sim’ for selecionada, a senha será exclusiva para o robô. Caso o usuário também precise dessa senha, marque ‘não’. Assim, quando a senha estiver próxima do vencimento:

Um e-mail de aviso será enviado à pessoa responsável cadastrada, solicitando a atualização.

Workflows:

Abaixo, você encontrará uma lista dos Workflows com acesso ao sistema. Você pode ativar ou desativar cada um deles com um clique no ícone correspondente: 

Usuários

Nesta seção, você pode gerenciar os usuários do sistema. Isso inclui:

Campo

Descrição 

Quantidade de usuários

Aqui, você pode verificar quantos usuários estão disponíveis no sistema e quantos estão atualmente em uso, exibidos no formato ‘X/Y’ (por exemplo, ‘9/10’). 

Cadastro de Novos Usuários

Você pode adicionar novos usuários ao sistema.

Edição de Usuários

Também é possível realizar edições nos perfis de usuários existentes, ajustando suas informações e permissões de acordo com as necessidades.

Status

Verificar quais são os usuários ativos e inativos

Perfis

Na aba  Home / Cadastro / Perfils , realiza o do controle de acesso aos sistemas.

Ao clicar em ‘Editar’ existe a possibilidade de definir permissões de duas formas:

Acesso Completo: Isso concede aos usuários acesso completo ao SRS e todos os seus Workflows. Os usuários com essa permissão têm autorização para visualizar, editar e executar todas as funcionalidades disponíveis no sistema.

Acesso Parcial: Você pode definir permissões de acesso específicas para determinados usuários ou grupos. Isso permite um controle maior, onde você pode conceder ou restringir acesso a recursos conforme necessário.

Essa flexibilidade de permissões garante que você possa ajustar o acesso de acordo com as necessidades da sua equipe, garantindo a segurança e o controle adequados sobre os recursos do sistema.

Máquinas

Nesta seção, você pode gerenciar informações relacionadas às máquinas utilizadas no sistema. Isso inclui informações de status da máquina como Ativo ou Inativo, o diretório do Bot SRS ou projeto e o status do Bot SRS como Ativo ou Inativo:

Editar Máquina: Aqui, você pode atualizar e manter detalhes sobre as máquinas em uso no sistema. Isso ajuda a garantir que as informações estejam sempre atualizadas e precisas.

Editar Tarefas e Agendamentos: É possível ativar e desativar todas as opções:

PRÉ REQUISITOS DE INSTALAÇÃO DO BOTAGENT

Para instalação do BotAgent, geralmente são necessários os seguintes requisitos:


Sistema Operacional:

  • Windows Server (versões modernas, como 2016, 2019, ou 2022) ou Windows 7 ou superiores para estações de trabalho.

 

Hardware:

  • Processador de pelo menos 2 GHz (multi-core recomendado).
  • Memória RAM: mínimo de 4 GB (8 GB ou mais é recomendável, especialmente em ambientes de produção).
  • Espaço em disco: cerca de 500 MB para a instalação inicial, mas é recomendável ter mais espaço para armazenamento de logs e arquivos temporários.

 

Rede:

  • Acesso às portas de comunicação que conectam o BotAgent ao SRS-Cloud da Automate Brasil(Portas 15672 e 5672).
  • Endereços URLs específicos permitidos no firewall para comunicação entre o BotAgent e o SRS-Cloud. São:
    • HTTPS://sauron.mq.srscloud.com.br
    • HTTPS://portal.srscloud.com.br

INSTALAÇÃO BOT AGENT

  1. Logado com seu usuário no SRS Cloud, clique no perfil do usuário para que abra a aba Meu Perfil.
  2. Com as opções apresentadas, clique em “Downloads” que irá redirecionar para a página de downloads dos principais recursos para o uso do SRS Cloud.
  3. Por fim, selecione ‘BotAgent Install’ e o download do arquivo será iniciado.

Depois de concluir o download, abra o arquivo executável e avance em todas as etapas.

Aguarde aparecer o ícone no menu oculto:

Clique com o botão direito em cima do ícone e clique em ‘Configurações’

Após preencher todas as informações acima, volte no ícone oculto e clique com o botão direito do mouse, em seguida, clique em ‘conectar’.

Aguarde alguns segundos e valide a conexão através da aba ‘Log do BotAgent’.

RELATÓRIOS

Nosso relatório de atividades fornece um resumo detalhado das ações realizadas. Esse relatório registra as atividades específicas, os responsáveis por elas, os resultados obtidos e as datas em que ocorreram, permitindo uma análise abrangente das operações e processos executados. Ele serve como um padrão para revisões e avaliações internas ou externas, garantindo a transparência, conformidade e eficiência das atividades realizadas.

Relatório de Agendamentos

Aplicação de filtros

  • No primeiro bloco, selecione uma coluna que queira comparar.
  • No segundo bloco, defina como realizar a comparação entre as duas colunas
  • No terceiro bloco,  digite a última parte da comparação.
  • Aplicar ou resetar o filtro.

Atividades

Nosso relatório de atividades detalha as horas economizadas em comparação com as horas humanas, além de destacar quais máquinas estão sendo mais utilizadas no momento. Ele também inclui gráficos que descrevem cada tarefa e seu consumo de tempo.

Nesta página é possível visualizar detalhes como:  

  • FTEs economizadas
  • Consumo de máquina
  • Atividades por tarefa  
  • Atividades por dia
  • Atividades

 

Parâmetros de pesquisa:

  • Exibição dos próximos 100 itens e dos 10 itens anteriores.
  • Filtro de colunas para comparação.
  • Exportação para arquivo Excel e para arquivo JSON.


Máquinas

Nosso relatório de máquinas tem como padrão destacar e organizar as disponibilidades das máquinas, detalhando o consumo diário ou semanal delas.

Página de monitoramento das Máquinas, é possível visualizar detalhes como:  

  • Gráfico de atividades por dia da semana
  • Consumo de máquina (em %)
  • Gráfico de atividades conforme hora do dia
  • Gráfico de disponibilidade de máquina (em %)
  • Lista de máquinas

Sistemas

O relatório dos sistemas tem como foco principal garantir a segurança, acompanhando as requisições e o status das credenciais ativas e inativas, a fim de permitir tomadas de decisão rápidas e eficazes.

Página de monitoramento dos Sistemas, é possível visualizar detalhes como:  

  • Requisições por credencial 
  • Credenciais inativas
  • Requisições por usuário
  • Requisições por tarefa
  • Lista de Sistemas

A funcionalidade “Responsáveis” oferece a capacidade de entrar em contato com as pessoas responsáveis por um sistema por meio de email e WhatsApp. Isso permite relatar quaisquer problemas, com ênfase na segurança e no registro de uso, incluindo informações sobre quem utilizou, quando e como.

Auditoria

Nos recursos de auditoria, você pode revisar e auditar todos os eventos realizados pelos usuários, monitorando suas ações em seu espaço de trabalho e compreendendo seu padrão de uso. Além disso, oferecemos opções de filtragem para simplificar a gestão da área de trabalho e dos usuários.

Página de Logs de auditoria, é possível visualizar um relatório de logs realizados:

INTEGRAÇÃO COM SRS CLOUD

A integração com o sistema do SRS Cloud requer a configuração de diversas informações para que a comunicação entre os sistemas seja bem-sucedida. Abaixo estão as configurações essenciais que devem ser definidas:

  • Máquina: Aqui, insira o nome da máquina que será usada para executar a integração. Certifique-se de que esta máquina está devidamente configurada e autorizada para acessar a API.
  • Server: Insira a URL completa da API à qual você deseja se integrar. Certifique-se de que esta URL seja precisa e esteja acessível a partir da máquina que executará a integração.
  • Token: Um token de acesso é necessário para autenticar e autorizar a máquina a interagir com a API. Certifique-se de que o token gerado seja mantido em segurança, pois ele é uma chave de acesso à API.
  • WorkflowAlias: O WorkflowAlias é um valor que identifica um workflow específico na API. Ele é usado para direcionar as solicitações e ações relacionadas a esse workflow específico.
  • TarefaAlias: O TarefaAlias é um valor que identifica uma tarefa específica dentro do workflow. Ele é usado para realizar operações relacionadas a essa tarefa específica.
				
					# Exemplo de conexão
maquina = 'Teste-VM-SRSCloud'
server = 'http://000.0.0.01:000/api/'
token = 'xxxxxxx-XXXX-XXXX-XXXXX'
workflowAlias = 'wf01'
tarefaAlias = 'ex01'

# Exemplo de requisição
url = f'{server}execucao/iniciar'
payload ={'token':token, 'workflow':workflowAlias, 'tarefa': tarefaAlias, 'nomeMaquina': maquina}
response = requests.request('POST', url, data=payload)
inicio = json.loads(response.text)
				
			

Na página “Guia Primeiros Passos”, você aprenderá o passo a passo de como realizar a integração por meio de um projeto exemplo. Este guia foi elaborado para ajudá-lo a maximizar o uso das funcionalidades do SRSCloud e a implementar integrações através da biblioteca SRSCloud_Integration.py.

Link Guia Primeiros Passos.

GUIA SRSCLOUD INTEGRATION

Segue um guia explicativo das principais funções da biblioteca. Para utilizá-las, antes é necessário abordar os principais parâmetros:

  • As variáveis workflow_unico, tarefa_unica e maquina_unica são obtidas a partir de um arquivo de configuração JSON chamado srs.json. Esse arquivo deve estar localizado no mesmo diretório do script que está sendo executado o SRSCloud_Integration.py.

Funções de Execução e Controle

1. execucaoIniciar

Objetivo: Registrar o início de uma execução de uma tarefa no portal SRS-Cloud.

Parâmetros:

    • workflow (opcional): Workflow a ser usado. Padrão é workflow_unico.
    • tarefa (opcional): Tarefa a ser usada. Padrão é tarefa_unica.
    • maquina (opcional): Máquina a ser usada. Padrão é maquina_unica.
 
Exemplo de Uso:
				
					# Python
response = execucaoIniciar()
print(response)
				
			

2. log

Objetivo: Registrar um log vinculado à execução em vigor, permitindo enviar mensagens e arquivos personalizados.

Parâmetros:

    • execucaoId: ID da execução.
    • statusId: Status da mensagem (2=mensagem de andamento, 3=alerta).
    • mensagem: Mensagem a ser registrada.
    • arquivo (opcional): Arquivo a ser enviado.
 
Exemplo de Uso:
				
					# Python
execucaoId = "Execucao_123"
statusId = 2
mensagem = "Processo em andamento"
response = log(execucaoId, statusId, mensagem)
print(response)
				
			

3. parametroAtualizar

Objetivo: Atualizar um parâmetro com permissão de alteração pelo robô.

Parâmetros:

    • parametro: Nome do parâmetro a ser atualizado.
    • valor: Novo valor do parâmetro.
    • execucaoId: ID da execução.
    • workflow (opcional): Workflow a ser usado. Padrão é workflow_unico.
    • tarefa (opcional): Tarefa a ser usada. Padrão é tarefa_unica.
 
Exemplo de Uso:
				
					# Python
parametro = "localPlanilha"
valor = "d:/nova_planilha.xlsx"
response = parametroAtualizar(parametro, valor, execucaoId)
print(response)
				
			

4. execucaoFinalizar

Objetivo: Registrar o encerramento de uma execução.

Parâmetros:

    • execucaoId: ID da execução.
    • status (opcional): Status da execução. Padrão é ok.
    • mensagem (opcional): Mensagem de encerramento. Padrão é Execução finalizada.
 
Exemplo de Uso:
				
					# Python
execucaoId = "Execucao_123"
response = execucaoFinalizar(execucaoId)
print(response)
				
			

5. credencialObter

Objetivo: Obter uma credencial de sistema.

Parâmetros:

    • execucaoId: ID da execução.
    • sistema: Nome do sistema para o qual a credencial é necessária.
 
Exemplo de Uso:
				
					# Python
execucaoId = "Execucao_123"
sistema = "SAP"
response = credencialObter(execucaoId, sistema)
print(response)
				
			

6. credencialAlterar

Objetivo: Atualizar o status, senhas e data de expiração das credenciais.

Parâmetros:

    • execucaoId: ID da execução.
    • credencialId: ID da credencial.
    • expiraEm: Nova data de expiração.
    • parametro: Parâmetro a ser alterado.
    • valorAntigo: Valor antigo do parâmetro.
    • valorNovo: Novo valor do parâmetro.
    • ativo (opcional): Status da credencial (1=ativo, 0=inativo). Padrão é 1.
 
Exemplo de Uso:
				
					# Python
execucaoId = "Execucao_123"
credencialId = "28d23acb-2739-4498-9e23-9e0decd154b9"
expiraEm = "2024-12-31"
parametro = "Senha"
valorAntigo = "senha_antiga"
valorNovo = "senha_nova"
response = credencialAlterar(execucaoId, credencialId, expiraEm, parametro, valorAntigo, valorNovo)
print(response)
				
			

Funções de Controle de Fila

1. filaInserir

Objetivo: Inserir um novo registro na fila de processamento dentro do portal SRS-Cloud.

Parâmetros:

    • referencia: Referência do item na fila.
    • parametrosEntrada: Dados de entrada do item.
    • workflow (opcional): Workflow a ser usado. Padrão é workflow_unico.
    • tarefa (opcional): Tarefa a ser usada. Padrão é tarefa_unica.
    • execucaoId (opcional): ID da execução.
    • arquivo (opcional): Arquivo a ser enviado.
 
Exemplo de Uso:
				
					# Python
referencia = "Item_001"
parametrosEntrada = {"param1": "valor1", "param2": "valor2"}
response = filaInserir(referencia, parametrosEntrada)
print(response)
				
			

2. filaInserirExecutando

Objetivo: Inserir um item na fila que já retorna com o status “Em Execução”.

Parâmetros:

    • execucaoId: ID da execução.
    • referencia: Referência do item na fila.
    • parametrosEntrada: Dados de entrada do item.
    • workflow (opcional): Workflow a ser usado. Padrão é workflow_unico.
    • tarefa (opcional): Tarefa a ser usada. Padrão é tarefa_unica.
    • arquivo (opcional): Arquivo a ser enviado.
 
Exemplo de Uso:
				
					# Python
referencia = "Item_001"
execucaoId = "4323414-1243r-41242r-124241"
parametrosEntrada = {"param1": "valor1", "param2": "valor2"}
response = filaInserirExecutando(execucaoId, referencia, parametrosEntrada)
print(response)
				
			

3. filaInserirLote

Objetivo: Inserir um conjunto de itens na fila de uma única vez.

Parâmetros:

    • lote: Lista de itens a serem inseridos.
    • workflow (opcional): Workflow a ser usado. Padrão é workflow_unico.
    • tarefa (opcional): Tarefa a ser usada. Padrão é tarefa_unica.
    • execucaoId (opcional): ID da execução.
 
Exemplo de Uso:
				
					# Python
lote = [
    {"referencia": "Item_003", "parametroEntrada": {"param1": "valor1"}},
    {"referencia": "Item_004", "parametroEntrada": {"param1": "valor2"}}
]
response = filaInserirLote(lote)
print(response)
				
			

4. filaProximo

Objetivo: Retornar o próximo item da fila. Pode trazer mais de um item se especificado.

Parâmetros:

    • execucaoId: ID da execução.
    • qtd (opcional): Quantidade de itens a serem retornados. Padrão é 1.
 
Exemplo de Uso:
				
					# Python
execucaoId = "Execucao_123"
response = filaProximo(execucaoId, qtd=2)
print(response)
				
			

5. filaProximoNomeada

Objetivo: Retornar um item específico da fila, utilizado frequentemente para execuções manuais.

Parâmetros:

    • execucaoId: ID da execução.
    • filaId: ID do item específico na fila.
 
Exemplo de Uso:
				
					# Python
execucaoId = "Execucao_123"
filaId = "Fila_001"
response = filaProximoNomeada(execucaoId, filaId)
print(response)
				
			

6. filaAtualizar

Objetivo: Atualizar o status e informações de um item específico na fila.

Parâmetros:

    • execucaoId: ID da execução.
    • filaId: ID do item na fila.
    • parametrosSaida: Dados de saída do item.
    • statusId: Novo status do item (0=aguardando, 1=em execução, 2=encerrado com sucesso, 3=encerrado com erro).
    • proximo (opcional): Indica se deve buscar o próximo item da fila. Padrão é 0.
    • mensagem (opcional): Mensagem de atualização. Padrão é “Fila atualizada com sucesso”.
    • arquivo (opcional): Arquivo a ser enviado.
 
Exemplo de Uso:
				
					# Python
execucaoId = "Execucao_123"
filaId = "Fila_002"
parametrosSaida = {"result": "success"}
statusId = 2
response = filaAtualizar(execucaoId, filaId, parametrosSaida, statusId)
print(response)
				
			

7. filaAtualizarLote

Objetivo: Atualizar vários itens na fila ao mesmo tempo.

Parâmetros:

    • execucaoId: ID da execução.
    • lote: Lista de itens a serem atualizados.
 
Exemplo de Uso:
				
					# Python
execucaoId = "Execucao_123"
lote = [
    {"filaId": "Fila_003", "statusId": 2, "parametroSaida": {"result": "success"}, "mensagem": "Atualizado com sucesso"},
    {"filaId": "Fila_004", "statusId": 2, "parametroSaida": {"result": "success"}, "mensagem": "Atualizado com sucesso"}
]
response = filaAtualizarLote(execucaoId, lote)
print(response)
				
			

8. filaAtualizarSucesso

Objetivo: Atualizar um item específico na fila como “Encerrado com Sucesso”.

Parâmetros:

    • execucaoId: ID da execução.
    • filaId: ID do item na fila.
    • parametrosSaida: Dados de saída do item.
    • mensagem (opcional): Mensagem de atualização. Padrão é “Fila atualizada com sucesso”.
    • arquivo (opcional): Arquivo a ser enviado.
 
Exemplo de Uso:
				
					# Python
execucaoId = "Execucao_123"
filaId = "Fila_005"
parametrosSaida = {"result": "success"}
response = filaAtualizarSucesso(execucaoId, filaId, parametrosSaida)
print(response)
				
			

9. filaAtualizarProx

Objetivo: Atualizar um item na fila e já retornar o próximo item se existir.

Parâmetros:

    • execucaoId: ID da execução.
    • filaId: ID do item na fila.
    • statusId: Novo status do item (0=aguardando, 1=em execução, 2=encerrado com sucesso, 3=encerrado com erro).
    • parametrosSaida: Dados de saída do item.
    • arquivo (opcional): Arquivo a ser enviado.
 
Exemplo de Uso:
				
					# Python
execucaoId = "Execucao_123"
filaId = "Fila_006"
statusId = 2
parametrosSaida = {"result": "success"}
response = filaAtualizarProx(execucaoId, filaId, statusId, parametrosSaida)
print(response)
				
			

10. filaAtualizarFalha

Objetivo: Atualizar um item específico na fila como “Encerrado com Erro”.

Parâmetros:

    • execucaoId: ID da execução.
    • filaId: ID do item na fila.
    • mensagem: Mensagem de erro.
    • parametrosSaida: Dados de saída do item.
    • arquivo (opcional): Arquivo a ser enviado
 
Exemplo de Uso:
				
					# Python
execucaoId = "Execucao_123"
filaId = "Fila_007"
mensagem = "Erro ao processar"
parametrosSaida = {"error": "details"}
response = filaAtualizarFalha(execucaoId, filaId, mensagem, parametrosSaida)
print(response)

				
			

11. filaConsultar

Objetivo: Consultar itens na fila com base em critérios específicos.

Parâmetros:

    • execucaoId: ID da execução.
    • criterio: Lista de critérios de busca.
    • ordenadoPor (opcional): Campo para ordenar os resultados.
    • limite (opcional): Número máximo de itens a serem retornados (até 100 itens). Padrão é 10.
    • workflow (opcional): Workflow a ser usado. Padrão é workflow_unico.
    • tarefa (opcional): Tarefa a ser usada. Padrão é tarefa_unica.
 
Exemplo de Uso:
				
					# Python
execucaoId = "Execucao_123"
criterio = json.dumps([{'StatusId':{'$gt':0}}])
response = filaConsultar(execucaoId, criterio)
print(response)
				
			

Este guia fornece uma visão geral de como utilizar as principais funções da biblioteca. Certifique-se de ajustar os parâmetros conforme necessário para atender às suas necessidades específicas.