Périmètre technique et prérequis
Le bureau d'automatisation pour Office 365 Action Pack intègre les opérations de fichiers Microsoft 365 SharePoint dans les flux de travail Automic Automation. Il fournit un ensemble d'actions publiques pour télécharger, téléverser 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 en utilisant le flux d'informations d'identification client et s'exécutent via l'agent REST WebService de Automic.
Ce guide complet couvre la portée, l'installation, la configuration, la référence complète des actions et le parcours de mise à niveau. C'est le document technique faisant autorité pour les administrateurs Automic et les propriétaires de plateforme déployant le Bureau d'automatisation 365 Action Pack dans un environnement de production Automic.
Plateformes prises en charge
- Automic Automation : Lignes de sortie 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 — Action Pack ne peut pas être installé dans le client 0
- Un agent WebService REST configuré et accessible par le locataire dans lequel le Action Pack est installé
- Un agent de système d'exploitation et un objet de connexion correspondant — requis uniquement pour l'action de téléchargement lorsque Supprimer la source = vrai et pour l'action de téléchargement lorsque les sous-répertoires locaux doivent être créés
- Optionnel : le dépendant Action Pack 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é
- **ID de client** — l'identifiant unique du client Microsoft 365 / Entra ID
- Identifiant client — l’ID de l’application (client) de l’application enregistrée
- **Secret client** — 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é
- Portée réseau de l'agent REST WebService vers graph.microsoft.com et login.microsoftonline.com
Installation, mise à jour et désinstallation
L'automatisation Office 365 Action Pack est installée via l'interface d'administration standard → Packs Automic. Le même flux de travail couvre l'installation propre et les mises à niveau sur place. Toutes les opérations doivent être effectuées dans un client non nul Automic — 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)
- Basculer 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 **Installer depuis un fichier**
- Sélectionnez le fichier Automation Office 365 Action Pack et confirmez avec **Installer**
- Si une version précédente est déjà installée, confirmez la mise à jour en cliquant à nouveau sur **Installer**
- 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é
- Basculer vers la vue **Administration**
- Ouvrez l'élément de menu Packs
- Sélectionnez Automation Office 365 Action Pack et cliquez sur Supprimer
- Confirmez la désinstallation en cliquant sur **Oui**
- Confirmer la suppression réussie avec Fermer
Configuration — connexion à un locataire Azure
Avant que toute action SharePoint puisse s'exécuter, la configuration de connexion nommée Automation Office 365 Action Pack doit avoir au moins une 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 de subvention | &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érences des actions
Le bureau d'automatisation Office 365 Action Pack expose cinq actions publiques : deux pour la gestion des connexions et trois pour les opérations de fichiers SharePoint. Toutes les actions SharePoint acquièrent 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 REST WebService. Les sous-sections suivantes documentent chaque action publique et ses paramètres.
4.1 · CONFIGURATION_AJOUTER / CONFIGURATION_METTRE_À_JOUR
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_AJOUT
- PCK.TRICISE_AUT_O365.PUB.ACTION.MISE_A_JOUR_CONFIGURATION
Paramètres : voir le tableau des paramètres de configuration dans la section 3 ci-dessus.
4.2 · CONFIGURATION_SUPPRIMER
Supprimer une configuration de connexion existante.
Nom de l'objet : PCK.TRICISE_AUT_O365.PUB.ACTION.CONFIGURATION_SUPPRIMER
| Paramètre | Variable | Notes et exemple |
|---|---|---|
| Nom | &AUT_O365_CONFIGURATION# |
Nom de configuration existant — par exemple MYTENANT_APPID |
4.3 · TÉLÉCHARGEMENTS_FICHIERS_SHAREPOINT
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échargé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
Supprimer la source = truepour nettoyer la source après le téléchargement
| 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:/MonDossier/MonSousDossier). Exemple : root:/monDossier |
| Modèle de chemin de fichier | &AUT_O365_FILE_PATTERN# |
Motif de sélection de fichier. Qualifié complètement ou caractère générique. Par exemple : *.txt |
| Chemin local | &AUT_O365_LOCAL_PATH# |
Répertoire source local contenant les fichiers à télécharger. 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 |
| Connexion au système d'exploitation | &AUT_O365_CONNEXION# |
Objet de connexion utilisé pour la suppression de la source lorsque Supprimer la source = true. Exemple : LOGIN.MONLOGIN |
| Inclure les dossiers | &AUT_O365_RECURSIVE# |
Parcourir les sous-répertoires lors du téléchargement. vrai / faux |
| Supprimer la source | &AUT_O365_DELETE_SOURCE# |
Supprimer les fichiers téléchargés à partir du chemin source après un téléchargement réussi. true / false |
4.4 · FICHIERS_SHAREPOINT_TÉLÉCHARGER
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
- TÉLÉCHARGER_FICHIERS_SHAREPOINT → TÉLÉCHARGER_FICHIER_SHAREPOINT — 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 : “ Documents partagés ”. Exemple : Dokumente |
| Modèle de chemin de fichier | &AUT_O365_FILE_PATTERN# |
Motif de sélection de fichier. Qualifié complètement ou caractère générique. Par exemple : *.txt |
| Chemin SharePoint | &AUT_O365_SHAREPOINT_PATH# |
Dossier source à l'intérieur de la bibliothèque. Racine (root) ou sous-dossier (root:/MonDossier/MonSousDossier) |
| 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 · SUPPRIMER_FICHIERS_SHAREPOINT
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.SUPPRIMER_FICHIERS_SHAREPOINT
Sous-processus internes :
- SHAREPOINT_GET_TOKEN
- SHAREPOINT_GET_SITE
- SHAREPOINT_GET_ITEM_ID / SHAREPOINT_GET_ITEM_IDS
- SUPPRIMER_FICHIERS_SHAREPOINT → SHAREPOINT_FICHIER_SUPPRIMER
| 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 : “ Documents partagés ” |
| Modèle de chemin de fichier | &AUT_O365_FILE_PATTERN# |
Motif de sélection de fichier. Qualifié complètement ou caractère générique. Par exemple : *.txt |
| Chemin SharePoint | &AUT_O365_SHAREPOINT_PATH# |
Dossier source dans la bibliothèque. Dossier racine ou sous-dossier. Exemple : root:/monDossier |
| Inclure les dossiers | &AUT_O365_RECURSIVE# |
Parcourir les sous-dossiers SharePoint lors de la suppression. vrai / faux |
Mise à niveau et migration
La mise à niveau d'Automation Office 365 Action Pack utilise le même flux de travail Installer à partir d'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 locataire pertinent pour conserver un point de retour arrière.
- Mettre en pause tous les workflows qui font référence aux actions SharePoint de Action Pack
- Exécutez Installer depuis fichier avec le nouveau fichier Action Pack et confirmez la mise à jour
- Tester par fumée une action connue pour être bonne : téléverser, télécharger et supprimer sur un site SharePoint de test
- Réactiver les flux de travail mis en pause
Questions fréquemment posées
Que fait le Bureau d'automatisation d'Office 365 Action Pack ?
Le bureau d'automatisation Office 365 Action Pack ajoute le téléchargement, le téléversement et la suppression SharePoint aux flux de travail 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 de fichiers sur SharePoint puissent être orchestrées directement à partir de Automic sans créer d'intégration personnalisée.
Quelles sont les versions de Automic prises en charge ?
Le Bureau automatisé Office 365 Action Pack est pris en charge sur les lignes de versions V24 et ultérieures de 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 de Automic arrivent.
Quelles autorisations Microsoft Graph nécessite-t-il ?
Le bureau d'automatisation Office 365 Action Pack nécessite la permission 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.
Le Action Pack peut-il cibler plusieurs locataires Microsoft 365 ?
Oui. Le bureau d'automatisation 365 Action Pack prend en charge un nombre illimité de connexions nommées par client Automic. Chaque connexion stocke son propre ID de locataire, ID client, secret client, type d'autorisation 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ù est installé le Action Pack, et puis-je le déplacer ?
Le Office 365 Action Pack automated est installé dans le dossier PACKAGES du client Automic via Administration → Packs → Installer depuis un fichier. Le Action Pack doit rester dans ce dossier et ne doit pas être renommé — toute autre action briserait les références internes. L'installation dans le client 0 n'est pas prise en charge.
L'action de téléchargement nécessite-t-elle un agent système d'exploitation ?
L'action de téléchargement Automation Office 365 Action Pack ne nécessite un agent et une connexion OS que lorsque Supprimer la source = vrai, car la suppression de la source s'exécute sur le système de fichiers où résident les fichiers téléchargés. Pour les téléchargements purs sans suppression de la source, l'agent REST WebService est suffisant. 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.
Lorsqu'une action de suppression est exécutée sur SharePoint, voici ce qui se passe : * **Suppression des éléments :** Les documents, éléments de liste, listes, bibliothèques et autres objets qui sont directement ciblés par l'action de suppression sont déplacés vers la Corbeille (Recycle Bin) de SharePoint. * **Corbeille :** La Corbeille agit comme une zone tampon. Les éléments supprimés n'ont pas disparu définitivement immédiatement. Ils y restent pendant une période définie par l'administrateur SharePoint (ou jusqu'à ce que la Corbeille soit effacée manuellement). * **Autorisations :** L'action de suppression respecte les autorisations. Un utilisateur ne peut supprimer que les éléments pour lesquels il dispose des droits nécessaires (généralement, le droit de "Supprimer"). * **Dépendances (pour certains objets) :** * **Listes et Bibliothèques :** La suppression d'une liste ou d'une bibliothèque entraîne également la suppression de tous les éléments qu'elle contient. * **Sites :** La suppression d'un site (ou sous-site) entraîne la suppression de tout son contenu, y compris les listes, bibliothèques, pages, et autres objets imbriqués. * **Versions :** Les versions précédentes d'un document ne sont généralement pas supprimées tant que le document lui-même n'est pas supprimé. Cependant, la suppression de la version la plus récente peut entraîner la suppression des versions antérieures si la politique de rétention le dicte. * **Flux de travail et automatisations :** Si un flux de travail ou une autre automatisation est lié à un élément supprimé, son statut peut changer. Certains flux de travail peuvent s'arrêter, d'autres peuvent être configurés pour réagir à la suppression (par exemple, pour exécuter un nettoyage). * **Journalisation et Audit :** Les actions de suppression sont généralement enregistrées dans les journaux d'audit de SharePoint, permettant aux administrateurs de suivre qui a supprimé quoi et quand. * **Verrous (Locks) :** Si un élément est verrouillé (pour empêchement de modifications ou parce qu'il est en cours d'édition), une tentative de suppression peut échouer ou le déverrouiller. * **Réplication et Synchronisation (dans les environnements distribués) :** Dans des configurations SharePoint plus complexes (comme des fermes avec plusieurs serveurs ou des environnements cloud synchronisés), la suppression doit être répliquée sur tous les serveurs ou fronts-ends concernés. En résumé, une action de suppression sur SharePoint déplace l'objet vers la Corbeille, respecte les autorisations et peut affecter les objets dépendants. L'effacement définitif n'intervient qu'après que l'élément a été retiré de la Corbeille.
L'action de suppression Action Pack d'Automation Office 365 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 le drapeau Include Folders, l'Automation Office 365 Action Pack peut traiter des arborescences de répertoires entières en un seul appel d'action.
Comment fonctionne la mise à niveau vers une nouvelle version ?
Les mises à niveau du Bureau d'automatisation 365 Action Pack réutilisent le flux standard **Installer à partir d'un fichier**. Automic détecte une installation existante, demande une confirmation et remplace 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.
Le Action Pack dépend-il d'autres packs Tricise ?
Le bureau d'automatisation Office 365 Action Packdépend de PCK.ITPA_SHARED, un utilitaire partagé Action Pack. S'il n'est pas déjà présent dans le client cible Automic, installez-le à partir de la même interface Administration → Packs avant d'installer le bureau Office 365 Action Pack lui-même.
Quel est le coût de l'automatisation de Office 365 Action Pack ?
L'automatisation Office 365 Action Pack est concédée sous licence sous forme d'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'automatisation d'Office 365 Action Pack?
Le bureau d'automatisation 365 Action Pack est disponible dans la boutique Tricise à 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.