Kaip paskirties vietos XML specifikaciją paversti B2BLIX eksporto šablonu

Ką padės jums atlikti šis vadovas

Paskirties vieta gali pateikti XML specifikaciją, kurioje aprašyta laukiama struktūra ir produkto informacija. Jūsų užduotis – paversti šią specifikaciją eksporto projekcija, naudojančia jūsų B2BLIX katalogo duomenis.

Paprastai reikia nustatyti pasikartojantį produkto kelią, sukurti reikiamus išvesties laukus, pasirinkti kiekvieno laukelio vertės šaltinį ir paruošti vertes, kurias reikia apskaičiuoti arba suformatuoti.

B2BLIX Feed sukuria XML eksportus iš susietų katalogo duomenų, konkrečiam eksportui pasirinktų produktų, filtrų, transformavimo taisyklių ir šablono nustatymų.

Trumpas atsakymas

Pradėkite paversdami paskirties vietos specifikaciją paprastu laukų planu. Kiekvienam paskirties vietos laukui nurodykite:

• XML elemento pavadinimą ir jo vietą dokumente.
• Ar laukas yra privalomas, ar pasirinktinis.
• Kuris B2BLIX atributas turėtų pateikti vertę.
• Ar vertę reikia apskaičiuoti, iš naujo suformatuoti, išversti arba pakeisti.
• Ar laukui naudojama nekintama vertė, vienoda visiems produktams.
• Kas turėtų nutikti, kai šaltinio vertė yra tuščia.

Tada galite sukurti struktūrą eksporto šablone ir naudoti duomenų transformavimo taisykles vertėms, kurių negalima naudoti tiesiogiai.

Įjungto eksporto pakeitimai gali paveikti XML failą, kurį naudoja svetainė, prekyvietė, kainų palyginimo platforma ar kita paskirties vieta. Prieš keisdami naudojamą šabloną peržiūrėkite dabartinius nustatymus ir sugeneruotą XML.

Pirmiausia pasiruoškite paskirties vietos reikalavimus

Prieš konfigūruodami eksportą, pagal paskirties vietos specifikaciją sudarykite kontrolinį sąrašą. Atskyrus privalomus ir pasirinktinius laukus, lengviau nustatyti, kurių produkto duomenų trūksta, ir nešvaistyti laiko laukams, kurių paskirties vietai nereikia.

Naudokite tikslius paskirties vietos laukų pavadinimus ir dokumentacijoje nurodytus formatus. Nekeiskite paskirties vietos lauko pavadinimo vien todėl, kad atitinkamas B2BLIX atributas vadinamas kitaip.

Supraskite XML šablono dalis

Pagrindinis ir konteinerio keliai

Pagrindinė dalis yra išorinė XML dokumento struktūra. Paprastai ji pateikiama vieną kartą ir joje yra eksportuojamų produktų rinkinys.

Pavyzdžiui, paskirties vietos specifikacijoje visi produktai gali būti pateikti tokioje struktūroje kaip catalog/products.

Produkto kelias

Produkto kelias nurodo XML elementą, kuris kartojamas kiekvienam pasirinktam produktui. Jei specifikacijoje naudojamas catalog/products/product, kiekvienas eksportuojamas produktas tame kelyje įrašomas kaip atskiras product elementas.

Išvesties laukų pavadinimai

Išvesties laukų pavadinimai yra paskirties vietos reikalaujami XML elementų pavadinimai, pavyzdžiui, ean, price, stock arba title.

Jie apibūdina paskirties vietos struktūrą. Jie nenustato, iš kur gaunama lauko vertė.

Dinaminės vertės

Dinaminė vertė gaunama iš dabartinių produkto duomenų. Jai gali būti naudojama:

• Standartinis susietas atributas, pavyzdžiui, ean, price, stock arba title.
• Iš tiekėjo duomenų pasirinkta vertė.
• Naujas atributas, sukurtas naudojant duomenų transformavimo taisyklę, pavyzdžiui, price_for_website.

Todėl vertė kiekvienam produktui gali būti skirtinga.

Konstantos

