FMK2018-FileMaker und JSON/REST by Bernhard Schulz schubec.com

9. FileMaker Konferenz | Liechtenstein | 17.-20. Oktober 2018
www.filemaker-konferenz.com
Die Schnittstelle zum REST der Welt

DI (FH) DI Bernhard Schulz

www.schubec.com
FileMaker und JSON/REST

FileMaker und JSON/REST by Bernhard Schulz / schubec.com
Über den Sprecher
• FM Konferenz Verein

• Inhaber und Geschäftsführer der schubec GmbH

• Studium Telekommunikationstechnik

• Studium Informationstechnologien

• FileMaker seit 21 Jahren

• SQL (MySQL)

• NoSQL (MongoDB)

• Java

• Play Framework

• GWT

• PHP

• Websecurity

• Netzwerktechnik

Vortragsziel
• Was ist REST?

• Was ist JSON?

• Was ist CURL?

• REST Anfragen mit FileMaker Client stellen und Antworten verarbeiten

• FileMaker Server und die neue auf REST basierende Data API

• Steuerung der FileMaker Server Admin Console per REST

• Dieser Vortrag gibt einen Überblick - Details zu JSON im Anschluss, Vortrag
von Thomas Hirt

REST? Was ist das?
• Steht für Representational State Transfer

• https://de.wikipedia.org/wiki/Representational_State_Transfer

• FMK2017 - REST mobil- die andere Serververbindung by Volker Krambrich

• https://de.slideshare.net/fmkonferenz/fmk2017-rest-mobil-die-andere-
serververbindung-by-volker-krambrich

Programmierparadigma
• Verteilte Systeme / Webservices

• Einheitliche Schnittstellen

• Schwerpunkt auf Maschine-zu-Maschine-Kommunikation

Quelle: Wikipedia

JavaScript Object Notation (JSON)
• Die JavaScript Object Notation ist ein kompaktes Datenformat in einer einfach
lesbaren Textform zum Zweck des Datenaustauschs zwischen Anwendungen.

Quelle: Wikipedia
{
"nachricht" : "Hallo FileMaker Konferenz 2018!"
}

JSON und REST
• Gehören für uns einfach zusammen

JSON und REST
• REST

• Wie werden die Daten übertragen?

• zu welchem Server?

• zu welcher Ressource?

• welches Protokoll?

• http

• https

• Lesen oder schreiben?

• JSON

• Die Daten selbst

• Strukturiert aufbereitet

• Die Gegenseite muss den Aufbau der Daten kennen/verstehen

JSON und REST
curl 'https://postman-echo.com/time/add?
timestamp=2018-10-18&years=100'
{ "sum" : "Tue Oct 18 2118 00:00:00 GMT+0000" }

Tools

Postman
• Kostenlose Software zum Experimentieren mit JSON/REST

• (kann noch viel viel viel mehr!)

• https://www.getpostman.com

REST Grundlagen

JSON und REST

Wie und mit wem kommunizieren wir?
HTTP Protokoll
https - verschlüsselt
Server: postman-echo.com

Welche Ressource nutzen wir?
Ressource "time/add"

Was wollen wir tun?
GET
POST
PUT
DELETE
...

Was wollen wir tun?
• GET

• Daten lesen

• Es wird am Server nichts geändert

• POST

• Daten NEU anlegen

• Am Server wird etwas geändert (zB neuer Datensatz angelegt)

• PUT

• Daten editieren

• DELETE

• Daten löschen
Ausnahmen bestätigen die Regel!
Es gibt weitere Methoden wie PATCH,
HEAD, OPTIONS, etc.

Welche Parameter übergeben wir?
1.Parameter "timestamp"
2.Parameter "years"

Parameter
1.Welche Parameter gibt es?
2.Wie sind die Parameter aufgebaut?

Rückgabe
1.Was erhalte ich als Antwort im Normalfall?
2.Was erhalte ich als Antwort im Fehlerfall?
3.Wie ist die Antwort aufgebaut?

Authentifizierung
• Benutzername und Passwort?

• Tokens?

• Cookies?

Lösung: OpenAPI Specification
• https://swagger.io/specification/

Swagger

XML / SOAP

Kennen wir das nicht schon alles?
• SOAP / WSDL

• SOAP ist "schwer"

• WSDL ist ein überprüfbarer Vertrag

• Beispiele: http://www.crcind.com/csp/samples/SOAP.Demo.cls

SOAP/WSDL vs JSON/REST

Was ist besser?
Mac oder Windows?

Bananen oder Orangen?

Schwarz oder weiß?

kommt drauf an...

SOAP
• Einfache Alternative zu ähnlichen Verfahren wie SOAP und WSDL

