FileMaker 17 Guide för Data API
Om FileMaker Data API
Översikt
FileMaker® Data API är ett API (application programming interface) som gör att webbtjänster kan komma åt data i värdbaserade databaser. Eftersom detta API följer REST-arkitektur (Representational State Transfer) är FileMaker Data API ett REST API.
Din webbtjänst eller ditt program anropar FileMaker Data API för att få en autentiseringstoken för åtkomst till en värdbaserad databas. Därefter används denna token i efterföljande anrop för att skapa poster, uppdatera poster, radera poster och utföra sökningar.
FileMaker Data API returnerar data i JavaScript Object Notation (JSON), ett textformat som vanligtvis används med REST API:er eftersom det är oberoende av specifika programmeringsspråkformat.
Den här guiden riktar sig till dig som har erfarenhet av följande:
- Att använda FileMaker Pro Advanced för att skapa databaser. Du bör förstå grunderna i databasdesign med FileMaker Pro Advanced och känna till begreppen fält, relationer, layouter, portaler och containrar. Mer information finns i FileMaker Pro Advanced Hjälp.
- Att använda FileMaker Server som värd för databaser. Du bör förstå hur man driftsätter FileMaker Server, ger åtkomst till värdbaserade databaser och övervakar värdbaserade databaser med FileMaker Server Admin Console. Mer information finns i FileMaker Server Hjälp.
- Att använda REST API:er i program på serversidan eller webbtjänster som anropar POST-, GET-, PATCH- och DELETE-metoder med data i JSON-format. Du kan använda vilka programmeringsspråk eller verktyg du vill.
Följ dessa steg för att använda FileMaker Data API:
- Förbered din databas för FileMaker Data API-åtkomst med hjälp av FileMaker Pro Advanced. Du kan skapa en databas eller förbereda en befintlig databas. Mer information finns under Förbereda databaser för FileMaker Data API-åtkomst.
- Skriv kod som anropar FileMaker Data API-metoder för att hitta, skapa, redigera och radera poster i en värdbaserad databas. Mer information finns under Skriva FileMaker Data API-anrop.
- Använd FileMaker Server med FileMaker Data API-åtkomst aktiverat som värd för din lösning. Mer information finns under Vara värd för en FileMaker Data API-lösning.
- Testa att FileMaker Data API-åtkomsten fungerar som den ska. Mer information finns under Testa en FileMaker Data API-lösning.
- Övervaka din värdbaserade lösning med hjälp av Admin Console. Mer information finns under Övervaka FileMaker Data API-lösningar.
Så här bearbetas ett FileMaker Data API-anrop
-
En REST API-klient skickar ett FileMaker Data API-anrop (HTTPS-förfrågan) till FileMaker Server-webbservern via HTTPS-porten (port 443). FileMaker Pro Advanced behöver inte installeras eller köras.
- Webbservern vidarebefordrar förfrågan genom FileMakers webbservermodul till FileMaker Data API-motorn.
- FileMaker Data API-motorn konverterar HTTPS-förfrågan (URL och JSON-data) till ett format som databasserverkomponenten kan förstå, och begär data från den databas som databasservern är värd för.
- Databasservern skickar tillbaka begärda FileMaker-data till FileMaker Data API-motorn.
- FileMaker Data API-motorn konverterar FileMaker-data till ett HTTPS-svar (URL med JSON-data) för att svara på anropet och datan skickas tillbaka till webbservern.
- Webbservern skickar HTTPS-svaret till den REST API-klient som gjort förfrågan.
FileMaker Data API-motorn kräver att portarna 3000 och 8989 är tillgängliga.
Databasservern kräver att port 5003 är tillgänglig.
Alternativ för webbpublicering
Om du inte tidigare har använt REST API:er kan du överväga följande alternativ för att publicera dina FileMaker-data på internet.
FileMaker WebDirect™: Webbanvändare ansluter till den databas som FileMaker Server är värd till för att visa, redigera, sortera eller söka poster om du ger dem åtkomstbehörigheter. De behöver inte installera ytterligare programvara, bara kompatibla webbläsare och åtkomst till internet eller ett intranät. Användargränssnittet liknar FileMaker Pro Advanced-programmet. De webbsidor och formulär som webbanvändaren samverkar med är beroende av de layouter och vyer som definierats i FileMaker Pro Advanced-databasen.
Mer information finns i Guide för FileMaker WebDirect.
Statisk publicering: Om du ändrar dina data väldigt sällan eller om du inte vill att användarna ska ha en direktanslutning till din databas kan du använda dig av statisk publicering. Vid statisk publicering exporterar du FileMaker Pro Advanced-data och skapar en webbsida som du kan anpassa ytterligare med HTML. Webbsidan ändras inte när informationen i din databas ändras, och användarna ansluter inte till din databas.
Mer information finns i Publicera data på statiska webbsidor i FileMaker Pro Advanced Hjälp.
Anpassad webbpublicering: Du kan integrera en FileMaker-databas med en anpassad webbplats genom att använda teknikerna för anpassad webbpublicering.
Mer information finns i FileMaker Server Guide för anpassad webbpublicering.
Förbereda databaser för FileMaker Data API-åtkomst
Avgör vilka data som ska vara tillgängliga
Du kan skapa en FileMaker Pro Advanced-databas att använda med FileMaker Data API eller använda en befintlig databas. Om du skapar en databas kan du designa de layouter och fält som din FileMaker Data API-lösning kräver. Om du använder en befintlig databas kan du överväga att skapa en layout som är specifik för din FileMaker Data API-lösning.
FileMaker Data API-anrop som kommer åt postdata kräver att du anger en layout. FileMaker Data API använder den standardvy som definieras för den layout som du anger. Ange en layout som definierar Formulär som standardvy för layouten. Om du använder en layout som definierar Tabellvy som standard kommer FileMaker Data API inte att kunna hämta data från relaterade poster.
Skydda dina FileMaker Data API-lösningar
FileMaker Data API kräver din REST API-kod för att logga in på en databassession med hjälp av ett lösenordsskyddat konto. Tilldela lösenord till databaskonton som används för REST API-åtkomst eller använd en OAuth-leverantör för dessa konton.
Obs!När du definierar kontonamn och lösenord för FileMaker Data API-lösningar ska du använda utskrivbara ASCII-tecken, till exempel a–z, A–Z och 0–9. För att göra kontonamn och lösenord säkrare inkluderar du skiljetecken, t.ex. ”!” och ”%”, men inte kolon. Mer information finns i FileMaker Pro Advanced Hjälp.
Aktivera FileMaker Data API-åtkomst
Du måste aktivera den utökade behörigheten Åtkomst via FileMaker Data API i varje databas du vill komma åt med FileMaker Data API. Om du inte aktiverar den utökade FileMaker Data API-behörigheten i databasen kommer REST API-program inte att kunna använda FileMaker Data API för åtkomst till databasen även om FileMaker Server inte är värd för den.
För att aktivera FileMaker Data API-åtkomst för en databas:
- Starta FileMaker Pro Advanced och öppna databasen med ett konto som har behörighetsuppsättningen Full åtkomst. Du kan också öppna databasen med hjälp av ett konto som har inställningen Hantera utökad behörighet i behörighetsuppsättningen.
- Välj den utökade behörigheten fmrest på fliken Utökad behörighet i dialogrutan Hantera säkerhet för att aktivera den.
- Tilldela de behörighetsuppsättningar som innehåller den utökade behörigheten fmrest till ett eller flera konton.
Obs!Av säkerhetsskäl ska du bara aktivera den utökade behörigheten fmrest i behörighetsuppsättningarna för de konton som du vill ska ha åtkomst till din värdbaserade databas.
Mer information finns i ”Skapa och redigera behörighetsuppsättningar” i FileMaker Pro Advanced Hjälp.
Designa FileMaker Data API-lösningen
Funktioner i FileMaker Data API
FileMaker Data API tillhandahåller ett REST API för att komma åt data i värdbaserade databaser. FileMaker Data API tillåter din kod att göra följande:
- Logga in eller ut från en delad databas. Mer information finns under Ansluta till eller koppla bort från en databas.
- Skapa, redigera, radera eller hämta en post, eller hämta en uppsättning poster. Mer information finns under Arbeta med poster.
- Göra sökningar. Mer information finns under Utföra en sökning.
- Ställa in globala fältvärden. Mer information finns under Ställa in globala fältvärden.
- Köra FileMaker-scripts. Mer information finns under FileMaker-scripts och FileMaker Data API.
- Överföra data till containerfält. Mer information finns under Överföra containerdata.
- Använda data i externa FileMaker-tabeller. Mer information finns under Logga in på en extern datakälla.
- Använda en annan layout för svarsdata när en post eller en uppsättning poster hämtas. Mer information finns under Hämta en enstaka post, Hämta en uppsättning poster och Utföra en sökning.
FileMaker Data API har inte stöd för följande:
- Åtkomst till data i externa ODBC-datakällor.
- Plugin-program till FileMaker.
- Scripttriggeraktivering genom användarinteraktion. En FileMaker Data API-lösning kan bara aktivera scripttriggers genom att köra ett FileMaker-script.
- Åtkomst till serverdatorns filsystem. Till exempel har FileMaker Data API inte stöd för FileMaker Pro Advanced-funktionen Get(TemporärSökväg). Den här funktionen returnerar en tom sträng när den används med FileMaker Data API. Filer kan lagras i ett containerfält, men det finns ingen åtkomst till serverns filsystem.
FileMaker Data API returnerar fältdata såsom de lagras i databasen, inte såsom de visas i FileMaker Pro Advanced.
Referensinformation för FileMaker Data API
När du installerade FileMaker Server installerades referensfilerna för FileMaker Data API. Den här referensen innehåller detaljerad information om alla anrop som stöds av FileMaker Data API.
Obs!Kontrollera att FileMaker Data API-åtkomst har aktiverats i Admin Console om du vill visa referensinformationen. Mer information finns i FileMaker Server Hjälp.
- För att visa referensen i ett webbläsarfönster på huvuddatorn, ange följande URL:
https://localhost/fmi/data/apidoc/
- För att visa referensen i ett webbläsarfönster på en fjärrdator, ange följande URL:
https://
värd
/fmi/data/apidoc/
därvärd
är IP-adressen eller värdnamnet för den huvuddator som kör FileMaker Server. På en Windows-server finns referensfilerna i mappen
[enhet]
:\Program Files\FileMaker\FileMaker Server\Documentation\Data API Documentation
där[enhet]
är den enhet där din FileMaker Server-driftsättning finns.Om du installerar med en icke-standardplats på Windows ersätter installationsplatsen början av standardsökvägen för installationen
[enhet]
:[installationsplats]
\FileMaker\FileMaker Server\Documentation\Data API Documentation- På en macOS-server finns referensfilerna i mappen
/Bibliotek/FileMaker Server/Documentation/Data API Documentation
Kommentarer
- Referensfilerna visar variabler i URL:erna genom att använda ett sökord som föregås av kolon (:). Exempel:
:database
- Den här guiden visar variabler i URL:erna genom att använda ett kursivt typsnitt. Exempel:
databas-namn
Kommentarer om URL:er och dataformat
- Det kan finnas URL:er eller delar av URL:er där skiftläget kvittar, men i allmänhet ska URL:er behandlas som skiftlägeskänsliga. Om du till exempel använder ett databasnamn med gemener för att logga in på en databassession ska du även använda ett databasnamn med gemener för alla efterföljande URL:er som går genom samma sessionstoken. I annat fall kan du få ett felmeddelande om ogiltig token.
- Strängar i URL:er måste använda URL-kodning (även kallat procentkodning), vilket är normalt för HTTP-förfrågningar. Till exempel: för att ange ett layoutnamn som innehåller ett snedstreck måste du ange snedstrecket som detta kodade värde: "%2F"
- Strängdatavärden som anges i parametrar i texten till förfrågan måste använda UTF-8-kodning.
- I allmänhet behandlar FileMaker Data API numeriska datavärden som om de vore i flytpunktsformat med dubbel precision (binär64). Använd motsvarande dataformat i det programmeringsspråk som du använder. (Numeriska datavärden ska inte omges av citattecken och inte använda URL-kodning.)
- Datavärden för fälten nummer, datum, tid och tidsstämpel har samma begränsningar som anges i FileMaker Pro Advanced. Mer information finns i FileMaker Pro Advanced Hjälp.
- De fält och portaler som du anger måste finnas i den layout du anger.
- Använd
portalData
-syntaxen om du vill ange relaterade fält.Obs!Syntaxen
tabellnamn::relaterat-fält(repetitionsnummer).post-id
från den tidigare versionen stöds fortfarande men det är bättre att användaportalData
-syntaxen. - När det gäller containerfält returnerar FileMaker Data API en URL med sökvägsreferens till containerdataobjektet.
FileMaker-scripts och FileMaker Data API
FileMaker-scripts kan automatisera uppgifter som utförs ofta samt kombinera flera uppgifter. Genom att använda FileMaker-scripts tillsammans med FileMaker Data API kan webbtjänster utföra fler uppgifter eller en serie uppgifter. Mer information finns under Köra FileMaker-scripts.
Om du vill vilka scriptsteg som FileMaker Data API stöder klickar du på Kompatibilitet-knappen i Scriptfönstret i FileMaker Pro Advanced och väljer FileMaker Data API. Scriptsteg som inte är nedtonade stöds för FileMaker Data API. Vissa scriptsteg utförs på ett annat sätt i FileMaker Data API än i FileMaker Pro Advanced. Mer information finns i FileMaker Pro Advanced Hjälp.
Scripts som körs av FileMaker Data API kan inte köra scripts i andra FileMaker-filer om inte filerna är värdbaserade i samma installation av FileMaker Server och den utökade behörigheten fmrest är aktiverad i övriga filer.
I FileMaker Pro Advanced kan både scripts och användaråtgärder (som att användaren klickar i ett fält) aktivera en scripttrigger. Men i FileMaker Data API-lösningar kan bara scripts aktivera scripttriggers. Information om scripttriggers finns i FileMaker Pro Advanced Hjälp.
Kommentarer
- Överväg hur mycket data och hur många poster som ett script kan returnera och definiera scripts utifrån det. I FileMaker Pro Advanced kan ett script returnera alla poster från en tabell eller från det aktuella sökresultatet. Men om ett script returnerar alla poster från en tabell kan en webbtjänst få slut på minne när den försöker att bearbeta posterna.
- Använd konton och behörigheter för att styra vilka scripts en webbtjänst kan köra. Kontrollera att scripten endast innehåller webbkompatibla scriptsteg och ge bara tillgång till scripts som ska användas från en webbtjänst.
- Var också uppmärksam på eventuella biverkningar av scripts som kör kombinationer av steg som styrs via behörigheten. Om ett script exempelvis innehåller steget Radera poster och en webbtjänst inte loggar in med ett konto som ger behörighet att radera poster, utförs inte scriptsteget Radera poster. Scriptet kan dock fortsätta att utföras, vilket kan ge oväntade resultat.
- I Scriptfönstret kan du ge ett script fullständiga behörigheter för att låta scriptet utföra uppgifter som du inte vill låta den enskilda användaren utföra. Du kan till exempel hindra användare från att radera poster via deras konton och behörighet, men ändå tillåta dem att köra ett script som raderar vissa typer av poster under vissa förutsättningar som anges i scriptet.
- Vissa scripts som bara behöver ett scriptsteg när de körs från en FileMaker Pro Advanced-klient kan behöva ytterligare ett scriptsteg för att verkställa post/sökpost och spara data på värddatorn när de körs i en FileMaker Data API-lösning. Eftersom webbtjänsterna inte har någon direktanslutning till värddatorn meddelas de inte när data ändras. Exempelvis kanske funktioner som villkorliga värdelistor inte fungerar som förväntat eftersom data måste sparas på värddatorn.
- Scripts som ändrar data bör innehålla scriptsteget Verkställ post/sökpost, eftersom dataändringar inte är åtkomliga förrän data sparas till servern. Detta gäller scriptsteg såsom Klipp ut, Kopiera och Klistra in. Många enkelstegsåtgärder bör konverteras till scripts och innehålla steget Verkställ post/sökpost. När du skapar scripts som ska köras från en webbtjänst ska du inkludera steget Verkställ post/sökpost sist i scriptet, så att du är säker på att alla ändringar sparas.
- Öppna varje script som webbanvändare kan tänkas köra och kontrollera att scriptet kan köras ordentligt när databasen är konfigurerad som en FileMaker Data API-lösning. Kontrollera att scriptet bara använder scriptsteg som stöds av FileMaker Data API, enligt beskrivningen ovan.
Skriva FileMaker Data API-anrop
Komponenter i REST API-anrop
FileMaker Data API-anrop består av följande komponenter.
Komponent | Beskrivning |
---|---|
En HTTP-metod (kallas även ett HTTP-verb) |
FileMaker Data API använder följande HTTP-metoder:
|
HTTP-headers |
FileMaker Data API använder följande headers:
|
En anrops-URL | URL:er i FileMaker Data API börjar alla med något av följande:
|
Parameterdata i JSON-format | Behövs inte med Logga ut från en databassession, Radera en post, Hämta en enstaka post eller Hämta en uppsättning poster. |
Ansluta till eller koppla bort från en databas
FileMaker Data API använder en åtkomsttoken för att definiera en anslutning till en databas. Denna åtkomsttoken måste användas i headern för alla efterföljande anrop till den värdbaserade databasen. Åtkomsttoken är giltig tills du loggar ut från en databassession eller i 15 minuter efter det sista anropet som angav token. (Medan token är giltig återställs tidräknaren till noll för varje anrop som anger token.)
Logga in på en databassession
Om du vill logga in på en värdbaserad databas använder du en HTTP POST-metod med en sessions
-URL som anger namnet på en värdbaserad databas. Kontonamnet och lösenordet anges i en auktoriseringssträng i headern. Om kontonamnet och lösenordet autentiseras får din kod en åtkomsttoken som definierar din anslutning till databasen. Den anslutningen kallas en databassession.
HTTP-metod | POST |
---|---|
URL | /fmi/data/v1/databases/databas-namn/sessions databas-namn – namnet på den värdbaserade databasen |
HTTP-header | Content-Type: application/json Auktorisering: en base64-kodad sträng som representerar kontonamnet och lösenordet och som används för att logga in på den värdbaserade databasen. Denna base64-kodade sträng ska följa standardschemat HTTP Basic Authentication. (Kontonamnet och lösenordet separeras med kolon.) |
Parametrar |
Klamrar utan innehåll. Till exempel:
Kan även använda parametern |
Svar | Åtkomsttoken, ett tomt svar och en meddelandematris som visar felkoden 0. Headern X-FM-Data-Access-Token returneras som svar, vilket är den sessionstoken som ska användas för efterföljande API-anrop. Till exempel: X-FM-Data-Access-Token: 823c0f48bb80f2187bde6f3859dabd4dcf8ea43be420dfeadf34 { "response": {}, "messages":[{"code":"0","message":"OK"}] }
Mer information finns under Felsvar. |
Logga in på en extern datakälla
Om den värdbaserade databasen behöver logga in på en extern datakälla anges namnet på den värdbaserade databasen i URL:en. Kontonamnet och lösenordet anges i en auktoriseringsträng i headern. Databasnamnet, kontonamnet och lösenordet för den externa datakällan anges i parametern fmDataSource
som en JSON-matris.
HTTP-metod | POST |
---|---|
URL | /fmi/data/v1/databases/databas-namn/sessions databas-namn – namnet på den värdbaserade databasen |
HTTP-header | Content-Type: application/json Auktorisering: en base64-kodad sträng som representerar kontonamnet och lösenordet och som används för att logga in på den värdbaserade databasen. Denna base64-kodade sträng ska följa standardschemat HTTP Basic Authentication. |
Parametrar | Parametern Till exempel: { "fmDataSource": [ { "database":"kontakter", "username":"admin", "password":"admin" } ] }
Om du vill använda ett OAuth-konto för att logga in på den externa datakällan anger du X-FMS-Request-ID-headervärdet ( { "fmDataSource": [ { "database":"kontakter", "oAuthRequestId": "E65B98BB17429CO643B31119F", "oAuthIdentifier": "B164A3459A776E5177445DR223"} ] }
|
Svar | Åtkomsttoken, ett tomt svar och en meddelandematris som visar felkoden 0. Headern X-FM-Data-Access-Token returneras som svar, vilket är den sessionstoken som ska användas för efterföljande API-anrop. Till exempel: X-FM-Data-Access-Token: c13c0f486780f2187bde6f3859dabd4dcf8ea43be420dfeadf34 { "response": {}, "messages":[{"code":"0","message":"OK"}] }
Mer information finns under Felsvar. |
Obs!FileMaker-databaser är de enda externa datakällorna som stöds. Ange databasnamnet utan filtillägget .fmp12.
Logga in på en databassession med hjälp av en OAuth-identitetsleverantör
Om du vill logga in på en värdbaserad databas med hjälp av en OAuth-identitetsleverantör använder du en HTTP POST-metod med en sessions
-URL som anger databasen. Använd strängarna X-FM-Data-OAuth-Request-Id och X-FM-Data-OAuth-Identifier i headern för att autentisera åtkomst till den värdbaserade databasen. Om autentiseringen godkänns får din kod en åtkomsttoken som definierar din anslutning till databasen. Den anslutningen kallas en databassession.
HTTP-metod | POST |
---|---|
URL | /fmi/data/v1/databases/databas-namn/sessions databas-namn – namnet på den värdbaserade databasen |
HTTP-header | Content-Type: application/json X-FM-Data-OAuth-Request-Id: sökpost-id X-FM-Data-OAuth-Identifier: identifierar-parameter |
Parametrar |
Klamrar utan innehåll. Till exempel: Kan även använda parametern |
Svar | Åtkomsttoken, ett tomt svar och en meddelandematris som visar felkoden 0. Headern X-FM-Data-Access-Token returneras som svar, vilket är den sessionstoken som ska användas för efterföljande API-anrop. Till exempel: X-FM-Data-Access-Token: 823c0f48bb80f2187bde6f3859dabd4dcf8ea43be420dfeadf34 { "response": {}, "messages":[{"code":"0","message":"OK"}] }
Mer information finns under Felsvar. |
Hämta OAuth-parametrar i JSON-format:
-
Hämta listan av OAuth-leverantörer som stöds genom att använda en HTTP GET-metod med denna URL:
https://värd/fmws/oauthproviderinfo
där värd är IP-adressen eller domännamnet på huvuddatorn i din FileMaker Server-driftsättning. Listan returneras i JSON-format.
- Välj en OAuth-leverantör som stöds och få ett spårnings-ID för din session.
-
Använd en HTTP GET-metod med denna URL:
http://värd/oauth/getoauthurl?trackingID=spårnings-ID&provider=OAuth-leverantör&address=127.0.0.1&X-FMS-OAuth-AuthType=2
där värd är IP-adressen eller domännamnet för huvuddatorn i din FileMaker Server-driftsättning, spårning-ID är det utvecklargenererade spårnings-ID:t för din session och OAuth-leverantör är namnet på den valda OAuth-leverantören.
HTTP-headern för denna förfrågan måste innehålla följande:
- X-FMS-Application-Type: 9
- X-FMS-Application-Version: 15
- X-FMS-Return-URL: http://127.0.0.1/
- Läs svarsheadern för X-FMS-Request-ID-datan. Den här svarsheadern innehåller ID:t för den OAuth-förfrågan som du ska använda för strängen X-FM-Data-OAuth-Request-ID i headern.
- Läs svarsheadern för X-FMS-Return-URL-datan. Anropa den URL som returneras i parametern för att låta användaren autentisera med OAuth-leverantören.
- Den "identifierare" som returneras av OAuth-leverantören är den OAuth-identifierarparameter som du använder för strängen X-FM-Data-OAuth-Identifier i headern.
Mer information finns under "Skapa konton som autentiseras via en OAuth-identitetsleverantör" i FileMaker Pro Advanced Hjälp.
Logga ut från en databassession
När din kod är klar med den värdbaserade databasen använder du en HTTP DELETE-metod med en sessions
-URL som anger namnet på den värdbaserade databasen och åtkomsttoken för sessionen. Om koden inte loggar ut från databassessionen blir åtkomsttoken ogiltig när FileMaker Data API-sessionen avslutas 15 minuter efter det sista anropet som angav token.
HTTP-metod | DELETE |
---|---|
URL | /fmi/data/v1/databases/databas-namn/sessions/sessions-token databas-namn – namnet på den värdbaserade databasen sessions-token – X-FM-Data-Access-Token för databassessionen |
HTTP-header | Content-Type: application/json |
Parametrar | Inga |
Svar |
Ett tomt svar och en meddelandematris som visar felkoden 0. Till exempel: { "response": {}, "messages":[{"code":"0","message":"OK"}] }
Mer information finns under Felsvar. |
Arbeta med poster
Skapa en post
Om du vill skapa en post använder du en HTTP POST-metod med en records
-URL som anger databasnamnet och layouten.
HTTP-metod | POST |
---|---|
URL | /fmi/data/v1/databases/databas-namn/layouts/layout-namn/records databas-namn – namnet på den värdbaserade databasen |
HTTP-header | Content-Type: application/json Auktorisering: Bearer sessions-token, där sessions-token är det unika X-FM-Data-Access-Token-värdet för databassessionen |
Parametrar | Registrera data i JSON-format som innehåller par med fält och värde, som anger värden för fält som finns i mållayouten. Datan kan ange relaterade poster eller portaler som finns i layouten genom att använda portalData-specifikationen. Ett portalnamn kan vara antingen det objektnamn som visas i Granskaren i FileMaker Pro Advanced eller det relaterade tabellnamnet. Till exempel: {"fieldData": { "Strängfält": "värde_1", "Nummerfält": 99,99, "repetitionsFält(1)" : "fältVärde" } }
Obs!Om du vill skapa en tom post med standardvärden för varje fält anger du ett tomt dataobjekt i JSON-format som parameter. Till exempel: {"fieldData": { } }
Du kan köra FileMaker-scripts som en del av den här förfrågan genom att inkludera parametrarna |
Svar |
ID för den post som skapades samt en meddelandematris som visar felkoden 0. Till exempel: { "response": {"postId":147}, "messages":[{"code":"0","message":"OK"}] }
Mer information finns under Felsvar. |
Kommentarer
- När du skapar poster med hjälp av FileMaker Data API upprätthålls fältkontroll. Om datan inte godkänns enligt fältkontrollen får du ett felmeddelande och posten skapas inte.
Redigera en post
Om du vill redigera en post använder du en HTTP PATCH-metod med en records
-URL som anger databasnamn, layout och post-ID.
HTTP-metod | PATCH |
---|---|
URL | /fmi/data/v1/databases/databas-namn/layouts/layout-namn/records/post-id databas-namn – namnet på den värdbaserade databasen |
HTTP-header |
Content-Type: application/json Auktorisering: Bearer sessions-token, där sessions-token är det unika X-FM-Data-Access-Token-värdet för databassessionen |
Parametrar | Registrera data i JSON-format som innehåller par med fält och värde som du vill uppdatera. Datan kan ange relaterade poster eller portaler som finns i layouten genom att använda portalData-specifikationen. Ett portalnamn kan vara antingen det objektnamn som visas i Granskaren i FileMaker Pro Advanced eller det relaterade tabellnamnet.
Bara de fält du anger uppdateras, övriga fält i posten ändras inte. Om "{}" anges som Alternativ parameter: modifierings-ID ( Till exempel: { "fieldData": { "Förnamn": "Joe", }, "portalData": { "JobsTable": [ { "recordId": 70, "modId": 4, "Jobb::Namn": "Leverantör" } ] } }
Du kan köra FileMaker-scripts som en del av den här förfrågan genom att inkludera parametrarna |
Svar |
Ett tomt svar och en meddelandematris som visar felkoden 0. Till exempel: { "response": {}, "messages":[{"code":"0","message":"OK"}] }
Mer information finns under Felsvar. |
Kommentarer
- När du redigerar poster med hjälp av FileMaker Data API upprätthålls fältvalidering. Om datan inte godkänns enligt fältkontrollen får du ett felmeddelande och posten uppdateras inte.
-
Använd
deleteRelated
-syntaxen för att radera en relaterad post.Till exempel:
"deleteRelated" : "Beställningar.3"
Bara en relaterad post kan raderas för varje anrop för att redigera poster.
Radera en post
Om du vill radera en post använder du en HTTP PATCH-metod med en records
-URL som anger databasnamn, layout och post-ID.
HTTP-metod | DELETE |
---|---|
URL | /fmi/data/v1/databases/databas-namn/layouts/layout-namn/records/post-id databas-namn – namnet på den värdbaserade databasen Du kan köra FileMaker-scripts som en del av den här förfrågan genom att inkludera parametrarna |
HTTP-header | Auktorisering: Bearer sessions-token, där sessions-token är det unika X-FM-Data-Access-Token-värdet för databassessionen |
Parametrar | Inga. |
Svar |
Ett tomt svar och en meddelandematris som visar felkoden 0. Till exempel: { "response": {}, "messages":[{"code":"0","message":"OK"}] }
Mer information finns under Felsvar. |
Hämta en enstaka post
Om du vill hämta en post använder du en HTTP GET-metod med en records
-URL som anger databasnamn, layout och post-ID. Du kan även ange portalinformation för att begränsa hur många relaterade poster som returneras.
HTTP-metod | GET |
---|---|
URL | Format 1: /fmi/data/v1/databases/databas-namn/layouts/layout-namn/records/post-id
databas-namn – namnet på den värdbaserade databasen För portalnyckelordet: Portaldelen i URL:en är valfri. Om layouten innehåller portaler kan du ange portalnamnen för bättre prestanda. Om portaldelen utelämnas returnerar anropet alla relaterade poster i alla portaler i layouten. För För Om du vill ha svarsdatan i kontexten för en annan layout använder du parametern Du kan köra FileMaker-scripts som en del av den här förfrågan genom att inkludera parametrarna |
HTTP-header | Auktorisering: Bearer sessions-token, där sessions-token är det unika X-FM-Data-Access-Token-värdet för databassessionen |
Parametrar | Inget |
Svar |
Postdatan i JSON-format och en meddelandematris som visar felkoden 0. Till exempel: { "response": { "data": [ ... ] }, "messages": [{"code":"0","message":"OK"}] }
Mer information finns under Felsvar. |
Kommentarer
- Om du vill returnera data för specifika portalrader kan du använda
_offset.portal-namn
och_limit.portal-namn
, där portal-namn är namnet på portalen i Granskaren i FileMaker Pro Advanced. Om du utelämnar offset- och limit-värdena för portalrader är standardvärdet för offset 1 och standardvärdet för limit är 50.
Hämta en uppsättning poster
Hämta en uppsättning poster genom att använda en HTTP GET-metod med en records
-URL som anger databasnamn, layout och ytterligare information för att ange en startpost och antal poster. Ett annat alternativ är att ange sorteringsordning för posterna. Du kan även ange portalinformation för att begränsa hur många relaterade poster som returneras.
HTTP-metod | GET |
---|---|
URL |
Format 1 (returnerar upp till de första 100 posterna): databas-namn – namnet på den värdbaserade databasen För För För specifikationen För portalnyckelordet: Portaldelen i URL:en är valfri. Om layouten innehåller portaler kan det vara bra att ange portalnamnen av prestandaskäl. Om portaldelen utelämnas returnerar anropet alla relaterade poster i alla portaler i layouten. För För Om du vill ha svarsdatan i kontexten för en annan layout använder du parametern
Du kan köra FileMaker-scripts som en del av den här förfrågan genom att inkludera parametrarna |
HTTP-header | Auktorisering: Bearer sessions-token, där sessions-token är det unika X-FM-Data-Access-Token-värdet för databassessionen |
Parametrar | Inga |
Svar |
Postdatan i JSON-format och en meddelandematris som visar felkoden 0. Till exempel: { "response": { "data": [ ... ] }, "messages": [{"code":"0","message":"OK"}] }
Mer information finns under Felsvar. |
Kommentarer
- Om du utelämnar offset- och limit-värdena är standardvärdet för offset 1 och standardvärdet för limit är 100:
_offset=1&_limit=100
- Om du utelämnar nyckelordet sortOrder är standardvärdet
ascend
. Till exempel behandlas&_sort=[{ "fieldName": "postId" }]
som:&_sort=[{ "fieldName": "postId", "sortOrder": "ascend" }]
- Om du vill returnera data för specifika portalrader, använd
_offset.portal-namn
och_limit.portal-namn
, där portal-namn är namnet på portalen i Granskaren i FileMaker Pro Advanced. Om du utelämnar offset- och limit-värdena för portalrader är standardvärdet för offset 1 och standardvärdet för limit är 50.
Överföra containerdata
Om du vill överföra containerdata använder du en HTTP POST-metod med en containers
-URL som anger databasnamn, layoutnamn, post-ID, fältnamn och en fältrepetition.
HTTP-metod | POST |
---|---|
URL | Format: /fmi/data/v1/databases/databas-namn/layouts/layout-namn/records/post-id/containers/fält-namn/fält-repetition
|
HTTP-header |
Content-Type: multipart/form-data Auktorisering: Bearer sessions-token, där sessions-token är det unika X-FM-Data-Access-Token-värdet för databassessionen |
Parametrar | En MIME-dataström med flera delar (Content-Type: multipart/form-data) där containerfältobjektet definieras som en del med Använd ett bibliotek med stöd för att ange flera delar/formdata. |
Svar |
Ett tomt svar och en meddelandematris som visar felkoden 0. Till exempel: { "response": {}, "messages":[{"code":"0","message":"OK"}] }
Mer information finns under Felsvar. |
Kommentarer
- Containerfältet måste vara ett fält i tabellförekomsten för den angivna layouten. Det kan inte vara ett containerfält i en relaterad tabell.
- FileMaker Data API tillåter alla MIME-typer. MIME-typerna kontrolleras inte för att begränsa dem till de typer som stöds av FileMaker-program eller webbservern.
- FileMaker Data API cachelagrar containerfältdata i en cachemapp på huvuddatorn när de överförs, men de raderas när förfrågan är klar.
Utföra en sökning
Om du vill utföra en sökning använder du en HTTP POST-metod med en _find
-URL som anger databasnamn och layout samt ytterligare information för att ange sökfält och kriterier, sorteringsordning, startpost och antal poster. Du kan även ange portalinformation för att begränsa hur många relaterade poster som returneras.
HTTP-metod | POST |
---|---|
URL |
/fmi/data/v1/databases/databas-namn/layouts/layout-namn/_find databas-namn – namnet på den värdbaserade databasen |
HTTP-header |
Content-Type: application/json Auktorisering: Bearer sessions-token, där sessions-token är det unika X-FM-Data-Access-Token-värdet för databassessionen |
Parametrar | En fråga i JSON-format som anger fälten och sökkriterier. Valfria parametrar som anger förfrågningar om utelämning, sorteringsordning, startpost (offset), antal poster (limit) samt portaler för att begränsa hur många relaterade poster som returneras. Om du vill ha svarsdatan i kontexten för en annan layout använder du parametern Till exempel: { "query":[ {"Group": "=Kirurg"}, {"Delstat" : "NewYork", "omit" : "true"}], "sort":[ {"fieldName": "Delstat","sortOrder": "ascend"}, {"fieldName": "Förnamn", "sortOrder": "ascend"} ] }
Exempel med offset, limit och portaler: { "query":[ {"Group": "=Kirurg"}, {"Delstat" : "NewYork", "omit" : "true"}], "portal": ["Portal1","Portal2"], "limit": "10", "offset": "1", "offset.Portal1": "1", "limit.Portal1": "5", "layout.response": "Läkare" }
Du kan köra FileMaker-scripts som en del av den här förfrågan genom att inkludera parametrarna |
Svar |
Postdatan i JSON-format och en meddelandematris som visar felkoden 0. Till exempel: { "response": { "data": [ ... ] }, "messages": [{"code":"0","message":"OK"}] }
Mer information finns under Felsvar. |
Kommentarer
- I en databas som har många relaterade poster kan sökning och sortering av portalposter vara tidskrävande. Om du vill begränsa antalet poster och rader som ska visas i en relaterad uppsättning, ange parametrarna offset.portal-namn och limit.portal-namn.
- Du kan inte ange globala fält som sökkriterium. Om du anger ett globalt fält med en sökning får du ett felmeddelande. Ställ istället in det globala fältvärdet före sökningen. Mer information finns under Ställa in globala fältvärden.
Ställa in globala fältvärden
Om du vill ställa in värden för globala fält använder du en HTTP PATCH-metod med en globals
-URL som anger databasnamnet.
HTTP-metod | PATCH |
---|---|
URL | /fmi/data/v1/databases/databas-namn/globals databas-namn – namnet på den värdbaserade databasen |
HTTP-header |
Content-Type: application/json Auktorisering: Bearer sessions-token, där sessions-token är det unika X-FM-Data-Access-Token-värdet för databassessionen |
Parametrar | Ett JSON-objekt med par för fält och värden som anger vilka globala fält som ska ställas in. Globala fält måste anges med fullständiga fältnamn (tabellnamn::fältnamn). Till exempel: { "globalFields": { "basTabell::gFöretag":"FileMaker", "basTabell::gKod":"95054" } }
|
Svar |
Ett tomt svar och en meddelandematris som visar felkoden 0. Till exempel: { "response": {}, "messages":[{"code":"0","message":"OK"}] }
|
Köra FileMaker-scripts
Parameter | Värde |
---|---|
script
|
Namnet på scriptet som ska köras efter den åtgärd som anges av API-anropet (hämta, skapa, redigera, radera, sök) och efter den efterföljande sorteringen. |
script.param
|
Textsträngen som ska användas som parameter för scriptet med namnet script .
|
script.prerequest
|
Namnet på scriptet som ska köras före den åtgärd som anges av API-anropet och den efterföljande sorteringen. |
script.prerequest.param
|
Textsträngen som ska användas som parameter för scriptet som angavs med script.prerequest .
|
script.presort
|
Namnet på scriptet som ska köras efter den åtgärd som anges av API-anropet men före den efterföljande sorteringen. |
script.presort.param
|
Textsträngen som ska användas som parameter för scriptet som angavs med script.presort .
|
Ordning för att utföra scripts
Du kan ange parametrarna script.prerequest
, script.presort
och script
för ett enstaka API-anrop. Varje nyckelord kan bara anges en gång. FileMaker Server bearbetar dessa parametrar som en del av API-anropet i följande ordning:
- Gå till den layout som anges i URL:en.
- Utför det script som anges av
script.prerequest
om det har angivits. - Utför den åtgärd som anges av API-anropet (hämta, skapa, redigera, radera, sök).
- Utför det script som anges av
script.presort
om det har angivits. - Utför den sortering som angetts i API-anropet:
- För Hämta en uppsättning poster utförs den sortering som anges av parametern
_sort
. - För Utföra en sökning utförs den sortering som anges av parametern
sort
.
- För Hämta en uppsättning poster utförs den sortering som anges av parametern
- Utför det script som anges av
script
om det har angivits. - Returnera resultatuppsättningen för API-anropet, med verkställning av parametrarna offset och limit, om de har angivits.
Kommentarer
- För anrop som använder HTTP GET- och HTTP DELETE-metoderna inkluderas scriptingparametrar som URL-parametrar. Mer information finns under Hämta en enstaka post, Hämta en uppsättning poster och Radera en post.
- För anrop som använder HTTP POST- och HTTP PATCH-metoderna inkluderas scriptingparametrarna i förfrågan. Mer information finns under Skapa en post, Redigera en post och Utföra en sökning.
- För scriptparametrarna
script.param
,script.prerequest.param
ochscript.presort.param
kan du bara ange en enda textsträng. Om du vill skicka flera parametrar kan du skapa en sträng som avgränsar parametrarna och låta ditt script tolka de enskilda parametrarna. Till exempel kan du skicka "param1|param2|param3" som en lista med tecknet "|" URL-kodat som:param1%7Cparam2%7Cparam3
Till exempel:
https://<värd>/fmi/data/v1/databases/kunder/layouts/inmatning/records/14?script=UppdateringBearbetas&script.param=14
Till exempel:
{"query":[{"Titel":"Kontorschef"}], "script.prerequest":"Eliminera dubbletter"}
Felsvar
När det uppstår ett fel returnerar FileMaker Data API följande:
- En statuskod på HTTP 400-nivå för standardmässiga HTTP-fel
- En HTTP 500-statuskod för FileMaker Server-fel
HTTP-statuskod | HTTP-kategori | Beskrivning |
---|---|---|
400 | Ogiltig begäran | Inträffar när servern inte kan bearbeta förfrågan på grund av ett klientfel. |
401 | Otillåtet | Inträffar när klienten inte har behörighet att komma åt API:n. Om det här felet inträffar när man försöker logga in på en databassession är det problem med det angivna användarkontot eller lösenordet. Om det här felet inträffar med andra anrop har åtkomsttoken inte angetts eller så är den ogiltig. |
403 | Förbjudet | Inträffar när klienten är autentiserad men anropet försöker utföra en åtgärd som är förbjuden av en annan orsak. |
404 | Hittades inte | Inträffar om anropet använder en URL med ett ogiltigt URL-schema. Kontrollera angiven URL för syntaxfel. |
405 | Metoden är inte tillåten | Inträffar när en felaktig HTTP-metod används med ett anrop. |
415 | Medietypen stöds inte | Inträffar om den obligatoriska headern saknas eller inte är korrekt för förfrågan:
|
500 | FileMaker Server-fel | Innehåller FileMaker-felmeddelanden och -felkoder. Mer information finns i FileMaker-felkoder i FileMaker Pro Advanced Hjälp. |
Kommentarer
- Om FileMaker Data API-motorn inte körs eller inte kan nås returneras felkoder eller -meddelanden baserat på din webbserver (Apache eller IIS).
- Mer information om ytterligare HTTP-statuskoder finns i www.w3.org.
Vara värd för, testa och övervaka FileMaker Data API-lösningar
Vara värd för en FileMaker Data API-lösning
- Utför alla steg i Förbereda databaser för FileMaker Data API-åtkomst.
- Kontrollera att FileMaker Data API-åtkomst har aktiverats och konfigurerats korrekt i Admin Console. Mer information finns i FileMaker Server Hjälp.
- Kontrollera att webbservern och FileMaker Data API-motorn är i gång.
-
Använd kryptering för kommunikation.
FileMaker Data API kräver att dina REST API-program använder en HTTPS-anslutning. HTTPS-anslutningar använder SSL-kryptering (Secure Sockets Layer) för kommunikation.
FileMaker Server tillhandahåller ett SSL-standardcertifikat som signerats av FileMaker, Inc. men som inte verifierar servernamnet. FileMakers standardcertifikat är endast avsett att användas för intern testning. För produktion krävs ett eget SSL-certifikat. Mer information finns i Installations- och konfigurationsguiden för FileMaker Server.
Det språk eller den teknik du använder för att anropa FileMaker Data API måste ha stöd för Transport Layer Security (TLS) v1.2 för att kommunicera med webbservern.
Testa en FileMaker Data API-lösning
Innan du tillgängliggör din FileMaker Data API-lösning ska du kontrollera att den fungerar som förväntat.
- Testa funktioner som sökning och att lägga till och radera poster med olika konton och behörigheter.
- Kontrollera att behörighetsuppsättningarna fungerar som väntat genom att testa olika konton. Kontrollera att inga obehöriga användare kan komma åt och ändra dina data.
- Testa att din lösning fungerar på samma sätt när den anropas från olika operativsystem.
Övervaka FileMaker Data API-lösningar
Serveradministratören kan använda Admin Console för att starta eller stoppa FileMaker Data API-motorn, övervaka FileMaker Data API-klienter, spåra användning av FileMaker Data API-anrop och hämta loggfilen för FileMaker Data API.
För att | Använd |
---|---|
Starta eller stoppa FileMaker Data API-motorn | Fliken Kontakter > FileMaker Data API i Admin Console eller ett CLI-kommando. Mer information finns under "Starta eller stoppa FileMaker Server-komponenter" i FileMaker Server Hjälp. |
Övervaka FileMaker Data API-klienter | Klientlistan på sidan Databaser i Admin Console. På den här sidan finns detaljer om klienterna och om de databaser som används. Mer information finns i FileMaker Server Hjälp. Från den här sidan kan du koppla bort FileMaker Data API-klienter, men du kan inte skicka meddelanden till dem. |
Spåra användning av FileMaker Data API-anrop | Fliken Kontakter > FileMaker Data API i Admin Console. På den här fliken visas den årsgräns för FileMaker Data API som bestäms av din FileMaker Server-licens, hur mycket data som har överförts hittills under licensperioden samt förnyelsedatum för licensen. Om du närmar dig årsgränsen kan du höja den från fliken Administration > FileMaker-licenser i Admin Console. Mer information finns under FileMaker Data API-inställningar i FileMaker Server Hjälp. |
Visa loggen för FileMaker Data API |
När FileMaker Data API-klienter är anslutna till en databas loggas statistiska data om klienterna i fmdapi.log. Mer information finns under FileMaker Data API-logg i FileMaker Server Hjälp. |
FileMaker Data API-integration med Tableau
Om integration med Tableau
FileMaker Server innehåller Tableau Web Data Connector, en exempelimplementering som tar emot REST API-anrop i JSON-format. Använd Tableau Web Data Connector för att definiera en koppling mellan FileMaker Server och Tableau Desktop. Kopplingen använder FileMaker Data API för att importera data från värdbaserade FileMaker-databaser till Tableau Desktop.
Krav för Tableau Web Data Connector
- Tableau Desktop, minst version 10, för Windows eller macOS.
- En lösenordsskyddad FileMaker Pro Advanced-databas som innehåller de data som ska importeras. Databasen måste finns på en FileMaker Server-värd.
-
En giltig REST API-slutpunkt. För FileMaker Server är slutpunkten en HTML-kopplingspunkt som ger den information som krävs för webbtjänster. Slutpunkten har formatet
https://<värdnamn>/fmi/data/v1/tableau/fm_connector.html
därvärdnamn
är det fullständiga värdnamnet för din FileMaker Server.Till exempel:
https://minserver.mittföretag.com/fmi/data/v1/tableau/fm_connector.html
Ett giltigt eget SSL-certifikat på FileMaker Server. Tableau Web Data Connector tillåter inte import av data från FileMaker Server utan ett giltigt eget SSL-certifikat. Om din server kräver ett mellanliggande certifikat måste det installeras på den server där FileMaker Server är driftsatt. Starta om serverdatorn efter att ändringarna har gjorts i det installerade certifikatet och innan du kopplar till Tableau.
Obs!Om din server använder ett SAN-certifikat (Subject Alternative Name) måste värdnamnet matcha det nätverksnamn som används i SAN-certifikatet.
Förbereda för att importera data till Tableau
Följ stegen i Förbereda databaser för FileMaker Data API-åtkomst för att definiera layouten för import och för att aktivera databasen för FileMaker Data API-åtkomst.
Obs!När data ska importeras till Tableau måste tabellen ha minst en post med postdata.
Följande FileMaker-fälttyper importeras som Tableau-datatyper.
FileMaker-fälttyp | Tableau-datatyp |
---|---|
text | sträng |
datum | datum |
tid | sträng |
tidsstämpel | datumtid |
numeriskt | float |
Följande FileMaker-fälttyper stöds inte vid import till Tableau:
- containerfält
- statistikfält. Du kan skapa ett statistikfält i Tableau utifrån de data som du importerar från FileMaker.
- beräkningsfält. Du kan skapa ett beräkningsfält i Tableau utifrån de data som du importerar från FileMaker.
- diagramdata
- data från FileMaker Pro Advanced-portaler. Om du vill importera data från relaterade poster skapar du en FileMaker Pro Advanced-layout utifrån den relaterade tabellen. Du kan även importera data från separata FileMaker Pro Advanced-tabeller till Tableau och sedan slå ihop dem i Tableau.
- fältrepetitioner där visningen av repeterade fält för Visa repetitioner innehåller flera värden. Det finns stöd för en enstaka repetition.
- icke-numeriska värden i nummerfält. Om Tableau hittar icke-numeriska värden i nummerfält importeras inte datan.
Använd inte reserverade ord som fältnamn i FileMaker Pro Advanced.
Ställa in datakopplingen i Tableau Desktop
- I Tableau Desktop, under Connect (koppla) (på vänster sida av skärmen) väljer du More (mer)> Web Data Connector.
- Ange URL:en för din FileMaker Server-slutpunkt
https://<värdnamn>/fmi/data/v1/tableau/fm_connector.html
där<värdnamn>
är det fullständiga värdnamnet för din FileMaker Server. -
I dialogrutan Importera data från FileMaker-fil:
-
Logga in på FileMaker Pro Advanced-databasen genom att ange följande information eller genom att använda en OAuth-identitetsleverantör.
- Namn på källdatabas: namnet på FileMaker Pro Advanced-databasen
- Namn på källayout: namnet på FileMaker Pro Advanced-layouten
- Kontonamn: namnet på FileMaker Pro Advanced-kontot med fmrest-behörighet
- Lösenord: lösenordet för FileMaker Pro Advanced-kontot
- Välj Aktivera stegvis uppdatering för att aktivera stegvis uppdatering.
-
- Klicka på Importera FileMaker-data.
Tableau importerar datan. Bearbetningstiden beror på hur många poster som importeras, serverbelastningen och nätverksgenomströmningen. Tableau mappar FileMaker Pro Advanced-fältnamn och -data till mått och storlekar. Strängdata mappas vanligtvis till mått medan numeriska data mappas till storlekar. Mappningen sker automatiskt under import, men du kan anpassa det.
Kommentarer
-
När du anger Namn på källayout bör du kontrollera att layoutnamnet är unikt. Om din databas har två layouter med samma namn kan inte Tableau-datakopplingen skilja dem åt. Tableau visar bara ett namn och det kanske inte är den layout du ville ha.
-
Använd Aktivera stegvis uppdatering för att bara importera de nya posterna.
- När FileMaker-data har importerats med stegvis uppdatering väljer du fliken Sheet (ark) i Tableau för att gå till kalkylbladet.
- Välj Data > FM: databas-namn / layout-namn > Extrahera > Uppdatera (stegvis).
- Välj fliken Datakälla.
- Klicka på Uppdatera nu för att visa de nya posterna.
- När du aktiverar stegvis uppdatering skapas inte en fortlöpande realtidskoppling mellan Tableau och den värdbaserade FileMaker-databasen. Du måste köra stegvis uppdatering manuellt.
- Med stegvis uppdatering importeras bara de nya posterna. FileMaker Pro Advanced-poster som har ändrats eller raderats uppdateras inte. För att hämta ändrade data eller ta bort raderade poster måste du skapa ett nytt kalkylblad i Tableau och importera datan igen.
- Med stegvis uppdatering skapas ett fält med namnet -postID. Om du gör ändringar i det fältet kanske du inte kan göra stegvisa uppdateringar.
- I Tableau kan du ändra det schema och de data som har importerats. Men om du ändrar schema eller data i Tableau överförs de ändringarna inte tillbaka till FileMaker Pro Advanced-filen.
- Om du ändrar schemat i FileMaker Pro Advanced-filen måste du skapa ett nytt kalkylblad i Tableau och importera datan igen.
- Tableau Server för Windows kan vara värd för en Tableau Desktop-databas.
- Om du stänger Tableau-kalkylbladet och öppnar det igen fungerar det inte längre med stegvis import.
- När datakopplingen har etablerats till Tableau cachelagrar FileMaker Web Data Connector användarkontot och lösenordet tills kalkylbladet stängs, med följande omständigheter:
- Om FileMaker-sessionen avbryts medan du är kopplad till Tableau försöker FileMaker Web Data Connector att återansluta användaren till FileMaker Server.
- Om Tableau-kopplingen går ut försöker FileMaker Web Data Connector att återansluta till FileMaker Server så länge Tableau-kalkylbladet är öppet.
- Om kalkylbladet stängs och öppnas på nytt måste du ange kontonamn och lösenord igen under den första dataimporten.
- Sidan för Tableau-datakällan visar upp till 1 000 000 (en miljon) rader, även om fler poster importeras.