Technischer Umfang und Voraussetzungen
Das Automation Office 365 Action Pack integriert Microsoft 365 SharePoint-Dateioperationen 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 Microsoft Entra ID (ehemals Azure AD) App-Registrierung mit dem Client-Credentials-Flow
Voraussetzungen auf der Automic-Seite
- Ein laufendes Automic-Automation-System mit einem erreichbaren Mandanten (Client) ungleich Client 0 — das Action Pack kann nicht in Client 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 Entra ID (Azure AD) App-Registrierung mit einem generierten Clientschlüssel
- Tenant-ID — der eindeutige Bezeichner des Microsoft-365- / Entra-ID-Tenants
- Client-ID — die Anwendungs- (Client-) ID der registrierten App
- Client-Secret — der geheime Wert, der zur Client-ID gehört
- API-Berechtigung: Sites.ReadWrite.All (Application Permission, nicht Delegated), mit erteiltem Admin-Consent
- 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 Client 0 wird nicht unterstützt.
Installation / Aktualisierung
- Melden Sie sich beim Ziel Automic-Client an (nicht beim Client 0)
- Zur Ansicht 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
- Melden Sie sich am Automic-Client an, auf dem Action Pack installiert ist
- Zur Ansicht 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-Mandanten
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 | Notizen & 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 Typ | &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 holen intern ein Access-Token über Microsoft Graph, lösen die Ziel-Site und -Bibliothek auf und führen anschließend den REST-Aufruf über den WebService-REST-Agenten aus. Die folgenden Unterabschnitte dokumentieren jede öffentliche Aktion und ihre Parameter.
4.1 · KONFIGURATION_HINZUFÜGEN / KONFIGURATION_AKTUALISIEREN
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 · KONFIGURATION_ENTFERNEN
Eine bestehende Konfigurationsverbindung entfernen.
Objektname: PCK.TRICISE_AUT_O365.PUB.ACTION.CONFIGURATION_REMOVE
| Parameter | Variable | Notizen & 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 — löst die Ziel-SharePoint-Site auf
- SHAREPOINT_FILES_UPLOAD → SHAREPOINT_FILE_UPLOAD — führt den Upload pro Datei aus
- SHAREPOINT_FILES_DELETE — wird aufgerufen, wenn
Delete source = true, um die Quelle nach dem Upload zu bereinigen
| Parameter | Variable | Notizen & Beispiel |
|---|---|---|
| Website-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 für das Löschen der Quelle verwendet wird, wenn Delete source = true. Beispiel: MYAGENT |
| OS-Anmeldung | &AUT_O365_LOGIN# |
Login-Objekt, das für das Löschen der Quelle verwendet wird, wenn Delete source = true. Beispiel: LOGIN.MYLOGIN |
| Ordner einschließen | &AUT_O365_RECURSIVE# |
Unterverzeichnisse beim Upload mit durchlaufen. true / false |
| Quelle löschen | &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. Unterstützt Wildcard-Auswahl 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 — löst die Ziel-SharePoint-Site auf
- SHAREPOINT_GET_ITEM_ID / SHAREPOINT_ELEMENT_IDS — löst einzelne oder mehrere Element-IDs für den Download auf
- SHAREPOINT_FILES_DOWNLOAD → SHAREPOINT_FILE_DOWNLOAD — führt den Download pro Datei aus
| Parameter | Variable | Notizen & Beispiel |
|---|---|---|
| Website-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 |
| Ordner einschließen | &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_ELEMENT_IDS
- SHAREPOINT_FILES_DELETE → SHAREPOINT_FILE_DELETE
| Parameter | Variable | Notizen & Beispiel |
|---|---|---|
| Website-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 |
| Ordner einschließen | &AUT_O365_RECURSIVE# |
SharePoint-Unterordner beim Löschen mit durchlaufen. true / false |
Upgrade & Migration
Das Upgrade des Automation Office 365 Action Pack verwendet denselben Install From File-Ablauf wie die Erstinstallation. Automic erkennt die bestehende Installation und fordert zur Bestätigung des Updates auf; die Auswahl von Install ersetzt die installierte Version direkt. Die über CONFIGURATION_ADD angelegten Konfigurationen bleiben beim Upgrade erhalten.
Empfohlene Upgrade-Prozedur
- Den betreffenden Mandanten sichern oder exportieren, um einen Rollback-Punkt zu behalten
- 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 bekannt funktionierenden Smoke-Test mit Upload-, Download- und Lösch-Aktion gegen eine Test-SharePoint-Site ausführen
- Die pausierten Workflows wieder aktivieren
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 Application Permission (nicht Delegated) auf der registrierten Entra-ID-App, mit erteiltem Admin-Consent. 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-Mandanten ansprechen?
Ja. Das Automation Office 365 Action Pack unterstützt eine unbegrenzte Anzahl benannter Verbindungen pro Automic-Mandant. Jede Verbindung speichert ihre eigene 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 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 — beides bricht interne Referenzen. Die Installation in Client 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 getroffenen 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.
Wie funktioniert ein Upgrade auf eine neue Version?
Upgrades des Automation Office 365 Action Pack verwenden den standardmäßigen Install From File-Ablauf wieder. 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.