Sauter les liens

Vérifier l'IBAN en ligne avec FileMaker et le plugin MBS.

Demande d'Authcode sur iban-test.fr

Vérifier l'IBAN en ligne avec FileMakerDepuis quelques mois, les anciens numéros de compte et codes bancaires ont fait leur temps dans le secteur bancaire - IBAN et BIC sont aujourd'hui les mots magiques dans la banque. Pour les développeurs FileMaker, cela signifie implémenter de nouvelles fonctions relatives à l'IBAN et au BIC dans leurs solutions FileMaker. Quelques fonctions personnalisées sont déjà disponibles sur Internet pour calculer un IBAN à partir d'un code bancaire et d'un numéro de compte. En raison de cas particuliers non négligeables lors du calcul d'un IBAN, il n'est toutefois pas toujours possible de s'assurer avec une simple formule que l'IBAN a effectivement été calculé correctement. C'est pourquoi il peut être utile de vérifier en ligne la plausibilité de l'IBAN calculé, afin de ne pas calculer et enregistrer un IBAN erroné. Dans cet article, nous montrons comment le service iban-test.de permet de vérifier un IBAN directement en ligne dans FileMaker grâce à l'API mise à disposition. Le fichier d'exemple présenté dans l'article peut être téléchargé à la fin de l'article, dans la section format fmp12 peut être téléchargé. Pour l'accès à l'API, le fichier d'exemple utilise des fonctions du plug-in MBS FileMaker.

Étape 1 : Demander une clé API sur iban-test.fr

Pour pouvoir vérifier un IBAN via l'API d'iban-test.de, nous avons d'abord besoin d'un code d'autorisation correspondant pour l'API. Pour ce faire, appelez dans votre navigateur web la page iban-test.fr et cliquez sur le bouton Barre de navigation sur le bouton [API].

Demande d'Authcode sur iban-test.fr

Indiquez maintenant dans la colonne de gauche votre nom, votre adresse e-mail, votre site web et le type d'utilisation. Après avoir cliqué sur le bouton [Créer une clé API] une nouvelle fenêtre s'ouvre, qui contient votre code d'autorisation pour l'API. Le mieux est de copier le code dans un éditeur de texte et d'enregistrer le fichier.

Étape 2 : Créer un sous-script pour la vérification de l'IBAN dans FileMaker

L'API de iban-test.fr peut être contactée par une requête HTTP GET/POST ordinaire. Dans cette étape, nous allons créer un sous-script qui sera appelé Script-accepte un IBAN et renvoie comme résultat un 1 (valide) ou un 0 (non valide). Dans notre fichier d'exemple, une boîte de dialogue s'affiche à la fin du script pour indiquer si l'IBAN saisi est valide ou non.

Script : ts.IBAN_vérification

