Ignorer et passer au contenu principal
Avertissement : cet article est le résultat de la traduction automatique, l'exactitude et la fidélité de la traduction ne sont donc pas garanties. Pour consulter la version originale de cet article, en anglais, cliquez ici.

Créer des propriétés calculées

Dernière mise à jour: septembre 21, 2023

Disponible avec le ou les abonnements suivants, sauf mention contraire :

Marketing Hub Pro, Entreprise
Sales Hub Pro, Entreprise
Service Hub Pro, Entreprise
Operations Hub Pro
CMS Hub Pro, Entreprise

Les propriétés de calcul dans HubSpot vous permettent de calculer automatiquement le minimum, le maximum, le total, la somme ou la valeur moyenne pour les propriétés sur les fiches d'informations associées ou de configurer des équations personnalisées basées sur d'autres propriétés. 

Par exemple, vous pouvez créer :

  • une propriété de contact qui calcule le montant moyen des transactions associées à un contact ; 
  • une propriété d'entreprise qui calcule le coût d'acquisition d'un nouveau client sur la base d'une équation personnalisée.

Remarque : En fonction de votre abonnement HubSpot, le nombre de propriétés calculées que vous pouvez créer est limité.

Créer des propriétés calculées

Les propriétés de calcul peuvent être définies en fonction de différents critères, notamment les valeurs des propriétés des fiches d'informations associées, le temps écoulé entre les valeurs de deux propriétés ou vos propres équations personnalisées. Pour créer une propriété de calcul :

  • Depuis votre compte HubSpot, accédez à l'icône Paramètres settings dans la barre de navigation principale.
  • Dans le menu latéral de gauche, accédez à Propriétés.

  • Cliquez sur le menu déroulant Sélectionner un objet, puis sélectionnez Propriétés [objet] pour créer une propriété pour cet objet.

  • Saisissez les informations de base concernant votre propriété, puis cliquez sur Suivant.
  • Sélectionnez Calcul pour le type de champ. Une fois qu'une propriété Calcul est créée, le type de champ ne peut pas être modifié.
  • Cliquez sur Créer un calcul.
  • Sélectionnez le Type de propriété calculée que vous souhaitez utiliser depuis le menu déroulant :

Calculer des valeurs selon des propriétés de fiches d'informations associées

Vous pouvez créer des propriétés pour un objet qui seront calculées en fonction de certaines valeurs de propriétés de fiches d'informations associées à cet objet. Vous pouvez effectuer le calcul sur la base de toutes les fiches d'informations associées à cet objet ou pour des libellés d'association spécifiques, y compris les relations parent-enfant des entreprises.

Par exemple, vous pouvez créer une propriété de transaction qui comptabilise le nombre total d'activités de vente enregistrées pour les contacts associés à une transaction avec le libellé Décisionnaire.

  • Cliquez sur le menu déroulant Type de propriété calculée et sélectionnez l'un des types suivants :
    • Minimum : affiche la valeur minimum pour la propriété numérique sélectionnée pour les fiches d'informations associées de l'objet sélectionné.
    • Maximum : affiche la valeur maximum pour la propriété numérique sélectionnée pour toutes les fiches d'informations associées de l'objet sélectionné.
    • Nombre : compte le nombre total de fiches d'informations associées de l'objet sélectionné ayant une valeur de propriété de nombre sélectionnée.
    • Somme : additionne les valeurs de la propriété de nombre sélectionnée sur toutes les fiches d'informations associées de l'objet sélectionné.
    • Somme : calcule la moyenne des valeurs de la propriété de nombre sélectionnée sur toutes les fiches d'informations associées de l'objet sélectionné.
  • Pour choisir le format des valeurs de la propriété, cliquez sur le menu déroulant Format de nombre, puis sélectionnez l'un des formats suivants : Numéro formaté, Numéro non formaté, Devise, Pourcentage ou Durée.

Veuillez noter : toutes les propriétés de calcul utilisant Devise comme format de nombre utiliseront la Société devisede votre compte. 

calculation-property-associated-record

  • Pour ajouter une condition supplémentaire, cliquez sur Créer une condition. Lorsqu'une condition supplémentaire est configurée, cette condition doit être remplie pour que la propriété soit calculée (par exemple, si Montant de la transaction la plus récente est supérieur à 1 000).
    • Dans le premier menu déroulant, sélectionnez une propriété.
    • Dans le deuxième menu déroulant, sélectionnez un opérateur qui comparera la valeur de la première propriété à un nombre ou à la valeur d'une autre propriété.
    • Dans le troisième menu déroulant, sélectionnez une propriété ou saisissez un nombre qui sera comparé à la première propriété.
  • Cliquez sur Créer. Une fois créé, le type de champ affiché de la propriété sera Relatif.

Calculer des valeurs en fonction du temps écoulé entre deux propriétés

Vous pouvez créer des propriétés qui calculent le temps entre deux propriétés de sélection de date sélectionnées dans le même objet. Par exemple, vous pouvez calculer le temps écoulé entre le moment où le propriétaire d'un ticket a été assigné et le moment où le ticket a été fermé. Découvrez-en davantage sur l'affichage des valeurs des propriétés calculées Délai entre.

  • Cliquez sur le menu déroulant Type de propriété calculée et sélectionnez Délai entre.
  • Cliquez sur les menus déroulants pour sélectionner les propriétés Date de début et Date de fin.

time-between-calculation-property

  • Pour ajouter une condition supplémentaire, cliquez sur Créer une condition. Lorsqu'une condition supplémentaire est configurée, cette condition doit être remplie pour que la propriété soit calculée (par exemple, si Montant de la transaction la plus récente est supérieur à 1 000).
    • Dans le premier menu déroulant, sélectionnez une propriété.
    • Dans le deuxième menu déroulant, sélectionnez un opérateur qui comparera la valeur de la première propriété à un nombre ou à la valeur d'une autre propriété.
    • Dans le troisième menu déroulant, sélectionnez une propriété ou saisissez un nombre qui sera comparé à la première propriété.
  • Cliquez sur Créer. Une fois créé, le type de champ affiché de la propriété sera Relatif.

Le comportement suivant est attendu lors de l'affichage des valeurs des propriétés calculées Délai entre :

  • La durée sera affichée différemment dans différents outils HubSpot.
  • Pour les propriétés de date sans horodatage, l'heure par défaut utilisée dans le calcul sera minuit (UTC) pour le jour sélectionné.
  • Dans un enregistrement d'objet (par exemple, un enregistrement de contact ), la valeur affichée sera exprimée en heures, jours, mois, ou années, et sera arrondie à l'unité supérieure en fonction de seuils spécifiques. Par exemple, si le temps calculé est d'un mois et vingt jours, la valeur affichée sera Un mois, mais si le temps calculé est d'un mois et vingt-sept jours, la valeur affichée sera Deux mois. Les seuils sont les suivants :
    • 45 secondes ou plus sont arrondies à une minute
    • 45 minutes ou plus sont arrondies à une heure
    • 22 heures ou plus sont arrondies à un jour
    • 26 jours ou plus sont arrondis à un mois
    • 11 mois ou plus sont arrondis à un an
  • Dans les rapports personnalisés qui utilisent une propriété avec ce type de champ, la valeur affichée sera en jours. Par exemple, si le temps calculé est un an et vingt jours, la valeur affichée sera 385 jours.

Remarque : Dans HubSpot, les valeurs brutes des types de propriété Délai entre et Moyenne seront en millisecondes. Si une équation avec ces valeurs génère une valeur supérieure à celle prévue, utilisez un convertisseur de millisecondes pour convertir selon l'unité de temps voulue.

Calculer des valeurs en fonction de l'arrondi des valeurs des propriétés

