FileMaker 16 Data API ガイド

FileMaker Data API について

概要

FileMaker^® Data API は、共有ソリューションのデータに Web サービスからアクセスできるようにするアプリケーションプログラミングインターフェース (API) です。この API は REST (Representational State Transfer) アーキテクチャを使用しているため、FileMaker Data API は REST API です。

Web サービスまたはアプリケーションによる FileMaker Data API の呼び出しによって認証トークンを取得して共有ソリューションにアクセスします。以降の呼び出しでそのトークンを使用してレコードの作成、レコードの更新、レコードの削除、検索の実行を行います。

FileMaker Data API は、特定のプログラミング言語形式に依存しないことから REST API で一般的に使用されているテキスト形式 JSON (JavaScript Object Notation) でデータを返します。

このガイドでは、次の経験があることを想定しています:

FileMaker Pro を使用したデータベースの作成。データベースの設計の基礎、ならびにフィールド、リレーションシップ、レイアウト、ポータル、およびオブジェクトの概念について理解している必要があります。 FileMaker Pro ヘルプを参照してください。
FileMaker Server を使用したソリューションの共有。 FileMaker Server の展開方法、共有ソリューションへのアクセスを有効にする方法、および FileMaker Server Admin Console を使用して共有ソリューションを監視する方法について理解している必要があります。 FileMaker Server ヘルプを参照してください。
POST、GET、PUT、および DELETE メソッドと JSON 形式のデータを呼び出すサーバーサイドアプリケーションまたは Web サービスでの REST API の使用。任意のプログラミング言語またはプログラミングツールを使用できる必要があります。

FileMaker Data API を使用するには次の手順に従います:

FileMaker Pro を使用して FileMaker Data API アクセス用のデータベースを準備します。データベースを新規作成するか、または既存のデータベースを準備します。「FileMaker Data API アクセス用のデータベースの準備」を参照してください。
共有ソリューション内のレコードを検索、作成、編集、削除する FileMaker Data API メソッドを呼び出すコードを作成します。「FileMaker Data API 呼び出しの作成」を参照してください。
FileMaker Server を使用してソリューションを共有して FileMaker Data API アクセスを有効にします。「FileMaker Data API ソリューションの共有」を参照してください。
FileMaker Data API アクセスが正しく動作するかをテストします。「FileMaker Data API ソリューションのテスト」を参照してください。
Admin Console を使用して共有ソリューションを監視します。「FileMaker Data API ソリューションの監視」を参照してください。

FileMaker Data API 呼び出しの処理の流れ

FileMaker Data API のアーキテクチャ図 — FileMaker Data API のアーキテクチャ

REST API クライアントが、HTTPS ポート経由で FileMaker Server の Web サーバーに FileMaker Data API 呼び出し (HTTPS リクエスト) を送信します。 FileMaker Pro がインストールまたは実行されている必要はありません。

デフォルトの HTTPS ポートは 443 ですが、サーバー管理者は FileMaker Server のインストール時に別のポートを指定できます。
Web サーバーが、FileMaker Web サーバーモジュールを使用してリクエストを FileMaker Data API エンジンにルーティングします。
FileMaker Data API エンジンが、HTTPS リクエスト (URL および JSON データ) をデータベースサーバーコンポーネントが解釈できる形式に変換し、データベースサーバーで共有されているソリューションのデータを要求します。

FileMaker Data API エンジンでは、ポート 3000 および 8989 が利用可能な状態である必要があります。

データベースサーバーが要求された FileMaker データを FileMaker Data API エンジンに返します。

データベースサーバーでは、ポート 5003 が利用可能な状態である必要があります。

FileMaker Data API エンジンが FileMaker データを HTTPS 応答 (URL と JSON データ) に変換して Web サーバーにデータを渡すことで呼び出しに応答します。
Web サーバーが要求元の REST API クライアントに HTTPS 応答を送信します。

その他の Web 公開方法

FileMaker Data API アクセス用のデータベースの準備

アクセスするデータの決定

共有ソリューションの保護

FileMaker Data API アクセスの有効化

FileMaker Data API 呼び出しの作成

FileMaker Data API の機能

FileMaker Data API Reference