Définir l'enregistrement des erreurs [Activé]
# Paramètres de script : IBAN
Définir la variable [$iban ; Valeur:Obtenir(ScriptParameter)]
Définir la variable [$authcode ; valeur:ibancheck::Authcode]
Définir la variable [$type ; Valeur:ibancheck:type]
#
Définir la variable [$r ; Valeur:MBS("Trace")]
# Préparer le transfert
Définir la variable [$authcode ; Valeur:MBS("StringEncodeURLComponent" ; $authcode ; "utf8")]
Définir la variable [$type ; Valeur:MBS("StringEncodeURLComponent" ; $type ; "utf8")]
Définir la variable [$iban ; Valeur:MBS("StringEncodeURLComponent" ; $iban ; "utf8")]
Définir la variable [$curl ; Valeur:MBS("CURL.New")]
Définir la variable [$result ; Valeur:MBS("CURL.SetOptionpost" ; $curl ; 1)]
Définir la variable [$result ; Valeur:MBS("CURL.SetOptionVerbose" ; $curl ; 1)]
Définir la variable [$result ; Valeur:MBS("CURL.SetOptionURL" ; "http://www.iban-test.de/api.php")]
# Définir les paramètres d'entrée
Définir la variable [$content ; valeur : "authcode=" & $authcode & "&" & "type=" & $type & "&" & "iban=" & $iban]
Définir la variable [$content ; Valeur:MBS("String.ReplaceNewline" ; $content ; 2 )]
Définir variable [$result ; Valeur:MBS("CURL.SetOptionPostFields" ; $curl ; $content)]
# Démarrer le transfert
Définir la variable [$result ; Valeur:MBS("CURL.Perform" ; $curl)]
# Contrôle des résultats
Définir variable [$debugText ; Valeur:MBS("String.ReplaceNewline" ; MBS("CURL.GetDebugAsText" ; $curl) ; 1)]
Définir variable [$resultText ; Valeur:MBS("String.ReplaceNewline" ; MBS("GetResultAsText" ; $curl) ; 1)]
Définir variable [$r ; Valeur:MBS("CURL.Cleanup" ; $curl) ; 1)]
Définir la variable [$résultat ; Valeur:Si(NombreModèle($resultText ; "200") > 0 ; 1 ; 0)]
Définir la variable [$texte du résultat ; Valeur:Si($résultat=0 ; "non valide" ; "valide")].
# Dialogue de test
Afficher sa propre boîte de dialogue ["IBAN" & $ergebnistext ; "L'IBAN saisi est " & $ergebnistext

Le script accepte d'abord l'IBAN comme paramètre de script. Pour éviter d'éventuels espaces dans l'IBAN, il est conseillé d'ajouter la commande Échanger($iban ; " " ; "") à ajouter.

Saisir le code d'accès

Saisir le code d'autorisation dans FileMakerLes champs Authcode et Type sont tirés de la mise en page du fichier exemple - avant de tester la fonction, vous devez donc d'abord saisir votre Authcode dans le champ correspondant, que vous avez demandé sur le site iban-test.de. Pour le type, veuillez laisser la valeur prédéfinie check sont disponibles. Un autre type est la fonction create qui permet de calculer un IBAN en indiquant le code bancaire (&blz=), le numéro de compte (&ktn=) et le code de pays ($cc=). La procédure est la même que dans notre fichier d'exemple, à la différence que les trois paramètres mentionnés doivent être fournis au lieu de l'IBAN.

Préparer le transfert

Dans la partie programme Transfert les trois paramètres sont mis dans la forme correcte et l'URL de la requête est définie. Dans notre exemple, l'URL

http://www.iban-test.de/api.php

intégrée de manière fixe dans le script - elle peut bien sûr aussi être obtenue de manière dynamique à partir d'un champ.

Démarrer le transfert

Dans les parties Définir les paramètres d'entrée et Démarrer le transfert les paramètres sont assemblés, les champs sont transférés et le transfert démarre. Dans le contrôle des résultats, on vérifie si le code résultat 200 correspond à un IBAN valable ou s'il n'est pas valable.

Dans notre exemple de base de données, nous avons inséré une boîte de dialogue de test qui indique si l'IBAN saisi est valide ou non.

Dialogue IBAN valable

Intégration dans vos propres solutions FileMaker

Dans notre exemple de script, la dernière ligne est la commande

Quitter le script en cours [résultat : $résultat]

Cette commande n'est pas nécessaire pour notre fichier d'exemple. Mais si vous intégrez le script contenu dans votre solution, il est recommandé de l'intégrer en tant que script partiel qui renvoie comme valeur si l'IBAN fourni est valable ou non. Lors de l'intégration, n'oubliez pas de supprimer le dialogue d'exemple ;-)

Plugin MBS FileMaker

Cette solution utilise les fonctions CURL de MBS Plugin FileMaker. Astuce : Jusqu'au 30 avril, le plugin MBS FileMaker est disponible dans le cadre du 20e anniversaire auprès du K&K Verlag (Magazine FileMaker) à Hambourg à des prix réduits. Vous trouverez plus d'informations sur le plugin MBS FileMaker sur le site Site web du fabricant.

Télécharger le fichier d'exemple pour FileMaker 12/13

Télécharger le fichier d'exemple FileMaker

Pour transférer des scripts du fichier d'exemple dans votre solution, procédez comme suit

Les scripts peuvent être facilement transférés d'une solution FileMaker à une autre via le presse-papiers. Il suffit d'ouvrir la boîte de dialogue Gérer les scriptsSélectionnez le script souhaité avec la souris et copiez le script dans le presse-papiers par le menu [Edition - Copier] ou la combinaison de touches [Ctrl/Cmd-C]. Ouvrez ensuite la même boîte de dialogue dans la solution cible et collez simplement le script précédemment copié avec la commande de menu [Edition - Coller].

Pour transférer des tableaux du fichier d'exemple dans votre solution, procédez comme suit

Les tableaux peuvent être insérés de plusieurs manières dans une solution existante. La manière la plus simple est d'importer les Tableau en cliquant sur le bouton [Importer...] dans la boîte de dialogue Base de données gérer. Dans la boîte de dialogue qui suit, il est possible de sélectionner tous les tableaux qui doivent être importés de la solution source. Cette méthode est donc particulièrement adaptée lorsque plusieurs tableaux doivent être importés en même temps. Si un seul tableau doit être importé, il est possible de le faire via le presse-papiers, comme un script. Si une table doit être importée avec toutes ses données, cela peut se faire avec la commande [Fichier > Importer des enregistrements > Fichier]. Dans la boîte de dialogue d'importation, il faut alors choisir comme table cible Nouveau tableau doit être indiqué.

Pour transférer des listes de valeurs du fichier d'exemple vers votre solution, procédez comme suit

Les listes de valeurs peuvent être facilement importées d'une solution FileMaker à une autre via le presse-papiers. Il suffit d'ouvrir la boîte de dialogue sous [Fichier > Gérer > Listes de valeurs], de sélectionner la liste de valeurs souhaitée et de cliquer sur le bouton "Ajouter". Liste de valeurs avec la souris et copiez la liste de valeurs dans le presse-papiers par le menu [Edition - Copier] ou la combinaison de touches [Ctrl/Cmd-C]. Ouvrez ensuite la même boîte de dialogue dans la solution cible et collez la liste de valeurs précédemment copiée avec la commande de menu [Edition - Coller].

Pour transférer vos propres fonctions du fichier d'exemple dans votre solution, procédez comme suit

Dans la boîte de dialogue [Fichier > Gérer > Fonctions propres...], cliquez sur le bouton [Importer] et sélectionnez ensuite le fichier exemple. Dans la boîte de dialogue suivante, sélectionnez les fonctions personnalisées souhaitées et confirmez la boîte de dialogue. Veuillez noter que cette fonction n'est disponible que dans FileMaker Pro Advanced, et non dans FileMaker Pro.

Laisser un commentaire

  1. Cela me rappelle le bon vieux temps où nous tapions des listings pour le C=64. Merci beaucoup pour l'article et le fichier d'exemple :-)

  2. Bonjour et bonne journée,

    je suis en train de tester ce script et j'obtiens un "invalide" en retour pour chaque IBAN. Le script est-il toujours d'actualité ?

    1. Ici, vous devriez éventuellement vérifier si l'interface du fournisseur est encore actuelle ou si elle a été modifiée entre-temps.

Partager cette page :

Un logiciel ERP aussi flexible que votre entreprise.
Nous nous ferons un plaisir de vous conseiller.

Logiciel ERP personnalisable pour Mac, Windows et iOS.

Vous êtes ici : Instructions : Vérifier l'IBAN en ligne avec FileMaker et le plugin MBS