Ações

Ações são comportamentos que o robô é capaz de realizar e funcionam da seguinte maneira: primeiro elas recebem valores de entradas pelo usuário através de seus campos (parâmetros). Logo ela faz a sua execução de acordo com essas entradas e por fim, armazenam em seus retornos os valores que foram obtidos após a execução. Exemplo de ações: reconhecer imagens, digitar um texto, ler algum arquivo. Cada ação possui uma estrutura básica que é comum para todas elas. Essas estruturas são importantes para que o usuário consiga identificar, manipular e obter os resultados das ações.

ID

Toda ação possui um campo ID que é um identificador único. Esse campo é preenchido automaticamente com caracteres aleatórios quando a ação é criada, porém se o usuário desejar é possível preencher com outro nome passado por ele. Dentro da estrutra do robô o usuário não poderá criar ações com o mesmo ID. É através do ID que é possível referenciar uma ação dentro de outras ações e obter o seu retorno.

Retornos

Os retornos de uma ação são os valores que elas armazenam após realizar a sua execução. Por exemplo: a ação de leitura de diretórios armazenará em seu retorno o nome de todos os arquivos que estavam no diretório passado pelo usuário. Esses retornos podem ser acessados pelo usuário de duas formas:

• Através da ferramenta de seleção de campo customizada que possui o campo ações customizadas. Este campo oferece uma lista de retornos de todas as ações que foram utilizadas no robô, assim o retorno de uma ação pode ser utilizado como parâmetro de outra ação. Nesta ferramenta o retorno é mostrado com o id da ação e o nome do retorno como mostrado na imagem abaixo:

  

  É perceptível na imagem acima que o retorno em si é o que está depois do ".", ou seja, o retorno de Lista1 é o .size, mas para obtê-lo é preciso referenciar a ação que ele pertence, por isso é mostrado "Lista1.size". Neste caso, Lista1.size retornará um valor numérico que representa o tamanho da Lista1 como está descrito na imagem. A mesma lógica serve para os retornos das outras ações, porém o valor retornado, seu tipo e o que ele representa pode mudar de acordo com a ação.

• Outra forma de acessar o retorno de ações é através dos códigos customizados como mostrado no exemplo abaixo:

  const retornoDaAcao = actions['id-da-acao'].value
  return retornoDaAcao

  • "actions" referencia a lista de todas as ações que existem na estrutura do robô;
  • "id-da-ação" é o nome que identifica unicamente cada ação que foi criada no robô, esse nome é gerado automaticamente quando a ação é criada, mas pode ser alterado pelo usuário desde que não exista nenhuma ação com o mesmo nome que ele colocar;
  • "value" é o valor que a ação retorna.

Neste caso, a constante 'retornoDaAcao' estaria recebendo o valor retornado pelo '.value' que é um retorno da ação 'id-da-acao' e esse valor está sendo retornado para o código customizado que também tem um retorno. O retorno de todo código customizado é '.value', ou seja, o retorno da ação 'id-da-acao' ficaria armazenado no retorno do código costumizado em que está o código acima. Veja mais aqui sobre códigos customizados.

Para finalizar, cada ação pode ter de nenhum a vários retornos e para saber qual é o retorno de cada uma delas, basta acessar a área de documentação onde existe a explicação de todas as ações do Roberty.