データ形式に関する注意点

REST API 呼び出しのコンポーネント

コンポーネント	説明
HTTP メソッド (HTTP 動詞)	FileMaker Data API は次の HTTP メソッドを使用します: POST ソリューションへのログイン、レコードの作成、および検索の実行で使用します。 GET 単一のレコードの取得およびレコードの範囲の取得で使用します。 PUT レコードの編集およびグローバルフィールドの値の設定で使用します。 DELETE ソリューションからのログアウトおよびレコードの削除で使用します。
HTTP ヘッダ	FileMaker Data API は次のヘッダを使用します: Content/Type: application/json ソリューションへのログイン、レコードの作成、およびレコードの編集で使用します。このヘッダでは、値として「application/json」のみを使用できます。このヘッダを使用する HTTP リクエストの場合、FileMaker Data API ではコンテンツが JSON でエンコードされている必要があります。 FM-Data-token: アクセストークンソリューションからのログアウト、レコードの作成、レコードの編集、レコードの削除、単一のレコードの取得、レコードの範囲の取得、検索の実行、およびグローバルフィールドの値の設定で使用します。「アクセストークン」の値は、ソリューションへのログイン時に返される固有のトークンです。共有ソリューションへのアクセスを認証するために必要になります。「ソリューションへのログイン」を参照してください。 X-FM-Data-Login-Type: oauth OAuth 資格情報を使用して共有ソリューションにログインする場合、OAuth アイデンティティプロバイダを使用したソリューションへのログインでのみ使用します。このヘッダでは、値として「oauth」のみを使用できます。
呼び出し URL	FileMaker Data API の URL はすべて次の文字列から始まります:`/fmi/rest/api/`
JSON 形式の引数データ	ソリューションからのログアウト、レコードの削除、単一のレコードの取得、またはレコードの範囲の取得では必要ありません。

データベースへの接続を確立または切断する呼び出し

FileMaker Data API ではアクセストークンを使用してデータベースへの接続を定義します。以降はその共有ソリューションに対するすべての呼び出しのヘッダでそのアクセストークンを使用する必要があります。アクセストークンは、ソリューションからログアウトするか、またはそのトークンを指定した最後の呼び出しから 15 分経過するまで有効です (トークンが有効な間は、そのトークンを指定して呼び出しを行うたびにセッションタイムアウトカウンタがゼロにリセットされます)。

ソリューションへのログイン

OAuth アイデンティティプロバイダを使用したソリューションへのログイン

共有ソリューションにログインするには、HTTP POST メソッドを使用して共有ソリューションの名前を auth URL で指定します。アカウント名とパスワードが認証されると、コードはソリューションへの接続を定義するアクセストークンを受け取ります。

HTTP メソッド	POST
URL	/fmi/rest/api/auth/solution solution – 共有データベースの名前
HTTP ヘッダ	Content/Type: application/json X-FM-Data-Login-Type: oauth
引数	認証用のコールバック URL が含まれる OAuth リクエスト ID、OAuth アイデンティティプロバイダから返された OAuth 識別子、ログイン後に切り替えるレイアウト。データはすべて JSON 形式である必要があります。例: `{ "oAuthRequestId":"E65B98CC17429CO643A31119F", "oAuthIdentifier":"B164A4629A776E5177445DR223", "layout":"連絡先" }`
応答	アクセストークン、現在のレイアウト、およびエラーコード 0。例: `{ "errorCode": "0", "layout": "連絡先", "token": "fdde35fa175eb1cc8621782fd327b191619fc32ed65efaab26d8" }` 「エラー応答」を参照してください。

OAuth 引数を JSON 形式で取得するには:

次の URL と HTTP GET メソッドを使用することにより、サポートされている OAuth プロバイダの一覧を取得します:
https://<ホスト>/fmws/oauthproviderinfo
<ホスト> は FileMaker Server 展開内のマスタマシンの IP アドレスまたはドメイン名です。一覧が JSON 形式で返されます。
サポートされている OAuth プロバイダを選択してソリューションの追跡 ID を取得します。
次の URL と HTTP GET メソッドを使用します:
http://<ホスト>/oauth/getoauthurl?trackingID=追跡 ID&provider=OAuth プロバイダ&address=127.0.0.1&X-FMS-OAuth-AuthType=2
<ホスト> は FileMaker Server 展開内のマスタマシンの IP アドレスまたはドメイン名、「追跡 ID」は開発者がソリューション用に生成した追跡 ID、「OAuth プロバイダ」は選択した OAuth プロバイダの名前です。

