dataset

name	dataset
description	Cria dataset JavaScript para TOTVS Fluig com defineStructure(), createDataset(), try/catch e logging completo. Use quando precisar consultar dados no Fluig, integrar com Protheus via REST, consulta SQL, atualizar dados externos ou dataset com constraints. Suporta: SQL simples, REST Protheus (GET/POST), SQL dinâmico com validação anti-injection.

Consulta MCP

Antes de gerar código, consulte o MCP tbc-knowledge:

searchFluigApi({ category: "dataset" })
// → métodos DatasetFactory, DatasetBuilder, constraints, colunas

searchFluigPatterns({ category: "template", skill: "fluig-dataset" })
// → templates: base, SQL, REST Protheus, constraints

searchFluigPatterns({ category: "naming" })
// → convenção de nomenclatura ds_[acao]_[entidade].js

---

Fluxo de Desenvolvimento

1. Nomear dataset: ds_[acao]_[entidade].js
2. Implementar defineStructure() — define colunas
3. Implementar createDataset() — executa lógica, retorna dados
4. Sempre usar try/catch e logging
5. Testar com fluig-test

---

Instruções para Claude

1. Perguntar antes de gerar: Qual o nome do dataset? Qual a fonte de dados (SQL, REST Protheus, dataset interno)? Quais colunas retornar? Precisa de constraints?
2. Consultar MCP para obter o template correto conforme o tipo de dataset solicitado.
3. Sempre incluir try/catch com log.info na entrada e log.error no catch.
4. Validar inputs em datasets SQL dinâmico — nunca concatenar parâmetros sem sanitização.
5. Nomear corretamente: ds_[acao]_[entidade].js em snake_case.