Office365

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 las acciones que admite el conector. Para saber cómo configurar las acciones, consulta los ejemplos de acciones.

Acción CancelEvent

Esta acción te permite cancelar un evento.

Parámetros de entrada de la acción CancelEvent

Para ver un ejemplo de cómo configurar la acción CancelEvent, consulta Ejemplos de acciones.

Acción MoveMail

Esta acción te permite mover un correo.

Parámetros de entrada de la acción MoveMail

Para ver un ejemplo de cómo configurar la acción MoveMail, consulte Ejemplos de acciones.

Acción AssignLicense

Esta acción te permite asignar una licencia.

Parámetros de entrada de la acción AssignLicense

Para ver un ejemplo de cómo configurar la acción AssignLicense, consulta Ejemplos de acciones.

Acción ForwardEvent

Esta acción te permite reenviar un evento.

Parámetros de entrada de la acción ForwardEvent

Para ver un ejemplo de cómo configurar la acción ForwardEvent, consulta Ejemplos de acciones.

Acción UploadFile

Esta acción te permite subir un archivo.

Parámetros de entrada de la acción UploadFile

Para ver un ejemplo de cómo configurar la acción UploadFile, consulta Ejemplos de acciones.

Acción DownloadFile

Esta acción te permite descargar un archivo.

Parámetros de entrada de la acción DownloadFile

Para ver un ejemplo de cómo configurar la acción DownloadFile, consulta Ejemplos de acciones.

Acción CreateFolder

Esta acción te permite crear una carpeta.

Parámetros de entrada de la acción CreateFolder

Para ver un ejemplo de cómo configurar la acción CreateFolder, consulta Ejemplos de acciones.

Acción SendMail

Esta acción te permite enviar un correo.

Parámetros de entrada de la acción SendMail

Para ver un ejemplo de cómo configurar la acción SendMail, consulta Ejemplos de acciones.

Acción ForwardMail

Esta acción te permite reenviar un correo.

Parámetros de entrada de la acción ForwardMail

Para ver un ejemplo de cómo configurar la acción ForwardMail, consulta Ejemplos de acciones.

Acción DownloadEmail

Con esta acción, puedes descargar un correo.

Parámetros de entrada de la acción DownloadEmail

Para ver un ejemplo de cómo configurar la acción DownloadMail, consulta Ejemplos de acciones.

Acción DownloadAttachments

Esta acción te permite descargar los archivos adjuntos de un correo.

Parámetros de entrada de la acción DownloadAttachments

Por ejemplo, para saber cómo configurar la acción DownloadAttachments, consulta Ejemplos de acciones.

Ejemplos de acciones

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

Ejemplo: cancelar un evento

En este ejemplo se cancela un evento con el ID especificado.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción CancelEvent 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:

   {
   "EventId": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGAAAAAACvzgT4b7T_Qav2LM_bB-GAAA=",   
   "Comment": "Canceled due to rain"
   }

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea CancelEvent tendrá un valor similar al siguiente:

[{
"Status": "Success"
}]

Ejemplo: asignar y retirar una licencia

En este ejemplo se asignan y se retiran licencias del usuario especificado.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción AssignLicense 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:

   {
   "UserID": "ee58217f-b22e-4300-a876-53db3c71a87b",   
   "AddLicenseSkuId": "c42b9cae-ea4f-4ab7-9717-81576235ccac",   
   "RemoveLicenses": "c42b9cae-ea4f-4ab7-9717-81576235ccac"
   }

Si la acción se realiza correctamente, el parámetro connectorOutputPayload de la respuesta AssignLicense tendrá un valor similar al siguiente:

[{
"Status": "Success"
}]

Ejemplo: reenviar un evento

En este ejemplo se reenvía un evento.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción ForwardEvent 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:

   {
   "EventId": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGAAAAAACvzgT4b7T_Qav2LM_bB-PKBwAhfASdetQfTZ3pESzwWnAbAAAAAAENAAAhfASdetQfTZ3pESzwWnAbAAA_CxGjAAA=",   
   "Comment": "forwarded due to rain",   
   "ToRecipients": "test99@example.com"
   }

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea ForwardEvent tendrá un valor similar al siguiente:

[{
"Status": "Success"
}]

Ejemplo: subir un archivo

En este ejemplo se sube un archivo.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción UploadFile 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:

   {
   "FileName": "Document1234.docx",   
   "ParentId": "01VCU572N6Y2GOVW7725BZO354PWSELRRZ",   
   "Content": "test"
   }

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea UploadFile tendrá un valor similar al siguiente:

 [{
"Id": "01VCU572JX6F3L3NKLQVB2BXETRHLEAUAY",   
"@test.context": "https://example.com/v1.0/$metadata#users('7954f490-5a43-083fc215362a')/drive/items('01VCU5BZO354PWSELRRZ')/test/$entity",   
"@example.downloadurl": "https://example.com/test/admin123/_layouts/15/download.aspx?UniqueId=bd76224r7-4........
"Status": "Success"
}] 

Ejemplo: descargar un archivo

En este ejemplo se descarga un archivo.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción DownloadFile 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:

   {
   "FileId": "01VCU572LDCGQYZOSMHZDZGN5HCXS5P6EP"
   }

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea DownloadFile tendrá un valor similar al siguiente:

[{
"Status": "Success",
"FileData": "UEsDBBQAAAAIAEoTdVdSWj6GTAEAABoFAAATAAAAWNdLnhtbLWUTU7DMBCFr2J"
}]

Ejemplo: crear una carpeta

En este ejemplo se crea una carpeta.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción CreateFolder 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:

   {
   "ParentId": "01VCU572N6Y2GOVW7725BZO354PWSELRRZ",   
   "FolderName": "outbox1234"
   }

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea CreateFolder tendrá un valor similar al siguiente:

[{
"Status": "Success"
}]

Ejemplo: enviar un correo

En este ejemplo se envía un correo a los destinatarios especificados.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción SendMail 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:

   {
   "ToRecipients": "test097@example.com",   
   "Content": "Testing",   
   "Subject": "Test subject",   
   "FileName": "Google"
   }

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea SendMail tendrá un valor similar al siguiente:

[{
"Status": "Success"
}]

Ejemplo: reenviar un correo

En este ejemplo se reenvía un correo.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción ForwardMail 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:

   {
   "MessageId": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGAAAAAACvzgT4b7T_Qav2LM_bB-PKBwAhfASdetQfTpESzwWnAbAAA0sITVAAA=",   
   "ToRecipients": "test097@example.com",   
   "Comment": "forwarded message"
   }

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea ForwardMail tendrá un valor similar al siguiente:

[{
"Status": "Success"
}]

Ejemplo: descargar un correo

En este ejemplo se descarga un correo.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción DownloadEmail 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:

   {
   "MessageId": "fTZ3pESzwWnAbAAAAAAEJAAAhfASdetQfTZ3pESzwWnAbAAA0sITVAAA="
   }

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea DownloadEmail tendrá un valor similar al siguiente:

[{
"Status": "Success",   
"FileData": "RnJvbTogRk5VIExOVSA8YWRtaW4xMjNANzNzY21nLm9ubWljcm9zb2Z0LmNvbT4NClRvOiB0ZXN0IDx0ZXN0.......
}]

Ejemplo: descargar archivos adjuntos

En este ejemplo se descargan archivos adjuntos.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción DownloadAttachments 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:

   {
   {"MessageId": "PKBwAhfASdetQfTZ3pESzwWnAbAAAAAAEJAAAhfASdetQfTZ3pESzwWnAbAAA0sITWAAA=",   
   "DownloadTo": "My files/Office355/reports/"}
   }

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea DownloadAttachments tendrá un valor similar al siguiente:

[{
"Id": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGTWAAABEgAQAF3EBDrnTc1Cj8akAYrJjdM=",
"Name": "demoattachment.docx",
"ContentBytes": "UEsDBBQAAAAIALskYlcppqeszQEAAHQJAAATAAAAWAAAI3RyYXNoXS8wMDAwLmRhdP........",
"LastmodifiedDatetime": "2023-11-21T10:09:09Z",
"ContentType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"FileData": null,
"json:repeatelementorder#": null,
"size": "23575",
"isinline": "false
}]