Crear conexiones para servicios en automatizaciones codificadas

Esta sección te ayuda a crear las conexiones necesarias para acceder a las API desde servicios que utilizan conexiones, como GSuite.Activities y Excel.Activities dentro de las automatizaciones codificadas.

Comienza creando una conexión en Integration Service. Se puede acceder a las conexiones dentro de la misma organización y tenant de tu proyecto de automatización codificado. Dentro de la automatización codificada, utiliza el objeto connections para acceder a las conexiones creadas anteriormente en Integration Service y luego acceder a las API correspondientes.

Después de completar la automatización y publicarla en Orchestrator, puedes anular las configuraciones de conexión originales configuradas en código, si es necesario.

Requisitos previos

Crea una conexión en Integration Service:

1. Ve a Integration Service y selecciona el tenant al que está conectado tu Studio.
2. Navega a Conexiones.
3. Selecciona Añadir conexión y crea una conexión para una de las siguientes aplicaciones:
   • Google Drive
   • Gmail
   • Google Sheets
   • Microsoft Office 365

Pasos

1. Abra una automatización codificada existente de la misma organización y el tenant donde creó inicialmente su conexión.
2. Dentro del cuerpo Execute(), escribe connections, y luego pulsa Ctrl + Space para ver las conexiones disponibles.
   Dependiendo de la aplicación para la que creaste anteriormente connection, puedes elegir entre los siguientes tipos de conexión:

   • G Drive
   • Gmail
   • Google Sheets
   • Excel
   • OneDrive
   • O365Mail
3. Configura aún más tu conexión añadiendo el nombre de la carpeta y subcarpeta de Orchestrator y la dirección de conexión específica que deseas. Utiliza subrayados para separar esta información.
   Por ejemplo, una conexión de Gmail para la carpeta My Workspace y subcarpeta My Gmail Worskapce en Orchestrator y para la dirección [e-mail] se escribiría en código como: connections.Gmail.My_Workspace_My_Gmail_Workspace_john_doe_gmail_com.

   Recomendable

   Te recomendamos que crees tus conexiones en un solo paso para evitar posibles errores. También te recomendamos que crees una variable para la conexión. De esta manera, si se producen cambios en Integration Service, evitarás actualizar cada instancia de la conexión a lo largo de tu automatización. Utilice el siguiente enfoque:

   var myGmailConnection = connections.Gmail.My_Workspace_My_Gmail_Workspace_john_doe_gmail_com;

   Evita crear tus conexiones en dos pasos separados como:

   var myGmailConnection = connections.Gmail;
   myGmailConnection.My_Workspace_My_Gmail_Workspace_john_doe_gmail_com;

4. Una vez que hayas establecido el connection, puedes acceder a las API relevantes específicas de un servicio a través de ese connection.
   Por ejemplo, si has configurado una conexión de Gmail de la siguiente manera: var myGmailConnection = connections.Gmail.My_Workspace_john_doe_gmail.com, puedes utilizar la API del servicio mediante myGmailConnection.

Anular la conexión en Orchestrator

1. Publica tu proyecto en Orchestrator.
2. Ve a la fuente de Orchestrator donde has publicado el proyecto.
3. Ve al proceso publicado y selecciona Editar.
4. En Configuración del proceso, elige la automatización codificada que contiene tu conexión configurada como punto de entrada.
5. En Requisitos del paquete, busca y selecciona el tipo de conexión correspondiente para tu automatización codificada.

   Ten cuidado al seleccionar el tipo de conexión para tu automatización codificada, ya que las conexiones para los archivos XAML dentro de tu proyecto también aparecen en la lista.

6. Identifica y selecciona la dirección de cuenta que planeas asociar con la conexión cuando se ejecute.

Limitación conocida

La conexión predeterminada de una biblioteca exportada funcionará en otros proyectos, solo si el proyecto importado está en el mismo tenant que el proyecto de biblioteca de origen.