Ambito tecnico e prerequisiti
L'Automation Office 365 Action Pack integra le operazioni sui file di Microsoft 365 SharePoint nei workflow di Automic Automation. Fornisce un set di azioni pubbliche per caricare, scaricare ed eliminare file su SharePoint, oltre ad azioni di gestione delle connessioni per registrare le credenziali delle app Azure. Tutte le chiamate SharePoint si autenticano su Microsoft Graph utilizzando il flusso delle credenziali client e vengono eseguite tramite l'agente REST WebService di Automic.
Questa Guida completa copre l'ambito, l'installazione, la configurazione, il riferimento completo delle azioni e il percorso di aggiornamento. È il documento tecnico autorevole per gli amministratori Automic e i proprietari della piattaforma che distribuiscono la soluzione Automation Office 365 Action Pack in un ambiente di produzione Automic.
Piattaforme supportate
- Automic Automation: Linee di rilascio V24 e successive
- SharePoint: SharePoint Online (Microsoft 365) tramite Microsoft Graph API
- Autenticazione: Registrazione di un'app in Microsoft Entra ID (precedentemente Azure AD) con il flusso client-credentials
Prerequisiti sul lato Automic
- Un sistema Automic Automation in funzione con un tenant (client) accessibile diverso dal client 0 - l'Action Pack non può essere installato nel client 0
- Un agente WebService REST configurato, raggiungibile dal tenant in cui è installato l'Action Pack
- Un agente del sistema operativo e un oggetto di login corrispondente — richiesto solo per l'azione di upload quando Delete source = true e per l'azione di download quando è necessario creare sottodirectory locali
- Facoltativo: l'Action Pack dipendente PCK.ITPA_SHARED — installalo prima se non è già presente nel client di destinazione
Prerequisiti lato Microsoft 365
- Una registrazione di app Entra ID (Azure AD) con un segreto client generato
- ID tenant — l'identificatore univoco del tenant Microsoft 365 / Entra ID
- ID client — l'ID dell'applicazione (client) dell'app registrata
- Segreto client — il valore segreto associato all'ID client
- Autorizzazione API: Sites.ReadWrite.All (autorizzazione di tipo applicazione, non delegata), con consenso dell'amministratore concesso
- Raggiungibilità di rete dall'agente WebService REST a graph.microsoft.com e login.microsoftonline.com
Installazione, aggiornamento e disinstallazione
L'Automation Office 365 Action Pack viene installato tramite l'interfaccia standard Automic Administration → Packs. Lo stesso flusso di lavoro copre l'installazione iniziale e gli aggiornamenti in-place. Tutte le operazioni devono essere eseguite in un client Automic diverso da 0 — l'installazione nel client 0 non è supportata.
Installazione / aggiornamento
- Accedi al client Automic di destinazione (non al client 0)
- Passa alla vista Amministrazione
- Apri la voce di menu Packs
- Facoltativo: se non è già installato, installa prima l'Action Pack dipendente PCK.ITPA_SHARED
- Fai clic su Install From File
- Seleziona il file dell'Automation Office 365 Action Pack e conferma con Install
- Se una versione precedente è già installata, conferma l'aggiornamento facendo di nuovo clic su Install
- Conferma l'installazione riuscita con Chiudi
Dopo l'installazione, l'Action Pack appare all'interno della cartella PACKAGES del client Automic.
Disinstalla
- Accedi al client Automic in cui è installato l'Action Pack
- Passa alla vista Amministrazione
- Apri la voce di menu Packs
- Seleziona l'Automation Office 365 Action Pack e fai clic su Remove
- Conferma la disinstallazione facendo clic su Yes
- Conferma l'avvenuta rimozione con Close
Configurazione — connessione a un tenant Azure
Prima che qualsiasi azione di SharePoint possa essere eseguita, l'Automation Office 365 Action Pack necessita di almeno una configurazione di connessione denominata che punti a un tenant Entra ID / Azure. Le configurazioni vengono gestite tramite tre azioni dedicate: CONFIGURATION_ADD, CONFIGURATION_UPDATE e CONFIGURATION_REMOVE. Ogni azione di SharePoint fa riferimento a una configurazione per nome al momento dell'esecuzione.
Creazione di una nuova configurazione
- Avvia l'azione CONFIGURATION_ADD
- Compila i campi richiesti (vedi tabella dei parametri qui sotto)
- Conferma facendo clic su Invia
Parametri di configurazione
| Parametro | Variabile | Note ed esempio |
|---|---|---|
| Nome | &AUT_O365_CONFIGURATION# |
Nome della configurazione a forma libera. Sintassi raccomandata: TENANT_APPID — ad es. MYCOMPANY_MYAPP o AUTOMIC_0100 |
| ID tenant | &AUT_O365_TENANT_ID# |
L'ID tenant univoco dell'ambiente Azure / Entra ID a cui connettersi |
| ID client | &AUT_O365_CLIENT_ID# |
L'ID client univoco dell'app registrata |
| Segreto client | &AUT_O365_CLIENT_SECRET# |
Il valore del segreto del client associato all'ID client |
| Tipo di concessione | &AUT_O365_GRANT_TYPE# |
Tipo di concessione OAuth 2.0. Valore tipico: client_credentials |
| Ambito di applicazione | &AUT_O365_SCOPE# |
URL dello scope di Microsoft Graph. Valore tipico: https://graph.microsoft.com/.default |
Aggiornamento e rimozione di configurazioni
- Per creare configurazioni aggiuntive, riavvia CONFIGURATION_ADD con un nuovo nome
- Per modificare una configurazione esistente, esegui CONFIGURATION_UPDATE con il nome della configurazione esistente e i campi da modificare
- Per eliminare una configurazione, esegui CONFIGURATION_REMOVE con il nome della configurazione come unico parametro richiesto
Riferimento azioni
L'Automation Office 365 Action Pack mette a disposizione cinque azioni pubbliche: due per la gestione delle connessioni e tre per le operazioni sui file SharePoint. Tutte le azioni SharePoint ottengono internamente un token di accesso tramite Microsoft Graph, risolvono il sito e la libreria di destinazione ed eseguono poi la chiamata REST tramite l'agente WebService REST. I token di accesso vengono rinnovati automaticamente dopo 59 minuti, così i trasferimenti di lunga durata continuano a funzionare con un token valido. Le sottosezioni seguenti documentano ogni azione pubblica e i relativi parametri.
4.1 · CONFIGURATION_ADD / CONFIGURATION_UPDATE
Crea o aggiorna una configurazione di connessione denominata utilizzata per l'autenticazione con Microsoft Graph.
Nomi degli oggetti:
- PCK.TRICISE_AUT_O365.PUB.ACTION.CONFIGURATION_ADD
- PCK.TRICISE_AUT_O365.PUB.ACTION.CONFIGURATION_UPDATE
Parametri: vedere la tabella dei parametri di configurazione nella Sezione 3 sopra.
4.2 · CONFIGURATION_REMOVE
Rimuovere una configurazione di connessione esistente.
Nome oggetto: PCK.TRICISE_AUT_O365.PUB.ACTION.CONFIGURATION_REMOVE
| Parametro | Variabile | Note ed esempio |
|---|---|---|
| Nome | &AUT_O365_CONFIGURATION# |
Nome configurazione esistente — ad es. MYTENANT_APPID |
4.3 · SHAREPOINT_FILES_UPLOAD
Carica uno o più file locali in una libreria SharePoint tramite Microsoft Graph REST. La selezione dei file supporta caratteri jolly ed esplorazione ricorsiva opzionale delle sottodirectory; i file caricati possono eventualmente essere eliminati dal percorso di origine dopo un trasferimento eseguito correttamente.
Nome oggetto: PCK.TRICISE_AUT_O365.PUB.ACTION.SHAREPOINT_FILES_UPLOAD
Processi interni secondari:
- SHAREPOINT_GET_TOKEN — acquisisce il token di accesso Microsoft Graph
- SHAREPOINT_GET_SITE — risolve il sito SharePoint di destinazione
- SHAREPOINT_FILES_UPLOAD → SHAREPOINT_FILE_UPLOAD — esegue l'upload per file
- SHAREPOINT_FILES_DELETE — invocato quando
Delete source = trueper pulire la sorgente dopo il caricamento
| Parametro | Variabile | Note ed esempio |
|---|---|---|
| Link al sito | &AUT_O365_SITE_LINK# |
Riferimento univoco del sito SharePoint. Esempio: mydomain.sharepoint.com:/sites/mySite |
| Nome della libreria | &AUT_O365_DRIVE_NAME# |
Libreria SharePoint di destinazione. La libreria predefinita in SharePoint è “Freigegebene Dokumente” / “Shared Documents”. Esempio: Dokumente |
| Percorso di SharePoint | &AUT_O365_SHAREPOINT_PATH# |
Cartella di destinazione all'interno della libreria. O la radice (root) o una sottocartella (root:/MyFolder/MySubfolder). Esempio: root:/myFolder |
| Modello di percorso file | &AUT_O365_FILE_PATTERN# |
Modello di selezione file. Percorso completo o con caratteri jolly. Esempio: *.txt |
| Percorso locale | &AUT_O365_LOCAL_PATH# |
Directory sorgente locale contenente i file da caricare. Esempio: C:\temp |
| Agente OS | &AUT_O365_AGENT# |
Agente del sistema operativo utilizzato per l'eliminazione della sorgente quando Delete source = true. Esempio: MYAGENT |
| Login OS | &AUT_O365_LOGIN# |
Oggetto di login utilizzato per l'eliminazione di sorgenti quando Delete source = true. Esempio: LOGIN.MYLOGIN |
| Includi Cartelle | &AUT_O365_RECURSIVE# |
Attraversa le sottodirectory durante il caricamento. true / false |
| Cancella sorgente | &AUT_O365_DELETE_SOURCE# |
Elimina i file caricati dal percorso di origine dopo un caricamento riuscito. true / false |
4.4 · SHAREPOINT_FILES_DOWNLOAD
Scaricare uno o più file da una libreria SharePoint in una directory locale di destinazione tramite Microsoft Graph REST. Supporta la selezione con caratteri jolly e l'attraversamento ricorsivo opzionale delle sottocartelle.
Nome oggetto: PCK.TRICISE_AUT_O365.PUB.ACTION.SHAREPOINT_FILES_DOWNLOAD
Processi interni secondari:
- SHAREPOINT_GET_TOKEN — acquisisce il token di accesso Microsoft Graph
- SHAREPOINT_GET_SITE — risolve il sito SharePoint di destinazione
- SHAREPOINT_GET_ITEM_ID / SHAREPOINT_GET_ITEM_IDS — risolve ID di uno o più elementi per il download
- SHAREPOINT_FILES_DOWNLOAD → SHAREPOINT_FILE_DOWNLOAD — esegue il download per file
| Parametro | Variabile | Note ed esempio |
|---|---|---|
| Link al sito | &AUT_O365_SITE_LINK# |
Riferimento univoco del sito SharePoint. Esempio: mydomain.sharepoint.com:/sites/mySite |
| Nome della libreria | &AUT_O365_DRIVE_NAME# |
Libreria SharePoint di origine. Predefinita: “Shared Documents”. Esempio: Dokumente |
| Modello di percorso file | &AUT_O365_FILE_PATTERN# |
Modello di selezione file. Percorso completo o con caratteri jolly. Esempio: *.txt |
| Percorso di SharePoint | &AUT_O365_SHAREPOINT_PATH# |
Cartella sorgente all'interno della libreria. Root (root) o sottocartella (root:/MyFolder/MySubfolder) |
| Percorso locale | &AUT_O365_LOCAL_PATH# |
Directory di destinazione locale per i file scaricati. Esempio: C:\temp |
| Includi Cartelle | &AUT_O365_RECURSIVE# |
Attraversa le sottocartelle di SharePoint durante il download. true / false |
4.5 · SHAREPOINT_FILES_DELETE
Eliminare uno o più file da una libreria SharePoint. I file vengono rimossi tramite Microsoft Graph REST, che li sposta nel cestino di SharePoint anziché eliminarli definitivamente.
Nome oggetto: PCK.TRICISE_AUT_O365.PUB.ACTION.SHAREPOINT_FILES_DELETE
Processi interni secondari:
- SHAREPOINT_GET_TOKEN
- SHAREPOINT_GET_SITE
- SHAREPOINT_GET_ITEM_ID / SHAREPOINT_GET_ITEM_IDS
- SHAREPOINT_FILES_DELETE → SHAREPOINT_FILE_DELETE
| Parametro | Variabile | Note ed esempio |
|---|---|---|
| Link al sito | &AUT_O365_SITE_LINK# |
Riferimento univoco del sito SharePoint. Esempio: mydomain.sharepoint.com:/sites/mySite |
| Nome della libreria | &AUT_O365_DRIVE_NAME# |
Libreria SharePoint di origine. Predefinita: “Shared Documents” |
| Modello di percorso file | &AUT_O365_FILE_PATTERN# |
Modello di selezione file. Percorso completo o con caratteri jolly. Esempio: *.txt |
| Percorso di SharePoint | &AUT_O365_SHAREPOINT_PATH# |
Cartella sorgente all'interno della libreria. Cartella radice o sottocartella. Esempio: root:/myFolder |
| Includi Cartelle | &AUT_O365_RECURSIVE# |
Attraversa le sottocartelle di SharePoint durante l'eliminazione. true / false |
Aggiornamento e migrazione
L'aggiornamento dell'Automation Office 365 Action Pack utilizza la stessa procedura Installa da file dell'installazione iniziale. Automic riconosce l'installazione esistente e chiede di confermare l'aggiornamento; selezionando Installa la versione installata viene sostituita direttamente. Le configurazioni create tramite CONFIGURATION_ADD vengono preservate durante gli aggiornamenti.
Procedura di aggiornamento consigliata
- Esegui il backup o esporta il tenant interessato per disporre di un punto di ripristino
- Metti in pausa tutti i workflow che fanno riferimento alle azioni di SharePoint dell'Action Pack
- Esegui Installa da file con il nuovo file Action Pack e conferma l'aggiornamento
- Esegui uno smoke test con azioni di upload, download ed eliminazione già verificate su un sito SharePoint di test
- Riabilita i flussi di lavoro in pausa
Note di rilascio
Tutte le versioni dell'Automation Office 365 Action Pack e le modifiche introdotte in ciascuna.
v2.1.2 (attuale) · 2026-07-08
| Versione | Tipo | Modifica |
|---|---|---|
| 2.1.2 2026-07-08 | Modificato | Predisposizione per le sessioni di upload (CREATEUPLOADSESSION); non ancora attiva |
Versioni precedenti
Versioni 1.0.0 – 2.1.1
| Versione | Tipo | Modifica |
|---|---|---|
| 2.1.1 2026-05-11 | Corretto | Upload con Delete source: percorsi e nomi di file con spazi vengono racchiusi tra virgolette (include PCK.TRICISE_AUT_O365.PRV.INCLUDE.SHAREPOINT_FILE_UPLOAD_DELETE_SOURCE) |
| 2.1.0 2025-11-14 | Modificato | SHAREPOINT_FILES_DOWNLOAD, SHAREPOINT_FILES_DELETE e SHAREPOINT_FILES_UPLOAD: libreria SharePoint selezionabile |
| 2.0.2 2025-05-15 | Corretto | PCK.TRICISE_AUT_O365.PRV.JOB.SHAREPOINT_FILE_DOWNLOAD: valore di output racchiuso tra virgolette, così è possibile scaricare anche file con spazi nel nome |
| 2.0.1 2025-04-03 | Corretto | PCK.TRICISE_AUT_O365.PRV.JOB.SHAREPOINT_GET_DOWNLOAD_URL: &ITERATION_ITEM# viene pubblicata su TOP anziché su WORKFLOW |
| 2.0.0 2025-02-11 | Nuovo | Azioni CONFIGURATION_ADD, CONFIGURATION_REMOVE e CONFIGURATION_UPDATE |
| Modificato | Download, eliminazione e upload leggono le credenziali dall'oggetto Variable della configurazione | |
| 1.5.0 2025-01-17 | Modificato | SHAREPOINT_GET_TOKEN verifica se il token deve essere rinnovato dopo 59 minuti |
| Modificato | Download, eliminazione e upload rinnovano il token dopo 59 minuti | |
| 1.4.0 2024-12-03 | Modificato | Download, eliminazione e upload ricorsivi |
| 1.3.3 2024-11-28 | Corretto | Miglioramenti delle prestazioni grazie a output di risposta più ridotti e a un filtraggio più efficiente |
| 1.3.2 2024-09-03 | Corretto | Report di richiesta e risposta dei job REST disattivati, perché riempivano il file system |
| 1.2.1 2024-06-26 | Corretto | Upload: &AUT_O365_LOCAL_PATH# e &AUT_O365_FILENAME_UPLOAD# vengono impostate nel PromptSet |
| 1.2.0 2024-06-20 | Nuovo | Azioni SHAREPOINT_FILES_DELETE e SHAREPOINT_FILES_DOWNLOAD |
| Nuovo | Azioni interne SHAREPOINT_FILE_DELETE, SHAREPOINT_GET_ITEM_ID e SHAREPOINT_GET_ITEM_CHILDS | |
| 1.0.3 2024-04-17 | Corretto | CONN_ENDPOINT_URL troppo lungo: suddiviso in URL e risorsa |
| 1.0.2 2024-03-20 | Modificato | SHAREPOINT_FILES_UPLOAD: nuova opzione Delete source (true / false) |
| 1.0.1 2024-03-19 | Nuovo | Azione SHAREPOINT_FILES_UPLOAD |
| 1.0.0 2024-03-19 | Nuovo | Versione iniziale |
Domande frequenti
Cosa fa l'Automation Office 365 Action Pack?
L'Automation Office 365 Action Pack aggiunge upload, download ed eliminazione di SharePoint ai workflow di Automic Automation. Incapsula l'autenticazione Microsoft Graph, la gestione dei token di accesso e le chiamate REST in cinque azioni pubbliche, in modo che le operazioni sui file su SharePoint possano essere orchestrate direttamente da Automic senza creare un'integrazione personalizzata.
Quali versioni di Automic sono supportate?
L'Automation Office 365 Action Pack è supportato su Automic Automation V24 e versioni successive. I sistemi V21 precedenti non sono coperti dalla versione corrente; Tricise fornisce aggiornamenti di compatibilità quando arrivano nuove versioni principali di Automic.
Di quali autorizzazioni di Microsoft Graph ha bisogno?
L'Automation Office 365 Action Pack richiede l'autorizzazione Sites.ReadWrite.All di tipo applicazione (non delegata) sull'app registrata in Entra ID, con consenso dell'amministratore concesso. Il flusso OAuth 2.0 client-credentials viene utilizzato per ottenere token di accesso tramite login.microsoftonline.com e quindi chiama Microsoft Graph all'indirizzo graph.microsoft.com.
L'Action Pack può operare su più tenant Microsoft 365?
Sì. L'Automation Office 365 Action Pack supporta un numero illimitato di connessioni denominate per client Automic. Ogni connessione memorizza il proprio Tenant ID, Client ID, Client Secret, grant type e scope. Ogni azione di SharePoint fa riferimento a una configurazione tramite il parametro &AUT_O365_CONFIGURATION#, che semplifica le configurazioni multi-tenant e lo scambio di file cross-tenant.
Dov'è installato l'Action Pack e posso spostarlo?
L'Automation Office 365 Action Pack è installato nella cartella PACKAGES del client Automic tramite Administration → Packs → Install From File. L'Action Pack deve rimanere all'interno di quella cartella e non deve essere rinominato: in entrambi i casi si interrompono i riferimenti interni. L'installazione nel client 0 non è supportata.
L'azione di caricamento richiede un agente del sistema operativo?
L'azione di caricamento dell'Automation Office 365 Action Pack necessita di un agente OS e di un login solo quando Delete source = true, poiché l'eliminazione dell'origine viene eseguita sul file system in cui si trovano i file caricati. Per caricamenti puri senza eliminazione dell'origine, l'agente WebService REST è sufficiente. L'azione di download utilizza l'agente OS solo quando è necessario creare sottodirectory locali per un download ricorsivo.
Cosa succede quando un'azione di cancellazione viene eseguita in SharePoint?
L'azione di eliminazione dell'Automation Office 365 Action Pack non elimina definitivamente i file. Gli elementi corrispondenti vengono spostati nel cestino di SharePoint tramite Microsoft Graph, il che significa che possono essere ripristinati dal cestino entro la finestra di conservazione di SharePoint se un'eliminazione si rivela errata.
I pattern di percorso dei file possono usare caratteri jolly?
Sì. Il parametro &AUT_O365_FILE_PATTERN# accetta sia nomi di file completi che modelli con caratteri jolly come *.txt o report_*.csv. Combinato con il flag Includi cartelle, l'Automation Office 365 Action Pack può elaborare intere strutture di directory in un'unica chiamata di azione.
Sono supportati nomi di file e cartelle contenenti spazi?
Sì. Percorsi e nomi di file con spazi vengono racchiusi correttamente tra virgolette: per i download dalla versione 2.0.2 e per gli upload con Delete source dalla versione 2.1.1.
Come funziona l'aggiornamento a una nuova versione?
Gli aggiornamenti dell'Automation Office 365 Action Pack riutilizzano la procedura standard Install From File. Automic rileva un'installazione esistente, chiede conferma e sostituisce l'Action Pack direttamente all'interno della cartella PACKAGES. Le configurazioni di connessione denominate create tramite CONFIGURATION_ADD vengono mantenute durante gli aggiornamenti.
L'Action Pack dipende da altri pack Tricise?
L'Automation Office 365 Action Pack dipende da PCK.ITPA_SHARED, un Action Pack di utilità condiviso. Se non è già presente nel client Automic di destinazione, installalo dalla stessa interfaccia Administration → Packs prima di installare l'Office 365 Action Pack vero e proprio.
Quanto costa l'Automation Office 365 Action Pack?
L'Automation Office 365 Action Pack è concesso in licenza come acquisto una tantum a 3.200 € (IVA esclusa) per sistema Automic. Il prezzo è indicato sulla pagina del negozio Tricise e include il supporto prodotto Tricise oltre agli aggiornamenti di compatibilità per la linea di rilascio corrente Automic V24+. Non è prevista alcuna tariffa di abbonamento ricorrente.
Dove posso acquistare l'Automation Office 365 Action Pack?
L'Automation Office 365 Action Pack è disponibile nello shop Tricise all'indirizzo tricise.com/shop/automation-office-365. Per domande relative a licenze, ambito multi-sistema, onboarding o walkthrough dal vivo, contatta Tricise tramite il modulo di consultazione.