Importul de produse prin fișier XML este unul dintre cele mai rapide și mai ușoare moduri de a importa un număr mare de produse în magazinul dvs.  Aplicaţia Import XML vă oferă posibilitatea de a importa o singură dată sau de a sincroniza la un interval de timp toate produsele dintr-un fişier sau link, în format XML. Modulul acesta o să vă fie foarte util dacă doriţi să adăugaţi produsele unui furnizor/distribuitor cu care colaboraţi. Astfel orice modificare de preţuri/stocuri se va reflecta automat şi în magazinul dvs.
Pentru a importa produsele, este necesar ca fişierul XML să conţină toate datele necesare pentru importare şi să fie structurat corect.


În articolul acesta citiţi:

Structura unui fişier XML?

Fişierul XML trebuie să conţină date bine structurate. Acesta conţine tag-uri care se aseamănă foarte mult cu tag-urile HTML. Un document XML este practic un fişier text în care se regăsesc diferite declaraţii XML şi tag-uri, precum şi text. Iată cum arată un document XML cu titlu de exemplu, şi care conţine informaţii despre numeroase produse:

În imaginea de mai sus vedeţi nişte tag-uri în care se regăsesc diferite elemente din informaţiile generale privind anumite produse date. Fiecare element al unui produs - precum numele, categoria, ID al produsului, descriere, marcă, preţ, greutate, cantitate, poză, diversitate, valoare şi altele, trebuie să fie delimitat printr-un tag iniţial (de deschidere) şi unul final (de închidere). Tag-ul iniţial şi cel final trebuie să poarte una şi aceeaşi denumire, diferenţa fiind - tagul final este precedat de o bară înclinată în dreapta "/"), pentru ca informaţiile să pot fi citite în mod corect de parcer şi să fie importate în magazinul dvs. online prin aplicaţia Import XML. Între aceste două tag-uri se găseşte conţinutul, adică datele care sunt incluse în secţiunea respectivă.


Trebuie să fie un element de bază în care să se regăsească tot restul elementelor. Acesta se numeşte Document Root. În exemplul dat, acesta este elementul <products>. Acest tag iniţial este urmat, obligatoriu, de unul final </products>. Acesta conţine numeroase sub-tag-uri fiecare dintre acestea având şi un tag final, şi anumite informaţii între tag-uri, spre exemplu, tag-ul pentru producător este <manufacturer>Manufacturer name</manufacturer>.

Denumirile tag-urilor, în sine, ce conţin fiecare element, sunt unele aleatorii, nefiind strict stabilite şi fiind introduse de creatorul fişierului XML. La importare acestea vor fi conectate de elementele deja existente ale unui produs.  


Un fişier XML bine structurat corespunde unui set de reguli extrem de stricte şi care controlează XML-ul. Dacă un anumit fişier nu li se supune, fişierul XML nu va mai funcţiona. În poza de mai sus vedeţi că fiecare tag iniţial are respectivul tag final, aceasta fiind una dintre regulile de bază pentru un XML bine structurat. Dacă îndepărtaţi un tag şi încercaţi să deschideţi fişierul în cauză, veţi vedea un mesaj de eroare şi programul vă va împiedica să folosiţi fişierul.


Nu este obligatoriu să cunoaşteţi regulile pentru crearea unui XML bine structurat, însă trebuie să ţineţi minte că puteţi împărtăşi date XML între programe şi sisteme doar dacă datele sunt structurate corect. Dacă nu puteţi deschide fişierul XML, este foarte probabil ca acel fişier să nu fie cu structura corectă

.

Instalarea aplicaţiei

Pentru ca să folosiţi aplicaţia Import XML este necesar să aveţi un astfel de fişier XML sau feed (fişierul pus la dispoziţie sub forma de link şi din care în continuu sunt preluate informaţii). O altă variantă este să aveţi un alt fel de sursă de informaţii (Tabel pe Google Sheets, spre exemplu) şi pe care s-o convertiţi în format XML. Informaţiile cu un produs anume dintr-un tabel, de regulă, sunt afişate pe un rând, în schimb aceste informaţii într-un XML sunt afişate pe numeroase rânduri şi care sunt îngrădite de un tag (spre exemplu, <product>). Realmente, afişarea orizontală a datelor se transformă într-o afişare verticală în fişierul XML.


1. Accesaţi panoul dvs. de administrare, secţiunea Setări > Fişiere şi apăsaţi butonul Încărcare fişiere în butonul din dreapta sus a ecranului dvs., pentru a încărca fişierul xml, dacă aveţi. După aceea copiaţi link-ul şi lipiţi-l în browser pentru a verifica dacă funcţionează corect. În cazul în care există o problemă cu fişierul, pe ecran va fi afişată notificarea respectivă.

2. Următorul pas este să accesaţi secţiunea Aplicaţii > Toate aplicaţiile şi alegeţi Import XML şi butonul Instalare.

Setări (Pasul 1)

1. Apăsaţi butonul Începe sarcină nouă pentru a începe sarcina de import.

  • Numele sarcinii (Job name) – introduceţi un nume prin care veţi diferenţia sarcina. Ulterior acest nume o să vă ajute să distingeţi şi dintre produse - care produs prin care sarcină a fost importat. Numele sarcinii va apărea numai în panoul de control. Dacă, spre exemplu, încărcaţi produse dintr-o anumită categorie (Headphones/ Căşti), chiar puteţi denumi astfel sarcina.
  • În câmpul XML URL link plasați link-ul (feed-ul xml) pe care-l aveţi sau pe care l-aţi copiat după ce aţi încărcat fişierul în secţiunea Setări > Fișiere
  • Importați toate produsele într-o categorie – folosiţi meniul derulant pentru a selecta o categorie de produse existentă în care vor fi importate toate produsele XML din sarcina respectivă. Dacă fișierul XML conține informații despre categoriile de produse, nu este nevoie să folosiţi acest meniu derulant. Dacă feed-ul XML pe care-l încărcaţi conţine produse doar dintr-o anumită categorie, o puteţi selecta încă din primul pas, în cazul în care nu aţi selectat o astfel de categorie, sistemul va aştepta să alegeţi o categorie pentru fiecare produs, în pasul al doilea 


Dacă încă nu aţi creat categorii în magazinul dvs., vedeţi cum faceţi acest lucru aici.

  • Importați toate produsele cu marcă – această opţiune funcţionează în acelaşi principiu ca şi selecţia de categorie. Din meniul derulant puteţi  selecta o marcă existentă în care vor fi importate toate produsele importate.
  • În următorul câmp Importă toate produsele ca, puteţi alege dacă importaţi produsele şi acestea vor fi publicate direct, sau vor rămâne ascunse.
  • XML tag al produsului – un câmp în care este necesar să introduceți informaţii importante, anume tag-ul produsului. În fişierul XML tag-ul iniţial şi cel final definesc începutul şi sfârşitul unui anumit produs. În cazul nostru este vorba despre tag-ul <product>. Este necesar să introduceţi tag-ul XML al produsului, de la fişierul dvs. XML pentru ca percer-ul (script-ul care citeşte fişierele XML) să poată înţelege de unde începe şi unde se termină un produs în structura xml. Tag-ul respectiv poate fi oricare, nu există un anumit standard, de aceea vedeţi cum este denumit acesta în fişierul dvs.

Tag-ul produsului conţine tot restul tag-urilor şi informaţiilor despre fiecare produs:

  • Atașați la o sarcină principală – importer-ul de XML este un soft destul de extins şi care înafară de import, poate de asemenea actualiza produsele. De asemenea puteţi avea şi numeroase sub-sarcini care să fie ataşate la o sarcină principală, Adică dacă aţi lansat o sarcină principală de import produse, puteţi lansa alte sarcini sub ea prin care vă puteţi completa catalogul de produse. Această funcţie este foarte utilă dacă toate produsele pe care doriţi să le încărcaţi, nu sunt într-un fişier, ci sunt împărţite în câteva fişiere. În cazul acesta puteţi lansa câteva sarcini care pot funcţiona ca una şi astfel puteţi uni întregul catalog de produse.
     

  • Linii (Rânduri, rows) – în acest câmp introduceți numărul maxim de rânduri (linii) din fişier şi în care sistemul poate verifica dacă există tag-ul produsului, şi poate extrage informaţiile necesare. Acest lucru este important deoarece când treceţi la al doilea pas, soft-ul va citi tot fişierul şi va prelua structura sa, o va afişa în cel de-al doilea pas pentru a face mapping-ul respectiv - mapping-ul unei valori din fişierul XML cu o altă valoare din produs. Este important ca în numărul de linii pe care-l menţionaţi, să se regăsească tag-ul iniţial şi cel final. Implicit liniile sunt 500 şi, în general, acest număr este absolut destul, dar dacă aveţi un fişier XML mai mare, puteţi modifica numărul. Trebuie să aveţi în vedere că numărul mare de linii încetineşte procesul de citire.
  • Oprirea produselor lipsă - o funcţionalitate extrem de utilă atunci când lucraţi cu feed-uri, deoarece ei se actualizează încontinuu. Dacă un anumit produs este deja epuizat din stoc sau este îndepărtat din site-ul distribuitorului cu care lucraţi, atunci produsul respectiv va fi îndepărtat automat şi din magazinul dvs. la înnoirea feed-ului. 
  • Urmărirea cantității – dacă feed-ul dvs. conţine informaţie privind calitatea, atunci această opţiune trebuie să fie pornită pentru ca să puteţi adăuga cantitatea respectivă şi sistemul să poate urmări bucăţile.
  • Continuă vânzările - dacă porniţi această opţiune, înseamnă că deşi cantitatea unui produs este 0, produsul respectiv va fi oferit în continuare în magazinul dvs. şi clienţii îl vor putea comanda.

  • ID-ul sarcinii - indiferent de identificatorul pe care-l veţi alege, este important ca el să fie unic pentru fiecare sarcină în parte. Dacă există sarcini cu unul şi acelaşi ID, este probabil ca produsele să intre în conflict. 
  • Adăugare reducere - prin importul de XML este posibil să adăugaţi şi reduceri pentru produse, dar în acest scop este necesar ca fişierul dvs. XML să conţină şi o astfel de valoare (original price şi sale price).


