web-dev-qa-db-fra.com

Meilleures pratiques pour nommer les étapes d'un workflow (étiquettes d'état)?

J'ai été incapable de trouver un bon guide pour nommer les étapes d'un workflow (étiquettes d'état).

Quels sont certains principes/meilleures pratiques?

Si vous êtes curieux, mon cas particulier est:

J'ai un système où les utilisateurs soumettent des demandes de paiement. Si l'utilisateur n'annule pas la demande de paiement au moment où notre équipe du service client la voit, le service client examine la demande et la marque comme "fraude" ou l'approuve. Après avoir approuvé des dizaines de demandes, l'employé CS peut appuyer sur un bouton pour télécharger toutes les demandes approuvées vers un système de paiement tiers. Puis le temps passe (la réponse n'est pas immédiate), donc ces éléments sont dans un état limbo (que je pense appeler "upload_for_processing"). Le système de paiement tiers renvoie finalement "succès" ou "échec" pour chaque demande; dans le cas de réussite, nous définissons le statut sur "terminé" (dans notre système local). Les échecs doivent avoir leurs statuts définis sur quelque chose qui permet au représentant CS de les examiner (par exemple failed_to_process). Pour chacun, le représentant CS doit contacter l'utilisateur pour l'informer que sa demande de paiement a échoué et qu'elle doit réessayer. Ensuite, le représentant CS marquerait la demande comme "reporté_failure_à_utilisateur".

  • nouveau
  • annulé
  • fraude
  • approuvée pour téléchargement
  • upload_for_processing
  • failed_to_process
  • rapporté_failure_à_utilisateur
  • achevée

Quelque chose ne me semble pas correct dans mes choix pour ces étiquettes de statut, donc je me demande s'il existe un bon cadre pour réfléchir à la façon de bien les nommer.

De plus, ces étiquettes d'état sont à usage interne (service client). Nos clients ne les verront pas.

4
Ryan

Quelques points pour un bon étiquetage sont:

  1. Court - 'soumis' vs 'upload_for_processing'
  2. Distinguishable les uns des autres - mauvais: "téléchargement" et "téléchargé", bon: "téléchargement" et "soumis"
  3. mêmes règles de style - essayez de ne pas mélanger les verbes et les noms et utilisez le même cas
  4. compréhensible - l'utilisateur doit connaître le processus métier pour faire correspondre les étiquettes de l'interface utilisateur aux phases métier

Pour attirer l'attention sur les éléments qui nécessitent des actions de l'utilisateur, vous pouvez utiliser un code couleur.

Avec un effort minimal sur l'apprentissage des processus métier, vous pouvez afficher le schéma de workflow pour l'utilisateur. enter image description here

7
Alexey Kolchenko

Un objectif important ici est de rendre les étiquettes significatives pour vos utilisateurs internes. Vous pourriez faire une petite étude avec quelques-uns de vos utilisateurs internes. Donnez-leur des cartes décrivant les états des systèmes et demandez-leur d'étiqueter chaque état. Vous pouvez également demander à chaque participant de préciser son choix d'étiquette pour mieux comprendre comment ses utilisateurs pensent le domaine. Vous pouvez voir certaines tendances. Étant donné que les clients sont internes, il peut être facile de recruter des participants. Pour faciliter la tâche aux participants, vous pouvez même envisager de simplement fournir des descriptions d'état dans l'e-mail et demander à chaque participant de vous répondre directement avec ses étiquettes. Bonne chance!

1
Anna Rouben

Je crois qu'il y a un moyen d'aller au-delà des conseils insignifiants de "utiliser le vocabulaire du public cible (allez simplement le comprendre)".

Lorsque vous mettez une étiquette sur quelque chose, essayez de faire en sorte que l'étiquette décrive ce qu'elle signifie pour l'utilisateur, et non sa signification technique ou ses implications.

Par exemple, lorsque vous affichez le panier, vous appelez les choses à l'intérieur des produits ou des articles, et non des lignes ou des entrées (voir mon réponse à une question similaire ).

Dans votre cas, essayez de penser à ce que chaque état signifie pour l'utilisateur. Lorsque nous voulons que l'interface soit plus "actionnable", vous pouvez envisager de nommer les états après ce que l'utilisateur doit faire avec les éléments appartenant à chaque état, par exemple "Examen des besoins".

0
Dvir Adler