
Muitas variantes de diagramas
A solução de código aberto "Chart.js" oferece um total de seis tipos de gráficos diferentes, cada um dos quais pode ser configurado individualmente e permite a interação direta do utilizador.
O Chart.js utiliza tecnologia HTML5 e JavaScript moderna e pode ser executado num visualizador web FileMaker. Os diagramas gerados estão em formato gráfico vetorial SVG e podem ser escalados livremente sem perda de qualidade. O site Charts.js contém documentação extensa sobre como os diagramas também podem ser desenhados de forma interactiva, para que, por exemplo, ao clicar numa parte de um diagrama se abra um visualizador web FileMaker.Script pode ser iniciado.
Encapsular Chart.js na FileMaker
Para poder utilizar as funções da biblioteca JavaScript "Chart.js" na FileMaker, deve primeiro instalar a versão atual do Biblioteca Charts.js no seu computador. A biblioteca Chart.js já está integrada na nossa solução de exemplo, que pode descarregar no final deste artigo. Modificámos a biblioteca aí contida para que os gráficos com valores negativos também possam ser apresentados.
Na nossa solução de exemplo, encapsulámos a biblioteca Chart.js num campo separado (global). O campo <> contém, portanto, simplesmente o código-fonte de todo o ficheiro de texto "Chart.js".
Fonte do diagrama como campos próprios da FileMaker
Se descarregar o pacote completo "Chart.js", encontrará alguns ficheiros HTML de amostra no diretório "samples" que podem ser utilizados para apresentar gráficos de amostra. Para estes ficheiros, que são necessários para exibir o gráfico, a nossa solução FileMaker contém os campos globais <> e <>, cada um dos quais fornece o código fonte para o tipo de gráfico correspondente. Nos códigos-fonte correspondentes, criámos marcadores de posição para todos os valores que pretendemos inserir dinamicamente a partir da FileMaker. Inserimos os seguintes marcadores de posição no código-fonte:
- {javascript} - Espaço reservado para Chart.js, na área entre
- {Largura} - Largura do diagrama
- {Altura} - Altura do diagrama
- {t1} - {t12} - Marcação de texto de 1 a 12 para valores de 1 a 12
- {w1} - {w12} - Valores de 1 a 12
- {vermelho, verde, azul - Valores de cor RGB para as cores do diagrama
O código fonte HTML para exibir o diagrama num visualizador web FileMaker é gerado a partir destes campos com os marcadores de posição que contêm.
Fundir a fonte do gráfico e Chart.js
Para finalmente apresentar o gráfico num visualizador Web da FileMaker, a nossa solução de amostra tem um campo adicional chamado "xLay_Diagramm_Webviewer". O código final do gráfico é gerado neste campo, que consiste no código-fonte do gráfico, no Chart.js e nos dados dinâmicos. Depois de clicar no botão de registo [valor 1], o seguinte script é executado esquematicamente:
Definir valor do campo [xLay_Diagram_Webviewer; Exchange (xGlo_Diagram; Placeholder; Fields/Data)]
Definir variável [$$menuchart; Valor: "Valor 1"]
Escrever dados de modificação/consulta [suprimir; sem caixa de diálogo].
Atualizar a janela [Eliminar resultados de junção, eliminar cache].
No primeiro passo do script, o código-fonte HTML para o visualizador Web é gerado a partir dos campos para o código-fonte do gráfico, Chart.js e os dados dinâmicos. O segundo passo do script define um Variávelque indica que o diagrama "Valor 1" está ativo e é apresentado. Com os dois últimos passos do script, garantimos que os dados são guardados e que a janela atual é actualizada.
Mostrar outros tipos de diagramas
No nosso ficheiro de exemplo, todos os sub-scripts a serem chamados estão num script, que é chamado através dos parâmetros de script correspondentes. Os dois primeiros sub-scripts "valor_do_gráfico_1" e "valor_do_gráfico_2" são utilizados para atualizar o gráfico depois de clicar num botão do separador correspondente. Os dois sub-scripts "bar" e "line" podem ser utilizados para mudar o tipo de gráfico de barras para gráfico de linhas.
No nosso exemplo, é sempre apresentado um total de 12 valores, razão pela qual os códigos fonte têm uma estrutura plana correspondente. Naturalmente, também é possível exibir mais de 12 valores ou exibir várias séries de dados por diagrama. Neste caso, é necessário organizar a substituição dos marcadores de posição dinamicamente, utilizando um marcador de posição para uma linha inteira da série de dados e construindo a série de dados dinamicamente no script. No nosso exemplo, limitamo-nos a uma estrutura plana com 12 valores numa série de dados.
Descarregar a base de dados de amostra FileMaker (.fmp12)
A base de dados de exemplo para este artigo está disponível no formato FileMaker 12 (.fmp12) para FileMaker 12 a 14, o download é gratuito.
Tutorial em vídeo de Matt Petrowski sobre o tema
Matt Petrowski, na sua qualidade de excelente programador FileMaker, publicou um vídeo tutorial de meia hora sobre o tema "Diagramas com FileMaker e JavaScript". No vídeo seguinte ele mostra as possibilidades de diagramas com JavaScript no FileMaker Webviewer em inglês.
Ao carregar o vídeo, o utilizador aceita a política de privacidade do YouTube.
Saiba mais
Muito obrigado a Matt Petrowski e Nick Downie por esta óptima solução!
Como transferir scripts do ficheiro de amostra para a sua solução
Os scripts podem ser facilmente transferidos de uma solução FileMaker para outra através da área de transferência. Basta abrir a caixa de diálogo Gerir guiõesSelecione o script pretendido com o rato e copie-o para a área de transferência utilizando o menu [Editar - Copiar] ou a combinação de teclas [Ctrl/Cmd-C]. Em seguida, abra a mesma caixa de diálogo na solução de destino e simplesmente cole novamente o script copiado anteriormente usando o comando de menu [Editar - Colar].
Para transferir tabelas do ficheiro de amostra para a sua solução
As tabelas podem ser inseridas numa solução existente de várias formas. A maneira mais fácil é importar a tabela Tabela através do botão [Importar...] da caixa de diálogo Gerir a base de dados. Todas as tabelas a importar da solução de origem podem então ser selecionadas num diálogo subsequente. Este método é, portanto, particularmente adequado se várias tabelas tiverem de ser importadas ao mesmo tempo. Se apenas uma tabela tiver que ser importada, isso também pode ser feito através da área de transferência como um script. Se uma tabela tiver de ser importada juntamente com os seus dados, isso pode ser feito com o comando [Ficheiro > Importar registos > Ficheiro]. Na caixa de diálogo de importação, a tabela de destino Nova mesa deve ser especificado.
Para transferir listas de valores do ficheiro de exemplo para a sua solução
As listas de valores podem ser facilmente importadas de uma solução FileMaker para outra através da área de transferência. Basta abrir a caixa de diálogo em [Ficheiro/Arquivo > Gerir > Listas de valores], selecionar a lista de valores pretendida e clicar em [Importar]. Lista de valores com o rato e copiar a lista de valores para a área de transferência utilizando o menu [Editar - Copiar] ou a combinação de teclas [Ctrl/Cmd-C]. Em seguida, abra a mesma caixa de diálogo na solução de destino e cole a lista de valores copiada anteriormente usando o comando de menu [Editar - Colar].
Como transferir as suas próprias funções do ficheiro de exemplo para a sua solução
Clique no botão [Importar] na caixa de diálogo [Ficheiro > Gerir > Funções personalizadas...] e, em seguida, selecione o ficheiro de amostra. Selecione as funções personalizadas desejadas na caixa de diálogo seguinte e confirme a caixa de diálogo. Tenha em atenção que esta função só está disponível na FileMaker Pro Advanced, mas não na FileMaker Pro.

Markus Schall tem vindo a desenvolver bases de dados personalizadas, interfaces e aplicações empresariais baseadas na Claris FileMaker desde 1994. É um parceiro da Claris, vencedor do Prémio FMM 2011 e criador do Software ERP gFM-Business. É também autor de livros e fundador da M. Schall Publishers.




Muito obrigado pela introdução simplificada. Tudo funciona perfeitamente no meu Mac com FM 18 e MacOS 10.15.1. Actualizei o Chart.js para a versão 2.9.1. No entanto, no ambiente Windows, os gráficos só são exibidos no Internet Explorer. Alguma ideia?
O problema só ocorre em relação à FileMaker ou também não funciona noutros navegadores de um sítio Web normal?
Muito obrigado pelas óptimas instruções e pela base de dados de exemplo. O que é que tenho de alterar no código para obter um gráfico de rosca em vez de um gráfico de barras ou de linhas? Se eu simplesmente substituir "window.myBar = new Chart(ctx).Bar(barChartData, options);" por "window.myBar = new Chart(ctx).doughnut(barChartData, options);", infelizmente não funciona...
Olá e obrigado pelo vosso interesse! Apenas um palpite: talvez os dados tenham de ser preparados de forma um pouco diferente para o outro tipo de diagrama?