> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inceptia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ações disponíveis

> Filtros e transformações aplicados a cada campo antes de enviá-lo ao bot

As **ações** permitem transformar ou filtrar os dados de um campo antes de enviá-lo ao bot. São aplicadas na ordem em que são adicionadas, e estão disponíveis nos campos de **Bot Params**, **Product Params** e **Extra Params**.

## Ações de remoção

| Ação                              | Descrição                                                                               | Parâmetros                                 |
| --------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------ |
| **remove\_empty**                 | Descarta o registro completo se o campo estiver vazio.                                  | —                                          |
| **remove\_empty\_and\_spaces**    | Descarta o registro se o campo estiver vazio ou contiver apenas espaços.                | —                                          |
| **remove\_length\_greater\_than** | Descarta o registro se o comprimento do valor superar N caracteres.                     | `Valor` (inteiro)                          |
| **remove\_length\_less\_than**    | Descarta o registro se o comprimento do valor for menor que N caracteres.               | `Valor` (inteiro)                          |
| **allows\_long\_between**         | Descarta o registro se o comprimento do valor não estiver dentro do intervalo definido. | `Comprimento mínimo`, `Comprimento máximo` |

## Ações de substituição

| Ação                      | Descrição                                      | Parâmetros                                        |
| ------------------------- | ---------------------------------------------- | ------------------------------------------------- |
| **replace\_empty**        | Substitui os valores vazios por um valor fixo. | `Valor de substituição`                           |
| **replace\_characters**   | Substitui um caractere ou cadeia por outro.    | `Caractere a substituir`, `Valor de substituição` |
| **replace\_field\_value** | Substitui um valor específico por outro.       | `Valor a substituir`, `Valor de substituição`     |

## Ações de coluna

| Ação             | Descrição                                                                                                                              | Parâmetros                                 |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
| **new\_column**  | Atribui um valor fixo ao campo, sem ler de nenhuma coluna do arquivo. Útil quando o bot requer um parâmetro que não existe no arquivo. | `Valor`                                    |
| **copy\_column** | Copia o valor de outra coluna do arquivo.                                                                                              | `Coluna de origem`, `Nome da coluna cópia` |

## Ações de formato

| Ação                  | Descrição                         | Parâmetros                                  |
| --------------------- | --------------------------------- | ------------------------------------------- |
| **change\_format**    | Converte o tipo de dado do valor. | `Formato de destino`: `str`, `int`, `float` |
| **convert\_to\_list** | Converte o valor em uma lista.    | —                                           |

## Ações de data

Todas as ações de data trabalham com uma **data de referência** e um **deslocamento em dias**:

* **Data de referência** (`init_date`): pode ser `today` (data do dia) ou uma data fixa no formato `YYYY-MM-DD`.
* **Dias de deslocamento** (`shift_days`): número de dias a somar ou subtrair da data de referência. Pode ser negativo. Por exemplo, `shift_days = -1` com `init_date = today` equivale a "ontem".

### Ações de filtragem por data

| Ação                                   | Descarta o registro se a data do campo for... |
| -------------------------------------- | --------------------------------------------- |
| **date\_remove\_greater\_than**        | maior que a data de referência                |
| **date\_remove\_greater\_equal\_than** | maior ou igual à data de referência           |
| **date\_remove\_less\_than**           | menor que a data de referência                |
| **date\_remove\_less\_equal\_than**    | menor ou igual à data de referência           |
| **date\_remove\_equal\_than**          | igual à data de referência                    |
| **date\_remove\_different\_than**      | diferente da data de referência               |

### date\_generate\_from\_relative\_value

Gera uma data a partir de um valor numérico (dias) que vem no campo. Por exemplo: se o campo contém `30`, gera a data que está 30 dias a partir da data de referência.

| Parâmetro                               | Descrição                                                                                                                                   |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nome da nova coluna**                 | Nome que a coluna com a data gerada terá.                                                                                                   |
| **Data inicial** (`init_date`)          | Data base: `today` ou uma data fixa.                                                                                                        |
| **Dias de deslocamento** (`shift_days`) | Dias a somar ou subtrair da data base.                                                                                                      |
| **Operação**                            | `nothing`: não modifica a coluna original. `add_col`: adiciona uma nova coluna com a data gerada. `subst_col`: substitui a coluna original. |