Actions des files d’attente de travail
Les Files d’attente de travail dans Power Automate peuvent être utilisées pour stocker des données pertinentes pour les processus et fournir un moyen de découpler les processus et automatisations complexes, ce qui leur permet de communiquer de manière asynchrone.
Les files d’attente de travail peuvent jouer un rôle crucial dans l’amélioration de l’efficacité, de l’évolutivité et de la résilience des automatisations, et aider à hiérarchiser le travail. Les files d’attente de travail vous permettent de terminer les éléments avec la priorité la plus élevée en premier, qu’ils soient traités par des employés numériques, des employés humains ou via des intégrations.
Note
- La prise en charge au niveau de la production pour le premier ensemble d’actions liées à la file d’attente de travail nécessite Power Automate bureau version 2.37 ou une version ultérieure.
- Les actions de la file d’attente de travail dans Power Automate pour le bureau sont une fonctionnalité premium qui nécessite un abonnement Power Automate.
- Actuellement, seules les actions Traiter les éléments de la file d’attente de travail et Mettre à jour l’élément de la file d’attente de travail peuvent être classées et autorisées ou restreintes via les stratégies de protection contre la perte de données (DLP), et d’autres actions seront bientôt disponibles. Notez que l’utilisation basée sur le flux de cloud des files d’attente de travail ne peut pas être restreinte par les stratégies DLP.
Traiter les éléments de la file d’attente de travail
L’action Traiter les éléments de la file d’attente de travail indique à l’orchestrateur de la file d’attente que la machine est prête à traiter un ou plusieurs éléments de la file d’attente de travail. Le contexte utilisateur qui demande un nouvel élément doit avoir des privilèges suffisants sur la file d’attente de travail et la table des éléments de la file d’attente de travail pour traiter les files d’attente de travail.
La file d’attente de travail référencée dans l’action précédente est utilisée par l’orchestrateur de la file d’attente pour déterminer les prochains éléments disponibles dans cette file d’attente qui sont à l’état En file d’attente. À mesure que le flux du bureau passe par les actions de la boucle Traiter les éléments de la file d’attente de travail que cette action restitue, vous pouvez appeler la valeur en utilisant la variable que vous avez désignée pour l’action avec la propriété .Value. Dans ce cas, vous pouvez appeler la valeur de l’élément de la file d’attente de travail en utilisant la variable %WorkQueueItem.Value%
Processworkqueueitemaction
L’action Traiter l’élément de la file d’attente de travail nécessite les arguments suivants.
Paramètres d’entrée
| Argument | Facultatif | Accepte | Valeur par défaut | Description |
|---|---|---|---|---|
| File d’attente de travail | Non | Texte | L’ID de la file d’attente de travail qui contient les éléments à traiter |
Variables produites
| Argument | Type | Description |
|---|---|---|
| WorkQueueItem | Non | Informations stockées dans l’élément de la file d’attente de travail en cours de traitement |
Exceptions
| Exception | Description |
|---|---|
| File d’attente de travail introuvable | La valeur saisie dans le paramètre de la file d’attente de travail n’est pas valide |
| Échec du traitement de la file d’attente de travail | Demande incorrecte : erreur dans la syntaxe de la requête |
Mettre à jour un élément de la file d’attente de travail
L’action Mettre à jour l’élément de la file d’attente de travail permet aux utilisateurs de modifier le statut et les résultats du traitement de l’élément de la file d’attente de travail sélectionné.
Updateworkqueueitemaction
L’action Mettre à jour l’élément de la file d’attente de travail nécessite les arguments suivants.
| Argument | Facultatif | Accepte | Valeur par défaut | Description |
|---|---|---|---|---|
| Élément de la file d’attente de travail | Non | Text | Variable de l’élément de la file d’attente de travail qui a été précédemment renvoyée par l’orchestrateur de la file d’attente | |
| Statut | Non | Traité, exception générique | Traité | Mettez à jour l’élément de la file d’attente de travail en cours de traitement en utilisant un statut dans la liste d’options. |
| Notes de traitement | Oui | Texte | Notes de traitement personnalisées ou valeur à ajouter à l’élément de la file d’attente en cours de traitement. | |
| Effacer les notes de traitement | Oui | Booléen | False | Lorsque cette option est activée, masque et efface le champ de notes de traitement sur cet écran et supprime toutes les notes de traitement de la base de données qui ont été précédemment capturées pour cet élément. |
Exceptions
| Argument | Description |
|---|---|
| Élément de la file d’attente de travail introuvable | L’élément de la file d’attente de travail en cours de traitement a été supprimé ou n’appartient plus à la file d’attente à partir de laquelle il a été appelé. |
| Élément de la file d’attente de travail mis en attente | L’élément de la file d’attente de travail en cours de traitement contient un statut on hold dans l’orchestrateur de la file d’attente et ne peut plus être mis à jour. |
| Échec de la mise à jour de l’élément de la file d’attente de travail | L’élément de la file d’attente de travail en cours de mise à jour a rencontré une erreur inattendue. Vérifiez le message d’erreur pour obtenir plus de détails. |
Ajouter un élément de file d’attente de travail
L’option Ajouter un élément de la file d’attente de travail permet aux utilisateurs d’introduire des éléments de la file d’attente de travail dans une file d’attente de travail, qui a été configurée dans le portail de flux.
Action Addworkqueueitem
L’action Ajouter un élément de la file d’attente de travail nécessite les arguments suivants.
Paramètres d’entrée
| Argument | Facultatif | Accepte | Valeur par défaut | Description |
|---|---|---|---|---|
| File d’attente de travail | Non | Valeur de texte | L’élément de la file d’attente de travail dans lequel ajouter l’élément | |
| Priorité | Non | Élevé, Normal, Faible | Normal | La priorité sur laquelle définir l’élément de la file d’attente de travail |
| Nom | Non | Valeur texte, valeur numérique | Nom ou ID personnalisé du nouvel élément de la file d’attente de travail | |
| Entrée | Non | Valeur texte, valeur numérique | Les données qui appartiennent à la colonne de valeur à traiter | |
| Expire | Oui | Datetime | La valeur datetime définie pour faire expirer l’élément de la file d’attente ; sinon, adopte la valeur par défaut si elle est définie pour la file d’attente | |
| Notes de traitement | Oui | Valeur texte, valeur numérique | Notes de traitement personnalisées à ajouter au nouvel élément de la file d’attente | |
| A un ID ou une référence unique | Oui | Valeur texte, valeur numérique | Lorsque cette option est activée, une valeur doit être fournie qui est unique au sein de cette file d’attente. Si elle est laissée vide, une valeur unique au format system-<GUID> est automatiquement fournie par le système |
Variables produites
| Argument | Type | Description |
|---|---|---|
| WorkQueueItem | Non | Informations stockées pour l’élément de la file d’attente de travail en cours d’ajout |
Exceptions
| Argument | Description |
|---|---|
| File d’attente de travail introuvable | La valeur saisie dans le paramètre de la file d’attente de travail n’est pas valide |
| Échec de l’ajout de l’élément dans la file d’attente de travail | L’élément de la file d’attente de travail n’a pas pu être ajouté à la file d’attente de travail. Demande incorrecte : erreur dans la syntaxe de la requête |
Remettre en file d’attente l’élément avec un retard
L’action Remettre en file d’attente l’élément avec un retard permet aux utilisateurs rajouter un élément de la file d’attente en cours de traitement dans le flux de bureau, dans sa file d’attente d’origine. De plus, l’élément en file d’attente peut être conservé et libéré jusqu’à une heure définie.
Requeueworkqueueitemaction
L’action Remettre l’élément en file d’attente avec un délai nécessite les arguments suivants.
Paramètres d’entrée
| Argument | Facultatif | Accepte | Valeur par défaut | Description |
|---|---|---|---|---|
| Élément de la file d’attente de travail | Non | Élément de la file d’attente de travail | L’élément de la file d’attente de travail dans lequel ajouter l’élément | |
| Différer jusqu’à | Non | Valeur DateHeure | Normal | La valeur de date et heure appliquée pour différer l’élément de la file d’attente |
| Expire | Oui | Valeur DateHeure | Délai d’expiration personnalisé pour l’élément remis en file d’attente | |
| Notes de traitement | Oui | Valeur texte, valeur numérique | Notes de traitement personnalisées à ajouter au nouvel élément de la file d’attente | |
| Effacer les notes de traitement | Oui | Booléen | False | Lorsque cette option est activée, masque et efface le champ de notes de traitement sur cet écran et supprime toutes les notes de traitement de la base de données qui ont été précédemment capturées pour cet élément |
Exceptions
| Argument | Description |
|---|---|
| File d’attente de travail introuvable | La valeur saisie dans le paramètre de la file d’attente de travail n’est pas valide |
| Élément de la file d’attente de travail introuvable | La valeur de l’élément de la file d’attente n’est pas valide |
| Échec de la remise en file d’attente de l’élément de la file d’attente de travail | L’élément de la file d’attente de travail n’a pas pu être ajouté à la file d’attente de travail. Demande incorrecte : erreur dans la syntaxe de la requête |
Mettre à jour les notes de traitement de l’élément de file d’attente de travail
L’action Mettre à jour les notes de traitement de l’élément de file d’attente de travail permet aux utilisateurs de mettre à jour ou d’effacer les notes de traitement de l’élément de la file d’attente de travail sélectionné sans modifier son état ou toute autre propriété.
updateprocessingnotesaction
L’action Mettre à jour les notes de traitement de l’élément de la file d’attente de travail nécessite les arguments suivants.
| Argument | Facultatif | Accepte | Valeur par défaut | Description |
|---|---|---|---|---|
| Élément de la file d’attente de travail | Non | Texte | Variable d’élément de la file d’attente de travail précédemment renvoyée par l’orchestrateur de la file d’attente | |
| Notes de traitement | Oui | Texte | Résultat du traitement personnalisé ou valeur à ajouter à l’élément de la file d’attente traité | |
| Effacer les notes de traitement | Oui | Booléen | False | Lorsque cette option est activée, masque et efface le champ de notes de traitement sur cet écran et supprime toutes les notes de traitement de la base de données qui ont été précédemment capturées pour cet élément |
Exceptions
| Argument | Description |
|---|---|
| File d’attente de travail introuvable | La file d’attente de travail associée à l’élément a été supprimée ou n’est plus accessible |
| Élément de la file d’attente de travail introuvable | L’élément de la file d’attente de travail n’est pas valide |
| Impossible d’ajouter les résultats du traitement | L’élément de la file d’attente de travail en cours de mise à jour a rencontré une erreur inattendue. Vérifiez le message d’erreur pour obtenir plus de détails. |