Le proprietà di calcolo in HubSpot consentono di calcolare automaticamente il valore minimo, massimo, il conteggio, la somma o la media delle proprietà sui record associati o di impostare equazioni personalizzate basate su altre proprietà.
Ad esempio, è possibile creare:
Attenzione: a seconda dell'abbonamento a HubSpot, esiste un limite al numero di proprietà di calcolo che è possibile creare.
Le proprietà di calcolo possono essere impostate in base a diversi criteri, tra cui i valori delle proprietà dei record associati, l'intervallo di tempo tra i valori di due proprietà o le equazioni personalizzate. Per creare una proprietà di calcolo:
Nel menu della barra laterale sinistra, spostarsi su Proprietà.
Fare clic sul menu a discesa Seleziona un oggetto , quindi selezionare Proprietà [Oggetto] per creare una proprietà per quell'oggetto.
È possibile creare proprietà per un oggetto che verranno calcolate in base a determinati valori di proprietà dei record associati all'oggetto. È possibile calcolare in base a tutti i record associati di quell'oggetto o per specifiche etichette di associazione, comprese le associazioni dello stesso oggetto.
Ad esempio, è possibile creare una proprietà di un affare che conta il numero totale di attività di vendita registrate per i contatti associati a un affare con l'etichetta Decision maker .
Nota bene: l'utilizzo di una valuta di registrazione influisce solo sulla visualizzazione del valore e non applica automaticamente un tasso di cambio.
È possibile creare proprietà che calcolano l'intervallo di tempo tra due proprietà del selezionatore di date selezionate all'interno dello stesso oggetto. Ad esempio, è possibile calcolare l'intervallo di tempo tra l'assegnazione del proprietario di un ticket e la sua chiusura. Per saperne di più su come vengono visualizzati i valori della proprietà di calcolo Time Between.
Nota bene: se si sta cercando di creare una proprietà basata sulla data odierna, si consiglia di utilizzare i filtri temporali relativi per le proprietà di data nelle viste, negli elenchi, nei report o nei flussi di lavoro, piuttosto che creare una proprietà di calcolo del tempo intermedio. Ad esempio, è possibile includere i contatti in un elenco se la data dell'ultimo impegno è superiore a 7 giorni fa, oppure iscrivere le offerte in un flusso di lavoro se la data del rinnovo del contratto è inferiore a 31 giorni da oggi.
Quando si visualizzano i valori delle proprietà di tempo tra i calcoli, ci si aspetta il seguente comportamento:
Nota bene: in HubSpot, i valori grezzi dei tipi di proprietà Tempo tra e Media sono memorizzati in millisecondi. Se un'equazione con questi valori produce un valore più alto del previsto, utilizzare un convertitore di millisecondi per convertire nell'unità di tempo desiderata.
È possibile creare proprietà di calcolo che specificano come arrotondare i valori numerici di altre proprietà. Ad esempio, è possibile creare una proprietà di calcolo che arrotonda una proprietà di commissione alle due cifre decimali più vicine.
Nota bene: l'utilizzo di una valuta di registrazione influisce solo sulla visualizzazione del valore e non applica automaticamente un tasso di cambio.
Nota bene: per le proprietà di valuta, questa funzione arrotonderà il valore alla precisione scelta, ma visualizzerà comunque i valori come valuta con il numero corretto di cifre.
È anche possibile creare proprietà che calcolano i valori in base a criteri personalizzati. Le equazioni personalizzate possono essere impostate solo per le proprietà numeriche all'interno dello stesso oggetto per il quale si sta creando la nuova proprietà. Ad esempio, è possibile creare un'equazione per calcolare l'importo della transazione più recente di un'azienda(Importo della transazione più recente) rispetto al numero di volte in cui l'azienda è stata contattata(Numero di volte contattate).
È possibile costruire equazioni personalizzate con operatori aritmetici, operatori di confronto, operatori logici, dichiarazioni condizionali e altre funzioni. Queste equazioni possono restituire valori numerici, booleani, stringhe o date. Per saperne di più sugli operatori e le funzioni disponibili e su come formattare le formule.
Per costruire una proprietà di calcolo dell'equazione personalizzata:
Attenzione: il tipo di output selezionato deve corrispondere al tipo di output mostrato in alto a destra nell'editor, altrimenti non sarà possibile creare la proprietà. Per le proprietà che restituiscono una data, è possibile utilizzare il tipo di output number o date, che determina la modalità di visualizzazione dei valori (ad esempio, number visualizza la data in millisecondi, date visualizza la data formattata).
Attenzione: l'uso di una valuta record influisce solo sulla visualizzazione del valore e non applica automaticamente un tasso di cambio. Per aggiungere un tasso di cambio, è possibile includere le funzioni exchange_rate
o dated_exchange_rate
nell'equazione.
Nota bene: se una delle proprietà numeriche di un'equazione personalizzata non ha valore o ha un valore nullo, il calcolo non verrà eseguito e il valore della proprietà di calcolo sarà vuoto. Il valore sarà vuoto anche se l'equazione contiene un numero costante. In questa situazione, si possono utilizzare le funzioni if
e is_known
per impostare il valore a 0.
Nell'editor di formule è possibile creare equazioni personalizzate utilizzando dati letterali, dati di altre proprietà, operatori e funzioni. Di seguito, si illustra la sintassi per la scrittura di equazioni di calcolo personalizzate e si esaminano esempi di formule comunemente utilizzate.
Utilizzando i dati letterali, è possibile aggiungere alle equazioni stringhe di testo, numeri e valori veri o falsi. È possibile formattare stringhe, numeri, booleani e costanti di data nei seguenti modi:
Letterale di stringa: testo circondato da virgolette. Questi possono essere rappresentati con virgolette singole ('constant'
) o doppie ("constant"
).
Numeri letterali: numeri senza virgolette. I numeri costanti possono essere qualsiasi numero reale e possono includere la notazione puntuale. Ad esempio, sia 1005
che 1.5589
sono numeri costanti validi.
Letterale booleano: i booleani costanti possono essere true
o false
.
1698508800000
.È possibile includere altre proprietà dello stesso oggetto nell'equazione personalizzata. Se una proprietà viene inserita nell'editor, viene automaticamente formattata e convalidata come parte di un'equazione.
Se si sceglie di digitare o incollare manualmente una proprietà nell'editor, questa deve essere formattata come [properties.{propertyInternalName}]
. Ad esempio, per aggiungere la proprietà Test score, che ha un valore interno di Test_score, la si digita nell'editor come [properties.Test_score]
.
Quando si usano le proprietà di enumerazione in un'equazione (ad esempio, selezione a discesa, selezione radio), i valori sono considerati stringhe e devono essere racchiusi tra doppi apici. Ad esempio, "subscriber"
.
È possibile utilizzare gli operatori nelle equazioni per aggiornare, valutare o confrontare le costanti e i valori delle proprietà. Quando si utilizzano più operatori, questi seguono l'ordine delle operazioni di PEMDAS. A seconda del tipo di dati utilizzati, è possibile includere i seguenti operatori nelle equazioni personalizzate.
Operatore | Descrizione |
+ |
Aggiunge numeri o stringhe. Restituisce un numero. |
- |
Sottrae i numeri. Restituisce un numero. |
* |
Moltiplica i numeri. Restituisce un numero. |
/ |
Divide i numeri. Restituisce un numero. |
< |
Verifica se un valore è minore di un altro. Supportato da proprietà o costanti numeriche. Restituisce un booleano. |
> |
Verifica se un valore è maggiore di un altro. Supportato da proprietà o costanti numeriche. Restituisce un booleano. |
<= |
Verifica se un valore è minore o uguale a un altro. Supportato da proprietà o costanti numeriche. Restituisce un booleano. |
>= |
Verifica se un valore è maggiore o uguale a un altro. Supportato da proprietà o costanti numeriche. Restituisce un booleano. |
! |
Verifica se nessuno dei valori è vero. Restituisce un booleano. |
= o == |
Verifica se un valore è uguale a un altro. Supportato da numeri e stringhe. Restituisce un booleano. |
!= |
Verifica se un valore non è uguale a un altro. Supportato da numeri e stringhe. Restituisce un booleano. |
or o || |
Verifica se uno dei due valori è vero. Restituisce un booleano. |
and o && |
Verifica se entrambi i valori sono veri. Restituisce un booleano. |
È possibile utilizzare le funzioni all'interno delle formule personalizzate per calcolare valori e completare azioni con i dati. A seconda del tipo di dati utilizzati, è possibile includere le seguenti funzioni nelle equazioni personalizzate.
Funzione | Argomenti | Esempi |
Ottiene il valore assoluto dei numeri. Restituisce un numero. |
numero: il numero di cui si vuole ottenere il valore assoluto. |
|
Combina fino a 100 stringhe in un unico valore. Restituisce una stringa. |
arg1: la stringa alla quale verrà aggiunto l'arg 2. arg2: la stringa da aggiungere all'arg 1. |
|
Filtra le stringhe che contengono una specifica sequenza di caratteri. Restituisce una stringa. |
proprietà: la proprietà di cui si vogliono controllare i valori per il testo. testo: la sequenza di caratteri che i valori devono contenere. |
|
Ottiene il numero di cifre decimali per una valuta. Restituisce un numero. |
valuta: la stringa di valuta per la quale si desidera calcolare il numero di cifre decimali. |
|
Ottiene il valore di un tasso di cambio in un determinato momento. Restituisce un numero. |
valuta: la stringa di valuta per la quale si desidera calcolare il tasso di cambio in una data specifica (ad esempio, data: la proprietà datetime per la quale si desidera calcolare il tasso di cambio. |
|
Ottiene il tasso di cambio più recente. Restituisce un numero. |
valuta: la stringa di valuta per la quale si desidera calcolare il tasso di cambio. |
|
Impostare un'espressione condizionale. |
condizione: l'istruzione booleana che determina il valore calcolato. arg2: un booleano, un numero o una stringa che sarà il valore calcolato se la condizione è soddisfatta. arg3 (opzionale): il valore calcolato se la condizione non è soddisfatta. Se incluso, deve essere dello stesso tipo di |
|
Determina se è noto un valore per il token. Restituisce un booleano. |
proprietà: la proprietà di cui si vuole verificare il valore. |
|
Ottiene la data dell'ultimo aggiornamento del token. Restituisce un timestamp in millisecondi come stringa. |
proprietà: la proprietà per la quale si desidera verificare la data di aggiornamento più recente. |
|
Cambia tutti i caratteri in minuscolo. Restituisce una stringa. |
testo: la stringa o la proprietà di testo con i valori che si desidera cambiare in minuscolo. |
|
Ottiene il massimo di due numeri. Restituisce un numero. |
arg1: il primo numero o la prima proprietà numerica. arg2: il secondo numero o proprietà numerica. |
|
Ottiene il minimo di due numeri. Restituisce un numero. |
arg1: il primo numero o la prima proprietà numerica. arg2: il secondo numero o proprietà numerica. |
|
Ottiene il mese numerico di una data determinata. Restituisce un numero. |
date: la proprietà datetime per la quale si vuole calcolare il mese. |
|
Converte un numero in una stringa. Restituisce una stringa. |
number_to_convert: il numero o la proprietà numerica che si desidera trasformare in stringa. |
|
Ottiene la probabilità di una fase della pipeline. Restituisce un numero. |
pipeline: il nome della pipeline per la quale si vuole calcolare la probabilità. |
|
Eleva un numero al valore di un altro numero. Restituisce un numero. |
base: il numero di base. esponente: il valore a cui elevare la base. |
|
Arrotonda un numero per difetto a una precisione specificata. Restituisce un numero. |
numero_da_arrotondare: il numero o la proprietà del numero che si desidera arrotondare per difetto. precisione: il numero di cifre decimali da arrotondare per difetto. |
|
Arrotonda un numero alla precisione specificata. Restituisce un numero. |
numero_da_arrotondare: il numero o la proprietà numerica i cui valori si vogliono arrotondare. precisione: il numero di cifre decimali da arrotondare. |
|
Arrotonda un numero fino alla precisione specificata. Restituisce un numero. |
numero_da_arrotondare: il numero o la proprietà numerica di cui si vuole arrotondare il valore. precisione: il numero di cifre decimali da arrotondare per eccesso. |
|
Ottiene la radice quadrata di un numero. Restituisce un numero. |
numero: il numero di cui si vuole ottenere la radice quadrata. |
|
Filtra le stringhe che iniziano con una specifica sequenza di caratteri. Restituisce una stringa. |
proprietà: la proprietà i cui valori si desidera controllare per i caratteri iniziali. testo: la sequenza di caratteri con cui devono iniziare i valori. |
|
Converte una stringa in un numero. Restituisce un numero. |
string_to_convert: la proprietà stringa o testo i cui valori si vogliono convertire in numero. |
|
Ottiene la differenza di orario tra due date. Restituisce un numero. |
date1: la proprietà datetime iniziale. date2: la proprietà datetime finale. |
|
Cambia tutti i caratteri in maiuscolo. Restituisce un numero. |
testo: la stringa o la proprietà di testo che si desidera cambiare in maiuscolo. |
|
Ottiene l'anno numerico di una determinata data. Restituisce un numero. |
date: la proprietà datetime per la quale si vuole calcolare l'anno. |
|
Di seguito sono riportate formule di esempio basate su casi d'uso comuni.
if([properties.number] < 4, "less than four", "more than four")
if([properties.number] < 4, if([properties.other_number] < 2, "both true", "one true"), "not true")
concatenate(if([properties.number] < 4, "less", "more"), " than four")
if
e is_known
per impostare il valore a 0 quando la proprietà del numero è vuota. Ad esempio, if(is_known([properties.number]), [properties.number], 0)
.exchange_rate
o dated_exchange_rate
nell'equazione. Ad esempio, [properties.amount] * exchange_rate('CAD')
.