Właściwości obliczeniowe w HubSpot umożliwiają automatyczne obliczanie wartości minimalnej, maksymalnej, liczby, sumy lub średniej dla właściwości w powiązanych rekordach lub konfigurowanie niestandardowych równań opartych na innych właściwościach.
Na przykład można utworzyć:
Uwaga: w zależności od subskrypcji HubSpot, istnieje ograniczenie liczby właściwości obliczeniowych, które można utworzyć.
Właściwości obliczeniowe można skonfigurować na podstawie różnych kryteriów, w tym wartości właściwości powiązanych rekordów, czasu między wartościami dwóch właściwości lub własnych niestandardowych równań. Aby utworzyć właściwość obliczeniową:
W menu na lewym pasku bocznym przejdź do Właściwości.
Kliknij menu rozwijane Wybierz obiekt , a następnie wybierz Właściwości [Obiekt] , aby utworzyć właściwość dla tego obiektu.
Dla obiektu można utworzyć właściwości, które będą obliczane na podstawie określonych wartości właściwości powiązanych rekordów tego obiektu. Można dokonywać obliczeń na podstawiewszystkich powiązanych rekordów tego obiektu lub dla określonych etykiet asocjacji, w tym asocjacji tego samego obiektu.
Na przykład można utworzyć właściwość transakcji, która zlicza całkowitą liczbę działań sprzedażowych zarejestrowanych dla kontaktów powiązanych z transakcją z etykietą Decydent .
Uwaga: użycie waluty rekordu wpływa tylko na sposób wyświetlania wartości i nie spowoduje automatycznego zastosowania kursu wymiany.
Można tworzyć właściwości, które obliczają czas między dwiema wybranymi właściwościami selektora daty w tym samym obiekcie. Na przykład można obliczyć czas między przypisaniem właściciela zgłoszenia a jego zamknięciem. Dowiedz się więcej o sposobie wyświetlania wartości właściwości Time Between.
Uwaga: jeśli próbujesz utworzyć właściwość na podstawie dzisiejszej daty, zaleca się stosowanie względnych filtrów czasu dla właściwości daty w widokach, listach, raportach lub przepływach pracy zamiast tworzenia właściwości czasu między obliczeniami. Na przykład, możesz uwzględnić kontakty na liście, jeśli data ostatniego zaangażowania jest większa niż 7 dni temu, lub zarejestrować transakcje w przepływie pracy, jeśli data odnowienia umowy jest mniejsza niż 31 dni od teraz.
Oczekuje się następującego zachowania podczas wyświetlania wartości czasu między właściwościami obliczeń:
Uwaga: w HubSpot nieprzetworzone wartości typów właściwości Time between i Average są przechowywane w milisekundach. Jeśli równanie z tymi wartościami daje wyższą wartość niż oczekiwana, użyj konwertera milisekund, aby przekonwertować na żądaną jednostkę czasu.
Można tworzyć właściwości obliczeniowe, które określają sposób zaokrąglania wartości liczbowych innych właściwości. Na przykład można utworzyć właściwość obliczeniową, która zaokrągla właściwość prowizji do dwóch miejsc po przecinku.
Uwaga: użycie waluty rekordu wpływa tylko na sposób wyświetlania wartości i nie spowoduje automatycznego zastosowania kursu wymiany.
Uwaga: w przypadku właściwości walutowych funkcja ta zaokrągli wartość do wybranej precyzji, ale nadal będzie wyświetlać wartości jako walutę z odpowiednią liczbą cyfr.
Można również tworzyć właściwości, które obliczają wartości na podstawie własnych kryteriów. Równania niestandardowe można skonfigurować tylko dla właściwości liczbowych w tym samym obiekcie, dla którego tworzona jest nowa właściwość. Na przykład można utworzyć równanie do obliczania kwoty z ostatniej transakcji firmy(Kwota ostatniej transakcji) w porównaniu do tego, ile razy firma kontaktowała się z firmą(Liczba kontaktów).
Równanie niestandardowe można utworzyć za pomocą operatorów arytmetycznych, operatorów porównania, operatorów logicznych, instrukcji warunkowych i innych funkcji. Równania te mogą zwracać wartości liczbowe, logiczne, łańcuchowe lub daty. Dowiedz się więcej o dostępnych operatorach i funkcjach oraz sposobie formatowania formuł.
Aby utworzyć niestandardową właściwość obliczania równania:
Uwaga: wybrany typ wyjściowy musi być zgodny z typem wyjściowym wyświetlanym w prawym górnym rogu edytora, w przeciwnym razie nie będzie można utworzyć właściwości. W przypadku właściwości zwracających datę można użyć typu wyjściowego liczby lub daty, który określa sposób wyświetlania wartości (tj. liczba wyświetla datę w milisekundach, data wyświetla sformatowaną datę).
Uwaga: użycie waluty rekordu wpływa tylko na sposób wyświetlania wartości i nie spowoduje automatycznego zastosowania kursu wymiany. Aby dodać kurs wymiany, można uwzględnić w równaniu funkcje exchange_rate
lub dated_exchange_rate
.
Uwaga: jeśli którakolwiek zwłaściwości liczbowych w równaniu niestandardowym nie ma wartości lub ma wartość null, obliczenia nie zostaną uruchomione, a wartość właściwości obliczeniowej będzie pusta. Wartość będzie pusta, nawet jeśli w równaniu znajduje się stała liczba. W takiej sytuacji można użyć funkcji if
i is_known
, aby zamiast tego ustawić wartość na 0.
W edytorze formuł można tworzyć własne niestandardowe równania przy użyciu danych literalnych, danych z innych właściwości, operatorów i funkcji. Poniżej przedstawiono składnię do pisania niestandardowych równań obliczeniowych i przykłady często używanych formuł.
Korzystając z danych dosłownych, można dodawać do równań ciągi tekstu, liczby oraz wartości prawdziwe lub fałszywe. Ciągi znaków, liczby, wartości logiczne i stałe daty można formatować w następujący sposób:
String literal: tekst otoczony cudzysłowami. Mogą one być reprezentowane za pomocą pojedynczych cudzysłowów ('constant'
) lub podwójnych cudzysłowów ("constant"
).
Liczba dosłowna: liczby bez cudzysłowów. Liczby stałe mogą być dowolnymi liczbami rzeczywistymi i mogą zawierać notację punktową. Na przykład, zarówno 1005
jak i 1.5589
są poprawnymi liczbami stałymi.
Boolean literal: stałe logiczne mogą być true
lub false
.
1698508800000
.Do niestandardowego równania można dołączyć inne właściwości tego samego obiektu. Jeśli właściwość zostanie wstawiona do edytora, zostanie automatycznie sformatowana i zweryfikowana jako część równania.
Jeśli zdecydujesz się ręcznie wpisać lub wkleić właściwość do edytora, powinna ona być sformatowana jako [properties.{propertyInternalName}]
. Na przykład, aby dodać właściwość Test score, która ma wewnętrzną wartość Test_score, należy wpisać ją w edytorze jako [properties.Test_score]
.
Podczas korzystania z właściwości wyliczeniowych w równaniu (np. wybór z listy rozwijanej, wybór radiowy), wartości są traktowane jako ciągi, więc muszą być ujęte w podwójne cudzysłowy. Na przykład "subscriber"
.
Operatorów można używać w równaniu do aktualizacji, oceny lub porównywania stałych i wartości właściwości. W przypadku korzystania z wielu operatorów są one zgodne z kolejnością operacji PEMDAS. W zależności od typu używanych danych, w równaniach niestandardowych można uwzględnić następujące operatory.
Operator | Opis |
+ |
Dodaje liczby lub ciągi znaków. Zwraca liczbę. |
- |
Odejmowanie liczb. Zwraca liczbę. |
* |
Mnożenie liczb. Zwraca liczbę. |
/ |
Dzielenie liczb. Zwraca liczbę. |
< |
Sprawdza, czy wartość jest mniejsza od innej. Obsługiwane przez właściwości liczbowe lub stałe. Zwraca wartość logiczną. |
> |
Sprawdza, czy wartość jest większa od innej. Obsługiwane przez właściwości liczbowe lub stałe. Zwraca wartość logiczną. |
<= |
Sprawdza, czy wartość jest mniejsza lub równa innej. Obsługiwane przez właściwości liczbowe lub stałe. Zwraca wartość logiczną. |
>= |
Sprawdza, czy wartość jest większa lub równa innej. Obsługiwane przez właściwości liczbowe lub stałe. Zwraca wartość logiczną. |
! |
Sprawdza, czy żadna z wartości nie jest prawdziwa. Zwraca wartość logiczną. |
= lub == |
Sprawdza, czy wartość jest równa innej. Obsługiwane przez liczby i ciągi znaków. Zwraca wartość logiczną. |
!= |
Sprawdza, czy wartość nie jest równa innej. Obsługiwane przez liczby i ciągi znaków. Zwraca wartość logiczną. |
or lub || |
Sprawdza, czy jedna z dwóch wartości jest prawdziwa. Zwraca wartość logiczną. |
and lub && |
Sprawdza, czy obie wartości są prawdziwe. Zwraca wartość logiczną. |
W formułach niestandardowych można używać funkcji do obliczania wartości i wykonywania działań na danych. W zależności od typu używanych danych, w równaniach niestandardowych można uwzględnić następujące funkcje.
Funkcja | Argumenty | Przykłady |
Pobiera wartość bezwzględną liczby. Zwraca liczbę. |
number: liczba, dla której chcesz uzyskać wartość bezwzględną. |
|
Łączy do 100 ciągów znaków w jedną wartość. Zwraca ciąg znaków. |
arg1: ciąg znaków, do którego zostanie dołączony argument 2. arg2: ciąg znaków do dołączenia do arg1. |
|
Filtruje ciągi znaków zawierające określoną sekwencję znaków. Zwraca ciąg znaków. |
property: właściwość, której wartości mają być sprawdzane dla tekstu. text: ciąg znaków, które powinny zawierać wartości. |
|
Pobiera liczbę miejsc dziesiętnych dla waluty. Zwraca liczbę. |
currency: ciąg znaków waluty, dla którego ma zostać obliczona liczba miejsc dziesiętnych. |
|
Pobiera wartość kursu wymiany w podanym czasie. Zwraca liczbę. |
currency: ciąg znaków waluty, dla którego ma zostać obliczony kurs wymiany w określonym dniu (np. date: właściwość datetime, dla której ma zostać obliczony kurs wymiany. |
|
Pobiera najnowszy kurs wymiany. Zwraca liczbę. |
currency: ciąg znaków waluty, dla której ma zostać obliczony kurs wymiany. |
|
Skonfiguruj wyrażenie warunkowe. |
warunek: wyrażenie logiczne określające obliczaną wartość. arg2: wartość logiczna, liczba lub ciąg znaków, który będzie obliczoną wartością, jeśli warunek zostanie spełniony. arg3 (opcjonalne): obliczona wartość, jeśli warunek nie zostanie spełniony. Jeśli jest dołączony, musi być tego samego typu co |
|
Określa, czy dla tokena znana jest wartość. Zwraca wartość logiczną. |
property: właściwość, której wartość ma zostać sprawdzona. |
|
Pobiera datę ostatniej aktualizacji tokena. Zwraca znacznik czasu w milisekundach jako ciąg znaków. |
property: właściwość, dla której ma zostać sprawdzona data ostatniej aktualizacji. |
|
Zmienia wszystkie znaki na małe litery. Zwraca ciąg znaków. |
text: ciąg znaków lub właściwość tekstowa z wartościami, które mają zostać zmienione na małe litery. |
|
Uzyskuje maksimum z dwóch liczb. Zwraca liczbę. |
arg1: pierwsza liczba lub właściwość liczby. arg2: druga liczba lub właściwość liczby. |
|
Pobiera minimum z dwóch liczb. Zwraca liczbę. |
arg1: pierwsza liczba lub właściwość liczby. arg2: druga liczba lub właściwość liczby. |
|
Zwraca liczbę. |
date: właściwość datetime, dla której ma zostać obliczony miesiąc. |
|
Konwertuje liczbę na ciąg znaków. Zwraca ciąg znaków. |
number_to_convert: liczba lub właściwość liczby, którą chcesz zmienić na ciąg znaków. |
|
Uzyskuje prawdopodobieństwo etapu potoku. Zwraca liczbę. |
pipeline: nazwa rurociągu, dla którego ma zostać obliczone prawdopodobieństwo. |
|
Podnosi liczbę do wartości innej liczby. Zwraca liczbę. |
base: numer bazowy. wykładnik: wartość, do której ma zostać podniesiona podstawa. |
|
Zaokrągla liczbę w dół do określonej precyzji. Zwraca liczbę. |
number_to_round: liczba lub właściwość liczby, którą chcesz zaokrąglić w dół. precision: liczba miejsc dziesiętnych, do których ma zostać zaokrąglona wartość. |
|
Zaokrągla liczbę do określonej precyzji. Zwraca liczbę. |
number_to_round: liczba lub właściwość liczby, której wartości mają zostać zaokrąglone. precyzja: liczba miejsc dziesiętnych do zaokrąglenia. |
|
Zaokrągla liczbę do określonej precyzji. Zwraca liczbę. |
number_to_round: liczba lub właściwość liczby, której wartości mają zostać zaokrąglone w górę. precyzja: liczba miejsc dziesiętnych, do których ma zostać zaokrąglona wartość. |
|
Pobiera pierwiastek kwadratowy z liczby. Zwraca liczbę. |
number: liczba, dla której chcesz uzyskać pierwiastek kwadratowy. |
|
Filtruje ciągi znaków rozpoczynające się od określonej sekwencji znaków. Zwraca ciąg znaków. |
property: właściwość, której wartości mają być sprawdzane pod kątem początkowych znaków. text: ciąg znaków, od którego powinny zaczynać się wartości. |
|
Konwertuje ciąg znaków na liczbę. Zwraca liczbę. |
string_to_convert: ciąg znaków lub właściwość tekstowa, której wartości mają zostać przekonwertowane na liczbę. |
|
Pobiera różnicę czasu między dwiema datami. Zwraca liczbę. |
date1: początkowa właściwość daty i godziny. date2: końcowa właściwość datetime. |
|
Zmienia wszystkie znaki na wielkie litery. Zwraca liczbę. |
text: ciąg znaków lub właściwość tekstowa, która ma zostać zmieniona na wielkie litery. |
|
Pobiera numeryczny rok podanej daty. Zwraca liczbę. |
date: właściwość datetime, dla której ma zostać obliczony rok. |
|
Poniżej przedstawiono przykładowe formuły oparte na typowych przypadkach użycia.
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
i is_known
, aby ustawić wartość na 0, gdy właściwość liczby jest pusta. Na przykład if(is_known([properties.number]), [properties.number], 0)
.exchange_rate
lub dated_exchange_rate
. Na przykład [properties.amount] * exchange_rate('CAD')
.