Airtable

Muestras de configuración de conexión

En esta sección, se enumeran los valores de muestra de los diversos campos que configuras cuando creas la conexión.

Tipo de conexión de token de acceso personal

Entidades, operaciones y acciones

Todos los Integration Connectors proporcionan una capa de abstracción para los objetos de la aplicación conectada. Solo puedes acceder a los objetos de una aplicación a través de esta abstracción. La abstracción se expone como entidades, operaciones y acciones.

• Entidades: Una entidad puede considerarse como un objeto o una colección de propiedades en la aplicación o servicio conectados. La definición de una entidad difiere de conector a conector. Por ejemplo, en un conector de bases de datos, las tablas son las entidades; en un conector de servidor de archivos, las carpetas son las entidades; en un conector de sistema de mensajería, las colas son las entidades.

  Sin embargo, es posible que un conector no admita o tenga ninguna entidad, en cuyo caso la lista Entities estará vacía.

• Operaciones: Una operación es la actividad que puedes realizar en una entidad. Puedes realizar cualquiera de las siguientes operaciones en una entidad:
  • Lista
  • Obtén
  • Crear
  • Actualizar
  • Borrar

  Cuando se selecciona una entidad de la lista disponible, se genera una lista de operaciones disponibles para esa entidad. Para obtener una descripción detallada de las operaciones, consulta las operaciones de entidades de la tarea de conectores. Sin embargo, si un conector no admite ninguna de las operaciones de entidad, estas operaciones no compatibles no se incluyen en la lista Operations.

• Acción: Una acción es una función de primera clase que está disponible para la integración mediante la interfaz de Conectores. Una acción te permite realizar cambios en una entidad o entidades y variar de un conector a otro. Por lo general, una acción tendrá algunos parámetros de entrada y un parámetro de salida. Sin embargo, es posible que un conector no admita ninguna acción, en cuyo caso la lista Actions estará vacía.

Ejemplos de operaciones de entidades

En esta sección, se muestra cómo realizar algunas de las operaciones de la entidad en este conector.

Ejemplo: Operación de lista para la entidad Datos de contacto (registros)

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Contact Data en la lista Entity.
3. Selecciona la operación List y haz clic en Listo.
4. Entrada de tarea de la tarea Conectores, puedes configurar filterClause según los requisitos del cliente.

Siempre especifica el valor de la cláusula de filtro entre comillas simples (').

También puedes realizar operaciones de lista en las siguientes entidades:
Contacts Data.Main View, Contacts Data.Calendar, Contacts Data.Kanban, Contacts Data.Gallery, Contacts Data.List y Contacts Data_Collaborators

Ejemplo: Obtén el registro de la entidad Datos de contacto (registros)

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Contact Data en la lista Entity.
3. Selecciona la operación GET y haz clic en Listo.
4. Establece el ID de la entidad en "recg7qjPRMa7DBwIb", que es la clave que se pasará. Para establecer el ID de la entidad, en la sección Data Mapper de Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa "recg7qjPRMa7DBwIb" en el campo Input Value y elige EntityId como variable local.

   Aquí, el ID de entidad: "recg7qjPRMa7DBwIb" es el valor único de la clave primaria y se debe pasar directamente.

Si la entidad tiene una clave primaria compuesta, puedes especificar una cláusula de filtro.

También puedes realizar la operación get en las siguientes entidades: Contacts Data.Main View, Contacts Data.Calendar, Contacts Data.Kanban, Contacts Data.Gallery, Contacts Data.List y Contacts Data_Collaborators.

Ejemplo: Borra un registro de la entidad Datos de contacto (registros)

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Contact Data en la lista Entity.
3. Selecciona la operación Delete y haz clic en Listo.
4. Establece el ID de la entidad en "recg7qjPRMa7DBwIb", que es la clave que se pasará.Para establecer el ID de la entidad, en la sección Data Mapper de Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa "recg7qjPRMa7DBwIb" en el campo Input Value y elige EntityId como variable local.

Si la entidad tiene una clave primaria compuesta, puedes especificar una cláusula de filtro.

Ejemplo: Operación de creación para la entidad Datos de contacto (registros)

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Contact Data en la lista Entity.
3. Selecciona la operación Create y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload como variable local.

   {
   "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"
   }
   

   Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   {
   "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>
   

Ejemplo: Operación de actualización para la entidad Datos de contacto (registros)

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona ContactData en la lista Entity.
3. Selecciona la operación Update y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

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

   En lugar de especificar entityId, también puedes establecer filterClause en Internal_Id='reckqGnFusjDlnmvs'.

Si la integración se realiza correctamente, la variable de salida connectorOutputPayload de la tarea del conector hará lo siguiente:

{
"Internal_Id": "reckqGnFusjDlnmvs"
}

Ejemplo: Operación de actualización para la entidad Datos de contacto (Adjunto)

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Contact Data en la lista Entity.
3. Selecciona la operación Update y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   {
   "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\"}]"
   }
   

   En lugar de especificar entityId, también puedes establecer filterClause en Internal_Id='reckqGnFusjDlnmvs'.

   Si la integración se realiza correctamente, la variable de salida connectorOutputPayload de la tarea del conector hará lo siguiente:

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

Ejemplo: Operación de actualización para la entidad Datos de contacto (casilla de verificación)

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Contact Data en la lista Entity.
3. Selecciona la operación Update y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   {
   "Checkbox": true
   }
   

   En lugar de especificar entityId, también puedes establecer filterClause en Internal_Id='reckqGnFusjDlnmvs'.

   Si la integración se realiza correctamente, la variable de salida connectorOutputPayload de la tarea del conector hará lo siguiente:

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

Ejemplo: Operación de actualización para la entidad Datos de contacto (número)

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona ContactData en la lista Entity.
3. Selecciona la operación Update y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   {
   "Number": 1001.0
   } 
   

   En lugar de especificar entityId, también puedes establecer filterClause en Internal_Id='reckqGnFusjDlnmvs'.

   Si la integración se realiza correctamente, la variable de salida connectorOutputPayload de la tarea del conector hará lo siguiente:

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   } 
   

Ejemplo: Operación de actualización para la entidad Datos de contacto (DateField)

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona ContactData en la lista Entity.
3. Selecciona la operación Update y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

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

   En lugar de especificar entityId, también puedes establecer filterClause en Internal_Id='reckqGnFusjDlnmvs'.

   Si la integración se realiza correctamente, la variable de salida connectorOutputPayload de la tarea del conector hará lo siguiente:

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

Ejemplo: Operación de actualización para la entidad Datos de contacto (texto)

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona ContactData en la lista Entity.
3. Selecciona la operación Update y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   {
   "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. "
   }
   

   En lugar de especificar entityId, también puedes establecer filterClause en Internal_Id='reckqGnFusjDlnmvs'.

   Si la integración se realiza correctamente, la variable de salida connectorOutputPayload de la tarea del conector hará lo siguiente:

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }