
Desde há várias gerações, a FileMaker tem sido capaz de aceder diretamente a SQL-fontes de dados como um MySQLBase de dados de uma loja online baseada no xt:Commerce e para ler e escrever dados na mesma. Neste artigo, descrevo como pode utilizar a FileMaker Pro em Mac OS X ou Windows para aceder diretamente a uma base de dados MySQL a partir do xt:Commerce, como pode importar dados do xt:Commerce para a FileMaker e como pode transferir mensagens de estado da FileMaker para o xt:Commerce.
O que é necessário para aceder à base de dados SQL?
Uma fonte de dados SQL externa é acedida através do ODBC-Interface. Para configurar uma fonte de dados ODBC, é necessário um gestor ODBC para Mac OS X. Este pode ser descarregado a partir de www.odbcmanager.net pode ser descarregado gratuitamente como freeware. O ODBC Administrator do Mac OS X também pode ser utilizado no Mac, e o ODBC Manager incluído no sistema pode ser utilizado no Windows.
Além disso, é necessário um conetor ODBC para Mac OS X para aceder à base de dados MySQL do xt:Commerce. Sítio Web da MySQL pode ser descarregado. Para uma ligação de dados estável à base de dados xt:Commerce, é necessário o conetor ODBC na versão mais antiga 3.51.27. A versão DMG para Mac OS X 10.5 (x86, 32-bit) também funciona no Mac OS X 10.6 Snow Leopard sem quaisquer problemas.
Instalando o conetor MySQL ODBC
Antes de se poder configurar a fonte de dados no Gestor ODBC, é necessário instalar o Conector ODBC para MySQL. Uma vez descarregado o programa, o assistente de instalação do Conector ODBC MySQL inicia-se automaticamente:
Depois de ter continuado e aceite as condições da licença, pode selecionar o volume de destino para a instalação e instalar o conetor ODBC no seu sistema.
Durante o processo de instalação, o conetor ODBC é automaticamente instalado no sistema para que o controlador para este conetor esteja disponível da próxima vez que iniciar o Gestor ODBC.
Configurar a fonte de dados ODBC
Depois de o SQL-Connector ter sido descarregado,
De seguida, descrevo como configurar o conetor ODBC com o gestor ODBC para Mac OS X - mais acima no texto existe uma ligação para descarregar este programa. No Windows ou no Mac OS X com outros gestores ODBC, as configurações devem ser efectuadas da mesma forma.
Depois de o ODBC Manager ter sido descarregado e copiado para o diretório de aplicações do Mac OS X, inicie o ODBC Manager fazendo duplo clique no ícone do programa. O programa inicia-se e abre a janela principal do ODBC Manager. As fontes de dados ODBC podem sempre ser configuradas para todo o sistema (DSN do sistema), ou seja, para todos os utilizadores do sistema ou para um utilizador (DSN do utilizador). Na área [Tracing], a utilização da fonte de dados ODBC pode ser registada num registo de texto.
Dependendo de se pretender configurar a fonte de dados para o utilizador ativo ou para todo o sistema, clique no botão [Adicionar...] na área correspondente.
Para o xt:Commerce, selecione a versão 3.51 do controlador MySQL ODBC neste ponto e clique no botão [OK]. Na janela seguinte, introduza todos os dados da sua base de dados MySQL que contém as tabelas de dados da sua loja virtual xt:Commerce.
Depois de ter introduzido todos os dados nos campos correspondentes, clique no botão [Testar] para estabelecer uma ligação através da sua fonte de dados recém-criada e testá-la.