Konstanta yra nekintama vertė, įrašoma kiekvienam tinkamam produktui. Ji naudinga, kai paskirties vietai reikia informacijos, kuri produktams nesikeičia.

Pavyzdžiui, valiutos laukui galima naudoti konstantą EUR, jei ji tinkama visam eksportui.

Naudokite konstantą tik tada, kai vertė iš tiesų galioja kiekvienam susijusiam produktui. Nekintama vertė neturėtų būti naudojama siekiant paslėpti neišsamius ar nevienodus tiekėjo duomenis.

Numatytosios vertės

Numatytoji vertė yra paruošta atsarginė vertė, naudojama, kai įprasta šaltinio vertė yra tuščia. Numatytosios vertės tinkamos tik tada, kai paskirties vieta leidžia naudoti tokią atsarginę vertę ir ji išlieka tiksli.

Prieš pridėdami numatytąją vertę patikrinkite:

• Ar paskirties vieta leidžia naudoti atsarginę to lauko vertę.
• Ar ta pati atsarginė vertė tinka visiems susijusiems produktams.
• Ar dėl trūkstamos privalomos vertės produktas neturėtų būti pašalintas.
• Ar trūkstamą vertę reikėtų pataisyti tiekėjo susiejime arba šaltinio duomenyse.

Sukurkite eksporto šabloną

Norėdami sukonfigūruoti XML struktūrą, atidarykite savo paskyros eksportus. Išsamesnės informacijos apie eksporto nustatymus ir šablono sąsają rasite perskaitę XML eksporto projekcijų kūrimas ir konfigūravimas.

1. Sukurkite naują eksportą arba atidarykite ruošiamą eksportą.
2. Konfigūruokite bendruosius eksporto nustatymus ir pasirinkite reikiamus tiekėjus bei produktus.
3. Nustatykite pasikartojantį produkto kelią pagal paskirties vietos specifikaciją.
4. Pridėkite paskirties vietos reikalaujamus išvesties laukų pavadinimus.
5. Susiekite kiekvieną išvesties lauką su standartiniu atributu, transformuotu atributu arba tinkama konstanta.
6. Pasirinktinius laukus pridėkite tik tada, kai jie pateikia naudingus duomenis ir atitinka paskirties vietos specifikaciją.
7. Išsaugokite konfigūraciją ir peržiūrėkite sugeneruotą XML prieš naudodami jį gamybos kanale.

Naudokite transformacijas, kai vertės negalima eksportuoti tiesiogiai

Kai kuriuos paskirties vietos reikalavimus galima įgyvendinti naudojant standartinius susietus atributus. Kitas vertes reikia paruošti prieš įtraukiant jas į šabloną.

Norėdami sukurti arba peržiūrėti šias taisykles, atidarykite savo paskyros duomenų transformavimo taisykles. Taisyklių filtrų, išraiškų, prioritetų ir transformuotų atributų paaiškinimą rasite perskaitę Duomenų transformavimo taisyklės.

Dažniausiai jos naudojamos:

• Paskirties vietai skirtai kainai apskaičiuoti.
• Taikyti PVM, fiksuotą antkainį arba procentinį antkainį.
• Skaitinėms vertėms suapvalinti.
• Paskirties vietai skirtam pavadinimui sukurti.
• Pasirinktam turiniui išversti.
• HTML aprašymams paversti paprastu tekstu.
• Raidžių dydžiui arba pavadinimo formatui pakeisti.
• Keliems atributams sujungti į vieną išvesties vertę.
• Sąlyginei logikai naudoti, kai skirtingiems produktams reikia skirtingų verčių.
• Papildomam atributui sukurti nepakeičiant pradinės vertės.

Kada naudoti kategorijų ID arba kategorijų kodus

Kategorijų pavadinimai gali būti ilgi, išversti arba skirtingų tiekėjų pateikiami nevienodai. Kategorijos ID dažnai patogiau naudoti filtre arba sąlyginėje transformacijoje, nes tai trumpesnė ir nuoseklesnė nuoroda.

Pavyzdžiui, taisyklė gali pritaikyti konkrečią vertę tik tada, kai category id sutampa su pasirinkta kategorija. Ji taip pat gali pašalinti tos kategorijos produktus arba sukurti paskirties vietai skirtą atributą.