Vous pouvez créer des propriétés calculées qui spécifient comment arrondir les valeurs numériques d'autres propriétés. Par exemple, vous pouvez créer une propriété calculée qui arrondit une propriété de commission aux deux décimales les plus proches.

  • Cliquez sur le menu déroulant Type de propriété calculée et sélectionnez une option d'arrondi :
    • Arrondi inférieur uniquement : toujours arrondir les valeurs au nombre de décimales spécifié. 
    • Arrondi supérieur uniquement : toujours arrondir les valeurs au nombre de décimales spécifié.
    • Arrondir au plus proche : arrondir les valeurs au nombre de décimales spécifié le plus proche en fonction de la proximité.
  • Pour choisir le format des valeurs de la propriété, cliquez sur le menu déroulant Format de nombre, puis sélectionnez l'un des formats suivants : Numéro formaté, Numéro non formaté, Devise, Pourcentage ou Durée.
  • Cliquez sur le menu déroulant Choisissez la propriété de la fiche d'informations, puis sélectionnez la propriété contenant les valeurs que vous souhaitez arrondir. Vous pouvez sélectionner n'importe quelle propriété de score, de calcul ou de nombre dans cet objet.
  • Dans la zone de texte Décimales à arrondir, saisissez le nombre de décimales auxquelles vous souhaitez que les valeurs soient arrondies.

Remarque : Pour les propriétés monétaires, cette fonction arrondira la valeur à la précision choisie, mais affichera toujours les valeurs sous forme de devise avec le nombre correct de chiffres.

rounding-calculation-property

  • Pour ajouter une condition supplémentaire, cliquez sur Créer une condition. Lorsqu'une condition supplémentaire est configurée, cette condition doit être remplie pour que la propriété soit calculée (par exemple, si Montant de la transaction la plus récente est supérieur à 1 000).
    • Dans le premier menu déroulant, sélectionnez une propriété.
    • Dans le deuxième menu déroulant, sélectionnez un opérateur qui comparera la valeur de la première propriété à un nombre ou à la valeur d'une autre propriété.
    • Dans le troisième menu déroulant, sélectionnez une propriété ou saisissez un nombre qui sera comparé à la première propriété.
  • Cliquez sur Créer. Une fois créé, le type de champ affiché de la propriété sera Calcul.

Calculer des valeurs sur la base d'une équation personnalisée

