Funzioni di formula personalizzate

Scritto da HubSpot Support | Jun 27, 2022 7:06:43 AM

Se si utilizza una formula personalizzata per formattare i dati in un flusso di lavoro, è possibile utilizzare funzioni con valori di proprietà del record iscritto o output di azioni precedenti per creare formule complesse.

Esaminare le diverse funzioni riportate di seguito per determinare quale utilizzare:

Funzione	Descrizione	Esempio
addominali	Recupera il valore assoluto di un numero. È possibile utilizzare questa funzione per assicurarsi che un numero sia positivo.	formula di esempio: abs([numero o proprietà numerica]) esempio: `abs(-10)` esempio di uscita: 10
aggiungere	Aggiunge un valore numerico a un altro valore numerico. Questa funzione è identica all'operatore +. Si utilizza con i seguenti elementi: numero: il valore numerico iniziale per l'operazione. numero da aggiungere: il numero da aggiungere al valore numerico iniziale.	formula di esempio: `add(number, number to add)` esempio: `add(5, 10)` esempio di uscita: 15 In alternativa, è possibile utilizzare anche: formula di esempio: `number + number to add` esempio: `5+10` esempio di uscita: 15
concat	Combina più valori stringa. Questa funzione è disponibile solo quando l'azione Formatta i dati viene utilizzata in modalità Personalizzata.	esempio di formula:`concat([string 1], " ", [string 2])` esempio: `concat([company name], " ", [MonthYear])` esempio di output: HubSpot giugno 2006
capitalizzare	Capitalizza la prima lettera di un valore di stringa. Il primo carattere sarà maiuscolo, mentre tutte le altre lettere saranno minuscole. Le altre parole presenti nell'input non avranno la prima lettera in maiuscolo.	formula di esempio: `capitalize([string])` esempio: `capitalize([firstname])` esempio di output: Henry
taglio	Taglia un carattere o più caratteri per rimuovere una stringa da un valore. Questa funzione può essere utilizzata per abbinare e tagliare una parte specifica di una stringa. Il parametro specifica la parte della stringa che deve essere rimossa. Da utilizzare con i seguenti comandi: sorgente: la stringa sorgente da cui rimuovere i caratteri. caratteri_da_tagliare: i caratteri specifici da rimuovere. Questo formato è sensibile alle maiuscole e alle minuscole.	formula: `cut(source, characters to cut)` esempio: `cut([phone], "-")` esempio di output: 80081234567
formato data-ora	Nota bene: questa formula è stata deprecata e sostituita dalla funzione `format_datetime` riportata di seguito. Le azioni che utilizzano questa funzione continueranno a funzionare, ma in futuro si dovrà utilizzare la nuova funzione.
format_datetime	Converte un timestamp in un formato facile da usare. Includere il timestamp o la proprietà insieme ai seguenti parametri per configurarne il formato: formato: il formato da utilizzare. I valori includono: `'short'`, `'medium'`, `'long'`, `'full'`. È anche possibile specificare un formato personalizzato utilizzando i modelli LDML Unicode. timeZone: il fuso orario dei dati di output nel formato IANA TZDB. Per impostazione predefinita, restituisce l'ora UTC. locale: il locale da usare per i formati locali.	formula: `format_datetime(date, format, timeZone, locale)` esempio: `format_datetime([closedate], 'medium', 'America/New_York, 'de-DE')` esempio di uscita: `08.02.2024, 17:09:49`
dividere	Divide un numero. Questa funzione è un'alternativa all'operatore /. Si utilizza con i seguenti comandi: numero: il numero da dividere. divisore: il numero da dividere per l'operazione di divisione.	formula: `divide(number, divisor)` esempio: `divide (8, 4)` esempio di uscita: 2 In alternativa, è possibile utilizzare anche: formula: `number/divisor` esempio: `8/4` esempio di uscita: 2
divisibile	Verifica se un numero è uniformemente divisibile. Quando non c'è alcun resto, la funzione dà esito positivo. Quando c'è un resto, la funzione dà esito negativo. Da utilizzare con i seguenti metodi: numero: il numero da dividere. divisore: il numero da dividere per l'operazione di divisione.	formula: `divisible(number, divisor)` esempio: `divisible (5,2)` esempio di uscita: false
unirsi	Combina due o più stringhe in un'unica stringa di risultato, utilizzando un separatore tra ogni valore. Questa funzione è disponibile solo quando l'azione Formatta i dati è utilizzata in modalità personalizzata. Da utilizzare con le seguenti funzioni: delimitatore: una stringa di separazione da inserire tra ogni elemento. elementi: un numero qualsiasi di stringhe da combinare.	formula: `join(delimiter, items)` esempio: `join("-", "A", "B", "C")` esempio di uscita: A-B-C
sinistra	Restituisce una sottostringa di caratteri di un valore di stringa a partire dall'inizio di un valore di stringa. Questa funzione è disponibile solo quando l'azione Formatta dati è utilizzata in modalità personalizzata.	formula: `left(string, length)` esempio: `left("Maria", "1")` esempio di uscita: M
lunghezza	Restituisce il numero di caratteri di una stringa.	formula: `length(string)` esempio: `left("Hello World!")` esempio di uscita: 12
inferiore	Converte tutti i caratteri di una stringa in lettere minuscole.	formula: `lower([string])` esempio: `lower(["HELLO WORLD"])` esempio di output: hello world
medio	Restituisce una sottostringa di caratteri da un valore stringa. Questa funzione è disponibile solo quando l'azione Formato dati è utilizzata in modalità Personalizzata.	formula: `mid(string, start-index, length)` esempio: `join("abc123", 2, 2)` esempio di uscita: c1
meno_tempo	Sottrae una quantità di tempo da un oggetto data/ora. Da utilizzare con i seguenti elementi: datetime: l'oggetto data/ora da cui sottrarre il tempo. diff: la quantità di tempo da sottrarre. timeunit: l'unità di tempo da sottrarre. Si possono usare le seguenti opzioni: secondi minuti ore mezzo_giorno giorni settimane mesi anni	formula: `minus_time(datetime, diff, timeunit)` esempio: `minus_time([closedate], 2, "days")` esempio di uscita: 04/11/2020
moltiplicatore	Moltiplica un valore per un numero. Questa funzione è un'alternativa all'operatore . Si utilizza con i seguenti comandi: numero:* il numero da moltiplicare. moltiplicatore: il numero per cui moltiplicare.	formula: `multipler(number, multipler)` esempio: `multiplier(5, 3)` esempio di uscita: 15 In alternativa, è possibile utilizzare anche: *formula: `numbermultipler` esempio: `53`* esempio di uscita: 15
numero	Converte una stringa in un numero.	formula: `number(string, default?)` esempio: `left("36")` esempio di uscita: 36
più_tempo	Aggiunge una quantità di tempo a un oggetto data/ora. Da utilizzare con i seguenti elementi: datetime: l'oggetto data/ora a cui aggiungere il tempo. diff: la quantità di tempo da aggiungere. timeunit: l'unità di tempo da aggiungere.	formula: `plus_time(datetime, diff, timeunit)` esempio: `plus_time([closedate], 2, "days")` esempio di uscita: 06/11/2020
numero casuale	Genera un numero casuale all'interno di un intervallo. Con questa funzione, i numeri generati sono completamente casuali e possono ripetersi. Ad esempio, se si utilizza un intervallo da uno a tre e si iscrivono tre contatti, è possibile che non si ottengano tre numeri unici. I numeri minimi e massimi sono inclusi nell'intervallo. È inoltre possibile utilizzare 0 e numeri negativi quando si imposta l'intervallo.	formula: `randomNumber(minimum, maximum)` esempio: `randomNumber(1, 3)` esempio di uscita: 1 o 2
sostituire	Sostituisce tutte le istanze di una sottostringa con una stringa diversa. Da utilizzare con i seguenti comandi: stringa: la stringa da cercare e sostituire. old: la sottostringa da sostituire. nuovo: la stringa sostitutiva. count: il numero di istanze della sottostringa da sostituire. Se non viene fornito, tutte le sottostringhe saranno sostituite.	formula: `replace(string, old, new, count)` esempio: `replace( "Hello world!", "Hello", "Hi", 1)` esempio di output: Ciao mondo!
diritto	Restituisce una sottostringa di caratteri da un valore di stringa a partire dalla fine di un valore di stringa. Questa funzione è disponibile solo quando l'azione Formatta dati viene utilizzata in modalità personalizzata.	formula: `right(string, length)` esempio: `right("abc123", 3)` esempio di uscita: 123
regex_replace	Cerca un modello regex e lo sostituisce con la stringa fornita. Si usa con i seguenti parametri: original_string: la stringa originale da cercare. pattern: lo schema regex su cui effettuare la ricerca. Informazioni sulla sintassi di RE2 sono disponibili qui. replacement_string: la stringa con cui sostituire i caratteri corrispondenti al pattern.	formula: `regex_replace(original_string, pattern, replacement_string)` esempio: `regex_replace("contact-us-2", "[^a-zA-Z]", "")` esempio di uscita: contactus
radice	Calcola la radice quadrata di un numero. È possibile specificare l'ennesima radice da calcolare. Da utilizzare con i seguenti comandi: Calcola la radice quadrata di un numero. Specificare facoltativamente l'ennesima radice da calcolare. nthRoot: l'ennesima radice da calcolare. Se non viene specificata, verrà presa la radice quadrata.	formula: `root(number, nthRoot)` esempio: `root(625, 4)` esempio di uscita: 5
rotondo	Arrotonda un numero a un decimale specificato. Da utilizzare con i seguenti comandi: precisione: il decimale a cui arrotondare. metodo di arrotondamento: arrotondare per eccesso o per difetto al numero intero più vicino. È possibile utilizzare i seguenti metodi di arrotondamento: comune massimo piano	formula: `round(number, precision, rounding method)` esempio: `round(52.5, 0, 'floor')` esempio di uscita: 52
striptags	Spoglia i tag SGML/XML e sostituisce gli spazi bianchi adiacenti con uno spazio. Questo filtro può essere usato per rimuovere qualsiasi tag HTML da una variabile.	formula: `striptags([string])` esempio: `striptags(<div><p>Potato</p></div>)` esempio di output: Patata
titolo	Cambia il testo in casing del titolo. Ogni parola della stringa risultante inizierà con lettere maiuscole, mentre tutti i caratteri rimanenti saranno minuscoli.	formula: `title([string])` esempio: `title("cheddar CHEESE")` esempio di output: Formaggio Cheddar
assetto	Rimuove gli spazi bianchi iniziali e finali da una stringa.	formula: `trim([string])` esempio: trim(" pesca ") esempio di output: peach
unixtimestamp	Converte un oggetto data/ora in un timestamp Unix.	formula: `unixtimestamp([dateteime])` esempio: `unixtimesstamp([closedate])` esempio di output: 16528638 24
superiore	Cambiare tutti i caratteri in maiuscolo.	formula: `upper([string])` esempio: `upper("teatime")` esempio di output: TEATIME
urlencode	Eseguire l'escape e codificare l'URL di una stringa utilizzando la formattazione UTF-8.	formula: `urlencode([string])` esempio: `urlencode("hi there")` esempio di output: hi%20there

Visualizza articolo completo