Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
En tant qu’administrateur de Project Web App, il est courant de devoir résoudre les problèmes liés aux flux de travail Project. Selon la façon dont le processus de flux de travail a été défini pour l’organization, il peut arriver qu’un administrateur ait besoin d’agir pour que le flux de travail instance progresse. Il existe des champs qu’un utilisateur peut ajouter au Centre de projets, interroger OData ou le point de terminaison rest Project Online pour mieux comprendre l’état de chaque workflow Project. Avec les informations fournies dans ces champs, un administrateur Project Web App peut prendre les mesures correctives appropriées pour débloquer la progression du flux de travail du projet.
Il existe trois étapes pour résoudre les problèmes Project Online workflows :
Configuration des vues et des rapports pour voir les erreurs
Un administrateur peut voir les erreurs de flux de travail project de deux manières :
Créer une vue Centre de projets pour afficher l’état du flux de travail
Interroger le service OData du projet ou l’API REST project
Créer une vue Centre de projets pour afficher l’état du flux de travail
Nous vous recommandons de créer une vue Centre de projets pour résoudre les problèmes liés aux flux de travail Project. Pour créer l’affichage ou modifier un affichage Centre de projets, l’utilisateur doit disposer de l’autorisation Globale pour gérer les vues Project Web App
Remarque
Pour plus d’informations sur la gestion de la sécurité, consultez Série de vidéos : Fonctionnement des autorisations de sécurité dans Project Server
Pour créer la vue
Dans Project Web App, cliquez sur l’icône d’engrenage, puis sur ** Paramètres PWA **.
Dans la page des paramètres, cliquez sur Gérer les vues. Une liste de vues s’affiche.
Cliquez sur ** Nouvel affichage **.
Dans la section Nom et Type, dans la liste ** Type d’affichage **, sélectionnez Centre de projets.
Dans la zone Nom , tapez le nom de la nouvelle vue. Par exemple, « Flux de travail de projet ».
Dans la zone Description , tapez une description de la nouvelle vue.
Dans la section Table et champs , dans la liste Champs affichés , supprimez les champs Start et Finish par défaut. Ajoutez les champs suivants à partir de la liste Champs disponibles :
Code d’erreur de flux de travail
Erreur de flux de travail
Flux de travail créé
ID de flux de travail
Dernière exécution du flux de travail
Propriétaire du flux de travail
Nom de la phase de flux de travail
Nom de l’étape de flux de travail
État du flux de travail
Extrait
Extrait par
Faites défiler vers le bas de la page, puis cliquez sur Filtrer.
Ajoutez le filtre en utilisant le champ « Workflow Error Codeis supérieur than 1 », puis cliquez sur OK .
Cliquez sur Save (Enregistrer).
Remarque
Après avoir cliqué sur Enregistrer, vous recevez le message suivant : « Vous n’avez pas affecté de catégorie de sécurité à cette vue. Si vous ne le faites pas, quiconque peut voir l’affichage dans la liste déroulante ou l’utiliser. Tu veux quand même économiser ? » Cliquez sur OK, car seuls les membres du groupe Administrateurs PWA pourront afficher l’affichage Centre de projets Flux de travail de projet.
Interroger le service OData du projet ou l’API REST project
Si vous le souhaitez, les utilisateurs peuvent interroger ces informations à partir du service OData project ou par programme via l’API REST project.
Project OData Service
| Champ Centre de projets | Entité | Propriété |
|---|---|---|
| Code d’erreur de flux de travail |
Projets |
WorkflowErrorResponseCode |
| Erreur de flux de travail |
Projets |
WorkflowError |
| Flux de travail créé |
Projets |
WorkflowCreatedDate |
| ID de flux de travail |
Projets |
WorkflowInstanceId |
| Dernière exécution du flux de travail |
ProjectWorkflowStageData |
StageLastSubmittedDate |
| Propriétaire du flux de travail |
Projets |
WorkflowOwnerName |
| Nom de la phase de flux de travail |
ProjectWorkflowStageData |
PhaseName |
| Nom de l’étape de flux de travail |
ProjectWorkflowStageData |
StageName |
| État du flux de travail |
ProjectWorkflowStageData |
StageStatus |
Remarque
Pour plus d’informations sur le service Project OData, consultez Informations de référence sur le service ProjectData-Project OData.
API REST de projet
| Champ Centre de projets | Entité | Propriété |
|---|---|---|
| Code d’erreur de flux de travail |
ProjectWorkflowInstance |
WorkflowErrorResponseCode |
| Erreur de flux de travail |
ProjectWorkflowInstance |
WorkflowError |
| Flux de travail créé |
ProjectWorkflowInstance |
WorkflowCreatedDate |
| ID de flux de travail |
ProjectWorkflowInstance |
ID |
| Dernière exécution du flux de travail |
ProjectWorkflowInstance |
LastSubmittedDate |
| Propriétaire du flux de travail |
Projets |
ProjectOwnerName |
| Nom de la phase de flux de travail |
ProjectWorkflowStageData |
PhaseName |
| Nom de l’étape de flux de travail |
ProjectWorkflowStageData |
StageName |
| État du flux de travail |
ProjectWorkflowInstance |
WorkflowState |
Exemples de code
Lisez un ensemble filtré de projets et récupérez les instances de workflow de projet. Si la requête inclut plus de 20 projets, vous devez ajouter un filtrage supplémentaire, sinon la requête échoue :
GET https://CONTOSO.sharepoint.com/teams/project/PWA/_api/projectserver/projects?$Filter=startswith(Name,'Budget')&$Expand=ProjectWorkflowInstance,ProjectWorkflowInstance/WorkflowInstance
Lisez tous les flux de travail avec des codes de réponse d’erreur supérieurs ou égaux à 400, y compris le propriétaire et les détails minimaux sur le projet :
GET https://CONTOSO.sharepoint.com/teams/project/PWA/_api/projectserver/projectworkflowinstances?$FILTER=WorkflowErrorResponseCode ge 400&$SELECT=Id,WorkflowError,WorkflowErrorResponseCode,WorkflowState,Project/Id,Project/Name&$EXPAND=WorkflowInstanceOwner,Project
Remarque
Pour plus d’informations sur le développement sur Project Online, visitez le Centre de développement project.
Examen des erreurs
Si l’administrateur a créé une vue Centre de projets comme décrit ci-dessus, l’affichage est accessible en procédant comme suit :
À partir Project Web App, accédez au Centre de projets en cliquant sur Projets à partir du lancement rapide.
Cliquez sur Projets dans le ruban.
Sélectionnez la vue qui a été créée en suivant les étapes ci-dessus dans la liste déroulante Affichage : .
Cela fournit à l’utilisateur la liste de tous les projets et la status actuelle du flux de travail de chaque projet, y compris les erreurs.
Si vous le souhaitez, l’utilisateur peut examiner les erreurs par le biais d’un rapport personnalisé ou par programmation, comme décrit ci-dessus.
Remarque
Le flux de travail créé et la dernière exécution du flux de travail affichent la date et l’heure au format UTC.
Remarque
Après avoir agi sur les erreurs, il faudra jusqu’à 24 heures pour que les status soient mis à jour dans le Centre de projets, Project Service OData et via l’AP REST de Project.
Agir sur les erreurs et prendre des mesures supplémentaires
Les erreurs suivantes peuvent se produire avec un workflow Project :
| Erreur | Action |
|---|---|
| Nous n’avons pas pu mettre à jour le status pour les PROJECT_GUID |
En règle générale, cette erreur est résolue si aucune action n’est effectuée pendant un certain temps. Si vous avez besoin que l’erreur soit résolue immédiatement, essayez Comment reprendre un flux de travail SharePoint. |
| Nous n’avons pas pu mettre à jour le status pour les STAGE_GUID intermédiaires sur les PROJECT_GUID |
En règle générale, cette erreur est résolue si aucune action n’est effectuée pendant un certain temps. Si vous avez besoin que l’erreur soit résolue immédiatement, essayez Comment reprendre un flux de travail SharePoint. |
| La phase STAGE_GUID n’est pas l’étape actuelle pour le PROJECT_GUID de projet |
Cette erreur se produit lors de la tentative de définition de l’étape de flux de travail status pour une étape de flux de travail qui n’est pas valide. Dans ce cas, vous devez redémarrer un workflow de projet. |
| Les CUSTOM_FIELD_GUID de champs personnalisés n’ont pas de valeur définie pour les PROJECT_GUID de projet |
Un champ personnalisé n’est pas correctement défini et le flux de travail ne peut pas progresser tant que la valeur du champ personnalisé n’est pas mise à jour. Pour déterminer le nom du champ personnalisé qui doit être mis à jour, consultez la section intitulée Comment obtenir un champ personnalisé à partir d’un GUID de champ personnalisé. Après avoir mis à jour le champ personnalisé, essayez Comment reprendre un flux de travail SharePoint. > [! REMARQUE]> Comme meilleure pratique, il est recommandé que les champs personnalisés vrai/faux impliqués dans un flux de travail utilisent une table de choix par opposition à un champ personnalisé d’indicateur pour éviter ce problème pour les champs personnalisés de ce type. |
| Le champ personnalisé CUSTOM_FIELD_GUID n’existe pas. |
Cela se produit lorsque le workflow tente de lire ou d’écrire la valeur d’un champ personnalisé qui a été supprimé de PWA. Vous devez modifier le flux de travail et vérifier que le champ personnalisé approprié est associé au flux de travail. |
| Échec de l’envoi d’un travail d’archivage pour PROJECT_GUID de projet |
En règle générale, cette erreur est résolue si aucune action n’est effectuée pendant un certain temps. Si vous avez besoin que l’erreur soit résolue immédiatement, essayez Comment reprendre un flux de travail SharePoint. Si le problème persiste, vous devrez redémarrer un workflow de projet. |
| Échec de l’envoi d’un travail de publication pour PROJECT_GUID de projet |
En règle générale, cette erreur est résolue si aucune action n’est effectuée pendant un certain temps. Si vous avez besoin que l’erreur soit résolue immédiatement, essayez Comment reprendre un flux de travail SharePoint. Si le problème persiste, vous devrez redémarrer un workflow de projet. |
| Échec de l’envoi d’un travail de synthèse de publication pour les PROJECT_GUID de projet |
En règle générale, cette erreur est résolue si aucune action n’est effectuée pendant un certain temps. Si vous avez besoin que l’erreur soit résolue immédiatement, essayez Comment reprendre un flux de travail SharePoint. Si le problème persiste, vous devrez redémarrer un workflow de projet. |
| Échec de la création d’un projet à partir d’un élément de liste |
Il s’agit d’une erreur qui affecte l’activité CreateProjectFromListItem. Tout d’abord, essayez Comment reprendre un flux de travail SharePoint. Si le problème persiste, passez en revue la file d’attente PWA pour voir si un travail de file d’attente a échoué pour la création du projet. |
| Élément de liste introuvable pour créer un projet de liste de WEB_ID web LIST_ID LIST_ITEM_ID |
L’élément de liste n’existe plus. Vous pouvez case activée la Corbeille pour voir si vous pouvez restaurer l’élément de liste. |
| Impossible de trouver une idée associée à l’PROJECT_GUID de projet lors de la tentative de mise à jour status |
Cela se produit lorsque l’idée initialement utilisée pour la création de projet est supprimée. Vous pouvez case activée la Corbeille pour voir si vous pouvez restaurer l’élément de liste. |
| L’ID de travail JOB_GUID n’est pas valide |
Contactez Support Microsoft si vous recevez ce message d’erreur. |
| Le propriétaire du flux de travail n’est pas autorisé à case activée PROJECT_GUID de projet |
Administration devez accorder des autorisations de case activée au propriétaire du flux de travail. Après avoir accordé des autorisations, essayez Comment reprendre un flux de travail SharePoint. Si le problème persiste, vous devrez redémarrer un workflow de projet. |
| Le propriétaire du flux de travail n’a pas l’autorisation Modifier les champs récapitulatives du projet ou Enregistrer le projet dans Project Server ou Publier la catégorie de projet sur le projet PROJECT_GUID |
Administration devez accorder l’autorisation appropriée au propriétaire du flux de travail. Après avoir accordé des autorisations, essayez Comment reprendre un flux de travail SharePoint. Si le problème persiste, vous devrez redémarrer un workflow de projet. |
| Le propriétaire du flux de travail ne dispose pas de l’autorisation globale Nouveau projet |
Cela se produit lorsque vous tentez de créer un projet à partir d’un élément de liste SharePoint et que l’utilisateur qui démarre le flux de travail instance ne peut pas créer de projets dans PWA. Administration doit accorder l’autorisation appropriée à l’utilisateur. Après avoir accordé des autorisations, essayez Comment reprendre un flux de travail SharePoint. Si le problème persiste, vous devrez redémarrer un workflow de projet. |
| Le propriétaire du flux de travail ne dispose pas des autorisations ouvrir et enregistrer le projet dans la catégorie Project Server sur le projet PROJECT_GUID |
Administration devez accorder l’autorisation appropriée à l’utilisateur. Après avoir accordé des autorisations, essayez Comment reprendre un flux de travail SharePoint. Si le problème persiste, vous devrez redémarrer un workflow de projet. |
| Le propriétaire du flux de travail n’a pas l’autorisation Ouvrir la catégorie projet sur le projet PROJECT_GUID |
Administration devez accorder l’autorisation appropriée à l’utilisateur. Après avoir accordé des autorisations, essayez Comment reprendre un flux de travail SharePoint. Si le problème persiste, vous devrez redémarrer un workflow de projet. |
| Le propriétaire du flux de travail n’a pas l’autorisation Publier la catégorie de projet sur le projet PROJECT_GUID |
Administration devez accorder l’autorisation appropriée à l’utilisateur. Après avoir accordé des autorisations, essayez Comment reprendre un flux de travail SharePoint. Si le problème persiste, vous devrez redémarrer un workflow de projet. |
| Le flux de travail du projet ne peut pas avoir plusieurs étapes en cours |
Cette erreur s’affiche si le workflow instance tente d’entrer dans une phase sans fermer l’étape précédente. Contactez Support Microsoft pour obtenir de l’aide sur cette erreur. |
| Le flux de travail du projet doit avoir une étape en cours |
Cette erreur s’affiche si le flux de travail instance tente de quitter une phase sans définir l’étape suivante en cours. Contactez Support Microsoft pour obtenir de l’aide sur cette erreur. |
| Project PROJECT_GUID ne peut pas avoir de workflow |
Cette erreur se produit lors de la tentative de démarrage d’un workflow instance sur un type de projet non pris en charge. Contactez Support Microsoft pour obtenir de l’aide sur cette erreur. |
| Project PROJECT_GUID n’a pas pu s’case activée |
Un travail de file d’attente PWA a échoué empêchant la progression du flux de travail. Passez en revue le travail de file d’attente ayant échoué à partir de la page Gérer le travail de file d’attente dans PWA. |
| Project {0} n’a pas pu case activée après la mise à jour de la valeur du champ {1} personnalisé |
Un travail de file d’attente PWA a échoué empêchant la progression du flux de travail. Passez en revue le travail de file d’attente ayant échoué à partir de la page Gérer le travail de file d’attente dans PWA. |
| Project PROJECT_GUID n’a pas pu s’case activée après la mise à jour de la valeur de propriété PROPERTY |
Un travail de file d’attente PWA a échoué empêchant la progression du flux de travail. Passez en revue le travail de file d’attente ayant échoué à partir de la page Gérer le travail de file d’attente dans PWA. |
| Project PROJECT_GUID est extrait dans une autre session |
Administration devez forcer case activée dans le projet ou demander à l’utilisateur d’case activée le projet. Une fois le projet archivé, essayez Comment reprendre un flux de travail SharePoint. Si le problème persiste, vous devrez redémarrer un workflow de projet. |
| Project PROJECT_GUID est extrait pour un autre utilisateur |
Administration devez forcer case activée dans le projet ou demander à l’utilisateur d’case activée le projet. Une fois le projet archivé, essayez Comment reprendre un flux de travail SharePoint. Si le problème persiste, vous devrez redémarrer un workflow de projet. |
| Project PROJECT_GUID n’a pas de workflow |
Contactez Support Microsoft si vous recevez ce message d’erreur. |
| Project PROJECT_GUID n’est pas extrait |
L’administrateur doit examiner la définition du flux de travail et vérifier qu’aucune mise à jour de projet n’est tentée avant que le projet ne soit extrait. |
| Le PROJECT_GUID de projet n’existe pas |
Contactez Support Microsoft si vous recevez ce message d’erreur. |
| Impossible de publier PROJECT_GUID project, car le PROJ_PWA_SHORT_NAME est en mode Lecture seule |
En règle générale, cette erreur est résolue si aucune action n’est effectuée pendant un certain temps. Si vous avez besoin que l’erreur soit résolue immédiatement, vérifiez que le site PWA n’est pas en mode lecture seule en accédant au site et en vérifiant s’il y a une notification en haut de la page. S’il n’y a pas de notification, essayez Comment reprendre un flux de travail SharePoint. |
| Échec de la mise à jour du PROJECT_GUID du projet |
Un travail de file d’attente PWA a échoué empêchant la progression du flux de travail. Passez en revue le travail de file d’attente ayant échoué à partir de la page Gérer le travail de file d’attente dans PWA. |
| La propriété PROPERTY n’a pas de valeur définie pour le projet PROJECT_GUID |
L’administrateur doit examiner la définition du flux de travail et vérifier que les propriétés sont correctement définies. |
| La propriété PROPRERTY n’existe pas |
Contactez Support Microsoft si vous recevez ce message d’erreur. |
| Échec de l’exécution d’une opération de publication sur le projet PROJECT_GUID |
Un travail de file d’attente PWA a échoué empêchant la progression du flux de travail. Passez en revue le travail de file d’attente ayant échoué à partir de la page Gérer le travail de file d’attente dans PWA. |
| Échec de l’exécution d’une opération De synthèse de publication sur le projet PROJECT_GUID |
Un travail de file d’attente PWA a échoué empêchant la progression du flux de travail. Passez en revue le travail de file d’attente ayant échoué à partir de la page Gérer le travail de file d’attente dans PWA. |
| 401 Utilisateur introuvable/utilisateur inactif |
Vous devrez redémarrer un flux de travail de projet. |
| System.InvalidOperationException : fermeture incomplète détectée lors du chargement des sous-routines pour les WORKFLOW_GUID de workflow dans l’étendue. |
Vous devrez redémarrer un flux de travail de projet. |
Si votre erreur n’est pas répertoriée ou si vous souhaitez obtenir plus de détails sur l’erreur que vous obtenez, consultez la section Comment obtenir le message d’erreur détaillé pour un flux de travail SharePoint.
Si vous trouvez d’autres zones non répertoriées ci-dessus, faites-le nous savoir en sélectionnant le lien de commentaires en haut de cette page. Fournissez les informations suivantes :
Nom du projet
Code d’erreur de flux de travail
Erreur de flux de travail
Flux de travail créé
ID de flux de travail
Dernière exécution du flux de travail
Propriétaire du flux de travail
Message de file d’attente et horodatage ayant échoué, le cas échéant
Comment reprendre un flux de travail SharePoint
Dans certains cas, un workflow peut avoir besoin d’être repris pour réessayer l’étape actuelle du flux de travail.
Pour reprendre un flux de travail SharePoint
À partir Project Web App, accédez au Centre de projets en cliquant sur Projets à partir du lancement rapide.
Cliquez sur le nom du projet.
Cliquez sur le nom du projet dans lancement rapide.
Développez la section Toutes les étapes du flux de travail .
Cliquez sur le lien Données de workflow supplémentaires .
Cliquez sur l’icône « i » en regard de l’état interne.
Cliquez sur le lien Reprendre ce flux de travail .
Guide pratique pour redémarrer un flux de travail de projet
Le redémarrage d’un flux de travail Project le replace au début du flux de travail. Les utilisateurs doivent revenir au stade actuel du flux de travail. Avant de redémarrer le flux de travail Project, vous pouvez commencer par essayer de le reprendre pour réessayer les étapes actuelles. Voir Guide pratique pour reprendre un flux de travail SharePoint pour connaître les étapes de reprise d’un flux de travail.
Pour redémarrer un workflow de projet
À partir Project Web App, accédez au Centre de projets en cliquant sur Projets à partir du lancement rapide.
Cliquez sur le nom du projet.
Sous l’onglet Projet , cliquez sur Options, puis sur Redémarrer le flux de travail.
Remarque
Le projet doit être archivé avant que le workflow puisse être redémarré. Pour plus d’informations sur l’archivage d’un projet, consultez Case activée manuellement dans les projets et les ressources extraits par un autre utilisateur.
Cliquez sur OK
Pour redémarrer des flux de travail de projet pour un ensemble de projets
Dans Project Web App, cliquez sur l’icône d’engrenage, puis sur Paramètres PWA.
Cliquez sur Modifier ou redémarrer les flux de travail.
Choisissez le Type de projet d’entreprise dans la liste des projets.
Sélectionnez l’ensemble des projets dont les workflows doivent être redémarrés.
Remarque
Les projets doivent être archivés pour qu’ils apparaissent dans la liste. Pour plus d’informations sur l’archivage d’un projet, consultez Case activée manuellement dans les projets et les ressources extraits par un autre utilisateur.
Sélectionnez Redémarrer le flux de travail actuel pour les projets sélectionnés.
Cliquez sur OK.
Si vous le souhaitez, les flux de travail Project peuvent être redémarrés par programme. ProjectWorkflowInstance propose deux méthodes pour redémarrer les flux de travail project :
- RestartWorkflow()
POST https://CONTOSO.sharepoint.com/teams/project/PWA/_api/projectserver/projects('PROJECT_GUID')/ProjectWorkflowInstance/RestartWorkflow()
- RestartWorkflowSkipToStage(stageId)
POST https://CONTOSO.sharepoint.com/teams/project/PWA/_api/projectserver/projectworkflowinstances('WORKFLOW_INSTANCE_GUID')/RestartWorkflowSkipToStage('STAGE_GUID')
Remarque
Le redémarrage de flux de travail Project en bloc peut entraîner une limitation. Pour plus d’informations, voir Limitation et performances des flux de travail SharePoint 2013 dans SharePoint Online et Project Online.
Comment obtenir le message d’erreur détaillé pour un flux de travail SharePoint
Si le message d’erreur fourni dans le Centre de projets ne fournit pas suffisamment de détails pour résoudre le problème, vous pouvez consulter le message d’erreur détaillé du flux de travail SharePoint.
Pour obtenir le message d’erreur détaillé pour un flux de travail SharePoint
À partir Project Web App, accédez au Centre de projets en cliquant sur Projets à partir du lancement rapide.
Cliquez sur le nom du projet.
Cliquez sur le nom du projet dans lancement rapide.
Développez la section Toutes les étapes du flux de travail .
Cliquez sur le lien Données de workflow supplémentaires .
Cliquez sur l’icône « i » en regard de l’état interne pour afficher le message d’erreur détaillé.
Comment obtenir un champ personnalisé à partir d’un GUID de champ personnalisé
Dans Project Web App, cliquez sur l’icône d’engrenage, puis sur Paramètres PWA.
Cliquez sur Champs personnalisés d’entreprise et Tables de choix.
Cliquez sur un champ personnalisé.
Faites défiler vers le bas de la page.
Développez la section Données d’identification du système pour passer en revue le GUID de champ personnalisé.
Guide pratique pour examiner les travaux de file d’attente PWA
Dans certains cas, une erreur est le résultat d’un travail de file d’attente PWA ayant échoué. PWA fournit des messages d’erreur détaillés pour les travaux de file d’attente ayant échoué.
Pour passer en revue les travaux de file d’attente PWA
Dans Project Web App, cliquez sur l’icône d’engrenage, puis sur Paramètres PWA.
Cliquez sur Gérer les travaux de file d’attente.
Recherchez le travail de file d’attente ayant échoué lié à l’erreur de flux de travail et cliquez sur l’erreur pour plus d’informations.
Remarque
Vous devez modifier l’historique des travaux si l’erreur de workflow est plus ancienne qu’une semaine pour qu’elle s’affiche dans la liste.
Étapes supplémentaires
La date de dernière exécution du flux de travail est loin dans le passé pour un projet actif
Le projet peut être extrait dans une autre session et le flux de travail ne peut pas progresser tant que le projet n’est pas archivé. L’administrateur peut envisager de forcer la vérification dans le projet pour permettre la progression du flux de travail. Pour plus d’informations sur l’archivage d’un projet, consultez Case activée manuellement dans les projets et les ressources extraits par un autre utilisateur.
Remarque
La date de dernière exécution du flux de travail est appelée Date de la dernière soumission dans l’API REST OData du service Project et Project Service.