Utilizar a fonte de dados ODBC com a FileMaker
Inicie a FileMaker e abra uma base de dados com a qual pretende estabelecer uma ligação à sua base de dados xt:Commerce. Se já tem uma solução FileMaker para as encomendas da sua loja, é melhor abrir a versão que pretende desenvolver.
Leitura de dados da base de dados xt:Commerce
Para importar dados do xt:Commerce para a FileMaker através da interface ODBC, tudo o que precisa é do familiar comando "Import records" no Scriptmaker. Para os dados do xt:Commerce, recomendo que crie uma imagem do ficheiro original Tabela do xt:Commerce na sua solução. Isto facilita a importação devido aos mesmos nomes de campo, e a sua solução tem a sua própria tabela com todas as encomendas do xt:Commerce.
Criar uma imagem de uma tabela a partir de xt:Commerce
Para criar uma imagem de uma tabela do xt:Commerce no FileMaker, é melhor importar a tabela com os nomes dos campos para a sua solução FileMaker. Na barra de menu do ficheiro FileMaker para o qual pretende importar a tabela, selecione o item
Ficheiro > Importar registos de dados > Fonte de dados ODBC
de. Selecione agora a fonte de dados ODBC do seu servidor SQL configurado no Gestor ODBC com as bases de dados do xt:Commerce e introduza o seu nome de utilizador e palavra-passe para a base de dados MySQL na caixa de diálogo seguinte. Aparece agora a caixa de diálogo Specify ODBC SQL query, na qual pode introduzir um comando SQL a partir de um cálculo ou como texto estático.
Para importar uma tabela inteira para a FileMaker, basta clicar no botão [Criação de consulta...], onde se abre um assistente para criar a consulta SQL.
Na coluna da esquerda, encontrará todas as tabelas que estão localizadas no servidor SQL remoto.Servidor estão localizados. Por exemplo, para importar a tabela "orders" do xt:Commerce, selecionar a tabela "orders" correspondente na coluna da esquerda. Os campos disponíveis da tabela selecionada à esquerda aparecem agora na coluna da direita. Para criar a consulta automaticamente, basta fazer duplo clique em cada campo a ser importado na coluna da direita. Na janela inferior, pode ver como a consulta é criada automaticamente campo a campo. No final, a janela deve ter o seguinte aspeto:
Agora selecione todo o texto (cmd-A) no campo "SQL query", cole-o num documento num editor de texto (por exemplo, Textedit) e guarde o texto, por exemplo, como "SQL_xtC_orders.txt".
Depois de clicar no botão [OK], aparece a caixa de diálogo para atribuição dos campos. Nesta caixa de diálogo, selecione [Nova tabela: "Nome da fonte de dados"] em "Destino". Depois de clicar no botão [Importar], todos os campos selecionados na consulta são criados numa nova tabela e os dados associados são importados. Após a importação, encontrará a tabela na administração da base de dados e pode dar-lhe o nome que desejar, por exemplo, "xtC_orders".
Criar um script para importação de dados do xt:Commerce
Para integrar uma importação de dados na sua solução, abra o Scriptmaker e crie um novo Script. Adicione o comando "Importar registos de dados" ao seu novo script. Agora selecione "ODBC data source" como fonte de dados e selecione a fonte de dados ODBC criada no Gestor ODBC. Introduza agora os seus dados de início de sessão para a base de dados SQL e assinale a caixa "Guardar nome de utilizador e palavra-passe". Depois de clicar no botão [OK], pode agora inserir novamente a consulta SQL como uma fórmula calculada ou como texto. Se, no futuro, apenas pretender importar uma encomenda específica com o seu script, deve criar uma consulta SQL calculada. No nosso exemplo, assumimos que o número da encomenda a importar no campo Variável $orders_id é guardado.
Agora, abra o documento de texto guardado com a consulta SQL. Adicione vírgulas invertidas (") no início e o seguinte comando no final da consulta:
WHERE `orders`.`orders_id` = " & $orders_id
Este comando restringe a importação ao registo de dados cujo campo contém o valor da variável $orders_id. Toda a sua instrução SQL deve agora ser algo como isto:
"SELECT `encomendas`.`tipo_de_conta`, `encomendas`.`id_de_compra_depois`, `encomendas`.`sucesso_de_compra`, pedidos`.`formato_de_endereço_de_faturação`, pedidos`.`cidade_de_faturação`, pedidos`.`empresa_de_faturação`, pedidos`.`país_de_facturação`, pedidos`.`país_de_facturação_iso_code_2`, pedidos`.`nome_de_faturação`, pedidos`.`sobrenome_de_faturação`, pedidos`.`nome_de_faturação`, código postal de faturação, estado de faturação, endereço de rua de faturação, pedidos`.`billing_suburb`, pedidos`.`cc_cvv`, pedidos`.`cc_expires`, pedidos`.`cc_issue`, encomendas`.`cc_number`, encomendas`.`cc_owner`, encomendas`.`cc_start`, encomendas`.`cc_type`, `ordens`.`comentários`, `ordens`.`tipo_conversão`, `ordens`.`moeda`, pedidos`.`valor_da_moeda`, pedidos`.`customers_address_format_id`, pedidos`.`customers_cid`, pedidos`.`cidade_dos_clientes`, pedidos`.`empresa_dos_clientes`, pedidos`.`país_dos_clientes`, pedidos`.`customers_email_address`, pedidos`.`customers_firstname`, pedidos`.`customers_id`, `ordens`.`ip_clientes`, `ordens`.`sobrenome_clientes`, `ordens`.`nome_clientes`, código postal da encomenda, estado da encomenda, estado da encomenda, estado da encomenda, encomendas`.`estado_do_cliente_desconto`, encomendas`.`estado_do_cliente_imagem`, pedidos`.`nome_do_cliente`, pedidos`.`endereço_da_rua`, pedidos`.`customers_suburb`, pedidos`.`customers_telephone`, pedidos`.`customers_vat_id`, pedidos`.`data_compra`, pedidos`.`formato_de_endereço_de_entrega`, pedidos`.`cidade_de_entrega`, encomendas`.`empresa_de_entrega`, encomendas`.`país_de_entrega`, pedidos`.`país_de_entrega_iso_code_2`, pedidos`.`nome_primeiro_entrega`, pedidos`.`nome_de_entrega`, pedidos`.`nome_de_entrega`, pedidos`.`código_postal`, encomendas`.`estado_de_entrega`, encomendas`.`endereço_da_rua`, encomendas`.`bairro`, pedidos`.`referência_do_banco_anseático`, pedidos`.`idioma`, pedidos`.`última_modificação`, pedidos`.`data_de_finalização`, pedidos`.`id_pedido`, pedidos`.`chave_de_identificação`, pedidos`.`status_dos_pedidos`, pedidos`.`classe_de_pagamento`, pedidos`.`método_de_pagamento`, `ordens`.`id_referentes`, `ordens`.`classe_de_envio`, `ordens`.`método_de_envio` FROM `ordens` WHERE `ordens`.`id_ordem` = " & $orders_id
Por exemplo, pode agora fazer com que o seu script solicite o número de encomenda desejado ao utilizador e importar automaticamente a encomenda correspondente para a sua solução FileMaker utilizando um script.
Escrever dados numa tabela de dados SQL
A FileMaker também pode ser utilizada para escrever ou atualizar dados diretamente numa tabela a partir do xt:Commerce via ODBC. O seguinte comando está disponível no Scriptmaker para este fim:
Executar consulta SQL [...]
No exemplo seguinte, criamos um novo registo de dados na tabela orders_status_history do xt:Commerce. As mensagens de estado do xt:Commerce são guardadas nesta tabela, que o cliente também pode normalmente visualizar na área de início de sessão da loja. Um novo registo de dados nesta tabela é criado com o seguinte comando:
Executar consulta SQL [
" INSERT INTO `orders_status_history` (`comments`, `customer_notified`, `date_added`, `id_pedido`, `id_histórico_pedido`, `id_status_pedido`)
VALUES ('" &
"Status text'" & ", 0, '" & xtc_date(Get(SystemDate)) &
"', " & xtcommerce::_Order_No & ", " & "''''" & ", " & "2)"]
Este comando pode ser utilizado diretamente num script, ou pode ser utilizado utilizando uma nova função personalizada (Função personalizada) podem ser encapsulados. O xtc_date é um Função própriaque pode ser definida como uma função separada ou resolvida diretamente no comando do script. A função xtc_date separada converte uma data transferida para o formato em que xt:Commerce espera uma data:
xtc_date (campo de data) =
ReadAsText(YearNumber ( date field ) & "-" & CharacterRight( "0" & MonthNumber (date field); 2) & "-" & CharacterRight( "0" & CalendarDayNumber (campo de data); 2)) & " " & ReadAsText(Get(SystemTime))
Para alterar o próprio estado, o ID do estado correspondente é definido na tabela MySQL <>. No exemplo seguinte, o ID do estado da encomenda é definido como ID "2":
Executar a consulta SQL ["UPDATE `orders` SET `orders_status` = 2 WHERE `orders_id` = " & xtcommerce::_Order_No]
Pode visualizar e editar os IDs de estado dos estados que atribuiu no xt:Commerce no backend do xt:Commerce.
As possibilidades de integração de dados do xt:commerce em conjunto com a FileMaker são praticamente ilimitadas. Tal como os dados de encomendas, os dados de artigos ou endereços do xt:commerce também podem ser utilizados na FileMaker e vice-versa.
Naturalmente, o procedimento descrito neste artigo funciona com qualquer tabela do xt:Commerce e, em princípio, com qualquer outra loja virtual cuja base de dados permita o acesso através do conetor ODBC. Para obter informações pormenorizadas sobre a estrutura da base de dados do sistema da sua loja, recomendo o estudo da documentação técnica relevante.

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.








