Ambito tecnico e prerequisiti
L'Office 365 Automation Action Pack integra le operazioni sui file di Microsoft 365 SharePoint in flussi di lavoro 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 dall'inquilino in cui è installato il Action Pack
- Un agente del sistema operativo e un oggetto di login corrispondente — richiesto solo per l'azione di upload quando Elimina origine = vero e per l'azione di download quando è necessario creare sottodirectory locali
- Facoltativo: la dipendenza Action Pack PCK.ITPA_SHARED — installala 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 cliente — l'ID dell'applicazione (client) dell'app registrata
- **Segreto del client** — il valore segreto associato all'ID client
- **Autorizzazione API:** Sites.ReadWrite.All (autorizzazione applicazione, non delega), consenso amministratore concesso
- Raggiungibilità di rete dall'agente WebService REST a graph.microsoft.com e login.microsoftonline.com
Installazione, aggiornamento e disinstallazione
L'Office 365 Automation Action Pack viene installato tramite la normale interfaccia di Amministrazione → Packs Automic. Lo stesso flusso di lavoro copre l'installazione iniziale e gli aggiornamenti in-place. Tutte le operazioni devono essere eseguite in un client non zero Automic — 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 Pacchetti
- *Facoltativo:* se non è già installato, installare prima il dipendente Action Pack PCK.ITPA_SHARED
- Fai clic su **Installa da file**
- Seleziona il file Office 365 Action Pack di automazione e conferma con Installa
- Se una versione precedente è già installata, conferma l'aggiornamento facendo di nuovo clic su **Installa**
- Conferma l'installazione riuscita con Chiudi
Dopo l'installazione, Action Pack appare all'interno della cartella PACKAGES del client Automic.
Disinstalla
- Accedi al client Automic dove è installato Action Pack
- Passa alla vista Amministrazione
- Apri la voce di menu Pacchetti
- Seleziona Office 365 Automation Action Pack e fai clic su **Rimuovi**
- Conferma la disinstallazione facendo clic su Sì
- Conferma la rimozione avvenuta con successo con Chiudi
Configurazione — connessione a un tenant Azure
Prima che qualsiasi azione di SharePoint possa essere eseguita, 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 CONFIGURAZIONE_ADD
- Compila i campi richiesti (vedi tabella dei parametri qui sotto)
- Conferma cliccando 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 cliente | &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 sovvenzione | &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'ufficio di automazione 365 Action Pack espone cinque azioni pubbliche: due per la gestione delle connessioni e tre per le operazioni sui file di SharePoint. Tutte le azioni di SharePoint acquisiscono internamente un token di accesso tramite Microsoft Graph, risolvono il sito e la libreria di destinazione, ed eseguono quindi la chiamata REST tramite l'agente REST WebService. Le sottosezioni seguenti documentano ogni azione pubblica e i suoi 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.AZIONE.CONFIGURAZIONE_AGGIUNGI
- PCK.TRICISE_AUT_O365.PUB.ACTION.AGGIORNAMENTO_CONFIGURAZIONE
Parametri: vedere la tabella dei parametri di configurazione nella Sezione 3 sopra.
4.2 · CONFIGURATION_RIMUOVI
Rimuovere una configurazione di connessione esistente.
Nome oggetto: PCK.TRICISE_AUT_O365.PUB.ACTION.CONFIGURATION_RIMUOVI
| Parametro | Variabile | Note ed esempio |
|---|---|---|
| Nome | &AUT_O365_CONFIGURATION# |
Nome configurazione esistente — ad es. MYTENANT_APPID |
4.3 · UPLOAD_FILE_SHAREPOINT
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_OTTENI_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
Elimina sorgente = veroper 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 biblioteca | &AUT_O365_DRIVE_NAME# |
Libreria SharePoint di destinazione. La libreria predefinita in SharePoint è “Freigegebene Dokumente” / “Documenti condivisi”. 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. Qualificato 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 |
| Accesso a 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. `vero` / `falso` |
| 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.AZIONE.SHAREPOINT_FILE_SCARICA
Processi interni secondari:
- SHAREPOINT_OTTENI_TOKEN — acquisisce il token di accesso Microsoft Graph
- SHAREPOINT_GET_SITE — risolve il sito SharePoint di destinazione
- SHAREPOINT_OTTENERE_ID_ELEMENTO / SHAREPOINT_GET_ITEM_IDS — risolve ID di uno o più elementi per il download
- DOWNLOAD_FILE_SHAREPOINT → 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 biblioteca | &AUT_O365_DRIVE_NAME# |
Libreria SharePoint di origine. Predefinito: “Documenti condivisi”. Esempio: `Dokumente` |
| Modello di percorso file | &AUT_O365_FILE_PATTERN# |
Modello di selezione file. Qualificato 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 · ELIMINARE_FILE_SHAREPOINT
Eliminare uno o più file da una libreria SharePoint. Le file vengono rimosse tramite Microsoft Graph REST, che le sposta nel cestino di SharePoint anziché eliminarle definitivamente.
Nome oggetto: PCK.TRICISE_AUT_O365.PUB.AZIONE.SHAREPOINT_FILE_ELIMINA
Processi interni secondari:
- SHAREPOINT_OTTENI_TOKEN
- SHAREPOINT_GET_SITE
- SHAREPOINT_OTTENERE_ID_ELEMENTO / SHAREPOINT_GET_ITEM_IDS
- FILE_SHAREPOINT_CANCELLA → ELIMINA_FILE_SHAREPOINT
| 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 biblioteca | &AUT_O365_DRIVE_NAME# |
Libreria SharePoint di origine. Predefinito: “Documenti condivisi” |
| Modello di percorso file | &AUT_O365_FILE_PATTERN# |
Modello di selezione file. Qualificato 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 di Automation Office 365 Action Pack utilizza lo stesso flusso di lavoro **Installa da file** dell'installazione iniziale. Automic riconosce l'installazione esistente e richiede una conferma di aggiornamento; selezionando **Installa** viene sostituita la versione installata sul posto. Le configurazioni create tramite CONFIGURATION_ADD vengono preservate durante gli aggiornamenti.
Procedura di aggiornamento consigliata
- Esegui il backup o esporta l'istanza pertinente per mantenere un punto di ripristino.
- Metti in pausa tutti i workflow che fanno riferimento alle azioni di SharePoint di Action Pack
- Esegui Installa da file con il nuovo file Action Pack e conferma l'aggiornamento
- Eseguire uno smoke test di un'azione di caricamento, download ed eliminazione nota e funzionante su un sito di test di SharePoint
- Riabilita i flussi di lavoro in pausa
Domande frequenti
Cosa fa l'Office 365 Automation Action Pack?
L'Office 365 Automation Action Pack aggiunge upload, download ed eliminazione di SharePoint ai flussi di lavoro 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'Office 365 di automazione 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.
Quali autorizzazioni di Microsoft Graph ha bisogno?
L'ufficio di automazione di 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ò integrare più tenant Microsoft 365?
Sì. L'Office 365 Automation Action Pack supporta un numero illimitato di connessioni nominate 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 Action Pack e posso spostarlo?
L'Office 365 Automation Action Pack è installato nella cartella PACKAGES del client Automic tramite Administration → Packs → Install From File. Il Action Pack deve rimanere all'interno di quella cartella e non deve essere rinominato – fare una delle due cose interrompe i riferimenti interni. L'installazione nel client 0 non è supportata.
L'azione di caricamento richiede un agente del sistema operativo?
L'azione di caricamento di Automation Office 365 Action Pack necessita di un agente OS e di un login solo quando Elimina origine = 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 Action Pack in Automazione Office 365 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, il file di Automation Office 365 Action Pack può elaborare intere strutture di directory in un'unica chiamata di azione.
Come funziona l'aggiornamento a una nuova versione?
Gli aggiornamenti di Automation Office 365 Action Pack riutilizzano il flusso standard **Installa da file**. Automic rileva un'installazione esistente, chiede conferma e sostituisce Action Pack in loco all'interno della cartella PACKAGES. Le configurazioni di connessione denominate create tramite CONFIGURATION_ADD vengono preservate durante gli aggiornamenti.
Il Action Pack dipende da altri pacchetti Tricise?
L'Automazione Office 365 Action Packdipende da PCK.ITPA_SHARED, un'utilità condivisa Action Pack. Se non è già presente nel client di destinazione Automic, installarla dalla stessa interfaccia Amministrazione → Pacchetti prima di installare l'Automazione Action Pack Office 365 stessa.
Quanto costa Microsoft 365 per l'automazione Action Pack?
L'Office 365 Action Pack di automazione è 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 comprare l'Automazione Office 365 Action Pack?
L'Automation Office 365 Action Pack è disponibile tramite il Tricise shop su 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.