このリクエストの HTTP ヘッダには次の情報を含める必要があります:
- X-FMS-Application-Type: 9
- X-FMS-Application-Version: 15
- X-FMS-Return-URL: http://127.0.0.1/
X-FMS-Request-ID データの応答ヘッダを読み取ります。この応答ヘッダにはログインに使用する OAuth リクエスト ID が含まれています。
X-FMS-Return-URL データの応答ヘッダを読み取ります。この引数で返された URL を呼び出すことによって、ユーザが OAuth プロバイダから認証を受けられるようになります。
OAuth プロバイダから返される「識別子」はログインに使用する OAuth 識別子の引数です。

FileMaker Pro ヘルプの「OAuth アイデンティティプロバイダで認証するアカウントの作成」を参照してください。

ソリューションからのログアウト

レコードを操作する呼び出し

レコードの作成

レコードを作成するには、HTTP POST メソッドを使用してソリューション名とレイアウトを record URL で指定します。

HTTP メソッド	POST
URL	/fmi/rest/api/record/solution/layout solution – 共有データベースの名前 layout – レコード作成のためのコンテキストとして使用するレイアウトの名前
HTTP ヘッダ	Content/Type: application/json FM-Data-token、ソリューションにログインした呼び出しに返されたアクセストークンを指定
引数	目的のレイアウト内にあるフィールドに値を指定するフィールド/値ペアが含まれた JSON 形式のレコードデータ。例: `{"data": { "フィールド 1": "値 1", "フィールド 2": "値 2", "繰り返しフィールド (1)" : "フィールド値", "注文::注文日.0":"12/22/2015" } }` メモ: 各フィールドのデフォルト値が空のレコードを作成するには、引数として空のデータオブジェクトを JSON 形式で指定します。例: `{"data": { } }`
応答	エラーコード 0 および作成されたレコードのレコード ID。例: `{ "errorCode": "0", "recordId": "25" }` 「エラー応答」を参照してください。

メモ

レコードの編集

レコードを編集するには、HTTP PUT メソッドを使用してソリューション名、レイアウト、およびレコード ID を record URL で指定します。

HTTP メソッド	PUT
URL	/fmi/rest/api/record/solution/layout/recordid solution – 共有データベースの名前 layout – レコード編集のためのコンテキストとして使用するレイアウトの名前 recordid – 編集するレコードのレコード ID
HTTP ヘッダ	Content/Type: application/json FM-Data-token、ソリューションにログインした呼び出しに返されたアクセストークンを指定
引数	更新するフィールド/値ペアが含まれた JSON 形式のレコードデータ。このデータでレイアウト上にある関連レコードまたはポータルを指定することもできます。指定したフィールドのみが更新されます。レコード内の他のフィールドは変更されません。データ値として「{}」を指定した場合、目的のレコードは更新されません。オプションの引数: 修正 ID。修正 ID を指定すると、現在のバージョンのレコードを編集することができます。修正 ID の値がデータベース内の現在の修正 ID の値と一致しない場合、レコードは変更されません。例: `{"data": { "名": "Bob", "姓": "Smith", "機器 (2)" : "PC", "注文::注文日.2":"12/20/2017", "注文::注文日.0":"12/22/2017", // recordId が 0 の「注文」関連レコードを作成 "deleteRelated": "注文.3" // "deleteRelated" 文字列を使用して「注文」関連レコードを削除 }, modId: "3" }`
応答	エラーコード 0 および編集されたレコードのレコード ID。例: `{ "errorCode": "0", "recordId": "53" }` 「エラー応答」を参照してください。

メモ

レコードの削除

HTTP メソッド	DELETE
URL	/fmi/rest/api/record/solution/layout/recordid solution – 共有データベースの名前 layout – レコード削除のためのコンテキストとして使用するレイアウトの名前 recordid – 削除するレコードのレコード ID
HTTP ヘッダ	FM-Data-token、ソリューションにログインした呼び出しに返されたアクセストークンを指定
引数	なし
応答	エラーコード 0。例: `{ "errorCode": "0" }` 「エラー応答」を参照してください。

単一のレコードの取得

単一のレコードを取得するには、HTTP GET メソッドを使用してソリューション名、レイアウト、およびレコード ID を record URL で指定します。ポータル情報を指定して返される関連レコードの数を制限することもできます。

HTTP メソッド	GET
URL	形式 1: /fmi/rest/api/record/solution/layout/recordid 形式 2: /fmi/rest/api/record/solution/layout/recordid?portal=["ポータル名-n", ...] solution – 共有データベースの名前 layout – レコード取得のためのコンテキストとして使用するレイアウトの名前 recordid – 取得するレコードのレコード ID portal キーワードについて: 「ポータル名-n」は関連レコードが含まれているポータルです。ポータル名は FileMaker Pro のインスペクタに表示されます。複数のポータル名を指定することができます。 URL の portal 部分はオプションです。レイアウトに複数のポータルが含まれている場合は、パフォーマンスを向上させるためにポータル名を指定します。 portal 部分を省略した場合、呼び出しによってレイアウト上のすべてのポータルにあるすべての関連レコードが返されます。
HTTP ヘッダ	FM-Data-token、ソリューションにログインした呼び出しに返されたアクセストークンを指定
引数	なし
応答	エラーコード 0 および JSON 形式のレコードデータ。例: `{ "errorCode": "0", "record": "{...}" }` 「エラー応答」を参照してください。

メモ

レコードの範囲の取得

レコードの範囲を取得するには、HTTP GET メソッドを使用してソリューション名、レイアウト、および開始レコードとレコード数を指定する追加情報を record URL で指定します。オプションでレコードのソート順を指定できます。ポータル情報を指定して返される関連レコードの数を制限することもできます。

HTTP メソッド	GET
URL	形式 1: /fmi/rest/api/record/solution/layout?offset=開始レコード&range=レコード数形式 2: /fmi/rest/api/record/solution/layout?offset=開始レコード&range=レコード数&sort=[{ "fieldName":"フィールド名", "sortOrder":"ascend \| descend \| 値一覧名" }, ...] 形式 3: /fmi/rest/api/record/solution/layout?offset=開始レコード&range=レコード数?portal=["ポータル名-n", ...] solution – 共有データベースの名前 layout – レコード取得のためのコンテキストとして使用するレイアウトの名前開始レコード – レコード範囲の最初のレコードのレコード番号レコード数 – 取得するレコード範囲にあるレコード数 sort の指定では情報を JSON 形式で指定する必要があります。フィールド名はレコードのソート基準として使用するフィールドの名前です。複数のフィールド名を指定することができます。ソート順には「ascend」または「descend」キーワードを指定するか、あるいは「値一覧名」に値一覧の名前を指定します。 portal キーワードについて: 「ポータル名-n」は関連レコードが含まれているポータルです。ポータル名は FileMaker Pro のインスペクタに表示される名前です。複数のポータル名を指定することができます。 URL の portal 部分はオプションです。レイアウトに複数のポータルが含まれている場合は、パフォーマンスを向上させるためにポータル名を指定することができます。 portal 部分を省略した場合、呼び出しによってレイアウト上のすべてのポータルにあるすべての関連レコードが返されます。
HTTP ヘッダ	FM-Data-token、ソリューションにログインした呼び出しに返されたアクセストークンを指定
引数	なし
応答	エラーコード 0 および JSON 形式のレコードデータの範囲。例: `{ "errorCode": "0", "records": "[...]" }` 「エラー応答」を参照してください。

メモ

検索を実行する呼び出し

検索を実行するには、HTTP POST メソッドを使用してソリューション名およびレイアウトと、クエリーフィールド、クエリー条件、ソート順、開始レコード、およびレコード数を指定する追加情報を find URL で指定します。ポータル情報を指定して関連レコードを検索することもできます。

HTTP メソッド	POST
URL	/fmi/rest/api/find/solution/layout solution – 共有データベースの名前 layout – 検索条件のコンテキストとして使用するレイアウト
HTTP ヘッダ	FM-Data-token、ソリューションにログインした呼び出しに返されたアクセストークンを指定
引数	フィールドおよび検索条件を指定する JSON 形式のクエリー。除外リクエスト、ソート順、開始レコード (オフセット)、レコード数 (範囲)、および返される関連レコード数を制限するためのポータルを指定するオプション引数。例: `{ "query":[ {"Group": "=外科医", "勤務先の都道府県" : "東京都"}, {"Group": "=外科医", "勤務先の市区町村" : "港区", "omit" : "true"}], "sort":[ {"fieldName": "勤務先の都道府県","sortOrder": "ascend"}, {"fieldName": "名", "sortOrder": "ascend"} ] }` オフセット、範囲、およびポータルの使用例: `{ "query":[ {"Group": "=外科医", "勤務先の都道府県" : "東京都"}, {"Group": "=外科医", "勤務先の市区町村" : "港区", "omit" : "true"}], "portal": ["ポータル 1","ポータル 2"], "range": "10", "offset": "1", "offset.Portal1": "1", "range.Portal1": "5" }`
応答	エラーコード 0 および対象レコードの JSON 表現。例: `{ "errorCode": "0", "data": [レコード 1, レコード 2, ...] }` 「エラー応答」を参照してください。

メモ

グローバルフィールドの値を設定する呼び出し

HTTP メソッド	PUT
URL	/fmi/rest/api/global/solution/layout solution – 共有データベースの名前 layout – グローバルフィールドのコンテキストに使用するレイアウト
HTTP ヘッダ	FM-Data-token、ソリューションにログインした呼び出しに返されたアクセストークンを指定
引数	設定するグローバルフィールドを指定するフィールド/値ペアが含まれる JSON オブジェクト。例: `{ "globalFields": { "gCompany":"FileMaker", "gCode":"95054" } }`
応答	エラーコード 0。例: `{ "errorCode": "0" }` 「エラー応答」を参照してください。

エラー応答

エラーが発生した場合、FileMaker Data API は一般に HTTP 400 番台のステータスコードと追加情報を JSON オブジェクトで返します。

HTTP ステータスコード	HTTP カテゴリ	JSON エラー形式	説明
400	不正なリクエスト	`{ "errorMessage": "エラーの詳細" }`	クライアントエラーのためサーバーがリクエストを処理できない場合に発生します。
401	権限がありません	`{ "errorMessage": "Unauthorized" }`	クライアントが API にアクセスする権限がない場合に発生します。共有ソリューションへのログイン試行中にこのエラーが起きた場合、指定されたユーザアカウントまたはパスワードに問題があります。他の呼び出しでこのエラーが起きた場合、アクセストークンが指定されていないか、または無効です。
404	見つかりません	`{ "errorMessage": "Not found" }`	呼び出しが無効な URL スキーマの URL を使用した場合に発生します。指定した URL に構文エラーがないか確認してください。
415	サポートされていないメディアタイプ	`{ "errorMessage": "Unsupported Media Type" }`	「Content/Type: application/json」ヘッダが指定されていないか、または「application/json」タイプの代わりに別のコンテンツタイプが指定された場合に発生します。
477	FileMaker サービスエラー	`{ "errorMessage": "FileMaker エラーメッセージ", "errorCode": "FileMaker エラーコード" }`	FileMaker のエラーメッセージとエラーコードが含まれます。 FileMaker Pro ヘルプの「FileMaker エラーコード」を参照してください。

メモ

FileMaker Data API ソリューションの共有、テスト、監視

FileMaker Data API ソリューションの共有

FileMaker Data API ソリューションのテスト

FileMaker Data API ソリューションの監視

サーバー管理者は Admin Console を使用して FileMaker Data API エンジンの起動と停止、FileMaker Data API 設定の変更、FileMaker Data API クライアントの監視、FileMaker Data API 呼び出しの使用の追跡、および FileMaker Data API ログファイルの表示を実行できます。

目的	用途
FileMaker Data API エンジンを起動または停止する	Admin Console の [ステータス] パネルまたは CLI コマンド。 FileMaker Server ヘルプの「FileMaker Server コンポーネントの起動または停止」および「コマンドラインインターフェースの使用」を参照してください。
FileMaker Data API 設定を変更する	Admin Console の [Web 公開] > [FileMaker Data API] タブ。このタブで、FileMaker Data API の使用の有効化、FileMaker Data API 呼び出しのログの有効化、FileMaker Data API ログファイルの最大サイズの設定、およびログファイルに書き込まれるメッセージのログレベルの設定を行います。 FileMaker Server ヘルプの「FileMaker Data API 設定」を参照してください。
FileMaker Data API クライアントを監視する	Admin Console の [アクティビティ] > [クライアント] タブ。このタブには、クライアントの詳細とアクセスされているソリューションの詳細が表示されます。 FileMaker Server ヘルプの「クライアントの管理」を参照してください。このタブから FileMaker Data API クライアントを切断できますが、クライアントにメッセージを送信することはできません。 FileMaker Data API クライアントがソリューションに接続している間、クライアントに関する使用状況データが Admin Console の [使用状況] > [クライアント] タブに表示されます。 FileMaker Server ヘルプの「クライアントの使用状況の表示」を参照してください。
FileMaker Data API 呼び出しの使用を追跡する	Admin Console の [Web 公開] > [FileMaker Data API] タブ。このタブには、FileMaker Server ライセンスで許可されている FileMaker Data API 呼び出し数、今月使用された呼び出し数、および先月使用された呼び出し数が表示されます。呼び出し数の制限に近づいた場合には呼び出しを追加購入することもできます。 FileMaker Server ヘルプの「FileMaker Data API 設定」を参照してください。
FileMaker Data API のログを表示する	Admin Console の [ログビューア] タブ。 FileMaker Data API コンポーネントによって FileMaker Data API を使用して共有ソリューションにアクセスするクライアントに関連するログ情報が生成されます。 FileMaker Server ヘルプの「FileMaker Data API のログ」を参照してください。

FileMaker Data API と Tableau との統合

Tableau との統合について

Tableau Web データコネクタの必要条件

Tableau へのデータのインポート準備

「FileMaker Data API 用のデータベースの準備」の手順に従い、インポート用のレイアウトを定義して FileMaker Data API アクセス用のデータベースを有効にします。

メモ: データを Tableau にインポートするには、レコードデータのあるレコードがテーブルに 1 つ以上含まれている必要があります。

次の FileMaker フィールドタイプは Tableau データ型としてインポートされます。

FileMaker フィールドタイプ	Tableau データ型
テキスト	string
日付	date
時刻	string
タイムスタンプ	datetime
数字	float

次の FileMaker フィールドタイプは Tableau へのインポート時にサポートされません:

オブジェクトフィールド
集計フィールド。 FileMaker からインポートするデータに基づいて Tableau で集計フィールドを作成することができます。
計算フィールド。 FileMaker からインポートするデータに基づいて Tableau で計算フィールドを作成することができます。
グラフデータ
FileMaker Pro ポータルからのデータ。関連レコードからデータをインポートするには、関連テーブルに基づく FileMaker Pro レイアウトを作成するか、または別の FileMaker Pro テーブルから Tableau へデータをインポートしてから Tableau でテーブルを結合します。
繰り返しフィールドの [繰り返しを表示] 設定の表示に複数の値が含まれているフィールドの繰り返し。単一の繰り返しはサポートされます。
数字フィールドの数値以外の値。Tableau が数字フィールドで数値以外の値を検出した場合、そのデータはインポートされません。

FileMaker Pro でフィールド名として予約されている単語を使用しないでください。

Tableau Desktop でのデータ接続の設定

Tableau Desktop の [接続] (画面の左側) で、[その他のサーバー...] > [Web データコネクタ] を選択します。
FileMaker Server エンドポイントの URL を入力します:
https://<ホスト名>/fmi/rest/tableau/fm_connector.html
<ホスト名> は FileMaker Server の完全修飾ホスト名です。
[FileMaker ファイルからのデータのインポート] ダイアログボックスで次の操作を行います:
- 次の情報を入力するか OAuth アイデンティティプロバイダを使用して FileMaker Pro ソリューションにサインインします。
  - [ソースデータベース名]: FileMaker Pro ソリューションの名前
  - [ソースレイアウト名]: FileMaker Pro レイアウトの名前
  - [アカウント名]: fmrest アクセス権のある FileMaker Pro アカウントの名前
  - [パスワード]: FileMaker Pro アカウントのパスワード
