Campi formula

​

Casi d’Uso Comuni

​

Formula di base: concatenazione

​

Esempio: compilazione automatica del nome completo

​

Impostazione

1. Trigger: il record viene aggiornato o creato (Persone)
2. Filtro: verifica che il nome o il cognome siano cambiati
3. Azione di codice:

export const main = async (params) => {
  const { firstName, lastName } = params;

  const fullName = [firstName, lastName]
    .filter(Boolean)
    .join(' ');

  return { fullName };
};

4. Aggiorna record: imposta Nome completo su {{code.fullName}}

​

Formula numerica: importo previsto

​

Esempio: calcolare il ricavo previsto

​

Impostazione

1. Trigger: il record viene aggiornato (Opportunità, campo Importo oppure Probabilità)
2. Azione di codice:

export const main = async (params) => {
  const { amount, probability } = params;

  const expectedAmount = (amount || 0) * (probability || 0) / 100;

  return { expectedAmount };
};

3. Aggiorna record: imposta Importo previsto su {{code.expectedAmount}}

​

Formula sulle date: calcolo dei giorni

​

Esempio: giorni alla scadenza dell’attività

​

Impostazione

1. Trigger: il record viene aggiornato o creato (Attività, campo Data di scadenza)
2. Azione di codice:

export const main = async (params) => {
  const { dueDate } = params;

  if (!dueDate) {
    return { daysUntilDue: null };
  }

  const due = new Date(dueDate);
  const today = new Date();
  const diffTime = due - today;
  const diffDays = Math.ceil(diffTime / (1000 * 60 * 60 * 24));

  return { daysUntilDue: diffDays };
};

3. Aggiorna record: imposta Giorni alla scadenza su {{code.daysUntilDue}}

​

Formula condizionale: punteggio lead

​

Esempio: calcolare il punteggio lead in base a criteri

​

Impostazione

1. Trigger: il record viene aggiornato (Persone o Aziende)
2. Azione di codice:

export const main = async (params) => {
  const { companySize, industry, hasEmail, hasPhone, source } = params;

  let score = 0;

  // Company size scoring
  if (companySize === 'Enterprise') score += 30;
  else if (companySize === 'Mid-Market') score += 20;
  else if (companySize === 'SMB') score += 10;

  // Industry scoring
  const targetIndustries = ['Technology', 'Finance', 'Healthcare'];
  if (targetIndustries.includes(industry)) score += 25;

  // Contact info scoring
  if (hasEmail) score += 10;
  if (hasPhone) score += 15;

  // Source scoring
  if (source === 'Referral') score += 20;
  else if (source === 'Website') score += 10;

  return { leadScore: score };
};

3. Aggiorna record: imposta Punteggio lead su {{code.leadScore}}

​

Formula di testo: estrazione del dominio

​

Esempio: estrarre il dominio dall’email

​

Impostazione

1. Trigger: il record viene aggiornato (Persone, campo Email)
2. Azione di codice:

export const main = async (params) => {
  const { email } = params;

  if (!email) return { domain: null };

  const domain = email.split('@')[1]?.toLowerCase();

  return { domain };
};

3. Aggiorna record: imposta il campo Dominio su {{code.domain}}

​

Migliori Pratiche

​

Prestazioni

• Attiva solo in caso di modifiche ai campi rilevanti
• Usa filtri per ignorare i record che non richiedono calcolo
• Evita calcoli complessi in flussi di lavoro ad alto volume

​

Gestione degli errori

• Verifica i valori null/undefined prima dei calcoli
• Usa valori predefiniti quando i dati mancano
• Restituisci messaggi di errore chiari quando i calcoli falliscono

​

Testing

• Esegui test con casi limite (campi vuoti, valori zero)
• Verifica manualmente i calcoli prima dell’attivazione
• Monitora le esecuzioni dei flussi di lavoro per risultati imprevisti

​

Correlati

• Come mostrare l’importo previsto nella pipeline
• Come tracciare il tempo in fase
• Azioni dei flussi di lavoro