
Passo 1: Solicitar uma chave API em iban-test.de
Para poder verificar um IBAN através da API iban-test.de, precisamos primeiro de um código de autorização correspondente para a API. Para tal, aceda à seguinte página no seu navegador de Internet iban-test.com e clicar no botão Barra de navegação no botão [API].
Introduza agora o seu nome, endereço eletrónico, sítio Web e tipo de utilização na coluna da esquerda. Depois de clicar no botão [Criar chave API] abre-se uma nova janela com o seu código de autenticação para a API. É preferível copiar o código para um editor de texto e guardar o ficheiro.
Passo 2: Criar um subscrito para verificação do IBAN na FileMaker
A API de iban-test.de pode ser acedida através de um pedido HTTP GET/POST normal. Neste passo, criamos um script parcial que se chama ScriptO parâmetro - aceita um IBAN e devolve um 1 (válido) ou um 0 (inválido) como resultado. No nosso ficheiro de exemplo, é apresentada uma caixa de diálogo no final do script que mostra se o IBAN introduzido é válido ou inválido.
Script: ts.IBAN_check
Definir registo de erros [Ligado]
# Parâmetro do guião: IBAN
Definir variável [$iban; Value:Get(ScriptParameter)]
Definir variável [$authcode; value:ibancheck::Authcode]
Definir variável [$type; value:ibancheck:type]
#
Definir variável [$r; Value:MBS("Trace")]
# Preparar a transferência
Definir variável [$authcode; value:MBS("StringEncodeURLComponent"; $authcode; "utf8")]
Definir variável [$type; value:MBS("StringEncodeURLComponent"; $type; "utf8")]
Definir variável [$iban; value:MBS("StringEncodeURLComponent"; $iban; "utf8")]
Definir variável [$curl; Value:MBS("CURL.New")]
Definir variável [$result; value:MBS("CURL.SetOptionpost"; $curl; 1)]
Definir variável [$result; Value:MBS("CURL.SetOptionVerbose"; $curl; 1)]
Definir variável [$result; Value:MBS("CURL.SetOptionURL"; "http://www.iban-test.de/api.php")]
# Definir parâmetros de entrada
Definir variável [$content; valor: "authcode=" & $authcode & "&" & "type=" & $type & "&" & "iban=" & $iban]
Definir variável [$content; value:MBS("String.ReplaceNewline"; $content; 2 )]
Definir variável [$result; Value:MBS("CURL.SetOptionPostFields"; $curl; $content)]
# Iniciar a transferência
Definir variável [$result; Value:MBS("CURL.Perform"; $curl)]
# Controlo dos resultados
Definir variável [$debugText; valor:MBS("String.ReplaceNewline"; MBS("CURL.GetDebugAsText"; $curl); 1)]
Definir variável [$resultText; Value:MBS("String.ReplaceNewline"; MBS("GetResultAsText"; $curl); 1)]
Definir variável [$r; valor:MBS("CURL.Cleanup"; $curl); 1)]
Definir variável [$result; Value:If(PatternNumber($resultText; "200") > 0; 1; 0)]
Definir variável [$result text; value:If($result=0; "invalid"; "valid")]
# Diálogo de ensaio
Mostrar a própria caixa de diálogo ["IBAN" & $result text; "O IBAN introduzido é " & $result text
O script aceita inicialmente o IBAN como um parâmetro de script. Para evitar quaisquer espaços no IBAN, recomenda-se que adicione o comando Substituir($iban; " "; "") para acrescentar.
Introduzir código de autenticação

Preparar a transferência
Na secção do programa Transferência os três parâmetros são definidos para a forma correta e o URL de consulta é definido. No nosso exemplo, o URL
http://www.iban-test.de/api.php
está permanentemente integrado no guião - também pode, naturalmente, ser obtido dinamicamente a partir de um campo.
Iniciar a transferência
Nas partes Definir parâmetros de entrada e Iniciar a transferência os parâmetros são reunidos, os campos são transferidos e a transferência é iniciada. A verificação do resultado verifica se o código de resultado 200 é um IBAN válido ou se é inválido.
Incluímos um diálogo de teste na nossa base de dados de amostra que mostra se o IBAN introduzido é válido ou inválido.
Integração nas suas próprias soluções FileMaker
No nosso script de exemplo, a última linha é o comando
Sair do script atual [Resultado: $result]
Este comando não é necessário para o nosso ficheiro de exemplo. No entanto, se integrar o script incluído na sua solução, recomenda-se que o integre como um script parcial que devolve o valor que indica se o IBAN fornecido é válido ou não. Não se esqueça de remover o diálogo de exemplo durante a integração ;-)
Plugin MBS FileMaker
Esta solução utiliza as funções CURL do MBS Plugin FileMaker. Dica: Até 30 de abril, o plugin MBS FileMaker está disponível como parte do 20º aniversário na K&K Verlag (Revista FileMaker) em Hamburgo, a preços reduzidos. Mais informações sobre o MBS FileMaker Plugin podem ser encontradas na página Sítio Web do fabricante.
Descarregar ficheiro de amostra para FileMaker 12/13
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 Base de dados Gerir. 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.



Isto faz-me lembrar os bons velhos tempos em que escrevíamos listagens para o C=64. Muito obrigado pelo artigo e pelo ficheiro de exemplo :-)
Olá e bom dia,
Estou atualmente a testar este script e recebo um "inválido" para cada IBAN. O script ainda está atualizado?
Aqui poderá ter de verificar se a interface do fornecedor ainda está actualizada ou se foi entretanto alterada.