# Session Management

O **Session Management** implementa o gerenciamento de sessão tradicional e a sua função principal para construção de *pipelines* é bastante utilizada no armazenamento de dados semelhantes às variáveis em desenvolvimento tradicional.

## Parâmetros

Dê uma olhada nas opções de configuração do componente. Parâmetros suportados por [expressões *Double Braces*](/documentation/connectors-and-triggers/pt-br/double-braces/overview.md) estão marcados com `(DB)`.

<table data-full-width="true"><thead><tr><th>Parâmetro</th><th>Descrição</th><th>Valor padrão</th><th>Tipo de dado</th></tr></thead><tbody><tr><td><strong>Operation</strong></td><td>Operação a ser executada (<em>Get Data, Put Data, Delete Data</em>).</td><td><em>Get Data</em></td><td><em>String</em></td></tr><tr><td><strong>Session Type</strong></td><td>Sessão para inserir o objeto especificado em <em>Fields</em> (Local ou Global).</td><td>Local</td><td><em>String</em></td></tr><tr><td><strong>Fields</strong></td><td>Objeto a ser especificado - ex. <em>body, data, id.</em></td><td>body, data, id</td><td><em>String</em></td></tr><tr><td><strong>Scoped</strong></td><td>Quando esta opção está habilitada, a sessão é isolada de outro subprocesso. Nesse caso, os subprocessos veem sua própria versão dos dados da sessão.</td><td><em>False</em></td><td>Booleano</td></tr></tbody></table>

## **Operation**

Esse componente pode ser configurado nas seguintes operações:

* **Get Data:** busca na sessão os objetos especificados no parâmetro **Fields**, que serão inseridos em seguida no corpo da solicitação.&#x20;
* **Put Data:** insere na sessão (Local ou Global) os objetos especificados no parâmetro **Fields***.*
* **Delete Data:** apaga da sessão os objetos especificados no parâmetro **Fields**.

## **Session Type**

### Local <a href="#local" id="local"></a>

Lida com uma sessão onde os valores armazenados estão disponíveis apenas no *pipeline* em execução corrente.               &#x20;

**Exemplo:** As *tags "body*" e *"data"* da etapa **Fields** são armazenadas na sessão **Local**.

### Global <a href="#global" id="global"></a>

Lida com uma sessão baseada no *token* JWT do usuário autenticado, permitindo que *pipelines* e execuções distintas tenham acesso seguro aos dados armazenados na sessão global do usuário.

Somente será permitido armazenar e acessar dados em sessão **Global** quando o *pipeline* possuir o [**REST Trigger**](/documentation/connectors-and-triggers/pt-br/triggers/web-protocols/rest.md) ou o [**HTTP Trigger**](/documentation/connectors-and-triggers/pt-br/triggers/web-protocols/http.md) e tiver o *token* JWT como critério de segurança.

Para executar um *pipeline* com esse critério de segurança, é necessário que você crie um *pipeline* de *login* e utilize o componente [**JWT**](/documentation/connectors-and-triggers/pt-br/connectors/security/jwt.md) para obter um *token* JW&#x54;*.*

&#x20;        \
**Exemplo**

* **Step Name:** Session-Management
* **Operation:** Get Data
* **Session Type:** Global
* **Fields:** object

## Fluxo de Mensagens <a href="#fluxo-de-mensagens" id="fluxo-de-mensagens"></a>

### Entrada <a href="#entrada" id="entrada"></a>

O componente aceita qualquer mensagem de entrada e pode fazer uso dela declarando os valores do JSON no campo **Fields**.

### Saída <a href="#sada" id="sada"></a>

O componente não altera nenhuma informação da mensagem de entrada. Portanto, ela é retornada para o componente seguinte ou é utilizada como resposta final se este componente for o último passo do *pipeline*.&#x20;

Ao manter a operação *Get Data* selecionada, os itens especificados no campo **Fields** serão adicionados à mensagem de saída (caso existam na sessão).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/structured-data/session-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.