---

Panoramica

I campi personalizzati ti consentono di estendere la struttura standard dei record di Blue con campi dati aggiuntivi specifici per le esigenze della tua azienda. Forniscono un modo potente per catturare dati strutturati oltre ai campi integrati come titolo, descrizione e data di scadenza.

I campi personalizzati sono definiti a livello di progetto e possono essere utilizzati in tutti i record (todo) all'interno di quel progetto. Ogni campo ha un tipo specifico che determina le sue regole di convalida, il formato di input e il comportamento di visualizzazione.

Operazioni Disponibili

Gestione dei Campi Core

Operazione	Descrizione	Link
List Custom Fields	Interroga e filtra campi personalizzati	View Details →
Create Custom Field	Aggiungi nuovi campi personalizzati ai progetti	View Details →
Delete Custom Field	Rimuovi campi personalizzati con una corretta pulizia	View Details →

Valori dei Campi

Operazione	Descrizione	Link
Set Field Values	Imposta e aggiorna i valori dei campi personalizzati sui record	View Details →

Tipi di Campi Personalizzati

Campi di Testo

Tipo	Descrizione	Casi d'uso	Link
TEXT_SINGLE	Input di testo su una sola riga	Names, titles, short descriptions	View Details →
TEXT_MULTI	Area di testo multilinea	Descrizioni lunghe, note, commenti	View Details →

Campi di Selezione

Tipo	Descrizione	Casi d'uso	Link
SELECT_SINGLE	Menu a discesa per selezione singola	Status, priority, category	View Details →
SELECT_MULTI	Menu a discesa per selezione multipla	Tags, skills, categories	View Details →
CHECKBOX	Campo checkbox booleano	Flags, approvals, confirmations	View Details →

Campi Numerici

Tipo	Descrizione	Casi d'uso	Link
NUMBER	Input numerico	Quantities, scores, measurements	View Details →
CURRENCY	Importo in valuta	Budgets, costs, pricing	View Details →
PERCENT	Valore percentuale	Completion rates, discounts	View Details →
RATING	Valutazione a stelle con scala personalizzata	Performance ratings, satisfaction	View Details →
FORMULA	Campo calcolato basato su altri campi	Totals, computations, aggregations	View Details →

Campi di Contatto

Tipo	Descrizione	Casi d'uso	Link
EMAIL	Indirizzo email con convalida	Informazioni di contatto, notifiche	View Details →
PHONE	Numero di telefono con formattazione internazionale	Contact details, emergency contacts	View Details →
URL	URL web con convalida	Links, references, resources	View Details →

Campi di Data e Ora

Tipo	Descrizione	Casi d'uso	Link
DATE	Selettore di data	Deadlines, milestones, events	View Details →
TIME_DURATION	Campo di tracciamento del tempo	Work hours, duration estimates	View Details →

Luogo e Geografia

Tipo	Descrizione	Casi d'uso	Link
LOCATION	Posizione geografica (lat/lng)	Addresses, venues, service areas	View Details →
COUNTRY	Selettore di paese	Regional assignments, localization	View Details →

File e Media

Tipo	Descrizione	Casi d'uso	Link
FILE	Allegato di file	Documents, images, resources	View Details →

Campi di Sistema

Tipo	Descrizione	Casi d'uso	Link
UNIQUE_ID	Identificatore unico generato automaticamente	Ticket numbers, order IDs	View Details →
REFERENCE	Link a record in un altro progetto	Cross-project relationships	View Details →
LOOKUP	Estrai dati dai record di riferimento	Aggregate data from related records	View Details →

Campi Interattivi

Tipo	Descrizione	Casi d'uso	Link
BUTTON	Campo pulsante azionabile	Triggers, actions, workflows	View Details →
CURRENCY_CONVERSION	Campo di conversione valuta	Multi-currency calculations	View Details →

Concetti Chiave

Definizione del Campo

• I campi personalizzati sono definiti a livello di progetto
• Ogni campo ha un nome e un tipo unici
• I campi possono includere regole e vincoli di convalida
• Le opzioni di configurazione variano in base al tipo di campo

Valori dei Campi

• I valori sono memorizzati su singoli record (todo)
• Ogni record può avere valori diversi per lo stesso campo
• Valori vuoti/nulli sono consentiti per campi opzionali
• I valori sono convalidati secondo le regole del tipo di campo

Modello di Permessi

I campi personalizzati rispettano i permessi a livello di progetto:

Ruolo	Crea Campi	Modifica Campi*	Imposta Valori	Visualizza Valori
OWNER	✅ Sì	✅ Sì	✅ Sì	✅ Sì
ADMIN	✅ Sì	✅ Sì	✅ Sì	✅ Sì
MEMBER	❌ No	❌ No	✅ Sì	✅ Sì
CLIENT	❌ No	❌ No	✅ Limitato	✅ Limitato