Dacă porniţi această opţiune, trebuie să creaţi o reducere din meniul Marketing > Reduceri şi să alegeţi Reducere fixă. Aplicaţia import XML funcţionează doar cu acest tip de reduceri. După ce veţi crea reducerea, aceasta se va folosi pentru actualizarea continuă, dacă feed-ul XML conţine astfel de informaţii.

Setări (Pasul 2)

După ce verificaţi datele introduse în primul pas, folosiţi butonul Salvează şi mergi la pasul 2, unde veţi seta cum se va face importul datelor de la feed-ul XML în catalogul de produse al magazinului dvs.

  • Alegere număr unic produs - din meniul derulant alegeţi identificatorul produsului care corespunde acestei condiţii, astfel încât să nu existe produse cu SKU sau ID egale/identice, spre exemplu. În dreapta, în meniul derulant, veţi vedea structura fişierului dvs. XML. Selectaţi identificatorul pentru produsele dvs., prin care aceştia se deosebesc unul faţă de celălalt, pentru ca să fie posibil ca la actualizarea feed-ului XML să nu se întâmple astfel încât două produse care au unul şi acelaşi ID, să se actualizeze într-unul şi acelaşi fel.
  • Titlul produsului - alegeţi tag-ul în care se regăseşte numele fiecărui produs din fişier. Acesta poate fi diferit, adică poate veni cu denumiri diferite (name, product name, validation name, title etc. în fişierul nostru cu titlu de exemplu, asta este tag-ul <title>.
  • Scurtă descriere - dacă există asemenea informaţii în fişierul dvs., alegeţi tag-ul respectiv, dacă nu - omiteţi acest câmp.
  • Descriere - descrierea unui anumit produs poate fi destul de lungă şi poate conţine tot felul de semne, link-uri, imagini etc. Selectaţi tag-ul respectiv care deschide şi închide descrierea produselor. În fişierul nostru este tag-ul <description>


Dacă în descrierea unui anumit produs se regăsesc şi imagini, atunci soft-ul "Import XML" le va extrage şi le va încărca şi le va salva direct în storage-ul magazinului dvs., astfel încât acestea să devină parte din descrierea produselor respective.


Când importați produse, dacă fișierul XML conține file ale căror descrieri sunt un link pentru a încorpora videoclipuri de pe YouTube (numai link), ca aici:

<tabs>
<tab>
<name> Video </name>
<description>https://www.youtube.com/embed/clJj2GUCicc</description>
</tab>
</tabs> 

În acest caz, linkul va fi înlocuit cu un cod care va putea afișa direct videoclipul.


  • Titlul SEO şi descrierea meta SEO - este posibil să nu le selectaţi, acestea vor fi create în mod automat de denumirea şi descrierea produsului.
  • Adresă URL veche - ne serveşte ca atunci când migrăm un anumit magazin. Dacă setaţi o valoare pentru vechea adresă URL a produsului, importerul XML va crea link-urile 301 în mod automat, astfel încât să salveze poziţionarea/indexarea produsului dvs. Mai multe citiţi aici.

  • Preţ - selectaţi tag-ul pentru preţul original (dacă aveţi preţ cu reducere).
  • Preţ cu reducere - selectaţi tag-ul care responsabil cu preţul cu reducere.
  • SKU - selectaţi tag-ul responsabil pentru sku al produsului
  • Cod de bare - selectaţi tag-ul responsabil pentru codul de bare al produsului. Acesta poate veni în diferite denumiri - EAN, ISSN (dacă este vorba despre cărţi)
  • Cantitate - selectaţi tag-ul responsabil pentru cantitatea produsului
  • Greutate - dacă în fişierul dvs. există astfel de informaţii, selectaţi tag-ul respectiv
  • Nou - produsul trebuie să fie marcat ca nou. Această funcţionalitate este utilă dacă încărcaţi fişier doar cu produse noi şi dacă doriţi să fie marcate ca atare.


Dacă doriţi ca un anumit rând din cele sus enumerate să fie actualizat permanent, este necesar să bifaţi rândurile/liniile dorite, după cum este afişat în poza de mai sus. 

Cu cât mai multe rânduri selectaţi pentru actualizare, cu atât mai lent se va face importul, deoarece vor fi comparate numeroşi indici ai diferitelor produse pentru ca soft-ul să poate efectua actualizarea conform criteriilor date.

Tab-uri suplimentare cu descriere şi informaţii

Această este o funcţionalitate care vă permite ca, dacă aveţi câteva descrieri pentru un anumit produs din feed, respectiv să fie create câteva tab-uri cu aceste descrieri. Dacă aveţi o singură descriere, nu este necesar să ştergeţi nimic.

Caracteristici categorie

Structura unei caracteristici este la fel ca şi definiţia unui produs:

Aveţi un tag general pentru toate caracteristicile. Fiecare caracteristică vine cu propria denumire şi valoare. O caracteristică începe obligatoriu cu un tag de deschidere şi unul de închidere. Din meniul derulant selectaţi mappaţi tag-urile respective. 

  • Valorile caracteristicii pot fi câteva în număr dar acestea pot fi separate prin virgule în cel de-al treilea pas din setări.
  • Valoarea proprietăţii - preia cel mai des valoarea caracteristicii astfel încât puteţi pune acelaşi tag.

În exemplul nostru tag-urile sunt următoarele:

În secţiunea următoare selectaţi tag-ul pentru producător.

Diversități

Pentru ca să importați diversitățile produselor, este necesar ca fișierul dvs. XML să conțină grupuri de diversități produse. La diversități se va urmări aceeași logică precum și la caracteristici. Din nou, este necesar să alegeți cu atenție tag-urile respective din fișierul dvs. XML

Pozele produsului - În cazul în care aveți câteva poze ale unui anumit produs în fișierul XML acestea pot fi unite într-un tag și vor fi separate prin virgulă. În al treilea pas din setări puteți crea o regulă prin care soft-ul, atunci când detectează o virgulă, să separe diferitele elemente și să le considere a fi items-uri separate.

Setări (Pasul 3)

În al treilea pas puteți crea operațiuni separate și reguli pentru executarea lor la importarea produselor din fișierul XML în catalogul magazinului dvs., astfel încât să corespundă nevoilor dvs. 

În cazul de față creăm următoarea regulă: Pozele produsului > Conține > Egal cu > , > Înlocuiește cu > Nimic (lăsați  câmpurile necompletate) și apăsăm butonul Salvare.

După ce ați salvat sarcina, aceasta devine activă, se pune în ordine și când vine rândul pentru îndeplinire, se lansează rularea ei. 

La încărcarea pozelor, acestea vor fi încărcate cu puțină întârziere, deoarece grupul de clustere - servere, prelucrează fiecare poză încărcată. Imaginile sunt optimizate, sunt puse filtrele necesare, se optimizează calitatea pentru ca să se încarce şi să se deschidă cât de repede posibil pe site-ul dvs. şi ele să fie cu calitate optimă.

Setări suplimentare

După lansarea sarcinii, aceasta niciodată nu se va opri, iar următoarele lansări se vor întâmpla la fiecare 12 ore  - importarea XML începe pentru a se actualiza conţinutul, dacă există modificări precum sunt produsele noi, stocurile, preţul etc.


Aveţi posibilitate să creşteţi gradul de prioritate a sarcinii dvs. precum şi să scurtaţi intervalul de executare - în loc de 12 ore, implementarea să fie făcută la fiecare 6 ore, spre exemplu.

Din butonul XML Import - prioritate sarcină puteţi achiziţiona prioritate pentru executarea sarcinii. Adică sarcina va fi executată de o prioritate de 20, 40, 60 sau 80% înainte de restul sarcinilor.

De la celălalt buton XML Import - interval de executare puteţi modifica intervalul prin care va fi lansată o anumită sarcină.