InterSystems Reports. Fórmulas, parâmetros, rótulos

Neste artigo, vamos explorar o uso de parâmetros, fórmulas e rótulos no Logi Report Designer (antigo Logi JReport Designer). Para que servem e como criá-los?

Usando a funcionalidade básica do InterSystems Reports Designer, os parâmetros, as fórmulas e os rótulos, você pode melhorar significativamente os detalhes e o conteúdo informativo do relatório gerado. Além disso, essas ferramentas permitem a automação de alguns dos processos, o que acelera e facilita bastante a criação de relatórios.

Vamos analisar cada ferramenta separadamente.

Os parâmetros são variáveis individualmente configuráveis. Eles podem armazenar tanto dados estáticos quanto dinâmicos. Para um parâmetro dinâmico, você pode configurar sua própria consulta SQL, que será independente da consulta SQL do conjunto de dados principal. Dessa maneira, você pode gerar dados sem criar vários conjuntos de dados, mantendo o design organizado e limpo. Os parâmetros podem ser usados como parte de funções e consultas SQL e também como um indicador independente com a seguinte sintaxe: "@YourParameter". Essa qualidade é simplesmente indispensável quando são necessários dados precisos e detalhados.

Um parâmetro estático é um valor ou uma lista de valores predefinidos usados como uma condição ou um filtro da saída. Um parâmetro estático também pode ser usado em consultas SQL, funções e rótulos usando a mesma sintaxe: "@YourParameter".

As fórmulas são funções totalmente programáveis na linguagem Java. Essa ferramenta poderosa amplia bastante as possibilidades de análise de dados, permitindo que você realize cálculos complexos e defina condições lógicas para os dados gerados. As fórmulas são criadas no IDE para Java dentro do Logi com um conjunto de funções integradas para trabalhar com esses tipos de dados, como Array, Data / Hora, Financeiro, Matemática, String, etc. As fórmulas funcionam com todos os dados disponíveis no InterSystems Reports. O IDE integrado entende parâmetros, campos calculados e até outras fórmulas.

Um rótulo é um widget de texto. Ele serve para mostrar quaisquer variáveis e caracteres em letra minúscula. O propósito dele fala por si mesmo: ele é usado em cabeçalhos e rodapés, como uma legenda personalizada de um gráfico ou uma tabela, em uma palavra e em qualquer lugar onde os dados precisam ter título. Como todas as outras ferramentas do InterSystems Reports, o rótulo é um widget bastante flexível. Ele pode ser colocado em qualquer lugar da página, dentro de um gráfico ou uma tabela.

Vamos conferir exemplos do uso mais básico dessas ferramentas.

Vamos criar um parâmetro que retorna o número de desenvolvedores entre o número total de membros da comunidade InterSystems.

Para criar um parâmetro, você precisa clicar no botão "Catalog Manager" (Gerenciador de catálogo) no canto superior esquerdo da barra de ferramentas.

Na janela exibida, à esquerda, selecione o item "Parameters" (Parâmetros) e clique no botão "New Parameter" (Novo parâmetro) no canto superior esquerdo.

A janela de criação de parâmetros abrirá.

Na primeira linha, precisamos definir o nome do parâmetro. É recomendável escolher um nome que reflita o propósito do parâmetro da maneira mais precisa possível e, ao mesmo tempo, curta o suficiente. Isso é necessário porque, durante o processo de desenvolvimento, você criará uma abundância de parâmetros diferentes, e há risco de sobrecarregar as listas de parâmetros e funções. Neste artigo, vamos analisar o parâmetro dinâmico. Portanto, na segunda linha em "Value Setting" (Configuração do valor), vamos selecionar "Bind with Single Column" (Ligação com coluna única). Na próxima linha "Data Source" (Origem dos dados), vamos escolher a tabela em que será feita a seleção. Em nosso caso, é "Members" (Membros). Depois, em "Bind Column" (Coluna de ligação), vamos selecionar as colunas de que vamos retornar o valor.

Não há uma coluna separada que possa contar o número de desenvolvedores na tabela "Members". Ainda assim, graças à habilidade de definir uma consulta SQL especial, podemos estabelecer uma condição para essa seleção específica. Para fazer isso, role a lista de propriedades para baixo, encontre a linha "Import SQL" (Importar SQL) e clique nela.

Será exibida uma janela para criar a solicitação. Ela já gravou a string de seleção da coluna "members_count" — o número total de participantes. Só precisamos adicionar a condição "where Developer = 1". Podemos verificar a solicitação ao clicar no botão "Check" e, se for bem-sucedida, você deve clicar em "OK".

