As tags permitem incluir informações do ERP MAXIPROD em relatórios personalizados. Durante a geração do relatório, cada tag é substituída automaticamente pelo valor correspondente ao registro consultado.
Embora o dicionário de tags apresente todas as propriedades disponíveis, compreender como elas são estruturadas facilita a escolha da tag correta e ajuda a identificar por que determinadas informações podem não ser exibidas no relatório.
Esta página mostra:
- Como interpretar uma tag
- Por que uma tag pode não retornar informações?
- Como escolher a tela correta para criar o relatório?
- Entenda os relacionamentos entre os registros
- Utilização de anexos
Como interpretar uma tag
As tags representam o caminho percorrido pelo sistema até encontrar uma determinada informação.
Exemplo da nova versão:
[[OrdensDeProducao.Reservas.DestinoItemDoPedidoDeVenda.PedidoDeVenda.Cliente.RazaoSocial]]
Nesse caso, a leitura da tag pode ser interpretada da seguinte forma:
- OrdensDeProducao: registro principal do relatório.
- Reservas: reserva vinculada à ordem de produção.
- DestinoItemDoPedidoDeVenda: item do pedido reservado.
- PedidoDeVenda: pedido de venda relacionado.
- Cliente: cliente do pedido.
- RazaoSocial: informação que será exibida.
Para saber mais sobre tags de relatórios e como consultá-las na nova versão do sistema, clique aqui.
Exemplo da antiga versão:
[[OrdemProducao.Reserva.ItemPedidoVenda.PedidoVenda.Cliente.RazaoSocial]]
Nesse caso, a leitura da tag pode ser interpretada da seguinte forma:
- OrdemProducao: registro principal do relatório.
- Reserva: reserva vinculada à ordem de produção.
- ItemPedidoDeVenda: item do pedido reservado.
- PedidoVenda: pedido de venda relacionado.
- Cliente: cliente do pedido.
- RazaoSocial: informação que será exibida.
Ao compreender essa estrutura, torna-se mais simples localizar outras informações no dicionário de tags.
Por que uma tag pode não retornar informações?
Uma tag somente retorna um valor quando todas as informações presentes em seu caminho existem no registro consultado.
Alguns exemplos:
- Tags de pedido de venda somente retornam informações quando existe um pedido relacionado ao registro. Para localizar esses registros, utilize telas como: “Pedido de venda“, “Itens dos pedidos de venda“, “Notas fiscais” (quando houver um pedido relacionado à nota), “Propostas de venda” (quando houver um pedido relacionado à proposta), entre outras.
- Tags de reserva dependem da existência de uma reserva. Para localizar esses registros, utilize telas como: “Ordens de produção“, “Pedido de venda“, “Pedido de compra“, entre outras, desde que haja reservas relacionadas aos itens. Para saber mais sobre reservas, clique aqui.
- Tags de lote somente retornam informações quando houver movimentação de lotes. Para localizar esses registros, utilize telas como: “Estoque“, “Movimentação de estoque“, “Ordens de produção“, entre outras, desde que haja lotes vinculados aos itens/estoques.
- Tags de anexos dependem da existência de anexos cadastrados e habilitados para utilização em relatórios. Para saber mais sobre anexos e sua usabilidade, clique aqui.
Caso alguma dessas informações não exista, a tag será apresentada em branco no relatório.
As tags também possuem dicionários específicos. A utilização de tags de ordens de produção em um relatório para tela de pedidos pode gerar inconsistência e/ou não retornar dados.
Como escolher a tela correta para criar o relatório?
A tela em que o relatório é criado determina quais informações estarão disponíveis por meio das tags. Isso ocorre porque cada tela possui um registro principal e relacionamentos próprios com outros registros do sistema.
Antes de criar ou alterar um relatório personalizado, identifique quais informações deseja exibir e consulte o dicionário de tags da tela em que o relatório será utilizado. O dicionário apresenta todas as informações disponíveis para aquele contexto, os relacionamentos existentes e o caminho necessário para acessar cada dado.
Alguns exemplos:
- Tags de Pedido de Venda: somente retornam informações quando existe um pedido relacionado ao registro. Essas informações podem ser acessadas em telas como Pedidos de Venda, Itens dos Pedidos de Venda, Notas Fiscais (quando houver um pedido vinculado à nota) e Propostas de Venda (quando houver um pedido originado da proposta).
- Tags de Reserva: dependem da existência de uma reserva vinculada ao registro. Elas podem ser utilizadas em telas como Ordens de Produção, Pedidos de Venda, Pedidos de Compra e outras que possuam reservas relacionadas aos itens. Para saber mais sobre reservas, clique aqui.
- Tags de Lote: somente retornam informações quando houver movimentação de lotes. Elas podem ser utilizadas em telas como Estoque, Movimentações de Estoque e Ordens de Produção, desde que existam lotes vinculados aos itens ou estoques.
- Tags de Anexos: dependem da existência de anexos cadastrados e habilitados para uso em relatórios. Para saber mais sobre anexos e sua utilização, clique aqui.
- Tags de Ordem de Produção: somente retornam informações quando o registro estiver relacionado a uma ordem de produção. Elas podem ser utilizadas em telas como Ordens de Produção, Apontamentos, Movimentações de Estoque (originadas da ordem) e outras que possuam esse relacionamento.
- Tags de Nota Fiscal: dependem da existência de uma nota fiscal vinculada ao registro. Essas informações podem ser acessadas em telas como Notas Fiscais, Itens das Notas Fiscais, Contas a Receber e Contas a Pagar, quando houver vínculo entre os registros.
- Tags de Cliente: estão disponíveis apenas em registros que possuam relacionamento com um cliente. Exemplos incluem Pedidos de Venda, Propostas de Venda, Notas Fiscais, Contas a Receber e outras telas que armazenem essa informação.
A estrutura das tags também ajuda a entender como o sistema obtém as informações. Tags com vários níveis de relacionamento indicam que o dado depende da existência desses registros relacionados.
Por exemplo, um relatório criado na tela de Propostas de Venda não possui acesso direto às movimentações de estoque, pois propostas não geram esse tipo de movimentação. Nesse caso, o ideal é criar o relatório em uma tela que possua relacionamento com essas informações, como Pedidos de Venda ou Notas Fiscais.
Se a informação desejada não estiver disponível no dicionário de tags da tela atual, verifique se existe outra tela mais adequada para a criação do relatório ou se há algum relacionamento que permita acessar esse dado.
Entenda os relacionamentos entre os registros
As tags seguem os relacionamentos existentes entre os registros do sistema. Por isso, uma informação só poderá ser acessada se houver um vínculo entre o registro principal da tela e o dado desejado.
Uma mesma informação também pode ser acessada por caminhos diferentes, dependendo de como os registros estão relacionados. Por exemplo, em uma Ordem de Produção, as informações de um Pedido de Venda podem estar disponíveis por meio de uma Reserva. Nesse caso, a tag deverá seguir esse relacionamento para localizar o pedido.
Ao criar um relatório, identifique primeiro quais registros estão relacionados e consulte o dicionário de tags para encontrar o caminho adequado até a informação desejada. Se não existir um relacionamento entre os registros, a tag não retornará nenhum valor.
Utilização de anexos
Além de informações textuais, numéricas e datas, também é possível utilizar anexos em relatórios personalizados por meio de tags específicas.
Os anexos são arquivos vinculados ao cadastro do item e podem ser inseridos automaticamente nos relatórios durante sua geração. Essa funcionalidade é útil para incluir documentos como certificados, fichas técnicas, desenhos, imagens ou outros arquivos relacionados ao item.
Para que um anexo possa ser utilizado em um relatório, ele deve estar cadastrado no item e configurado para permitir sua utilização nos tipos de relatório desejados.
Após essa configuração, basta localizar a tag correspondente no dicionário de tags da tela em que o relatório será criado e inseri-la no modelo utilizando o formato:
[[...Anexos]:sim]
Exemplo de utilização na nova versão:
[[OrdemProducao.ItemPedidoVenda.PedidoVenda.Anexos]:sim]
Para saber como cadastrar anexos, habilitá-los para utilização em relatórios e consultar exemplos de uso na nova versão, clique aqui.
Exemplo de utilização na antiga versão:
[[Anexos]:sim]
Para saber como cadastrar anexos, habilitá-los para utilização em relatórios e consultar exemplos de uso na antiga versão, clique aqui.
Durante a geração do relatório, o sistema substituirá a tag pelos anexos vinculados ao item, desde que atendam às configurações definidas para utilização em relatórios.
Em caso de dúvidas, entre em contato com o suporte.
Veja também: