AreaCacaoDocs
FormulazioneIngredienti

Campi personalizzati

Definisci campi personalizzati del tuo account per registrare informazioni aggiuntive sui tuoi ingredienti.

Che cos’è

I campi personalizzati ti permettono di arricchire le informazioni dei tuoi ingredienti con dati tuoi che il catalogo standard non prevede: origine, certificazione, numero di lotto ecc. I campi che definisci valgono a livello del tuo account.

Come accedere

Dal catalogo ingredienti, fai clic sul pulsante Campi personalizzati nell’intestazione. Si apre una finestra modale con il sottotitolo «Definisci campi personalizzati per registrare informazioni aggiuntive sui tuoi ingredienti (origine, certificazione, lotto, ecc.).».

Sezioni della finestra

La finestra mostra l’elenco Campi definiti (N), con il numero di campi creati tra parentesi, e una tabella dei campi che hai già creato:

ColonnaContenuto
EtichettaNome visibile del campo.
ChiaveChiave interna del campo.
TipoTipo di dato del campo.
ObbligatorioIndica se il campo è obbligatorio.

Ogni riga ha un’icona a forma di matita per modificare e una a forma di cestino per eliminare. Se non ne hai ancora creato nessuno, vedrai «Nessun campo definito. Crea il primo per ampliare il tuo catalogo.».

Creare un campo

Apri l’editor

Fai clic su Nuovo campo. Si apre un sottomodulo vuoto.

Compila i dati

  • Etichetta (obbligatorio): il nome visibile del campo, per esempio Paese d’origine.
  • Chiave (interna): la chiave interna. Viene generata automaticamente dall’etichetta in formato snake_case, deve iniziare con una lettera minuscola e non si può modificare dopo la creazione del campo.
  • Tipo: scegli tra Testo, Numero, Data, Selezione (menu a tendina) o Booleano (sì/no).
  • Opzioni: solo per il tipo Selezione, l’elenco dei valori separati da virgole, per esempio Venezuela, Ecuador, Madagascar.
  • Aiuto (facoltativo): un testo di supporto per chi compila il campo.
  • Campo obbligatorio: casella per rendere obbligatorio il campo. Prima di selezionarla, leggi l’avviso in Stato attuale.

Salva

Fai clic su Crea campo. Il campo compare nell’elenco dei campi definiti.

Modificare ed eliminare

  • Modifica (icona a forma di matita): apre l’editor con i dati del campo. La chiave interna resta bloccata e non si può modificare.
  • Elimina (icona a forma di cestino): cancella la definizione del campo, previa conferma. I valori già registrati negli ingredienti non vengono cancellati: restano salvati, anche se privi della loro definizione.

Controlli

  • L’Etichetta è obbligatoria: se la lasci vuota, vedrai «L’etichetta è obbligatoria».
  • La Chiave deve iniziare con una lettera minuscola ed essere in snake_case; in caso contrario vedrai «Chiave non valida: deve iniziare con una lettera minuscola ed essere in snake_case».

Stato attuale

Per ora questa schermata serve solo a definire i campi. La finestra anticipa con la nota «Una volta definiti, potrai inserire i valori in ogni ingrediente personalizzato.», ma il modulo dell’ingrediente personalizzato non mostra ancora i campi definiti, quindi per ora non c’è modo di compilarne i valori dall’interfaccia (né tramite l’importazione CSV o JSON).

Se selezioni Campo obbligatorio per un campo, non potrai creare nuovi ingredienti personalizzati da Nuovo ingrediente: al salvataggio il server risponde «Il campo “…” è obbligatorio» e il modulo non offre alcun punto in cui compilarlo. Lascia la casella deselezionata finché il modulo non mostrerà questi campi.

Non confondere le due cose: i campi personalizzati aggiungono colonne di dati; gli ingredienti personalizzati sono nuove schede complete.

Passaggi successivi

In questa pagina