> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/pt/acoes/workflow-concepts/workflow-steps/logic-steps/format-single-multi-select.md).

# Formatar seleção única/múltipla

Transforme uma lista de objetos em opções JSON ou CSV para colunas de Seleção Única e Grelha de Seleção Múltipla.

## Como funciona a Etapa Formatar Seleção Única/Múltipla?

Utilize **Formatar Seleção Simples/Múltipla** para transformar uma lista de objetos em rótulos e valores armazenados. Por exemplo, converta uma lista de autores do CMS em nomes legíveis associados a IDs de autor e, depois, use o resultado ao configurar as opções do Grid.

A Etapa retorna um objeto JSON ou texto CSV. Quando for a Etapa final, o Workflow retorna o resultado formatado completo numa única coluna de saída do Grid.

## Como Configurar uma Etapa Formatar Seleção Única/Múltipla

1. Adicione **Formatar Seleção Simples/Múltipla** de **Código** após a Etapa que produz a sua lista.
2. Em **Selecionar saída JSON**, escolha a lista de origem. Teste a Etapa de origem para disponibilizar a saída para pré-visualização.
3. Defina **Campo de rótulo** para o campo do objeto que contém o rótulo de exibição, como `nome`.
4. Defina **Campo de valor** para o campo que contém o valor armazenado, como `id`. Ambas as definições de campo suportam variáveis.
5. Escolha **JSON (rótulo para valor)** ou **CSV (rótulo,valor por linha)** em **Formato de saída**. O JSON é o padrão.
6. Rever **Pré-visualização das opções**, depois teste a Etapa.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-debb845904eaa466e83c00da1e972ffcd13d0af2%2Fformat-select-01-options-preview.png?alt=media" alt="Format Single/Multi Select step with label and value fields and an options preview of three ground stations"><figcaption><p>Associe os campos de rótulo e valor e, depois, verifique a pré-visualização das opções.</p></figcaption></figure>

| Parâmetro                 | O que fornecer                                                                   |
| ------------------------- | -------------------------------------------------------------------------------- |
| **Selecionar saída JSON** | Um array de objetos de uma Etapa anterior ou de uma Entrada.                     |
| **Campo de rótulo**       | A chave a usar para o rótulo de exibição de cada opção.                          |
| **Campo de valor**        | A chave a usar para o valor armazenado de cada opção.                            |
| **Formato de saída**      | Um objeto JSON de rótulo para valor ou CSV com um par por linha e sem cabeçalho. |

Os rótulos e valores devem ser texto ou números não vazios. A Etapa remove os espaços em branco à volta, converte números em strings e rejeita rótulos duplicados ou valores duplicados.

## Exemplo

Dada esta lista de origem:

```json
[
  {"name": "Aaron", "id": 93},
  {"name": "Alice", "id": 22}
]
```

Defina **Campo de rótulo** para `nome` quanto no **Campo de valor** para `id`. A saída JSON é:

```json
{
  "Aaron": "93",
  "Alice": "22"
}
```

A saída CSV é:

```csv
Aaron,93
Alice,22
```

O formatador prepara os dados. Para transformar uma coluna de dados do Grid preenchida numa lista suspensa, use o [fluxo de conversão de coluna](https://docs.airops.com/docs/pt/acoes/grids/add-columns-in-the-grid.md#convert-a-populated-column-to-single-select-or-multi-select).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/pt/acoes/workflow-concepts/workflow-steps/logic-steps/format-single-multi-select.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
