Criacao_tarefa_auditor_xls

---
title: Criacao_tarefa_auditor_xls
slug: criacao-tarefa-auditor-xls
sistema:
  - Teorema Auditor [18]
categoria: user_manual
tipo: how-to
publico: ""
keywords:
  - auditor
  - tarefa
  - planilha
  - xlsx
  - html
  - modelo
  - jx
  - template
autor: ""
setor: ""
modulo: ""
aprovado_em: ""
release: ""
versao_pipeline: 2.7.0
chamado: ""
ultima_revisao: "2026-06-13"
---

## Visão Geral

Descreve como criar uma tarefa no Teorema Auditor usando um arquivo `.xlsx` como modelo de saída (tipo Planilha) e como criar uma tarefa com saída em HTML (tipo Gráfico), incluindo a geração do arquivo `.options` para seletores interativos.

---

## Configurar a aba Geral da tarefa

Ao criar ou editar uma tarefa no Auditor, a aba **GERAL** exige os seguintes campos:

- **Descrição** — nome da tarefa visível para consulta.
- **Tipo** — `Ativo`, `Inativo` ou `Manual`.
- **Grupo** — categoria na qual a tarefa ficará disponível para consulta.

![Editar Tarefa — aba GERAL com Descrição "AVALIACAO ESTOQUE MENSAL - INVENTARIO", Tipo "Manual", Grupo "ESTOQUE" e Loop "modelo,tipoSaida"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/criacao-tarefa-auditor-xls/criacao-tarefa-auditor-xls-01.png)

---

## Configurar o Modelo da tarefa (tipo Planilha)

Na aba **MODELO**, selecione **Planilha** e cadastre as variáveis abaixo:

| Variável | Parâmetro | Tipo |
|---|---|---|
| SQL_ESTOQUEMENSAL | sql/avaliacao_estoque_mensal_inventario.txt | FSQ |
| TEMPLATE | templates/avaliacao_estoque_mensal_inventario.xlsx | STR |

- **SQL_nome_do_sql** (FSQ) — caminho do arquivo SQL que será executado.
- **TEMPLATE** (FSQ/STR) — caminho do arquivo `.xlsx` usado como modelo de saída.

![Editar Tarefa — aba MODELO com tipo "Planilha" selecionado; variável SQL_ESTOQUEMENSAL (FSQ: sql/avaliacao_estoque_mensal_inventario.txt) e TEMPLATE (STR: templates/avaliacao_estoque_mensal_inventario.xlsx)](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/criacao-tarefa-auditor-xls/criacao-tarefa-auditor-xls-02.png)

---

## Configurar a Saída da tarefa

Na aba **SAÍDA**, selecione **Arquivo** e informe o caminho de destino do `.xlsx` gerado.

![Editar Tarefa — aba SAÍDA com tipo "Arquivo" selecionado; variável OUTPUT com parâmetro C:/temp/teorema/result/avaliacao_estoque_mensal_inventario.xlsx, tipo STR](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/criacao-tarefa-auditor-xls/criacao-tarefa-auditor-xls-03.png)

---

## Copiar os campos da consulta via IB

Para mapear as colunas do SQL no template `.xlsx`, execute a consulta no InterBase (IB), acesse a aba **Query columns** e copie os nomes dos campos:

![IB — aba "Query columns" com lista de colunas da consulta e separador vírgula](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/criacao-tarefa-auditor-xls/criacao-tarefa-auditor-xls-04.png)

Colunas retornadas pela consulta de exemplo (`avaliacao_estoque_mensal_inventario`):

```
ITEM,
INVENTARIO_QUANTIDADE,
CUSTO_REAL_TOTAL,
CUSTO_MEDIO_TOTAL,
CUSTO_PRODUTO_TOTAL,
FAMILIA,
GRUPO,
SUBGRUPO,
TIPO,
SUBTIPO,
EMPRESA,
INVENTARIO_DATA,
TRANSACAO,
INVENTARIO_DESCRICAO,
ANO,
ANOMES
```

---

## Inserir as variáveis no template .xlsx

No arquivo `.xlsx` de modelo, referencie cada coluna com a sintaxe `${results.<COLUNA>}`:

![Editor de texto com as variáveis ${results.ITEM}, ${results.INVENTARIO_QUANTIDADE}, ${results.CUSTO_REAL_TOTAL}, ${results.CUSTO_MEDIO_TOTAL}, ${results.CUSTO_PRODUTO_TOTAL}, ${results.FAMILIA}, ${results.GRUPO}, ${results.SUBGRUPO}, ${results.TIPO}, ${results.SUBTIPO}, ${results.EMPRESA}, ${results.INVENTARIO_DATA}, ${results.TRANSACAO}, ${results.INVENTARIO_DESCRICAO}, ${results.ANO}, ${results.ANOMES}](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/criacao-tarefa-auditor-xls/criacao-tarefa-auditor-xls-05.png)

