# Retornar Última Execução

## CONFIGURAÇÃO

Para utilizar esse objeto basta configurar o objeto Autenticação e selecionar o robô.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2Fuq1ZbJ6sR1wqBSi18zoP%2Fimage.png?alt=media&#x26;token=c93f1b9d-1103-433c-8b2a-f48cb40693d5" alt=""><figcaption><p>Layout geral do objeto</p></figcaption></figure>

**Preenchendo o objeto:**

| Campo                        | Descrição                                                                                                                                                                                                                                                        |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Título                       | É o nome do objeto e **não precisa ser alterado**, a menos que você queira identificá-lo para facilitar a localização dele no robô, por exemplo: "Retornar Última Execução -  Robô Receita Federal".                                                             |
| Nome Identificador do Objeto | É um identificador único do objeto e **não precisa ser alterado**, mas você pode renomear caso queira para localizá-lo mais facilmente quando for usá-lo em outros objetos. Apenas lembre-se que esse nome deve ser único e sem espaços ou caracteres especiais. |
| Selecionar Objeto Principal  | Opção para selecionar objeto **Autenticação.**                                                                                                                                                                                                                   |
| Seleciona o robô             | Robô sobre o qual será retornado a última execução.                                                                                                                                                                                                              |
| Selecione o robô (checkbox)  | Marcar caso deseje selecionar o robô. Possível utilizar o ID do robô ao desmarcar a opção.                                                                                                                                                                       |

## PRÉ-REQUISITOS

* É necessário configurar o objeto [Autenticação](https://docs.roboteasy.tech/studio/geral/objetos/orquestrador/autenticacao) com o usuário e senha onde encontra-se o robô e Runtime desejado.

## RETORNOS

* Segue a lista de retornos possíveis de objeto, basta colocar o nome identificar do objeto no começo da frase:&#x20;

<details>

<summary>Variáveis de Retorno do Objeto</summary>

* Código de Status: {.StatusCode}
* Status: {.Task.Status}
* ID do cliente: {.Task.ClientId}
* Data de inserção: {.Task.DtAdd}
* Data final: {.Task.DtEnd}
* Data inicial: {.Task.DtIni}
* Ordem de Execução: {.Task.ExecutionOrder}
* ID do robô: {.Task.IdBot}
* ID da tarefa: {.IdTask}
* Última notificação: {.Task.LastNotification}
* Local do robô: {.Task.LocalBot}
* Nome do robô: {.Task.NameBot}
* Parâmetros: {.Task.Parameters}
* Positivo: {.Task.Positive}
* Progresso: {.Task.Progress}
* Valor retornado: {orchestratorGetLastExecution3.Task.ReturnValue}
* Token: {.Task.Token}
* Token de integração: {.Task.TokenIntegration}
* Versão do robô: {.Task.VersionBot}

</details>

## CASOS DE USO

* Utilizar para retornar última execução do robô salvo na ferramenta RobotEasy Orquestrador.
* É utilizado para retornar informações da execução do robô através das variáveis de retorno, por exemplo: demonstrar que o robô foi executado com sucesso.

## EXEMPLO

Verificar a situação do Status do robô.

<details>

<summary>ITENS UTILIZADOS NO ROBÔ</summary>

* **Objetos:** [Autenticação ](https://docs.roboteasy.tech/studio/geral/objetos/orquestrador/autenticacao)- [Caixa de mensagem](https://docs.roboteasy.tech/studio/geral/objetos/acoes-globais/caixa-de-mensagem)

</details>

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FL6k1cYVlNPZRWQlL3Fkq%2Fimage.png?alt=media&#x26;token=dadab2ea-cc97-4082-9891-2f89855d8085" alt=""><figcaption><p>Configuração Robô Exemplo Retornar Última Execução</p></figcaption></figure>

**PASSO 1:** Configurar Autenticação com usuário e senha válidos.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FtzrnKRiDYUPWnD513e1s%2Fimage.png?alt=media&#x26;token=57ed205c-20c7-4efe-a643-7e462dffd1d4" alt=""><figcaption><p>Configuração Autenticação</p></figcaption></figure>

**PASSO 2:** Configurar Retornar Última Execução com o robô desejado.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FdofYBqyNecfqBOzy1Txj%2Fimage.png?alt=media&#x26;token=2df7c6e1-4274-48b6-827b-75fe697334b6" alt=""><figcaption><p>Configuração Retornar Última Execução</p></figcaption></figure>

**PASSO 3:** Configurar Caixa de Mensagem com a variável de retorno desejada.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2F5VOBmoMIvZNywVNQ7xva%2Fimage.png?alt=media&#x26;token=b63e66f4-2ef5-48cf-985e-da89a9c3f409" alt=""><figcaption><p>Configuração Caixa de Mensagem</p></figcaption></figure>

**PASSO 4:** Executar o robô e verificar as ações.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FcaUi46ILoQF59LZnl1jm%2Fexecu%C3%A7%C3%A3o.gif?alt=media&#x26;token=393be30a-09c4-4849-9c8f-867689e06fd0" alt=""><figcaption><p>Execução Robô Exemplo Retornar Última Execução</p></figcaption></figure>

## Baixar o Robô

{% hint style="info" %}
O robô não será disponibilizado por conter informações sensíveis.
{% endhint %}