*Modifica Campi si riferisce alla modifica delle impostazioni del campo (nome, tipo, opzioni, regole di convalida) - non all'impostazione dei valori del campo sui record

Permessi dei Ruoli Personalizzati

• I progetti possono avere ruoli personalizzati con permessi specifici per i campi
• I campi possono essere contrassegnati come modificabili/non modificabili per ruolo
• I ruoli personalizzati possono limitare l'accesso a campi specifici

Modelli Comuni

Creazione di un Campo Personalizzato di Base

mutation CreateCustomField {
  createCustomField(input: {
    name: "Priority Level"
    type: SELECT_SINGLE
    description: "Task priority level"
    customFieldOptions: [
      { title: "Low", color: "#28a745" }
      { title: "Medium", color: "#ffc107" }
      { title: "High", color: "#fd7e14" }
      { title: "Critical", color: "#dc3545" }
    ]
  }) {
    id
    name
    type
    customFieldOptions {
      id
      title
      color
    }
  }
}

Impostazione dei Valori dei Campi sui Record

mutation SetFieldValue {
  setTodoCustomField(input: {
    todoId: "todo_123"
    customFieldId: "field_456"
    customFieldOptionId: "option_789"  # For SELECT_SINGLE
  })
}

Interrogazione dei Record con Campi Personalizzati

query GetTodosWithCustomFields {
  todos(projectId: "project_123") {
    id
    title
    customFields {
      id
      customField {
        name
        type
      }
      # Type-specific value fields
      text           # TEXT_SINGLE, TEXT_MULTI, EMAIL, etc.
      number         # NUMBER, CURRENCY, PERCENT, RATING
      selectedOption # SELECT_SINGLE
      selectedOptions # SELECT_MULTI
      checked        # CHECKBOX
      date           # DATE
    }
  }
}

Creazione di Record con Valori di Campi Personalizzati

mutation CreateTodoWithCustomFields {
  createTodo(input: {
    title: "New task"
    todoListId: "list_123"
    customFields: [
      { customFieldId: "priority_field", value: "high_priority_option" }
      { customFieldId: "budget_field", value: "5000" }
      { customFieldId: "notes_field", value: "Additional context here" }
    ]
  }) {
    id
    title
    customFields {
      customField { name }
      value
    }
  }
}

Migliori Pratiche

Progettazione del Campo

1. Usa nomi descrittivi - Rendi chiari gli scopi dei campi
2. Scegli tipi appropriati - Abbina il tipo di campo ai requisiti dei dati
3. Imposta regole di convalida - Usa valori minimi/massimi, campi obbligatori
4. Organizza logicamente - Raggruppa i campi correlati insieme

Considerazioni sulle Prestazioni

1. Limita il numero di campi - Troppi campi possono influire sulle prestazioni
2. Usa la paginazione - Quando interroghi grandi set di dati
3. Indicizza i campi chiave - Per i campi utilizzati nel filtraggio/ordinamento
4. Evita la nidificazione profonda - Mantieni semplici le relazioni tra i campi

Qualità dei Dati

1. Convalida l'input - Usa tipi di campo appropriati con convalida
2. Fornisci valori predefiniti - Imposta valori predefiniti sensati dove appropriato
3. Usa formati coerenti - Standardizza i modelli di inserimento dati
4. Pulizia regolare - Rimuovi campi e opzioni non utilizzati

Esperienza Utente

1. Descrizioni chiare - Fornisci descrizioni utili per i campi
2. Ordinamento logico - Posiziona i campi in un ordine naturale di flusso di lavoro
3. Gerarchia visiva - Usa colori e formattazione in modo efficace
4. Divulgazione progressiva - Mostra i campi quando rilevanti

Gestione degli Errori

Errori comuni quando si lavora con campi personalizzati:

Codice Errore	Descrizione	Soluzione
CUSTOM_FIELD_NOT_FOUND	Il campo non esiste	Verify field ID and project access
VALIDATION_ERROR	Il valore non corrisponde al tipo di campo	Check format and validation rules
UNAUTHORIZED	Permessi insufficienti	Ensure proper role level
CUSTOM_FIELD_VALUE_PARSE_ERROR	Formato valore non valido	Review field type requirements

Risorse Correlate

• API dei Record - Lavorare con record che contengono campi personalizzati
• API dei Progetti - Gestire progetti che contengono campi personalizzati
• API delle Automazioni - Automatizzare i flussi di lavoro con trigger di campi personalizzati
• API di Gestione Utenti - Gestire i permessi dei campi personalizzati