Création de valeurs de processus exposées

Vous pouvez créer des valeurs de processus exposées (EPV) pour définir un ensemble de variables que vous souhaitez exposer à des utilisateurs spécifiques. Ces variables peuvent être modifiées par les utilisateurs alors que des instances d'un processus sont en cours d'exécution. Par exemple, si vous créez un processus pour traiter le remboursement des frais, vous souhaiterez peut-être permettre à des administrateurs système de modifier les montants autorisés pour les dépenses quotidiennes, ou le montant en Euro qui correspond à différents niveaux d'approbateurs. En créant des valeurs de processus exposées, vous fournissez ce type de flexibilité en permettant aux utilisateurs de régler certaines valeurs de variable comme des constantes, ce qui a pour conséquence d'affecter le flux de toutes les instances de processus, affectations de tâche, etc.

A propos de cette tâche

La valeur EPV renvoyée varie selon que l'option Utiliser les nouvelles valeurs est définie ou non dans la valeur EPV ; elle n'est pas définie par défaut.
  • Si l'option Utiliser les nouvelles valeurs est définie, l'API tw.epv renvoie l'EPV dont la date Effective On dans le passé est la plus proche de la date actuelle.
  • Si l'option Utiliser les nouvelles valeurs n'est pas définie, l'API tw.epv utilise l'heure à laquelle l'instance de tâche a démarré, ce qui signifie qu'elle recherche l'EPV dont la date Effective On dans le passé est la plus proche de la date à laquelle l'instance de tâche a démarré.
Remarque: Les instructions de cette rubrique expliquent comment créer une nouvelle EPV et l'exposer à une équipe dont les membres peuvent gérer l'EPV et ajuster ses valeurs de variable. Si vous disposez d'une EPV existante qui n'est pas encore exposée, vous devez l'exposer à une équipe du concepteur et créer une nouvelle version afin d'éditer les valeurs par défaut. Faute de quoi, l'EPV n'est pas utilisable. L'EPV ne peut être éditée que par l'équipe à laquelle elle est exposée. Elle ne peut pas être éditée par les administrateurs. Une fois l'EPV exposée à une équipe spécifique, vous pouvez modifier le contenu de l'équipe lors de l'exécution à l'aide des méthodes standard de modification d'équipe. Pour plus d'informations sur les EPV, voir la rubrique Gestion des valeurs de processus exposées (EPV).
Restriction: Vous devez utiliser le nom de variable dans les scripts côté client d'un service utilisateur côté client pour obtenir une valeur pour une valeur EPV. Vous ne pouvez pas atteindre une variable EPV en utilisant le nom externe sur un service utilisateur côté client.

Procédure

