Airtable

Ejemplos de configuración de conexiones

En esta sección se indican los valores de ejemplo de los distintos campos que se configuran al crear la conexión.

Tipo de conexión de token de acceso personal

Entidades, operaciones y acciones

Todos los conectores de integración 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 te muestra como entidades, operaciones y acciones.

• Entidad: una entidad se puede considerar como un objeto o un conjunto de propiedades en la aplicación o el servicio conectados. La definición de una entidad varía de un conector a otro. Por ejemplo, en un conector de base de datos, las tablas son las entidades; en un conector de servidor de archivos, las carpetas son las entidades; y en un conector de sistema de mensajería, las colas son las entidades.

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

• Operación: una operación es la actividad que puedes realizar en una entidad. Puedes realizar cualquiera de las siguientes operaciones en una entidad:
  • Mostrar
  • Obtener
  • Crear
  • Actualizar
  • Eliminar

  Al seleccionar una entidad de la lista disponible, se genera una lista de operaciones disponibles para la entidad. Para ver una descripción detallada de las operaciones, consulta las operaciones de entidades de la tarea Connectors. Sin embargo, si un conector no admite ninguna de las operaciones de entidad, esas operaciones no admitidas no se mostrarán en la lista Operations.

• Acción: una acción es una función de primera clase que se pone a disposición de la integración a través de la interfaz del conector. Una acción te permite hacer cambios en una o varias entidades y varía de un conector a otro. Normalmente, 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 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, a continuación, haz clic en Hecho.
4. Entrada de tarea de la tarea Conectores, puede definir el filterClause según los requisitos del cliente.

Siempre debe especificar 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: Obtener 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, a continuación, haz clic en Hecho.
4. Asigna el ID de entidad "recg7qjPRMa7DBwIb", que es la clave que se va a transferir. Para definir el ID de entidad, en la sección Asignación de datos de Asignador de datos, haga clic en Abrir editor de asignación de datos y, a continuación, introduzca "recg7qjPRMa7DBwIb" en el campo Valor de entrada y elija EntityId como variable local.

   En este caso, Entity Id: "recg7qjPRMa7DBwIb" es el valor de clave principal único y debe transferirse directamente.

Si la entidad tiene una clave principal compuesta, puede 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: Eliminar 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, a continuación, haz clic en Hecho.
4. Asigne el valor "recg7qjPRMa7DBwIb" al ID de entidad, que es la clave que se va a transferir.Para definir el ID de entidad, en la sección Asignador de datos de Asignación de datos, haga clic en Abrir editor de asignación de datos y, a continuación, introduzca "recg7qjPRMa7DBwIb" en el campo Valor de entrada y elija EntityId como variable local.

Si la entidad tiene una clave principal compuesta, puede especificar una cláusula de filtro.

Ejemplo: operación de creación 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 Create y, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija 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 connectorOutputPayload de la respuesta 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 de 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

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

   En lugar de especificar el entityId, también puede definir filterClause como Internal_Id='reckqGnFusjDlnmvs'.

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

{
"Internal_Id": "reckqGnFusjDlnmvs"
}

Ejemplo: operación de actualización de 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija 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 el entityId, también puede definir filterClause como Internal_Id='reckqGnFusjDlnmvs'.

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

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

Ejemplo: operación de actualización de la entidad Datos de contacto (casilla)

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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

   {
   "Checkbox": true
   }
   

   En lugar de especificar el entityId, también puede definir filterClause como Internal_Id='reckqGnFusjDlnmvs'.

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

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

Ejemplo: operación de actualización de 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

   {
   "Number": 1001.0
   } 
   

   En lugar de especificar el entityId, también puede definir filterClause como Internal_Id='reckqGnFusjDlnmvs'.

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

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   } 
   

Ejemplo: operación de actualización de la entidad Contact Data (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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

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

   En lugar de especificar el entityId, también puede definir filterClause como Internal_Id='reckqGnFusjDlnmvs'.

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

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

Ejemplo: operación de actualización de 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija 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 el entityId, también puede definir filterClause como Internal_Id='reckqGnFusjDlnmvs'.

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

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }