Kontrola IBAN online pomocí aplikace FileMaker a zásuvného modulu MBS.

Již několik měsíců jsou stará čísla účtů a třídicí kódy v bankovnictví zastaralé - dnes se v bankovnictví používají kouzelná slova IBAN a BIC. Pro vývojáře FileMakeru to znamená implementovat do svých řešení FileMaker nové funkce týkající se IBAN a BIC. Na internetu je již k dispozici řada vlastních funkcí pro výpočet IBAN z třídicího kódu banky a čísla účtu. Vzhledem k nezanedbatelným zvláštním případům při výpočtu IBAN si však nemůžete být vždy jisti, že IBAN byl skutečně vypočten správně pomocí čistého vzorce. Z tohoto důvodu může být užitečné zkontrolovat věrohodnost vypočteného IBAN online, abyste se vyhnuli výpočtu a uložení nesprávného IBAN. V tomto článku si ukážeme, jak lze IBAN zkontrolovat online přímo v aplikaci FileMaker pomocí služby iban-test.de a poskytovaného rozhraní API. Ukázkový soubor uvedený v článku si můžete stáhnout na konci článku v sekci formát fmp12 lze stáhnout. Ukázkový soubor využívá funkce zásuvného modulu MBS FileMaker pro přístup k rozhraní API.

Krok 1: Požádejte o klíč API na iban-test.de

Abychom mohli zkontrolovat IBAN prostřednictvím API iban-test.de, potřebujeme nejprve příslušný autorizační kód pro API. Za tímto účelem vyvolejte ve webovém prohlížeči následující stránku iban-test.com a klikněte na Navigační panel na tlačítku [API].

Nyní do levého sloupce zadejte své jméno, e-mailovou adresu, webovou stránku a typ použití. Po kliknutí na tlačítko [Vytvořit klíč API] otevře se nové okno s vaším autentizačním kódem pro rozhraní API. Kód je nejlepší zkopírovat do textového editoru a soubor uložit.

Krok 2: Vytvoření subskriptu pro kontrolu IBAN v aplikaci FileMaker

Na API iban-test.de se lze obrátit prostřednictvím běžného požadavku HTTP GET/POST. V tomto kroku vytvoříme dílčí skript, který se jmenuje Skript-parametr přijímá IBAN a jako výsledek vrací 1 (platný) nebo 0 (neplatný). V našem ukázkovém souboru se na konci skriptu zobrazí dialog, který ukazuje, zda je zadaný IBAN platný nebo neplatný.

Skript: ts.IBAN_check

Nastavení záznamu chyb [Zapnuto]

# Parametr skriptu: IBAN

Nastavit proměnnou [$iban; Hodnota:Get(ScriptParameter)]

Nastavit proměnnou [$authcode; hodnota:ibancheck::Authcode]

Nastavit proměnnou [$type; value:ibancheck:type]

#

Nastavit proměnnou [$r; Hodnota:MBS("Trace")]

# Připravit přenos

Nastavit proměnnou [$authcode; value:MBS("StringEncodeURLComponent"; $authcode; "utf8")]

Nastavit proměnnou [$type; value:MBS("StringEncodeURLComponent"; $type; "utf8")]

Nastavit proměnnou [$iban; value:MBS("StringEncodeURLComponent"; $iban; "utf8")]

Nastavit proměnnou [$curl; Hodnota:MBS("CURL.New")]

Nastavení proměnné [$result; value:MBS("CURL.SetOptionpost"; $curl; 1)]

Nastavení proměnné [$result; Value:MBS("CURL.SetOptionVerbose"; $curl; 1)]

Nastavení proměnné [$result; Value:MBS("CURL.SetOptionURL"; "http://www.iban-test.de/api.php")]

# Nastavení vstupních parametrů

Nastavit proměnnou [$content; hodnota: "authcode=" & $authcode & "&" & "type=" & $type & "&" & "iban=" & $iban]

Nastavení proměnné [$content; value:MBS("String.ReplaceNewline"; $content; 2 )]

Nastavení proměnné [$result; Value:MBS("CURL.SetOptionPostFields"; $curl; $content)]

# Zahájení přenosu

Nastavit proměnnou [$result; Hodnota:MBS("CURL.Perform"; $curl)]

# Kontrola výsledků

Nastavit proměnnou [$debugText; hodnota:MBS("String.ReplaceNewline"; MBS("CURL.GetDebugAsText"; $curl); 1)]

Nastavit proměnnou [$resultText; Hodnota:MBS("String.ReplaceNewline"; MBS("GetResultAsText"; $curl); 1)]

Nastavit proměnnou [$r; hodnota:MBS("CURL.Cleanup"; $curl); 1)]

Nastavit proměnnou [$result; Hodnota:If(PatternNumber($resultText; "200") > 0; 1; 0)]

Nastavit proměnnou [$result text; hodnota:If($result=0; "invalid"; "valid")]

# Zkušební dialog

