# TABELA

{% hint style="success" %}
**Atenção:** Esta função permite o uso do atributo [CO;](https://docs-kpi-software.gitbook.io/doc/parametros-especiais/co)
{% endhint %}

## Notação

**TABELA(**<mark style="color:green;">f(x) => TABELA()</mark>**) ==>** Executa a função que retorna uma tabela e apresenta a tabela

**TABELA(**<mark style="color:green;">f(x) => TABELA()</mark>**\[** <mark style="color:green;">FILTRO</mark> **]) ==>** Faz o recurso anterior aplicando um filtro

**TABELA(**<mark style="color:green;">f(x) => TABELA()</mark>**{** <mark style="color:green;">CAMPOS</mark> **}) ==>** Faz o recurso principal retornando apenas os campos informados

**TABELA(**<mark style="color:green;">f(x) => TABELA()</mark>**\[** <mark style="color:green;">FILTRO</mark> **]{** <mark style="color:green;">CAMPOS</mark> **}) ==>** Faz o recurso principal aplicando um filtro e retornando apenas os campos informados

**TABELA(**<mark style="color:green;">f(x) => TABELA()</mark>**;** [**Reservado** ](#user-content-fn-1)[^1]**;** <mark style="color:green;">AGRUPAMENTO</mark> **;** <mark style="color:green;">ORDENAÇÃO</mark> **) ==>** Faz o recurso principal executando um agrupamento e ordenando as informações

**TABELA(**<mark style="color:green;">f(x) => TABELA()</mark>**\[** <mark style="color:green;">FILTRO</mark> **];** [**Reservado** ](#user-content-fn-1)[^1]**;** <mark style="color:green;">AGRUPAMENTO</mark> **;** <mark style="color:green;">ORDENAÇÃO</mark> **) ==>** Faz o recurso principal aplicando um filtro, executa um agrupamento e ordena as informações

**TABELA(**<mark style="color:green;">f(x) => TABELA()</mark>**{** <mark style="color:green;">CAMPOS</mark> **};** [**Reservado** ](#user-content-fn-1)[^1]**;** <mark style="color:green;">AGRUPAMENTO</mark> **;** <mark style="color:green;">ORDENAÇÃO</mark> **) ==>** Faz o recurso principal retornando apenas os campos informado, executa um agrupamento e ordena as informações

**TABELA(**<mark style="color:green;">f(x) => TABELA()</mark>**\[** <mark style="color:green;">FILTRO</mark> **]{** <mark style="color:green;">CAMPOS</mark> **};** [**Reservado** ](#user-content-fn-1)[^1]**;** <mark style="color:green;">AGRUPAMENTO</mark> **;** <mark style="color:green;">ORDENAÇÃO</mark> **) ==>** Faz o recurso principal aplicando um filtro e retornando apenas os campos informado, executa um agrupamento e ordena as informações

## Exemplo de Uso

<table><thead><tr><th width="304">Função</th><th>Significado</th></tr></thead><tbody><tr><td>TABELA(#10)</td><td>Executa a regra 10 e retorna a tabela da regra</td></tr><tr><td>TABELA(#10[ CODCLI = 41 ])</td><td>Executa a regra 10 e retorna somente as linhas cujo campo CODCLI seja o valor 41</td></tr><tr><td>TABELA(#10{ CODCLI })</td><td>Executa a regra 10 e retorna somente a coluna CODCLI da regra</td></tr><tr><td>TABELA(#10[ CODCLI = 41 ]{ CODCLI })</td><td>Executa a regra 10, aplica o filtro CODCLI = 41 e retorna somente a coluna CODCLI da regra</td></tr><tr><td>TABELA(#10;;CODCLI;)</td><td>Executa a regra 10 agrupando o campo CODCLI</td></tr><tr><td>TABELA(#10;;CODCLI;CODCLI)</td><td>Executa a regra 10 agrupando o campo CODCLI e ordena a tabela CODCLI</td></tr></tbody></table>

[^1]: Este local está reservado para futuras implementações. Portanto, deve-se deixar sem preenchimento na utilização
