Utilisation de tableaux de référence et d'une logique dynamique dans Salesforce Spiff

Utilisation de tableaux de référence au lieu d'instructions IF imbriquées

Lorsque la logique de commission nécessite de mapper une entrée avec un taux ou un niveau, par exemple un pourcentage de réalisation du quota mappé avec un taux d'accélération, une première approche courante consiste à écrire une série d'instructions de if(). Cette approche fonctionne pour un petit nombre de niveaux. Cependant, il devient difficile à mesure que le nombre de conditions augmente, et chaque modification d'un niveau nécessite de modifier directement la formule.

Les tableaux de référence résolvent ce problème en stockant le mappage sous forme de données. Le calcul référence le tableau, référence la ligne applicable en fonction de la valeur d'entrée et renvoie la sortie associée. L'ajout, le retrait ou la modification d'un niveau implique la mise à jour du tableau, pas de la formule.

Utilisez des tableaux de référence dans ces situations.

• Votre logique de commission nécessite plusieurs branches conditionnelles.
• Les taux ou les seuils sont déterminés par des dates, des territoires, des familles de produits ou d'autres attributs qui changent entre les périodes.
• Plusieurs plans partagent la même structure tarifaire et une seule source de vérité.

Stockage de montants variables dans des champs de feuille de calcul

Les chiffres codés en dur dans les formules de commission créent des dépendances masquées. Lorsqu'un taux, un seuil ou un montant de quota change, le moteur doit rechercher et mettre à jour chaque formule qui contient la valeur. Les occurrences manquées entraînent des versements incorrects.

Stockez les montants de variables dans des champs de feuille de calcul et référencez ces champs dans vos formules. Lorsqu'une valeur change, mettez à jour le champ de la feuille de calcul à un emplacement unique. Toutes les formules qui la référencent sont automatiquement recalculées lors de l'exécution de l'instruction suivante.

Les champs de feuille de calcul conviennent à ces types de valeur.

• Taux de commission fixes ou multiplicateurs qui s'appliquent à l'ensemble d'un plan.
• Montants de seuil, tels que la taille minimale des affaires ou les objectifs de quota.
• Listes courtes de valeurs, telles que des familles de produits éligibles ou des codes de région.

Conseil Saisissez des noms clairs et explicites pour les champs de feuille de calcul qui communiquent leur objet. Un champ nommé Q1MinDealSizeThreshold est plus facile à trouver et à auditer qu'un champ nommé Threshold1.

Utilisation de périodes de relevé pour des dates clés

Les calculs de commission référencent souvent des dates telles que le début d'un trimestre, la fin d'un exercice ou une date de report spécifique pour une nouvelle structure de régime. Si vous codez en dur ces dates, chaque période nécessite des mises à jour manuelles de la formule avant l'exécution du calcul.

Utilisez des dates de période d'instruction et des calculs de feuille de calcul pour rendre la logique de date dynamique.

• Stockez les dates clés, telles que le début du trimestre, la fin du trimestre, le début et la fin du premier semestre, et le début et la fin du deuxième semestre, dans une feuille de calcul unique dédiée. Référencez ces champs de n'importe quel calcul qui nécessite la date.
• Évitez de créer des calculs de feuille de calcul individuels pour chaque valeur mensuelle d'une série. Par exemple, la création de champs JanARR, FebARR et MarARR séparés n'est pas recommandée. Renvoyez ces valeurs dynamiquement à partir d'un filtre de données et utilisez à la place des conditions de plage de dates.
• Utilisez les variables de période d'instruction intégrées (BeginningOfPeriod, EndOfPeriod) comme base de calcul de date dans la mesure du possible. Par conséquent, la logique s'adapte automatiquement lorsque des instructions sont générées pour différentes périodes.

Choix du niveau approprié pour vos calculs

Déterminez si un calcul appartient au niveau de la feuille de calcul ou de la feuille de données avant de l'élaborer.

Chaque niveau sert un objectif différent dans votre plan de commission.

• Calculs de feuille de calcul. Convient aux valeurs qui s'appliquent à l'ensemble du relevé : prix fixes, totaux entre les affaires, quotas au niveau de la période et autres valeurs qui ne sont pas associées à des enregistrements individuels. Les calculs de feuille de calcul produisent une sortie unique pour le contexte de l'instruction.
• Calculs de feuille de données. Convient aux valeurs qui nécessitent un calcul enregistrement par enregistrement : montants de commission au niveau de l'affaire, indicateurs d'éligibilité par enregistrement ou tout calcul dans lequel la sortie varie entre les enregistrements individuels. Lorsqu'un paiement final est une somme de montants au niveau de l'enregistrement, effectuez le calcul dans la feuille de calcul et agrégez le résultat dans la feuille de calcul.

Utilisation de fonctions auxiliaires pour simplifier la syntaxe

Spiff fournit des fonctions auxiliaires qui remplacent les fonctions standard complexes et à arguments multiples par une syntaxe plus simple et plus lisible. Les fonctions auxiliaires sont interchangeables avec leurs équivalents standard et produisent le même résultat, mais elles réduisent le risque d'erreurs de syntaxe et facilitent la lecture des formules pendant l'implémentation et l'audit.

Lorsque vous rencontrez une fonction complexe qui nécessite de nombreux arguments ou appels imbriqués, vérifiez si une fonction d'aide est disponible pour ce cas d'utilisation. Les fonctions d'assistance sont particulièrement utiles lors d'une version initiale lorsque la vitesse et la lisibilité sont importantes.