Claris FileMaker コネクタの操作

Claris FileMaker コネクタを使用すると FileMaker Cloud および FileMaker Server でホストされているファイルのレコードとテーブルを操作できます。ホストされたカスタム App を Claris プラットフォーム全体またはサードパーティアプリケーションと統合することも可能です。接続要件の詳細については、「Claris App への接続」を参照してください。

メモ Claris FileMaker コネクタは現在 Claris Studio のテーブルの操作はサポートしていません。

Claris FileMaker コネクタを操作する場合、理解しておくべき重要なポイントがいくつかあります。

応答データでレコードとテーブルがどのように表示されるか。これによりステップデータのレコードとテーブルを操作する場合に正しいプロパティを選択できます。

応答データとステップデータの詳細については、「フロー履歴の表示」および「ステップデータの使用」をそれぞれ参照してください。
コネクタのトリガとアクションがどのように機能するか。
エラーメッセージがどのように書式設定されているか。

内容の概要:

レコードの構造
テーブルの構造
トリガ
アクション
エラーの書式

レコードの構造

応答データでは、Claris FileMaker コネクタは FileMaker システムフィールド (例 DefID) をオブジェクトのルートに、レコードのフィールドを Fields プロパティの下にネストしてレコードを表示します。

コピー

{
    "ID": "AF6C3CCC-2E55-C549-B05C-390396F24B09",
    "ExternalID": 421,
    "DefID": "Containers",
    "ModID": 0,
    "Fields": {
        "PrimaryKey": "AF6C3CCC-2E55-C549-B05C-390396F24B09",
        "CreationTimestamp": "2025-01-06T20:16:54Z",
        "CreatedBy": "Admin",
        "ModificationTimestamp": "2025-01-06T20:16:54Z",
        "ModifiedBy": "Admin",
        "ID": "NULL",
        "File Name": "NULL",
        "Record ID": 421,
        "Description": "Test record",
        "Studio ID": "NULL",
        "Title": "NULL",
        "Info": "NULL"
    }
}

メモ ExternalID は FileMaker レコードのレコード ID または行 ID です。

テーブルの構造

応答データでは、Claris FileMaker コネクタはテーブルを Key、ID (テーブル名と同じ)、およびフィールド定義の配列で表示します。各フィールド定義にはフィールド名、データタイプ、フィールドオプションが含まれます。

コピー

{
    "Name": "Approvals",
    "ID": "Approvals",
    "Key": "PrimaryKey",
    "Fields": [
        {
            "Name": "PrimaryKey",
            "Type": "Edm.String",
            "ReadOnly": true,
            "Nullable": false
        },
        {
            "Name": "CreationTimestamp",
            "Type": "Edm.DateTimeOffset",
            "ReadOnly": true,
            "Nullable": false,
            "DefaultValue": "CURRENT_TIMESTAMP"
        },
        {
            "Name": "CreatedBy",
            "Type": "Edm.String",
            "ReadOnly": true,
            "Nullable": false,
            "DefaultValue": "USER"
        },
        {
            "Name": "ModificationTimestamp",
            "Type": "Edm.DateTimeOffset",
            "ReadOnly": true,
            "Nullable": false,
            "DefaultValue": "CURRENT_TIMESTAMP"
        },
        {
            "Name": "ModifiedBy",
            "Type": "Edm.String",
            "ReadOnly": true,
            "Nullable": false,
            "DefaultValue": "USER"
        },
        {
            "Name": "Status",
            "Type": "Edm.String",
            "ReadOnly": false,
            "Nullable": true
        }
    ]
}

トリガ

トリガは Claris Connect フローを開始してその後のステップがフローで定義されたアクションを実行するために使用する基本的な内容を渡します。

Trigger by script

[Trigger by script] トリガは対応する FileMaker Pro カスタム App で [Claris Connect フローをトリガ] スクリプトステップが実行されたときにフローを実行します。このトリガはフロー実行時に最初のステップデータを渡します。

「Claris コネクタトリガの追加」を参照してください。

アクション

アクションとはフローで実行されるステップです。アクションはその前に実行されたアクションやトリガのデータにアクセスできます。前のアクションやトリガのデータはステップデータとして後のアクションに渡されます。

メモ

読み取り専用フィールドは非詳細アクション設定からは除外されます。
日付フィールド、時刻フィールド、タイムスタンプフィールドでは、アクションは ISO 準拠の文字列または Claris Studio の時刻オブジェクトのいずれかをサポートします。

ISO 準拠の文字列

2011-10-05T14:48:00.000Z

Claris Studio 時刻オブジェクト
コピー
```
{ 
  "Type": "ts",
  "Zone": "America/Los Angeles",
  "Time" : "2024-08-20T00:00:00Z"
}
```

エラーの書式

フロー実行時にエラーが発生した場合、コネクタは FileMaker Data API エラーメッセージまたは一般的な OData ステータスコードのいずれかを応答データにマップします。FileMaker コードが返された場合はそれを使用します。FileMaker コードが存在しない場合は一般的な OData ステータスコードが返されます。FileMaker Data API ガイドのエラー応答および OData 要件の Common Response Status Codes を参照してください。それぞれの違いを理解するための例を挙げます。

FileMaker Data API ステータスコードおよび一般的な OData 応答

コピー

{
  "body": {
    "code": "201", // FileMaker specific error code
    "error": "Write access to the field is not permitted (201)"
  },
  "statusCode": 400 // Common Response Status Code defined in OData specification
}

一般的な OData 応答のみ

コピー

{
  "body": {
    "code": 400, // No FileMaker code, Common Response Status Code used.
    "error": "Unable to open file"
  },
  "statusCode": 400 // Common Response Status Code defined in OData specification
}