Cosa sono e come configurare i Marker di Completeness
Per configurare i Marker di Completeness è necessario essere Amministratore o avere il permesso "Può gestire la modellazione dati prodotto" e aver configurato almeno una Famiglia e un Locale attivo.
Cosa fa un Marker di Completeness
Un Marker di Completeness è un indicatore calcolato automaticamente da THRON che misura, in percentuale, quanti degli attributi che hai definito come obbligatori sono già compilati su un prodotto — per una specifica Famiglia e uno specifico Locale.
Il marker è sia un indicatore visivo nella scheda prodotto, sia uno strumento operativo: puoi usarlo per filtrare e raggruppare i prodotti in base al loro stato di completamento.
Come funziona il calcolo:
- Attributi: il marker verifica che ciascun attributo selezionato sia compilato
- Famiglie: la regola si applica a tutti i prodotti appartenenti alle Famiglie selezionate
- Locale: per gli attributi localizzati, ogni Locale viene valutato in modo indipendente; per gli attributi non localizzati, è sufficiente che siano popolati una volta sola
Crea un Marker di Completeness
- Vai su Impostazioni di piattaforma → Prodotti → Marker
- Clicca Nuovo marker di completeness
- Inserisci un Codice univoco (es.
pronto-ecommerce,tradotto-de) - Seleziona le Famiglie a cui si applica (fino a 10)
- Seleziona i Locale su cui misurare la completeness (fino a 10)
- Clicca Continua, scegli gli attributi
- Seleziona gli Attributi che devono essere compilati per raggiungere il 100% (fino a 50)
- Clicca Crea marker per confermare
💡 Configurazione Consigliata
Crea subito un marker
base-prodottoche includa gli attributi fondamentali condivisi da tutte le tue Famiglie e il Locale principale: SKU, Nome Prodotto, Descrizione e immagine principale (Media Gallery). È il punto di partenza minimo per monitorare la qualità del catalogo.
Visualizza la completeness nella scheda prodotto
Il valore del marker è visibile nel pannello di sinistra della scheda prodotto, nella sezione Completeness. La sezione appare solo se il prodotto appartiene a una Famiglia e a un Locale previsti dal marker.
- Di default viene mostrato solo il primo marker; clicca Visualizza tutti i marker per espanderli
- Espandi un singolo marker per vedere il dettaglio per ogni Locale configurato e il valore complessivo considerando tutti i Locale applicati
- Passa il cursore sul titolo del marker per vedere in anteprima gli attributi ancora mancanti
- Usa il filtro "Mostra solo attributi mancanti" nella scheda prodotto per visualizzare esclusivamente i campi da compilare — sia per il Locale corrente sia per quelli configurati nel marker — e rimuovilo in qualsiasi momento
Modifica e manutenzione
Vai su Impostazioni di piattaforma → Prodotti → Marker e clicca sull'icona di modifica accanto al marker da aggiornare. La pagina di dettaglio è suddivisa in due sezioni:
- Parametri base: Codice, Famiglie e Locale. Devono essere presenti almeno 1 Locale, 1 Famiglia e 1 Attributo per poter salvare.
- Attributi selezionati: elenco degli attributi inclusi nel calcolo.
Clicca Salva modifiche nell'intestazione per confermare. Se la configurazione contiene Famiglie o attributi non esistenti, il sistema mostra un pannello di errore e blocca il salvataggio.
Per eliminare un marker, scorri in fondo alla pagina di modifica e clicca Elimina marker. Comparirà una modale di conferma; dopo la conferma verrai reindirizzato alla lista senza il marker eliminato.
⚠️ Nota: al momento non è possibile eliminare un marker direttamente dalla lista; l'eliminazione avviene solo dalla pagina di dettaglio.
Limiti di sistema
| Elemento | Limite |
|---|---|
| Marker totali per piattaforma | Massimo 50 |
| Famiglie per marker | Da 1 a 10 |
| Locale per marker | Da 1 a 10 |
| Attributi per marker | Da 1 a 50 |
| Codice marker — lunghezza | Da 2 a 50 caratteri |
| Codice marker — caratteri consentiti | Solo a-z, 0-9, _, - (nessun maiuscolo) |
| Codice marker — unicità | Deve essere univoco tra tutti i marker |
| Parole riservate (non usabili come codice) | id, family, hierarchylevel, variation, variationgroup, master |
Al raggiungimento del limite di 50 marker, il sistema mostra un pannello di avviso e il pulsante Nuovo viene disabilitato.
Casi particolari: marker non applicabile
In alcuni casi il marker risulta non applicabile su un prodotto, anche se Famiglia e Locale corrispondono. Al posto della percentuale viene mostrato un messaggio di errore nella scheda prodotto.
Questo accade quando uno o più attributi inclusi nel marker non appartengono alla Famiglia del prodotto. Le cause principali sono:
- L'attributo non è nella Famiglia: nella pagina di configurazione del marker viene mostrato un avviso sull'attributo in questione. È comunque possibile salvare il marker, ma rimarrà non applicabile per quei prodotti.
- L'attributo è a un livello gerarchico inferiore: il calcolo del marker non eredita i valori da livelli di Variazione inferiori (es. Variante), quindi se l'attributo è definito solo a livello di Variante, il marker non riesce a calcolarlo.
⚠️ Verifica sempre le Famiglie prima di aggiungere attributi al marker. Un attributo assente in anche solo una delle Famiglie selezionate rende il marker non applicabile per tutti i prodotti di quella Famiglia.
Best practice
Un marker per obiettivo. Crea marker distinti per scopo — pronto-stampa, pronto-ecommerce, tradotto-en, approvato-marketing — invece di un unico marker con tutto dentro. Il team capisce subito cosa manca e perché.
Aggiorna i marker quando evolve la struttura. Se aggiungi nuove Famiglie o nuovi Locale, includili nei marker esistenti per non perdere visibilità sui nuovi prodotti.
Collega i Locale agli attributi localizzati. Affinché il marker misuri correttamente la completeness multilingua, assicurati che gli attributi che variano per lingua (es. nome, descrizione) abbiano il flag Valore Localizzabile attivo.