SendGrid

Configurar la autenticación

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.

Acciones

En esta sección se enumeran algunas de las acciones que admite el conector. Para saber cómo configurar las acciones, consulta los ejemplos de acciones.

Acción SendMail2

Con esta acción se envía un correo con un archivo adjunto.

Parámetros de entrada de la acción Enviar un correo

Parámetros de salida de la acción Enviar un correo

Esta acción devuelve un mensaje de confirmación tanto si el correo se ha enviado correctamente como si no.

Ejemplos de acciones

En esta sección se describe cómo realizar algunas de las acciones de este conector.

Ejemplo: enviar un correo

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción SendMail2 y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
       "FromName": "Name",
       "FromEmail": "cloudysanfrancisco@gmail.com",
       "Subject": "[{\"value\": \"cymbalgroup.com\",\"type\": \"text/plain\"}]",
       "TemplateId": "d-c4bc730a0b094a3a9d9cabb7347b5edc",
       "Personalizations": "[{\"subject\": \"Test Subject3\",\"send_at\": 1698659820,\"from\": {\"name\": \"hi\",\"email\": \"email@gmail\"},\"to\":      
       [{\"email\": \"email@gmail.com\",\"name\": \"test\"}\n ]}]",
       "Content": "[{\"value\": \"abc@cdata.com\",\"type\": \"text/plain\"}]"
   }

Esta acción devuelve un mensaje de confirmación. Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea tendrá un valor similar al siguiente:

[{
"Success": "True"
}]

Ejemplos de operaciones de entidades

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

Ejemplo: enumerar todos los contactos

En este ejemplo se enumeran todos los contactos de la entidad NMCContacts.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona NMCContacts en la lista Entity.
3. Selecciona la operación List y, a continuación, haz clic en Hecho.
4. Opcionalmente, en la sección Entrada de tarea de la tarea Conectores, puedes filtrar el conjunto de resultados especificando una cláusula de filtro. Por ejemplo, City='Bangalore'. También puede especificar varias condiciones de filtro mediante operadores lógicos. Por ejemplo, City='Bangalore' and region='asia-south2'.

Ejemplo: obtener un registro

En este ejemplo se obtiene un registro con el ID especificado de la entidad NMCSegments.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona NMCSegments en la lista Entity.
3. Selecciona la operación Get y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haga clic en EntityId y, a continuación, introduzca 0d44bb3f-d28e-4bcf-aba2-c77be831ad46 en el campo Valor predeterminado.

   En este caso, 0d44bb3f-d28e-4bcf-aba2-c77be831ad46 es un valor de clave principal de la entidad NMCSegments.

Ejemplo: crear un registro

En este ejemplo, se crea un registro en la entidad NMCSenders.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona NMCSenders en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "Nickname": "Test",
   "FromEmail": "test1@examplepetstore.com",
   "FromName": "testuser",   
   "ReplytoEmail": "test1@examplepetstore.com",  
   "Address": "NA", 
   "City": "NA", 
   "Country": "India"}

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

   {
   "Id": 5360940.0
   }

Ejemplo: crear un registro

En este ejemplo, se crea un registro en la entidad NMCLists.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona NMCLists en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "Name": "TEST_CON_LIST1699262238224",
   "ContactCount": 3.0}

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

   {
   "Id": "d927f128-b718-447a-affe-417f1a8b3abd"}

Ejemplo: actualizar un registro

En este ejemplo se actualiza un registro de la entidad NMCSenders.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona NMCSenders en la lista Entity.
3. Selecciona la operación Update y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "Nickname": "Test",
   "FromEmail": "test2@examplepetstore.com",
   "FromName": "testuser",   
   "ReplytoEmail": "test2@examplepetstore.com",  
   "Address": "NA", 
   "City": "NA", 
   "Country": "India"}

5. Haga clic en entityId y, a continuación, introduzca 5360940.0 en el campo Valor predeterminado.

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

   {
   "Id":"5360940.0"
   }

Ejemplo: eliminar un registro

En este ejemplo se elimina el registro con el ID especificado de la entidad NMCSegments.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona NMCSegments en la lista Entity.
3. Selecciona la operación Delete y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haga clic en entityId y, a continuación, introduzca c58b9151-7279-428a-bac2-12b4bf2b48b0 en el campo Valor predeterminado.