- [増分更新を有効にする] を選択して増分更新を有効にします。
[FileMaker データのインポート] をクリックします。

Tableau によりデータがインポートされます。処理時間はインポートするレコード数、サーバーの負荷、およびネットワークスループットによって変わります。 Tableau によって FileMaker Pro フィールド名およびデータがディメンションおよびメジャーにマッピングされます。通常、文字列データはディメンションにマッピングされ、数値データはメジャーにマッピングされます。マッピングはインポート中に自動的に行われますが、カスタマイズすることもできます。

メモ

[ソースレイアウト名] を指定する際はレイアウト名が固有であることを確認してください。データベースに同じ名前のレイアウトが 2 つある場合、Tableau データ接続ではその 2 つを区別できません。 Tableau には名前が 1 つのみ表示され、それが必要としていたレイアウトではない可能性もあります。
新規レコードのみをインポートするには、[増分更新を有効にする] を使用します。
1. 増分更新を有効にして FileMaker データをインポートした後に、Tableau の [シート] タブを選択してワークシートに移動します。
2. [データ] > [FM: ソリューション名 / レイアウト名] > [抽出] > [更新 (増分)] を選択します。
3. [データソース] タブを選択します。
4. [更新] をクリックして新規レコードを表示します。
増分更新を有効にしても、共有されている FileMaker データベースと Tableau 間に継続的なライブ接続は確立されません。増分更新を手動で実行する必要があります。
増分更新では、新規レコードのみがインポートされます。変更または削除された FileMaker Pro レコードは更新されません。変更データを取得するか削除されたレコードを取り除くには、Tableau でワークブックを新規作成してデータを再インポートする必要があります。
増分更新では、-recordId という名前のフィールドが作成されます。このフィールドを変更すると、増分更新を実行できなくなる可能性があります。
Tableau で、インポートされたスキーマおよびデータを変更できます。ただし、Tableau でスキーマまたはデータを変更しても、これらの変更は FileMaker Pro ファイルに送信されません。
FileMaker Pro ファイルでスキーマを変更した場合は、Tableau でワークブックを新規作成してデータを再インポートする必要があります。
Tableau Desktop データベースは、Tableau Server for Windows 上で共有することができます。
Tableau ワークブックを閉じてから再度開くと、増分インポートが動作しなくなります。
Tableau へのデータ接続が確立されると、次の状況を考慮して、ワークブックが閉じられるまで FileMaker Web データコネクタによってユーザアカウントとパスワードがキャッシュされます:

Tableau に接続している間に FileMaker セッションがタイムアウトになった場合、FileMaker Web データコネクタは FileMaker Server へのユーザの再接続を試行します。
Tableau 接続が期限切れになった場合、Tableau ワークブックが開いている限り、FileMaker Web データコネクタは FileMaker Server への再接続を試行します。
ワークブックを閉じてから再度開いた場合は、最初のデータインポート時にアカウント名とパスワードを再入力する必要があります。

Tableau の [データソース] ページには、最大 1,000,000 (100 万) 行が表示されます。これより多くのレコードがインポートされた場合も同様です。

HTTP メソッド	POST
URL	/fmi/rest/api/auth/solution solution – 共有データベースの名前
HTTP ヘッダ	Content/Type: application/json
引数	共有ソリューションにログインするためのアカウント名とパスワード、およびログイン後に切り替えるレイアウト (JSON 形式)。例: `{ "user":"admin", "password":"admin", "layout":"タスク" }`
応答	アクセストークン、現在のレイアウト、およびエラーコード 0。例: `{ "errorCode": "0", "layout": "タスク", "token": "fdde29fa175eb1cc8347512ca327b191619fc32ed65efaab26d8" }` 「エラー応答」を参照してください。