Norėdami peržiūrėti B2BLIX kategorijas ir jų ID, atidarykite savo paskyros kategorijų žemėlapį. Išsamesnės informacijos apie kategorijų hierarchiją ir tiekėjų bei kategorijų ryšius rasite perskaitę Kategorijų žemėlapio sąsaja.

Jei paskirties vieta naudoja savo kategorijų kodus, patikrinkite, ar šie kodai skiriasi nuo B2BLIX kategorijų ID. Jei skiriasi, reikiamą paskirties vietos vertę paruoškite naudodami tinkamą taisyklę arba susiejimą, o ne manykite, kad ID yra tarpusavyje pakeičiami.

Tvarkykite tuščias vertes, HTML ir specialiuosius simbolius

Tuščios vertės

Transformavimo taisyklėje naudokite tuščios vertės sąlygas, kai išvestis priklauso nuo to, ar atributas pasiekiamas. Atsižvelgiant į paskirties vietos reikalavimus, taisyklė gali sukurti patvirtintą atsarginę vertę, pasirinkti kitą atributą arba padėti nustatyti produktus, kurių nereikėtų įtraukti.

Automatiškai nepridėkite numatytųjų verčių prie kiekvieno tuščio lauko. Pirmiausia patikrinkite, ar laukas privalomas ir ar siūloma atsarginė vertė yra tiksli.

HTML turinys

Jei paskirties vietai reikia paprasto teksto, o tiekėjo aprašyme yra HTML, duomenų transformavimo taisyklėje naudokite funkciją html-to-text. Gautą transformuotą atributą susiekite su paskirties vietos lauku eksporto šablone.

Specialieji simboliai

Peržiūrėkite sugeneruotą XML ir įsitikinkite, kad pavadinimai, aprašymai, gamintojų pavadinimai ir kitos tekstinės vertės rodomi teisingai. Ypač atkreipkite dėmesį į produktus, kuriuose yra kabučių, ampersandų, diakritinių ženklų arba daugiakalbio turinio.

Paskirties vieta taip pat gali taikyti savo simbolių, ilgio arba turinio apribojimus. Šiuos reikalavimus reikia nustatyti pagal paskirties vietos specifikaciją.

Patvirtinkite sugeneruotą XML

Išsaugoję šabloną, atidarykite bendruosius eksporto nustatymus iš Eksportų skilties. Prisijungę naudokite viešąjį eksporto URL, kad naršyklėje atidarytumėte sugeneruotą XML ir peržiūrėtumėte jo dabartinį turinį.

Patikrinkite, ar:

• Išorinė XML struktūra atitinka paskirties vietos specifikaciją.
• Produkto elementas kartojamas tinkamame kelyje.
• Privalomi išvesties laukai turi teisingus pavadinimus.
• Laukuose pateikiamos numatytos produkto vertės.
• Konstantos rodomos tik ten, kur numatyta.
• Pateikiamos apskaičiuotos ir transformuotos vertės.
• Tuščios vertės tvarkomos pagal jūsų planą.
• Nedidelė neįprastų duomenų turinčių produktų imtis taip pat atrodo teisingai.

Sėkmingas XML sugeneravimas ir atidarymas patvirtina, kad B2BLIX sukūrė išvesties failą. Tai nepatvirtina, kad išorinė prekyvietė, svetainė ar partneris failą priėmė, importavo arba paskelbė.

Neskelbkite ir nesidalykite privačiu konkrečiam klientui skirtu eksporto URL viešoje dokumentacijoje arba su neįgaliotais asmenimis.

Patikrinkite atskirus produktus, kai rezultatas netikėtas

Jei viename produkte trūksta lauko, pateikiama netikėta vertė arba produktas neįtraukiamas, naudokite Eksportų tikrintuvą produkto lygio rezultatui patikrinti.

Atidarykite savo paskyros eksportų tikrintuvą. Išsamesnės informacijos apie ten rodomus šaltinio duomenis, apdorojimo informaciją ir eksportuotą XML rasite perskaitę Eksportų tikrintuvas: produkto duomenų ir eksporto rezultatų peržiūra.

