Alcance técnico y requisitos previos
El Automation Office 365 Action Pack integra las operaciones de archivos de Microsoft 365 SharePoint en los flujos de trabajo de Automic Automation. Incluye un conjunto de acciones públicas para cargar, descargar y eliminar archivos en SharePoint, además de acciones de gestión de conexiones para registrar credenciales de aplicaciones de Azure. Todas las llamadas a SharePoint se autentican contra Microsoft Graph mediante el flujo de credenciales de cliente y se ejecutan a través del agente WebService REST de Automic.
Esta Guía completa cubre el alcance, la instalación, la configuración, la referencia completa de acciones y la ruta de actualización. Es el documento técnico de referencia para los administradores de Automic y los responsables de plataforma que implementan el Automation Office 365 Action Pack en un entorno de producción de Automic.
Plataformas compatibles
- Automic Automation: Líneas de versión V24 y posteriores
- SharePoint: SharePoint Online (Microsoft 365) a través de la API de Microsoft Graph
- Autenticación: Registro de aplicaciones de Microsoft Entra ID (anteriormente Azure AD) con flujo de credenciales de cliente
Requisitos previos en el lado de Automic
- Un sistema Automic Automation en ejecución con un inquilino (cliente) accesible distinto del cliente 0; el Action Pack no se puede instalar en el cliente 0
- Un agente de WebService REST configurado y accesible para el inquilino en el que está instalado el Action Pack
- Un agente de sistema operativo y un objeto Login correspondiente — solo se requieren para la acción de carga cuando Delete source = true y para la acción de descarga cuando se deben crear subdirectorios locales
- Opcional: el Action Pack dependiente PCK.ITPA_SHARED — instálelo primero si aún no está presente en el cliente de destino
Requisitos previos en el lado de Microsoft 365
- Un registro de aplicación de Entra ID (Azure AD) con un secreto de cliente generado
- — el identificador único del inquilino de Microsoft 365 / Entra ID
- ID de cliente — el ID de la aplicación (cliente) de la aplicación registrada
- — el valor secreto asociado al ID de cliente
- Permiso de API: Sites.ReadWrite.All (Permiso de aplicación, no delegado), consentimiento del administrador concedido
- Accesibilidad de red desde el agente REST de WebService a graph.microsoft.com y login.microsoftonline.com.
Instalación, actualización y desinstalación
El Automation Office 365 Action Pack se instala a través de la interfaz estándar Administración → Packs de Automic. El mismo flujo de trabajo cubre la instalación inicial y las actualizaciones in situ. Todas las operaciones deben realizarse en un cliente de Automic distinto de 0; no se admite la instalación en el cliente 0.
Instalación / actualización
- Iniciar sesión en el cliente Automic de destino (no en el cliente 0)
- Cambie a la vista de
- Abra la entrada de menú Packs
- si aún no está instalado, instale el Action Pack dependiente PCK.ITPA_SHARED
- Haga clic en Install From File
- Seleccione el archivo del Automation Office 365 Action Pack y confirme con Install
- Si ya hay instalada una versión anterior, confirme la actualización haciendo clic de nuevo en Install
- Confirme la instalación correcta con
Después de la instalación, el Action Pack aparece dentro de la carpeta PACKAGES del cliente Automic.
Desinstalar
- Inicie sesión en el cliente Automic donde está instalado el Action Pack
- Cambie a la vista de
- Abra la entrada de menú Packs
- Seleccione el Automation Office 365 Action Pack y haga clic en Remove
- Confirme la desinstalación haciendo clic en Yes
- Confirme la eliminación correcta con Close
Configuración: conexión con un inquilino de Azure
Antes de que pueda ejecutarse cualquier acción de SharePoint, el Automation Office 365 Action Pack necesita al menos una configuración de conexión con nombre que apunte a un inquilino de Entra ID/Azure. Las configuraciones se gestionan a través de tres acciones dedicadas: CONFIGURATION_ADD, CONFIGURATION_UPDATE y CONFIGURATION_REMOVE. Cada acción de SharePoint hace referencia a una configuración por nombre en tiempo de ejecución.
Crear una nueva configuración
- Iniciar la acción CONFIGURATION_ADD
- Complete los campos requeridos (ver tabla de parámetros a continuación)
- Confirme haciendo clic en
Parámetros de configuración
| Parámetro | Variable | Notas y ejemplo |
|---|---|---|
| Nombre | &AUT_O365_CONFIGURATION# |
Nombre de configuración libre. Sintaxis recomendada: TENANT_APPID — por ejemplo, MYCOMPANY_MYAPP o AUTOMIC_0100 |
| ID de inquilino | &AUT_O365_TENANT_ID# |
El ID de inquilino único del entorno de Azure / Entra ID al que conectarse |
| ID de cliente | &AUT_O365_CLIENT_ID# |
El ID de cliente único de la aplicación registrada |
| Secreto del cliente | &AUT_O365_CLIENT_SECRET# |
El valor del secreto del cliente junto con el ID del cliente |
| Tipo de concesión | &AUT_O365_GRANT_TYPE# |
Tipo de concesión de OAuth 2.0. Valor típico: |
| Alcance | &AUT_O365_SCOPE# |
URL del ámbito de Microsoft Graph. Valor típico: https://graph.microsoft.com/.default |
Actualización y eliminación de configuraciones
- Para crear configuraciones adicionales, inicie CONFIGURATION_ADD de nuevo con un nombre nuevo
- Para modificar una configuración existente, ejecute CONFIGURATION_UPDATE con el nombre de la configuración existente y los campos que desea cambiar
- Para eliminar una configuración, ejecute CONFIGURATION_REMOVE con el nombre de la configuración como el único parámetro requerido.
Referencia de acciones
El Automation Office 365 Action Pack ofrece cinco acciones públicas: dos para la gestión de conexiones y tres para operaciones con archivos de SharePoint. Internamente, todas las acciones de SharePoint obtienen un token de acceso a través de Microsoft Graph, resuelven el sitio y la biblioteca de destino y, a continuación, ejecutan la llamada REST a través del agente WebService REST. Los tokens de acceso se renuevan automáticamente a los 59 minutos, de modo que las transferencias de larga duración siguen funcionando con un token válido. Los siguientes apartados documentan cada acción pública y sus parámetros.
4.1 · CONFIGURATION_ADD / CONFIGURATION_UPDATE
Crear o actualizar una configuración de conexión con nombre utilizada para autenticarse contra Microsoft Graph.
Nombres de objetos:
- PCK.TRICISE_AUT_O365.PUB.ACTION.CONFIGURATION_ADD
- PCK.TRICISE_AUT_O365.PUB.ACTION.CONFIGURATION_UPDATE
Parámetros: ver la tabla de parámetros de configuración en la Sección 3 anterior.
4.2 · CONFIGURATION_REMOVE
Eliminar una configuración de conexión existente.
Nombre del objeto: PCK.TRICISE_AUT_O365.PUB.ACTION.CONFIGURATION_REMOVE
| Parámetro | Variable | Notas y ejemplo |
|---|---|---|
| Nombre | &AUT_O365_CONFIGURATION# |
Nombre de configuración existente — p. ej. MYTENANT_APPID |
4.3 · SHAREPOINT_FILES_UPLOAD
Cargar uno o más archivos locales en una biblioteca de SharePoint a través de Microsoft Graph REST. La selección de archivos admite comodines y el recorrido recursivo opcional de subdirectorios; los archivos cargados se pueden eliminar opcionalmente de la ruta de origen después de una transferencia exitosa.
Nombre del objeto: PCK.TRICISE_AUT_O365.PUB.ACTION.SHAREPOINT_FILES_UPLOAD
Subprocesos internos:
- SHAREPOINT_GET_TOKEN — adquiere el token de acceso de Microsoft Graph
- SHAREPOINT_GET_SITE — resuelve el sitio de SharePoint de destino
- SHAREPOINT_FILES_UPLOAD → SHAREPOINT_FILE_UPLOAD — ejecuta la carga por archivo
- SHAREPOINT_FILES_DELETE— se invoca cuando
Delete source = truepara limpiar el origen después de la carga.
| Parámetro | Variable | Notas y ejemplo |
|---|---|---|
| Enlace del sitio | &AUT_O365_SITE_LINK# |
Referencia única del sitio de SharePoint. Ejemplo: mydomain.sharepoint.com:/sites/mySite |
| Nombre de la biblioteca | &AUT_O365_DRIVE_NAME# |
Biblioteca de SharePoint de destino. La biblioteca predeterminada en SharePoint es “Freigegebene Dokumente” / “Documentos compartidos”. Ejemplo: Dokumente |
| Ruta de SharePoint | &AUT_O365_SHAREPOINT_PATH# |
Carpeta de destino dentro de la biblioteca. Puede ser la raíz (root) o una subcarpeta (root:/MyFolder/MySubfolder). Ejemplo: root:/myFolder |
| Patrón de ruta de archivo | &AUT_O365_FILE_PATTERN# |
Patrón de selección de archivo. Completamente calificado o comodín. Ejemplo: *.txt |
| Ruta local | &AUT_O365_LOCAL_PATH# |
Directorio de origen local que contiene los archivos a cargar. Ejemplo: C:\temp |
| Agente del sistema operativo | &AUT_O365_AGENT# |
Agente del sistema operativo utilizado para la eliminación de origen cuando Delete source = true. Ejemplo: MYAGENT |
| Login del SO | &AUT_O365_LOGIN# |
Objeto Login utilizado para la eliminación del origen cuando Delete source = true. Ejemplo: LOGIN.MYLOGIN |
| Incluir carpetas | &AUT_O365_RECURSIVE# |
Recorrer subdirectorios durante la carga. verdadero / falso |
| Eliminar origen | &AUT_O365_DELETE_SOURCE# |
Eliminar archivos cargados de la ruta de origen después de una carga exitosa. verdadero / falso |
4.4 · SHAREPOINT_FILES_DOWNLOAD
Descargar uno o varios archivos de una biblioteca de SharePoint a un directorio de destino local a través de Microsoft Graph REST. Admite la selección por comodín y el recorrido recursivo opcional de subcarpetas.
Nombre del objeto: PCK.TRICISE_AUT_O365.PUB.ACTION.SHAREPOINT_FILES_DOWNLOAD
Subprocesos internos:
- SHAREPOINT_GET_TOKEN — adquiere el token de acceso de Microsoft Graph
- SHAREPOINT_GET_SITE — resuelve el sitio de SharePoint de destino
- SHAREPOINT_GET_ITEM_ID / SHAREPOINT_GET_ITEM_IDS — resuelve uno o varios ID de elemento para la descarga
- SHAREPOINT_FILES_DOWNLOAD → SHAREPOINT_FILE_DOWNLOAD — ejecuta la descarga por archivo
| Parámetro | Variable | Notas y ejemplo |
|---|---|---|
| Enlace del sitio | &AUT_O365_SITE_LINK# |
Referencia única del sitio de SharePoint. Ejemplo: mydomain.sharepoint.com:/sites/mySite |
| Nombre de la biblioteca | &AUT_O365_DRIVE_NAME# |
Biblioteca de SharePoint de origen. Por defecto: “Documentos compartidos”. Ejemplo: Dokumente |
| Patrón de ruta de archivo | &AUT_O365_FILE_PATTERN# |
Patrón de selección de archivo. Completamente calificado o comodín. Ejemplo: *.txt |
| Ruta de SharePoint | &AUT_O365_SHAREPOINT_PATH# |
Carpeta de origen dentro de la biblioteca. Raíz (root) o subcarpeta (root:/MyFolder/MySubfolder) |
| Ruta local | &AUT_O365_LOCAL_PATH# |
Directorio local de destino para los archivos descargados. Ejemplo: C:\temp |
| Incluir carpetas | &AUT_O365_RECURSIVE# |
Recorrer subcarpetas de SharePoint durante la descarga. true / false |
4.5 · SHAREPOINT_FILES_DELETE
Eliminar uno o más archivos de una biblioteca de SharePoint. Los archivos se eliminan a través de Microsoft Graph REST, lo que los mueve a la papelera de reciclaje de SharePoint en lugar de borrarlos permanentemente.
Nombre del objeto: PCK.TRICISE_AUT_O365.PUB.ACTION.SHAREPOINT_FILES_DELETE
Subprocesos internos:
- SHAREPOINT_GET_TOKEN
- SHAREPOINT_GET_SITE
- SHAREPOINT_GET_ITEM_ID / SHAREPOINT_GET_ITEM_IDS
- SHAREPOINT_FILES_DELETE → SHAREPOINT_FILE_DELETE
| Parámetro | Variable | Notas y ejemplo |
|---|---|---|
| Enlace del sitio | &AUT_O365_SITE_LINK# |
Referencia única del sitio de SharePoint. Ejemplo: mydomain.sharepoint.com:/sites/mySite |
| Nombre de la biblioteca | &AUT_O365_DRIVE_NAME# |
Biblioteca de SharePoint de origen. Por defecto: “Documentos compartidos” |
| Patrón de ruta de archivo | &AUT_O365_FILE_PATTERN# |
Patrón de selección de archivo. Completamente calificado o comodín. Ejemplo: *.txt |
| Ruta de SharePoint | &AUT_O365_SHAREPOINT_PATH# |
Carpeta de origen dentro de la biblioteca. Carpeta raíz o subcarpeta. Ejemplo: root:/myFolder |
| Incluir carpetas | &AUT_O365_RECURSIVE# |
Recorrer subcarpetas de SharePoint durante la eliminación. true/false |
Actualización y migración
Actualizar Automation Office 365 Action Pack utiliza el mismo flujo de trabajo de Instalar desde archivo que la instalación inicial. Automic reconoce la instalación existente y solicita una confirmación de actualización; seleccionar Instalar reemplaza la versión instalada sin moverla. Las configuraciones creadas a través de CONFIGURATION_ADD se conservan en las actualizaciones.
Procedimiento de actualización recomendado
- Haga una copia de seguridad o exporte el inquilino correspondiente para conservar un punto de restauración
- Pause los flujos de trabajo que hagan referencia a las acciones de SharePoint del Action Pack
- con el nuevo archivo del Action Pack y confirme la actualización
- Realice una prueba rápida (smoke test) de una carga, una descarga y una eliminación con datos conocidos en un sitio de SharePoint de prueba
- Reanudar los flujos de trabajo pausados
Notas de la versión
Todas las versiones del Automation Office 365 Action Pack y los cambios de cada una.
v2.1.2 (actual) · 2026-07-08
| Versión | Tipo | Cambio |
|---|---|---|
| 2.1.2 2026-07-08 | Modificado | Trabajo preparatorio para las sesiones de carga (CREATEUPLOADSESSION); todavía no está activo |
Versiones anteriores
Versiones 1.0.0 – 2.1.1
| Versión | Tipo | Cambio |
|---|---|---|
| 2.1.1 2026-05-11 | Corregido | Carga con Delete source: las rutas y los nombres de archivo con espacios se ponen entre comillas (include PCK.TRICISE_AUT_O365.PRV.INCLUDE.SHAREPOINT_FILE_UPLOAD_DELETE_SOURCE) |
| 2.1.0 2025-11-14 | Modificado | SHAREPOINT_FILES_DOWNLOAD, SHAREPOINT_FILES_DELETE y SHAREPOINT_FILES_UPLOAD: biblioteca de SharePoint seleccionable |
| 2.0.2 2025-05-15 | Corregido | PCK.TRICISE_AUT_O365.PRV.JOB.SHAREPOINT_FILE_DOWNLOAD: valor de salida entre comillas, de modo que se pueden descargar archivos con espacios en el nombre |
| 2.0.1 2025-04-03 | Corregido | PCK.TRICISE_AUT_O365.PRV.JOB.SHAREPOINT_GET_DOWNLOAD_URL: &ITERATION_ITEM# se publica en TOP en lugar de en WORKFLOW |
| 2.0.0 2025-02-11 | Nuevo | Acciones CONFIGURATION_ADD, CONFIGURATION_REMOVE y CONFIGURATION_UPDATE |
| Modificado | La descarga, la eliminación y la carga leen sus credenciales del objeto Variable de configuración | |
| 1.5.0 2025-01-17 | Modificado | SHAREPOINT_GET_TOKEN comprueba si el token debe renovarse tras 59 minutos |
| Modificado | La descarga, la eliminación y la carga renuevan el token a los 59 minutos | |
| 1.4.0 2024-12-03 | Modificado | Descarga, eliminación y carga recursivas |
| 1.3.3 2024-11-28 | Corregido | Mejoras de rendimiento gracias a respuestas más reducidas y a un filtrado más inteligente |
| 1.3.2 2024-09-03 | Corregido | Informes de solicitud y respuesta de los jobs REST desactivados, porque llenaban el sistema de archivos |
| 1.2.1 2024-06-26 | Corregido | Carga: &AUT_O365_LOCAL_PATH# y &AUT_O365_FILENAME_UPLOAD# se definen en el PromptSet |
| 1.2.0 2024-06-20 | Nuevo | Acciones SHAREPOINT_FILES_DELETE y SHAREPOINT_FILES_DOWNLOAD |
| Nuevo | Acciones internas SHAREPOINT_FILE_DELETE, SHAREPOINT_GET_ITEM_ID y SHAREPOINT_GET_ITEM_CHILDS | |
| 1.0.3 2024-04-17 | Corregido | CONN_ENDPOINT_URL demasiado largo: se divide en URL y recurso |
| 1.0.2 2024-03-20 | Modificado | SHAREPOINT_FILES_UPLOAD: nueva opción Delete source (true / false) |
| 1.0.1 2024-03-19 | Nuevo | Acción SHAREPOINT_FILES_UPLOAD |
| 1.0.0 2024-03-19 | Nuevo | Versión inicial |
Preguntas frecuentes
¿Qué hace el Automation Office 365 Action Pack?
El Automation Office 365 Action Pack añade la carga, la descarga y la eliminación de SharePoint a los flujos de trabajo de Automic Automation. Encapsula la autenticación de Microsoft Graph, la gestión de tokens de acceso y las llamadas REST en cinco acciones públicas, de modo que las operaciones de archivos en SharePoint puedan orquestarse directamente desde Automic sin desarrollar una integración personalizada.
¿Qué versiones de Automic son compatibles?
El Automation Office 365 Action Pack es compatible con Automic Automation V24 y líneas de versión posteriores. Los sistemas V21 anteriores no están cubiertos por la versión actual; Tricise proporciona actualizaciones de compatibilidad a medida que llegan nuevas versiones principales de Automic.
¿Qué permisos de Microsoft Graph necesita?
El Automation Office 365 Action Pack requiere el permiso Aplicación Sites.ReadWrite.All (no Delegado) en la aplicación de Entra ID registrada, con el consentimiento del administrador concedido. Se utiliza el flujo OAuth 2.0 de credenciales de cliente para obtener tokens de acceso a través de login.microsoftonline.com y luego llama a Microsoft Graph en graph.microsoft.com.
¿Puede el Action Pack dirigirse a varios inquilinos de Microsoft 365?
Sí. El Automation Office 365 Action Pack admite un número ilimitado de conexiones con nombre por cliente Automic. Cada conexión almacena su propio ID de inquilino, ID de cliente, secreto de cliente, tipo de concesión y alcance. Cada acción de SharePoint hace referencia a una configuración a través del parámetro &AUT_O365_CONFIGURATION#, lo que facilita las configuraciones multi-inquilino y el intercambio de archivos entre inquilinos.
¿Dónde está instalado el Action Pack y puedo moverlo?
El Automation Office 365 Action Pack se instala en la carpeta PACKAGES del cliente Automic a través de Administración → Packs → Instalar desde archivo. El Action Pack debe permanecer dentro de esa carpeta y no debe ser renombrado; hacer cualquiera de las dos cosas rompe las referencias internas. La instalación en el cliente 0 no está soportada.
¿La acción de carga requiere un agente del sistema operativo?
La acción de carga del Automation Office 365 Action Pack solo necesita un agente de sistema operativo y un objeto Login cuando Delete source = true, porque la eliminación del origen se ejecuta en el sistema de archivos donde residen los archivos cargados. Para cargas puras sin eliminación del origen, el agente REST del servicio web es suficiente. La acción de descarga utiliza el agente del sistema operativo solo cuando es necesario crear subdirectorios locales para una descarga recursiva.
¿Qué sucede cuando se ejecuta una acción de eliminación en SharePoint?
La acción de eliminación del Automation Office 365 Action Pack no elimina los archivos de forma permanente. Los elementos coincidentes se mueven a la papelera de reciclaje de SharePoint a través de Microsoft Graph, lo que significa que se pueden restaurar desde la papelera de reciclaje dentro del periodo de retención de SharePoint si una eliminación resulta ser errónea.
¿Pueden los patrones de ruta de archivo usar comodines?
Sí. El parámetro &AUT_O365_FILE_PATTERN# acepta nombres de archivo completos y patrones de comodín como *.txt o report_*.csv. Combinado con la marca Incluir carpetas, el Automation Office 365 Action Pack puede procesar árboles de directorios completos en una única llamada de acción.
¿Se admiten nombres de archivos y carpetas con espacios?
Sí. Las rutas y los nombres de archivo con espacios se ponen correctamente entre comillas: en las descargas desde la versión 2.0.2 y en las cargas con Delete source desde la versión 2.1.1.
¿Cómo funciona la actualización a una nueva versión?
Las actualizaciones del Automation Office 365 Action Pack reutilizan el flujo estándar de Install From File. Automic detecta una instalación existente, solicita confirmación y reemplaza el Action Pack en su ubicación dentro de la carpeta PACKAGES. Las configuraciones de conexión con nombre creadas a través de CONFIGURATION_ADD se conservan en las actualizaciones.
¿El Action Pack depende de otros paquetes de Tricise?
El Automation Office 365 Action Pack depende de PCK.ITPA_SHARED, un Action Pack de utilidades compartido. Si aún no está presente en el cliente Automic de destino, instálelo desde la misma interfaz Administración → Packs antes de instalar el propio Office 365 Action Pack.
¿Cuánto cuesta el Automation Office 365 Action Pack?
El Automation Office 365 Action Pack se licencia como compra única por 3.200 € (IVA no incluido) por sistema Automic. El precio se muestra en la página de la tienda de Tricise e incluye el soporte de producto de Tricise y las actualizaciones de compatibilidad para la línea de versiones actual de Automic V24+. No hay cuota de suscripción recurrente.
¿Dónde puedo comprar el Automation Office 365 Action Pack?
El Automation Office 365 Action Pack está disponible en la tienda de Tricise en tricise.com/shop/automation-office-365. Para preguntas sobre licencias, alcance de múltiples sistemas, incorporación o demostraciones en vivo, contacte a Tricise a través del formulario de consulta.