Claris FileMaker 2024 -「FileMaker Data API を実行」スクリプトステップー追加機能で作成や更新などのレコード操作が可能に!
2024年06月06日 04:36 PM
Claris FileMaker 2024
Claris FileMaker 2024 では、「FileMaker Data APIを実行」スクリプトステップに次の機能が新たにサポートされることになりました。
■追加された機能
1. レコードデータを変更する書き込み操作リクエストで、action キーに create、update、delete、または duplicate 値を設定できます
2. 他のスクリプトステップと同様に Get (最終エラー)、Get (最終エラー詳細)、Get (最終エラー位置) 関数で適切なエラー情報を返します
3. [データの入力時にユーザによる上書きを許可する] 制限オプションの上書きリクエストで、新しい options.entrymode キーに user (制限ルールに従う) または script (制限ルールを上書きする) を設定できます
■「レコードデータを変更する書き込み操作リクエスト」で追加されたactionキーを試してみよう
これまでサポートされていたactionキーは
- 「metadata」(テーブルなどの構造の取得)
- 「read」(データをJSON形式で取得)
のみでしたが、FileMaker 2024では、
- 「create」(レコードの作成)
- 「update」(レコードの更新)
- 「duplicate」(レコードの複製)
- 「delete」(レコードの削除)
がサポートされるようになりました。
次のようなレイアウトを準備します。
レイアウト名:「list」テーブルオカレンス名:「案件管理」
![](https://ywc.com/filemaker/wp-content/uploads/2024/06/1-1024x297.jpg)
まずは既存の「metadata」を試してみます。
![](https://ywc.com/filemaker/wp-content/uploads/2024/06/2.jpg)
スクリプトを実行すると以下のような結果が返ってきます。
![](https://ywc.com/filemaker/wp-content/uploads/2024/06/3.jpg)
次に既存の「read」も試してみます。
![](https://ywc.com/filemaker/wp-content/uploads/2024/06/4.jpg)
![](https://ywc.com/filemaker/wp-content/uploads/2024/06/5.jpg)
では、追加された「create」を試してみます。
![](https://ywc.com/filemaker/wp-content/uploads/2024/06/6.jpg)
レコードを1件追加することができました。(レコードIDの値が 9のもの)
![](https://ywc.com/filemaker/wp-content/uploads/2024/06/7-1024x325.jpg)
続いて「update」を試してみます。
![](https://ywc.com/filemaker/wp-content/uploads/2024/06/8.jpg)
JSON内でレコードIDの値を9に指定し「名前」を「白井」に設定することができました。
![](https://ywc.com/filemaker/wp-content/uploads/2024/06/9-1024x321.jpg)
試しに、更新しようとするレコードが編集中の状態の場合、スクリプトを実行するとエラー番号301のエラーが発生し更新はできません。
![](https://ywc.com/filemaker/wp-content/uploads/2024/06/10-1.jpg)
![](https://ywc.com/filemaker/wp-content/uploads/2024/06/11-1.jpg)
Get (最終エラー) でもエラー番号を取得できるようになっています。
ちなみに存在しないレコードIDを指定すると、エラー番号101(レコードがみつかりません)が発生します。
![](https://ywc.com/filemaker/wp-content/uploads/2024/06/12.jpg)
次は「duplicate」を実行してみます。今作成したレコードIDが9のレコードを複製します。
![](https://ywc.com/filemaker/wp-content/uploads/2024/06/13.jpg)
レコードが複製され、レコードIDが10のレコードができました。
![](https://ywc.com/filemaker/wp-content/uploads/2024/06/14-1024x336.jpg)
では最後に、複製してできたレコードIDが10のレコードを「delete」で削除してみます。
![](https://ywc.com/filemaker/wp-content/uploads/2024/06/15-1024x305.jpg)
無事レコードが削除されました。
![](https://ywc.com/filemaker/wp-content/uploads/2024/06/16-1024x405.jpg)
■追加されたoptions.entrymode キーについても確認してみましょう
まずは準備として「案件名」フィールドのオプションで「データの入力時にユーザによる上書きを許可する」と「データの入力時のみ」にチェックをし「最大文字数」を10という制限をかけておきます。
![](https://ywc.com/filemaker/wp-content/uploads/2024/06/17.jpg)
「update」を使い「options.entrymode」 キーを「user」にし、案件名に「あいうえおかきくけこさ」を設定するスクリプトを作成しました。
![](https://ywc.com/filemaker/wp-content/uploads/2024/06/18-1024x324.jpg)
実行してみると、「user」の場合は入力値の制限ルールに従い、11文字である「あいうえおかきくけこさ」を設定することはできませんでした。
![](https://ywc.com/filemaker/wp-content/uploads/2024/06/19-1024x571.jpg)
次に「options.entrymode」 キーを「script」にしたスクリプトを作成しました。
![](https://ywc.com/filemaker/wp-content/uploads/2024/06/20-1024x325.jpg)
「script」にセットした場合は制限ルールを上書きできるので、エラーがでることなく最大文字数10という制限を無視して「あいうえおかきくけこさ」の値が設定されました。
![](https://ywc.com/filemaker/wp-content/uploads/2024/06/21.jpg)
まとめ
これらの機能追加により、必要なフィールドが配置されたレイアウトさえ準備しておけば、別のテーブルオカレンスのレイアウトを表示している場合でもレイアウトを切り替えずにレコードを操作できます。
これによって高速にスクリプトを実行できるようになり、使い方によっては大きな強みになるかもしれないですね。
無料評価版ダウンロードが可能
Claris FileMaker 2024 が45日間無料でお試しいただける無料評価版がダウンロードできます!
機能制限等は一切ありません。
購入前に新機能を試してみたい方、ご購入を検討されている方ぜひボタンをクリックしてください!(Caris サイトへ移動します)