Périmètre technique et prérequis
L'Automation Office 365 Action Pack intègre les opérations sur les fichiers SharePoint de Microsoft 365 dans les workflows Automic Automation. Il fournit un ensemble d'actions publiques pour téléverser, télécharger et supprimer des fichiers sur SharePoint, ainsi que des actions de gestion de connexion pour enregistrer les informations d'identification de l'application Azure. Tous les appels SharePoint s'authentifient auprès de Microsoft Graph via le flux d'informations d'identification client et s'exécutent via l'agent WebService REST d'Automic.
Ce guide complet couvre la portée, l'installation, la configuration, la référence complète des actions et la procédure de mise à niveau. C'est le document technique de référence pour les administrateurs Automic et les propriétaires de plateforme qui déploient l'Automation Office 365 Action Pack dans un environnement Automic de production.
Plateformes prises en charge
- Automic Automation : Versions V24 et ultérieures
- SharePoint : SharePoint Online (Microsoft 365) via l'API Microsoft Graph
- Authentification : Enregistrement d'application Microsoft Entra ID (anciennement Azure AD) avec le flux client-credentials
Prérequis côté Automic
- Un système Automic Automation en cours d'exécution avec un client accessible autre que le client 0 — l'Action Pack ne peut pas être installé dans le client 0
- Un agent WebService REST configuré et accessible depuis le client dans lequel l'Action Pack est installé
- Un agent de système d'exploitation et un objet Login correspondant — requis uniquement pour l'action de téléversement lorsque Delete source = true et pour l'action de téléchargement lorsque les sous-répertoires locaux doivent être créés
- Facultatif : l'Action Pack dépendant PCK.ITPA_SHARED — installez-le d'abord s'il n'est pas déjà présent sur le client cible
Prérequis du côté de Microsoft 365
- Une inscription d'application Entra ID (Azure AD) avec un secret client généré
- — l'identifiant unique du locataire Microsoft 365 / Entra ID
- Identifiant client — l’ID de l’application (client) de l’application enregistrée
- — la valeur secrète associée à l'identifiant client
- Autorisation d'API : Sites.ReadWrite.All (autorisation d'application, pas déléguée), consentement administrateur accordé
- Accessibilité réseau depuis l'agent WebService REST vers graph.microsoft.com et login.microsoftonline.com
Installation, mise à jour et désinstallation
L'Automation Office 365 Action Pack s'installe via l'interface standard Automic Administration → Packs. Le même processus couvre l'installation initiale et les mises à jour sur place. Toutes les opérations doivent être effectuées dans un client Automic autre que 0 — l'installation dans le client 0 n'est pas prise en charge.
Installation / mise à jour
- Connectez-vous au client cible Automic (pas au client 0)
- Basculez vers la vue Administration
- Ouvrez l'élément de menu Packs
- Facultatif : si Action Pack PCK.ITPA_SHARED n'est pas déjà installé, installez d'abord la dépendance
- Cliquez sur Install From File
- Sélectionnez le fichier de l'Automation Office 365 Action Pack et confirmez avec Install
- Si une version précédente est déjà installée, confirmez la mise à jour en cliquant à nouveau sur Install
- Confirmez la réussite de l'installation avec Fermer
Après l'installation, le Action Pack apparaît dans le dossier PACKAGES du client Automic.
Désinstaller
- Connectez-vous au client Automic où Action Pack est installé
- Basculez vers la vue Administration
- Ouvrez l'élément de menu Packs
- Sélectionnez l'Automation Office 365 Action Pack et cliquez sur Remove
- Confirmez la désinstallation en cliquant sur Yes
- Confirmez la suppression avec Close
Configuration — connexion à un locataire Azure
Avant que toute action SharePoint puisse s'exécuter, l'Automation Office 365 Action Pack a besoin d'au moins une configuration de connexion nommée pointant vers un locataire Entra ID / Azure. Les configurations sont gérées via trois actions dédiées : CONFIGURATION_ADD, CONFIGURATION_UPDATE et CONFIGURATION_REMOVE. Chaque action SharePoint référence une configuration par son nom à l'exécution.
Création d'une nouvelle configuration
- Démarrez l'action CONFIGURATION_ADD
- Remplissez les champs requis (voir le tableau des paramètres ci-dessous)
- Confirmez en cliquant sur Envoyer
Paramètres de configuration
| Paramètre | Variable | Notes et exemple |
|---|---|---|
| Nom | &AUT_O365_CONFIGURATION# |
Nom de configuration libre. Syntaxe recommandée : TENANT_APPID — par exemple, MYCOMPANY_MYAPP ou AUTOMIC_0100 |
| ID du locataire | &AUT_O365_TENANT_ID# |
L'ID unique du locataire de l'environnement Azure / Entra ID auquel se connecter |
| Identifiant client | &AUT_O365_CLIENT_ID# |
L'identifiant client unique de l'application enregistrée |
| Clé secrète client | &AUT_O365_CLIENT_SECRET# |
La valeur secrète du client associée à l'ID client |
| Type d'octroi | &AUT_O365_GRANT_TYPE# |
Type d'octroi OAuth 2.0. Valeur typique : client_credentials |
| Champ d'application | &AUT_O365_SCOPE# |
URL du périmètre de Microsoft Graph. Valeur typique : https://graph.microsoft.com/.default |
Mise à jour et suppression des configurations
- Pour créer des configurations supplémentaires, relancez CONFIGURATION_ADD avec un nouveau nom
- Pour modifier une configuration existante, exécutez CONFIGURATION_UPDATE avec le nom de la configuration existante et les champs à modifier
- Pour supprimer une configuration, exécutez CONFIGURATION_REMOVE avec le nom de la configuration comme seul paramètre requis.
Référence des actions
L'Automation Office 365 Action Pack met à disposition cinq actions publiques : deux pour la gestion des connexions et trois pour les opérations sur les fichiers SharePoint. Toutes les actions SharePoint obtiennent en interne un jeton d'accès via Microsoft Graph, résolvent le site et la bibliothèque cibles, puis exécutent l'appel REST via l'agent WebService REST. Les jetons d'accès sont renouvelés automatiquement au bout de 59 minutes, de sorte que les transferts de longue durée continuent de fonctionner avec un jeton valide. Les sous-sections suivantes décrivent chaque action publique et ses paramètres.
4.1 · CONFIGURATION_ADD / CONFIGURATION_UPDATE
Créer ou mettre à jour une configuration de connexion nommée utilisée pour s'authentifier auprès de Microsoft Graph.
Noms des objets :
- PCK.TRICISE_AUT_O365.PUB.ACTION.CONFIGURATION_ADD
- PCK.TRICISE_AUT_O365.PUB.ACTION.CONFIGURATION_UPDATE
Paramètres : voir le tableau des paramètres de configuration dans la section 3 ci-dessus.
4.2 · CONFIGURATION_REMOVE
Supprimer une configuration de connexion existante.
Nom de l'objet : PCK.TRICISE_AUT_O365.PUB.ACTION.CONFIGURATION_REMOVE
| Paramètre | Variable | Notes et exemple |
|---|---|---|
| Nom | &AUT_O365_CONFIGURATION# |
Nom de configuration existant — par exemple MYTENANT_APPID |
4.3 · SHAREPOINT_FILES_UPLOAD
Transférer un ou plusieurs fichiers locaux vers une bibliothèque SharePoint via Microsoft Graph REST. La sélection de fichiers prend en charge les jokers et la traversée récursive facultative des sous-répertoires ; les fichiers téléversés peuvent facultativement être supprimés du chemin source après un transfert réussi.
Nom de l'objet : PCK.TRICISE_AUT_O365.PUB.ACTION.SHAREPOINT_FILES_UPLOAD
Sous-processus internes :
- SHAREPOINT_GET_TOKEN — acquiert le jeton d'accès Microsoft Graph
- SHAREPOINT_GET_SITE — résout le site SharePoint cible
- SHAREPOINT_FILES_UPLOAD → SHAREPOINT_FILE_UPLOAD — exécute le chargement par fichier
- SHAREPOINT_FILES_DELETE — appelé lorsque
Delete source = truepour nettoyer la source après le téléversement
| Paramètre | Variable | Notes et exemple |
|---|---|---|
| Lien du site | &AUT_O365_SITE_LINK# |
Référence de site SharePoint unique. Exemple : mydomain.sharepoint.com:/sites/mySite |
| Nom de la bibliothèque | &AUT_O365_DRIVE_NAME# |
Bibliothèque SharePoint cible. La bibliothèque par défaut dans SharePoint est « Freigegebene Dokumente » / « Shared Documents ». Exemple : Dokumente |
| Chemin SharePoint | &AUT_O365_SHAREPOINT_PATH# |
Dossier cible à l'intérieur de la bibliothèque. Soit la racine (root), soit un sous-dossier (root:/MyFolder/MySubfolder). Exemple : root:/myFolder |
| Modèle de chemin de fichier | &AUT_O365_FILE_PATTERN# |
Motif de sélection de fichier. Chemin complet ou avec caractères génériques. Exemple : *.txt |
| Chemin local | &AUT_O365_LOCAL_PATH# |
Répertoire source local contenant les fichiers à téléverser. Exemple : C:\temp |
| Agent OS | &AUT_O365_AGENT# |
Agent de système d'exploitation utilisé pour la suppression de la source lorsque Delete source = true. Exemple : MYAGENT |
| Login OS | &AUT_O365_LOGIN# |
Objet Login utilisé pour la suppression de la source lorsque Delete source = true. Exemple : LOGIN.MYLOGIN |
| Inclure les dossiers | &AUT_O365_RECURSIVE# |
Parcourir les sous-répertoires lors du téléversement. vrai / faux |
| Supprimer la source | &AUT_O365_DELETE_SOURCE# |
Supprimer les fichiers téléversés du chemin source après un téléversement réussi. true / false |
4.4 · SHAREPOINT_FILES_DOWNLOAD
Télécharger un ou plusieurs fichiers d'une bibliothèque SharePoint vers un répertoire cible local via Microsoft Graph REST. Prend en charge la sélection par caractères génériques et la traversée récursive optionnelle des sous-dossiers.
Nom de l'objet : PCK.TRICISE_AUT_O365.PUB.ACTION.SHAREPOINT_FILES_DOWNLOAD
Sous-processus internes :
- SHAREPOINT_GET_TOKEN — acquiert le jeton d'accès Microsoft Graph
- SHAREPOINT_GET_SITE — résout le site SharePoint cible
- SHAREPOINT_GET_ITEM_ID / SHAREPOINT_GET_ITEM_IDS — résout les identifiants d'un ou plusieurs éléments pour le téléchargement
- SHAREPOINT_FILES_DOWNLOAD → SHAREPOINT_FILE_DOWNLOAD — exécute le téléchargement par fichier
| Paramètre | Variable | Notes et exemple |
|---|---|---|
| Lien du site | &AUT_O365_SITE_LINK# |
Référence de site SharePoint unique. Exemple : mydomain.sharepoint.com:/sites/mySite |
| Nom de la bibliothèque | &AUT_O365_DRIVE_NAME# |
Bibliothèque SharePoint source. Par défaut : « Shared Documents ». Exemple : Dokumente |
| Modèle de chemin de fichier | &AUT_O365_FILE_PATTERN# |
Motif de sélection de fichier. Chemin complet ou avec caractères génériques. Exemple : *.txt |
| Chemin SharePoint | &AUT_O365_SHAREPOINT_PATH# |
Dossier source à l'intérieur de la bibliothèque. Racine (root) ou sous-dossier (root:/MyFolder/MySubfolder) |
| Chemin local | &AUT_O365_LOCAL_PATH# |
Répertoire local cible pour les fichiers téléchargés. Exemple : C:\temp |
| Inclure les dossiers | &AUT_O365_RECURSIVE# |
Parcourir les sous-dossiers SharePoint lors du téléchargement. vrai / faux |
4.5 · SHAREPOINT_FILES_DELETE
Supprimez un ou plusieurs fichiers d'une bibliothèque SharePoint. Les fichiers sont supprimés via Microsoft Graph REST, ce qui les déplace vers la corbeille SharePoint plutôt que de les effacer définitivement.
Nom de l'objet : PCK.TRICISE_AUT_O365.PUB.ACTION.SHAREPOINT_FILES_DELETE
Sous-processus internes :
- SHAREPOINT_GET_TOKEN
- SHAREPOINT_GET_SITE
- SHAREPOINT_GET_ITEM_ID / SHAREPOINT_GET_ITEM_IDS
- SHAREPOINT_FILES_DELETE → SHAREPOINT_FILE_DELETE
| Paramètre | Variable | Notes et exemple |
|---|---|---|
| Lien du site | &AUT_O365_SITE_LINK# |
Référence de site SharePoint unique. Exemple : mydomain.sharepoint.com:/sites/mySite |
| Nom de la bibliothèque | &AUT_O365_DRIVE_NAME# |
Bibliothèque SharePoint source. Par défaut : « Shared Documents » |
| Modèle de chemin de fichier | &AUT_O365_FILE_PATTERN# |
Motif de sélection de fichier. Chemin complet ou avec caractères génériques. Exemple : *.txt |
| Chemin SharePoint | &AUT_O365_SHAREPOINT_PATH# |
Dossier source dans la bibliothèque. Dossier racine ou sous-dossier. Exemple : root:/myFolder |
| Inclure les dossiers | &AUT_O365_RECURSIVE# |
Parcourir les sous-dossiers SharePoint lors de la suppression. vrai / faux |
Mise à niveau et migration
La mise à niveau de l'Automation Office 365 Action Pack utilise la même procédure Installer depuis un fichier que l'installation initiale. Automic reconnaît l'installation existante et vous demande une confirmation de mise à jour ; la sélection de Installer remplace la version installée sur place. Les configurations créées via CONFIGURATION_ADD sont préservées lors des mises à niveau.
Procédure de mise à niveau recommandée
- Sauvegardez ou exportez le client concerné pour conserver un point de retour arrière.
- Mettez en pause tous les workflows qui font référence aux actions SharePoint de l'Action Pack
- Exécutez Installer depuis un fichier avec le nouveau fichier Action Pack et confirmez la mise à jour
- Effectuez un test rapide (smoke test) avec un téléversement, un téléchargement et une suppression éprouvés sur un site SharePoint de test
- Réactivez les workflows mis en pause
Notes de publication
Toutes les versions de l'Automation Office 365 Action Pack et les modifications apportées par chacune d'elles.
v2.1.2 (actuelle) · 2026-07-08
| Version | Type | Modification |
|---|---|---|
| 2.1.2 2026-07-08 | Modifié | Préparation des sessions de téléversement (CREATEUPLOADSESSION) ; pas encore activée |
Versions antérieures
Versions 1.0.0 – 2.1.1
| Version | Type | Modification |
|---|---|---|
| 2.1.1 2026-05-11 | Corrigé | Téléversement avec l'option Delete source : les chemins et noms de fichiers contenant des espaces sont mis entre guillemets (include PCK.TRICISE_AUT_O365.PRV.INCLUDE.SHAREPOINT_FILE_UPLOAD_DELETE_SOURCE) |
| 2.1.0 2025-11-14 | Modifié | SHAREPOINT_FILES_DOWNLOAD, SHAREPOINT_FILES_DELETE et SHAREPOINT_FILES_UPLOAD : bibliothèque SharePoint sélectionnable |
| 2.0.2 2025-05-15 | Corrigé | PCK.TRICISE_AUT_O365.PRV.JOB.SHAREPOINT_FILE_DOWNLOAD : valeur de sortie mise entre guillemets, afin de pouvoir télécharger les fichiers dont le nom contient des espaces |
| 2.0.1 2025-04-03 | Corrigé | PCK.TRICISE_AUT_O365.PRV.JOB.SHAREPOINT_GET_DOWNLOAD_URL : &ITERATION_ITEM# est publié dans TOP au lieu de WORKFLOW |
| 2.0.0 2025-02-11 | Nouveau | Actions CONFIGURATION_ADD, CONFIGURATION_REMOVE et CONFIGURATION_UPDATE |
| Modifié | Le téléchargement, la suppression et le téléversement lisent leurs identifiants dans l'objet variable de configuration | |
| 1.5.0 2025-01-17 | Modifié | SHAREPOINT_GET_TOKEN vérifie si le jeton doit être renouvelé au bout de 59 minutes |
| Modifié | Le téléchargement, la suppression et le téléversement renouvellent le jeton au bout de 59 minutes | |
| 1.4.0 2024-12-03 | Modifié | Téléchargement, suppression et téléversement récursifs |
| 1.3.3 2024-11-28 | Corrigé | Amélioration des performances grâce à des réponses plus compactes et à un filtrage plus efficace |
| 1.3.2 2024-09-03 | Corrigé | Rapports de requête et de réponse des jobs REST désactivés, car ils saturaient le système de fichiers |
| 1.2.1 2024-06-26 | Corrigé | Téléversement : &AUT_O365_LOCAL_PATH# et &AUT_O365_FILENAME_UPLOAD# sont définis dans le PromptSet |
| 1.2.0 2024-06-20 | Nouveau | Actions SHAREPOINT_FILES_DELETE et SHAREPOINT_FILES_DOWNLOAD |
| Nouveau | Actions internes SHAREPOINT_FILE_DELETE, SHAREPOINT_GET_ITEM_ID et SHAREPOINT_GET_ITEM_CHILDS | |
| 1.0.3 2024-04-17 | Corrigé | CONN_ENDPOINT_URL trop long : scindé en URL et ressource |
| 1.0.2 2024-03-20 | Modifié | SHAREPOINT_FILES_UPLOAD : nouvelle option Delete source (true / false) |
| 1.0.1 2024-03-19 | Nouveau | Action SHAREPOINT_FILES_UPLOAD |
| 1.0.0 2024-03-19 | Nouveau | Version initiale |
Questions fréquemment posées
Que fait l'Automation Office 365 Action Pack ?
L'Automation Office 365 Action Pack ajoute le téléversement, le téléchargement et la suppression de fichiers SharePoint aux workflows Automic Automation. Il encapsule l'authentification Microsoft Graph, la gestion des jetons d'accès et les appels REST dans cinq actions publiques, afin que les opérations sur les fichiers SharePoint puissent être orchestrées directement depuis Automic sans créer d'intégration personnalisée.
Quelles sont les versions d'Automic prises en charge ?
L'Automation Office 365 Action Pack est pris en charge sur les versions V24 et ultérieures d'Automic Automation. Les systèmes V21 antérieurs ne sont pas couverts par la version actuelle ; Tricise fournit des mises à jour de compatibilité à mesure que de nouvelles versions majeures d'Automic paraissent.
Quelles autorisations Microsoft Graph nécessite-t-il ?
L'Automation Office 365 Action Pack nécessite l'autorisation Application (et non Déléguée) Sites.ReadWrite.All sur l'application Entra ID enregistrée, avec le consentement de l'administrateur accordé. Le flux OAuth 2.0 client-credentials est utilisé pour obtenir des jetons d'accès via login.microsoftonline.com, puis appelle Microsoft Graph à graph.microsoft.com.
L'Action Pack peut-il cibler plusieurs locataires Microsoft 365 ?
Oui. L'Automation Office 365 Action Pack prend en charge un nombre illimité de connexions nommées par client Automic. Chaque connexion stocke ses propres Tenant ID, Client ID, Client Secret, type d'octroi et portée. Chaque action SharePoint référence une configuration via le paramètre &AUT_O365_CONFIGURATION#, ce qui simplifie les configurations multi-locataires et les échanges de fichiers inter-locataires.
Où l'Action Pack est-il installé, et puis-je le déplacer ?
L'Automation Office 365 Action Pack est installé dans le dossier PACKAGES du client Automic via Administration → Packs → Installer depuis un fichier. L'Action Pack doit rester dans ce dossier et ne doit pas être renommé — l'un comme l'autre casserait les références internes. L'installation dans le client 0 n'est pas prise en charge.
L'action de téléversement nécessite-t-elle un agent OS ?
L'action de téléversement de l'Automation Office 365 Action Pack ne nécessite un agent OS et un objet Login que lorsque Delete source = true, car la suppression de la source s'exécute sur le système de fichiers où résident les fichiers téléversés. Pour de simples téléversements sans suppression de la source, l'agent WebService REST suffit. L'action de téléchargement utilise l'agent OS uniquement lorsque des sous-répertoires locaux doivent être créés pour un téléchargement récursif.
Que se passe-t-il lorsqu'une action de suppression s'exécute sur SharePoint ?
L'action de suppression de l'Automation Office 365 Action Pack ne supprime pas définitivement les fichiers. Les éléments correspondants sont déplacés dans la corbeille SharePoint via Microsoft Graph, ce qui signifie qu'ils peuvent être restaurés à partir de la corbeille dans la fenêtre de rétention de SharePoint si une suppression s'avère erronée.
Les modèles de chemin de fichier peuvent-ils utiliser des caractères génériques ?
Oui. Le paramètre &AUT_O365_FILE_PATTERN# accepte à la fois les noms de fichiers complets et les caractères génériques tels que *.txt ou report_*.csv. Combiné avec l'indicateur Include Folders, l'Automation Office 365 Action Pack peut traiter des arborescences de répertoires entières en un seul appel d'action.
Les noms de fichiers et de dossiers contenant des espaces sont-ils pris en charge ?
Oui. Les chemins et noms de fichiers contenant des espaces sont correctement mis entre guillemets — pour les téléchargements depuis la version 2.0.2 et pour les téléversements avec Delete source depuis la version 2.1.1.
Comment fonctionne la mise à niveau vers une nouvelle version ?
Les mises à niveau de l'Automation Office 365 Action Pack reprennent la procédure standard Install From File. Automic détecte une installation existante, demande une confirmation et remplace l'Action Pack sur place dans le dossier PACKAGES. Les configurations de connexion nommées créées via CONFIGURATION_ADD sont conservées lors des mises à niveau.
L'Action Pack dépend-il d'autres packs Tricise ?
L'Automation Office 365 Action Pack dépend de PCK.ITPA_SHARED, un Action Pack utilitaire partagé. S'il n'est pas déjà présent dans le client Automic cible, installez-le à partir de la même interface Administration → Packs avant d'installer l'Office 365 Action Pack lui-même.
Combien coûte l'Automation Office 365 Action Pack ?
L'Automation Office 365 Action Pack est proposé sous forme de licence à achat unique à 3 200 € (hors TVA) par système Automic. Le prix est indiqué sur la page de la boutique Tricise et comprend le support produit Tricise ainsi que les mises à jour de compatibilité pour la ligne de versions actuelle Automic V24+. Il n'y a pas de frais d'abonnement récurrents.
Où puis-je acheter l'Automation Office 365 Action Pack ?
L'Automation Office 365 Action Pack est disponible dans la boutique Tricise à l'adresse tricise.com/shop/automation-office-365. Pour toute question concernant les licences, l'étendue multi-systèmes, l'intégration ou les démonstrations en direct, contactez Tricise via le formulaire de consultation.