Outlook Activities

Versión: 1.0.5  ·  ID: zoan-packages-outlook  ·  Autor: Zoan Software

El paquete Outlook automatiza Microsoft Outlook de escritorio: enviar correos, leer la bandeja de entrada, descargar adjuntos, mover mensajes entre carpetas, responder y eliminar. Es ideal para procesos basados en correo: leer pedidos que llegan por email, descargar facturas adjuntas, enviar notificaciones, clasificar mensajes. Como trabaja con las cuentas que Outlook ya tiene configuradas, no necesitas servidores, puertos ni contraseñas en el playbook.

Requiere Outlook instalado y configurado

Estas actividades controlan el cliente Outlook de escritorio (vía COM) usando las cuentas que ya tiene configuradas en la máquina. Por tanto, en el equipo donde se ejecute el robot:

• Microsoft Outlook debe estar instalado y tener un perfil de correo configurado con al menos una cuenta. Si Outlook no está abierto, se inicia en segundo plano.
• Suele necesitar una sesión de usuario activa (modo atendido o un agente con sesión interactiva).
• El robot y Outlook deben ejecutarse con el mismo nivel de elevación: un robot ejecutado como administrador no puede usar un Outlook abierto sin elevar (y al revés).

Si necesitas enviar/leer correo sin Outlook (por servidor SMTP/IMAP genérico), usa el paquete SMTP/IMAP.

La cuenta y la sesión (opcional)

La mayoría de las actividades funcionan directamente, sin pasos previos: usan la cuenta por defecto de Outlook. Por ejemplo, puedes poner un Outlook Get Emails solo y leerá tu Bandeja de entrada. En ese modo, cada actividad abre y libera su propia conexión con Outlook.

Si necesitas usar una cuenta concreta (no la predeterminada) o hacer varias operaciones seguidas de forma eficiente, abre una sesión con Outlook Connect:

Outlook Connect   account = "soporte@empresa.com"
 └─ body:
      Outlook Get Emails   folder = "Inbox"   → output: correos
      ... procesar ...

Dentro del body, las actividades heredan la sesión (y su cuenta) automáticamente, y se cierra sola al terminar. Sin body, Outlook Connect devuelve la sesión como variable y la cierras con Outlook Close.

Carpetas

Los parámetros folder y targetFolder aceptan una ruta con / para subcarpetas ("Inbox/Procesados"). El primer segmento puede ser:

• Un alias en inglés de una carpeta conocida: inbox, sent, drafts, deleted, junk, outbox (sin distinguir mayúsculas).
• El nombre que Outlook le da en tu idioma: "Bandeja de entrada/Procesados", "Elementos enviados".
• Cualquier otro nombre: se busca como subcarpeta de la Bandeja de entrada ("Clientes" = Inbox/Clientes).

Los nombres se comparan sin distinguir mayúsculas. Si un segmento no existe, el error indica en qué nivel de la ruta falló y cuántas subcarpetas tiene la carpeta superior.

Con una sesión con account

Si la sesión se abrió con una cuenta concreta y Outlook encuentra su buzón, la ruta se resuelve desde la raíz de ese buzón: escribe el nombre de la carpeta tal como lo muestra Outlook (por ejemplo "Bandeja de entrada/Procesados" en un Outlook en español). Si el buzón de esa cuenta no aparece, se usan las reglas anteriores sobre el buzón predeterminado.

El flujo con EntryID

El patrón central de este paquete: Outlook Get Emails devuelve una lista de correos (ZoanMail). Cada correo tiene un identificador único, su EntryID, accesible como .Id. Las demás actividades (guardar adjuntos, mover, marcar, eliminar, responder) reciben ese entryId para saber sobre qué correo actuar.

Outlook Get Emails   folder = "Inbox"   unreadOnly = true   → output: correos
For Each   items = correos   itemVariable = correo
 └─ activities:
      Outlook Get Attachments   entryId = correo.Id   outputDir = "C:/adjuntos"   → output: archivos
      Outlook Mark Read         entryId = correo.Id
      Outlook Move Email        entryId = correo.Id   targetFolder = "Inbox/Procesados"

Qué trae cada correo (ZoanMail)

Propiedad	Tipo	Valor en Outlook
.Id	string	EntryID del mensaje.
.Subject	string	Asunto ("" si no tiene).
.From	string	Dirección del remitente. Para remitentes internos de Exchange, Outlook puede entregar su dirección interna en lugar de la SMTP.
.To / .Cc	string[]	Destinatarios tal como los muestra Outlook (nombres o direcciones), separados en una lista.
.Bcc	string[]	Siempre vacío.
.Body	string	Cuerpo en texto plano.
.IsHtml	bool	Siempre false (el cuerpo se entrega en texto plano).
.SentAt	DateTime	Fecha y hora de recepción del mensaje.
.IsRead	bool	true si está leído.
.Attachments	ZoanAttachment[]	Siempre vacío: para obtener los adjuntos usa Outlook Get Attachments.

El tipo completo está en Tipos de datos › ZoanMail.

Actividades

Sesión (opcional)

Actividad	Tipo	Salida	Qué hace
Outlook Connect	outlook-connect	ZoanOutlookSession	Abre una sesión (cuenta específica / varias operaciones)
Outlook Close	outlook-close	—	Cierra una sesión abierta

Enviar y responder

Actividad	Tipo	Salida	Qué hace
Outlook Send Email	outlook-send	—	Envía un correo
Outlook Reply	outlook-reply	—	Responde a un correo

Leer

Actividad	Tipo	Salida	Qué hace
Outlook Get Emails	outlook-get-emails	List<ZoanMail>	Lee correos de una carpeta
Outlook Get Attachments	outlook-get-attachments	List<string>	Guarda los adjuntos de un correo

Organizar

Actividad	Tipo	Salida	Qué hace
Outlook Mark Read	outlook-mark-read	—	Marca un correo como leído/no leído
Outlook Move Email	outlook-move-email	—	Mueve un correo a otra carpeta
Outlook Delete Email	outlook-delete-email	—	Envía un correo a Elementos eliminados

Siguientes pasos

• Outlook Get Emails — leer la bandeja.
• Outlook Send Email — enviar correos.
• Tipos de datos › ZoanMail — las propiedades de un correo.
• SMTP/IMAP — alternativa sin Outlook instalado.