Situation des API de Workflow YouTrack

Delphine Massenhove

Il y a quelque temps, nous avons annoncé que la prise en charge des anciens workflows cesserait dans YouTrack 2019.1.

Par « anciens » workflows, nous entendons ceux écrits dans l’ancien éditeur de workflow, une application externe qui a été supprimée à partir de la la version 2018.3.

Nous constatons que certains de nos clients utilisent toujours ces anciens workflows. Selon nos statistiques d’utilisation des fonctionnalités, près de 6,5 % des instances YouTrack InCloud ont encore un ou plusieurs anciens workflows activés. Nous avons donc décidé de les maintenir opérationnels pendant encore 6 mois. Ainsi, ces workflows cesseront de fonctionner à partir de la version 2019.3.

Cela dit, nous vous encourageons vivement à mettre à niveau vos anciens workflows dès que possible. Non seulement l’ancien éditeur est indisponible (vous ne pouvez donc rien changer dans vos anciennes règles), mais la nouvelle API est beaucoup plus puissante et pratique. Certaines nouvelles fonctionnalités ne sont pas prises en charge dans l’ancienne API. Par exemple, vous ne pouvez pas y implémenter desrègles d’action.

Pour mettre à jour vos workflows, veuillez suivre les étapes suivantes :

1. Vérifiez s’il vous reste des anciens workflows actifs. Pour ce faire, rendez-vous sur la page Workflows de votre serveur YouTrack et vérifiez s’il existe des workflows avec des titres affichés en texte brut (et non un lien) :

LegacyWorkflows

2. Certains de ces anciens workflows peuvent inclure ceux que nous fournissions avec chaque installation de YouTrack avant la version 2017.3. Leurs noms commencent par « jetbrains-youtrack ». Nous avons effectué des mises à jour automatiques de la nouvelle API de workflow chaque fois que cela était possible, mais certains workflows qui avaient été édités avec l’ancien éditeur de workflow n’ont pas pu être mis à jour.

Identifiez les workflows que vous êtes sûr de ne jamais vouloir modifier. Pour les mettre à jour, sélectionnez-les et cliquez sur le bouton« Restore Selected » :

RestoreWorkflow

3. Si vous avez des workflows par défaut que vous avez modifiés, nous vous recommandons de sélectionner les workflows JS correspondants dans la section Default Workflows de notre documentation et de les mettre à jour en conséquence.

Par exemple, si vous utilisez une règle « Interdiction de créer un ticket sans date d’échéance » du workflow « Date d’échéance » avec un message modifié, vous devez :

  • Créer un workflow dans notre éditeur web.
  • Ajouter un nouveau module
  • Copier le texte de la règle suivante.
  • Modifier le message.
  • Sauvegarder et joindre le workflow aux projets correspondants.

DueDateDefaultWorkflow

4. D’autres workflows hérités peuvent provenir de notre référentiel public de workflows. Pour les mettre à jour, consultez le référentiel pour y trouver les workflows correspondants et remplacer les anciens par les nouveaux :

Référentiel

5. S’il reste encore d’anciens workflows, vous devez les réécrire dans la nouvelle API. Si vous ne l’avez pas encore utilisée, nous vous recommandons de regarder ce webinaire et de consulter le Guide de prise en main.

6. Pour accélérer le processus de réécriture, nous avons mis en place un convertisseur de workflow. Toutefois, ce convertisseur étant entièrement automatisé, les workflows générés sont de moins bonne qualité que ceux issus de code produit manuellement.

Pour mettre à jour un ancien workflow :

WorkflowConverter

Pour toute question ou demande d’aide concernant la mise à jour de vos workflows, veuillez contacter notre équipe d’assistance ou rejoindre la communauté YouTrack sur Slack. L’aide est toujours à portée de main !

Auteur de l’article original en anglais : Mariya Davydova

S'abonner

S'abonner aux mises à jour