Alcance técnico y requisitos previos
La Oficina de Automatización Office 365 Action Pack integra las operaciones de archivos de Microsoft 365 SharePoint en flujos de trabajo Automic Automation. Envía un conjunto de acciones públicas para cargar, descargar y eliminar archivos en SharePoint, además de acciones de gestión de conexión para registrar credenciales de aplicaciones de Azure. Todas las llamadas a SharePoint se autentican contra Microsoft Graph utilizando el flujo de credenciales de cliente y se ejecutan a través del agente REST WebService 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 autorizado para los administradores de Automic y los propietarios de la plataforma que implementan la solución de Automatización de Office 365 Action Pack en un entorno de producción Automic.
Plataformas compatibles
- Automic Automation: Líneas de lanzamiento 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
Prerrequisitos en el lado 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 tenant en el que está instalado el Action Pack
- Un agente del sistema operativo y un objeto de inicio de sesión coincidente — solo se requieren para la acción de carga cuando Eliminar origen = verdadero y para la acción de descarga cuando se deben crear subdirectorios locales
- Opcional: el dependiente Action Pack 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
- **ID de inquilino** — 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
- **Secreto del cliente** — el valor secreto asociado con el ID del 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
La Automation Office 365 Action Pack se instala a través de la interfaz estándar de 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 distinto de cero Automic, 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)
- Cambiar a la vista de **Administración**
- Abrir la entrada del menú **Paquetes**
- Opcional: si aún no está instalado, instale primero el K.TIEMPO_COMPARTIDOAction Pack dependiente PCK.ITPA_SHARED
- Haga clic en **Instalar desde archivo**
- Seleccione el archivo de Office 365 de Automatización Action Pack y confirme con **Instalar**.
- Si ya hay una versión anterior instalada, confirme la actualización haciendo clic de nuevo en **Instalar**
- Confirme la instalación exitosa con **Cerrar**
Después de la instalación, el Action Pack aparece dentro de la carpeta PACKAGES del cliente Automic.
Desinstalar
- Inicia sesión en el cliente Automic donde está instalado Action Pack
- Cambiar a la vista de **Administración**
- Abrir la entrada del menú **Paquetes**
- Seleccionar la Automation Office 365 Action Pack y hacer clic en **Eliminar**
- Confirme la desinstalación haciendo clic en Sí
- Confirmar eliminación exitosa con **Cerrar**
Configuración - conectar a un tenant de Azure
Antes de que pueda ejecutarse cualquier acción de SharePoint, 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.
Creando una nueva configuración
- Iniciar la acción CONFIGURATION_ADD
- Complete los campos requeridos (ver tabla de parámetros a continuación)
- Confirmar haciendo clic en **Enviar**
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 subvención | &AUT_O365_GRANT_TYPE# |
Tipo de concesión de OAuth 2.0. Valor típico: `client_credentials` |
| 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, reinicie CONFIGURATION_ADD con un nuevo nombre
- 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, ejecuta CONFIGURATION_REMOVE con el nombre de la configuración como el único parámetro requerido.
Referencia de acciones
La Oficina de Automatización de Office 365 Action Pack expone cinco acciones públicas: dos para la gestión de conexiones y tres para operaciones de archivos de SharePoint. Todas las acciones de SharePoint adquieren internamente un token de acceso a través de Microsoft Graph, resuelven el sitio y la biblioteca de destino, y luego ejecutan la llamada REST a través del agente REST de WebService. Las siguientes subsecciones documentan cada acción pública y sus parámetros.
4.1 · CONFIGURACIÓN_AGREGAR / CONFIGURACIÓN_ACTUALIZAR
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.ACTUALIZACIÓN_CONFIGURACIÓN
Parámetros: ver la tabla de parámetros de configuración en la Sección 3 anterior.
4.2 · CONFIGURACIÓN_ELIMINAR
Eliminar una configuración de conexión existente.
Nombre del objeto: PCK.TRICISE_AUT_O365.PUB.ACTION.CONFIGURACION_ELIMINAR
| Parámetro | Variable | Notas y ejemplo |
|---|---|---|
| Nombre | &AUT_O365_CONFIGURATION# |
Nombre de configuración existente — p. ej. MYTENANT_APPID |
4.3 · CARGAR ARCHIVOS DE SHAREPOINT
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.ACCION.SUBIR_ARCHIVOS_SHAREPOINT
Subprocesos internos:
- SHAREPOINT_OBTENER_TOKEN — adquiere el token de acceso de Microsoft Graph
- SHAREPOINT_OBTENER_SITIO — resuelve el sitio de SharePoint de destino
- SHAREPOINT_FILES_UPLOAD → SHAREPOINT_FILE_UPLOAD — ejecuta la carga por archivo
- SHAREPOINT_FILES_DELETE: se invoca cuando
Eliminar origen = truepara limpiar el origen después de la carga.
| Parámetro | Variable | Notas y ejemplo |
|---|---|---|
| Enlace del sitio | &AUT_O365_SITE_LINK# |
Referencia de sitio de SharePoint único. 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:/MiCarpeta/MiSubcarpeta). Ejemplo: root:/miCarpeta |
| 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 Eliminar origen = verdadero. Ejemplo: MIAGENTE |
| Inicio de sesión en el SO | &AUT_O365_LOGIN# |
Objeto de inicio de sesión utilizado para la eliminación de la fuente cuando Delete source = true. Ejemplo: LOGIN.MYLOGIN |
| Incluir Carpetas | &AUT_O365_RECURSIVO# |
Recorrer subdirectorios durante la carga. verdadero / falso |
| Eliminar fuente | &AUT_O365_DELETE_SOURCE# |
Eliminar archivos cargados de la ruta de origen después de una carga exitosa. verdadero / falso |
4.4 · DESCARGAR_ARCHIVOS_SHAREPOINT
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_OBTENER_TOKEN — adquiere el token de acceso de Microsoft Graph
- SHAREPOINT_OBTENER_SITIO — resuelve el sitio de SharePoint de destino
- SHAREPOINT_OBTENER_ID_ELEMENTO / SHAREPOINT_OBTENER_IDENTIFICADORES_ELEMENTOS — resuelve identificadores de elementos únicos o múltiples para la descarga
- ARCHIVOS_DE_SHAREPOINT_DESCARGAR → DESCARGA_ARCHIVO_SHAREPOINT — ejecuta la descarga por archivo
| Parámetro | Variable | Notas y ejemplo |
|---|---|---|
| Enlace del sitio | &AUT_O365_SITE_LINK# |
Referencia de sitio de SharePoint único. 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:/MiCarpeta/MiSubcarpeta) |
| Ruta local | &AUT_O365_LOCAL_PATH# |
Directorio local de destino para los archivos descargados. Ejemplo: C:\temp |
| Incluir Carpetas | &AUT_O365_RECURSIVO# |
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_OBTENER_TOKEN
- SHAREPOINT_OBTENER_SITIO
- SHAREPOINT_OBTENER_ID_ELEMENTO / SHAREPOINT_OBTENER_IDENTIFICADORES_ELEMENTOS
- ARCHIVOS_SHAREPOINT_BORRAR → SHAREPOINT_ARCHIVO_ELIMINAR
| Parámetro | Variable | Notas y ejemplo |
|---|---|---|
| Enlace del sitio | &AUT_O365_SITE_LINK# |
Referencia de sitio de SharePoint único. 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:/miCarpeta |
| Incluir Carpetas | &AUT_O365_RECURSIVO# |
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
- Copia de seguridad o exporta el inquilino relevante para conservar un punto de reversión.
- Pausa cualquier flujo de trabajo que haga referencia a las acciones de SharePoint de Action Pack.
- Ejecuta **Instalar desde archivo** con el nuevo archivo Action Pack y confirma la actualización
- Prueba de humo de una acción conocida de carga, descarga y eliminación contra un sitio de SharePoint de prueba
- Reanudar los flujos de trabajo pausados
Preguntas frecuentes
¿Qué hace la Oficina de Automatización 365 Action Pack?
La Oficina de Automatización de Office 365 Action Pack agrega carga, descarga y eliminación de SharePoint a flujos de trabajo de Automic Automation. Envuelve la autenticación de Microsoft Graph, el manejo de tokens de acceso y las llamadas REST en cinco acciones públicas, para que las operaciones de archivo en SharePoint puedan orquestarse directamente desde Automic sin construir una integración personalizada.
¿Qué versiones de Automic son compatibles?
The Automation Office 365 Action Pack is supported on Automic Automation V24 and later release lines. Earlier V21 systems are not covered by the current release; Tricise provides compatibility updates as new Automic major versions arrive.
¿Qué permisos de Microsoft Graph necesita?
La Oficina de Automatización 365 Action Pack requiere el permiso de 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í. La Oficina de Automatización 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?
La Oficina de Automatización 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 de Automation Office 365 Action Pack solo necesita un agente del sistema operativo e inicio de sesión cuando Eliminar origen = verdadero, 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 de Office 365 de Automatización 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 de la ventana 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, Automation Office 365 Action Pack puede procesar árboles de directorios completos en una única llamada de acción.
¿Cómo funciona la actualización a una nueva versión?
Las actualizaciones de Automation Office 365 Action Pack reutilizan el flujo estándar de Instalar desde archivo. Automic detecta una instalación existente, solicita confirmación y reemplaza Action Pack en el lugar 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?
La Oficina de Automatización 365 Action Packdepende de PCK.ITPA_SHARED, una utilidad compartida Action Pack . Si aún no está presente en el cliente de destino Automic , instálela desde la misma interfaz Administración → Packs antes de instalar la propia Action Pack de Office 365.
¿Cuánto cuesta la Oficina de Automatización 365 Action Pack?
La Automation Office 365 Action Pack tiene licencia como una compra única a 3.200 € (IVA no incluido) por sistema Automic. El precio se muestra en la página de la tienda Tricise e incluye el soporte de productos Tricise más las actualizaciones de compatibilidad para la línea de lanzamiento actual Automic V24+. No hay una tarifa de suscripción recurrente.
¿Dónde puedo comprar la automatización de Office 365 Action Pack?
La Automatización Office 365 Action Pack está disponible en la tienda 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.