Zobrazení vlastního dialogového okna ["IBAN" & $result text; "Zadaný IBAN je " & $result text

Skript zpočátku přijímá IBAN jako parametr skriptu. Aby se zabránilo vzniku mezer v IBAN, doporučuje se přidat příkaz Nahradit($iban; " "; "") doplnit.

Zadejte autentizační kód

Pole Authcode a Type jsou převzata z rozvržení vzorového souboru - než funkci vyzkoušíte, musíte nejprve zadat svůj Authcode do příslušného pole, které jste si vyžádali na webové stránce iban-test.de. U pole Type ponechte výchozí hodnotu zkontrolujte jsou k dispozici. Dalším typem je funkce vytvořit který lze rovněž použít k výpočtu IBAN zadáním kódu banky (&blz=), čísla účtu (&ktn=) a kódu země ($cc=). Postup je stejný jako v našem ukázkovém souboru s tím rozdílem, že místo IBAN je třeba zadat tři zmíněné parametry.

Připravte přenos

V části programu Přenos tři parametry jsou nastaveny do správného tvaru a je nastavena adresa URL dotazu. V našem příkladu je URL

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

je trvale integrován do skriptu - lze jej samozřejmě získat i dynamicky z pole.

Zahájení přenosu

V částech Nastavení vstupních parametrů a Zahájení přenosu parametry se dají dohromady, pole se přenesou a přenos se spustí. Kontrola výsledku zkontroluje, zda je výsledný kód 200 platný IBAN, nebo zda je neplatný.

Do naší vzorové databáze jsme zahrnuli testovací dialog, který ukazuje, zda je zadaný IBAN platný nebo neplatný.

Integrace do vlastních řešení FileMaker

V našem příkladovém skriptu je posledním řádkem příkaz

Ukončit aktuální skript [Výsledek: $result]

Tento příkaz není pro náš ukázkový soubor nutný. Pokud však přiložený skript začleníte do svého řešení, doporučujeme jej začlenit jako dílčí skript, který vrátí hodnotu, zda je zadaný IBAN platný, či nikoli. Nezapomeňte prosím při integraci odstranit dialog příkladu ;-)

Zásuvný modul MBS FileMaker

Toto řešení využívá funkce CURL systému MBS Zásuvný modul FileMaker. Tip: Až do 30. dubna je v rámci 20. výročí k dispozici zásuvný modul MBS FileMaker na adrese K&K Verlag (časopis FileMaker) v Hamburku za zvýhodněné ceny. Další informace o MBS FileMaker Plugin naleznete na stránce Webové stránky výrobce.

Stáhnout ukázkový soubor pro FileMaker 12/13

Jak přenést skripty ze vzorového souboru do řešení

Skripty lze snadno přenášet z jednoho řešení FileMakeru do druhého prostřednictvím schránky. Stačí otevřít dialogové okno Správa skriptůVyberte požadovaný skript myší a zkopírujte jej do schránky pomocí nabídky [Úpravy - Kopírovat] nebo kombinace kláves [Ctrl/Cmd-C]. Poté otevřete stejný dialog v cílovém řešení a jednoduše znovu vložte dříve zkopírovaný skript pomocí příkazu nabídky [Úpravy - Vložit].

Přenos tabulek ze vzorového souboru do řešení

Tabulky lze do stávajícího řešení vložit několika způsoby. Nejjednodušší je importovat Tabulka prostřednictvím tlačítka [Importovat...] v dialogu Databáze Správa. Všechny tabulky, které mají být importovány ze zdrojového řešení, lze poté vybrat v následném dialogu. Tento způsob je proto vhodný zejména v případě, že se má importovat více tabulek najednou. Pokud se má importovat pouze jedna tabulka, lze to provést také prostřednictvím schránky jako skript. Má-li být tabulka importována spolu s daty, lze to provést příkazem [Soubor > Importovat záznamy > Soubor]. V dialogovém okně pro import je cílová tabulka Nová tabulka musí být zadán.

Přenos seznamů hodnot ze vzorového souboru do řešení

Seznamy hodnot lze snadno importovat z jednoho řešení FileMakeru do druhého prostřednictvím schránky. Stačí otevřít dialog v nabídce [Soubor/Soubor > Správa > Seznamy hodnot], vybrat požadovaný seznam hodnot a kliknout na tlačítko [Importovat]. Seznam hodnot myší a zkopírujte seznam hodnot do schránky pomocí nabídky [Úpravy - Kopírovat] nebo kombinace kláves [Ctrl/Cmd-C]. Poté otevřete stejný dialog v cílovém řešení a vložte dříve zkopírovaný seznam hodnot pomocí příkazu nabídky [Úpravy - Vložit].

Jak přenést vlastní funkce z příkladového souboru do řešení

Klikněte na tlačítko [Importovat] v dialogu [Soubor > Správa > Vlastní funkce...] a poté vyberte vzorový soubor. V následujícím dialogu vyberte požadované vlastní funkce a dialog potvrďte. Upozorňujeme, že tato funkce je k dispozici pouze v aplikaci FileMaker Pro Advanced, nikoli však v aplikaci FileMaker Pro.

Markus Schall

Markus Schall vyvíjí od roku 1994 databáze, rozhraní a podnikové aplikace na míru založené na Claris FileMaker. Je partnerem společnosti Claris, držitelem ocenění FMM Award 2011 a vývojářem aplikace Software ERP gFM-Business. Je také autorem knih a zakladatelem organizace M. Schall Publishers.

markus-schall.de