Koppelingen overslaan

Controleer IBAN online met FileMaker en de MBS-plugin.

Vraag een authcode aan op iban-test.de

IBAN online controleren met FileMakerSinds enkele maanden zijn de oude rekeningnummers en sorteercodes in het bankwezen achterhaald - IBAN en BIC zijn tegenwoordig de toverwoorden in het bankwezen. Voor FileMaker-ontwikkelaars betekent dit dat ze nieuwe functies met betrekking tot IBAN en BIC in hun FileMaker-oplossingen moeten implementeren. Er zijn al een aantal aangepaste functies beschikbaar op het internet om een IBAN te berekenen op basis van een banksorteercode en rekeningnummer. Door niet onbelangrijke speciale gevallen bij het berekenen van een IBAN, kunt u er echter niet altijd zeker van zijn dat het IBAN daadwerkelijk correct is berekend met een pure formule. Daarom kan het nuttig zijn om de aannemelijkheid van het berekende IBAN online te controleren om te voorkomen dat je een onjuist IBAN berekent en opslaat. In dit artikel tonen we hoe een IBAN rechtstreeks in FileMaker online kan worden gecontroleerd met behulp van de iban-test.de service en de meegeleverde API. Het voorbeeldbestand dat in het artikel wordt getoond, kan aan het einde van het artikel worden gedownload in de fmp12-formaat kan worden gedownload. Het voorbeeldbestand gebruikt functies van de MBS FileMaker plugin voor API-toegang.

Stap 1: Vraag een API-sleutel aan op iban-test.de

Om een IBAN te kunnen controleren via de iban-test.de API, hebben we eerst een bijbehorende autorisatiecode voor de API nodig. Roep hiervoor de volgende pagina op in je webbrowser iban-test.nl en klik in de Navigatiebalk op de knop [API].

Vraag een authcode aan op iban-test.de

Voer nu in de linkerkolom je naam, e-mailadres, website en soort gebruik in. Nadat u op de knop [Maak API-sleutel]. Er wordt een nieuw venster geopend met uw auth-code voor de API. Je kunt de code het beste kopiëren in een teksteditor en het bestand opslaan.

Stap 2: subscript maken voor IBAN-controle in FileMaker

De API van iban-test.de kan worden benaderd via een gewoon HTTP GET/POST-verzoek. In deze stap maken we een gedeeltelijk script aan met de naam Script-parameter accepteert een IBAN en retourneert een 1 (geldig) of een 0 (ongeldig) als resultaat. In ons voorbeeldbestand wordt aan het einde van het script een dialoogvenster weergegeven dat laat zien of het ingevoerde IBAN geldig of ongeldig is.

Script: ts.IBAN_check

Foutopname instellen [Aan]
# Script parameter: IBAN
Stel variabele [$iban; Waarde:Get(ScriptParameter)] in.
Stel variabele [$authcode; waarde:ibancheck::Authcode] in.
Stel variabele [$type; waarde:ibancheck:type] in.
#
Stel variabele [$r; Waarde:MBS("Trace")] in.
# Overdracht voorbereiden
Stel variabele [$authcode; waarde:MBS("StringEncodeURLComponent"; $authcode; "utf8")] in.
Stel variabele [$type; waarde:MBS("StringEncodeURLComponent"; $type; "utf8")] in.
Stel variabele [$iban; waarde:MBS("StringEncodeURLComponent"; $iban; "utf8")] in.
Stel variabele [$curl; Waarde:MBS("CURL.New")] in.
Variabele instellen [$result; waarde:MBS("CURL.SetOptionpost"; $curl; 1)]
Stel variabele [$result; Waarde:MBS("CURL.SetOptionVerbose"; $curl; 1)] in.
Variabele instellen [$result; Waarde:MBS("CURL.SetOptionURL"; "http://www.iban-test.de/api.php")]
# Ingangsparameters instellen
Stel variabele [$content; waarde: "authcode=" & $authcode & "&" & "type=" & $type & "&" & "iban=" & $iban] in.
Stel variabele [$content; Waarde:MBS("String.ReplaceNewline"; $content; 2 )] in.
Variabele instellen [$result; Waarde:MBS("CURL.SetOptionPostFields"; $curl; $content)].
# Start overdracht
Stel variabele [$result; Waarde:MBS("CURL.Perform"; $curl)] in.
# Resultaatcontrole
Stel variabele [$debugText; waarde:MBS("String.ReplaceNewline"; MBS("CURL.GetDebugAsText"; $curl); 1)] in.
Stel variabele in [$resultText; Waarde:MBS("String.ReplaceNewline"; MBS("GetResultAsText"; $curl); 1)].
Stel variabele [$r; waarde:MBS("CURL.Cleanup"; $curl); 1)] in.
Stel variabele [$result; Waarde:Als(PatternNumber($resultText; "200") > 0; 1; 0)] in.
Stel variabele [$result tekst; waarde:If($result=0; "ongeldig"; "geldig")] in.
# Testdialoog
Toon eigen dialoogvenster ["IBAN" & $result tekst; "De ingevoerde IBAN is " & $result tekst

Het script accepteert in eerste instantie de IBAN als scriptparameter. Om spaties in het IBAN te voorkomen, wordt aanbevolen om het commando Vervangen($iban; " "; "") toevoegen.

Voer authcode in

Authcode invoeren in FileMakerDe velden Authcode en Type zijn overgenomen uit de lay-out van het voorbeeldbestand - voordat je de functie test, moet je eerst je Authcode invoeren in het corresponderende veld dat je hebt aangevraagd op de website iban-test.de. Laat voor het type de standaardwaarde staan kijk op beschikbaar zijn. Een ander type is de functie maken dat ook kan worden gebruikt om een IBAN te berekenen door de banksorteercode (&blz=), het rekeningnummer (&ktn=) en de landcode ($cc=) op te geven. De procedure is hetzelfde als in ons voorbeeldbestand, met dit verschil dat de drie genoemde parameters moeten worden opgegeven in plaats van het IBAN.

Overdracht voorbereiden

In het programmadeel Overdracht zijn de drie parameters ingesteld op de juiste vorm en is de query URL ingesteld. In ons voorbeeld is de URL

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

is permanent geïntegreerd in het script - het kan natuurlijk ook dynamisch worden verkregen uit een veld.

Begin overdracht

In de onderdelen Invoerparameters instellen en Begin overdracht de parameters worden samengevoegd, de velden worden overgedragen en de overdracht wordt gestart. De resultaatcontrole controleert of de resultaatcode 200 een geldige IBAN is of dat deze ongeldig is.

We hebben een testdialoog opgenomen in onze voorbeelddatabase die laat zien of het ingevoerde IBAN geldig of ongeldig is.

Dialoog IBAN geldig

Integratie in uw eigen FileMaker-oplossingen

In ons voorbeeldscript is de laatste regel het commando

Verlaat huidig script [Resultaat: $result]

Deze opdracht is niet vereist voor ons voorbeeldbestand. Als je echter het meegeleverde script in je oplossing integreert, is het aan te raden om het te integreren als een deelscript dat de waarde teruggeeft of het geleverde IBAN geldig is of niet. Vergeet niet de voorbeelddialoog te verwijderen tijdens de integratie ;-)