---

## Adicionar comentários de controle jx no template

Nas células da planilha, insira comentários com as diretivas `jx` para controlar a iteração dos dados:

- **Comentário da 1ª linha** (célula de área):
  ```
  jx:area(lastCell="")
  ```
- **Comentário da 2ª linha** (célula de iteração):
  ```
  jx:each(items="CARTEIRA_CONSULTOR" var="results" lastCell="")
  ```

![Planilha Excel com cabeçalhos das colunas ITEM, INVENTARIO_QUANTIDADE, CUSTO_RE(AL_TOTAL), CUSTO_M(EDIO_TOTAL), CUSTO_PR(ODUTO_TOTAL), FAMILIA, GRUPO, SUBGRUPO, TIPO, SUBTIPO, EMPRESA, INVENTAR(IO_DATA), TRANSACAO, INVENTARIO_DESCRICAO, ANO, ANOMES; linha 2 com variáveis ${results.*}; callout na célula B1 com diretiva "jx:each(items=SQL_ESTOQUEMENSAL var=results lastCell=P2)" e callout na célula H1 com diretiva "jx:area(lastCell=P2)"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/criacao-tarefa-auditor-xls/criacao-tarefa-auditor-xls-06.png)

---

## Criar uma tarefa com saída em HTML

Para tarefas do tipo **Gráfico** (saída HTML), configure a aba **PARAMETROS** com as variáveis de SQL, opções e filtros:

![Editar Tarefa — aba PARAMETROS com variáveis SQL_PROJETOS (@SQL_PROJETOS, STR), CHART1 (sql/horas_previstas_x_horas_realizadas_chamada_projeto.txt, FSQ), OPTION1 (options/horas_previstas_x_horas_realizadas_chamada_projeto.options, FIL) e PROJETOS (SQL_PROJETOS->ID, STR)](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/criacao-tarefa-auditor-xls/criacao-tarefa-auditor-xls-07.png)

Na aba **MODELO**, selecione **Gráfico** e informe o template HTML:

![Editar Tarefa — aba MODELO com tipo "Gráfico" selecionado; variável CHART1 (CHART1, STR) e TEMPLATE (template/horas_previstas_x_horas_realizadas_chamada_projeto.html, STR)](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/criacao-tarefa-auditor-xls/criacao-tarefa-auditor-xls-08.png)

---

## Criar o arquivo .options

O arquivo `.options` define os valores dos seletores interativos exibidos na tarefa HTML.

**Ferramenta:** `I:\teorema\tp\google drive\publico\qualidade\auditor\exemplos\criador-options.html`

**Passo a passo:**

1. No IB, execute a consulta e acesse **Query columns**; marque **Include column types** e copie os campos separados por `;`.

| Coluna | Tipo |
|---|---|
| ITEM | VARCHAR(64) |
| INVENTARIO_QUANTIDADE | DOUBLE PRECISION |
| CUSTO_MEDIO_TOTAL | DOUBLE PRECISION |
| CUSTO_PRODUTO_TOTAL | DOUBLE PRECISION |
| FAMILIA | VARCHAR(50) |
| GRUPO | VARCHAR(50) |
| SUBGRUPO | VARCHAR(50) |
| TIPO | VARCHAR(30) |
| SUBTIPO | VARCHAR(30) |
| EMPRESA | VARCHAR(57) |
| ANO | SMALLINT |
| ANOMES | VARCHAR(17) |

2. No criador de `.options`, preencha **Nome da tarefa** (sem extensão) e cole as colunas copiadas do IB no campo **Colunas**.

![Criador .options — campo "Nome da tarefa" preenchido com "exemplo" e campo "Colunas" com "ITEM VARCHAR(64); INVEN..." seguido do botão OK](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/criacao-tarefa-auditor-xls/criacao-tarefa-auditor-xls-10.png)

---

## Estrutura do arquivo HTML do modelo

O template HTML utiliza o componente `<teo-advanced-pivot>` com os atributos de binding:

```html
<teo-advanced-pivot
  ng-load="vm.filter.isPivot"
  ng-model="vm.entities['CHART1']"
  columns="options['OPTION1']"
  controller="vm"
  on-double-click="onDoubleClick"
  show-tool-panel="vm.showToolPanel"
  custom-style="vm.customStyle"
>
</teo-advanced-pivot>
```


## Informações do documento

> Autor:
> Setor:
> Módulo:
> Chamado:
> Versão do Sistema:
> Versão do documento:
> Revisão:
> Aprovado em:
---

> 📎 **Arquivos originais:** [criacao_tarefa_auditor_xls.docx](https://drive.google.com/uc?export=download&id=11RxH3aSNLtNVb0UTm6Rb5_AIelFHniSO)