Scripts clients du catalogue

Les scripts côté client peuvent ajouter des effets dynamiques et une validation aux formulaires. Les scripts peuvent s’appliquer à des éléments de catalogue de services ou à des jeux de variables, ce qui permet aux administrateurs d’utiliser les mêmes fonctionnalités que celles disponibles dans d’autres formulaires.

Vous pouvez utiliser des scripts côté client pour :

• Obtenir ou définir des valeurs de variables.
• Masquer ou afficher les variables.
• Rendre les variables obligatoires ou non.
• Validez l’envoi du formulaire.
• Ajouter quelque chose au panier.
• Commandez quelque chose immédiatement.

Considérations relatives aux scripts clients de catalogue

Lorsque vous créez des scripts clients de catalogue, tenez compte des considérations suivantes.

• Les scripts clients de catalogue s’exécutent lorsqu’un utilisateur commande un élément à partir du catalogue de services. Les scripts clients de catalogue peuvent également s’exécuter lorsque des variables ou des jeux de variables d’un élément de catalogue sont affichés lorsqu’un utilisateur demande cet élément.
• Pour qu’une variable soit accessible à l’aide d’un script client de catalogue, elle doit avoir un nom de variable. Les variables sans nom n’apparaissent pas dans la liste des variables disponibles.
• Lorsque vous utilisez des scripts clients standard sur un élément demandé ou un formulaire de tâche du catalogue, notez les champs portant le même nom que les variables. Si un champ de table et une variable du même nom sont tous deux présents dans un formulaire, le champ de table est mis en correspondance lorsque l’accès y a été effectué à l’aide d’un script. Si cela se produit, adressez spécifiquement la variable en la nommant variables.nom de variable. Par exemple : g_form.setValue('variables.replacement', 'false') ;
• Si vous utilisez des créateurs d’enregistrement pour transmettre des variables du catalogue de services à d’autres types d’enregistrements, ces variables sont rendues visibles dans ces enregistrements à l’aide d’un éditeur de variables, tel que le formateur d’interface utilisateur de l’éditeur de variable de changement sur les formulaires de demande de changement. Vous pouvez manipuler ces variables à l’aide de méthodes de script client standard, telles que setDisplay, setMandatory, setValue et getValue.
• Les scripts clients de catalogue peuvent être utilisés pour les éléments de catalogue inclus dans un assistant.
• Vous pouvez utiliser l’API g_form.refreshSlushbucket(fieldName) pour mettre à jour une variable de collecteur de liste.

Différences de scripts clients du catalogue

Les scripts clients de catalogue sont très similaires aux scripts clients standard, à quelques différences près.

• Au lieu de sélectionner une table telle que Incident pour le script, sélectionnez un élément de catalogue ou un jeu de variables. Votre système pouvant comporter un grand nombre d’éléments de catalogue, vous devez sélectionner un élément de catalogue ou un jeu de variables à l’aide d’un champ de référence au lieu de la liste de choix utilisée par le formulaire de script client standard.
• Lors de l’utilisation d’un script client de catalogue onChange(), il est lié à une variable particulière au lieu d’un champ. Le système remplit automatiquement la liste de sélection des noms de variables avec les variables nommées de l’élément de catalogue ou du jeu de variables sélectionné.

Créer un script client de catalogue

Suivez cette procédure pour créer un script client de catalogue.

Procédure

1. Accédez à la Tout > Catalogue de services > Administration des catalogues > Scripts clients du catalogue.
   Une liste des scripts clients actuels du catalogue personnalisé s'affiche.
2. Cliquez sur Nouveau.
3. Renseignez les champs comme il convient (voir la table).

   Champ	Description
   Nom	Entrez un nom unique pour le script client du catalogue.
   Concerne	Sélectionnez le type d’élément auquel ce script client s’applique : Un élément de catalogue : active le champ Élément de catalogue. Un jeu de variables : active le champ Jeu de variables.
   Actif	Cochez cette case pour activer le script client. Décochez la case pour désactiver le script.
   Type d'interface utilisateur	Indique s’il faut l’appliquer à un ordinateur de bureau, un appareil mobile ou les deux.
   Script	Entrez le script client qui doit s’exécuter sur l’élément de catalogue de services.
   Type	Sélectionnez le moment où le script doit s’exécuter, par exemple onLoad ou onSubmit.
   Élément de catalogue ou jeu de variables	Sélectionnez un élément de catalogue ou un jeu de variables dans la liste. Le nom du champ et les options disponibles dépendent de la sélection dans le champ S'applique à.
   S'applique sur une vue d'élément de catalogue	Cochez la case pour appliquer le script client du catalogue aux éléments de catalogue affichés dans l’écran de commande du catalogue de services. Disponible dans la vue du demandeur.
   S'applique sur des éléments demandés	Cochez la case pour appliquer le script client du catalogue sur un formulaire d’élément demandé, une fois l’élément demandé. Disponible dans la vue du prestataire. Voir VEditor .
   S'applique sur des tâches du catalogue	Cochez la case pour appliquer le script client du catalogue lorsqu’un formulaire de tâche du catalogue est affiché pour l’élément. Disponible dans la vue du prestataire. Voir VEditor .
   S'applique sur l'enregistrement cible	Case à cocher pour prendre en charge la politique d'interface utilisateur du catalogue sur un enregistrement créé pour les tables de tâche étendues via des créateurs d'enregistrement. Reportez-vous à la section Éditeur de variables par défaut .

4. Cliquez sur Envoyer.

Exemples de scripts clients de catalogue

Exemples de scripts clients pour effectuer des actions courantes.

Obtenir la valeur d’une variable

Pour obtenir la valeur d’une variable de catalogue, utilisez la syntaxe suivante. Notez que la variable doit avoir un nom. Remplacez variable_name par le nom de la variable.

g_form.getValue('variable_name');

Limiter le nombre de caractères qu’un utilisateur peut saisir dans une variable

Il s’agit d’un exemple de script qui s’exécute lorsque la variable est affichée, plutôt que lorsque l’élément est commandé.

function onLoad(){
  var sd = g_form.getControl('short_description');
  sd.maxLength=80;
}