- Vue d'ensemble (Overview)
- Excel
- Notes de publication
- À propos du package d'activités Excel
- Compatibilité du Projet
- Codage de caractères pris en charge
- Paramètres du projet
- Ajouter ou mettre à jour le libellé de confidentialité Excel (Add or Update Excel Sensitivity Label)
- Ajouter la plage (Append Range)
- Auto Fill
- Plage d’ajustement automatique
- Change Pivot Data Source
- Clear Sheet/Range/Table
- Copy/Paste Range
- Create Pivot Table
- Supprimer la colonne (Delete Column)
- Delete Rows
- Supprimer la feuille
- Duplicate Sheet
- Export to CSV
- Fill Range
- Filtrer (Filter)
- Filter Pivot Table
- Find First/Last Data Row
- Valeur Rechercher/Remplacer
- For Each Excel Row
- For Each Excel Sheet
- Formater en tant que table
- Format Cells
- Get Cell Color
- Obtenir un graphique Excel
- Obtenir le libellé de confidentialité Excel (Get Excel Sensitivity Label)
- Get Selected Range
- Insérer la colonne (Insert Column)
- Insert Chart
- Insert Rows
- Insert Sheet
- Appeler VBA (Invoke VBA)
- Recherche
- Match function
- Protect Sheet
- Lire la formule de cellule (Read Cell Formula)
- Read Cell Value
- Lire la plage (Read Range)
- Actualiser les données de connexion Excel
- Refresh Pivot Table
- Supprimer les doublons
- Rename Sheet
- Run Spreadsheet Macro
- Save Excel File
- Save Excel File As
- Save Excel File As PDF
- Sélectionner la plage (Select Range)
- Sort Range
- Text to Columns
- Unprotect Sheet
- Mettre à jour un graphique Excel
- Utiliser le fichier Excel
- VLookup
- Écrire la cellule (Write Cell)
- Écrire un fichier CSV (Write CSV)
- Écrire un objet DataTable dans Excel
- Étendue d'application Excel (Excel Application Scope)
- Ajouter au fichier CSV (Append To CSV)
- Lire un fichier CSV (Read CSV)
- Écrire un fichier CSV (Write CSV)
- Supprimer la colonne (Delete Column)
- Filtrer la table (Filter Table)
- Obtenir la plage de tables (Get Table Range)
- Insérer la colonne (Insert Column)
- Trier la table (Sort Table)
- Ajouter la plage (Append Range)
- Fermer le classeur (Close Workbook)
- Get Cell Color
- Lire la cellule (Read Cell)
- Lire la formule de cellule (Read Cell Formula)
- Lire la colonne (Read Column)
- Lire la plage (Read Range)
- Lire la ligne (Read Row)
- Sélectionner la plage (Select Range)
- Définir la couleur de plage (Set Range Color)
- Écrire la cellule (Write Cell)
- Écrire la plage (Write Range)
- Enregistrer le classeur (Save Workbook)
- Create Table
- Get Workbook Sheet
- Get Workbook Sheets
- Refresh Pivot Table
- Create Pivot Table
- Get Selected Range
- Copy Sheet
- Delete Range
- Auto Fill Range
- Copy Paste Range
- Exécuter la macro (Execute Macro)
- Insert/Delete Columns
- Insert/Delete Rows
- Appeler VBA (Invoke VBA)
- LookUp Range
- Remove Duplicates Range
- Excel Process Scope
- Gérer les fichiers CSV
- Filtrer les fichiers CSV
- Vérifier les fichiers CSV
- Fonctiones de table
- Gérer plusieurs fichiers Excel
- Interpréter les résultats Excel
- Gérer les tableaux croisés dynamiques
- Gérer la sélection de la plage
- Lire à partir de fichiers Excel
- Gérer les bases de données dans Excel
- Comparer des fichiers CSV
- Comparer des valeurs numériques
- Trier les données dans les fichiers Excel
- Filtrer et supprimer des lignes dans les fichiers Excel
- Manipuler les sélections de plage
- Vérifier les données du classeur Excel
- Lire, écrire et ajouter des données dans Excel
- Google Workspace
- Notes de publication
- À propos du package d'activités Google Workspace
- Compatibilité du projet
- Demande HTTP (HTTP Request)
- Copier le fichier (Copy File)
- Get File List
- Créer un dossier (Create Folder)
- Delete File/Folder
- Télécharger le fichier
- For Each File/Folder
- Get File/Folder
- Déplacer le fichier (Move File)
- Share File/Folder
- Upload Files
- Apply File Labels
- Remove File Labels
- Obtenir les libellés de fichier (Get File Labels)
- Effacer les champs de libellé du fichier (Clear File Label Fields)
- Obtenir les libellés du Drive (Get Drive Labels)
- Archiver un e-mail
- Supprimer un e-mail
- Download Email
- Download Email Attachments
- Get Email List
- Pour chaque e-mail
- Transférer un e-mail
- Get Email By Id
- Get Newest Email
- Marquer un e-mail comme lu/non-lu
- Move Email
- Répondre à un e-mail
- Envoyer un e-mail
- Appliquer des libellés Gmail (Apply Gmail Labels)
- Supprimer les libellés Gmail (Remove Gmail Labels)
- Activer les réponses automatiques (Turn On Automatic Replies)
- Désactiver les réponses automatiques (Turn Off Automatic Replies)
- Add Sheet
- Create Spreadsheet
- Pour chaque feuille dans Feuille de calcul (Spreadsheet)
- Pour chaque ligne de la feuille de calcul
- Rename Sheet
- Supprimer la feuille
- Lire la cellule (Read Cell)
- Écrire la cellule (Write Cell)
- Lire la plage (Read Range)
- Écrire la plage (Write Range)
- Delete Range
- Ligne d'écriture (Write Row)
- Write Column
- Delete Rows
- Supprimer la colonne (Delete Column)
- Événement de calendrier créé
- Événement de calendrier reçu
- Événement du calendrier (Calendar Event) mis à jour
- Réponse à l'événement de calendrier
- Fichier créé
- Dossier créé
- Fichier mis à jour
- E-mail reçu
- E-mail envoyé
- Feuille créée (Sheet Created)
- Cellule de la feuille mise à jour (Cell in Sheet Updated)
- Ligne ajoutée en bas d'une feuille (Row Added to the Bottom of a Sheet)
- Tâche créée
- Tâche terminée
- Connexions
- Add Sheet
- AjouterFeuilleCalcul
- Supprimer la colonne (Delete Column)
- Delete Range
- Delete Rows
- Supprimer la feuille
- GetNamedRanges
- Get Ranges
- Récupérer des feuilles (Get Sheets)
- ObtenirFeuillesCalcul
- Lire la cellule (Read Cell)
- Lire la plage (Read Range)
- Rename Sheet
- Écrire la cellule (Write Cell)
- Write Column
- Écrire la plage (Write Range)
- Ligne d'écriture (Write Row)
- Options
- Apply File Labels
- Effacer les champs de libellé du fichier (Clear File Label Fields)
- Copy File
- Créer un dossier (Create Folder)
- Supprimer l'élément
- Télécharger le fichier
- Obtenir les libellés du Drive (Get Drive Labels)
- Get File
- Obtenir les libellés de fichier (Get File Labels)
- Get Files
- GetFilesandFolders
- Get Folder
- Obtenir les dossiers
- Obtenir un élément
- Move File
- Move Folder
- RefreshFile
- ActualiserDossier
- RefreshItem
- Remove File Labels
- Share File
- Partager le dossier
- Upload File
- Upload Files
- Options
- Appliquer les libellés
- Archiver un e-mail
- Supprimer un e-mail
- Download Email
- Télécharger la pièce jointe d'e-mail
- Download Email Attachments
- Transférer un e-mail
- Get Email
- Obtenir les infos des pièces jointes de l'e-mail
- Get Emails
- Get Mail Labels
- Get Newest Email
- Mark Email As Read
- MarquerEmailCommeNonLu
- Move Email
- Supprimer les libellés
- Reply To Email
- Envoyer un e-mail
- Désactiver les réponses automatiques (Turn Off Automatic Replies)
- Activer les réponses automatiques (Turn On Automatic Replies)
- Options
- Add Attendee
- Créer un événement
- Supprimer l'événement
- Modify Event
- Search Events
- Use Google Drive
- Share File
- Delete File Permission
- Get File Permissions
- Update File Permission
- Copier le fichier (Copy File)
- Créer un dossier (Create Folder)
- Delete File
- Télécharger le fichier
- Rechercher des fichiers et des dossiers (Find Files and Folders)
- Obtenir des informations sur les fichiers
- Déplacer le fichier (Move File)
- Télécharger le fichier
- Create Document
- Create New Spreadsheet
- Récupérer les messages électroniques (Get Mail Messages)
- Envoyer des messages électroniques
- Modifier les libellés
- Use Google Spreadsheet
- Add Delete Columns
- Add Delete Rows
- Auto Fill Range
- Ajouter une feuille (Add New Sheet)
- Append Row
- Batch Spreadsheet Updates
- Copy Sheet
- Copy Paste Range
- Delete Range
- Supprimer la feuille
- Get Cell Color
- Récupérer des feuilles (Get Sheets)
- Lire la cellule (Read Cell)
- Lire la colonne (Read Column)
- Lire la plage (Read Range)
- Lire la ligne (Read Row)
- Rename Sheet
- Écrire la cellule (Write Cell)
- Écrire la plage (Write Range)
- Clear Range
- Download Spreadsheet
- Use Google Document
- Batch Document Updates
- Get Document
- Get Text Index
- Insert Text
- Remplacer le texte (Replace Text)
- Read All Text
- Create Script Project
- Get Project Content
- Upload Script File
- Create Deployment
- Run Script
- Courrier (Mail)
- Notes de publication
- Compatibilité du Projet
- Étendue Exchange (Exchange Scope)
- Supprimer le message électronique Exchange (Delete Exchange Mail Message)
- Obtenir les messages électroniques Exchange (Get Exchange Mail Messages)
- Déplacer le message électronique Exchange (Move Exchange Mail Message)
- Envoyer le message électronique Exchange (Send Exchange Mail Message)
- Microsoft 365
- Notes de publication
- About the Microsoft 365 activity package
- How to connect to Microsoft 365 activities
- Compatibilité du projet
- Demande HTTP (HTTP Request)
- Create Workbook
- Add Sheet
- Supprimer la feuille
- Lire la cellule (Read Cell)
- Écrire la cellule (Write Cell)
- Lire la plage (Read Range)
- Écrire la plage (Write Range)
- Delete Range
- Rename Sheet
- Pour chaque ligne du classeur
- Ligne d'écriture (Write Row)
- Pour chaque feuille dans Classeur (Workbook)
- Write Column
- Delete Rows
- Supprimer la colonne (Delete Column)
- Supprimer un e-mail
- Archiver un e-mail
- Get Email List
- Download Email
- Download Email Attachments
- Pour chaque e-mail
- Transférer un e-mail
- Get Email By ID
- Get Newest Email
- Mark Email as Read/Unread
- Move Email
- Répondre à un e-mail
- Envoyer un e-mail
- Set Email Categories
- Activer les réponses automatiques (Turn On Automatic Replies)
- Désactiver les réponses automatiques (Turn Off Automatic Replies)
- Fichier créé
- Fichier mis à jour
- E-mail reçu
- E-mail envoyé
- Événement de calendrier créé
- Événement de calendrier reçu
- Réponse à l'événement de calendrier
- Événement du calendrier (Calendar Event) mis à jour
- List Item Added
- List Item Updated
- Cellule de la feuille de calcul mise à jour (Cell in Worksheet Updated)
- Feuille de calcul créée
- Ligne ajoutée en bas d'une table
- Connexions
- Add Sheet
- AjouterClasseur
- Supprimer la colonne (Delete Column)
- Delete Range
- Delete Rows
- Supprimer la feuille
- GetNamedRanges
- Get Ranges
- Récupérer des feuilles (Get Sheets)
- ObtenirClasseurs
- Lire la cellule (Read Cell)
- Lire la plage (Read Range)
- Rename Sheet
- Écrire la cellule (Write Cell)
- Write Column
- Écrire la plage (Write Range)
- Ligne d'écriture (Write Row)
- AjouterCatégoriesE-mail
- Archiver un e-mail
- Supprimer un e-mail
- Download Email
- Télécharger la pièce jointe d'e-mail
- Download Email Attachments
- Transférer un e-mail
- Get Email
- Obtenir les infos des pièces jointes de l'e-mail
- Get Emails
- ObtenirDossiersE-mail
- Get Newest Email
- Mark Email As Read
- MarquerEmailCommeNonLu
- Move Email
- SupprimerCatégoriesE-mail
- Reply To Email
- Envoyer un e-mail
- Désactiver les réponses automatiques (Turn Off Automatic Replies)
- Activer les réponses automatiques (Turn On Automatic Replies)
- Fusionner plusieurs feuilles dans une nouvelle feuille Excel récapitulative
- Accepter automatiquement les invitations d'agenda de votre gestionnaire
- Déplacer les fichiers vers des dossiers dédiés par type
- Vérifier si les nouveaux documents d'emploi (I9 et ID) correspondent
- Ajouter de nouveaux clients à une liste SharePoint
- Supprimer les éléments de la liste SharePoint plus récents qu'hier
- M'avertir sur Slack lorsqu'un e-mail Outlook important est reçu
- Inclure la date de création dans les nouveaux noms de fichiers OneDrive
- M'avertir par e-mail lorsqu'un nouveau fichier est créé
- Microsoft Office 365 Scope
- Add Sheet
- Ajouter la plage (Append Range)
- Clear Range
- Copy Range
- Copy Sheet
- Create Workbook
- Delete Range
- Supprimer la feuille
- Get Cell Color
- Récupérer des feuilles (Get Sheets)
- Lire la cellule (Read Cell)
- Lire la colonne (Read Column)
- Lire la plage (Read Range)
- Lire la ligne (Read Row)
- Rename Sheet
- Écrire la cellule (Write Cell)
- Écrire la plage (Write Range)
- Définir la couleur de plage (Set Range Color)
- Create Table
- Obtenir la plage de tables (Get Table Range)
- Insérer la colonne (Insert Column)
- Supprimer la colonne (Delete Column)
- Insert Rows
- Delete Rows
- VLookup Range
- Use OneDrive & SharePoint
- Copy File/Folder
- Créer un dossier (Create Folder)
- Delete File/Folder
- Télécharger le fichier
- Export File as PDF
- Find Files And Folders
- Get File/Folder
- Move File/Folder
- Télécharger le fichier
- Partager un fichier/dossier
- For Each File/Folder
- Forward Mail
- Get Mail
- Move Mail
- Send Mail
- Reply to Mail
- Supprimer l'e-mail
- Définir les catégories d’e-mail
- Add Attachment
- Add Attendee
- Ajouter un emplacement
- Créer un événement
- Supprimer l'événement
- Find Meeting Times
- Get Calendars
- Modify Event
- RSVP
- Search Events
- Create Group
- Supprimer le groupe
- Get Group
- List Groups
- Create Bucket
- Delete Bucket
- List Buckets
- List Bucket Tasks
- Create Plan
- Get Plan
- List Plans
- Create Task
- Delete Task
- Get Task
- List Tasks
- Update Task
- For Each List
- Get List Info
- For Each List Item
- Delete List Item
- Add List Items
- Update List Item
- Get List Items
- Présentation
- Notes de publication
- À propos du package d’activités Presentations
- Compatibilité du Projet
- Ajouter ou mettre à jour le libellé de confidentialité PowerPoint (Add or Update PowerPoint Sensitivity Label)
- Add Data Table to Slide
- Add File to Slide
- Ajouter une image ou une vidéo à la diapositive
- Add New Slide
- Add Text to Slide
- Copy Paste Slide
- Delete Slide
- Formater le contenu de la diapositive
- Obtenir le libellé de confidentialité PowerPoint (Get PowerPoint Sensitivity Label)
- Replace Text in Presentation
- Coller un élément dans une diapositive
- Run Presentation Macro
- Save PowerPoint File As
- Save Presentation as PDF
- Utiliser une présentation PowerPoint
- Word
- Notes de publication
- À propos du package d'activités Word
- Compatibilité du Projet
- Fonctionnalités de l'application Word/Utiliser un fichier Word
- Ajouter ou mettre à jour le libellé de confidentialité Word (Add or Update Word Sensitivity Label)
- Add Hyperlink to Document
- Add Picture
- Ajouter un texte (Append Text)
- Obtenir le libellé de confidentialité Word (Get Word Sensitivity Label)
- Insert DataTable in Document
- Paste Chart/Picture into Document
- Lire le texte (Read Text)
- Replace Picture
- Replace Text in Document
- Save Document As
- Save Document as PDF
- Définir le contenu du signet (Set Bookmark Content)
Microsoft Office 365 Scope
UiPath.MicrosoftOffice365.Activities.Office365ApplicationScope
Utilise la Plateforme d’identités Microsoft pour établir une connexion authentifiée entre UiPath et votre application Microsoft 365. Cette connexion authentifiée permet à un Robot d'appeler l'API Microsoft Graph pour lire et écrire des ressources en votre nom.
Pour établir votre connexion authentifiée, vous devez d'abord enregistrer votre application Microsoft 365 dans votre Azure Active Directory (à l'aide de votre compte Microsoft 365 personnel, professionnel et/ou scolaire). Lors de l'enregistrement de votre application, vous attribuez les autorisations de l'API Microsoft Graph qui indiquent les ressources auxquelles un robot peut accéder en votre nom.
Après avoir enregistré votre application Microsoft 365, Azure Active Directory lui attribue un identifiant d'application (client) unique que vous saisissez dans l'activité Étendue Microsoft 365 ( Microsoft 365 Scope ). L' ID d'application (Application ID) est utilisé pour collecter les informations nécessaires sur votre application enregistrée afin d'initier l'authentification.
Pour en savoir plus sur l'enregistrement de votre application et l'attribution d'autorisations, consultez le Guide de Configuration (Setsp). Ce guide fournit des instructions étape par étape pour configurer votre application Microsoft 365 pour l'automatisation.
Type d’authentification |
En tant qu'utilisateur |
En tant qu'application (exécutée en tant que service d'arrière-plan) |
Assisté (Attended) |
Non assisté (Unattended) |
Unattended (MFA activé) |
Détails (Details) |
---|---|---|---|---|---|---|
Jeton interactif |
Vous avez la possibilité d'enregistrer et d'utiliser votre propre application Azure AD (c'est-à-dire
OAuthApplication = Custom ) ou celle fournie par UiPath (OAuthApplication = UiPath ).
| |||||
IntegratedWindowsAuthentication |
Fonctionne uniquement pour les utilisateurs fédérés et si votre application Azure enregistrée est configurée pour prendre en charge IWA. Ne fonctionne pas pour l'authentification multifacteur (MFA). Voir les détails ici : IWA sur GitHub | |||||
UsernameAndPassword |
Non recommandé, fourni uniquement pour des raisons héritées (cela va à l'encontre des principes de l'authentification moderne). Cela ne fonctionne pas pour l'authentification multifacteur (MFA). Voir les détails ici : Utilisateur et mot de passe sur GitHub | |||||
ID d’application et Clé secrète |
Recommandé pour les exécutions Unattended ou lorsque vous souhaitez accéder à l'API Microsoft Graph en tant qu'application (un service/démon en arrière-plan) sans utilisateur connecté. | |||||
IDApplication et Certificat |
Disponible à partir de la v1.9.0. Très similaire à l'ID d'application et à la clé secrète. La seule différence est l'utilisation d'un certificat en tant que clé secrète au lieu d'une chaîne secrète cliente. Consultez la documentation officielle. |
- Méthode de connexion (Connection method) : sélectionnez la méthode de connexion que vous souhaitez utiliser. Les options disponibles dans le menu déroulant sont les suivantes :
- Panneau Propriétés (Properties) : configurez les détails de connexion dans le panneau Propriétés (Properties).
- Ressource : utilise les ressources d’identification Orchestrator. Nous vous recommandons d'utiliser cette option.
Lorsque vous sélectionnez cette option, les champs d'authentification affichés dans l'option Panneau de propriétés (Properties Panel) sont masqués, car toutes les informations d'authentification sont stockées à l'intérieur de la ressource.
- Ressources de connexion ( Connection assets ) : parcourez les dossiers Orchestrator pour sélectionner une ressource. Ce champ prend en charge les variables
IResource
. Sélectionnez le bouton Gérer les ressources (Manage Assets ) pour ouvrir Orchestrator. La liste des ressources disponibles dépend de l'Orchestrator auquel votre Studio et votre Robot sont connectés.- Utilisez le bouton Plus pour sélectionner Recharger les ressources ( Reload Assets ) si vous avez mis à jour vos ressources dans Orchestrator. Notez que si vous ajoutez une nouvelle ressource dans Orchestrator alors que vous utilisez Studio Desktop, elle ne sera pas immédiatement disponible dans l’activité Étendue (Scope).
Consultez le format de ressource dans la section Comment utiliser les activités Microsoft 365 sans connexion Integration Service.
Authentification
- Adresse e-mail de l'utilisateur dont l'identité est utilisée : l'adresse e-mail de l'utilisateur dont l'identité est utilisée. Utilisé pour les autorisations d’application.
Nom d’utilisateur et mot de passe (Unattended)
- Nom d'utilisateur (Username) : nom d'utilisateur de votre compte Microsoft 365.
- Mot de passe (Password) : mot de passe de votre compte Microsoft 365.
Commun
- DélaiAttenteMillisecondes : indique le délai d’attente (en millisecondes) pour que l’authentification interactive (boîte de dialogue de consentement) se termine avant qu’une erreur ne soit générée. Ce champ ne prend en charge que les entiers et les variables
Int32
. La valeur par défaut est de 30 000 ms (30 secondes).
Runtime
- Ressources de connexion du runtime ( Runtime connection assets ) : recherchez pour sélectionner une ressource. Ce champ vous permet de sélectionner une ressource différente pour l'exécution. Utilisez le bouton Plus pour sélectionner Chemin relatif ( Relative path ) et entrez le chemin d'accès complet de la ressource Orchestrator contenant les détails de connexion.
- Connexions ( Connections) - Sélectionnez un compte dans la liste. Vous pouvez ajouter, supprimer et choisir les connexions à utiliser.
- Étendues d'authentification ( Authentication Scopes ) : consultez la section de l' assistant Utilisation des étendues d'authentification (Using the Authentication Scopes ) ci-dessous.
Utilisation de l'assistant Étendues d'authentification (Authentication Scopes)
L'activité Étendue (Scope) intègre un sélecteur universel d'autorisations, offrant une image claire de toutes les étendues d'authentification utilisées, dont les activités ont besoin pour fonctionner correctement.
Si aucune étendue n'est sélectionnée manuellement dans l'assistant Étendues, la fonction de détection automatique sera appliquée par défaut au moment de l'exécution et il ne sera pas nécessaire de configurer l'assistant. Toutes les étendues minimales requises seront sélectionnées lors de l'exécution.
Vous pouvez également ajouter une étendue manuellement après avoir ajouté une activité enfant à Microsoft 365 Application Scope.
- Type d'authentification (Authentication Type ) - Le type d'authentification requis pour votre application enregistrée. Sélectionnez l'une des cinq options : InteractiveToken, IntegratedWindowsAuthentication, UsernameAndPassword, ApplicationIdAndSecret ou ApplicationIdAndCertificate. La valeur par défaut est InteractiveToken. Pour plus d'informations sur ces options et savoir laquelle sélectionner, consultez la section Automatisation assistée par rapport à l'automatisation Unattended ci-dessous.
- Environnement - L'environnement, qu'il s'agisse de clouds Azure Global ou nationaux et étant des environnements uniques et distincts d'Azure Global. Sélectionnez l'une des cinq options suivantes : Par défaut (Default), Global, Chine, Allemagne ou USGoverment. La valeur par défaut est Global.
- ID d'application : l'ID d'application (client) unique attribué par Azure Active Directory lorsque vous avez enregistré votre application lors de la Configuration (Setup). L'ID d'application (client) représente une instance d'une application Microsoft 365. Une même organisation peut avoir plusieurs ID d'application (client) pour son compte Microsoft 365. Chaque ID d'application (client) contient ses propres autorisations et exigences d'authentification. Par exemple, vous et votre collègue pouvez tous les deux enregistrer une application Microsoft 365 dans l'annuaire Azure Active Directory de votre entreprise avec des autorisations différentes. Votre application peut être configurée pour accorder des autorisations en vue d'interagir uniquement avec les fichiers, tandis que l'application de votre collègue est configurée pour accorder des autorisations en vue d'interagir avec les fichiers, la messagerie et l'agenda. Si vous entrez votre ID d'application (client) dans cette propriété et exécutez une automatisation Attended, la boîte de dialogue de consentement sera limitée aux autorisations de fichiers (et par la suite, seules les activités de Fichiers (Files) peuvent être utilisées).
- Locataire (Tenant) - ID d'annuaire (locataire) d'annuaire unique attribué par Azure Active Directory lorsque vous avez enregistré votre application lors de la Configuration ( Setup). Requis pour les applications multilocataires et IntegratedWindowsAuthentication. L'ID d'annuaire (locataire) se trouve sur la page Aperçu (Overview) de votre application enregistrée (sous l'ID d'application (client)).
- Adresse e-mail de l'utilisateur dont l'identité est utilisée : l'adresse e-mail de l'utilisateur dont l'identité est utilisée.
Commun
- DélaiAttenteMillisecondes : indique le délai d’attente (en millisecondes) pour que l’authentification interactive (boîte de dialogue de consentement) se termine avant qu’une erreur ne soit générée. Ce champ ne prend en charge que les entiers et les variables
Int32
. La valeur par défaut est de 30 000 ms (30 secondes) (non affichée). - ContinuerSurErreur (ContinueOnError) - indique s'il faut poursuivre l'exécution des activités restantes, même si l'activité actuelle a échoué.
-
ApplicationOAuth - indique l'application (client) à utiliser. Si
UiPath
est sélectionné, les clés IDApplication et Tenant sont ignorées. Ce champ prend uniquement en charge les variablesOAuthApplication
. Sélectionnez l'une des options suivantes :- UiPath - Par défaut. Lorsque vous souhaitez utiliser l'application créée par UiPath. Dans ce cas, les valeurs des paramètres ID d'application ( Application ID ) et Locataire (Tenant) sont ignorées.
- Personnalisé (Custom ) : lorsque vous souhaitez créer votre propre application avec les autorisations appropriées. Dans ce cas, une valeur doit être définie pour le paramètre ID d'application .
-
Certificat en Base64 (Certificate As Base64 ) - La représentation Base64 du certificat. Requis si le Type d’authentification est défini sur ID d’application et Certificat.
- Mot de passe du certificat ( Certificate Password ) - Un mot de passe facultatif qui peut être requis pour utiliser le certificat, en tant que
Secure String
.
- Clé secrète de l' application (Application Secret) - Chaîne secrète utilisée par l'application pour fournir son identité. Requis si le Type d'authentification est défini sur ID d'application et Clé secrète.
- Clé secrète de l'application sécurisée (Secure Application Secret) - La clé secrète de l'application (cliente), sous la forme d'un
SecureString
.
Ces propriétés s'appliquent lorsque vous exécutez une automatisation Unattended uniquement. Lorsque vous indiquez les valeurs de ces propriétés, assurez-vous que le Type d'authentification (Authentication Type) est défini sur Nom d'utilisateur (Username) et Mot de passe (Password). Pour plus d'informations, consultez la section Nom d'utilisateur et mot de passe ci-dessous.
- Mot de passe (Password) : mot de passe de votre compte Microsoft 365.
- MotDePasseSécurisé : le mot de passe de votre compte Microsoft 365, sous la forme d'un
SecureString
. - Nom d'utilisateur (Username) : nom d'utilisateur de votre compte Microsoft 365.
Les étapes et le diagramme de séquence de messages suivants illustrent le fonctionnement de l'activité, depuis la conception (c'est-à-dire les dépendances d'activité et les propriétés d'entrée/sortie) jusqu'à l'exécution.
- Terminez les étapes de configuration .
- Ajoutez l’activité Étendue Microsoft Office 365 à votre projet.
-
Entrez des valeurs pour les propriétés Authentification, Entréeet Unattended (le cas échéant) .
L’activité Étendue Microsoft 365 dispose de quatre flux d’authentification différents (Types d’authentification (Authentication Types)) que vous pouvez choisir lors de l’ajout de l’activité à votre projet. Votre sélection dépend du type de mode d'automatisation que vous prévoyez d'exécuter (Unattended ou Attended) et les exigences d'authentification de votre application (consultez votre administrateur si vous ne savez pas quelles exigences d'authentification s'appliquent à votre application).
AuthenticationType |
Assisté (Attended) |
Non assisté (Unattended) |
Type d'autorisation API |
---|---|---|---|
Jeton interactif | X |
Autorisations déléguées | |
IntegratedWindowsAuthentication | X |
Autorisations déléguées | |
UsernameAndPassword | X |
Autorisations déléguées | |
ID d’application et Clé secrète | X |
Autorisations de l'application | |
IDApplication et Certificat | X |
Autorisations de l'application |
Les types d'authentification intégrée de l'authentification Windows ou du nom d'utilisateur et du mot de passe ne fonctionnent pas lorsque l'authentification multifacteur (MFA) est activée. Si votre application nécessite une MFA, vous pouvez exécuter une automatisation assistée à l'aide du type d'authentification par jeton interactif ou une automatisation non assistée à l'aide de l'ID d'application et de la clé secrète de l'application et de son certificat. Les types d'authentification ID d'application et Clé secrète (Application ID) et Certificat (Certificate) sont appropriés pour l'automatisation non assistée et fonctionnent que le MFA soit activé ou désactivé.
Lors de l'enregistrement de votre application, vous devez sélectionner un type d'application. Tenez compte des exigences suivantes :
-
Pour les scénarios Attended (type d'authentification par jeton interactif) et Unattended avec authentification Windows intégrée, utilisez une application mobile/de bureau (qui utilise le flux de code d'autorisation OAuth 2.0).
-
Pour les scénarios Unattended (nom d'utilisateur et mot de passe, ID et clé secrète d'application, ID d'application et Certificat), utilisez une application confidentielle/Web (qui utilise le flux d'informations d'identification client OAuth 2.0).
Jeton interactif
Le type d'authentification par jeton interactif peut être utilisé dans le cadre de l'automatisation assistée et lorsque l'authentification multifacteur (MFA) est requise. C'est l'option par défaut et ce que nous utilisons dans nos exemples. Si vous souhaitez essayer le package d'activités, cette option est facile à configurer et fonctionne bien pour les comptes personnels (en utilisant l'URI de redirection par défaut notée à l'étape 7 de la section Enregistrer votre application du guide de configuration ).
Lorsque l'activité Microsoft 365 est exécutée pour la première fois à l'aide de ce type d'authentification, vous êtes invité à autoriser l'accès aux ressources (à qui vous avez accordé des autorisations lors de l'enregistrement de votre application) via une boîte de dialogue de consentement .
Si vous sélectionnez cette option, les propriétés Nom d'utilisateur ( Username), Motde passe (Password) et Locataire (Tenant) doivent être laissées vides.
IntegratedWindowsAuthentication
Le type d'authentification par authentification Windows intégrée peut être utilisé pour l'automatisation non assistée. Cette option peut s'appliquer aux applications hébergées Windows s'exécutant sur des ordinateurs connectés à un domaine Windows ou à Azure Active Directory.
Vous ne devez sélectionner cette option que si votre application enregistrée est configurée pour prendre en charge l'authentification Windows intégrée (des informations supplémentaires sont disponibles sur GitHub).
Si vous sélectionnez cette option, les propriétés Nom d'utilisateur ( Username ) et Mot de passe (Password) doivent être laissées vides. La propriété Locataire (Tenant) est facultative.
UsernameAndPassword
Le type d'authentification Nom d'utilisateur (Username) et Mot de passe (Password) peut être utilisé pour l'automatisation non assistée (Unattended).
Bien que Microsoft ne le recommande pas, vous pouvez utiliser ce type d'authentification dans les applications clientes publiques. L'utilisation de ce type d'authentification impose des contraintes à votre application. Par exemple, les applications utilisant ce flux ne pourront pas se connecter à un utilisateur qui doit effectuer une authentification multifacteur (accès conditionnel). Cela ne permettra pas non plus à votre application de bénéficier de l’authentification unique.
Si vous sélectionnez cette option, les propriétés Nom d'utilisateur ( Username ) et Mot de passe (Password) sont requises et la propriété Locataire (Tenant) est facultative pour les applications à locataire unique (obligatoire pour les applications à locataires multiples).
ID d’application et Clé secrète
En ce qui concerne l'authentification avec l'ID d'application (client) et la clé secrète d'application (client), gardez à l'esprit ce qui suit :
- Les autorisations d'API appropriées doivent être configurées pour l'application Azure afin que les activités Microsoft 365 fonctionnent correctement (par exemple, les autorisations d'application
Group.Create
,Group.Read.All
etGroup.ReadWrite.All
doivent être configurées pour Microsoft Graph lors de l'utilisation des activités Groupes). - Certaines activités ne peuvent pas être utilisées avec ce type d'authentification, car l'API Microsoft Graph correspondante ne prend pas en charge les autorisations d'application. Consultez la documentation officielle de Microsoft.
- Pour les activités de messagerie ( Get Mail, Forward Mail, Send Mailet Move Email ), il est obligatoire de spécifier une valeur pour le paramètre Account .
IDApplication et Certificat
Afin de vous authentifier en utilisant un certificat comme clé secrète, veuillez suivre ces étapes :
-
Dans le portail Azure :
- Localisez votre application Microsoft 365 enregistrée.
-
Sélectionnez Certificats et secrets (Certificates & secrets ) et téléchargez votre fichier de certificat (clé publique). Il peut avoir l'un des types de fichiers suivants :
.cer
,.pem
,.crt
.
- Convertissez le contenu brut de votre fichier
.pfx
représentant le certificat enbase64 string
. Pour ce faire, utilisez un outil Web tel que Base64.Guru ou affectezConvert.ToBase64String(System.IO.File.ReadAllBytes(pfxFilePath))
à une variableString
. - Dans l’activité Étendue Microsoft 365 :
- Définissez le Type d'authentification (Authentication Type) sur ID d'application (Application ID) et Certificat (Certificate).
- Définissez CertificateAsBase64 sur la représentation base64 du certificat.
-
Si un mot de passe est requis pour utiliser le certificat, définissez également la valeur de la propriété Mot de passe du certificat ( Certificate Password ).
Remarque : la même description que pour la section ID d'application et Clé secrète (Application Secret) s'applique également à ID d'application et Certificat (Certificate).
Si vous rencontrez des problèmes avec l'authentification, consultez Dépannage - Authentification.
- Description
- Compatibilité du projet
- Vue d'ensemble (Overview)
- Type d’authentification
- Configuration
- Méthode de connexion de ressource
- Méthode de connexion du panneau Propriétés
- Authentification
- Jeton interactif
- ID d’application et Certificat (Unattended)
- Application ID and Secret (Unattended)
- Nom d’utilisateur et mot de passe (Unattended)
- Mode de fonctionnement
- Automatisation avec ou sans assistance
- Résolution des problèmes