Diagnostic des Workflows 2013
an English version of this post is also available - click here for English
Après avoir donné les formations internes Workflows, j'ai trouvé utile de compiler une "checklist" de référence pour le support des workflows 2013. Voici donc cette liste, contenant les actions de diagnostic les plus usitées.
Problèmes d'exécution du flux de travail
1. Observer la "Workflow History list", eg "https://sp2013/Lists/Workflow History". Y a-t-il des erreurs?
2. Le compte de l'utilisateur qui démarre le workflows est-il:
-
- correctement synchronisé dans la base des profils utilisateurs?
- distinct du compte de setup du Workflow manager?
(Plus de détails à https://technet.microsoft.com/en-us/library/jj658588.aspx#section7)
3. Les services User Profile Service et App Management Service sont-ils démarrés ? Voir les cadres verts dans copie d'écran depuis l'Administration Centrale \ Manage Services on Server : 
4. Les service-applications App Management Service Application et User Profile Service Application sont-elles démarrées? Leurs proxies sont-elles également démarrées ? Voir les cadres verts dans copie d'écran depuis l'Administration Centrale \ Manage Service Applications :
Comment retrouver une exception dans les base Workflow Manager
Non supporté en production, mais très pratique en développement!
Dans la page SharePoint workstat.aspx , copier le champs "requestor id"
1. Puis dans les paramètres d'appels de l'url de la page worsktat.aspx, copier le champs "instanceid"
2. Ouvrir la base WFInstanceManagementDB avec SQLManagement Studio, faire une requête table DebugTrace
3. l'exception est dans la colonne "WorkflowStatusDetail"
Configuration du serveur SharePoint
Dans l'Administration Centrale \ MaService Applications \ Workflow Service Application Proxy:
Quel est le status? Le status est-il bien "connecté" comme dans la copie d'écran ci-dessous:
La ferme Worflow Manager est-elle en cours d'exécution?
Sur un serveur de la ferme Worflow Manager,
1. Lancer un Workflow Manager PowerShell
2. lancer la commande get-WFStatus
3. Les status sont-ils Running comme sur la copie d'écran ci-dessous:
Les information Oauth sont-elles publiées et accessibles depuis le serveur SharePoint?
Sur le serveur SharePoint 2013, lancer IE, et vérifier que les metadonnées OAuth sont accessibles. L'url est de la forme: https://wfm1:12291/$SYSTEM/$Metadata/json/1
Voici un exemple de résultat:
Les scopes sont-ils bien enregistrés dans la ferme Workflow Manager?
Il est possible de vérifier depuis Internet Explorer que les scopes sont bien enregistrés. Il est également possible de parcourir les données des workflows. Les URLs indiquées ci-dessous permettent de vérifier ces éléments:
https://wfm1:12291/$ChildScopes
Notes
Les GUIDs des URLs ci-dessus ne sont pas fixes.
L'outil ci-dessous pour naviguer plus simplement dans les données du workflows manager:
https://code.msdn.microsoft.com/windowsdesktop/Workflow-Resource-Browser-a67b1d27
Sur un serveur Workflows Manager, il convient d'exécuter l'outil Workflow-Resource-Browser en tant qu'administrateur
Activer les logs Workflows Manager
1. Lancer l'observateur d'évènements
2. Étendre Applications and Services Logs \ Microsoft-Workflow
3. Dans le menu View \ Show Analytical and Debug logs
4. Sélectionner le log Debug, cliquer-droit enable Log
5. Reproduire le problème
6. Sélectionner le log Debug, cliquer-droit Disable Log. (L'objectif est de ne pas saturer la plateforme.)
7. Il est alors possible d'enregistrer le log au format EVTX
Versions utilisées:
SharePoint 2013 v15.0.4551.1001
Workflow Manager 1.0.0
Je remercie Yvan Duhamel pour la relecture de ce blog.
Vincent Runge