Utiliser les scripts de projet

Cette section décrit comment utiliser les scripts de projet pour personnaliser l’interface utilisateur du Client Web, afin que les utilisateurs finaux puissent interagir avec le Client Web comme ils le souhaitent.

Dans cette rubrique :

• Présentation des scripts de projet
• Préalablement à l’écriture de scripts de projet
• Écriture de scripts de projet
• Exemples
• Déboguer les scripts de projet
• Limitations

Présentation des scripts de projet

Vous écrivez des scripts de projet afin d’automatiser les tâches courantes et personnaliser la manière dont les utilisateurs finaux interagissent avec le Client Web.

Les scripts de projet sont déclenchés par des événements lorsque ceux-ci sont associés aux actions utilisateur. Lors d’une session ALM Client Web, lorsqu’un utilisateur initie une action, comme cliquer sur un bouton ou modifier un champ, l’événement correspondant est déclenché et se comporte selon le code JavaScript défini dans l’événement.

Entités prises en charge

Vous pouvez personnaliser les flux de travail dans le Client Web pour les entités suivantes :

Entité	Description
Req	Données sur les besoins
Test	Données de tests
TestFolder	Données du dossier de test
DesignStep	Données d’étape de conception de tests
TestSet	Données de campagne de test
TestSetFolder	Données du dossier de campagnes de test
TestSetTests	Données d’instance de test
Run	Données d’exécution de tests
Bug	Données d’anomalie
Step	Données d’étape d’exécution de tests manuels
Release	Données de release
Cycle	Données sur le cycle de release
ReleaseFolder	Données du dossier de validation

Retour en haut

Préalablement à l’écriture de scripts de projet

Avant d’écrire des scripts de projet, vous devez vous familiariser avec les événements, les objets et les propriétés.

Événements des scripts de projet

Placez votre code dans l’événement approprié afin qu’il soit invoqué lorsqu’une action d’utilisateur pertinente est initiée.

Pour plus d’informations sur les événements, consultez la rubrique Événements.

Objets des scripts de projet

Vos scripts effectuent des personnalisations en se basant sur les informations obtenues à partir des objets pertinents, telles que les informations relatives au champ et à l’utilisateur.

Pour plus d’informations, voir Objets.

Propriétés des scripts de projet

Vous pouvez utiliser les propriétés ActiveModule et ActiveDialogName pour obtenir des informations sur le module et la boîte de dialogue actifs.

Pour plus d’informations, consultez la rubrique Propriétés ActiveModule et ActiveDialogName.

Retour en haut

Écriture de scripts de projet

Pour écrire des scripts de projet, ajoutez du code JavaScript aux événements qui sont déclenchés par les actions utilisateur. Par exemple, l’événement Nouveau est déclenché lorsqu’une entité est ajoutée au Client Web.

Pour écrire des scripts pour un événement :

1. Dans la bannière Client Web, cliquez sur Paramètres > Flux de travail.

2. Dans l’onglet Éditeur de script, dans l’arborescence des scripts du projet, sous le nœud Scripts de flux de travail > Scripts de projet, développez le module cible et sélectionnez l’événement auquel vous souhaitez ajouter du code, en fonction du moment où vous souhaitez que votre code soit déclenché.

   • Pour écrire du code pouvant être utilisé par d’autres événements dans le même module, recherchez un événement <module>_SharedFunction.

   • Pour écrire du code pouvant être utilisé par des événements dans plusieurs modules, recherchez l’événement Script commun > SharedFunction.

   Pour des informations détaillées sur les événements, consultez la rubrique Événements.

3. Ajoutez votre code JavaScript à l’événement.

   Consultez la rubrique Exemples pour obtenir des exemples.

   Note : Si vous écrivez des chaînes de date dans les scripts, assurez-vous que le format de la chaîne de date est cohérent avec le paramètre de format de date de votre navigateur.

   Par exemple, si votre navigateur définit le format de chaîne de date sur AAAA/MM/JJ, utilisez le même format pour les chaînes de date dans vos scripts.

4. Cliquez sur Enregistrer.

Retour en haut

Exemples

Le tableau suivant fournit quelques exemples pour vous aider à rédiger vos propres scripts de projet.

Tâche de flux de travail	Exemples
Personnaliser la boîte de dialogue	Exemple : Modifier les noms des onglets de la boîte de dialogue Détails de l’entité Exemple : Personnaliser les champs de la boîte de dialogue Nouvelle anomalie
Automatiser la valeur du champ	Exemple : Ajouter un modèle à un champ mémo Exemple : Modifier un champ en fonction du groupe d’utilisateurs Exemple : Modifier un champ basé sur un autre champ
Valider les données	Exemple : Valider si une entité peut être mise à jour dans des cas spécifiques Exemple : Valider un champ
Personnaliser le champ dynamique	Exemple : Présenter une liste de champs dynamique Exemple : Modifier les propriétés du champ lorsqu’un champ est modifié
Contrôler l’autorisation utilisateur	Exemple : Empêcher les utilisateurs d’effectuer une action

Retour en haut

Déboguer les scripts de projet

Vous pouvez déboguer un script de flux de travail pour résoudre ses erreurs.

Pour déboguer un script de flux de travail :

1. Dans l’arborescence des scripts de projet, sélectionner le script de flux de travail.

2. Dans la zone de l’éditeur, ajouter la déclaration suivante :

   Copy code

   debugger;
   console.log("<script_name> triggered");Copy Code

   Par exemple :

   Copy code

   function Bug_New() {
     debugger;
     console.log("Bug_New triggered");
   }Copy Code

3. Appuyer sur la touche F12 pour ouvrir la console du navigateur.

4. Déclencher le script dans le Client Web.

   Par exemple, cliquez sur le bouton Créer dans la fenêtre Nouvelle anomalie.

5. Déboguer le script dans la console du navigateur.

Retour en haut

Limitations

Les scripts de flux de travail comportent les limitations suivantes :

• Tous les objets ou méthodes qui sont automatiquement suggérés lors de la modification du script ne peuvent pas être appelés. Une erreur se produit si vous appelez un objet ou une méthode non pris en charge.

• Certains scripts répertoriés dans l’arborescence des scripts de projet ne sont pas disponibles pour utilisation. Ils sont affichés en gris.

Voir aussi :

• Écriture de scripts de projet avancés