Airtable

接続構成のサンプル

このセクションでは、接続を作成するときに構成するさまざまなフィールドのサンプル値を示します。

Personal Access Token の接続タイプ

エンティティ、オペレーション、アクション

すべての Integration Connectors が、接続されたアプリケーションのオブジェクトを抽象化するレイヤを提供します。アプリケーションのオブジェクトには、この抽象化を通じてのみアクセスできます。抽象化は、エンティティ、オペレーション、アクションとして公開されます。

• エンティティ: エンティティは、接続されているアプリケーションやサービスのオブジェクト、またはプロパティのコレクションと考えることができます。エンティティの定義は、コネクタによって異なります。たとえば、データベース コネクタでは、テーブルがエンティティであり、ファイル サーバー コネクタでは、フォルダがエンティティです。また、メッセージング システム コネクタでは、キューがエンティティです。

  ただし、コネクタでいずれのエンティティもサポートされていない、またはエンティティが存在しない可能性があります。その場合、Entities リストは空になります。

• オペレーション: エンティティに対して行うことができるアクティビティです。エンティティに対して次のいずれかのオペレーションを行うことができます。
  • リスト
  • 取得
  • 作成
  • 更新
  • 削除

  使用可能なリストからエンティティを選択すると、そのエンティティで使用可能なオペレーションのリストが生成されます。オペレーションの詳細については、コネクタタスクのエンティティ オペレーションをご覧ください。ただし、コネクタがいずれかのエンティティ オペレーションをサポートしていない場合、サポートされていないオペレーションは Operations リストに含まれません。

• アクション: コネクタ インターフェースを介して統合で使用できる主要な関数の一つです。アクションを使用すると、1 つまたは複数のエンティティに対して変更を加えることができます。また、使用できるアクションはコネクタごとに異なります。通常、アクションには入力パラメータと出力パラメータがあります。ただし、コネクタがどのアクションもサポートしていない可能性があります。その場合は、Actions リストが空になります。

エンティティ オペレーションの例

このセクションでは、このコネクタでエンティティ オペレーションの一部を実行する方法について説明します。

例 - 連絡先データ（レコード）エンティティの List オペレーション

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から Contact Data を選択します。
3. [List] オペレーションを選択し、[完了] をクリックします。
4. [コネクタ] タスクの [タスク入力] セクションで、お客様の要件に応じて filterClause を設定できます。

フィルタ句の値は、常に単一引用符（'）内で指定します。

LIST オペレーションは、次のエンティティに対しても実行できます。
Contacts Data.Main View、Contacts Data.Calendar、Contacts Data.Kanban、Contacts Data.Gallery、Contacts Data.List、Contacts Data_Collaborators

例 - Contact Data（Records）エンティティのレコードを取得する

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から Contact Data を選択します。
3. [GET] オペレーションを選択し、[完了] をクリックします。
4. エンティティ ID を「recg7qjPRMa7DBwIb」に設定します。これは渡されるキーです。エンティティ ID を設定するには、[データ マッピング] の [データ マッパー] セクションで [データ マッピング エディタを開く] をクリックし、[入力値] フィールドに "recg7qjPRMa7DBwIb" を入力し、EntityId をローカル変数として選択します。

   ここで、エンティティ ID:「recg7qjPRMa7DBwIb」は一意の主キー値であり、直接渡す必要があります。

エンティティに複合主キーがある場合は、フィルタ句を指定できます。

get オペレーションは、Contacts Data.Main View、Contacts Data.Calendar、Contacts Data.Kanban、Contacts Data.Gallery、Contacts Data.List、Contacts Data_Collaborators の各エンティティに対しても実行できます。

例 - Contact Data（Records）エンティティのレコードを削除する

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から Contact Data を選択します。
3. [Delete] オペレーションを選択し、[完了] をクリックします。
4. エンティティ ID を「recg7qjPRMa7DBwIb」に設定します。これは渡されるキーです。エンティティ ID を設定するには、[データ マッピング] の [データ マッパー] セクションで [データ マッピング エディタを開く] をクリックし、[入力値] フィールドに "recg7qjPRMa7DBwIb" を入力し、EntityId をローカル変数として選択します。

エンティティに複合主キーがある場合は、フィルタ句を指定できます。