Pour créer une EPV :

  1. Ouvrez le concepteur.
  2. Développez Données et sélectionnez Valeur de processus exposée.
    La fenêtre Nouvelle valeur de processus exposée s'affiche.
  3. Dans la zone Nom , entrez un nom pour la valeur et cliquez sur Terminer.
    La vue de configuration de l'EPV s'affiche.
  4. Configurez l'EPV :
    1. Dans la zone Documentation , entrez une description de l'EPV pour les développeurs.
    2. Pour permettre aux utilisateurs d'envoyer des commentaires sur cette EPV, entrez une adresse électronique dans la zone Contact par e-mail de commentaires .

      La page Gérer les valeurs de processus exposées de la console Process Admin inclut un lien Retour d'information qui utilise cette adresse de messagerie.

    3. Dans la zone Description externe , entrez une description de l'EPV pour les utilisateurs.
      La description que vous entrez ici apparaît dans la page Gérer les valeurs de processus exposées de Process Admin Console.
  5. Ajoutez une ou plusieurs variables à l'EPV en procédant comme suit :
    1. Dans la section Variables de valeur de processus exposées , cliquez sur + pour ajouter une variable à cette EPV.

      Par exemple, si vous souhaitez permettre aux utilisateurs d'ajuster les montants en Euro qui correspondent aux différents niveaux d'approbateur pour un processus de remboursement de frais, ajoutez une variable pour chaque niveau disponible.

    2. Dans la section Détails de la variable , dans la zone Nom externe , entrez le nom de la variable pour les utilisateurs.
      Ce nom apparaît dans la liste des variables de cette valeur de processus exposée dans Process Admin Console.
    3. Dans la zone Nom de variable , entrez le nom de la variable à traiter en interne.
      Remarque: Les noms de variable doivent commencer par une lettre minuscule et les mots suivants doivent être mis en majuscules, comme dans l'exemple suivant: myVar. N'utilisez pas d'espace dans les noms de variable. Les noms de variable distinguent les majuscules des minuscules.
    4. Dans la zone Description externe , entrez le texte décrivant cette variable aux utilisateurs.
      Cette description apparaît dans la liste des variables de cette valeur de processus exposée dans Process Admin Console.
    5. Facultatif: Dans la zone de texte Valeur par défaut , entrez une valeur par défaut valide pour cette variable.
    6. Pour activer les tâches en cours afin d'utiliser la valeur mise à jour de cette variable lorsque les utilisateurs édite sa valeur, cochez la case Utiliser de nouvelles valeurs .
    7. Pour sélectionner un type de variable, cliquez sur Sélectionner ... et sélectionnez un objet métier ou cliquez sur Nouveau pour créer un nouvel objet métier personnalisé (type de variable).
      Remarque: Vous devez être prudent lorsque vous utilisez un type non chaîne pour les variables EPV. L'utilisation de types autres que des chaînes n'est pas recommandée et peut entraîner des problèmes de conversion de type JavaScript. Si vous devez utiliser un type autre qu'une chaîne pour des variables EPV, consultez la section "Exemple" ci-dessous.
  6. Dans la section Exposition , cliquez sur Sélectionner pour choisir l'équipe dont les membres peuvent gérer cette EPV et ajuster ses valeurs de variable.

    Par défaut, une EPV n'est exposée à aucune équipe. Vous devez exposer une EPV en sélectionnant une équipe afin d'éditer les valeurs de l'EPV. L'EPV peut uniquement être modifiée par l'équipe sélectionnée dans la Console d'administration de processus. Les administrateurs ne peuvent pas modifier l'EPV. Une fois l'EPV exposée à une équipe spécifique, vous pouvez modifier le contenu de l'équipe lors de l'exécution à l'aide des méthodes standard de modification d'équipe. Pour plus d'informations sur les EPV, voir la rubrique Gestion des valeurs de processus exposées (EPV).

  7. Cliquez sur Enregistrer ou sur Terminer l'édition.
    Pour plus d'informations sur la déclaration de variables pour les services humains côté client, voir Déclarer des variables

Résultats

La valeur EPV est créée. Vous pouvez la lier à un processus, un service ou un rapport.

Vous pouvez faire référence au nom de l'EPV et à ses variables, comme dans l'exemple suivant: tw.epv.[epv_name].[epv_variable_name].

Vous pouvez utiliser la valeur EPV dans une passerelle de décision pour contrôler le flux d'un processus. Vous pouvez également vous référer à la valeur EPV à partir de tout code JavaScript d'un processus lié, comme le code d'un composant de service de script de serveur.

Exemple

Pour utiliser un type entier ou décimal pour une variable EPV (plutôt que le type de chaîne recommandé), créez une variable locale correspondante de type entier ou décimal. L'opération doit alors être exécutée sur la variable locale, par exemple

tw.local.number = tw.epv.myepvs.number; tw.local.number = tw.local.number + 1;

Sinon, pour utiliser des variables EPV dans du code JavaScript, utilisez le type de transtypage, par exemple

var mynumber = parseFloat(tw.epv.myepvs.number);

Vous pouvez également utiliser une variable complexe en transtypant la variable EPV vers le type que vous utilisez. Par exemple

// for a string use the following:
 tw.local.myString = String(tw.epv.kbexample.myString);
 // for an integer use:
 tw.local.myInt = Number(tw.epv.kbexample.myInt);
 //for a boolean use:
 tw.local.myBoolean = String(tw.epv.kbexample.myBoolean);
Remarque: Vous devez effectuer un transtypage vers une chaîne comme si vous effectuez un transtypage vers une valeur booléenne qui renvoie toujours true. Lorsqu'elle est affectée à une valeur booléenne, la chaîne obtenue est implicitement convertie en valeur booléenne.

Etape suivante

Après avoir créé une EPV, vous pouvez la lier à un processus ou à un service en la sélectionnant dans la liste des variables de processus exposées de l'onglet Variables.