Импортирането на продукти с XML файл е един от най-бързите и лесни начини да импортирате в магазина си голям каталог с продуктово съдържание. Често XML импортирането може да се наложи, ако работите с партньор/дистрибутор, който ви предоставя каталог в XML структура. В тази статия ще намерите информация относно това какво представлява XML структурата и как да я използвате, за да активирате приложението, което ние сме разработили, за да улесним управлението на продуктовия каталог в онлайн магазина ви.

Какво е XML файл и XML структура?

За разбирането на XML е от помощ идеята за коригиране на данни. Хората създават документи от векове и от също толкова дълго време добавят знаци към тях. Коригирането на документ е начинът, по който определяме структурата, значението и външния вид на информацията в документа. В света на компютрите „коригирането“ се е развило в „маркиране“. Маркирането е процесът на използване на кодове, наричани етикети (или понякога маркери), за определяне на структурата, външния вид и – в случая на XML– значението на данните. Ето как изглежда част от примерен XML файл, отворен в браузър и съдържащ информация за стотици продукти:



В горната снимка виждате тагове, в които се съдържа всеки елемент от общата информация за продукт. Всеки елемент от един продукт като идентификационен код, име, категория, описание, тагове, марка, цена, тегло, количество, снимка, разновидност и стойност трябва да бъде ограден с отварящ и затварящ таг, за да може информацията да се чете коректно и да може да се импортира във вашия магазин чрез приложението XML импортиране. Имената на самите тагове, в които се съдържа всеки елемент от продукта се определят от създателя на XML файла.

Добре оформеният XML файл отговаря на набор от много строги правила, които управляват XML. Ако даден файл не отговаря на тези правила, XML спира да работи. Например в извадката от код по-горе всеки отварящ таг има съответен затварящ таг, така че извадката отговаря на едно от правилата за правилно оформяне. Ако премахнете един таг и се опитате да отворите този файл, ще видите съобщение за грешка и програмата ще ви попречи да използвате файла.

Не е задължително да знаете правилата за създаване на добре оформен XML (макар че са лесни за разбиране), но трябва да запомните, че можете да споделяте XML данни между програми и системи само ако данните са добре оформени. Ако не можете да отворите XML файл, много вероятно е този файл да не е добре оформен.

В какви случаи да използвате приложението XML импортиране

когато имате предоставена онлайн информация (в структура, различна от XML, която може да се конвертира в XML) за голям брой продукти, които искате да продавате в онлайн магазина си
когато ваш партньор или диструбутор ви предоставя информация за продуктите, които искате да продавате в XML файл

Ако информацията за продуктите, които искате да качите в магазина си не е събрана на едно място и продуктите не са много, не е необходимо да използвате това приложение за импортиране. В този случай можете да качите ръчно всеки един продукт в магазина си, което също става много лесно и бързо в секция Продукти в контролния панел на магазина ви.

Оттук можете да видите нашият примерен CloudCart Шаблон

Първа стъпка в настройките на задача в XML приложението

Влезте в контролния панел на магазина си и намерете XML импортиране в секция Приложения, за да кликнете и инсталирате тази интеграция.



След като инсталирате приложение, изберете бутона Стартирай задача и попълнете следните настройки:

Име на задачата – напишете име за XML задачата спрямо критериите и целта, поради която я създавате. Името ще се вижда само в контролния панел, в списъка със задачи в приложението за импортиране
XML URL линк – тук поставете пълния URL адрес към XML хранилката. Ако имате XML файл, първо го качете в секция Настройки -> Файлове в контролния си панел, за да получи линк, който да сложите в това поле
Импортирай всички продукти в категория – използвайте падащото меню, за да изберете съществуваща продуктова категория, в която всички продукти от XML задачата ще се импортират. Ако в XML файла се съдържа информация за продуктови категории, не е нужно да използвате това падащо меню, само го пропуснете и продължете към следващите настройки в задачата
Импортирай всички продукти с марка – използвайте падащото меню, за да изберете съществуваща марка, в която всички продукти от XML задачата ще се импортират. Ако в XML файла се съдържа информация за марките на продуктите, не е нужно да използвате това падащо меню, само го пропуснете и продължете към следващите настройки в задачата
Импортирай всички продукти като – от падащото меню изберете дали продуктите да се импортират като директно да са видими в магазина ви или да се импоритрат като непубликувани. След като цялата задача се изпълни и продуктите са импортирани, можете да използвате бързите инструменти в секция Продукти, за да публикувате всички продукти наведнъж
XML таг на продукта – тук въведете тага от XML структурата, в който се съдържат всички останали тагове и информация за всеки продукт. XML таг на продукта в тази структура например:

e <product> – в този случай в първата стъпка от настройките на задачата, трябва да въведете product за таг на продукта.

