Como configurar relatórios personalizados no Vidya Force

SOLUÇÃO:

Para disponibilizar e configurar relatórios personalizados no aplicativo Vidya Force, siga os procedimentos abaixo:

Acesse o Sankhya e localize a tela Relatórios Formatados. Nesta tela, é possível cadastrar e gerenciar relatórios que poderão ser disponibilizados tanto em outras telas do sistema quanto no aplicativo Vidya Force.

Após confirmar que o relatório desejado já está cadastrado, acesse a tela Configurações - Vidya Force.

Navegue até a aba Relatórios Formatados e clique no botão ➕ (Adicionar).

Selecione o relatório desejado na lista. Após a seleção, será exibida a opção para definir em qual contexto/tela o relatório será disponibilizado dentro do aplicativo.

No aplicativo Vidya Force, os relatórios configurados estarão disponíveis na nova tela inicial (Home), dentro do botão Relatórios.

PARÂMETROS OBRIGATÓRIOS POR TIPO DE RELATÓRIO:

Para que o relatório funcione corretamente no aplicativo, é essencial respeitar o padrão de nomenclatura dos parâmetros, conforme o tipo de informação:

Relatórios de Parceiros: Parâmetro obrigatório P_CODPARC.

Relatórios de Usuários/Vendedores: Parâmetro obrigatório P_CODVEND.

Relatórios de Vendas (Pedidos/Notas): Parâmetro obrigatório PK_NUNOTA.

IMPORTANTE:

O funcionamento do relatório no app depende diretamente da correspondência exata desses parâmetros. Caso estejam divergentes, o relatório não será carregado corretamente.

CONFIGURAÇÃO NO IREPORT:

Ao utilizar o IReport para construção do relatório, é obrigatório garantir que os parâmetros estejam consistentes em dois pontos:

Na query SQL;

No cadastro do parâmetro dentro do layout do relatório.

O nome do parâmetro deve ser idêntico em ambas as configurações, respeitando exatamente a nomenclatura esperada pelo sistema.

DIRETRIZES TÉCNICAS PARA RELATÓRIOS PERSONALIZADOS:

Para garantir o correto funcionamento dos relatórios integrados aos aplicativos da Vidya, é indispensável seguir as diretrizes abaixo:

Tipagem Obrigatória de Parâmetros:

Todos os parâmetros numéricos utilizados no relatório devem ser definidos obrigatoriamente como: java.math.BigDecimal.

Observação: A camada de integração entre os aplicativos Vidya e o Sankhya foi projetada para trabalhar com o tipo java.math.BigDecimal. A utilização de outros tipos (Integer, Long ou Double) pode gerar falhas na execução, retorno de dados inconsistentes ou erros silenciosos.

RESTRIÇÃO NO USO DE USUÁRIO LOGADO:

Não deve ser utilizada, em hipótese alguma, a procedure nativa: STP_GET_CODUSULOGADO.

Motivo técnico: Quando o relatório é executado via aplicativos da Vidya, a autenticação no Sankhya ocorre por meio de um usuário técnico de integração, e não pelo usuário final. Na prática, a procedure sempre retornará o mesmo usuário (usuário Vidya), independentemente de quem esteja acessando o relatório.