Atsižvelgdami į produktą, peržiūrėkite:

• Pradines tiekėjo vertes.
• Susietus B2BLIX atributus.
• Produktui pasirinktą tiekėją.
• Eksporto filtrus, dėl kurių produktas galėjo būti įtrauktas arba pašalintas.
• Transformavimo taisykles, pakeitusias jo vertes.
• Galutinius eksporto naudojamus atributus.
• Atitinkamą eksportuotą XML.

Dažniausios įgyvendinimo problemos

• Neteisingas išvesties lauko pavadinimas. Vietoj paskirties vietos reikalaujamo elemento pavadinimo buvo panaudotas B2BLIX atributo pavadinimas.
• Produkto kelias nustatytas netinkamu lygiu. Pasikartojantis kelias turi apibrėžti visą vieną produktą, o ne visą rinkinį arba vieną atskirą atributą.
• Privalomas laukas neturi susietos vertės. Patikrinkite tiekėjo susiejimą ir įsitikinkite, kad produkte yra reikiami šaltinio duomenys.
• Apskaičiuotas atributas nebuvo sukurtas. Sukurkite reikiamą duomenų transformavimo taisyklę ir įsitikinkite, kad ji įjungta eksportui.
• Transformacija netaikoma numatytiems produktams. Patikrinkite jos filtro kriterijus, prioritetą ir eksportui sukonfigūruotą elgseną sustabdyti, jei sąlyga sutampa.
• Konstanta naudojama ten, kur reikia konkretaus produkto duomenų. Pakeiskite ją susieta arba transformuota dinamine verte.
• Kategorijų identifikatoriai palaikyti paskirties vietos kodais. Patvirtinkite, kurios kategorijų sistemos tikisi paskirties vieta, ir prireikus transformuokite vertę.
• XML atidaromas tinkamai, bet išorėje atmetamas. Palyginkite jį su paskirties vietos reikalaujamais laukais, formatais, leidžiamomis vertėmis ir importo taisyklėmis. Vien XML sugeneravimas neįrodo, kad paskirties vieta jį priėmė.

Pavyzdys: prekyvietės produkto įrašo paruošimas

Tarkime, prekyvietei reikia vieno pasikartojančio product elemento, kuriame būtų ean, price, stock, title ir currency.

• ean naudoja standartinį ean atributą.
• stock naudoja dabartinę eksportuojamo likučio vertę.
• title naudoja susietą pavadinimą arba paskirties vietai skirtą transformuotą pavadinimą.
• price naudoja transformuotą atributą, kuriame įtrauktas reikiamas antkainis ir apvalinimas.
• currency naudoja konstantą eur, nes visos šio eksporto kainos paruoštos eurais.

Jei paskirties vietai reikia aprašymų paprastu tekstu, sukurkite papildomą transformuotą aprašymą naudodami funkciją html-to-text ir susiekite šį atributą su atitinkamu išvesties lauku.

Kas toliau

1. Paverskite paskirties vietos specifikaciją privalomų ir pasirinktinių laukų kontroliniu sąrašu.
2. Patvirtinkite, kad būtini tiekėjo atributai yra susieti ir pasiekiami B2BLIX.
3. Sukurkite visus skaičiavimus, formatavimo taisykles, numatytąsias arba sąlygines vertes duomenų transformavimo taisyklėse.
4. Sukurkite XML produkto kelią ir laukų susiejimus eksporto šablone.
5. Sugeneruokite XML ir palyginkite jį su paskirties vietos specifikacija.
6. Patikrinkite reprezentatyvius produktus, įskaitant produktus su tuščiomis arba neįprastomis vertėmis.
7. Jei atskiro produkto rezultatas neaiškus, naudokite Eksportų tikrintuvą.
8. Prieš išplėsdami eksportą, patikrinkite failą paskirties vietoje naudodami kontroliuojamą produktų pasirinkimą.

Jei įmanoma, bandomąjį eksportą laikykite atskirai nuo tiesioginio pardavimo kanalo proceso. Išplėtus katalogą tik patikrinus struktūrą ir vertes, sumažėja rizika paskelbti neteisingas kainas, likučius, turinį ar produktų pasirinkimus.