Outlook Connect

Tipo: outlook-connect · Paquete: Outlook Activities v1.0.4 · Salida: ZoanOutlookSession

Abre una sesión de Outlook y devuelve un ZoanOutlookSession. No es obligatorio: las demás actividades funcionan solas usando la cuenta por defecto. Usa Connect cuando necesites una cuenta concreta (distinta de la predeterminada) o vayas a hacer varias operaciones seguidas: todas comparten una sola conexión con Outlook en lugar de abrir una por actividad.

Cómo funciona

Conecta con el Outlook instalado (si no está abierto, lo inicia en segundo plano) y guarda la cuenta indicada en account (o ninguna, para usar la predeterminada). Dos modos:

Con body: las actividades dentro heredan la sesión (y su cuenta) automáticamente, y se cierra sola al terminar, también si una actividad del body falla.
Sin body: devuelve la sesión como salida; pásala como session a las actividades y ciérrala con Outlook Close.

La cuenta se usa en dos momentos:

Al enviar (Outlook Send Email): el correo sale desde la cuenta cuyo nombre visible o dirección SMTP coincida con account.
Al resolver carpetas: las rutas se buscan desde la raíz del buzón de esa cuenta (ver Carpetas).

Connect no valida la cuenta al abrir la sesión: si ninguna cuenta del perfil coincide con account, los envíos salen por la cuenta predeterminada y las carpetas se buscan en el buzón predeterminado. Revisa que el texto coincida exactamente con el nombre o correo que muestra Outlook (sin distinguir mayúsculas).

Requisitos: Outlook instalado con un perfil de correo configurado, en una sesión de usuario, con el mismo nivel de elevación que el robot.

Parámetros requeridos

Ninguno.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`account`	`string`	—	Nombre visible de la cuenta o su dirección de correo (ej. `"soporte@empresa.com"`). Sin valor se usa la cuenta predeterminada del perfil.

Sub-flujos

`body`

Opcional. Actividades que se ejecutan con esta sesión; la heredan sin indicar session. Al salir (con éxito o con error) la sesión se cierra. Si el body está vacío, la actividad devuelve la sesión como salida.

Salida

Sin body: devuelve un ZoanOutlookSession. Pásalo como session a las demás actividades de Outlook y ciérralo con Outlook Close.
Con body: no devuelve ningún valor (la sesión solo existe dentro del body).

Errores comunes

Mensaje	Causa y solución
`COM component 'Outlook.Application' is not registered. Is the application installed?`	Outlook de escritorio no está instalado en la máquina del robot. Instálalo, o usa el paquete SMTP/IMAP, que no lo necesita.
Error de COM al crear la instancia (acceso denegado, servidor no disponible)	Outlook está abierto con otro nivel de elevación que el robot, o no hay sesión de usuario. Ejecuta ambos con el mismo nivel y en una sesión interactiva.

Ejemplo

Procesar el correo de una cuenta compartida y responder desde ella:

Outlook Connect   account = "facturas@empresa.com"
 └─ body:
      Outlook Get Emails   folder = "Bandeja de entrada"   unreadOnly = true   → output: correos
      For Each   items = correos   itemVariable = correo
       └─ activities:
            Outlook Get Attachments   entryId = correo.Id   outputDir = "C:/facturas"   → output: archivos
            Outlook Send Email   to = "contabilidad@empresa.com"   subject = "Factura recibida: " + correo.Subject   attachments = archivos
            Outlook Mark Read   entryId = correo.Id

Actividades relacionadas

Outlook Close — cerrar la sesión (modo sin body).
Outlook Get Emails / Outlook Send Email — operar en la sesión.