Após concluir as etapas anteriores, clique em "OK" na janela de criação de parâmetros, e o novo parâmetro "Developer_member" aparecerá no diretório à esquerda. Neste ponto, feche a janela do Catalog Manager e teste o parâmetro recém-criado. Para isso, arraste-o até a página do relatório e clique em "View" (Ver). Depois de concluir esse passo, você precisará aceitar o valor do parâmetro retirado do banco de dados atual, então clique em "OK".

Pronto! Agora podemos ver quantas pessoas na comunidade são desenvolvedores. Essa configuração será atualizada automaticamente sempre que os dados mudarem.

Agora vamos criar uma fórmula. Essa fórmula calculará a porcentagem de desenvolvedores em comparação com o número total de participantes.

Para isso, você precisa repetir os mesmos passos que seguimos ao criar o parâmetro. Vamos relembrá-los. Clique em "Catalog Manager", selecione "Formulas" e "New Formula" no canto superior esquerdo.

Antes que a janela de criação de fórmulas apareça, precisamos inserir um nome para a fórmula.

Depois disso, o IDE abrirá para você escrever código no Java. Integrado ao InterSystems Reports, o compilador permite que você escreva funções curtas sem definir classes e métodos. Para calcular a porcentagem, precisamos dividir nosso novo parâmetro pelo número total de membros e multiplicar por 100. Já criamos o indicador CountTotalMembers. Fizemos isso com a ferramenta chamada InterSystems Adaptive Analytics (com tecnologia da AtScale). Saiba mais aqui (link).

Então, obtemos a seguinte fórmula. Preste atenção na função que permite a escrita de comentários no código. Um código bem documentado facilita o trabalho de outras pessoas com suas fórmulas.

Depois de escrever, você pode conferir se o código resultante tem algum erro ao clicar no botão de marca de seleção na barra de ferramentas. A ferramenta verificará se a sintaxe está correta e se os parâmetros especificos estão presentes.

Após testar a função, ela poderá ser salva. Para fazer isso, clique no botão "Save", e a fórmula aparecerá no catálogo.

Seguindo o exemplo do parâmetro, nossa próxima etapa será arrastar a nova fórmula para dentro da página e encontrar a parcela de desenvolvedores no número total de participantes.

Esta função pode ser utilizada como um indicador para gráficos e tabelas. Vou dar um exemplo de como usar nossa nova fórmula em um gráfico de barras. Saiba mais sobre os gráficos e como criá-los aqui (link).

Neste exemplo, usei uma nova fórmula e derivei a proporção de desenvolvedores nos últimos cinco meses.

É um gráfico de barras, com a fórmula developers_to_members no eixo y e a dimensão month_year_num no eixo x. A tendência ficou bastante visual e fizemos isso em apenas alguns minutos.

Agora é hora de conferir as tabelas.

Elas são incorporadas à página do relatório com o botão "Label", na guia "Insert" (Inserir).

Uma janela para inserir o texto aparecerá na página.

A funcionalidade integrada permite que você edite vários parâmetros para o novo Label. Neste artigo, usamos esse widget para aprimorar nossa nova tabela.

Há vários parâmetros no painel à direita que podem ajudar você a criar um rótulo. Para que eles sejam exibidos, selecione o widget "Label".

Para configurar as bordas do widget, role para baixo até a categoria "Border". Selecione as 4 bordas: "Bottom Line", "Left Line", "Right Line" e "Top Line", e defina todas elas como "Solid".

Para preencher o plano de fundo, você precisa rolar para baixo nas propriedades até a categoria "Color" e escolher o tom desejado. O mesmo pode ser feito na guia "Format" na barra de ferramentas no topo.

Se você quiser selecionar o tamanho da fonte, fique na mesma guia "Format", clique no menu suspenso com tamanhos e escolha a opção desejada. Também é possível definir o tipo de fonte e o local do texto dentro do widget.

Para um posicionamento mais preciso em relação aos outros widgets, use as coordenadas de Label dentro da página. Por padrão, os tamanhos da folha estão em polegadas. As configurações de posicionamento estão na categoria "Geometry" (Geometria) no painel de propriedades do widget, à esquerda.

Neste artigo, tentamos abordar os três recursos básicos do InterSystems Reports (com tecnologia do Logi Report). Por isso, agora, esperamos que você saiba criar fórmulas, parâmetros e rótulos com bastante confiança.