Прикачи към основна задача – aко имате основна XML задача и тази, която сега създавате трябва да се изпълнява към нея, можете да изберете основната от това падащо меню. Например, ако имате един XML фийд с продукти и втори XML фийд с наличности, то първия XML (този с продуктите), ще е основен на този с наличностите.
Линии – тук въведете максималния брой редове в XML fфийда, в които системата да провери дали съществува продуктовия таг. Ако структурата на фийда е правилна, би трябвало да няма нужда да променяте броя линии и продуктовия таг със сигурност да се съдържа в първите 500 линии.
Проследяване на количеството – чрез тази опция количеството на всички продукти, които ще се импортират ще се следи от системата. Когато един артикул бъде продаден, останалото количество ще се преизчислява от общото зададено количество на продукта.
Продължи продажбата – ако включите тази опция системата ще позволява поръчване на продукта, дори ако количеството на продукта е 0
ID на задачата – въведете номер на задачата. Той ще служи, за да може системата за разграничава или обединява задачите, които сте активирали в приложението. ID на задачата позволява създаването на няколко задачи за импортиране, които да работят в синхрон. За да могат да работят заедно и да обновяват информацията на продуктите, ID на задачите им трябва да е едно и също.
Добавяне на отстъпки – ако XML фийда съдържа продукти с две цени (основна и намалена), тук трябва да изберете съществуваща в контролния панел фиксирана отстъпка, в която тези продукти да се импортират, за да показват двете си цени в магазина ви. Ако още нямате такава отстъпка в контролния панл, а в XML фийда има продукти с две цени, вижте как да създадете фиксирана отстъпка тук.



След като проверите въведените в първата стъпка данни, използвайте бутона Запази и отиди към 2-ра стъпка, където ще посочите как да се импортират данните от XML фийда в продуктовия каталог на магазина ви.

Втора стъпка в настройките на задача в XML приложението

Ако въведеният в предната стъпка продуктов таг е верен, сега платформата вече ще може да прочете съдържанието на XML фийда. За вас остава да настроите като какъв елемент на продуктите да се импортира всеки от таговете, съществуващи в XML фийда.

Първо и най-важно е да изберете кой е уникалния номер на продукта в XML фийда. Разгледайте файла, с който разполагате и преценете в кой таг се съдържат различни номера за всеки от продуктите в XML фийда.

Всички полета, които виждате в лявата част са елементите, които биха могли да съществуват за един продукт. Заглавието на продукта е неговото име. Ако в XML файла, който качвате има таг, в който се съдържа името на всеки продукт, трябва да изберете от падащото меню срещу Загавие кой е този таг. Например, в XML фийд с тази структура ->



product е тага на продукта, таг id ще се използва за уникален номер на продукт, product code може да се въведе като SKU на продукта, а title е тага, в който се съдържа името на всеки продукт от файла. Така първите няколко елемента от 2-ра стъпка на примерната ни задача ще изглеждат така:



Импортиране на разновидности на продукти
За да импортирате разновидности на продуктите е нужно вашият XML файл да съдържа групи от разновидности на продуктите.
В най-общия случай, можете да имате една група от разновидности например Размер, като към нея може да имате безброй стойности. Например XS, S, M, L, XL, XXL, XXXL и тн.

В примера по-долу разглеждаме един от най-често срещаните случаи - два броя разновидности - Размер и Цвят


ВАЖНО! Възможно е да имате до 3бр. разновидности

Подробно описание на анатомията на XML файла


Ето как би изглеждала втора стъпка при мапване на разновидностите от този XML файл:



В зависимост от информацията, която имате в XML фийда и информацията, която искате да импортирате в магазина, продължете със свързването на двете колони като внимателно избирате кои тагове да се попълнят за продуктите в каталога ви. Натиснете Запази и продължи към 3-та стъпка, за да допълните настройките на задачата.

Трета стъпка в настройките на задача в XML приложението

В тази стъпка можете да създадете допълнителни операции и правила за импортирането на продуктите от XML файла в каталога на магазина ви. Ако например искате съдържанието на някой от таговете да се промени/допълни или промени с определени стойности, можете да настроите всички тези действия и да промените по необходимия начин импортирането на продуктите.

В примера по-долу, в 3-тата стъпка на задачата е направена настройка, чрез която ако тагът от файла, който попълва полето за количество на продукта, съдържа думите “ограничена наличност“, това съдържание ще се замени с “1“.



Тази настройка би могла да е необходима, ако в XML фийда, тагът <qty> не съдържа реално количество, а съдържа статус с думи тип “ограничена наличност“.

В следващия пример, в 3-тата стъпка на задачата е направена настройка, чрез която информацията в тагът от файла, който попълва полето за цена на продукта, ще бъде умножена с определена стойност.



Тази настройка би могла да е необходима, ако в XML фийда разполагате със стойност на цена, която искате да се качи в каталога ви вече повишена.

Допълнителни настройки на XML задача

Някои от елементите, които добавяте за всеки от продуктите си, могат да бъдат модифицирани като въведете повече от един таг, от който те да се съставят. Например, ако искате името на продукта в магазина ви да се състои от информацията в два различни тага от xml фийда, можете да го направите като във втора стъпка от задачата изберете, че искате Заглавие да се състои от Няколко елемента и после добавите всеки един от тях. Вижте краткото видео по-долу.



Друга опция е да добавите подкатегории за продуктите си, ако имате такива тагове в XML фийда, които да съдържат информаця за категории, подкатегоии или под-подкатегории. Например, ако искате да добавите такава структура за продуктовите категории, можете във втора стъпка на задачата да изберете бутона добави още и от новото падащо меню да посочите тага, който отговаря за подкатегорията на продуктите. Вижте краткото видео по-долу.



Важно е да обърнете внимание, че ако в първа стъпка коректно сте посочили кой е тага на продукта, във следващите стъпки използвате падащите менюта, в които системата вече успешно ще ви показва информацията от файла и вие само трябва да посочвате за какво да се използва всеки таг от XML фийда.
Беше ли ви полезна тази статия?
Отказ
Благодарим ви!