Modificatori

Panoramica #

Modifiers è uno strumento potente che ti permette di modificare i dati di prodotto dopo la sincronizzazione senza dover coinvolgere uno sviluppatore per apportare modifiche al data-feed. I Modifiers vengono valutati dall’alto verso il basso, quindi l’ordine in cui compaiono nella lista è importante.

Hai diversi tipi di modifiers; ecco l’elenco completo:

Tutti i comandi hanno un campo if in input. Il if può essere aggiunto a qualsiasi elemento con una condizione e il comando verrà eseguito solo sull’attributo se la condizione risulta vera.

Comandi #

Qui di seguito sono riportati ciascuno dei comandi con un esempio. Tutti i modifiers hanno un tipo che specifica quale comando eseguire e un attribute che indica su quale attributo eseguire il comando.

Create new attribute #

Richiede un new_value che indica quale valore assegnare all’attributo; può essere utilizzato sia per creare un nuovo attributo, sia per sostituire uno esistente.

Delete attribute #

Elimina l’attributo specificato da tutti i prodotti, o solo da alcuni in base a una condizione if.

Delete product #

Elimina il/i prodotto/i in base a una condizione if.

Update attribute #

Se non sei tecnico e stai leggendo questo, preparati perché useremo regex con la libreria di python.

Update richiede l’attributo regexp, ovvero una espressione regex che corrisponde ad alcune parti dell’attributo e sostituisce ciascun gruppo corrispondente con il contenuto di replace_by. Qui trovi uno strumento utile per costruire la tua regex.

Un esempio di regex potrebbe essere [/]+ con un replace_by di ’/’: questo sostituirebbe tutte le sezioni dell’attributo con più / di seguito con un singolo /. Quindi https://test//tests diventerà https:/test/tests.

Esempio #

In questo esempio vogliamo rimuovere l’ultima parte di un URL usando un pattern regex. L’URL di partenza è: https://example.domain/product/153//__example. Per rimuovere la parte //__example, possiamo usare la seguente regex: \/\/__example.

Poiché desideriamo semplicemente rimuovere questa parte dell’URL senza sostituirla con altro, il campo Replace by viene lasciato vuoto.

Change attribute type #

Permette di cambiare il tipo di un attributo. Quindi, se i dati sono numerici e ti serve farli diventare una stringa, puoi usarlo per fare il typecast. I tipi di attributo sono: string,int,float e boolean.

Split attribute #

Permette di dividere una stringa tramite un separatore, in una lista di stringhe. Se non viene specificato il separatore, il valore predefinito è la virgola.

Esempio #

Qui stiamo dividendo un attributo con categorie, trasformandolo in una lista: "lineman, chute" diventa ["lineman","chute"].

Append value #

Permette di aggiungere nuovi valori a un attributo lista già esistente.

Si può, ad esempio, aggiungere ulteriori stringhe all’attributo tags o una nuova categoria all’attributo categories.

Evaluate an expression #

L’azione Expression valuta un’espressione matematica, che può includere attributi, costanti e operatori. Ad esempio, se definisci questa espressione: price * 0.8 il sistema calcolerà il risultato moltiplicando il valore dell’attributo price per 0.8, applicando uno sconto del 20%.

Esempio #

Se inserisci nel campo New Value la stringa: price * 0.8 e il prezzo è 100, allora il risultato sarà 80.

New formatted attribute #

Questa azione crea un nuovo attributo basato su dati esistenti, applicando formattazioni o trasformazioni al suo valore.

Per fare riferimento a un attributo esistente, racchiudi il suo nome tra parentesi graffe senza spazi: {attributeName}.

• Copia un attributo: imposta New Value a {MPN}.
• Concatenare testo e attributi: € + {price}.

Se inserisci spazi nelle parentesi graffe, ad esempio { attribute }, il sistema salverà la stringa letterale (comprese le parentesi), non il valore dell’attributo.

Esempio #

Puoi combinare attributi, aggiungere prefissi o suffissi oppure cambiare come appare il dato. Ad esempio, per creare un prezzo formattato come €100,00, imposta New Value come: € + {price}.

If Statements #

Se aggiungi una condizione nel campo if, il comando verrà eseguito solo sugli attributi in cui la condizione specificata risulta vera.

Operatori disponibili:

Esempio #

Crea un nuovo attributo Availability impostato su Available, If stock > 0.

Testing & Save #

Prima di fare clic su Save & Run, che applica i modifiers a tutto il tuo catalogo, è consigliato testare prima il nuovo modifier. Puoi farlo nella sezione See how your modifiers impact your product data.

Qui puoi selezionare un prodotto e vedere come viene influenzato dal modifier, utilizzando la visualizzazione Before & After.

Puoi includere o escludere singolarmente i modifiers dall’anteprima. Utilizza la casella di controllo Include in preview su ciascun modifier per rimuoverlo temporaneamente dal calcolo durante il test di un prodotto. Questa selezione influisce solo sull’anteprima e non sul modifier live — tutti i modifiers verranno applicati quando fare clic su Save & Run.