こんにちは。リナークのニシザワです。
今回は「FileMaker Data APIを実行」スクリプトのReadアクションについて解説します。
FileMakerを利用していると「データの取得に時間がかかる」「テーブルオカレンスが複雑で扱いづらい」と感じることはありませんか？特に特定の条件に基づいてデータを抽出する場合、複雑なリレーションや設定を管理するのは煩雑です。
そんなときに便利なのが「FileMaker Data APIを実行」スクリプトのReadアクションです。このアクションを活用すれば、複雑な設定を必要とせずに、データベース内の必要な情報をすばやく取得できます。例えば、特定の会員IDや会社名に基づいたデータを簡単に抽出でき、業務効率が大幅に向上します。
今回は、会員テーブルのデモデータを使いながら、Readアクションを実際にどのように利用できるのかを解説していきます。さらに、記事の最後にサンプルソリューションをダウンロードできます。是非、ダウンロードして実際の動作をご確認ください。
目次
Readアクションとは？
「FileMaker Data APIを実行」スクリプトのReadアクションは、データベースに保存されている情報を柔軟に取得するためのツールです。従来のFileMakerのデータ取得方法では、テーブルオカレンスや複雑なリレーションの管理が必要でしたが、Readアクションを使うことで、シンプルかつ迅速にデータを取得できます。
たとえば、特定の条件に合致するレコードを効率的に抽出したり、必要なフィールドだけを選んで取得したりすることが可能です。さらに、取得するデータの並べ替えや複数条件を組み合わせたフィルタリングも簡単に行えます。
デモデータを使った例
今回の記事では、会員テーブルのデモデータを使って、Readアクションの具体的な使い方を解説します。このテーブルには、以下のフィールドが含まれています。
- ID：各会員を一意に識別するUUID
- クレジットカード番号：会員のクレジットカード情報
- マイナンバー：会員の個人識別番号
- メールアドレス：会員の連絡先メール
- 会社名：会員が所属する企業名
- 住所：会員の所在地
- 名前：会員の氏名
- 誕生日：会員の誕生日
- 電話番号：連絡用の電話番号
- 性別：男性、女性などの性別
これらの情報を基に、特定の会員を検索したり、特定の条件に合致する会員リストを取得する方法を見ていきましょう。
ステップ1：特定の会員データを取得する
ずは、Readアクションを使って特定の会員のデータを取得する方法を解説します。デモデータとして利用している会員テーブルには、ID、名前、メールアドレス、会社名などのフィールドが含まれていますが、ここでは会員IDに基づいて1人の会員データを取得する例を見ていきます。
特定の会員IDに基づいたデータ取得
例えば、会員IDが「5212FA8A-5607-479B-81DC-3C40A46C3BB2」である会員のデータを取得したい場合、次のようにクエリを設定します。
{
"action" : "read",
"layouts" : "T001_会員.API",
"query" :
[
{
"__id" : "5212FA8A-5607-479B-81DC-3C40A46C3BB2"
}
]
}「FileMaker Data APIを実行」スクリプトでは、デフォルトで "action" : "read" が設定されています。そのため、通常はこの記述を省略しても問題ありませんが、今回は明示的に記述しています。
このクエリを実行すると、指定した会員IDに一致する会員のデータ（名前、住所、メールアドレス、会社名など）が取得されます。
結果
実行すると、以下のような会員データが返されます。
{
"messages" :
[
{
"code" : "0",
"message" : "OK"
}
],
"response" :
{
"data" :
[
{
"fieldData" :
{
"__id" : "5212FA8A-5607-479B-81DC-3C40A46C3BB2",
"za_accountCreated" : "Administrator",
"za_accountModified" : "Administrator",
"za_timestampCreated" : "09/18/2024 08:48:38",
"za_timestampModified" : "09/18/2024 08:48:38",
"za_trigger_modified" : "08:48:38",
"クレジットカード" : "376806723547663",
"マイナンバー" : "955004502060",
"メールアドレス" : "morinagamasayuki_14617422@hotmaill.com",
"会社名" : "株式会社K2",
"住所" : "東京都町田市東玉川学園2-3-8",
"名" : "雅之",
"名_ひらがな" : "まさゆき",
"姓" : "森永",
"姓_ひらがな" : "もりなが",
"年齢" : "52",
"性別" : "男",
"携帯電話番号" : "070-3295-7760",
"有効期限" : "08/26",
"生年月日" : "1972年03月11日",
"血液型" : "A",
"郵便番号" : "176-2122",
"電話番号" : "03-7738-3530"
},
"modId" : "0",
"portalData" : {},
"recordId" : "20001"
}
],
"dataInfo" :
{
"database" : "FileMaker_data_api",
"foundCount" : 1,
"layout" : "T001_会員.API",
"returnedCount" : 1,
"table" : "T001_会員",
"totalRecordCount" : 10000
}
}
}このように、特定の会員IDに紐づく情報を簡単に取得することができます。
特定の顧客に関する情報を素早く検索したい場合やIDに基づいたデータをシステムに提供したい場合に非常に役立ちます。
実務への応用
- 顧客情報の確認：顧客対応の場面で、IDを基に顧客情報を即座に確認したい場合に便利です。
- レポート生成：特定の顧客の履歴や情報を取得し、レポートを生成する際にも活用できます。
- 外部連携：他のシステムと連携する際に、IDを指定して必要なデータだけを取得し、さらに外部システムに渡す処理を効率化できます。
ステップ2：特定の条件に基づいて会員データをフィルタリングする
次に、特定の条件に基づいて複数の会員データを取得する方法について解説します。たとえば、特定の会社に所属するすべての会員情報を抽出したい場合や、特定の地域に住む会員をフィルタリングしてリスト化したい場合など、条件に基づいたデータ取得がReadアクションの強みです。
例1：会社名で会員を絞り込む
{
"action" : "read",
"layouts" : "T001_会員.API",
"query" :
[
{
"会社名" : "株式会社K2"
}
]
}このクエリを実行すると、会社名が「株式会社K2」に該当する会員データが取得されます。
結果
{
"messages" :
[
{
"code" : "0",
"message" : "OK"
}
],
"response" :
{
"data" :
[
{
"fieldData" :
{
"__id" : "5212FA8A-5607-479B-81DC-3C40A46C3BB2",
"za_accountCreated" : "Administrator",
"za_accountModified" : "Administrator",
"za_timestampCreated" : "09/18/2024 08:48:38",
"za_timestampModified" : "09/18/2024 08:48:38",
"za_trigger_modified" : "08:48:38",
"クレジットカード" : "376806723547663",
"マイナンバー" : "955004502060",
"メールアドレス" : "morinagamasayuki_14617422@hotmaill.com",
"会社名" : "株式会社K2",
"住所" : "東京都町田市東玉川学園2-3-8",
"名" : "雅之",
"名_ひらがな" : "まさゆき",
"姓" : "森永",
"姓_ひらがな" : "もりなが",
"年齢" : "52",
"性別" : "男",
"携帯電話番号" : "070-3295-7760",
"有効期限" : "08/26",
"生年月日" : "1972年03月11日",
"血液型" : "A",
"郵便番号" : "176-2122",
"電話番号" : "03-7738-3530"
},
"modId" : "0",
"portalData" : {},
"recordId" : "20001"
},
{
"fieldData" :
{
"__id" : "30ADF14F-1936-47F0-991F-E7DC812F0AC3",
"za_accountCreated" : "Administrator",
"za_accountModified" : "Administrator",
"za_timestampCreated" : "09/18/2024 08:48:39",
"za_timestampModified" : "09/18/2024 08:48:39",
"za_trigger_modified" : "08:48:39",
"クレジットカード" : "5503719177090863",
"マイナンバー" : "117972033132",
"メールアドレス" : "morikawa512_53480860@yahoo.co.jp",
"会社名" : "株式会社K2",
"住所" : "東京都大田区蒲田1-5-108モンラヴィ608",
"名" : "文江",
"名_ひらがな" : "ふみえ",
"姓" : "森川",
"姓_ひらがな" : "もりかわ",
"年齢" : "30",
"性別" : "女",
"携帯電話番号" : "080-8966-9761",
"有効期限" : "07/29",
"生年月日" : "1994年05月12日",
"血液型" : "O",
"郵便番号" : "209-3475",
"電話番号" : "03-9744-3737"
},
"modId" : "0",
"portalData" : {},
"recordId" : "22026"
},
{
"fieldData" :
{
"__id" : "E4CDB24F-3F74-4B79-A033-E8057FDBA196",
"za_accountCreated" : "Administrator",
"za_accountModified" : "Administrator",
"za_timestampCreated" : "09/18/2024 08:48:39",
"za_timestampModified" : "09/18/2024 08:48:39",
"za_trigger_modified" : "08:48:39",
"クレジットカード" : "4630012975914529",
"マイナンバー" : "662250929660",
"メールアドレス" : "shouko_itonaga_57807994@gmail.com",
"会社名" : "株式会社K2",
"住所" : "神奈川県川崎市宮前区土橋1-5-405プラネ315",
"名" : "翔子",
"名_ひらがな" : "しょうこ",
"姓" : "糸永",
"姓_ひらがな" : "いとなが",
"年齢" : "36",
"性別" : "女",
"携帯電話番号" : "090-0157-4357",
"有効期限" : "09/27",
"生年月日" : "1988年07月09日",
"血液型" : "O",
"郵便番号" : "215-6756",
"電話番号" : "0460-60-8670"
},
"modId" : "0",
"portalData" : {},
"recordId" : "28343"
},
{
"fieldData" :
{
"__id" : "F537E180-3472-4EB7-BDFE-C1BF386CB60F",
"za_accountCreated" : "Administrator",
"za_accountModified" : "Administrator",
"za_timestampCreated" : "09/18/2024 08:48:39",
"za_timestampModified" : "09/18/2024 08:48:39",
"za_trigger_modified" : "08:48:39",
"クレジットカード" : "379486545321089",
"マイナンバー" : "150077531884",
"メールアドレス" : "moriemiko_96024829@yahoo.co.jp",
"会社名" : "株式会社K2",
"住所" : "東京都東村山市秋津町3-1-604",
"名" : "恵美子",
"名_ひらがな" : "えみこ",
"姓" : "森",
"姓_ひらがな" : "もり",
"年齢" : "47",
"性別" : "女",
"携帯電話番号" : "070-1877-8948",
"有効期限" : "10/24",
"生年月日" : "1976年11月12日",
"血液型" : "B",
"郵便番号" : "165-3068",
"電話番号" : "03-8134-0476"
},
"modId" : "0",
"portalData" : {},
"recordId" : "28623"
},
{
"fieldData" :
{
"__id" : "30A49596-4A94-4AFD-A88D-5587765FEE36",
"za_accountCreated" : "Administrator",
"za_accountModified" : "Administrator",
"za_timestampCreated" : "09/18/2024 08:48:39",
"za_timestampModified" : "09/18/2024 08:48:39",
"za_trigger_modified" : "08:48:39",
"クレジットカード" : "373040275688310",
"マイナンバー" : "879657336337",
"メールアドレス" : "kataokashinji_38983963@gmail.com",
"会社名" : "株式会社K2",
"住所" : "東京都港区虎ノ門2-4-7",
"名" : "信二",
"名_ひらがな" : "しんじ",
"姓" : "片岡",
"姓_ひらがな" : "かたおか",
"年齢" : "27",
"性別" : "その他・不明",
"携帯電話番号" : "070-8049-7480",
"有効期限" : "01/25",
"生年月日" : "1997年04月16日",
"血液型" : "B",
"郵便番号" : "209-7417",
"電話番号" : "03-4698-6344"
},
"modId" : "0",
"portalData" : {},
"recordId" : "29973"
}
],
"dataInfo" :
{
"database" : "FileMaker_data_api",
"foundCount" : 5,
"layout" : "T001_会員.API",
"returnedCount" : 5,
"table" : "T001_会員",
"totalRecordCount" : 10000
}
}
}このように、「株式会社K2」に所属するすべての会員情報を取得することができます。
例2：地域で会員を絞り込む
次に、特定の地域に住んでいる会員を抽出したい場合、例えば「長野市」に住んでいる会員を取得するためのクエリは次の通りです。
{
"query" :
[
{
"住所" : "長野市"
}
]
}このクエリを使うと、「住所」に「長野市」を含むすべての会員を取得することができます。
結果
{
"messages" :
[
{
"code" : "0",
"message" : "OK"
}
],
"response" :
{
"data" :
[
{
"fieldData" :
{
"__id" : "9C525898-A880-4701-9C07-30E350EFDD5A",
"za_accountCreated" : "Administrator",
"za_accountModified" : "Administrator",
"za_timestampCreated" : "09/18/2024 08:48:38",
"za_timestampModified" : "09/18/2024 08:48:38",
"za_trigger_modified" : "08:48:38",
"クレジットカード" : "3576161975606839",
"マイナンバー" : "552097523692",
"メールアドレス" : "erina_otaki_58545270@hotmaill.com",
"会社名" : "",
"住所" : "長野県長野市安茂里小市1-3-208",
"名" : "絵里奈",
"名_ひらがな" : "えりな",
"姓" : "大瀧",
"姓_ひらがな" : "おおたき",
"年齢" : "67",
"性別" : "女",
"携帯電話番号" : "050-8311-1096",
"有効期限" : "08/27",
"生年月日" : "1956年09月28日",
"血液型" : "B",
"郵便番号" : "390-8933",
"電話番号" : "026-028-5252"
},
"modId" : "0",
"portalData" : {},
"recordId" : "20339"
},
{
"fieldData" :
{
"__id" : "36AFC0CB-C95B-4853-8A2E-C95022E0B0AC",
"za_accountCreated" : "Administrator",
"za_accountModified" : "Administrator",
"za_timestampCreated" : "09/18/2024 08:48:38",
"za_timestampModified" : "09/18/2024 08:48:38",
"za_trigger_modified" : "08:48:38",
"クレジットカード" : "3578921482664631",
"マイナンバー" : "345134953915",
"メールアドレス" : "nakano_miho_88019240@hotmaill.com",
"会社名" : "合名会社八百権本店",
"住所" : "長野県長野市三輪1-2-9",
"名" : "美保",
"名_ひらがな" : "みほ",
"姓" : "中野",
"姓_ひらがな" : "なかの",
"年齢" : "28",
"性別" : "女",
"携帯電話番号" : "080-6235-0159",
"有効期限" : "10/28",
"生年月日" : "1996年03月19日",
"血液型" : "O",
"郵便番号" : "394-8845",
"電話番号" : "0269-47-1921"
},
"modId" : "0",
"portalData" : {},
"recordId" : "20434"
},
{
"fieldData" :
{
"__id" : "64193958-B86D-4D6C-BED6-CB67596EA700",
"za_accountCreated" : "Administrator",
"za_accountModified" : "Administrator",
"za_timestampCreated" : "09/18/2024 08:48:38",
"za_timestampModified" : "09/18/2024 08:48:38",
"za_trigger_modified" : "08:48:38",
"クレジットカード" : "5582677813742863",
"マイナンバー" : "253741096892",
"メールアドレス" : "hiromi_fujita_45711644@gmail.com",
"会社名" : "",
"住所" : "長野県長野市中御所町2-3-6",
"名" : "ひろみ",
"名_ひらがな" : "ひろみ",
"姓" : "藤田",
"姓_ひらがな" : "ふじた",
"年齢" : "74",
"性別" : "女",
"携帯電話番号" : "070-7186-9580",
"有効期限" : "12/24",
"生年月日" : "1950年04月14日",
"血液型" : "A",
"郵便番号" : "391-5011",
"電話番号" : "0265-47-8786"
},
"modId" : "0",
"portalData" : {},
"recordId" : "20676"
},
{
"fieldData" :
{
"__id" : "B24E8888-9766-4229-9AD4-FC439008B58D",
"za_accountCreated" : "Administrator",
"za_accountModified" : "Administrator",
"za_timestampCreated" : "09/18/2024 08:48:39",
"za_timestampModified" : "09/18/2024 08:48:39",
"za_trigger_modified" : "08:48:39",
"クレジットカード" : "378221428027508",
"マイナンバー" : "327619889141",
"メールアドレス" : "tsujiyukiko_82795604@gmail.com",
"会社名" : "株式会社ルミナス",
"住所" : "長野県長野市三輪1-2-9",
"名" : "裕紀子",
"名_ひらがな" : "ゆきこ",
"姓" : "辻",
"姓_ひらがな" : "つじ",
"年齢" : "21",
"性別" : "女",
"携帯電話番号" : "050-3378-9992",
"有効期限" : "12/27",
"生年月日" : "2003年08月11日",
"血液型" : "A",
"郵便番号" : "383-3763",
"電話番号" : "0269-49-1403"
},
"modId" : "0",
"portalData" : {},
"recordId" : "23667"
},
{
"fieldData" :
{
"__id" : "C04C6DDC-4E4E-4CED-AFD7-7B392FBB43B9",
"za_accountCreated" : "Administrator",
"za_accountModified" : "Administrator",
"za_timestampCreated" : "09/18/2024 08:48:39",
"za_timestampModified" : "09/18/2024 08:48:39",
"za_trigger_modified" : "08:48:39",
"クレジットカード" : "3581559933581668",
"マイナンバー" : "302036219390",
"メールアドレス" : "takayukitakahashi_38853483@yahoo.co.jp",
"会社名" : "",
"住所" : "長野県長野市若里1-5-22",
"名" : "貴之",
"名_ひらがな" : "たかゆき",
"姓" : "高橋",
"姓_ひらがな" : "たかはし",
"年齢" : "16",
"性別" : "男",
"携帯電話番号" : "080-5748-5026",
"有効期限" : "03/28",
"生年月日" : "2007年11月09日",
"血液型" : "A",
"郵便番号" : "395-7006",
"電話番号" : "0267-10-8486"
},
"modId" : "0",
"portalData" : {},
"recordId" : "24798"
},
{
"fieldData" :
{
"__id" : "B328A2DC-2A55-4A97-A083-5EF68066697B",
"za_accountCreated" : "Administrator",
"za_accountModified" : "Administrator",
"za_timestampCreated" : "09/18/2024 08:48:39",
"za_timestampModified" : "09/18/2024 08:48:39",
"za_trigger_modified" : "08:48:39",
"クレジットカード" : "3546319145785886",
"マイナンバー" : "504315108665",
"メールアドレス" : "shin_fujii_03326701@yahoo.co.jp",
"会社名" : "有限会社佐藤製作所",
"住所" : "長野県長野市安茂里小市1-3-208",
"名" : "信",
"名_ひらがな" : "しん",
"姓" : "藤井",
"姓_ひらがな" : "ふじい",
"年齢" : "22",
"性別" : "男",
"携帯電話番号" : "070-4650-9202",
"有効期限" : "10/26",
"生年月日" : "2002年05月25日",
"血液型" : "O",
"郵便番号" : "395-1832",
"電話番号" : "0269-76-0451"
},
"modId" : "0",
"portalData" : {},
"recordId" : "24854"
},
{
"fieldData" :
{
"__id" : "E90C995A-905C-49C2-85BC-F0A6EDA0522B",
"za_accountCreated" : "Administrator",
"za_accountModified" : "Administrator",
"za_timestampCreated" : "09/18/2024 08:48:39",
"za_timestampModified" : "09/18/2024 08:48:39",
"za_trigger_modified" : "08:48:39",
"クレジットカード" : "4293206555466953",
"マイナンバー" : "607291718002",
"メールアドレス" : "noriwakahara_40778383@gmail.com",
"会社名" : "",
"住所" : "長野県長野市若里2-1-10",
"名" : "のり",
"名_ひらがな" : "のり",
"姓" : "若原",
"姓_ひらがな" : "わかはら",
"年齢" : "75",
"性別" : "男",
"携帯電話番号" : "070-4981-8393",
"有効期限" : "05/27",
"生年月日" : "1949年06月19日",
"血液型" : "O",
"郵便番号" : "397-4725",
"電話番号" : "0260-42-0056"
},
"modId" : "0",
"portalData" : {},
"recordId" : "27032"
},
{
"fieldData" :
{
"__id" : "004CDB19-4EA2-4C32-8BF4-D78FAE0F90AE",
"za_accountCreated" : "Administrator",
"za_accountModified" : "Administrator",
"za_timestampCreated" : "09/18/2024 08:48:39",
"za_timestampModified" : "09/18/2024 08:48:39",
"za_trigger_modified" : "08:48:39",
"クレジットカード" : "374907310588979",
"マイナンバー" : "871391666866",
"メールアドレス" : "akira_mori_20867279@gmail.com",
"会社名" : "",
"住所" : "長野県長野市稲里町中央4-2-8",
"名" : "顕",
"名_ひらがな" : "あきら",
"姓" : "森",
"姓_ひらがな" : "もり",
"年齢" : "78",
"性別" : "男",
"携帯電話番号" : "070-9694-1250",
"有効期限" : "10/28",
"生年月日" : "1946年04月03日",
"血液型" : "A",
"郵便番号" : "397-4729",
"電話番号" : "0267-00-4264"
},
"modId" : "0",
"portalData" : {},
"recordId" : "28229"
}
],
"dataInfo" :
{
"database" : "FileMaker_data_api",
"foundCount" : 8,
"layout" : "T001_会員.API",
"returnedCount" : 8,
"table" : "T001_会員",
"totalRecordCount" : 10000
}
}
}このように、地域別に顧客リストを作成する際にもReadアクションは非常に便利です。これを使えば、特定の会社の全顧客リストを簡単に抽出したり、マーケティング活動のためにデータを活用したりすることが可能です。
実務への応用
- ターゲティングリストの作成：特定の地域や会社に所属する会員データを抽出して、営業活動やマーケティングキャンペーンに活用できます。
- 地域ごとの分析：特定の地域に住んでいる顧客の動向を分析することで、エリアマーケティングや営業戦略に役立てることができます。
- イベント参加者の管理：イベントやキャンペーンで、特定の会社や地域に所属する会員を効率的に管理・抽出できます。
ステップ3：複数条件を使った高度なデータ取得
FileMaker Data APIのReadアクションでは、複数の条件を組み合わせて高度なフィルタリングを行うことができます。これにより、より精密なデータ抽出が可能になり、複雑な検索条件にも対応できます。たとえば、年齢や性別、所属する会社など複数の条件に基づいてデータを取得する場合に便利です。
例：複数条件で会員を絞り込む
たとえば、「30歳以上で、住所が長野市の会員」を取得したい場合、次のように複数条件を組み合わせてクエリを設定します。
{
"query" :
[
{
"住所" : "長野市",
"年齢" : "≥30"
}
]
}このクエリを実行すると、住所に「長野市」を含み、年齢が「30歳以上」に一致する会員情報が取得されます。
結果
{
"messages" :
[
{
"code" : "0",
"message" : "OK"
}
],
"response" :
{
"data" :
[
{
"fieldData" :
{
"__id" : "9C525898-A880-4701-9C07-30E350EFDD5A",
"za_accountCreated" : "Administrator",
"za_accountModified" : "Administrator",
"za_timestampCreated" : "09/18/2024 08:48:38",
"za_timestampModified" : "09/18/2024 08:48:38",
"za_trigger_modified" : "08:48:38",
"クレジットカード" : "3576161975606839",
"マイナンバー" : "552097523692",
"メールアドレス" : "erina_otaki_58545270@hotmaill.com",
"会社名" : "",
"住所" : "長野県長野市安茂里小市1-3-208",
"名" : "絵里奈",
"名_ひらがな" : "えりな",
"姓" : "大瀧",
"姓_ひらがな" : "おおたき",
"年齢" : "67",
"性別" : "女",
"携帯電話番号" : "050-8311-1096",
"有効期限" : "08/27",
"生年月日" : "1956年09月28日",
"血液型" : "B",
"郵便番号" : "390-8933",
"電話番号" : "026-028-5252"
},
"modId" : "0",
"portalData" : {},
"recordId" : "20339"
},
{
"fieldData" :
{
"__id" : "64193958-B86D-4D6C-BED6-CB67596EA700",
"za_accountCreated" : "Administrator",
"za_accountModified" : "Administrator",
"za_timestampCreated" : "09/18/2024 08:48:38",
"za_timestampModified" : "09/18/2024 08:48:38",
"za_trigger_modified" : "08:48:38",
"クレジットカード" : "5582677813742863",
"マイナンバー" : "253741096892",
"メールアドレス" : "hiromi_fujita_45711644@gmail.com",
"会社名" : "",
"住所" : "長野県長野市中御所町2-3-6",
"名" : "ひろみ",
"名_ひらがな" : "ひろみ",
"姓" : "藤田",
"姓_ひらがな" : "ふじた",
"年齢" : "74",
"性別" : "女",
"携帯電話番号" : "070-7186-9580",
"有効期限" : "12/24",
"生年月日" : "1950年04月14日",
"血液型" : "A",
"郵便番号" : "391-5011",
"電話番号" : "0265-47-8786"
},
"modId" : "0",
"portalData" : {},
"recordId" : "20676"
},
{
"fieldData" :
{
"__id" : "E90C995A-905C-49C2-85BC-F0A6EDA0522B",
"za_accountCreated" : "Administrator",
"za_accountModified" : "Administrator",
"za_timestampCreated" : "09/18/2024 08:48:39",
"za_timestampModified" : "09/18/2024 08:48:39",
"za_trigger_modified" : "08:48:39",
"クレジットカード" : "4293206555466953",
"マイナンバー" : "607291718002",
"メールアドレス" : "noriwakahara_40778383@gmail.com",
"会社名" : "",
"住所" : "長野県長野市若里2-1-10",
"名" : "のり",
"名_ひらがな" : "のり",
"姓" : "若原",
"姓_ひらがな" : "わかはら",
"年齢" : "75",
"性別" : "男",
"携帯電話番号" : "070-4981-8393",
"有効期限" : "05/27",
"生年月日" : "1949年06月19日",
"血液型" : "O",
"郵便番号" : "397-4725",
"電話番号" : "0260-42-0056"
},
"modId" : "0",
"portalData" : {},
"recordId" : "27032"
},
{
"fieldData" :
{
"__id" : "004CDB19-4EA2-4C32-8BF4-D78FAE0F90AE",
"za_accountCreated" : "Administrator",
"za_accountModified" : "Administrator",
"za_timestampCreated" : "09/18/2024 08:48:39",
"za_timestampModified" : "09/18/2024 08:48:39",
"za_trigger_modified" : "08:48:39",
"クレジットカード" : "374907310588979",
"マイナンバー" : "871391666866",
"メールアドレス" : "akira_mori_20867279@gmail.com",
"会社名" : "",
"住所" : "長野県長野市稲里町中央4-2-8",
"名" : "顕",
"名_ひらがな" : "あきら",
"姓" : "森",
"姓_ひらがな" : "もり",
"年齢" : "78",
"性別" : "男",
"携帯電話番号" : "070-9694-1250",
"有効期限" : "10/28",
"生年月日" : "1946年04月03日",
"血液型" : "A",
"郵便番号" : "397-4729",
"電話番号" : "0267-00-4264"
},
"modId" : "0",
"portalData" : {},
"recordId" : "28229"
}
],
"dataInfo" :
{
"database" : "FileMaker_data_api",
"foundCount" : 4,
"layout" : "T001_会員.API",
"returnedCount" : 4,
"table" : "T001_会員",
"totalRecordCount" : 10000
}
}
}この結果から、指定したすべての条件に一致するデータが返されるため、複雑な条件での検索が効率よく行えます。
実務への応用
- ターゲットセグメントの精密な抽出：複数の条件を組み合わせて、顧客セグメントを細かく絞り込み、特定の条件に合致するターゲットに対してマーケティングキャンペーンを行うことができます。
- 条件に基づいたレポート作成：顧客の年齢、地域、会社名など複数の属性を考慮したレポートを自動的に生成することが可能です。
- 営業戦略の最適化：営業チームが特定の地域や特定の会社にフォーカスしたアプローチを取る際に、正確なリストを素早く作成できます。
ステップ4：データの並べ替えや部分的なフィールド取得
FileMaker Data APIのReadアクションでは、データを取得する際に並べ替えをすることも可能です。これにより、必要な情報だけを効率的に取得し、さらにデータの表示や処理のスピードを向上させることができます。
例：データの並べ替え
例えば、会員データを「年齢」順に昇順で並べ替えて取得したい場合は、次のように設定します。
{
"action" : "read",
"layouts" : "T001_会員.API",
"query" :
[
{
"住所" : "長野市",
"年齢" : "≥30"
}
],
"sort" :
[
{
"fieldName" : "年齢",
"sortOrder" : "ascend"
}
]
}
このクエリでは、会員のデータを「年齢」で昇順に並べ替えて取得します。
結果
{
"messages" :
[
{
"code" : "0",
"message" : "OK"
}
],
"response" :
{
"data" :
[
{
"fieldData" :
{
"__id" : "9C525898-A880-4701-9C07-30E350EFDD5A",
"za_accountCreated" : "Administrator",
"za_accountModified" : "Administrator",
"za_timestampCreated" : "09/18/2024 08:48:38",
"za_timestampModified" : "09/18/2024 08:48:38",
"za_trigger_modified" : "08:48:38",
"クレジットカード" : "3576161975606839",
"マイナンバー" : "552097523692",
"メールアドレス" : "erina_otaki_58545270@hotmaill.com",
"会社名" : "",
"住所" : "長野県長野市安茂里小市1-3-208",
"名" : "絵里奈",
"名_ひらがな" : "えりな",
"姓" : "大瀧",
"姓_ひらがな" : "おおたき",
"年齢" : "67",
"性別" : "女",
"携帯電話番号" : "050-8311-1096",
"有効期限" : "08/27",
"生年月日" : "1956年09月28日",
"血液型" : "B",
"郵便番号" : "390-8933",
"電話番号" : "026-028-5252"
},
"modId" : "0",
"portalData" : {},
"recordId" : "20339"
},
{
"fieldData" :
{
"__id" : "64193958-B86D-4D6C-BED6-CB67596EA700",
"za_accountCreated" : "Administrator",
"za_accountModified" : "Administrator",
"za_timestampCreated" : "09/18/2024 08:48:38",
"za_timestampModified" : "09/18/2024 08:48:38",
"za_trigger_modified" : "08:48:38",
"クレジットカード" : "5582677813742863",
"マイナンバー" : "253741096892",
"メールアドレス" : "hiromi_fujita_45711644@gmail.com",
"会社名" : "",
"住所" : "長野県長野市中御所町2-3-6",
"名" : "ひろみ",
"名_ひらがな" : "ひろみ",
"姓" : "藤田",
"姓_ひらがな" : "ふじた",
"年齢" : "74",
"性別" : "女",
"携帯電話番号" : "070-7186-9580",
"有効期限" : "12/24",
"生年月日" : "1950年04月14日",
"血液型" : "A",
"郵便番号" : "391-5011",
"電話番号" : "0265-47-8786"
},
"modId" : "0",
"portalData" : {},
"recordId" : "20676"
},
{
"fieldData" :
{
"__id" : "E90C995A-905C-49C2-85BC-F0A6EDA0522B",
"za_accountCreated" : "Administrator",
"za_accountModified" : "Administrator",
"za_timestampCreated" : "09/18/2024 08:48:39",
"za_timestampModified" : "09/18/2024 08:48:39",
"za_trigger_modified" : "08:48:39",
"クレジットカード" : "4293206555466953",
"マイナンバー" : "607291718002",
"メールアドレス" : "noriwakahara_40778383@gmail.com",
"会社名" : "",
"住所" : "長野県長野市若里2-1-10",
"名" : "のり",
"名_ひらがな" : "のり",
"姓" : "若原",
"姓_ひらがな" : "わかはら",
"年齢" : "75",
"性別" : "男",
"携帯電話番号" : "070-4981-8393",
"有効期限" : "05/27",
"生年月日" : "1949年06月19日",
"血液型" : "O",
"郵便番号" : "397-4725",
"電話番号" : "0260-42-0056"
},
"modId" : "0",
"portalData" : {},
"recordId" : "27032"
},
{
"fieldData" :
{
"__id" : "004CDB19-4EA2-4C32-8BF4-D78FAE0F90AE",
"za_accountCreated" : "Administrator",
"za_accountModified" : "Administrator",
"za_timestampCreated" : "09/18/2024 08:48:39",
"za_timestampModified" : "09/18/2024 08:48:39",
"za_trigger_modified" : "08:48:39",
"クレジットカード" : "374907310588979",
"マイナンバー" : "871391666866",
"メールアドレス" : "akira_mori_20867279@gmail.com",
"会社名" : "",
"住所" : "長野県長野市稲里町中央4-2-8",
"名" : "顕",
"名_ひらがな" : "あきら",
"姓" : "森",
"姓_ひらがな" : "もり",
"年齢" : "78",
"性別" : "男",
"携帯電話番号" : "070-9694-1250",
"有効期限" : "10/28",
"生年月日" : "1946年04月03日",
"血液型" : "A",
"郵便番号" : "397-4729",
"電話番号" : "0267-00-4264"
},
"modId" : "0",
"portalData" : {},
"recordId" : "28229"
}
],
"dataInfo" :
{
"database" : "FileMaker_data_api",
"foundCount" : 4,
"layout" : "T001_会員.API",
"returnedCount" : 4,
"table" : "T001_会員",
"totalRecordCount" : 10000
}
}
}これにより、一覧を確認する際に名前順で整理されたデータを簡単に取得できます。
実務への応用
- スト表示やエクスポートの最適化：必要なフィールドのみを取得することで、画面上のリスト表示やデータのエクスポート処理を高速化し、システムのパフォーマンス向上を図れます。
- データの整理：複数フィールドを持つデータベースから、業務で必要な情報（例えば、メールマーケティングに必要な名前とメールアドレスのみ）を抽出し、整理されたデータを利用できます。
- 簡易レポート作成：特定のフィールドだけを取得して、簡易レポートやCSV形式でのエクスポートを効率的に行えます。
まとめ
今回は、「FileMaker Data APIを実行」スクリプトのReadアクションについて解説しました。このアクションを使えば、テーブルオカレンスや複雑なリレーションを意識することなく、柔軟で効率的にデータを取得できるようになります。実際の業務において、必要な情報を瞬時に引き出すための強力なツールとなるでしょう。
特定の会員IDによるデータ取得
特定の会員情報を素早く取得するための基本的なクエリを学びました。会員情報の詳細を確認したり、その結果から次のアクションを実施する場合に活用できます。
条件に基づいたデータのフィルタリング
会社名や住所などの条件に基づいて、複数の会員情報を効率よく抽出する方法を紹介しました。これにより、特定のセグメントに対するデータを抽出することが可能になります。
複数条件を使った高度なデータ抽出
年齢や性別など、複数の条件を組み合わせたフィルタリングを行うことで、より精密なデータ分析や会員リストの生成が可能になります。
データの並べ替え
取得するデータを並べ替えたり、必要なフィールドと抽出することで、データ処理を最適化し、システムのパフォーマンスが向上します。
Readアクションは、日常的なデータ操作をよりシンプルで迅速に行える手段です。業務の効率化やデータの活用度を高めるために、ぜひこの記事を参考に「FileMaker Data APIを実行」スクリプトのReadアクションを活用してみてください。
サンプルソリューション
FileMaker data api Read
今回の記事で使用したサンプルソリューションになります。
スクリプトや動作などをご確認いただければ幸いです。
※サンプルソリューションは、ZIP形式に圧縮しております。ダウンロード後に解凍してご利用ください。
※サンプルソリューションのご利用により生じた障害等に対する責任はいっさい負いかねますのであらかじめご了承ください。
※動作確認環境：macOS Sonoma 14.6.1 / Claris FileMaker 2024
ファイルをダウンロードしてFileMakerで開くと、カスタムダイアログボックスが表示されます。以下に記載のアカウント名とパスワードを使用してログインしてください。
アカウント名：Administrator
パスワード：UzIXmy5x2Ss50jHKこの記事にご興味を持たれた方は、こちらの記事もおすすめです。