Collegamento automatico Asset-Prodotto – THRON Guide

L'automazione Asset Product Link collega automaticamente gli asset digitali caricati in cartelle THRON alle media gallery dei prodotti, estraendo un codice dal nome file tramite regex per confrontarlo con gli attributi del catalogo. Permette di aggiornare le schede prodotto senza interventi manuali e migliorare la ricercabilità. La configurazione prevede la selezione di attributi, cartelle di origine, pattern regex e test per garantire l'associazione corretta. Sono presenti indicazioni per troubleshooting e supporto tecnico.

Configurazione automazione

In questa sezione definisci dove l'automazione deve cercare gli asset e dove deve collegarli.

Name: Inserisci un nome identificativo (max 50 caratteri) che ti permetta di riconoscere lo scopo dell'automazione nella lista esecuzioni.
Quale attributo deve corrispondere?: È la chiave di ricerca del prodotto. Puoi selezionare solo attributi di tipo identificativo, testo breve, numero, booleano, selezione semplice o multipla.

Nota: Se l'attributo è localizzato, seleziona la Locale su cui applicare il matching per sbloccare il salvataggio.

Collega asset dalla cartella di origine: Seleziona la cartella THRON contenente i file da processare. Se non hai i permessi di visualizzazione, il sistema mostrerà l'avviso "You can't view this folder".
- Includendo tutte le sottocartelle: Attiva questo toggle se vuoi che l'automazione scansioni anche l'intera struttura gerarchica sotto la cartella radice.
All'attributo media di destinazione: Seleziona la gallery del prodotto che deve ricevere gli asset. Se localizzato, specifica la Locale di destinazione (indipendente dalla locale del matcher).
Quando: L'esecuzione standard è impostata su Ogni giorno.

Definizione del pattern della naming convention

Il Pattern definisce la regola per identificare il codice prodotto (es. SKU) all'interno del nome del file dell'asset.

Espressione Regolare e sua validazione

Espressione regolare: Inserisci la regex. Il sistema evidenzierà in blu il primo gruppo catturato, che rappresenta il valore da confrontare con il catalogo.
Carica preset: Clicca qui per selezionare configurazioni predefinite già ottimizzate.
Stringa di test del nome file: Inserisci fino a 5 nomi file reali (uno per riga) per testare la regola in tempo reale.

A destra della stringa di test, il sistema mostra una tabella riepilogativa:

sku (o nome del matcher scelto): Mostra il valore estratto dalla regex.
Il prodotto esiste?: Indica se nel catalogo PIM è presente un prodotto con quel codice.

Se vedi prevalentemente "Non esiste" in rosso, la regex non è configurata correttamente o il matcher selezionato non coincide con i dati nel catalogo.

Configurazione Consigliata

Per un setup rapido e privo di errori, segui questi passaggi nell'ordine indicato:

Quale attributo deve corrispondere?: Seleziona un attributo di tipo identifier (es. SKU) per un matching univoco.
Collega asset dalla cartella di origine: Scegli la cartella dedicata e attiva Includendo tutte le sottocartelle se la tua struttura è gerarchica.
Pattern: Usa Carica preset e verifica l'estrazione corretta nella Stringa di test del nome file.

Esempio Pratico: Naming Convention e Regex

1. Definizione della Naming Convention

Struttura: [SKU]_[TipoVista]_[Variante].[Estensione]

Esempio di nomi file reali:

TSHIRT-RED-001_front_v1.jpg
TSHIRT-RED-001_back_v1.jpg
JEANS-BLU-999_detail_v2.png

In questo caso, il valore che l'automazione deve estrarre per il matching è solo la prima parte: TSHIRT-RED-001 o JEANS-BLU-999.

2. Configurazione della Regex

Per estrarre correttamente lo SKU prima del primo underscore, configura la sezione Pattern come segue:

Espressione Regolare: ^([A-Z0-9-]+)_

Spiegazione tecnica:

^ : Inizia l'analisi dall'inizio della riga.

([A-Z0-9-]+) : Gruppo di cattura (evidenziato in blu nell'interfaccia) che identifica qualsiasi combinazione di lettere maiuscole, numeri e trattini.
_ : Si ferma non appena incontra il primo underscore, escludendo tutto il resto del nome file dal match.

3. Test dell'estrazione (Stringa di test)

Inserendo i nomi file nella textarea di test di THRON, il sistema si comporterà così:

Nome file	Valore estratto	Attributo SKU	Esito
`TSHIRT-RED-001_front_v1.jpg`	`TSHIRT-RED-001`	`TSHIRT-RED-001`	Prodotto esiste
`JEANS-BLU-999_detail_v2.png`	`JEANS-BLU-999`	`JEANS-BLU-999`	Prodotto esiste

Troubleshooting

Errori in Configurazione

Questi problemi impediscono il salvataggio o la corretta impostazione dell'automazione. Si risolvono agendo direttamente sull'interfaccia di configurazione.

Problema	Causa Probabile	Soluzione Operativa
Salvataggio disabilitato	Mancano campi obbligatori o la Locale non è stata selezionata per un attributo localizzato.	Compila tutti i campi contrassegnati dall'asterisco rosso (Name, Matcher, Cartella, Media Attribute).
"You can't view this folder"	L'utente non ha i permessi di visibilità sulla cartella THRON selezionata.	Seleziona una cartella su cui hai visibilità tramite la select dedicata.
Valori "Non esiste" in Tabella Match	La regex estrae un codice (es. SKU) che non trova corrispondenza nel catalogo prodotti.	Verifica che il Matcher Attribute contenga i valori estratti e che la regex non stia catturando caratteri extra.
Nessun valore evidenziato in blu	La regex inserita non contiene gruppi di cattura `()`.	Definisci almeno un gruppo di cattura (es. `([A-Z0-9]+)`) per indicare al sistema quale parte del nome file confrontare.

Anomalie in Fase di Esecuzione

Questi problemi si riscontrano analizzando i log nella sezione Esecuzioni dopo che l'automazione è stata processata dal sistema. Fai riferimento alla documentazione di Automation Studio per ulteriori dettagli.

Problema	Causa Probabile	Soluzione Operativa
Asset rifiutati (Contatore elevato)	I nuovi file caricati non rispettano la naming convention definita nella regex.	Apri il log, clicca su Visualizza asset per controllare i nomi file e aggiorna la regex o rinomina i file.
Nessuna nuova associazione	Gli asset sono già associati (colonna Associazioni esistenti) o non ci sono nuovi file nella cartella.	Verifica se sono stati caricati nuovi file nella cartella di origine dopo l'ultima esecuzione.
Associazioni mancanti in sottocartelle	Il toggle Including all child folders è disattivato.	Torna nel Flusso di Automazione e attiva il toggle per estendere la scansione a tutta l'alberatura.
Match fallito su prodotti specifici	Discrepanza di Locale tra il Matcher Attribute e il valore nel prodotto.	Controlla che il codice prodotto sia inserito nella stessa lingua (Locale) configurata nell'automazione.

Serve aiuto?

Per problemi o difficoltà tecniche, scrivi a support@thron.com.