Guida alla compilazione del file category_template.xlsx
Il file category_template.xlsx serve a definire la struttura gerarchica delle categorie di prodotto per un catalogo. Ogni riga rappresenta una categoria, che può essere un nodo foglia (ultima categoria) oppure un nodo intermedio.
Struttura del file
Il file contiene le seguenti colonne:
|
Colonna |
Descrizione |
|
id |
Facoltativo, ma soggetto a una regola importante (vedi sotto). È un identificativo numerico univoco per ogni categoria. Se non disponibile, può essere omesso, ma non è consentito mescolare righe con e senza id nello stesso file. |
|
cat_1 |
Livello 1 della gerarchia (es. "Elettronica") |
|
cat_2 |
Livello 2 (es. "Smartphone") |
|
cat_3 |
Livello 3 (es. "Accessori") |
|
cat_4 |
Livello 4 (se presente) |
|
cat_5 |
Livello 5 (se presente) |
|
cat_6 |
Livello 6 (se presente) |
Regole per il campo id
- Il campo id non è obbligatorio.
- Tuttavia, il file deve essere internamente coerente:
- o tutte le righe hanno il campo id compilato,
- oppure nessuna riga ha il campo id.
- Non sono accettati file in cui solo alcune righe contengono id e altre no.
Regole di compilazione generali
- Ogni riga rappresenta una singola categoria con il suo percorso completo.
- I livelli devono essere compilati in ordine, a partire da cat_1. Se è presente un livello cat_n, tutti i livelli precedenti (cat_1, ..., cat_{n-1}) devono essere compilati.
- Il valore delle colonne cat_1...cat_6 deve rappresentare il nome della categoria per quel livello.
- Le combinazioni duplicate di percorsi (stesso insieme di livelli) devono essere evitate.
Esempio corretto
|
id |
cat_1 |
cat_2 |
cat_3 |
cat_4 |
cat_5 |
cat_6 |
|
16 |
Audio e Video |
|||||
|
20108 |
Audio e Video |
Accessori Audio |
||||
|
20067 |
Audio e Video |
Accessori Audio |
Accessori Ipod |
|||
|
30001 |
Casa |
Cucina |
Pentole |
Oppure, in assenza di id:
|
id |
cat_1 |
cat_2 |
cat_3 |
cat_4 |
cat_5 |
cat_6 |
|
Audio e Video |
||||||
|
Audio e Video |
Accessori Audio |
|||||
|
Audio e Video |
Accessori Audio |
Accessori Ipod |
||||
|
Casa |
Cucina |
Pentole |
Errori da evitare
- Lasciare cat_1 vuoto: tutti i percorsi devono iniziare da cat_1.
- Saltare livelli (es. compilare cat_1 e cat_3 ma non cat_2).
- Usare formati inconsistenti o nomi di categoria con varianti non standardizzate.
- Compilare solo alcune righe con id e altre senza.
Suggerimenti
- Se si dispone di un sistema di codifica interno per le categorie, è consigliabile compilare il campo id per garantire riferimenti stabili nel tempo.
- In caso contrario, si può tranquillamente omettere, purché l'intero file sia privo di id.