Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.
To provide a consolidated guide of patterns and best practices for creating and maintaining dashboards, SQL queries, BI parameterization, and UI/UX within the Sankhya ecosystem (JSP/HTML/Java).
When to Use This Skill
This skill should be used when:
The user asks about "boas praticas do sankhya" or "Sankhya best practices".
The user mentions "dashboard sankhya" or is working on a Sankhya BI dashboard.
The user asks for anything related to the word "Sankhya".
The user wants to create or modify code files for Sankhya dashboards.
Core Capabilities
Code Generation & Review: Apply JSP/JSTL patterns and server-side organization to reduce compilation errors and rendering failures.
Visual Consistency: Standardize visual identity in BI components using predefined CSS tokens.
Database Exploration: Structure data exploration queries for performance and correct mapping of Sankhya entities.
BI Construction Guide: Use the HTML5 component flow in BI to ensure correct rendering, reactivity, and navigation.
Patterns
Melhores Práticas de Código
Aplicar padrões de JSP/JSTL e organização server-side para reduzir erros de compilação, falhas de renderização e regressões em dashboards/telas.
Diretrizes de implementação
Declarar diretivas JSP e taglibs obrigatórias no topo do arquivo.
Forçar isELIgnored="false" para habilitar ${...} em tempo de renderização.
Preferir core_rt para JSTL core no ecossistema Sankhya.
Evitar scriptlets Java em JSP; usar JSTL (c:if, c:choose, c:forEach).
Modularizar lógica de negócio (camadas/serviços), evitando acoplamento em arquivo único.
Evitar hardcode de credenciais, URLs sensíveis e tokens.
Modelar estado global da UI (dados, filtros, ordenação, aba ativa) e resetar estado antes de novo carregamento.
Persistir preferências de visualização no localStorage (ordem de colunas e ordenação).
Implementar carregamento sob demanda para abas/modais pesados (lazy-load) para reduzir tempo inicial.
Blindagem de Parâmetros: Sempre definir um valor padrão (fallback) para parâmetros de URL via c:set para evitar Erro 500 no servidor Java do Sankhya.
Separação de Camadas (JSP vs JS): Evitar injetar tags JSP diretamente dentro de blocos <script>. Utilizar containers HTML ocultos para passar dados ao JavaScript, mantendo a saúde do editor de código (IDE Linting).
Os nomes de tabelas e campos abaixo são representativos e podem variar conforme a implementação da instância.
Em TOP versionada, relacionar CODTIPOPER + data de alteração (DHTIPOPER/DHALTER).
Em filtros opcionais, usar padrão (... = :P_PARAM OR :P_PARAM IS NULL).
Parametrizar sempre (evitar literals de usuário).
Os nomes de tabelas e campos abaixo são representativos e podem variar conforme a implementação da instância.
SELECT
CAB.NUNOTA,
CAB.CODPARC,
CAB.DTNEG,
ITE.SEQUENCIA,
ITE.CODPROD,
(ITE.VLRTOT - ITE.VLRDESC) AS VLR_LIQUIDO
FROM TGFCAB CAB
JOIN TGFITE ITE
ON ITE.NUNOTA = CAB.NUNOTA
JOIN TGFTOP TOP
ON TOP.CODTIPOPER = CAB.CODTIPOPER
AND TOP.DHALTER = CAB.DHTIPOPER
WHERE (CAB.CODPARC = :P_CODPARC OR :P_CODPARC ISNULL)
AND (CAB.CODVEND = :P_CODVEND OR :P_CODVEND ISNULL)
SELECT
U.CODUSU,
U.NOMEUSU,
G.NOMEGRUPO,
A.CODREL,
I.NOME AS DESCRICAO_RECURSO,
A.CONS,
A.ALTERA
FROM TSIUSU U
JOIN TSIGRU G ON G.CODGRUPO = U.CODGRUPO
JOIN TSIACI A ON A.CODGRUPO = U.CODGRUPO
JOIN TSIIMP I ON I.CODREL = A.CODREL
WHERE U.CODUSU = :P_CODUSU
ORDERBY I.NOME
Guia do Construtor de BI
Aplicar fluxo de desenvolvimento de componentes HTML5 no BI para garantir renderização, reatividade e navegação entre níveis.
Estrutura e publicação
Empacotar componente em .zip com index.html como entrada principal.
Organizar recursos estáticos em assets/ (CSS, JS, libs, imagens).
Usar XML/design conforme necessidade; considerar JSP de entrada quando houver pré-processamento server-side.
Fluxo de dados e parâmetros
Definir variáveis SQL ou BeanShell conforme complexidade.
Usar prefixos de tradução de parâmetro:
: para bind padrão.
:# para substituição literal (avaliar com cautela e validação).
:@ para literal textual em cenários como LIKE.
Em parâmetros multi-list extensos, usar /*inCollection*/.
Os nomes de tabelas e campos abaixo são representativos e podem variar conforme a implementação da instância.
SELECT
C.CODCID,
C.NOMECID,
C.UF
FROM AD_TABELA_EXEMPLO C
WHERE/*inCollection*/ C.CODCID IN :P_CODCID /*inCollection*/
Reatividade e ciclo de vida
Programar re-render quando filtros globais mudarem.
Evitar dependência exclusiva de DOMContentLoaded em conteúdo injetado.
Aplicar inicialização assíncrona para garantir elementos disponíveis.
<script>functionrenderizarComponente(dados) {
// Atualizar DOM, gráficos e KPIs com os dados recebidos
}
functioniniciar() {
const dadosIniciais = window.snkBIData || [];
renderizarComponente(dadosIniciais);
}
setTimeout(iniciar, 300);
</script>
Drill-down e eventos
Modelar níveis independentes (macro → micro) com argumentos explícitos.
Evitar contêiner vazio em níveis subsequentes.
Usar herança de contexto entre níveis para preservar filtros e navegação.
Implementar ações de clique para atualizar detalhes e abrir telas nativas com chave de contexto.
Navegação multi-nível (openLevel e contrato de contexto)
Definir constantes de nível em configuração (NIVEL_RESUMO, NIVEL_DETALHE, NIVEL_ITEM) para evitar acoplamento em string solta.
Encapsular openLevel em funções dedicadas por rota de navegação (ex.: abrir detalhe por vendedor, abrir itens por parceiro).
Repassar parâmetros de contexto entre níveis com contrato explícito (ARG_* para chaves e P_* para filtros/período).
Validar disponibilidade de openLevel e parâmetros obrigatórios antes de navegar.
Aplicar fallback de erro no console/UI quando o contexto não permitir abertura de nível.
Restringir qualquer consulta de nível pela relação usuário-meta/escopo antes de agregar dados.
Centralizar o predicado de segurança em função de montagem de WHERE para reaproveitamento em KPIs, grids e gráficos.
Preferir variáveis de sessão (CODUSU_LOG ou função equivalente de usuário logado) para evitar spoof de parâmetro de usuário.
Bloquear carga quando parâmetros críticos estiverem ausentes (ex.: período, meta, entidade de drill-down).
Os nomes de tabelas e campos abaixo são representativos e podem variar conforme a implementação da instância.
SELECT
M.CODMETA,
M.CODENTIDADE,
SUM(M.VLRPREV) AS VLR_PREV,
SUM(M.VLRREAL) AS VLR_REAL
FROM AD_DADOS_META M
WHERE M.CODMETA = :P_CODMETA
AND M.DTREF BETWEEN TO_DATE(:P_PERIODO_INI, 'DD/MM/YYYY')
AND TO_DATE(:P_PERIODO_FIN, 'DD/MM/YYYY')
ANDEXISTS (
SELECT1FROM AD_META_USUARIO_LIB L
WHERE L.CODMETA = M.CODMETA
AND L.CODUSU = STP_GET_CODUSULOGADO
)
GROUPBY M.CODMETA, M.CODENTIDADE
Grid hierárquica com expansão/colapso
Estruturar mapa filhosPorPai e estado nosExpandidos para renderização incremental da árvore.
Inicializar nós não analíticos de níveis superiores como expandidos para melhorar leitura inicial.
Em nós colapsados, exibir agregados de descendentes analíticos para manter contexto sem abrir toda árvore.
Fornecer ações rápidas de “Expandir tudo” e “Recolher tudo” no cabeçalho.
Em filtros de texto, incluir ancestrais dos nós encontrados para preservar rastreabilidade hierárquica.
var filhosPorPai = {};
var nosExpandidos = {};
functionalternarNo(codNo) {
var id = String(codNo);
nosExpandidos[id] = !nosExpandidos[id];
renderizarGrid();
}
functionobterVisiveis(raiz) {
var lista = [];
functionvisitar(pai) {
(filhosPorPai[pai] || []).forEach(function (no) {
lista.push(no);
if (nosExpandidos[String(no.CODNO)]) visitar(String(no.CODNO));
});
}
visitar(String(raiz || ""));
return lista;
}
Resiliência de carregamento
Separar a carga principal da carga complementar (ex.: realizado mensal) e não bloquear a visualização principal por falha secundária.
Tratar ausência de dados por componente (vazio) sem derrubar o layout inteiro.
Destruir instâncias de gráfico antes de recriar para evitar vazamento e sobreposição visual.
Carregar painéis secundários somente ao abrir aba/visão correspondente (on-demand).
Navegação intra-nível (single JSP)
Tratar o JSP único como shell de navegação: tabela principal + modal de detalhe + abas internas + modais auxiliares.
Encadear cliques sem trocar de nível Sankhya: KPI → lista modal, gráfico → filtro de tabela, linha da tabela → detalhe.
Aplicar atalhos de ação no detalhe para abrir cadastro nativo no contexto da chave primária.
Fechar modal por clique no overlay para reduzir atrito de uso.
