Gestionnaire des transactions : champs
Comprenez les cinq principales options de type de champ : texte, numéro, booléen, liste déroulante et date/heure. Découvrez comment créer de nouveaux champs à l’aide de l’interface utilisateur de l’administrateur.
Dans Transaction Manager, les administrateurs peuvent créer des champs de texte, de nombre, de booléen, de liste déroulante et de date/heure. Les administrateurs ont également le choix de créer des champs au niveau de la transaction ou de la ligne de transaction.
Les champs créés au niveau de la transaction se trouvent en dehors de la grille de la ligne de transaction. Ces champs contiennent généralement des informations sur le compte, les adresses, le prix catalogue total, la remise totale et le total net de tous les éléments de ligne.
Les champs créés au niveau de la ligne de transaction se trouvent dans la grille de la ligne de transaction. Ceux-ci peuvent apparaître sous forme de champs de colonne ou de champs dans les effets d’interface utilisateur Détails de ligne, Modèle et Glissement vers l’extérieur.
En fin de compte, le niveau sélectionné aura un impact sur la disponibilité du champ pour les règles, qui ont également un niveau de transaction et de ligne de transaction.
Dans la capture d’écran buyside ci-dessous, les sections marquées 1 sont des champs au niveau de la transaction ; Les champs de la section marquée 2 sont des champs de niveau ligne de transaction.
Types de champs
Le gestionnaire des transactions fournit les types de champs suivants.
- Texte
- Numéro
- Booléen
- Liste déroulante
- Date/Heure
Les options pour ces types sont décrites dans les sections qui suivent.
Champs fournis par le système
Transaction Manager fournit à l’administrateur un ensemble de champs fournis par le système qui sont souvent utilisés dans le traitement des transactions. Il existe des champs fournis par le système au niveau de la transaction et de la ligne de transaction.
Les champs fournis par le système contiennent des champs dans les catégories suivantes :
Niveau de la transaction :
- Informations de tarification
- Informations sur l’opportunité
- Informations sur la transaction
- Informations sur le compte
Pour obtenir la liste complète des champs au niveau des transactions, reportez-vous à la section Gestionnaire des transactions : champs système au niveau des transactions.
Niveau de la ligne de transaction :
- Informations de tarification
- Informations sur la ligne de transaction
- Informations de configuration
- Informations sur le produit
- Informations sur la commande
Pour obtenir la liste complète des champs au niveau de la ligne, reportez-vous à la section Gestionnaire des transactions : champs système au niveau de la ligne.
Vous pouvez également ajouter des champs personnalisés à un plan dans Transaction Manager. Les champs personnalisés ajoutés via l’interface utilisateur de l’administrateur du gestionnaire de transactions sont automatiquement associés au plan. Toutefois, les champs personnalisés chargés à l’aide du chargeur de matrice doivent être associés au plan au moyen du fichier blueprint.yaml. Pour ce faire, ajoutez une liste au fichier blueprint.yaml qui détaille les noms de variables de champ à associer au plan.
L’exemple de fichier blueprint.yaml suivant montre les associations de champs dans la section relatedFields :
---
blueprints:
- variableName: default
relatedFields:
- txn.custom.transactionNumber
- txn.custom.quoteName
- txn.custom.quoteValidUntil
- txn.custom.paymentTerm
- txn.custom.accountSpecificDiscount
- txn.custom.agreementDiscount
- txn.line.custom.agreementLineDiscount
- txn.line.custom.customerLineDiscount
lastModifiedBy: mark@logik.io.sfdcdev
name: Transaction Manager Default
stages: /blueprints/default/stages/stage.yaml
description: Transaction Manager Default blueprint
layouts: null
events: /blueprints/default/events/events.csv
views: /blueprints/default/views/views.yaml
fieldOptions: /fields/fieldOptions.csv
rules: null
fields: /fields/fields.csv
Création d’un nouveau champ à l’aide de l’interface utilisateur de l’administrateur
Pour ajouter un nouveau champ au plan du gestionnaire de transaction, procédez comme suit :
-
Accédez à l’interface utilisateur de l’administrateur de Transaction Manager.
- Cliquez sur Champs associés.
- Cliquez sur Créer un champ pour créer un nouveau champ.
La boîte de dialogue Nouveau champ s’ouvre.
- Entrez un nom dans le champ 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 Adresse de facturation client, le nom de variable entré automatiquement est customerBillingAddress. 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.
- Sélectionnez un niveau pour choisir s’il s’agit d’un champ au niveau de la transaction ou de la ligne de transaction.
- Choisissez le type de champ que vous créez parmi les cinq types de champs disponibles.
- Cliquez sur Enregistrer.
La page de l’éditeur de champ s’ouvre. Sélectionnez les options souhaitées.
Options de champ de texte
Le nom et le nom de la variable s’affichent en haut à gauche de la page de l’éditeur de champs. Vous pouvez changer le nom, mais le nom de la variable est verrouillé et ne peut être modifié qu’en supprimant le champ et en l’ajoutant à nouveau au plan. Vous pouvez éventuellement ajouter une description du champ ici. Si le champ doit être obligatoire dans la mise en page côté achat, basculez le commutateur requis .
Le champ Accès par défaut contrôle l’accès à ce champ dans la vue par défaut. Modifiable rend ce champ accessible en lecture/écriture. Si vous sélectionnez Aucun accès, le champ est masqué sur la mise en page buy-side et n’est pas accessible via les API.
Vous pouvez entrer une valeur par défaut pour le champ de texte dans le champ Valeur par défaut .
Les valeurs Longueur minimale du champ et Longueur maximale du champ vous permettent de définir le nombre minimal et maximal de caractères qui peuvent être saisis.
Options de champ de numéro
Le nom et le nom de la variable s’affichent en haut à gauche de la page de l’éditeur de champs. Vous pouvez changer le nom, mais le nom de la variable est verrouillé et ne peut être modifié qu’en supprimant le champ et en l’ajoutant à nouveau au plan. Vous pouvez éventuellement ajouter une description du champ ici. Si le champ doit être obligatoire dans la mise en page côté achat, basculez le commutateur requis .
Le champ Accès par défaut contrôle l’accès à ce champ dans la vue par défaut. Modifiable rend ce champ accessible en lecture/écriture. Si vous sélectionnez Aucun accès, le champ est masqué sur la mise en page buy-side et n’est pas accessible via les API.
Les champs de nombres peuvent prendre l’une des trois formes suivantes : nombre, devise ou pourcentage. Choisissez la forme que vous souhaitez donner au champ.
Le champ Étiquette de l’unité vous permet de spécifier l’étiquette de l’unité pour le champ numérique. Si le champ est destiné à la devise, l’étiquette de l’unité est le symbole de devise par défaut de votre CPQ site. Si le champ est un pourcentage, l’étiquette de l’unité est le symbole de pourcentage ( %).
Les champs Valeur minimale et Valeur maximale vous permettent de définir les valeurs minimales et maximales autorisées pour le champ.
Vous pouvez entrer une valeur par défaut pour le champ Number (Numéro) dans le champ Default Value (Valeur par défaut ).
Options de champ booléen
Le nom et le nom de la variable s’affichent en haut à gauche de la page de l’éditeur de champs. Vous pouvez changer le nom, mais le nom de la variable est verrouillé et ne peut être modifié qu’en supprimant le champ et en l’ajoutant à nouveau au plan. Vous pouvez éventuellement ajouter une description du champ ici. Si le champ doit être obligatoire dans la mise en page côté achat, basculez le commutateur requis .
Le champ Accès par défaut contrôle l’accès à ce champ dans la vue par défaut. Modifiable rend ce champ accessible en lecture/écriture. Si vous sélectionnez Aucun accès, le champ est masqué sur la mise en page buy-side et n’est pas accessible via les API.
Vous pouvez définir si la valeur par défaut du champ Booléen est True (Vrai) en définissant l’option Default Checked (Vérifié par défaut ). Si l’option n’est pas définie, le champ est défini par défaut sur False.
Dans le champ True Label , vous pouvez définir la valeur de texte du champ lorsque la valeur booléenne est Vrai. Par exemple, vous pouvez définir la valeur affichée sur « Oui » lorsque la valeur est Vrai. De même, le champ False Label vous permet de définir le texte lorsque la valeur du champ est False.
Options de champs de liste déroulante
Le nom et le nom de la variable s’affichent en haut à gauche de la page de l’éditeur de champs. Vous pouvez changer le nom, mais le nom de la variable est verrouillé et ne peut être modifié qu’en supprimant le champ et en l’ajoutant à nouveau au plan. Vous pouvez éventuellement ajouter une description du champ ici. Si le champ doit être obligatoire dans la mise en page côté achat, basculez le commutateur requis .
Le champ Accès par défaut contrôle l’accès à ce champ dans la vue par défaut. Modifiable rend ce champ accessible en lecture/écriture. Si vous sélectionnez Aucun accès, le champ est masqué sur la mise en page buy-side et n’est pas accessible via les API.
Selection Type (Type de sélection ) définit la liste de sélection comme un menu à sélection unique ou une sélection multiple.
Le type de comparaison vous permet de déterminer comment la valeur de l’option de menu est traitée lorsqu’elle est utilisée dans une comparaison : en tant que valeur de texte ou en tant que valeur numérique.
Le lien + Ajouter des options de liste déroulante vous permet d’ajouter la première option de menu à ce champ de menu de liste déroulante.
Lors de l’ajout d’une option de liste déroulante, tenez compte des valeurs de champ suivantes :
- Ordre
- Utilisez ce champ pour déterminer l’ordre des options de menu dans le menu. Plus le nombre est bas, plus la place est élevée dans le menu. En règle générale, numérotez vos options de menu 10, 20, 30, 40 et 50 au lieu de les numéroter de 1 à 5. Cela laisse de la place dans la séquence si vos nouveaux éléments doivent être insérés plus tard.
- Étiquette de l’option
- Nom de l’option que l’utilisateur voit dans la mise en page du gestionnaire de transactions.
- Valeur de l’option
- Valeur utilisée CPQ pour identifier cette option de menu.
- Sélectionné
- Détermine si une option de menu est la valeur de menu par défaut.
- Description
- Description de l’option de menu.
- URL de l'image
- URL d’une image graphique qui peut être affichée à la place du texte.
Cliquez sur Option d’enregistrement pour ajouter l’option à la liste des options du champ de la liste de sélection. Pour ajouter des options de menu supplémentaires, cliquez sur +Ajouter une option.
Options du champ de date/heure
Le nom et le nom de la variable s’affichent en haut à gauche de la page de l’éditeur de champs. Vous pouvez changer le nom, mais le nom de la variable est verrouillé et ne peut être modifié qu’en supprimant le champ et en l’ajoutant à nouveau au plan. Vous pouvez éventuellement ajouter une description du champ ici. Si le champ doit être obligatoire dans la mise en page côté achat, basculez le commutateur requis .
Le champ Accès par défaut contrôle l’accès à ce champ dans la vue par défaut. Modifiable rend ce champ accessible en lecture/écriture. Si vous sélectionnez Aucun accès, le champ est masqué sur la mise en page buy-side et n’est pas accessible via les API.
Le champ Valeur par défaut vous permet de définir le paramètre de date et d’heure par défaut pour le champ. La valeur est convertie en UTC au format AAAA-MM-JJTHH :MM :SSZ.
Les champs Ni avant ni après vous permettent de définir les valeurs de date et d’heure minimales et maximales du champ.
Pour plus d’informations sur le type de champ Date/Heure, reportez-vous à la section Gestionnaire des transactions : champs de date et d’heure.