例 - 連絡先データ（レコード）エンティティの Create オペレーション

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から Contact Data を選択します。
3. [Create] オペレーションを選択し、[完了] をクリックします。
4. [データ マッピング] タスクの [データ マッパー] セクションで、Open Data Mapping Editor をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。

   {
   "First Name": "Demo4",
   "Last Name": "Alex",
   "Email": "cloudysanfrancisco@gmail.com",
   "DOB": "2000-04-14",
   "Office": "Denver",
   "Phone Number": "1-175-432-1437",
   "Current Brand": "Mercedes"
   }
   

   統合が成功すると、コネクタタスクの connectorOutputPayload レスポンス パラメータには次に似た値が含まれます。

   {
   "Internal_Id": "recg7qjPRMa7DBwIb"
   }
     
   <pre>
     function helloWorld() {
       alert('Hello, world! This sentence is so long that it wraps onto a second
         line.');
     }
     
     /n
     <h3>Example title</h3>
     </pre>
   

例 - 連絡先データ（レコード）エンティティの更新オペレーション

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から ContactData を選択します。
3. [Update] オペレーションを選択し、[完了] をクリックします。
4. [データ マッピング] タスクの [データマッパー] セクションで、Open Data Mapping Editor をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。

   {
   "Phone Number": "1-175-432-4312",
   "Current Brand": "Honda"
   }
   

   [entityId] を指定する代わりに、[filterClause] を Internal_Id='reckqGnFusjDlnmvs' に設定することもできます。

統合に成功すると、コネクタタスクの connectorOutputPayload 出力変数は次のようになります。

{
"Internal_Id": "reckqGnFusjDlnmvs"
}

例 - 連絡先データ（アタッチメント）エンティティの更新オペレーション

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から Contact Data を選択します。
3. [Update] オペレーションを選択し、[完了] をクリックします。
4. [データ マッピング] タスクの [データマッパー] セクションで、Open Data Mapping Editor をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。

   {
   "Attachment": "[{\"url\":\"https://media.istockphoto.com/id/2086323995/photo/global-communication-east-asia.jpg?s=2048x2048&w=is&k=20&c=Z50lesspQQzxWug0m11QrPZMOUzMeTufgnLHh_3COy4=\",\"filename\":\"BMW\"}]"
   }
   

   [entityId] を指定する代わりに、[filterClause] を Internal_Id='reckqGnFusjDlnmvs' に設定することもできます。

   統合に成功すると、コネクタタスクの connectorOutputPayload 出力変数は次のようになります。

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

例 - 連絡先データ（チェックボックス）エンティティの更新オペレーション

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から Contact Data を選択します。
3. [Update] オペレーションを選択し、[完了] をクリックします。
4. [データ マッピング] タスクの [データマッパー] セクションで、Open Data Mapping Editor をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。

   {
   "Checkbox": true
   }
   

   [entityId] を指定する代わりに、[filterClause] を Internal_Id='reckqGnFusjDlnmvs' に設定することもできます。

   統合に成功すると、コネクタタスクの connectorOutputPayload 出力変数は次のようになります。

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

例 - 連絡先データ（番号）エンティティの更新オペレーション

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から ContactData を選択します。
3. [Update] オペレーションを選択し、[完了] をクリックします。
4. [データ マッピング] タスクの [データマッパー] セクションで、Open Data Mapping Editor をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。

   {
   "Number": 1001.0
   } 
   

   [entityId] を指定する代わりに、[filterClause] を Internal_Id='reckqGnFusjDlnmvs' に設定することもできます。

   統合に成功すると、コネクタタスクの connectorOutputPayload 出力変数は次のようになります。

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   } 
   

例 - 連絡先データ（DateField）エンティティの更新オペレーション

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から ContactData を選択します。
3. [Update] オペレーションを選択し、[完了] をクリックします。
4. [データ マッピング] タスクの [データマッパー] セクションで、Open Data Mapping Editor をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。

   {
   "DOB": "2000-04-14"
   } 
   

   [entityId] を指定する代わりに、[filterClause] を Internal_Id='reckqGnFusjDlnmvs' に設定することもできます。

   統合に成功すると、コネクタタスクの connectorOutputPayload 出力変数は次のようになります。

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

例 - 連絡先データ（テキスト）エンティティの更新オペレーション

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から ContactData を選択します。
3. [Update] オペレーションを選択し、[完了] をクリックします。
4. [データ マッピング] タスクの [データマッパー] セクションで、Open Data Mapping Editor をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。

   {
   "Singlelinetext": "Airtable Application",
   "Long text": "Airtable is a cloud-based collaboration platform that combines the features of a spreadsheet with the capabilities of a database. "
   }
   

   [entityId] を指定する代わりに、[filterClause] を Internal_Id='reckqGnFusjDlnmvs' に設定することもできます。

   統合に成功すると、コネクタタスクの connectorOutputPayload 出力変数は次のようになります。

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }