# Previous Steps Access

{% hint style="info" %}
Para usar o Previous Steps Access, certifique-se de que está utilizando a versão mais recente do Pipeline Engine. Atualize e reimplante seus pipelines para ativar o recurso.
{% endhint %}

A funcionalidade de **Previous Steps Access** permite referenciar dados de uma etapa anterior (conector ou cápsula) nas etapas subsequentes do fluxo, utilizando [expressões Double Braces.](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/double-braces/overview) Com ela, você pode acessar os payloads diretamente usando aliases personalizados que se alinham às necessidades do seu pipeline.

Isso reduz o esforço necessário para o gerenciamento manual de dados e diminui a necessidade de utilizar o conector [Session Management](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/structured-data/session-management).

## Como funciona

Ao configurar um conector ou cápsula, você pode definir um **Step Alias**. Isso permite referenciar os dados em passos subsequentes que suportam expressões Double Braces. Veja abaixo um exemplo usando o conector **JWT V2** e uma cápsula de validação (**cpf-cnpj-validator**):

<figure><img src="https://content.gitbook.com/content/SKBJ6ZiEWBU93x170HH4/blobs/qR8xWFjEBHIcgRAEfGNX/DoubleBrace_Alias_PT.png" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://3268428548-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSKBJ6ZiEWBU93x170HH4%2Fuploads%2F9gUfVb9hX9Bdp7OHbtlH%2FPrevious_Steps_Access_Capsules_PT.png?alt=media&#x26;token=8204000e-1a5b-4464-8603-2ead9c98b6a5" alt="" width="563"><figcaption></figcaption></figure>

Também é possível usar a feature de Previous Steps Access para referenciar ao output de qualquer etapa ao criar uma nova cápsula.

<figure><img src="https://3268428548-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSKBJ6ZiEWBU93x170HH4%2Fuploads%2FrJh5YFRNPRwAhkhpnGja%2FScreenshot%202025-07-24%20at%2017.03.55-20250724-200400.png?alt=media&#x26;token=6e41184e-785f-4a70-ba28-76adb2d00c31" alt=""><figcaption></figcaption></figure>

### Regras de nomenclatura para o Alias

O nome definido para o Alias, para ser referenciado corretamente, deve:

* Utilizar apenas caracteres alfanuméricos e hífens.
* Utilizar apenas letras minúsculas.
* Iniciar com uma letra.
* Finalizar com um caractere alfanumérico.
* Conter no máximo 30 caracteres.

**Sugestão:** Nome do conector/Nome da cápsula + identificação numérica. Exemplo: `csv-to-json-v1-3`

## Como usar o Previous Steps Access

### Criando o Alias

1. Abra o **Canvas** para [criar um novo pipeline](https://app.gitbook.com/s/cO0A6g1dOsu8BiHYqO67/development-cycle/build-overview/pipelines/how-to-create-a-pipeline). Você também pode modificar um pipeline existente, se preferir.
2. Clique no conector ou cápsula cuja saída você deseja referenciar nos próximos passos.
3. Dê um nome ao seu **Alias**.
4. Preencha as demais configurações do conector normalmente.
5. Clique em **Confirmar.**&#x20;

### Referenciando o Alias

1. Selecione o conector ou cápsula que irá consumir a saída salva por meio do Previous Steps Access.
2. Preencha as configurações do conector ou cápsula normalmente.
3. Cole o nome do Double Brace Alias que você criou usando a sintaxe `{{ step.step-alias}}`. Por exemplo: `{{ step.csv-to-json-v1-3 }}` , com `csv-to-json-v1-3` representando o step-alias.
4. Clique em **Salvar**.
5. Execute o pipeline utilizando o [**Painel de Execução**](https://app.gitbook.com/s/cO0A6g1dOsu8BiHYqO67/development-cycle/build-overview/canvas/execution-panel).

## Perguntas frequentes

<details>

<summary><strong>Como identificar se a saída de um conector pode ser referenciada posteriormente?</strong></summary>

Para verificar se um conector oferece esse recurso, abra o formulário de configuração e confira se o primeiro campo é denominado **Alias**. Se o campo **Alias** estiver presente, a saída do conector poderá ser referenciada posteriormente no fluxo.

</details>

<details>

<summary><strong>Todos os conectores suportam o campo Alias?</strong></summary>

Não. Nem todos os conectores disponibilizam o campo **Alias**, que é usado para referenciar a saída de um conector posteriormente no fluxo. Exemplos de conectores que **suportam** esse recurso:

* [AWS Kinesis](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/aws/kinesis)
* [DB V2](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/structured-data/db-v2)
* [Dynamics 365](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/enterprise-applications/dynamics-365)
* [Email V2](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/web-protocols/email-v2)
* [Event Publisher](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/queues-and-messaging/event-publisher)
* [JWT V2](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/security/jwt)
* [Google Drive](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/file-storage/google-drive)
* [Gupy Public API](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/industry-solutions/gupy)
* [Hash](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/security/hash)
* [JSON Generator (Mock)](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/tools/json-generator)
* [JSON Transformer](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/tools/json-transformer)
* [Agent Component](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/ai-tools/llm)
* [Marketo](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/industry-solutions/marketo)
* [Object Store](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/structured-data/object-store)
* [REST V2](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/web-protocols/rest-v2)
* [Salesforce](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/enterprise-applications/salesforce)
* [SAP](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/enterprise-applications/sap)
* [Script](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/tools/script)
* [Session Management](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/structured-data/session-management)
* [Stream XML File Reader](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/files/stream-xml-file-reader)
* [Template Transformer](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/tools/template-transformer)
* [Transformer (JOLT) V2](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/tools/jolt-v2)
* [Vector DB](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/ai-tools/vector-db)
* [WhatsApp](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/enterprise-applications/whatsapp)

</details>