Événements système

Les événements système sont des comportements fréquemment utilisés, disponibles pour les clients prêts à l’emploi.

Transaction (en-tête)

Lorsque Transaction Manager (Gestionnaire de transactions) est intégré à un CRM, un bouton s’affiche dans l’interface utilisateur du CRM correspondant à ces événements de transaction. Lorsque l’utilisateur clique sur l’un de ces boutons, le CRM appelle l’API correspondante CPQ :

• Créer une transaction : événement déclenché pour créer une nouvelle transaction.
• Modifier la transaction : permet de modifier une transaction existante, en activant une règle basée sur l’étape et des actions d’intégration.
• Copier la transaction : événement permettant de cloner une transaction et ses éléments de ligne.
• Mettre à jour et insérer des lignes : cet événement gère la création/la mise à jour des lignes de transaction après que l’utilisateur a parcouru le catalogue (effet d’interface utilisateur « productSearch ») pour ajouter de nouvelles lignes ou reconfigurer une ligne existante. La mise à jour et l’insertion des lignes s’exécute automatiquement une fois que l’utilisateur a terminé de sélectionner des produits dans le catalogue, de configurer des produits ou de les reconfigurer (effet d’interface utilisateur « reconfigurer »). Bien que cet événement fonctionne sur les lignes de la transaction, il fonctionne au niveau de la transaction, sur toutes les lignes de la transaction.

  Pour plus d’informations sur les effets d’interface utilisateur, reportez-vous à la section Gestionnaire des transactions : mises en page : effets d’interface utilisateur.

• Supprimer la transaction : événement déclenché pour supprimer une transaction existante.

Ligne de transaction :

Les événements de niveau ligne de Transaction Manager sont représentés sur l’interface utilisateur native CPQ de Transaction Manager sous forme de boutons :

• Ligne clone : clone une ligne et ses enfants, mais uniquement pour les lignes de niveau supérieur de la transaction. Les règles au niveau de l’en-tête s’appliquent également après le clonage.
• Supprimer des lignes : supprime une ou plusieurs lignes d’une transaction ; L’interface utilisateur prend en charge la sélection de lignes et les ID peuvent être transmis en mode sans en-tête.

API d’événements

Les API d’événements sont autorisées uniquement via un cookie de session.

Événements personnalisés

Outre les événements système, l’administrateur peut définir des événements personnalisés pour répondre aux besoins spécifiques de l’entreprise. Pour créer un événement personnalisé, procédez comme suit.

1. Dans Administrateur de Transaction Manager, cliquez sur Événements, puis sur + Nouvel événement.

   

2. Dans la fenêtre Nouvel événement, saisissez un nom. Au fur et à mesure que le nom est saisi, il est reflété dans le champ Variable Name (Nom de variable ). Par défaut, le nom de la variable est le même que le nom saisi, mais en majuscule avec tous les espaces et les caractères spéciaux supprimés. Par exemple, si vous saisissez le nom Total of Manufacturing Lines, le nom de variable saisi automatiquement est totalOfManufacturingLines. Pour créer un nom de variable personnalisé, cliquez sur l’icône en forme de crayon à droite du champ de nom de variable et entrez votre propre valeur.

   

3. Sélectionnez le niveau Ligne de transaction , puis cliquez sur Enregistrer.

L’éditeur d’événements s’ouvre. Par défaut, l’accès aux événements est défini sur Aucun accès. Cliquez sur Modifier l’accès à l’événement, changez le niveau d’accès à l’événement en Actif, puis cliquez sur Terminé pour revenir à l’éditeur d’événement.

Dans la zone Actions, vous pouvez affecter des groupes de règles ou des intégrations à déclencher lorsque l’événement est déclenché. Pour ajouter une nouvelle action à l’événement, cliquez sur + Ajouter une nouvelle action et choisissez Regroupements de règles ou Intégration. Un menu répertoriant les regroupements ou intégrations de règles disponibles s’affiche. Choisissez le regroupement ou l’intégration de règles à appliquer à l’événement. Vous pouvez ajouter plusieurs groupes de règles ou intégrations au même événement.

Utilisez le bouton bascule Transition pour déterminer si l’événement fait avancer ou reculer la transaction dans la séquence d’étapes. Par défaut, l’événement ne fait pas passer la transaction à une autre étape. Cliquez sur le bouton Transition pour activer la fonction de transition.

Lorsque vous avez terminé, cliquez sur Enregistrer. Le nouvel événement apparaît dans la liste des événements sous la forme d’un événement au niveau de la transaction ou d’un événement au niveau de la ligne de transaction, selon le niveau que vous avez choisi lors de la création de l’événement.

Paramètres de l’événement : Valider les éléments configurés

Le paramètre Valider les éléments configurés sur les événements d’en-tête personnalisés valide les configurations de produit dans la transaction lorsque l’événement s’exécute. La validation a lieu avant les actions d’événement, qui s’exécutent quel que soit l’état de validation.

Le paramètre inclut une période de validité qui exclut les produits validés dans un délai donné. Par exemple, si la période de validité est définie sur 15 jours et qu’un produit a été validé il y a 7 jours, la configuration du produit n’est pas validée. Si un produit a été validé il y a 20 jours, sa configuration est validée.

Deux champs système au niveau de la ligne prennent en charge cette fonction : txn.line.configuration.status (booléen) et txn.line.configuration.validatedAt (date).