Handbuch „FileMaker Data API“
Über das FileMaker Data API
Übersicht
Das FileMaker® Data API ist ein Application Programming Interface (API), das Webdiensten ermöglicht, auf Daten in bereitgestellten Lösungen zuzugreifen. Da dieses API der Representational-State-Transfer- (REST-) Architektur entspricht, ist das FileMaker Data API ein REST API.
Ihr Webdienst bzw. Ihre Anwendung ruft das FileMaker Data API auf, um einen Authentifizierungstoken für den Zugriff auf eine bereitgestellte Lösung zu erhalten, und verwendet dann in nachfolgenden Aufrufen diesen Token, um Datensätze zu erstellen, zu aktualisieren und zu löschen sowie Suchabfragen durchzuführen.
Das FileMaker Data API gibt Daten in JavaScript-Object-Notation- (JSON-) Format zurück, einem Textformat, das häufig bei REST APIs verwendet wird, da es unabhängig von bestimmten Programmiersprachenformaten ist.
Dieses Handbuch setzt voraus, dass Sie vertraut sind mit:
- der Verwendung von FileMaker Pro, um Datenbanken zu erstellen. Sie sollten sich mit den Grundlagen der Datenbankgestaltung von FileMaker Pro auskennen und die Konzepte von Feldern, Beziehungen, Layouts, Ausschnitten und Containerfeldern verstehen. Weitere Informationen finden Sie in der FileMaker Pro Hilfe.
- der Verwendung von FileMaker Server, um Lösungen bereitzustellen. Sie sollten in der Lage sein, FileMaker Server einzusetzen und den Zugang zu bereitgestellten Lösungen zu ermöglichen, und bereitgestellte Lösungen über FileMaker Server Admin Console überwachen können. Weitere Informationen finden Sie in der FileMaker Server Hilfe.
- der Verwendung von REST APIs in serverseitigen Anwendungen bzw. Webdiensten, die POST-, GET-, PUT- und DELETE-Methoden mit Daten in JSON-Format aufrufen. Sie können Programmiersprachen und -werkzeuge je nach Wunsch einsetzen.
Um das FileMaker Data API zu verwenden, gehen Sie wie folgt vor:
- Bereiten Sie Ihre Datenbank für den FileMaker Data API-Zugriff mit FileMaker Pro vor. Sie können eine Datenbank neu erstellen oder eine vorhandene Datenbank vorbereiten. Siehe Vorbereiten von Datenbanken für FileMaker Data API-Zugriff.
- Schreiben Sie Programmcode, der FileMaker Data API-Methoden aufruft, um Datensätze in bereitgestellten Lösungen zu suchen, zu erstellen, zu bearbeiten und zu löschen. Siehe Schreiben von FileMaker Data API-Aufrufen.
- Stellen Sie Ihre Lösung mit FileMaker Server mit aktiviertem FileMaker Data API-Zugriff bereit. Siehe Bereitstellen einer FileMaker Data API-Lösung.
- Testen Sie, ob der FileMaker Data API-Zugriff korrekt funktioniert. Siehe Testen einer FileMaker Data API-Lösung.
- Überwachen Sie Ihre bereitgestellte Lösung mithilfe von Admin Console. Siehe Überwachen einer FileMaker Data API-Lösung.
Bearbeitung eines FileMaker Data API-Aufrufs
REST API-Client
1
6
Web-Server
2
5
FileMaker Data API
Engine
3
4
Datenbank-Server
-
Ein REST API-Client sendet einen FileMaker Data API-Aufruf (HTTPS-Anforderung) über den HTTPS-Port an den FileMaker Server-Web-Server. FileMaker Pro muss weder installiert sein noch ausgeführt werden.
Standardmäßig ist der HTTPS-Port 443, aber der Server-Administrator kann bei der Installation von FileMaker Server einen anderen Port angeben.
- Der Web-Server leitet die Anforderung über das FileMaker Web-Server-Modul an die FileMaker Data API Engine weiter.
- Die FileMaker Data API Engine wandelt die HTTPS-Anforderung (URL und JSON-Daten) in ein Format um, das die Datenbank-Server-Komponente versteht, und fragt Daten von der vom Datenbank-Server bereitgestellten Lösung ab.
- Der Datenbank-Server sendet die angeforderten FileMaker-Daten zurück an die FileMaker Data API Engine.
- Die FileMaker Data API Engine wandelt die FileMaker-Daten in eine HTTPS-Antwort (URL mit JSON-Daten) um, um auf den Aufruf zu reagieren, und gibt die Daten an den Web-Server zurück.
- Der Web-Server sendet die HTTPS-Antwort an den anfordernden REST API-Client.
Die FileMaker Data API Engine erfordert, dass die Ports 3000 und 8989 verfügbar sind.
Der Datenbank-Server erfordert, dass Port 5003 verfügbar ist.
Web Publishing-Alternativen
Wenn Sie keine Erfahrung in der Verwendung von REST APIs besitzen, können Sie die folgenden Alternativen in Erwägung ziehen, um Ihre FileMaker-Daten im Internet zu veröffentlichen.
FileMaker WebDirect™: Webbenutzer verbinden sich mit Ihrer auf FileMaker Server bereitgestellten Lösung, um Datensätze anzuzeigen, zu bearbeiten, zu sortieren oder zu suchen, wenn Sie ihnen die entsprechenden Zugriffsrechte geben. Sie müssen keine zusätzliche Software installieren, lediglich kompatible Webbrowser-Software und der Zugang zum Internet bzw. einem Intranet ist erforderlich. Die Benutzeroberfläche ähnelt der FileMaker Pro-Desktop-Anwendung. Die Webseiten und Formulare, mit denen der Webbenutzer arbeitet, hängen von den in der FileMaker Pro-Datenbank definierten Layouts und Ansichten ab.
Weitere Informationen finden Sie im FileMaker WebDirect-Handbuch.
Statisches Veröffentlichen: Wenn sich Ihre Daten selten ändern oder Sie keine Live-Verbindung Ihrer Benutzer zu Ihrer Datenbank wünschen, können Sie die Daten statisch veröffentlichen. Bei der statischen Veröffentlichung exportieren Sie die FileMaker Pro-Daten, um eine Webseite zu erstellen, die Sie anhand von HTML weiter anpassen können. Die Webseite ändert sich nicht, wenn sich Informationen in Ihrer Datenbank ändern, und die Benutzer stellen keine Verbindung zu Ihrer Datenbank her.
Siehe Veröffentlichen von Daten auf statischen Webseiten in der FileMaker Pro Hilfe.
Custom Web Publishing: Um Ihre FileMaker-Datenbank in eine angepasste Website zu integrieren, verwenden Sie die Techniken für Custom Web Publishing.
Siehe das Handbuch FileMaker Server Custom Web Publishing.
Vorbereiten von Datenbanken für FileMaker Data API-Zugriff
Festlegen der Daten für den Zugriff
Sie können eine FileMaker Pro-Datenbank erstellen, die mit dem FileMaker Data API verwendet wird, oder eine bestehende Datenbank verwenden. Wenn Sie eine Datenbank erstellen, können Sie die Layouts und Felder anlegen, die Ihre FileMaker Data API-Lösung erfordert. Wenn Sie eine bestehende Datenbank verwenden, ziehen Sie in Betracht, ein Layout zu erstellen, das speziell für Ihre FileMaker Data API-Lösung gedacht ist.
FileMaker Data API-Aufrufe, die auf Datensatzdaten zugreifen, erfordern, dass Sie ein Layout angeben. Das FileMaker Data API verwendet die Standardansicht, die für das von Ihnen angegebene Layout definiert ist. Geben Sie ein Layout an, das die Formularansicht als Standardansicht für das Layout definiert. Wenn Sie ein Layout verwenden, das die Tabellenansicht als Standardansicht definiert, kann das FileMaker Data API keine Daten aus Bezugsdatensätzen abrufen.
Schutz Ihrer bereitgestellten Lösungen
Das FileMaker Data API benötigt Ihren REST API-Programmcode, um sich an einer Lösung über ein passwortgeschütztes Konto anzumelden. Weisen Sie Datenbankkonten, die für REST API-Zugriff verwendet werden, Passwörter zu oder verwenden Sie einen OAuth-Identitätsdienstleister für diese Konten.
Hinweis: Wenn Sie Kontonamen und Passwörter für FileMaker Data API-Lösungen definieren, verwenden Sie druckbare ASCII-Zeichen. Beispiel: a-z, A-Z und 0-9. Verwenden Sie für sicherere Kontonamen und Passwörter zudem Satzzeichen wie „!“ und „%“, aber verwenden Sie keine Doppelpunkte. Weitere Informationen finden Sie in der FileMaker Pro Hilfe.
Aktivieren des FileMaker Data API
Sie müssen das erweiterte Zugriffsrecht „Zugriff über FileMaker Data API“ in jeder Datenbank verwenden, die mithilfe des FileMaker Data API zugreifen soll. Wenn Sie das erweiterte FileMaker Data API-Zugriffsrecht nicht in der Datenbank aktivieren, können REST API-Anwendungen das FileMaker Data API nicht verwenden, um auf die Datenbank zuzugreifen, selbst wenn die Datenbank von FileMaker Server bereitgestellt wird.
So aktivieren Sie FileMaker Data API-Zugriff für eine Datenbank:
- Öffnen Sie die Datenbank in FileMaker Pro mit einem Konto, das über die Berechtigung für vollen Zugriff verfügt. Alternativ können Sie die Datenbank mit einem Konto öffnen, das über die Berechtigung „Erweiterte Zugriffsrechte verwalten“ verfügt.
- Aktivieren Sie im Register „Erweiterte Berechtigungen“ im Dialogfeld „Sicherheit verwalten“ das erweiterte Zugriffsrecht fmrest.
- Weisen Sie die Berechtigungen, die das erweiterte Zugriffsrecht „fmrest“ umfassen, einem oder mehreren Konten zu.
Hinweis: Aktivieren Sie das erweiterte Zugriffsrecht „fmrest“ aus Sicherheitsgründen nur in den Berechtigungen für Konten, denen Sie den Zugriff auf Ihre bereitgestellte Lösung erlauben wollen.
Siehe Erstellen und Bearbeiten von Berechtigungen in der FileMaker Pro Hilfe.
Schreiben von FileMaker Data API-Aufrufen
FileMaker Data API-Funktionen
Das FileMaker Data API stellt ein REST API bereit, um auf Daten in bereitgestellten Lösungen zuzugreifen. Das FileMaker Data API ermöglicht Ihrem Programmcode:
- sich bei einer bereitgestellten Lösung an- und abzumelden. Siehe Aufrufe, die eine Verbindung zum Datenbank-Server herstellen bzw. trennen.
- einen Datensatz zu erstellen, zu bearbeiten, zu löschen oder abzurufen oder einen Datensatzbereich abzufragen. Siehe Aufrufe, die mit Datensätzen arbeiten.
- Suchabfragen auszuführen. Siehe Aufruf, der Suchabfragen ausführt.
- Variablenfeldwerte zu setzen. Siehe Aufruf, der Variablenfeldwerte setzt.
Das FileMaker Data API unterstützt Folgendes nicht:
- den Upload von Daten in Containerfelder
- den Zugriff auf Daten in externen ODBC-Datenquellen
- FileMaker-Plugins
- das Ausführen von FileMaker-Scripts
- das Auslösen von Script-Triggern
Das FileMaker Data API gibt Felddaten so zurück, wie sie in der Datenbank gespeichert sind, nicht wie sie in FileMaker Pro angezeigt werden.
FileMaker Data API-Referenzinformationen
Als Sie FileMaker Server installiert haben, haben Sie die FileMaker Data API-Referenzdateien installiert. Diese Referenz stellt detaillierte Informationen über alle vom FileMaker Data API unterstützten Aufrufe bereit.
- Um die Referenz in einem Browserfenster auf dem Mastercomputer anzuzeigen, geben Sie folgende URL ein:
https://localhost/fmi/rest/apidoc/ - Um die Referenz in einem Browserfenster auf einem Remotecomputer anzuzeigen, geben Sie die folgende URL ein:
https://host/fmi/rest/apidoc/
wobeihostfür die IP-Adresse oder den Host-Namen des Mastercomputers steht, auf dem FileMaker Server läuft. Auf einem Windows-Server befinden sich die Referenzdateien im Ordner
[laufwerk]:\Programme\FileMaker\FileMaker Server\Documentation\Data API Documentation
wobei[laufwerk]das Laufwerk ist, auf dem sich Ihr FileMaker Server-Einsatz befindet.Wenn Sie unter Windows an einem anderen als dem Standardort installieren, ersetzt Ihr Installationsort den Beginn des Standard-Installationspfads
[installationsort]:\Documentation\Data API Documentation.- Auf einem macOS Server befinden sich die Referenzdateien im Ordner
/Library/FileMaker Server/Documentation/Data API Documentation.
Hinweise zu Datenformaten
- Alle Datenwerte müssen URL-Verschlüsselung, auch als Prozent-Verschlüsselung bekannt, verwenden, das ist für HTTP-Anforderungen normal. Um zum Beispiel einen Layoutnamen anzugeben, der einen Schrägstrich enthält, müssen Sie den Schrägstrich als verschlüsselten Wert angeben: „%2F“
- Die Felder und Ausschnitte, die Sie angeben, müssen sich in dem Layout befinden, das sie angeben.
- Um Bezugsfelder anzugeben, müssen Sie die Syntax
tabellename::bezugsfeldverwenden. - Um Feldwiederholung 2 und höher zu verwenden, müssen Sie die Syntax
tabellenname::bezugsfeld(wiederholungnummer)verwenden. - Für die Bearbeitung von Datensätzen müssen Sie die DatensatzID-Syntax
tabellenname::bezugsfeld(wiederholungnummer).datensatzidverwenden. - Für Containerfelddaten gibt das FileMaker Data API eine URL mit dem Pfadverweis an das Containerdatenobjekt zurück.
REST API-Aufrufkomponenten
Die FileMaker Data API-Aufrufe bestehen aus folgenden Komponenten.
| Komponente | Beschreibung |
|---|---|
Eine HTTP-Methode (auch als HTTP-Verb bezeichnet) |
Das FileMaker Data API verwendet die folgenden HTTP-Methoden:
|
Ein HTTP-Header |
Das FileMaker Data API verwendet die folgenden Header:
|
| Eine Aufruf-URL | Die FileMaker Data API-URLs beginnen alle mit folgender Zeichenfolge: /fmi/rest/api/ |
| Parameterdaten in JSON-Format | Nicht benötigt bei: Abmelden von einer Lösung, Löschen eines Datensatzes, Abrufen eines einzelnen Datensatzes und Abrufen eines Datensatzbereichs. |
Aufrufe, die eine Verbindung zum Datenbank-Server herstellen bzw. trennen
Das FileMaker Data API verwendet einen Zugriffstoken, um eine Verbindung zu einer Datenbank zu definieren. Dieser Zugriffstoken muss im Header aller nachfolgenden Aufrufe an die bereitgestellte Lösung verwendet werden. Der Zugriffstoken ist so lange gültig, bis Sie sich von der Lösung abmelden, bzw. bis 15 Minuten nach dem letzten Aufruf, der diesen Token angegeben hat. (Während der Token gültig ist, setzt jeder Aufruf, der den Token angibt, den Zähler für das Zeitlimit der Sitzung wieder zurück.)
Anmelden bei einer Lösung
Um sich bei einer bereitgestellten Lösung anzumelden, verwenden Sie eine HTTP POST-Methode mit der auth-URL, die den Namen der bereitgestellten Lösung angibt.
Wenn der Kontoname und das Passwort authentifiziert sind, erhält Ihr Programmcode einen Zugriffstoken, der Ihre Verbindung zu der Lösung definiert.
| HTTP-Methode | POST |
|---|---|
| URL | /fmi/rest/api/auth/loesung loesung – der Name der bereitgestellten Datenbank |
| HTTP-Header | Content/Type: application/json |
| Parameter | Kontoname und Passwort, um sich bei der bereitgestellten Lösung anzumelden, und das Layout, auf das nach der Anmeldung gewechselt wird, in JSON-Format. Beispiel: {
"user":"admin",
"password":"admin",
"layout":"Aufgaben"
} |
| Antwort | Der Zugriffstoken, das aktuelle Layout und der Fehlercode 0 Beispiel: {
"errorCode": "0",
"layout": "Aufgaben",
"token": "fdde29fa175eb1cc8347512ca327b191619fc32ed65efaab26d8"
}
Siehe Fehlerantworten. |
Anmelden bei einer Lösung mithilfe eines OAuth-Identitätsdienstleisters
Um sich bei einer bereitgestellten Lösung anzumelden, verwenden Sie eine HTTP POST-Methode mit der auth-URL, die den Namen der bereitgestellten Lösung angibt.
Wenn der Kontoname und das Passwort authentifiziert sind, erhält Ihr Programmcode einen Zugriffstoken, der Ihre Verbindung zu der Lösung definiert.
| HTTP-Methode | POST |
|---|---|
| URL | /fmi/rest/api/auth/loesung loesung – der Name der bereitgestellten Datenbank |
| HTTP-Header | Content/Type: application/json X-FM-Data-Login-Type: oauth |
| Parameter | Die OAuth-AnforderungsID, die die Callback-URL für die Authentifizierung enthält, die OAuthID, die der OAuth-Identitätsdienstleister zurückgibt, und das Layout, auf das nach der Anmeldung umgeschaltet wird. Alle Daten müssen in JSON-Format angegeben werden. Beispiel: {
"oAuthRequestId":"E65B98CC17429CO643A31119F",
"oAuthIdentifier":"B164A4629A776E5177445DR223",
"layout":"Kontakte"
} |
| Antwort | Der Zugriffstoken, das aktuelle Layout und der Fehlercode 0 Beispiel: {
"errorCode": "0",
"layout": "Kontakte",
"token": "fdde35fa175eb1cc8621782fd327b191619fc32ed65efaab26d8"
}
Siehe Fehlerantworten. |
So erhalten Sie die OAuth-Parameter in JSON-Format:
-
Rufen Sie die Liste unterstützter OAuth-Dienstleister ab, indem Sie eine HTTP GET-Methode mit dieser URL verwenden:
https://host/fmws/oauthproviderinfoDabei steht host für die IP-Adresse bzw. den Domänennamen des Mastercomputers in Ihrem FileMaker Server-Einsatz. Die Liste wird in JSON-Format zurückgegeben.
- Wählen Sie einen unterstützten OAuth-Dienstleister und rufen Sie eine TrackingID für Ihre Lösung ab.
-
Verwenden Sie eine HTTP GET-Methode mit dieser URL:
http://host/oauth/getoauthurl?trackingID=tracking-ID&provider=OAuth-dienstleister&address=127.0.0.1&X-FMS-OAuth-AuthType=2Dabei steht host für die IP-Adresse bzw. den Domänennamen des Mastercomputers in Ihrem FileMaker Server-Einsatz, tracking-ID für die vom Entwickler generierte TrackingID für Ihre Lösung und OAuth-dienstleister für den Namen des von Ihnen ausgewählten OAuth-Dienstleisters.
Der HTTP-Header für diese Anforderung muss Folgendes beinhalten:
- X-FMS-Application-Type: 9
- X-FMS-Application-Version: 15
- X-FMS-Return-URL: http://127.0.0.1/
- Lesen Sie den Antwortheader für die X-FMS-Request-ID-Daten. Dieser Antwortheader enthält die OAuth-AnforderungsID, die sie für die Anmeldung verwenden werden.
- Lesen Sie den Antwortheader für die X-FMS-Return-URL-Daten. Rufen Sie die URL auf, die dieser Parameter zurückgibt, damit der Benutzer sich beim OAuth-Dienstleister authentifizieren kann.
- Die „ID“, die der OAuth-Dienstleister zurückgibt, ist der OAuthID-Parameter, den Sie für die Anmeldung verwenden werden.
Siehe Erstellen von Konten, die über einen OAuth-Identitätsdienstleister authentifiziert werden in der FileMaker Pro Hilfe.
Abmelden von der Lösung
Wenn Ihr Programmcode den Zugriff auf die bereitgestellte Lösung beendet hat, verwenden Sie eine HTTP DELETE-Methode mit der auth-URL, die den Namen der bereitgestellten Lösung angibt.
Der Sitzungstoken wird an den Anforderungsheader gesendet.
Wenn Ihr Programmcode sich nicht von der bereitgestellten Lösung abmeldet, wird der Zugriffstoken ungültig, wenn die FileMaker Data API-Sitzung eine Zeit von 15 Minuten nach dem letzten Aufruf dieses angegebenen Tokens überschreitet.
| HTTP-Methode | DELETE |
|---|---|
| URL | /fmi/rest/api/auth/loesung loesung – der Name der bereitgestellten Datenbank |
| HTTP-Header | FM-Data-token, der den Zugriffstoken angibt, den der Aufruf zur Anmeldung bei der Lösung angibt |
| Parameter | Keine |
| Antwort | Fehlercode = 0 Beispiel: {
"errorCode": "0"
}
Siehe Fehlerantworten. |
Aufrufe, die mit Datensätzen arbeiten
Datensatz erstellen
Um einen Datensatz zu erstellen, verwenden Sie eine HTTP POST-Methode mit der record-URL, die Lösungsname und Layout angibt.
| HTTP-Methode | POST |
|---|---|
| URL | /fmi/rest/api/record/lösung/layout lösung – der Name der bereitgestellten Datenbank |
| HTTP-Header | Content/Type: application/json FM-Data-token, der den Zugriffstoken angibt, den der Aufruf zur Anmeldung bei der Lösung angibt |
| Parameter | Datensatzdaten in JSON-Format mit Feld-Wert-Paaren, die Werte für Felder angeben, die sich im Ziellayout befinden. Beispiel: {"data":
{
"feld_1": "wert_1",
"feld_2": "wert_2",
"wiederholungFeld(1)" : "feldWert",
"Bestellungen::Bestelldatum.0":"22.12.2015"
}
}
Hinweis: Um einen leeren Datensatz mit den Standardwerten für ein Feld abzugeben, geben Sie ein leeres Datenobjekt in JSON-Format als Parameter ein. Beispiel: {"data":
{
}
} |
| Antwort | Fehlercode 0, DatensatzID des Datensatzes, der erstellt wurde Beispiel: {
"errorCode": "0",
"recordId": "25"
}
Siehe Fehlerantworten. |
Hinweise
- Wenn Sie Datensätze mithilfe des FileMaker Data API erstellen, wird die Feldwertüberprüfung durchgesetzt. Wenn die Daten die Feldwertüberprüfung nicht bestehen, erhalten Sie eine Fehlermeldung und der Datensatz wird nicht erstellt.
-
Um einen Bezugsdatensatz zu erstellen, schließen Sie die DatensatzID aus oder verwenden Sie den Wert 0 (null) als DatensatzID für den Bezugsdatensatz, gefolgt vom neuen Feldwert.
Zum Beispiel können Sie eines der folgenden Beispiele verwenden, um einen Bezugsdatensatz zu erstellen:
"Bestellungen::Bestelldatum" : "12/22/2017" "Bestellungen::Bestelldatum.0" : "12/22/2017"Pro Aufruf zum Erstellen von Datensätzen kann nur ein Datensatz erstellt werden.
Bearbeiten eines Datensatzes
Um einen Datensatz zu bearbeiten, verwenden Sie eine HTTP POST-Methode mit der record-URL, die Lösungsname, Layout und DatensatzID angibt.
| HTTP-Methode | PUT |
|---|---|
| URL | /fmi/rest/api/record/lösung/layout/datensatzid lösung – der Name der bereitgestellten Datenbank |
| HTTP-Header | Content/Type: application/json FM-Data-token, der den Zugriffstoken angibt, den der Aufruf zur Anmeldung bei der Lösung angibt |
| Parameter | Datensatzdaten in JSON-Format mit Feld-Wert-Paaren, die Sie aktualisieren möchten. Die Daten können Bezugsdatensätze oder Ausschnitte angeben, die sich in dem Layout befinden. Nur die Felder, die Sie angeben, werden aktualisiert. Andere Felder im Datensatz werden nicht geändert. Wenn „{}“ als Datenwert angegeben wird, wird der Zieldatensatz nicht aktualisiert. Optionaler Parameter: ÄnderungsID. Durch Angabe einer ÄnderungsID stellen Sie sicher, dass Sie die aktuelle Version eines Datensatzes bearbeiten. Wenn der Wert der ÄnderungsID nicht dem aktuellen Wert der ÄnderungsID in der Datenbank entspricht, wird der Datensatz nicht geändert. Beispiel: {"data":
{
"vorname": "Boris",
"nachname": "Schmidt",
"Ausstattung(2)" : "PC",
"Bestellungen::Bestelldatum.2":"12/20/2017",
"Bestellungen::Bestelldatum.0":"12/22/2017", // erstellt einen Bezugsdatensatz „Bestellungen“ mit 0 als DatensatzID
"deleteRelated": "Bestellungen.3" // löscht einen Bezugsdatensatz „Bestellungen“ mit der Zeichenfolge „deleteRelated“
},
modId: "3"
} |
| Antwort | Fehlercode 0 und die DatensatzID des Datensatzes, der bearbeitet wurde Beispiel: {
"errorCode": "0",
"recordId": "53"
}
Siehe Fehlerantworten. |
Hinweise
- Wenn Sie Datensätze mithilfe des FileMaker Data API bearbeiten, wird die Feldwertüberprüfung durchgesetzt. Wenn die Daten die Feldwertüberprüfung nicht bestehen, erhalten Sie eine Fehlermeldung und der Datensatz wird nicht aktualisiert.
-
Um einen Bezugsdatensatz zu erstellen, schließen Sie die DatensatzID aus oder verwenden Sie den Wert 0 (null) als DatensatzID für den Bezugsdatensatz, gefolgt vom neuen Feldwert.
Zum Beispiel können Sie eines der folgenden Beispiele verwenden, um einen Bezugsdatensatz zu erstellen:
"Bestellungen::Bestelldatum" : "12/22/2017" "Bestellungen::Bestelldatum.0" : "12/22/2017"Pro Aufruf zum Bearbeiten von Datensätzen kann nur ein Datensatz erstellt werden. -
Um einen Bezugsdatensatz zu löschen, verwenden Sie die Zeichenfolge „deleteRelated“, gefolgt von dem zu löschenden Bezugsdatensatz.
Beispiel:
"deleteRelated" : "Bestellungen.3"Pro Aufruf zum Löschen von Datensätzen kann nur ein Datensatz gelöscht werden.
Einen Datensatz löschen
Um einen Datensatz zu löschen, verwenden Sie eine HTTP DELETE-Methode mit der record-URL, die Lösungsname, Layout und DatensatzID angibt.
| HTTP-Methode | DELETE |
|---|---|
| URL | /fmi/rest/api/record/lösung/layout/datensatzid lösung – der Name der bereitgestellten Datenbank |
| HTTP-Header | FM-Data-token, der den Zugriffstoken angibt, den der Aufruf zur Anmeldung bei der Lösung angibt |
| Parameter | Keine |
| Antwort | Fehlercode = 0 Beispiel: {
"errorCode": "0"
}
Siehe Fehlerantworten. |
Abrufen eines einzelnen Datensatzes
Um einen Datensatz abzurufen, verwenden Sie eine HTTP GET-Methode mit der record-URL, die Lösungsname, Layout und DatensatzID angibt.
Sie können zudem Ausschnittinformationen angeben, um die Anzahl der Bezugsdatensätze, die zurückgegeben werden, zu begrenzen.
| HTTP-Methode | GET |
|---|---|
| URL | Format 1:
/fmi/rest/api/record/lösung/layout/datensatzid lösung – der Name der bereitgestellten Datenbank Für das Ausschnitt-Schlüsselwort: Der Ausschnittteil der URL ist optional. Wenn das Layout Ausschnitte umfasst, geben Sie die Ausschnittnamen an, um die Leistung zu optimieren. Wenn der Ausschnittteil weggelassen wird, gibt der Aufruf alle Bezugsdatensätze in allen Ausschnitten im Layout zurück. |
| HTTP-Header | FM-Data-token, der den Zugriffstoken angibt, den der Aufruf zur Anmeldung bei der Lösung angibt |
| Parameter | Keine |
| Antwort | Fehlercode 0 und die Datensatzdaten in JSON-Format Beispiel: {
"errorCode": "0",
"recordId": "{...}"
}
Siehe Fehlerantworten. |
Hinweise
- Um die Anzahl der zurückgegebenen Bezugsdatensätze zu begrenzen, unterstützt das FileMaker Data API die Option Vertikales Scrollen zulassen im Dialogfeld „Ausschnitteinstellungen“. Wenn diese Option ausgewählt ist, gibt FileMaker Data API die ersten 50 Zeilen aus dem Ausschnitt zurück. Wenn diese Option nicht ausgewählt ist, gibt FileMaker Data API die Anzahl der Zeilen zurück, die in der Option Anzahl der Zeilen angegeben ist.
- Um durch die Ausschnittzeilen zu scrollen, verwenden Sie die Syntax
offset.<ausschnittname>undrange.<ausschnittname>. Dabei steht<ausschnittname>für den Wert, der für den Ausschnitt im Inspektor in FileMaker Pro angegeben ist. Wenn Sie die Versatz- und Bereichswerte für Ausschnittzeilen weglassen, ist der Standard für Versatz 1 und für Bereich 50.
Abrufen eines Datensatzbereichs
Um einen Bereich von Datensätzen abzurufen, verwenden Sie eine HTTP GET-Methode, wobei die record-URL den Lösungsnamen, das Layout und weitere Informationen enthält, um einen Startdatensatz und die Anzahl der Datensätze anzugeben.
Optional können Sie die Sortierfolge der Datensätze angeben.
Sie können zudem Ausschnittinformationen angeben, um die Anzahl der Bezugsdatensätze, die zurückgegeben werden, zu begrenzen.
| HTTP-Methode | GET |
|---|---|
| URL | Format 1:
/fmi/rest/api/record/lösung/layout?offset=startdatensatz&range=anzahldatensätze lösung – der Name der bereitgestellten Datenbank Die Angabe der Sortierfolge muss in JSON-Format erfolgen. feldname ist der Name eines Felds, das als Basis für die Sortierung der Datensätze verwendet wird. Sie können mehrere Feldnamen angeben. Geben Sie für die Sortierfolge das Schlüsselwort „ascend“ oder „descend“ an oder geben Sie einen Wertelistennamen für value-list-name an. Für das Ausschnitt-Schlüsselwort: Der Ausschnittteil der URL ist optional. Wenn das Layout Ausschnitte umfasst, geben Sie die Ausschnittnamen an, um die Leistung zu optimieren. Wenn der Ausschnittteil weggelassen wird, gibt der Aufruf alle Bezugsdatensätze in allen Ausschnitten im Layout zurück. |
| HTTP-Header | FM-Data-token, der den Zugriffstoken angibt, den der Aufruf zur Anmeldung bei der Lösung angibt |
| Parameter | Keine |
| Antwort | Fehlercode 0 und den Bereich der Datensatzdaten in JSON-Format Beispiel: {
"errorCode": "0",
"records": "[...]"
}
Siehe Fehlerantworten. |
Hinweise
- Wenn Sie die Versatz- und Bereichswerte weglassen, ist der Standard für Versatz 1 und für Bereich 100.
offset=1&range=100 - Wenn Sie die Sortierfolgewerte weglassen, wird der Standard
&sort=[{ "fieldName": "datensatzId", "sortOrder": "ascend" }]verwendet. - Um die Anzahl der zurückgegebenen Bezugsdatensätze zu begrenzen, unterstützt das FileMaker Data API die Option Vertikales Scrollen zulassen im Dialogfeld „Ausschnitteinstellungen“. Wenn diese Option ausgewählt ist, gibt FileMaker Data API die ersten 50 Zeilen aus dem Ausschnitt zurück. Wenn diese Option nicht ausgewählt ist, gibt FileMaker Data API die Anzahl der Zeilen zurück, die in der Option Anzahl der Zeilen angegeben ist.
- Um durch die Ausschnittzeilen zu scrollen, verwenden Sie die Syntax
offset.<ausschnittname>undrange.<ausschnittname>. Dabei steht<ausschnittname>für den Wert, der für den Ausschnitt im Inspektor in FileMaker Pro angegeben ist. Wenn Sie die Versatz- und Bereichswerte für Ausschnittzeilen weglassen, ist der Standard für Versatz 1 und für Bereich 50.
Aufruf, der Suchabfragen ausführt
Um eine Suchabfrage auszuführen, verwenden Sie eine HTTP POST-Methode mit der find-URL, die Lösungsnamen und das Layout sowie zusätzliche Informationen angibt, um Abfragefelder und Kriterien, Sortierfolge, Startdatensatz und Anzahl der Datensätze anzugeben.
Sie können zudem Ausschnittinformationen angeben, um Bezugsdatensätze zu suchen.
| HTTP-Methode | POST |
|---|---|
| URL | /fmi/rest/api/find/lösung/layout lösung – der Name der bereitgestellten Datenbank |
| HTTP-Header | FM-Data-token, der den Zugriffstoken angibt, den der Aufruf zur Anmeldung bei der Lösung angibt |
| Parameter | Eine Abfrage in JSON-Format, die Felder und Suchkriterien angibt. Optionale Parameter geben Ausschlussabfragen, Sortierfolge, Startdatensatz (Versatz), Anzahl der Datensätze (Bereich) und Ausschnitte für die Begrenzung der Anzahl an Bezugsdatensätzen an, die zurückgegeben werden. Beispiel: {
"query":[
{"Group": "=Chirurg", "Bundesland" : "Bayern"},
{"Group": "=Chirurg", "Ort" : "München", "omit" : "true"}],
"sort":[
{"fieldName": "Bundesland","sortOrder": "ascend"},
{"fieldName": "Vorname", "sortOrder": "ascend"} ]
}
Beispiel mit Versatz, Bereich und Ausschnitten: {
"query":[
{"Group": "=Chirurg", "Bundesland" : "Bayern"},
{"Group": "=Chirurg", "Ort" : "München", "omit" : "true"}],
"portal": ["Ausschnitt1","Ausschnitt2"],
"range": "10",
"offset": "1",
"offset.Portal1": "1",
"range.Portal1": "5"
} |
| Antwort | Fehlercode 0 und die JSON-Darstellung der Ergebnismenge. Beispiel: {
"errorCode": "0",
"data": [datensatz1, datensatz2, ...]
}
Siehe Fehlerantworten. |
Hinweise
- In einer Lösung mit vielen Datensätzen kann das Abfragen und Sortieren von Datensätzen einige Zeit in Anspruch nehmen. Um die Anzahl der Datensätze und der anzuzeigenden Zeilen in einer Bezugsmenge zu begrenzen, geben Sie Versatz- und Bereichsparameter an.
- Variablenfelder können Sie nicht als Suchkriterien angeben. Wenn Sie eine Variable in einer Suchabfrage angeben, erhalten Sie eine Fehlermeldung. Setzen Sie den Variablenfeldwert stattdessen vor der Suchabfrage. Siehe Aufruf, der Variablenfeldwerte setzt.
Aufruf, der Variablenfeldwerte setzt
Um die Werte von Variablenfeldern zu setzen, verwenden Sie eine HTTP PUT-Methode mit der global-URL, die Lösungsname und Layout angibt.
| HTTP-Methode | PUT |
|---|---|
| URL | /fmi/rest/api/global/lösung/layout/ lösung – der Name der bereitgestellten Datenbank |
| HTTP-Header | FM-Data-token, der den Zugriffstoken angibt, den der Aufruf zur Anmeldung bei der Lösung angibt |
| Parameter | Ein JSON-Objekt mit Feld-und-Wert-Paaren, die die zu setzenden Variablenfelder angeben. Beispiel: { "globalFields":
{
"vFirma":"FileMaker",
"vCode":"95054"
}
} |
| Antwort | Fehlercode 0 Beispiel: {
"errorCode": "0"
}
Siehe Fehlerantworten. |
Fehlerantworten
Wenn ein Fehler auftritt, gibt das FileMaker Data API im Allgemeinen einen HTTP 400-Level-Statuscode mit zusätzlichen Informationen in einem JSON-Objekt zurück.
| HTTP-Statuscode | HTTP-Kategorie | JSON-Fehlerformat | Beschreibung |
|---|---|---|---|
| 400 | Ungültige Abfrage | {
"errorMessage": "Fehlerdetail"
} |
Tritt auf, wenn der Server die Abfrage aufgrund eines Client-Fehlers nicht bearbeiten kann. |
| 401 | Nicht autorisiert | {
"errorMessage": "Nicht autorisiert"
} |
Tritt auf, wenn der Client nicht autorisiert ist, auf das API zuzugreifen. Wenn dieser Fehler bei dem Versuch auftritt, sich an einer bereitgestellten Lösung anzumelden, gibt es ein Problem mit dem angegebenen Benutzerkonto bzw. Passwort. Wenn dieser Fehler bei anderen Aufrufen auftritt, wurde der Zugriffstoken nicht angegeben oder ist nicht gültig. |
| 404 | Nicht gefunden | {
"errorMessage": "Nicht gefunden"
} |
Tritt auf, wenn der Aufruf eine URL mit einem ungültigen URL-Schema verwendet. Prüfen Sie die angegebene URL auf Syntaxfehler. |
| 415 | Nicht unterstützter Medientyp | {
"errorMessage": "Nicht unterstützter Medientyp"
} |
Tritt auf, wenn der Header „Content/Type: application/json“ nicht angegeben wurde oder wenn ein anderer Content-Type als „application/json“ angegeben wurde. |
| 477 | FileMaker-Dienstfehler | {
"errorMessage": "FileMaker-Fehlermeldung",
"errorCode": "FileMaker-Fehlercode"
} |
Enthält FileMaker-Fehlermeldungen und -Fehlercodes. Siehe FileMaker-Fehlercodes in der FileMaker Pro Hilfe. |
Hinweise
- Wenn die FileMaker Data API Engine nicht läuft oder nicht erreichbar ist, kann der Statuscode 0 (null) ohne Fehlermeldung zurückgegeben werden.
- Weitere Informationen zu zusätzlichen HTTP-Statuscodes, die zurückgegeben werden, finden Sie bei www.w3.org.
Bereitstellen, Testen und Überwachen von FileMaker Data API-Lösungen
Bereitstellen einer FileMaker Data API-Lösung
- Arbeiten Sie alle Schritte unter Vorbereiten von Datenbanken für FileMaker Data API-Zugriff durch.
- Stellen Sie sicher, dass der FileMaker Data API-Zugriff in FileMaker Server Admin Console aktiviert und richtig konfiguriert wurde. Weitere Informationen finden Sie in der FileMaker Server Hilfe.
- Stellen Sie sicher, dass der Web-Server, die Web Publishing Engine und die FileMaker Data API Engine laufen.
-
Verschlüsseln Sie die Kommunikation.
Das FileMaker Data API verlangt, dass Ihre REST API-Anwendungen eine HTTPS-Verbindung verwenden. HTTPS-Verbindungen verwenden Secure-Sockets-Layer- (SSL-) Verschlüsselung für die Kommunikation.
FileMaker Server umfasst ein Standard-SSL-Zertifikat, das von FileMaker, Inc. signiert wurde und den Servernamen nicht verifiziert. Das Standardzertifikat von FileMaker dient nur für Testzwecke. Ein eigenes SSL-Zertifikat wird für die Produktion benötigt. Siehe das Handbuch FileMaker Server Installation und Konfiguration.
Die Programmiersprache bzw. Technologie, die Sie verwenden, um das FileMaker Data API aufzurufen, muss Transport Layer Security (TLS) v1.2 unterstützen, um mit dem Web-Server zu kommunizieren.
Testen einer FileMaker Data API-Lösung
Bevor Sie Ihre FileMaker Data API-Lösung in einer produktiven Umgebung einsetzen, stellen Sie sicher, dass sie wie erwartet funktioniert.
- Testen Sie Funktionen wie Suchen, Hinzufügen und Löschen von Datensätzen mit unterschiedlichen Konten und Berechtigungen.
- Stellen Sie sicher, dass Berechtigungen wie erwartet arbeiten, indem Sie mit unterschiedlichen Konten testen. Vergewissern Sie sich, dass nicht autorisierte Benutzer nicht auf Ihre Daten zugreifen bzw. sie nicht ändern können.
- Testen Sie, ob sich Ihre Lösung gleich verhält, wenn sie von unterschiedlichen Betriebssystemen aufgerufen wird.
Überwachen von FileMaker Data API-Lösungen
Der Server-Administrator kann Admin Console verwenden, um die FileMaker Data API Engine zu starten und zu stoppen, FileMaker Data API-Einstellungen zu ändern, FileMaker Data API-Clients zu überwachen, die Verwendung von FileMaker Data API-Aufrufen zu überwachen und die FileMaker Data API-Protokolldatei anzuzeigen.
| Für | Verwenden |
|---|---|
| Starten oder stoppen der FileMaker Data API Engine | Admin Console Statusbereich oder ein CLI-Befehl. Siehe Starten und Stoppen von FileMaker Server-Komponenten und Verwenden der Befehlszeilenschnittstelle in der FileMaker Server Hilfe. |
| Ändern von FileMaker Data API-Einstellungen | Das Admin Console-Register Web Publishing > FileMaker Data API. In diesem Register aktivieren Sie die Verwendung des FileMaker Data API, aktivieren die Protokollierung von FileMaker Data API-Aufrufen, legen die maximale Größe für die FileMaker Data API-Protokolldatei fest und setzen die Protokollierungsebene für Meldungen, die in die Protokolldatei geschrieben werden. Siehe FileMaker Data API-Einstellungen in der FileMaker Server Hilfe. |
| Überwachen von FileMaker Data API-Clients | Das Admin Console-Register Aktivität > Clients. Dieses Register zeigt die Details zum Client und den Lösungen, auf die zugegriffen wird. Siehe Verwalten von Clients in der FileMaker Server Hilfe. Von diesem Register aus trennen Sie FileMaker Data API-Clients, können ihnen aber keine Meldungen senden. Während FileMaker Data API-Clients mit einer Lösung verbunden sind, werden statistische Daten zu den Clients im Register Admin Console Statistik > Clients angezeigt. Siehe Anzeigen von Client-Statistiken in der FileMaker Server Hilfe. |
| Überwachen der Verwendung von FileMaker Data API-Aufrufen | Das Admin Console-Register Web Publishing > FileMaker Data API. Dieses Register zeigt, wie viele FileMaker Data API-Aufrufe von Ihrer FileMaker Server-Lizenz gestattet werden, wie viele Aufrufe im aktuellen Monat verwendet wurden und wie viele Aufrufe im Vormonat verwendet wurden. Wenn Sie sich dem Limit der Aufrufe nähern, können Sie über dieses Register auch weitere Aufrufe erwerben. Siehe FileMaker Data API-Einstellungen in der FileMaker Server Hilfe. |
| Anzeigen des FileMaker Data API-Protokolls | Das Admin Console-Register Protokollanzeige. FileMaker Data API-Komponenten generieren Protokollinformationen in Bezug auf die Clients, die auf bereitgestellte Lösungen über das FileMaker Data API zugreifen. Siehe FileMaker Data API-Protokoll in der FileMaker Server Hilfe. |
FileMaker Data API-Integration mit Tableau
Über die Integration mit Tableau
FileMaker Server beinhaltet den Tableau Web Data Connector, eine Beispielimplementierung, die REST API-Aufrufe in JSON-Format akzeptiert. Verwenden Sie den Tableau Web Data Connector, um eine Verbindung zwischen FileMaker Server und Tableau Desktop zu definieren. Die Verbindung verwendet das FileMaker Data API, um Daten von bereitgestellten FileMaker-Lösungen in Tableau Desktop zu importieren.
Anforderungen für den Tableau Web Data Connector
- Tableau Desktop, mindestens Version 9.1, für Windows oder Mac.
- Eine passwortgeschützte FileMaker Pro-Datenbank mit den zu importierenden Daten. Die Datenbank muss von FileMaker Server bereitgestellt werden.
-
Einen gültigen REST API-Endpunkt. Für FileMaker Server ist der Endpunkt ein HTML-Verbindungspunkt, der für Webdienste nötige Informationen bereitstellt. Der Endpunkt hat das Format
https://<hostname>/fmi/rest/tableau/fm_connector.html.
Dabei stehthostnamefür den vollständig qualifizierten Hostnamen Ihres FileMaker Servers.Beispiel:
https://meinserver.meinefirma.com/fmi/rest/tableau/fm_connector.html - Ein gültiges eigenes SSL-Zertifikat auf FileMaker Server. Der Tableau Web Data Connector lässt den Import von Daten von FileMaker Server nicht ohne ein eigenes gültiges SSL-Zertifikat zu.
Vorbereiten des Datenimports in Tableau
Folgen Sie der Anleitung unter Vorbereiten von Datenbanken für den FileMaker Data API-Zugriff, um das Layout für den Import zu definieren und die Datenbank für FileMaker Data API-Zugriff zu aktivieren.
Hinweis:Um Daten in Tableau zu importieren, muss die Tabelle mindestens einen Datensatz mit Datensatzdaten enthalten.
Die folgenden FileMaker-Feldtypen werden als Tableau-Datentypen importiert.
| FileMaker-Feldtyp | Tableau-Datentyp |
|---|---|
| Text | String |
| Datum | Date |
| Zeit | String |
| Zeitstempel | Datetime |
| Zahl | Float |
Die folgenden FileMaker-Feldtypen werden beim Import in Tableau nicht unterstützt:
- Containerfelder
- Statistikfelder. Sie können ein Statistikfeld in Tableau basierend auf den Daten erstellen, die Sie aus FileMaker importieren.
- Formelfelder. Sie können ein Formelfeld in Tableau basierend auf den Daten erstellen, die Sie aus FileMaker importieren.
- Diagrammdaten
- Daten aus FileMaker Pro-Ausschnitten. Um Daten aus Bezugsdatensätzen zu importieren, erstellen Sie ein FileMaker Pro-Layout basierend auf der Bezugstabelle oder importieren Sie Daten aus getrennten FileMaker Pro-Tabellen in Tableau und verknüpfen Sie die Tabellen dann in Tableau.
- Feldwiederholungen, bei denen die Anzeige von Wiederholfeldern für Wiederholungen anzeigen mehrere Werte umfasst. Eine einzelne Wiederholung wird unterstützt.
- Nicht numerische Werte in Zahlenfeldern. Wenn Tableau nicht numerische Werte in Zahlenfeldern erkennt, werden die Daten nicht importiert.
Verwenden Sie keine reservierten Wörter als Feldnamen in FileMaker Pro.
Einrichten der Datenverbindung in Tableau Desktop
- Wählen Sie in Tableau Desktop unter Verbinden (links am Bildschirm) Weitere > Webdaten-Connector.
- Geben Sie die URL für Ihren FileMaker Server-Endpunkt
https://<hostname>/fmi/rest/tableau/fm_connector.html
an. Dabei stehthostnamefür den vollständig qualifizierten Hostnamen Ihres FileMaker Servers. -
Im Dialogfeld „Daten aus FileMaker-Datei importieren“:
-
Melden Sie sich an der FileMaker Pro-Lösung an, indem Sie die folgenden Informationen eingeben oder einen OAuth-Identitätsdienstleister verwenden.
- Quelle Datenbankname: der Name der FileMaker Pro-Lösung
- Quelle Layoutname: der Name des FileMaker Pro-Layouts
- Kontoname: der Name des FileMaker Pro-Kontos mit dem Zugriffsrecht „fmrest“
- Passwort: das Passwort für das FileMaker Pro-Konto
- Wählen Sie Inkrementelle Aktualisierung aktivieren, um die inkrementelle Aktualisierung zu aktivieren.
-
- Klicken Sie auf FileMaker-Daten importieren.
Tableau importiert die Daten. Die Verarbeitungszeit hängt von der Anzahl der importieren Datensätze, der Server-Auslastung und dem Netzwerkdurchsatz ab. Tableau weist die FileMaker Pro-Feldnamen und Daten Dimensionen und Kennzahlen zu. String-Daten werden in der Regel Dimensionen zugeordnet, wohingegen numerische Daten in der Regel Kennzahlen zugeordnet werden. Die Zuordnung erfolgt automatisch während des Imports, Sie können sie aber anpassen.
Hinweise
-
Wenn Sie Quelle Layoutname angeben, stellen Sie sicher, dass der Layoutname eindeutig ist. Wenn Ihre Datenbank zwei Layouts mit dem gleichen Namen enthält, kann die Tableau-Datenverbindung nicht zwischen ihnen unterscheiden. Tableau zeigt nur einen Namen an und es kann ggf. nicht das Layout sein, das Sie meinten.
-
Verwenden Sie Inkrementelle Aktualisierung aktivieren, um nur die neuen Datensätze zu importieren.
- Nach dem Import von FileMaker-Daten mit inkrementeller Aktualisierung wählen Sie das Register Arbeitsblatt in Tableau, um zu dem Arbeitsblatt zu wechseln.
- Wählen Sie Daten > FM: lösungsname / layoutname > Extrahieren > Inkrementelle Aktualisierung.
- Wählen Sie das Register Datenquelle.
- Klicken Sie auf Jetzt aktualisieren, um die neuen Datensätze anzuzeigen.
- Das Aktivieren der inkrementellen Aktualisierung erzeugt keine anhaltende Live-Verbindung zwischen Tableau und der bereitgestellten FileMaker-Datenbank. Sie müssen die inkrementelle Aktualisierung manuell ausführen.
- Die inkrementelle Aktualisierung importiert nur die neuen Datensätze. FileMaker Pro-Datensätze, die geändert oder gelöscht wurden, werden nicht aktualisiert. Um geänderte Daten abzurufen oder gelöschte Datensätze zu entfernen, müssen Sie in Tableau eine neue Arbeitsmappe erstellen und die Daten neu importieren.
- Die inkrementelle Aktualisierung erstellt ein Feld namens -recordId. Wenn Sie Änderungen an diesem Feld vornehmen, können Sie eine inkrementelle Aktualisierung eventuell nicht durchführen.
- In Tableau können Sie Schema und Daten ändern, die importiert wurden. Wenn Sie aber Schema oder Daten in Tableau ändern, werden diese Änderungen nicht zurück in die FileMaker Pro-Datei übertragen.
- Wenn Sie das Schema in der FileMaker Pro-Datei ändern, müssen Sie in Tableau eine neue Arbeitsmappe erstellen und die Daten neu importieren.
- Die Tableau Desktop-Datenbank kann auf Tableau Server für Windows bereitgestellt werden.
- Wenn Sie die Tableau-Arbeitsmappe schließen und erneut öffnen, funktioniert die inkrementelle Aktualisierung nicht mehr.
- Nachdem die Datenverbindung zu Tableau hergestellt wurde, speichert der FileMaker Web Data Connector Benutzerkonto und Passwort zwischen, bis die Arbeitsmappe geschlossen wird. Beachten Sie dabei Folgendes:
- Wenn die FileMaker-Sitzung abläuft, während Sie mit Tableau verbunden sind, versucht der FileMaker Web Data Connector, den Benutzer wieder mit FileMaker Server zu verbinden.
- Wenn die Tableau-Verbindung ausläuft, versucht der FileMaker Web Data Connector, die Verbindung zu FileMaker Server so lange wiederherzustellen, wie die Tableau-Arbeitsmappe geöffnet ist.
- Wenn die Arbeitsmappe geschlossen und wieder geöffnet wird, müssen Sie Ihren Kontonamen und Ihr Passwort erneut während des anfänglichen Datenimports eingeben.
- Die Seite „Tableau-Datenquelle“ zeigt bis zu 1.000.000 (eine Million) Zeilen an, selbst wenn mehr Datensätze importiert werden.