Scripts clients du catalogue

Les scripts côté client peuvent ajouter des effets dynamiques et une validation aux formulaires. Les scripts peuvent s’appliquer aux éléments de catalogue de services ou aux jeux de variables, ce qui permet aux administrateurs d’utiliser les mêmes fonctionnalités que celles disponibles sur 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 la soumission du formulaire.
• Ajoutez quelque chose au panier.
• Commandez quelque chose immédiatement.

Considérations relatives au script client du catalogue

Lorsque vous créez des scripts clients de catalogue, gardez à l’esprit les considérations suivantes.

• Les scripts clients du 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 lorsqu’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 noms n’apparaissent pas dans la liste des variables disponibles.
• Lorsque vous utilisez des scripts clients standard sur un formulaire Élément demandé ou 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 les deux présents sur un formulaire, le champ de table est mis en correspondance lorsque vous y accédez à l’aide d’un script. Si cela se produit, traitez spécifiquement la variable en la nommant variable.variable name. Par exemple : g_form.setValue('variables.replacement', 'false') ;
• Si vous utilisez des créateurs d’enregistrements pour transmettre des variables du catalogue de services à d’autres types d’enregistrements, ces variables sont rendues visibles dans ces enregistrements avec un éditeur de variables, tel que le formateur d’interface utilisateur É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, avec quelques différences importantes.

• Au lieu de sélectionner une table telle qu’Incident pour le script, sélectionnez un élément de catalogue ou un jeu de variables. Étant donné que votre système peut contenir 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 toutes 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	S’il faut appliquer cette option à 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, tel que 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 sur 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 que l’élément a été demandé. Disponible dans la vue du prestataire. Voir Éditeur .
   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 Éditeur .
   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. Voir Éditeur de variable par défaut .

4. Cliquez sur Envoyer.

Exemples de scripts clients de catalogues

Exemples de scripts clients pour effectuer des actions courantes.

Obtenir la valeur d’une variable

Utilisez la syntaxe suivante pour obtenir la valeur d’une variable de catalogue. 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, et non lorsque l’élément est commandé.

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