Modules Microsoft SharePoint Online
Dans un scénario Adobe Workfront Fusion, vous pouvez automatiser les workflows qui utilisent Microsoft SharePoint Online et les connecter à plusieurs applications et services tiers.
Pour obtenir des instructions sur la création d’un scénario, consultez les articles sous Créer des scénarios : index des articles.
Pour plus d’informations sur les modules, consultez les articles sous Modules : index des articles.
Conditions d’accès
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Package Adobe Workfront |
Tout package de workflow Adobe Workfront et tout package d’automatisation et d’intégration Adobe Workfront Workfront Ultimate Packages Workfront Prime et Select, avec l’achat supplémentaire de Workfront Fusion. |
| Licences Adobe Workfront |
Standard Travail ou supérieur |
| Licence Adobe Workfront Fusion |
Basé sur les opérations : disponible pour les organisations disposant de licences basées sur les opérations Basé sur un connecteur (hérité) : Workfront Fusion pour l’automatisation et l’intégration du travail |
| Produit | Si votre organisation dispose d’un package Workfront Select ou Prime qui n’inclut pas l’automatisation et l’intégration de Workfront, elle doit acquérir Adobe Workfront Fusion. |
Pour plus d’informations sur le contenu de ce tableau, consultez Conditions d’accès requises dans la documentation.
Pour plus d’informations sur les licences Adobe Workfront Fusion, consultez Licences Adobe Workfront Fusion.
Conditions préalables
Pour utiliser les modules Microsoft SharePoint Online, vous devez disposer d’un compte Microsoft SharePoint Online.
Informations sur l’API SharePoint
Le connecteur SharePoint utilise les éléments suivants :
Connexion de Microsoft SharePoint Online à Workfront Fusion connect-microsoft-sharepoint-online-to-workfront-fusion
- Connexion de Microsoft SharePoint Online à Workfront Fusion à l’aide d’un compte Microsoft
- Connexion de Microsoft SharePoint Online à Workfront Fusion à l’aide de paramètres avancés
- Connexion de Microsoft SharePoint Online à Workfront Fusion à l’aide de l’autorisation de certificat
- Connexion de Microsoft SharePoint Online à Workfront Fusion à l’aide d’un principal de service
Connexion de Microsoft SharePoint Online à Workfront Fusion à l’aide d’un compte Microsoft
Connexion de Microsoft SharePoint Online à Workfront Fusion à l’aide de paramètres avancés
Pour inclure des informations d’identification dans la connexion, activez l’option Afficher les paramètres avancés . Pour ce type de connexion, vous avez besoin d’un identifiant client, d’un secret client et d’un identifiant client.
-
Dans un module SharePoint, cliquez sur Ajouter à proximité du champ Connexion pour afficher la zone Créer une connexion.
-
Cliquez sur Afficher les paramètres avancés.
-
Remplissez les champs suivants :
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header Connection type Pour utiliser les informations d'identification du client, sélectionnez Microsoft 365 Email. Connection name Saisissez un nom pour la connexion. Client ID Saisissez l’ID client de l’application SharePoint à laquelle vous vous connectez. Client secret Saisissez le secret client pour l’application SharePoint à laquelle vous vous connectez. Tenant ID Saisissez l’ID client de l’application SharePoint à laquelle vous vous connectez. -
Cliquez sur Continuer pour enregistrer la connexion et revenir au module.
Connexion de Microsoft SharePoint Online à Workfront Fusion à l’aide de l’autorisation de certificat
Vous pouvez utiliser l’autorisation de certificat pour vous connecter à SharePoint.
| note important |
|---|
| IMPORTANT |
| Pour utiliser l’autorisation de certificat, vous devez d’abord créer une application dans Microsoft Entra et y télécharger le certificat. |
| Pour obtenir des instructions, consultez Comment configurer des autorités de certification pour l’authentification par certificat Microsoft Entra dans la documentation de Microsoft. |
-
Dans un module SharePoint, cliquez sur Ajouter à proximité du champ Connexion pour afficher la zone Créer une connexion.
-
Cliquez sur Afficher les paramètres avancés.
-
Remplissez les champs suivants :
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header Connection type Pour utiliser l’autorisation de certificat, sélectionnez Microsoft SharePoint Online (authentification de certificat). Connection name Saisissez un nom pour la connexion. Client ID Saisissez l’ID client de l’application SharePoint à laquelle vous vous connectez. Thumbprint Saisissez l’empreinte numérique de l’application SharePoint à laquelle vous vous connectez. Private key Saisissez le certificat ou la clé privée qui a été généré lors de la création de vos informations d’identification dans Microsoft.
Pour extraire votre clé privée ou votre certificat privé, procédez comme suit :
-
Cliquez sur Extract.
-
Indiquez si vous extrayez un certificat ou une clé privée.
-
Sélectionnez le type de fichier que vous extrayez.
-
Sélectionnez le fichier contenant la clé privée ou le certificat privé.
-
Saisissez le mot de passe du fichier.
-
Cliquez sur Save pour extraire le fichier et revenir à la configuration de la connexion.
-
-
Cliquez sur Continuer pour enregistrer la connexion et revenir au module.
Connexion de Microsoft SharePoint Online à Workfront Fusion à l’aide d’un principal de service
Vous pouvez créer une connexion qui utilise un principal de service (une connexion API d’application) au lieu d’un compte personnel. Cela s’avère utile lorsque vous souhaitez que la connexion s’exécute en tant qu’identité d’application ou de service plutôt qu’en tant que personne spécifique, de sorte que l’intégration ne soit pas interrompue si cette personne quitte l’entreprise ou modifie son mot de passe.
| note important |
|---|
| IMPORTANT |
| Ce type de connexion est disponible uniquement pour le module Effectuer un appel API . Les autres modules SharePoint nécessitent l’un des autres types de connexion décrits dans cet article. |
- Conditions préalables à la connexion de Microsoft SharePoint Online à Workfront Fusion à l’aide d’un principal de service
- Création de l’enregistrement de l’application dans l’ID Microsoft Entra
- Créer un secret client
- Octroi d’autorisations d’API
- Collecter les détails de votre connexion
- Créer la connexion
Conditions préalables à la connexion de Microsoft SharePoint Online à Workfront Fusion à l’aide d’un principal de service
Vous devez disposer d’un accès Administrateur global, Administrateur d’application ou Administrateur de rôle privilégié dans Microsoft Entra ID pour enregistrer l’application et lui accorder des autorisations. Si vous ne disposez pas de cet accès, demandez à un membre de votre équipe informatique ou d’identité d’effectuer ces étapes pour vous.
Passez à Créer l’enregistrement de l’application dans l’ID Microsoft Entra.
Créer l’enregistrement de l’application dans l’ID Microsoft Entra (principal de service)
- Connectez-vous au centre d’administration Microsoft Entra.
- Accédez à Enregistrements des applications > Nouvel enregistrement.
- Donnez à l’application un nom clair et reconnaissable. Par exemple,
Make - SharePoint Integration. - Laissez le champ URI de redirection vide. Cette connexion n’implique aucune connexion via un navigateur.
- Sélectionnez Enregistrer.
- Passez à Créer un secret client.
Créer un secret client (principal de service)
- Dans l’enregistrement de votre nouvelle application, accédez à Certificats et secrets.
- Sélectionnez Nouveau secret client, ajoutez une description, puis choisissez une période d’expiration.
- Sélectionnez Ajouter.
- Copiez immédiatement la valeur du secret. Il s’affiche une seule fois. Si vous quittez cette page avant de la copier, vous devez en créer une nouvelle.
- Passez à Octroi des autorisations d’API.
Octroi d’autorisations d’API (principal de service)
- Dans l’enregistrement de votre application, accédez à Autorisations d’API.
- Sélectionnez Ajouter une autorisation, puis sélectionnez Graphique Microsoft.
- Sélectionnez Autorisations d’application.
- Sélectionnez la ou les autorisations dont vos appels API ont besoin, puis sélectionnez Ajouter des autorisations.
- Sélectionnez Accorder le consentement administrateur pour votre organisation, puis confirmez.
- Continuez pour Collecter les détails de votre connexion.
Collecter les détails de votre connexion (principal de service)
Sur la page Aperçu de l’enregistrement de l’application, notez les valeurs suivantes. Vous les saisissez lors de la création de la connexion dans le module .
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| Tenant ID | Sur la page Aperçu , intitulé ID de répertoire (client). |
| Client ID | Sur la page Aperçu , intitulé ID d’application (client). |
| Client Secret | Valeur copiée dans Créer un secret client. |
Passez à Créer la connexion .
Créer la connexion (principal de service)
-
Dans le module Effectuer un appel API, cliquez sur Ajouter près du champ Connexion pour ouvrir la zone Créer une connexion.
-
Cliquez sur Afficher les paramètres avancés.
-
Dans le champ Type de connexion, sélectionnez Principal de service.
-
Saisissez les informations suivantes :
- ID de client
- Identifiant du client
- Secret du client
-
Cliquez sur Continuer pour enregistrer la connexion et revenir au module.
Si tout est correctement configuré, la connexion est validée avec succès.
Connexion de Microsoft SharePoint Online à Adobe Workfront Fusion à l’aide d’une connexion fédérée
Une connexion fédérée fonctionne comme la connexion principale du service, sauf qu’elle n’utilise pas de secret client.
Au lieu de stocker un secret, vous indiquez à Microsoft Entra ID d’approuver les jetons que Workfront Fusion émet pour une connexion spécifique. Lorsque la connexion s’exécute, Fusion présente une preuve d’identité de courte durée et l’ID Microsoft Entra renvoie un jeton d’accès. Comme il n’existe aucun secret client, il n’existe aucun secret qui expire et aucun secret à faire pivoter ou à stocker.
| note |
|---|
| NOTE |
| La configuration de cette connexion nécessite deux visites au centre d’administration Microsoft Entra. Vous enregistrez d’abord l’application, puis vous créez la connexion dans Workfront Fusion, et revenez ensuite à Microsoft Entra ID pour ajouter les informations d’identification fédérées. En effet, les informations d’identification fédérées identifient une connexion spécifique et cet identifiant n’existe pas tant que la connexion n’a pas été créée. |
- Conditions préalables à la connexion de Microsoft SharePoint Online à Workfront Fusion à l’aide d’une connexion fédérée
- Création de l’enregistrement de l’application dans Microsoft Entra ID (connexion fédérée)
- Octroi des autorisations d’API (connexion fédérée)
- Collecter les détails de votre connexion (connexion fédérée)
- Création de la connexion dans Workfront Fusion (connexion fédérée)
- Ajout des informations d’identification fédérées dans l’ID Microsoft Entra (connexion fédérée)
- Vérification de la connexion (connexion fédérée)
- Dépannage
Conditions préalables à la connexion de Microsoft SharePoint Online à Workfront Fusion à l’aide d’une connexion fédérée
Vous avez besoin d’un accès d’administrateur global, d’administrateur d’application ou d’administrateur de rôle privilégié dans Microsoft Entra ID pour enregistrer l’application, lui accorder des autorisations et ajouter les informations d’identification fédérées. Si vous ne disposez pas de cet accès, demandez à un membre de votre équipe informatique ou d’identité d’effectuer ces étapes pour vous.
Création de l’enregistrement de l’application dans Microsoft Entra ID (connexion fédérée)
- Connectez-vous au centre d’administration Microsoft Entra.
- Accédez à Enregistrements des applications > Nouvel enregistrement.
- Donnez à l’application un nom clair et reconnaissable. Par exemple,
Workfront Fusion SharePoint Integration. - Laissez l’URI de redirection vide. Cette connexion n’implique aucune connexion via un navigateur.
- Sélectionnez Enregistrer.
Ne créez pas de secret client. Une connexion fédérée n’en utilise pas. - Continuez pour accorder des autorisations d’API.
Octroi des autorisations d’API (connexion fédérée)
- Dans l’enregistrement de votre application, accédez à Autorisations d’API.
- Sélectionnez Ajouter une autorisation, puis sélectionnez Graphique Microsoft.
- Sélectionnez Autorisations d’application.
- Sélectionnez la ou les autorisations dont vos appels API ont besoin, puis sélectionnez Ajouter des autorisations.
- Sélectionnez Accorder le consentement administrateur pour votre organisation, puis confirmez.
- Continuez pour Collecter les détails de votre connexion.
Collecter les détails de votre connexion (connexion fédérée)
-
Sur la page Aperçu de l’enregistrement de l’application, notez les valeurs suivantes. Vous les saisissez lors de la création de la connexion dans le module .
table 0-row-2 1-row-2 layout-auto html-authored no-header Tenant ID Sur la page Aperçu , intitulé ID de répertoire (client). Client ID Sur la page Aperçu , intitulé ID d’application (client).
Création de la connexion dans Workfront Fusion (connexion fédérée)
-
Dans le module Effectuer un appel API , cliquez sur b près du champ Connexion pour ouvrir la zone Créer une connexion .
-
Cliquez sur (Connexion fédérée).
-
Dans le champ Type de connexion , sélectionnez le type de connexion fédérée .
-
Saisissez les informations suivantes :
- Identifiant du tenant
- ID client
-
Sélectionnez Créer.
Workfront Fusion affiche trois valeurs. Vous les utiliserez dans la procédure suivante.table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header Issuer Toujours https://oidc.automations.adobe.com.Subject Identifie cette connexion. On dirait fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964. Il est différent pour chaque connexion que vous créez.Audience Toujours api://AzureADTokenExchange. -
Laissez ce panneau ouvert et copiez la valeur Objet.
note NOTE Ne fermez pas le panneau et ne sélectionnez pas Annuler. La connexion n'est pas terminée tant que vous n'avez pas terminé les procédures restantes. Si vous fermez le panneau, vous devez supprimer la connexion et recommencer, car une nouvelle connexion reçoit un nouvel objet. -
Passez à Ajouter les informations d’identification fédérées dans l’ID Microsoft Entra .
Ajout des informations d’identification fédérées dans l’ID Microsoft Entra (connexion fédérée)
Cette procédure remplace le secret client. Il indique à Microsoft Entra ID d’accepter les jetons que Workfront Fusion rencontre pour cette connexion.
-
Dans un nouvel onglet du navigateur, revenez au centre d’administration Microsoft Entra et ouvrez votre enregistrement d’application.
-
Accédez à Certificats et secrets > Federated credentials.
-
Sélectionnez Ajouter des informations d’identification.
-
Dans le scénario Federated Credential, sélectionnez Autre émetteur.
-
Saisissez les informations suivantes :
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Issuer https://oidc.automations.adobe.com.Identifiant de l'objet Objet copié à partir de Workfront Fusion. Collez-le exactement, sans espace ajouté. Name Nom qui identifie cette connexion afin que vous puissiez la trouver ultérieurement. Par exemple, workfront-fusion-connection-28964.Audience api://AzureADTokenExchange. Ce champ est généralement renseigné pour vous. Laissez la valeur par défaut. -
Sélectionnez Ajouter.
-
Passez à Vérifier la connexion.
Vérification de la connexion (connexion fédérée)
-
Revenez à l’onglet du navigateur de Workfront Fusion, où le panneau de connexion est toujours ouvert.
-
Sélectionnez Enregistrer.
- Si tout est configuré correctement, la connexion est validée avec succès et vous pouvez poursuivre la configuration du module.
- Si la vérification échoue, le panneau reste ouvert et affiche l’erreur. Corrigez le problème dans Microsoft Entra ID et sélectionnez à nouveau Enregistrer. Vous n’avez pas besoin de recréer la connexion et l’objet ne change pas.
Dépannage
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| La vérification de la connexion échoue avec un client non valide ou une erreur de requête non valide | L’ID Microsoft Entra n’a pas pu faire correspondre le jeton à des informations d’identification fédérées. Vérifiez que l'émetteur est exactement https://oidc.automations.adobe.com sans barre oblique, et que l'identifiant du sujet est caractère pour caractère identique au sujet affiché dans Workfront Fusion. Un objet copié à partir d’une autre connexion est la cause la plus courante. |
| La connexion vérifie, mais les appels API renvoient la valeur 403 | L’identité est approuvée, mais l’application ne dispose pas des autorisations Microsoft Graph dont votre appel a besoin. Revenez à Accorder les autorisations d’API, ajoutez l’autorisation d’application requise et accordez le consentement administrateur. |
| Vous ne pouvez pas ajouter d’autres informations d’identification fédérées | Vous avez atteint la limite de 20 informations d’identification fédérées pour cet enregistrement d’application. Enregistrez une application supplémentaire et créez d’autres connexions. |
Modules SharePoint Microsoft et leurs champs
Lorsque vous configurez les modules Microsoft SharePoint Online, Workfront Fusion affiche les champs répertoriés ci-dessous. D’autres champs Microsoft SharePoint Online peuvent s’afficher, selon des facteurs tels que votre niveau d’accès dans l’application ou le service. Un titre en gras dans un module indique un champ obligatoire.
Si le bouton « Mapper » apparaît au-dessus d’un champ ou d’une fonction, vous pouvez l’utiliser pour définir des variables et des fonctions pour ce champ. Pour plus d’informations, consultez Mappage d’informations d’un module à l’autre.
Élément Drive
Créer un fichier
Ce module renvoie la création d’un fichier dans SharePoint. Ce module est plus performant que le module Créer un fichier (hérité).
Créer un fichier (hérité)
Ce module permet de créer un fichier dans SharePoint.
Pour de meilleures performances, il est recommandé d’utiliser le module Créer un fichier.
Créer un dossier
Ce module d’action crée un dossier dans SharePoint.
Obtenir un fichier
Ce module d’action récupère le fichier SharePoint spécifié.
Obtenir un dossier
Ce module a récupéré des détails sur le dossier spécifié
Mettre à jour un dossier ou un fichier
Ce module d’action met à jour les métadonnées d’un dossier ou d’un fichier
Éléments du dossier de contrôle
Ce module de déclenchement lance un scénario lorsqu’un élément est mis à jour dans un dossier que vous sélectionnez.
Élément
Copier un élément
Ce module d’action copie un élément existant dans une liste SharePoint.
Créer un élément
Ce module d’action crée un élément dans une liste SharePoint.
Supprimer un élément
Ce module d’action supprime un élément existant dans une liste SharePoint.
Obtenir un élément
Ce module d’action renvoie les données d’un élément spécifié.
Obtenir des détails
Ce module obtient les détails de l’élément à partir de l’URL spécifiée.
Éléments de liste
Ce module d’action récupère une liste de tous les éléments d’une liste spécifiée.
Déplacer un élément
Ce module d’action copie un élément existant dans une liste SharePoint.
Mettre à jour un élément
Ce module d’action met à jour un élément existant dans une liste SharePoint.
Éléments de contrôle (Planifié)
Ce module de déclenchement lance un scénario lorsqu’un élément est créé ou modifié.
Liste
Créer une liste
Ce module d’action crée une liste dans SharePoint.
Obtenir une liste
Ce module d’action renvoie les données d’une liste spécifiée.
Répertorier des listes
Ce module d’action récupère une liste de tous les éléments d’un site spécifié.
Surveiller des listes
Ce module de déclenchement lance un scénario lorsqu’une liste est créée ou modifiée.
Page (Beta)
beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans les applications de production n’est pas prise en charge.Obtenir une page
Ce module d’action renvoie les données d’une page spécifique.
Pages de liste
Ce module récupère une liste de toutes les pages.
Publier une page
Ce module d’action publie la dernière version de la page sélectionnée.
Pages Espion
Ce module de déclenchement lance un scénario lorsqu’une page est modifiée sur le site spécifié.
Site
Obtenir un site
Ce module d’action renvoie les données d’un site spécifié.
Rechercher des sites
Ce module d’action recherche des sites en fonction d’un paramètre que vous spécifiez.
Autre
Obtenir les modifications
Ce module récupère les ajouts, les mises à jour et les suppressions effectués dans le dossier SharePoint.
Effectuer un appel API
Ce module vous permet d’effectuer un appel API personnalisé.
Surveiller les événements
Ce module de déclenchement instantané démarre un scénario lorsqu’un élément est ajouté, mis à jour ou supprimé dans SharePoint.