Technischer Umfang und Voraussetzungen
Das Automation Office 365 Action Pack integriert SharePoint-Dateioperationen aus Microsoft 365 in Automic-Automation-Workflows. Es liefert eine Reihe öffentlicher Aktionen zum Hochladen, Herunterladen und Löschen von Dateien auf SharePoint sowie Aktionen zur Verbindungsverwaltung, um Azure-App-Zugangsdaten zu registrieren. Alle SharePoint-Aufrufe authentifizieren sich über den Client-Credentials-Flow gegenüber Microsoft Graph und laufen über den WebService-REST-Agenten von Automic.
Dieser Full Guide behandelt Umfang, Installation, Konfiguration, die vollständige Aktions-Referenz sowie den Upgrade-Pfad. Es ist das maßgebliche technische Dokument für Automic-Administratoren und Plattform-Verantwortliche, die das Automation Office 365 Action Pack in eine produktive Automic-Umgebung ausrollen.
Unterstützte Plattformen
- Automic Automation: V24 und spätere Release-Linien
- SharePoint: SharePoint Online (Microsoft 365) über die Microsoft Graph API
- Authentifizierung: App-Registrierung in Microsoft Entra ID (ehemals Azure AD) mit dem Client-Credentials-Flow
Voraussetzungen auf der Automic-Seite
- Ein laufendes Automic-Automation-System mit einem erreichbaren Mandanten außer Mandant 0 — das Action Pack kann nicht in Mandant 0 installiert werden
- Ein konfigurierter WebService REST-Agent, der vom Mandanten, in dem das Action Pack installiert ist, erreichbar ist
- Ein OS-Agent und ein passendes Login-Objekt — nur erforderlich für die Upload-Aktion bei Delete source = true sowie für die Download-Aktion, wenn lokale Unterverzeichnisse angelegt werden müssen
- Optional: das abhängige Action Pack PCK.ITPA_SHARED — zuerst installieren, falls es im Zielmandanten noch nicht vorhanden ist
Voraussetzungen auf der Microsoft-365-Seite
- Eine App-Registrierung in Entra ID (Azure AD) mit einem generierten Client-Secret
- Tenant-ID — der eindeutige Bezeichner des Microsoft-365- / Entra-ID-Tenants
- Client-ID — die Anwendungs-ID (Client) der registrierten App
- Client-Secret — der geheime Wert, der zur Client-ID gehört
- API-Berechtigung: Sites.ReadWrite.All (Anwendungsberechtigung, nicht delegiert), mit erteilter Administratorzustimmung
- Netzwerk-Erreichbarkeit vom WebService-REST-Agenten zu graph.microsoft.com und login.microsoftonline.com
Installation, Update & Deinstallation
Das Automation Office 365 Action Pack wird über die Standardoberfläche Automic Administration → Packs installiert. Derselbe Ablauf deckt sowohl die Neuinstallation als auch In-Place-Updates ab. Alle Operationen müssen in einem Automic-Mandanten ungleich 0 durchgeführt werden — die Installation in Mandant 0 wird nicht unterstützt.
Installation / Aktualisierung
- Am Automic-Zielmandanten anmelden (nicht an Mandant 0)
- Zur Perspektive Administration wechseln
- Den Menüeintrag Packs öffnen
- Optional: Falls noch nicht installiert, zuerst das abhängige Action Pack PCK.ITPA_SHARED installieren
- Auf Install From File klicken
- Die Datei des Automation Office 365 Action Pack auswählen und mit Install bestätigen
- Falls bereits eine frühere Version installiert ist, das Update durch erneutes Klicken auf Install bestätigen
- Die erfolgreiche Installation mit Close bestätigen
Nach der Installation erscheint das Action Pack im Ordner PACKAGES des Automic-Mandanten.
Deinstallieren
- Am Automic-Mandanten anmelden, in dem das Action Pack installiert ist
- Zur Perspektive Administration wechseln
- Den Menüeintrag Packs öffnen
- Das Automation Office 365 Action Pack auswählen und auf Remove klicken
- Die Deinstallation durch Klicken auf Yes bestätigen
- Die erfolgreiche Entfernung mit Close bestätigen
Konfiguration – Verbindung zu einem Azure-Tenant
Bevor eine SharePoint-Aktion ausgeführt werden kann, benötigt das Automation Office 365 Action Pack mindestens eine benannte Verbindungskonfiguration, die auf einen Entra-ID- / Azure-Tenant verweist. Konfigurationen werden über drei dedizierte Aktionen verwaltet: CONFIGURATION_ADD, CONFIGURATION_UPDATE und CONFIGURATION_REMOVE. Jede SharePoint-Aktion referenziert zur Laufzeit eine Konfiguration über deren Namen.
Neue Konfiguration erstellen
- Die Aktion CONFIGURATION_ADD starten
- Die erforderlichen Felder ausfüllen (siehe Parametertabelle unten)
- Mit Klick auf Submit bestätigen
Konfigurationsparameter
| Parameter | Variable | Hinweise & Beispiel |
|---|---|---|
| Name | &AUT_O365_CONFIGURATION# |
Frei wählbarer Konfigurationsname. Empfohlene Syntax: TENANT_APPID — z. B. MYCOMPANY_MYAPP oder AUTOMIC_0100 |
| Tenant ID | &AUT_O365_TENANT_ID# |
Die eindeutige Tenant-ID der Azure- / Entra-ID-Umgebung, mit der verbunden werden soll |
| Client-ID | &AUT_O365_CLIENT_ID# |
Die eindeutige Client-ID der registrierten Anwendung |
| Client Secret | &AUT_O365_CLIENT_SECRET# |
Der Client-Secret-Wert, der zur Client-ID gehört |
| Grant Type | &AUT_O365_GRANT_TYPE# |
OAuth-2.0-Grant-Type. Üblicher Wert: client_credentials |
| Scope | &AUT_O365_SCOPE# |
Microsoft-Graph-Scope-URL. Üblicher Wert: https://graph.microsoft.com/.default |
Aktualisieren und Entfernen von Konfigurationen
- Um weitere Konfigurationen anzulegen, CONFIGURATION_ADD erneut mit einem neuen Namen starten
- Um eine bestehende Konfiguration zu ändern, CONFIGURATION_UPDATE mit dem bestehenden Konfigurationsnamen und den zu ändernden Feldern ausführen
- Um eine Konfiguration zu löschen, CONFIGURATION_REMOVE mit dem Konfigurationsnamen als einzigem erforderlichen Parameter ausführen
Aktionsreferenz
Das Automation Office 365 Action Pack stellt fünf öffentliche Aktionen bereit: zwei für die Verbindungsverwaltung und drei für SharePoint-Dateioperationen. Alle SharePoint-Aktionen beziehen intern über Microsoft Graph ein Zugriffstoken, ermitteln die Ziel-Site und die Bibliothek und führen anschließend den REST-Aufruf über den WebService-REST-Agenten aus. Zugriffstoken werden nach 59 Minuten automatisch erneuert, sodass auch lang laufende Übertragungen mit einem gültigen Token weiterarbeiten. Die folgenden Unterabschnitte beschreiben jede öffentliche Aktion und ihre Parameter.
4.1 · CONFIGURATION_ADD / CONFIGURATION_UPDATE
Eine benannte Verbindungskonfiguration anlegen oder aktualisieren, die zur Authentifizierung gegenüber Microsoft Graph verwendet wird.
Objektnamen:
- PCK.TRICISE_AUT_O365.PUB.ACTION.CONFIGURATION_ADD
- PCK.TRICISE_AUT_O365.PUB.ACTION.CONFIGURATION_UPDATE
Parameter: siehe die Parametertabelle für die Konfiguration in Abschnitt 3 oben.
4.2 · CONFIGURATION_REMOVE
Eine bestehende Verbindungskonfiguration entfernen.
Objektname: PCK.TRICISE_AUT_O365.PUB.ACTION.CONFIGURATION_REMOVE
| Parameter | Variable | Hinweise & Beispiel |
|---|---|---|
| Name | &AUT_O365_CONFIGURATION# |
Name einer bestehenden Konfiguration — z. B. MYTENANT_APPID |
4.3 · SHAREPOINT_FILES_UPLOAD
Eine oder mehrere lokale Dateien über Microsoft Graph REST in eine SharePoint-Bibliothek hochladen. Die Dateiauswahl unterstützt Wildcards und optional den rekursiven Durchlauf von Unterverzeichnissen; hochgeladene Dateien können nach erfolgreicher Übertragung optional aus dem Quellpfad gelöscht werden.
Objektname: PCK.TRICISE_AUT_O365.PUB.ACTION.SHAREPOINT_FILES_UPLOAD
Interne Teilprozesse:
- SHAREPOINT_GET_TOKEN — holt das Microsoft-Graph-Access-Token
- SHAREPOINT_GET_SITE — ermittelt die Ziel-Site in SharePoint
- SHAREPOINT_FILES_UPLOAD → SHAREPOINT_FILE_UPLOAD — führt den Upload pro Datei aus
- SHAREPOINT_FILES_DELETE — wird bei
Delete source = trueaufgerufen, um die Quelle nach dem Upload zu bereinigen
| Parameter | Variable | Hinweise & Beispiel |
|---|---|---|
| Site-Link | &AUT_O365_SITE_LINK# |
Eindeutige SharePoint-Site-Referenz. Beispiel: mydomain.sharepoint.com:/sites/mySite |
| Bibliotheksname | &AUT_O365_DRIVE_NAME# |
Ziel-SharePoint-Bibliothek. Die Standardbibliothek in SharePoint heißt „Freigegebene Dokumente“ / „Shared Documents“. Beispiel: Dokumente |
| SharePoint-Pfad | &AUT_O365_SHAREPOINT_PATH# |
Zielordner innerhalb der Bibliothek. Entweder das Stammverzeichnis (root) oder ein Unterordner (root:/MyFolder/MySubfolder). Beispiel: root:/myFolder |
| Dateipfad-Muster | &AUT_O365_FILE_PATTERN# |
Muster für die Dateiauswahl. Voll qualifiziert oder mit Wildcard. Beispiel: *.txt |
| Lokaler Pfad | &AUT_O365_LOCAL_PATH# |
Lokales Quellverzeichnis mit den hochzuladenden Dateien. Beispiel: C:\temp |
| OS-Agent | &AUT_O365_AGENT# |
Betriebssystem-Agent, der bei Delete source = true für das Löschen der Quelle verwendet wird. Beispiel: MYAGENT |
| OS-Login | &AUT_O365_LOGIN# |
Login-Objekt, das bei Delete source = true für das Löschen der Quelle verwendet wird. Beispiel: LOGIN.MYLOGIN |
| Include Folders | &AUT_O365_RECURSIVE# |
Unterverzeichnisse beim Upload mit durchlaufen. true / false |
| Delete source | &AUT_O365_DELETE_SOURCE# |
Hochgeladene Dateien nach erfolgreichem Upload aus dem Quellpfad löschen. true / false |
4.4 · SHAREPOINT_FILES_DOWNLOAD
Eine oder mehrere Dateien aus einer SharePoint-Bibliothek über Microsoft Graph REST in ein lokales Zielverzeichnis herunterladen. Die Aktion unterstützt die Auswahl per Wildcard und optional den rekursiven Durchlauf von Unterordnern.
Objektname: PCK.TRICISE_AUT_O365.PUB.ACTION.SHAREPOINT_FILES_DOWNLOAD
Interne Teilprozesse:
- SHAREPOINT_GET_TOKEN — holt das Microsoft-Graph-Access-Token
- SHAREPOINT_GET_SITE — ermittelt die Ziel-Site in SharePoint
- SHAREPOINT_GET_ITEM_ID / SHAREPOINT_GET_ITEM_IDS — ermittelt einzelne oder mehrere Element-IDs für den Download
- SHAREPOINT_FILES_DOWNLOAD → SHAREPOINT_FILE_DOWNLOAD — führt den Download pro Datei aus
| Parameter | Variable | Hinweise & Beispiel |
|---|---|---|
| Site-Link | &AUT_O365_SITE_LINK# |
Eindeutige SharePoint-Site-Referenz. Beispiel: mydomain.sharepoint.com:/sites/mySite |
| Bibliotheksname | &AUT_O365_DRIVE_NAME# |
Quell-SharePoint-Bibliothek. Standard: „Shared Documents“. Beispiel: Dokumente |
| Dateipfad-Muster | &AUT_O365_FILE_PATTERN# |
Muster für die Dateiauswahl. Voll qualifiziert oder mit Wildcard. Beispiel: *.txt |
| SharePoint-Pfad | &AUT_O365_SHAREPOINT_PATH# |
Quellordner innerhalb der Bibliothek. Stammverzeichnis (root) oder Unterordner (root:/MyFolder/MySubfolder) |
| Lokaler Pfad | &AUT_O365_LOCAL_PATH# |
Lokales Zielverzeichnis für die heruntergeladenen Dateien. Beispiel: C:\temp |
| Include Folders | &AUT_O365_RECURSIVE# |
SharePoint-Unterordner beim Download mit durchlaufen. true / false |
4.5 · SHAREPOINT_FILES_DELETE
Eine oder mehrere Dateien aus einer SharePoint-Bibliothek löschen. Die Dateien werden über Microsoft Graph REST entfernt, wodurch sie in den SharePoint-Papierkorb verschoben und nicht dauerhaft gelöscht werden.
Objektname: PCK.TRICISE_AUT_O365.PUB.ACTION.SHAREPOINT_FILES_DELETE
Interne Teilprozesse:
- SHAREPOINT_GET_TOKEN
- SHAREPOINT_GET_SITE
- SHAREPOINT_GET_ITEM_ID / SHAREPOINT_GET_ITEM_IDS
- SHAREPOINT_FILES_DELETE → SHAREPOINT_FILE_DELETE
| Parameter | Variable | Hinweise & Beispiel |
|---|---|---|
| Site-Link | &AUT_O365_SITE_LINK# |
Eindeutige SharePoint-Site-Referenz. Beispiel: mydomain.sharepoint.com:/sites/mySite |
| Bibliotheksname | &AUT_O365_DRIVE_NAME# |
Quell-SharePoint-Bibliothek. Standard: „Shared Documents“ |
| Dateipfad-Muster | &AUT_O365_FILE_PATTERN# |
Muster für die Dateiauswahl. Voll qualifiziert oder mit Wildcard. Beispiel: *.txt |
| SharePoint-Pfad | &AUT_O365_SHAREPOINT_PATH# |
Quellordner innerhalb der Bibliothek. Stammverzeichnis oder Unterordner. Beispiel: root:/myFolder |
| Include Folders | &AUT_O365_RECURSIVE# |
SharePoint-Unterordner beim Löschen mit durchlaufen. true / false |
Upgrade & Migration
Das Upgrade des Automation Office 365 Action Pack läuft wie die Erstinstallation über Install From File. Automic erkennt die bestehende Installation und fordert zur Bestätigung des Updates auf; ein Klick auf Install ersetzt die installierte Version direkt. Die über CONFIGURATION_ADD angelegten Konfigurationen bleiben beim Upgrade erhalten.
Empfohlenes Vorgehen beim Upgrade
- Den betreffenden Mandanten sichern oder exportieren, um einen Wiederherstellungspunkt zu schaffen
- Alle Workflows pausieren, die auf die SharePoint-Aktionen des Action Pack verweisen
- Install From File mit der neuen Action-Pack-Datei ausführen und das Update bestätigen
- Einen Smoke-Test mit bekannt funktionierenden Upload-, Download- und Lösch-Aktionen gegen eine Test-SharePoint-Site ausführen
- Die pausierten Workflows wieder aktivieren
Versionshinweise
Alle Versionen des Automation Office 365 Action Pack und was sich jeweils geändert hat.
v2.1.2 (aktuell) · 2026-07-08
| Version | Typ | Änderung |
|---|---|---|
| 2.1.2 2026-07-08 | Geändert | Vorbereitung für Upload-Sitzungen (CREATEUPLOADSESSION); noch nicht aktiv |
Frühere Versionen
Versionen 1.0.0 – 2.1.1
| Version | Typ | Änderung |
|---|---|---|
| 2.1.1 2026-05-11 | Behoben | Upload mit Delete source: Pfade und Dateinamen mit Leerzeichen werden in Anführungszeichen gesetzt (Include PCK.TRICISE_AUT_O365.PRV.INCLUDE.SHAREPOINT_FILE_UPLOAD_DELETE_SOURCE) |
| 2.1.0 2025-11-14 | Geändert | SHAREPOINT_FILES_DOWNLOAD, SHAREPOINT_FILES_DELETE und SHAREPOINT_FILES_UPLOAD: SharePoint-Bibliothek auswählbar |
| 2.0.2 2025-05-15 | Behoben | PCK.TRICISE_AUT_O365.PRV.JOB.SHAREPOINT_FILE_DOWNLOAD: Ausgabewert in Anführungszeichen, sodass sich auch Dateien mit Leerzeichen herunterladen lassen |
| 2.0.1 2025-04-03 | Behoben | PCK.TRICISE_AUT_O365.PRV.JOB.SHAREPOINT_GET_DOWNLOAD_URL: &ITERATION_ITEM# wird an TOP statt an WORKFLOW veröffentlicht |
| 2.0.0 2025-02-11 | Neu | Aktionen CONFIGURATION_ADD, CONFIGURATION_REMOVE und CONFIGURATION_UPDATE |
| Geändert | Die Aktionen für Download, Löschen und Upload lesen ihre Zugangsdaten aus dem Variablenobjekt der Konfiguration | |
| 1.5.0 2025-01-17 | Geändert | SHAREPOINT_GET_TOKEN prüft, ob das Token nach 59 Minuten erneuert werden muss |
| Geändert | Die Aktionen für Download, Löschen und Upload erneuern das Token nach 59 Minuten | |
| 1.4.0 2024-12-03 | Geändert | Rekursives Herunterladen, Löschen und Hochladen |
| 1.3.3 2024-11-28 | Behoben | Bessere Performance durch kleinere Antwortausgaben und intelligentere Filterung |
| 1.3.2 2024-09-03 | Behoben | Request- und Response-Reports der REST-Jobs deaktiviert, da sie das Dateisystem volllaufen ließen |
| 1.2.1 2024-06-26 | Behoben | Upload: &AUT_O365_LOCAL_PATH# und &AUT_O365_FILENAME_UPLOAD# werden im PromptSet gesetzt |
| 1.2.0 2024-06-20 | Neu | Aktionen SHAREPOINT_FILES_DELETE und SHAREPOINT_FILES_DOWNLOAD |
| Neu | Interne Aktionen SHAREPOINT_FILE_DELETE, SHAREPOINT_GET_ITEM_ID und SHAREPOINT_GET_ITEM_CHILDS | |
| 1.0.3 2024-04-17 | Behoben | CONN_ENDPOINT_URL zu lang: in URL und Ressource aufgeteilt |
| 1.0.2 2024-03-20 | Geändert | SHAREPOINT_FILES_UPLOAD: neue Option Delete source (true / false) |
| 1.0.1 2024-03-19 | Neu | Aktion SHAREPOINT_FILES_UPLOAD |
| 1.0.0 2024-03-19 | Neu | Erste Version |
Häufig gestellte Fragen
Was macht das Automation Office 365 Action Pack?
Das Automation Office 365 Action Pack erweitert Automic-Automation-Workflows um SharePoint-Upload, -Download und -Löschen. Es kapselt die Microsoft-Graph-Authentifizierung, das Handling der Access-Token und die REST-Aufrufe in fünf öffentlichen Aktionen, sodass Dateioperationen auf SharePoint direkt aus Automic heraus orchestriert werden können — ohne eine eigene Integration entwickeln zu müssen.
Welche Automic-Versionen werden unterstützt?
Das Automation Office 365 Action Pack wird auf Automic Automation V24 und den nachfolgenden Release-Linien unterstützt. Ältere V21-Systeme sind vom aktuellen Release nicht abgedeckt; Tricise stellt Kompatibilitäts-Updates bereit, sobald neue Automic-Hauptversionen erscheinen.
Welche Microsoft-Graph-Berechtigungen werden benötigt?
Das Automation Office 365 Action Pack benötigt die Berechtigung Sites.ReadWrite.All als Anwendungsberechtigung (nicht delegiert) für die registrierte Entra-ID-App, mit erteilter Administratorzustimmung. Der OAuth-2.0-Client-Credentials-Flow wird verwendet, um Access-Token über login.microsoftonline.com abzurufen; anschließend erfolgen die Aufrufe gegen Microsoft Graph unter graph.microsoft.com.
Kann das Action Pack mehrere Microsoft-365-Tenants ansprechen?
Ja. Das Automation Office 365 Action Pack unterstützt eine unbegrenzte Anzahl benannter Verbindungen pro Automic-Mandant. Jede Verbindung speichert eigene Werte für Tenant-ID, Client-ID, Client-Secret, Grant Type und Scope. Jede SharePoint-Aktion referenziert eine Konfiguration über den Parameter &AUT_O365_CONFIGURATION#, wodurch Multi-Tenant-Setups und der Dateiaustausch zwischen Tenants unkompliziert möglich sind.
Wo wird das Action Pack installiert, und kann ich es verschieben?
Das Automation Office 365 Action Pack wird über Administration → Packs → Install From File in den Ordner PACKAGES des Automic-Mandanten installiert. Das Action Pack muss in diesem Ordner verbleiben und darf nicht umbenannt werden — andernfalls werden interne Referenzen ungültig. Die Installation in Mandant 0 wird nicht unterstützt.
Benötigt die Upload-Aktion einen OS-Agenten?
Die Upload-Aktion des Automation Office 365 Action Pack benötigt nur dann einen OS-Agenten und ein Login, wenn Delete source = true gesetzt ist, da das Löschen der Quelle auf dem Dateisystem erfolgt, auf dem die hochgeladenen Dateien liegen. Für reine Uploads ohne Löschen der Quelle genügt der WebService-REST-Agent. Die Download-Aktion verwendet den OS-Agenten nur dann, wenn für einen rekursiven Download lokale Unterverzeichnisse angelegt werden müssen.
Was passiert, wenn eine Löschaktion gegen SharePoint ausgeführt wird?
Die Lösch-Aktion des Automation Office 365 Action Pack löscht Dateien nicht endgültig. Die passenden Elemente werden über Microsoft Graph in den SharePoint-Papierkorb verschoben, sodass sie innerhalb des SharePoint-Aufbewahrungszeitraums aus dem Papierkorb wiederhergestellt werden können, falls eine Löschung fälschlicherweise erfolgt ist.
Können Dateipfad-Muster Wildcards verwenden?
Ja. Der Parameter &AUT_O365_FILE_PATTERN# akzeptiert sowohl voll qualifizierte Dateinamen als auch Wildcard-Muster wie *.txt oder report_*.csv. In Kombination mit dem Flag Include Folders kann das Automation Office 365 Action Pack ganze Verzeichnisbäume in einem einzigen Aktionsaufruf verarbeiten.
Werden Datei- und Ordnernamen mit Leerzeichen unterstützt?
Ja. Pfade und Dateinamen mit Leerzeichen werden korrekt in Anführungszeichen gesetzt – bei Downloads seit Version 2.0.2 und bei Uploads mit Delete source seit Version 2.1.1.
Wie funktioniert ein Upgrade auf eine neue Version?
Upgrades des Automation Office 365 Action Pack nutzen den Standardablauf über Install From File. Automic erkennt eine bestehende Installation, fordert zur Bestätigung auf und ersetzt das Action Pack direkt im Ordner PACKAGES. Über CONFIGURATION_ADD angelegte benannte Verbindungskonfigurationen bleiben beim Upgrade erhalten.
Hängt das Action Pack von anderen Tricise-Packs ab?
Das Automation Office 365 Action Pack hängt von PCK.ITPA_SHARED ab, einem gemeinsam genutzten Utility-Action-Pack. Falls es im Ziel-Automic-Mandanten noch nicht vorhanden ist, muss es über dieselbe Oberfläche Administration → Packs installiert werden, bevor das Office 365 Action Pack selbst installiert wird.
Wie viel kostet das Automation Office 365 Action Pack?
Das Automation Office 365 Action Pack wird als Einmalkauf zu 3.200 € (zzgl. MwSt.) pro Automic-System lizenziert. Der Preis ist auf der Tricise-Shop-Seite ausgewiesen und beinhaltet den Tricise-Produkt-Support sowie Kompatibilitäts-Updates für die aktuelle Automic-Release-Linie V24+. Es fallen keine wiederkehrenden Abonnementgebühren an.
Wo kann ich das Automation Office 365 Action Pack kaufen?
Das Automation Office 365 Action Pack ist über den Tricise-Shop unter tricise.com/shop/automation-office-365 erhältlich. Bei Fragen zu Lizenzierung, Multi-System-Scoping, Onboarding oder Live-Walkthroughs können Sie Tricise über das Beratungsformular kontaktieren.