Vous pouvez également créer des propriétés qui calculent des valeurs en fonction de vos propres critères. Les équations personnalisées ne peuvent être définies que pour les propriétés de nombre au sein du même objet pour lequel vous créez la nouvelle propriété. Par exemple, vous pouvez créer une équation pour calculer le montant de la transaction la plus récente d'une entreprise (Montant de la transaction la plus récente) par rapport au nombre de fois où votre entreprise a contacté l'entreprise (Nombre de fois où l'entreprise a été contactée).

Pour créer votre équation, vous pouvez utiliser les menus déroulants avec des options prédéfinies ou utiliser l'éditeur en mode avancé pour écrire des équations avec des opérateurs arithmétiques, des opérateurs de comparaison, des opérateurs logiques, des instructions conditionnelles et d'autres fonctions. Découvrez-en davantage sur les opérateurs et les fonctions disponibles ainsi que sur le formatage de vos formules.

  • Cliquez sur le menu déroulant Type de propriété calculée, puis sélectionnez Équation personnalisée.
  • Pour créer une équation avec les options de menu déroulant :
    • Cliquez sur le menu déroulant Format de nombre, puis sélectionnez la manière de formater les valeurs de la propriété. Vous pouvez sélectionner l'un des éléments suivants : Nombre formaté, Nombre non formaté, Devise, Pourcentage ou Durée.
    • Utilisez le menu déroulant pour choisir une propriété numérique ou saisissez un nombre et cliquez sur l'option Constante : [valeur saisie] pour l'ajouter à l'équation.
    • Utilisez le menu déroulant de fonction pour sélectionner une opération : addition (+), soustraction (-), multiplication (*) ou division (/).
    • Pour ajouter une autre fonction à l'équation, cliquez sur Ajouter à l'équation. Vous pouvez également ajouter d'autres fonctions à une partie de l'équation en cliquant sur Développer entre parenthèses.

dropdown-menu-custom-equations

  • Pour créer une équation dans l'éditeur en mode avancé :
    • Cliquez pour activer le bouton Mode avancé.

advanced-mode-switch

    • Cliquez sur la liste déroulante Type de résultat, puis sélectionnez le type de résultat que votre calcul renverra. Vous pouvez sélectionner l'un des éléments suivants : Nombre, Booléen, Chaîne ou Date
    • Si vous avez sélectionné le type de résultat Nombre, cliquez sur le menu déroulant Format de nombre, puis sélectionnez la manière de formater les valeurs de la propriété. Vous pouvez sélectionner l'un des éléments suivants : Nombre formaté, Nombre non formaté, Devise, Pourcentage ou Durée.
    • Dans l'éditeur, insérez, saisissez ou collez des fonctions et des propriétés pour créer votre équation personnalisée. Découvrez-en davantage sur la syntaxe des équations de calcul personnalisées. Pour insérer des éléments de formule :
      • Cliquez sur le menu déroulant Insérer.
      • Pour insérer des fonctions dans votre équation, sélectionnez Fonctions, puis sélectionnez une fonction.
      • Pour insérer des propriétés dans votre équation, sélectionnez Propriétés, puis sélectionnez une propriété. Vous ne pouvez créer des équations personnalisées qu'en utilisant des propriétés du même objet que celui pour lequel vous créez la propriété.

example-advanced-calculation-equation

    • Si votre équation comporte des erreurs, cliquez sur [x] erreurs au-dessus de l'éditeur pour voir les raisons des erreurs. Vous ne pourrez pas créer la propriété si votre équation comporte des erreurs non résolues. Découvrez-en davantage sur le formatage de vos équations.

Remarque : Si l'une des propriétés numériques utilisées dans une équation personnalisée n'a aucune valeur ou a une valeur nulle, le calcul ne s'exécutera pas et la valeur de la propriété calculée sera vide. La valeur sera vide même si un nombre constant est inclus dans l'équation.

  • Pour ajouter une condition supplémentaire, cliquez sur Créer une condition. Lorsqu'une condition supplémentaire est configurée, cette condition doit être remplie pour que la propriété soit calculée (par exemple, si Montant de la transaction la plus récente est supérieur à 1 000).
    • Dans le premier menu déroulant, sélectionnez une propriété.
    • Dans le deuxième menu déroulant, sélectionnez un opérateur qui comparera la valeur de la première propriété à un nombre ou à la valeur d'une autre propriété.
    • Dans le troisième menu déroulant, sélectionnez une propriété ou saisissez un nombre qui sera comparé à la première propriété.
  • Cliquez sur Créer. Une fois créé, le type de champ affiché de la propriété sera Calcul.

Syntaxe d'équation personnalisée

Dans le mode avancé, vous pouvez créer vos propres équations personnalisées en utilisant des données littérales, des données provenant d'autres propriétés, des opérateurs et des fonctions. Vous trouverez ci-dessous la syntaxe permettant d'écrire des équations de calcul personnalisées.

Syntaxe littérale

En utilisant des données littérales, vous pouvez ajouter des chaînes de texte, des nombres et des valeurs true ou false à vos équations. Vous pouvez formater les chaînes de caractères, les nombres et les constantes booléennes de la manière suivante :

  • Chaîne littérale : texte entouré de guillemets. Il peut s'agir de guillemets simples ('constant') ou doubles ("constant").

  • Chiffre littéral : chiffre sans guillemets. Les nombres constants peuvent être n'importe quel nombre réel et peuvent inclure une notation ponctuelle. Par exemple, 1005 et 1.5589 sont tous deux des nombres constants valides.

  • Booléen littéral : les booléens constants peuvent être true ou false.

Syntaxe de propriété

Vous pouvez inclure d'autres propriétés du même objet dans votre équation personnalisée. Si une propriété est insérée dans l'éditeur, elle est automatiquement formatée et validée en tant que partie d'une équation.

Si vous choisissez de saisir ou de coller manuellement une propriété dans l'éditeur, elle doit être formatée comme suit : [properties.{propertyInternalName}]. Par exemple, pour ajouter la propriété Test score qui a la valeur interne Test_score, vous devez la saisir dans l'éditeur sous la forme [properties.Test_score].

Opérateurs

Vous pouvez utiliser des opérateurs dans votre équation pour mettre à jour, évaluer ou comparer des constantes et des valeurs de propriété. Lorsque plusieurs opérateurs sont utilisés, ils suivent l'ordre des opérations PEMDAS. Selon le type de données que vous utilisez, vous pouvez inclure les opérateurs suivants dans vos équations personnalisées.

Opérateur Description
+ Ajoutez des nombres ou des chaînes de caractères. Renvoie un nombre.
- Soustrayez des nombres. Renvoie un nombre.
* Multipliez des nombres. Renvoie un nombre.
/ Divisez des nombres. Renvoie un nombre.
< Vérifiez si une valeur est inférieure à une autre. Pris en charge par des propriétés ou des constantes de nombre. Renvoie un booléen.
> Vérifiez si une valeur est supérieure à une autre. Pris en charge par des propriétés ou des constantes de nombre. Renvoie un booléen.
<= Vérifiez si une valeur est inférieure ou égale à une autre. Pris en charge par des propriétés ou des constantes de nombre. Renvoie un booléen.
>= Vérifiez si une valeur est supérieure ou égale à une autre. Pris en charge par des propriétés ou des constantes de nombre. Renvoie un booléen.
! Vérifiez si aucune des valeurs n'est vraie. Renvoie un booléen.
= ou == Vérifiez si une valeur est égale à une autre. Pris en charge par les nombres et les chaînes de caractères. Renvoie un booléen.
!= Vérifiez si une valeur est différente d'une autre. Pris en charge par les nombres et les chaînes de caractères. Renvoie un booléen.
or ou || Vérifiez si l'une des deux valeurs booléennes est exacte. Renvoie un booléen.
and ou && Vérifiez si les deux valeurs sont vraies. Renvoie un booléen.

Fonctions

Vous pouvez utiliser des fonctions dans des formules personnalisées pour calculer des valeurs et effectuer des actions avec vos données. Selon le type de données que vous utilisez, vous pouvez inclure les fonctions suivantes dans vos équations personnalisées.

Fonction Arguments Exemples

concat

Combinez les chaînes de caractères en une seule valeur. Renvoie une chaîne.

concat("arg 1", "arg 2")

arg1 : la chaîne de caractères à laquelle arg2 sera ajouté.

arg2 : la chaîne de caractères à ajouter à arg1.

concat("Test", " example") = "Test exemple"

currency_decimal_places

Obtenez le nombre de décimales pour une devise. Renvoie un nombre.

currency_decimal_places(currency)

currency : la chaîne monétaire pour laquelle vous souhaitez calculer le nombre de décimales.

currency_decimal_places("USD")

dated_exchange_rate

Obtenez la valeur d'un taux de change à un moment donné. Renvoie un nombre. 

dated_exchange_rate(currency, date)

currency : la chaîne monétaire pour laquelle vous souhaitez calculer le taux de change à une date donnée. (ex : "USD").

date : la propriété de date et d'heure pour laquelle vous voulez calculer le taux de change.

dated_exchange_rate("USD", [properties.closedate])

exchange_rate

Obtenez les taux de change les plus récents. Renvoie un nombre.

exchange_rate(currency)

currency : la chaîne monétaire pour laquelle vous souhaitez calculer le taux de change.

exchange_rate("USD")

if

Configurez une expression conditionnelle.

if(condition, arg2) ou if(condition, arg2, arg3)

condition : proposition booléenne qui détermine la valeur calculée.

arg2 : un booléen, un nombre ou une chaîne qui sera la valeur calculée si la condition est remplie. 

arg3 (facultatif) : la valeur calculée si la condition n'est pas remplie. Si elle est incluse, elle doit être du même type que arg2. Si elle n'est pas utilisée, la valeur sera null lorsque la condition ne sera pas remplie. 

if([properties.amount] > 1000, "large", "small")

 

is_present

Déterminez si une valeur est présente pour le jeton. Renvoie un booléen.

is_present(property)

property : la propriété dont vous voulez vérifier la valeur.

is_present([properties.name]) = true

last_updated

Obtenez la date à laquelle le jeton a été mis à jour pour la dernière fois. Renvoie un horodatage en millisecondes sous forme de chaîne de caractères.

last_updated(property)

property : la propriété pour laquelle vous souhaitez consulter la date de mise à jour la plus récente.

last_updated([properties.amount]) = "1672531200000"

lowercase

Écrivez tous les caractères en minuscules. Renvoie une chaîne.

lowercase(text)

text : la chaîne ou la propriété de texte avec des valeurs que vous souhaitez mettre en minuscules.

lowercase("heLLo") = "hello"


lowercase([properties.test])

max

Obtenez le maximum de deux nombres. Renvoie un nombre. 

max(arg1, arg2)

arg1 : le premier nombre ou propriété de nombre.

arg2 : le deuxième nombre ou propriété de nombre.

max(500,[properties.amount]) = 500, si la valeur du montant est inférieure à 500.

min

Obtenez le minimum de deux nombres. Renvoie un nombre.

min(arg1, arg2)

arg1 : le premier nombre ou propriété de nombre.

arg2 : le deuxième nombre ou propriété de nombre.

min(500, 250) = 250

month

Obtenez le mois numérique d'une date donnée. Renvoie un nombre.

month(date)

date : la propriété de date et d'heure pour laquelle vous souhaitez calculer le mois.

month([properties.closedate])

number_to_string

Convertissez un nombre en chaîne. Renvoie une chaîne.

number_to_string(number_to_convert)

number_to_convert : le nombre ou la propriété de nombre que vous souhaitez transformer en chaîne.

number_to_string(1000) = "1000"

pipeline_probability

Obtenez la probabilité d'une phase du pipeline. Renvoie un nombre.

pipeline_probability(pipeline)

pipeline : le nom du pipeline pour lequel vous souhaitez calculer la probabilité.

pipeline_probability("newdeal")

round_down

Arrondissez un nombre à l'unité inférieure avec la précision indiquée. Renvoie un nombre.

round_down(number_to_round, precision)

number_to_round : le nombre ou la propriété de nombre que vous souhaitez arrondir à l'unité inférieure.

precision : le nombre de décimales à arrondir au chiffre inférieur.

round_down(4.353, 1) = 4,3

round_nearest

Arrondissez un nombre avec la précision indiquée. Renvoie un nombre.

round_nearest(number_to_round)

number_to_round : le nombre ou la propriété de nombre dont les valeurs doivent être arrondies au nombre entier le plus proche.

round_nearest(4,353) = 4

round_up

Arrondissez un nombre au supérieur avec la précision indiquée. Renvoie un nombre.

round_up(number_to_round, precision)

number_to_round : le nombre ou la propriété de nombre dont vous voulez arrondir les valeurs.

precision : le nombre de décimales à arrondir.

round_up(4.353, 1) = 4,4

string_to_number

Convertissez une chaîne en nombre. Renvoie un nombre.

string_to_number(string_to_convert)

string_to_convert : la chaîne ou la propriété de texte dont vous souhaitez convertir les valeurs en nombre.

string_to_number("1000") = 1000

time_between

Obtenez le décalage horaire entre deux dates. Renvoie un nombre.

time_between(date1, date2)

date1 : la propriété de date et d'heure de début.

date2 : la propriété de date et d'heure de fin.

time_between([properties.createdate],[properties.closedate])

uppercase

Écrivez tous les caractères en majuscules. Renvoie un nombre.

uppercase(text)

text : la chaîne ou la propriété de texte que vous souhaitez mettre en majuscules.

uppercase("hello") = "HELLO"

year

Obtenez l'année numérique d'une date donnée. Renvoie un nombre.

year(date)

date : la propriété de date et d'heure pour laquelle vous souhaitez calculer l'année.

year([properties.closedate])

 

Cet article vous a-t-il été utile ?
Ce formulaire n'est utilisé que pour recueillir du feedback sur la documentation. Découvrez comment obtenir de l'aide sur HubSpot.