Quelle: Wikipedia

JSON/REST Live Demo

Im Anschluss Screenshots für zu Hause

Beispiele

Beispiel mit Authentifizierung
• OAuth, siehe

• FileMaker als Kommunikationszentrale by schubec - Bernhard Schulz

• https://de.slideshare.net/schubec/fmk2011-file-maker-als-
kommunikationszentrale-by-schubec-bernhard-schulz

• JSON Web Token

• Username / Passwort

• Authentifizierungsinformationen werden meistens im Header mitgesende

JSON/REST in FileMaker

JSON-Nutzung in FileMaker
• JSON Lesen & Schreiben ab FileMaker 16

• davor mit Plugins oder "Handarbeit"

• JSONSetElement / JSONGetElement & Co

JSON-Nutzung in FileMaker
• JSON Datentypen

JSON in FileMaker
• Details: Siehe Vortrag von Thomas Hirt

• 14 Uhr

• Raum hgi systems IT

cURL Nutzung in FileMaker
• CURL mit erweiterten Funktionen ab FileMaker 17

• FileMaker 16 nur eingeschränkt oder mit Plugins

• davor nur mit Plugins

cURL Optionen
• https://fmhelp.filemaker.com/help/17/
fmp/en/index.html#page/FMP_Help/
curl-options.html

• Die Dokumentation ist schlecht, denn
sie lässt viele Fragen offen

• Ausprobieren!

cURL Optionen
• FileMaker ist eine Zicke!
Keine einfachen Hochkommata!

Beispiele aus der Praxis

Livedemo und Screenshots für zu Hause

FileMaker und mobile.de
• Fahrzeuge inkl. Fotos werden in FileMaker verwaltet

• Upload zu online Autobörsen

• Autoscout24

• mobile.de

• https://services.mobile.de/docs/seller-api.html
Mit freundlicher Genehmigung von

• Früher

• CSV Upload per FTP

• Jetzt

• JSON/REST-Schnittstelle

• Vorteil

• Update einzelner Fahrzeuge möglich

Rechnungsmerkmale auslesen

Links zum Nachlesen
https://www.bludelta.ai

Rechnung in Online Buchhaltung laden

vatlayer

FileMaker Script zum
Nachprogrammieren
(Es sind keine cURL Optionen erforderlich)
• API Key

• kostenlos bei https://vatlayer.com registrieren
FileMaker Feld „UID“

JSON in FileMaker

Weitere Einsatzmöglichkeiten

JSON + Virtual List
• https://filemakerhacks.com/2017/07/27/json-virtual-list/

FileMaker JSON Script Parameters
• https://www.seedcode.com/filemaker-16-json-script-parameters/
• Details: Siehe Vortrag von Thomas Hirt

• 14 Uhr

• Raum hgi systems IT

JSON und FileMaker Server

FileMaker 17 Data API
• Wir haben bisher FileMaker als JSON/REST Client besprochen

• FileMaker Server kann auch als JSON/REST Server dienen

• Löst langfristig FileMaker API for PHP ab

• JSON/REST ist unabhängig von der Programmiersprache

• nicht auf PHP beschränkt

• Achtung: Nutzung der API kostet Geld!

• Lizenzkosten nach Datenvolumen

• https://fmhelp.filemaker.com/
docs/17/de/dataapi/index.html

• Session anmelden

• Datensatz anlegen

• Session im Header mitgeben!!!

• Datensatz anlegen

• Daten im Body mitgeben

FileMaker und JSON/REST ohne
Programmieren

Neuer Datensatz in FileMaker und ...

... dieser "landet" in Trello

JSON und FileMaker Admin Server

FileMaker Admin Server
• https://{{host}}:16000/fmi/admin/apidoc/

FileMaker Admin Server

FileMaker Beratung
Sollten Sie Dienstleistungen in Zusammenhang mit
FileMaker und JSON/REST benötigen, so kontaktieren Sie uns unverbindlich:
office@schubec.com
https://www.schubec.com

Vortrag und Sprecher
Vielen Dank unseren Sponsoren
Danke für das Bewerten dieses Vortrages

FMK2018-FileMaker und JSON/REST by Bernhard Schulz schubec.com

Empfohlen

Empfohlen

Weitere ähnliche Inhalte

Was ist angesagt?

Was ist angesagt? (20)

Ähnlich wie FMK2018-FileMaker und JSON/REST by Bernhard Schulz schubec.com

Ähnlich wie FMK2018-FileMaker und JSON/REST by Bernhard Schulz schubec.com (18)

Mehr von Verein FM Konferenz

Mehr von Verein FM Konferenz (20)

FMK2018-FileMaker und JSON/REST by Bernhard Schulz schubec.com