MBS FileMaker-plugin

Deze oplossing gebruikt CURL-functies van de MBS FileMaker-plugin. Tip: Tot 30 april is de MBS FileMaker plugin beschikbaar als onderdeel van de 20e verjaardag op de K&K Verlag (FileMaker Magazine) in Hamburg tegen gereduceerde prijzen. Meer informatie over de MBS FileMaker Plugin is te vinden op de Website van de fabrikant.

Voorbeeldbestand downloaden voor FileMaker 12/13

FileMaker-voorbeeldbestand downloaden

Hoe scripts over te zetten van het voorbeeldbestand naar je oplossing

Scripts kunnen eenvoudig van de ene FileMaker-oplossing naar de andere worden overgezet via het klembord. Open gewoon het dialoogvenster Scripts beherenSelecteer het gewenste script met de muis en kopieer het script naar het klembord met behulp van het menu [Bewerken - Kopiëren] of de toetscombinatie [Ctrl/Cmd-C]. Open vervolgens hetzelfde dialoogvenster in de doeloplossing en plak het eerder gekopieerde script opnieuw met de menuopdracht [Bewerken - Plakken].

Tabellen overbrengen van het voorbeeldbestand naar je oplossing

Tabellen kunnen op verschillende manieren in een bestaande oplossing worden ingevoegd. De eenvoudigste manier is om de Tabel via de knop [Importeren...] in het dialoogvenster Database Beheer. Alle tabellen die geïmporteerd moeten worden uit de bronoplossing kunnen dan geselecteerd worden in een volgende dialoog. Deze methode is daarom bijzonder geschikt als er meerdere tabellen tegelijk geïmporteerd moeten worden. Als er slechts één tabel geïmporteerd moet worden, kan dit ook via het klembord gebeuren, zoals een script. Als een tabel samen met de gegevens geïmporteerd moet worden, kan dit met het commando [Bestand > Records importeren > Bestand]. In de importdialoog wordt de doeltabel Nieuwe tabel moet worden opgegeven.

Om waardenlijsten over te zetten van het voorbeeldbestand naar je oplossing

Waardenlijsten kunnen eenvoudig van de ene FileMaker-oplossing naar de andere worden geïmporteerd via het klembord. Open gewoon het dialoogvenster onder [Bestand/Bestand > Beheer > Waardenlijsten], selecteer de gewenste waardenlijst en klik op [Importeren]. Waardelijst met de muis en kopieer de waardenlijst naar het klembord met behulp van het menu [Bewerken - Kopiëren] of de toetscombinatie [Ctrl/Cmd-C]. Open vervolgens hetzelfde dialoogvenster in de doeloplossing en plak de eerder gekopieerde waardenlijst met de menuopdracht [Bewerken - Plakken].

Hoe je je eigen functies uit het voorbeeldbestand kunt overbrengen naar je oplossing

Klik op de knop [Importeren] in het dialoogvenster [Bestand > Beheren > Aangepaste functies...] en selecteer vervolgens het voorbeeldbestand. Selecteer de gewenste aangepaste functies in het volgende dialoogvenster en bevestig het dialoogvenster. Houd er rekening mee dat deze functie alleen beschikbaar is in FileMaker Pro Advanced, maar niet in FileMaker Pro.

Laat een reactie achter

  1. Dit doet me denken aan de goede oude tijd toen we lijsten typten voor de C=64. Hartelijk dank voor het artikel en het voorbeeldbestand :-)

  2. Hallo en goedendag,

    Ik ben dit script momenteel aan het testen en krijg een "ongeldig" voor elke IBAN. Is het script nog steeds up-to-date?

    1. Hier moet je mogelijk controleren of de interface van de provider nog steeds up-to-date is of dat deze in de tussentijd is gewijzigd.

Deel deze pagina:

ERP-software zo flexibel als uw bedrijf.
We geven je graag advies.

Aanpasbare ERP-software voor Mac, Windows en iOS.

U bevindt zich hier: Instructies: IBAN controleren met FileMaker en de MBS Plugin online