# Glossário

## Workspace <a href="#h.v2iib5rbzgad" id="h.v2iib5rbzgad"></a>

Um workspace é um ambiente virtual projetado especificamente para facilitar a criação, gerenciamento e execução de integrações entre diferentes aplicativos e sistemas. Esse ambiente fornece uma área isolada, onde os usuários podem desenvolver, testar e implantar fluxos de integração de forma segura, sem interferir em outros ambientes operacionais.

## Flow ou Fluxos

Um sistema que permite agrupar diversos componentes (conectores) e construir sequências de execução lógica. Cada fluxo é vinculado e encapsulado dentro do Workspace em que foi criado, porém podem ser exportados e importados entre diferentes Workspaces.

## Conectores <a href="#h.l8aktgo22hw4" id="h.l8aktgo22hw4"></a>

Conectores são os blocos fundamentais usados para criar integrações entre diversos aplicativos e sistemas. Eles podem incluir transformações de dados, lógica de negócios, e outros elementos que facilitam a configuração e execução de fluxos de integração.

## Triggers

Triggers (gatilhos) são condições ou eventos que ativam processos automáticos em um sistema. Eles facilitam a automação e a sincronização de tarefas entre diferentes plataformas, reagindo a situações como o recebimento de um e-mail, mudanças em arquivos de armazenamento na nuvem ou atualizações em bancos de dados.

## Painel de funcionalidades

O menu de funcionalidades encontrado dentro do Workspace, acessível pelo menu lateral esquerdo, reúne os diferentes serviços oferecidos pelo Floui.

## Conta de serviço <a href="#h.wu2gufxu3jzg" id="h.wu2gufxu3jzg"></a>

Uma conta de serviço refere-se a uma identidade utilizada pela aplicação para autenticar-se e acessar recursos internos ou externos de forma automatizada.

## Objeto msg

Representa os dados mantidos em memória dentro do contexto atual de execução de um fluxo, contendo todas as informações geradas por esta execução. A criação de um contexto pode ser definida por meio de um conector do tipo trigger (gatilho) representados pelo ícone ⚡ .

## Output path

O termo "output path" refere-se ao caminho dentro do objeto `msg` em um fluxo, onde os dados de saída são armazenados. Isso é frequentemente equivalente ao termo "payload", que denota os dados principais ou as informações transportadas por uma mensagem.

## Campo de descrição <a href="#h.46wdq0l5jez5" id="h.46wdq0l5jez5"></a>

Elemento visual utilizado para descrever a funcionalidade do conector dentro do fluxo. Aplicado para orientar outros colaboradores durante a criação dos fluxos.

## Canal de suporte

Em caso de dúvidas, contate o nosso time de suporte através do site[ https://floui.freshdesk.com/](https://floui.freshdesk.com/). Por padrão, as contas de acesso são fornecidas pelo time de implantação do Floui ao final de um projeto.&#x20;

## Eventos internos

Os logs de monitoramento no serviço Floui registram diversos eventos para ajudar a identificar e diagnosticar exceções durante as execuções. Aqui estão alguns dos principais eventos que representam exceções:

* **Timeouts**: Indicam que uma execução excedeu o tempo máximo permitido, potencialmente devido a problemas de desempenho ou bloqueios na rede.
* **Erros de Conexão**: Representam falhas ao tentar se conectar a recursos externos ou internos, como bancos de dados ou serviços de terceiros.
* **Falhas de Autorização**: Ocorrem quando uma execução falha devido a credenciais inválidas ou insuficientes para acessar um recurso específico.
* **Erros de Validação**: Refletem problemas com os dados de entrada, onde eles não atendem aos critérios necessários para uma execução bem-sucedida.
* **Exceções Não Tratadas**: Capturam erros que não foram explicitamente tratados pelo código, podendo indicar problemas desconhecidos ou imprevistos.

<details>

<summary>flow_run_start</summary>

Indica a inicialização de uma execução de fluxo

```json
{
  "event": "flow_run_start",
  "trigger_type": "core_scheduler"
}
```

| Tipos de gatilhos disponíveis                      |
| -------------------------------------------------- |
| core\_form                                         |
| core\_http\_in                                     |
| core\_manual\_trigger                              |
| core\_pubsub\_subscriber                           |
| core\_queue\_consumer\_v2                          |
| core\_queue\_consumer                              |
| core\_scheduler                                    |
| core\_flow\_input                                  |
| service\_magento\_remote\_event\_cart\_item\_added |
| service\_magento\_remote\_event\_order\_created    |
| service\_magento\_remote\_event\_order\_updated    |
| service\_trello\_card\_moved                       |

</details>

<details>

<summary>flow_run_end</summary>

Indica o término de uma execução de fluxo.

```json
{
  "event": "flow_run_end",
  "execution_time": 124,
  "last_node_type": "core_logger",
  "last_node_uid": "8ethriey3"
}
```

</details>

<details>

<summary>flow_run_stop</summary>

Indica a finalização de uma execução de um fluxo

```json
{
  "event": "flow_run_stop",
  "execution_time": 235,
  "last_node_type": "core_logger",
  "last_node_uid": "2cflyfhz1"
}
```

</details>

<details>

<summary>flow_debug_start</summary>

Indica a inicialização da execução de um fluxo em modo de debug.

```json
{
  "event": "flow_debug_start",
  "is_debug_mode": true,
  "trigger_type": "core_form"
}
```

</details>

<details>

<summary>flow_debug_stop</summary>

Indica a finalização da execução de um fluxo em modo de debug

```json
{
  "event": "flow_debug_stop",
  "execution_time": 11449,
  "last_node_type": "core_debugger",
  "last_node_uid": "qt636is8k"
}
```

</details>

<details>

<summary>flow_run_exception</summary>

Indica uma exceção ocorrida durante uma execução (em geral um erro dentro de uma execução)

```json
{
  "error": {
    "message": "Service account not found"
  },
  "event": "flow_run_exception"
}
```

</details>

<details>

<summary>agent_started</summary>

Indica quando o agente do workspace inicializou (a engine de execução)

```json
{
  "event": "agent_started"
}
```

</details>

<details>

<summary>rate_limit_reached</summary>

Indica quando o limite de execuções simultâneas do workspace foi atingido

```json
{
  "event": "rate_limit_reached",
  "execution_count": 10
}
```

</details>

<details>

<summary>warning</summary>

Indica uma mensagem de alerta disparada durante uma execução de fluxo

```json
{
  "event": "warning",
  "message": "Missing HTTP Out/Response node"
}
```

</details>

<details>

<summary>uncaught_exception</summary>

```
{
  "event": "uncaught_exception",
  "message": "Error: Field (minute) cannot be parsed"
}
```

</details>