レコードの編集

/fmi/data/version/databases/database-name/layouts/layout-name/records/record-id

version – リクエストされた FileMaker Data API のバージョン。v1、v2、または vLatest のいずれかを使用できます。

database-name – 共有データベースの名前

layout-name – レコード編集のためのコンテキストとして使用するレイアウトの名前

record-id – 編集するレコードのレコード ID

Content-Type: application/json

Authorization: Bearer session-token。session-token はデータベースセッションに固有の X-FM-Data-Access-Token の値です。

更新するフィールド/値ペアが含まれた JSON 形式のレコードデータ。portalData の指定を使用してレイアウト上にある関連レコードまたはポータルをこのデータで指定することもできます。FileMaker Pro のインスペクタに表示されるオブジェクト名か、関連テーブル名のいずれかをポータル名にすることができます。

指定したフィールドのみが更新されます。レコード内の他のフィールドは変更されません。fieldData の値として「{}」を指定した場合、目的のレコードは更新されません。

例:

{ 
  "fieldData": {
    "First Name": "Joe",
    "deleteRelated": "Orders.3",
    "Date Field": "2029/1/20"
  },
  "portalData": {
    "JobsTable": [
      {
        "recordId": "70", 
        "modId": "4", 
        "JobsTable::Name": "Contractor" 
      }
    ]
  },
  "options": {
    "entrymode": "script",
    "prohibitmode": "script"
  },
  "dateformats": 2
}

その他のオプションのリクエストボディの引数:

• modId - 修正 ID を指定すると現在のバージョンのレコードを編集することができます。修正 ID の値がデータベース内の現在の修正 ID と一致しない場合、レコードは変更されません。

• options - データを書き込むとき、これらのオプションで次を制御できます:

  • entrymode - フィールドに [データの入力時にユーザによる上書きを許可する] 入力値の制限オプションが選択されているかどうかを無視して代わりにこのオプションを使用します。値「script」はフィールドのデータ入力値の制限の要件を無視します (スクリプトがこれらの要件を無視するためにこのように名付けられました)。値「user」 (デフォルト) はフィールドの入力値の制限の要件に従います。

  • prohibitmode - フィールドに [データ入力時の値変更の禁止] 入力値の自動化オプションが選択されているかどうかを無視して代わりにこのオプションを使用します。値「script」はフィールドの入力値の自動化の要件を無視します (スクリプトがこれらの要件を無視するためにこのように名付けられました)。値「user」 (デフォルト) はフィールドの入力値の自動化の要件に従います。

• dateformats - 日付およびタイムスタンプフィールドの形式を指定します。米国形式の場合は値が 0、ファイルロケールの形式の場合は 1、ISO 8601 形式の場合は 2 です。指定されていない場合、デフォルト値は 0 です。

• script.prerequest、script.presort、script - リクエストの一部として FileMaker スクリプトを実行します。「別のリクエストによるスクリプトの実行」を参照してください。