Kaip paskirties vietos XML specifikaciją paversti B2BLIX eksporto šablonu

Ką padės atlikti šis vadovas

Paskirties vieta gali pateikti XML specifikaciją, kurioje aprašoma 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 reikšmės šaltinį ir paruošti reikšmes, kurias reikia apskaičiuoti arba suformatuoti.

B2BLIX Feed kuria XML eksportus iš susietų katalogo duomenų, eksportui skirtų produktų pasirinkimų, filtrų, transformavimo taisyklių ir šablono nustatymų.

Trumpas atsakymas

Pradėkite paskirties vietos specifikaciją paversdami paprastu laukų planu. Kiekvienam paskirties laukui užrašykite:

• XML elemento pavadinimą ir jo vietą dokumente.
• Ar laukas yra privalomas, ar pasirenkamas.
• Kuris B2BLIX atributas turėtų pateikti reikšmę.
• Ar reikšmę reikia apskaičiuoti, performatuoti, išversti arba pakeisti.
• Ar lauke naudojama fiksuota reikšmė, vienoda kiekvienam produktui.
• Kas turi nutikti, kai šaltinio reikšmė yra tuščia.

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

Įjungto eksporto pakeitimai gali paveikti XML failą, kurį naudoja svetainė, prekyvietė, kainų palyginimo platforma arba 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 pasirenkamus laukus lengviau nustatyti, kurių produktų duomenų trūksta, ir negaišti laiko laukams, kurių paskirties vietai nereikia.

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

Supraskite XML šablono dalis

Pagrindiniai ir konteinerių keliai

Pagrindinis elementas yra išorinė XML dokumento struktūra. Paprastai jis pateikiamas vieną kartą ir jame yra eksportuojama produktų kolekcija.

Pavyzdžiui, paskirties vietos specifikacijoje visi produktai gali būti pateikiami 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 šiame kelyje įrašomas kaip atskiras product elementas.

Išvesties laukų pavadinimai

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

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

Dinaminės reikšmės

Dinaminė reikšmė gaunama iš esamų produkto duomenų. Ji gali būti naudojama iš:

• Standartinio susieto atributo, pavyzdžiui, ean, price, stock arba title.
• Iš tiekėjo duomenų pasirinktos reikšmės.
• Naujo atributo, sukurto pagal duomenų transformavimo taisyklę, pavyzdžiui, price_for_website.

Todėl reikšmė gali skirtis kiekvienam produktui.

Konstantos

Konstanta yra fiksuota reikšmė, įrašoma kiekvienam taikomam produktui. Ji naudinga, kai paskirties vietai reikia informacijos, kuri tarp produktų nesikeičia.

Pavyzdžiui, valiutos laukui galima naudoti konstantą EUR, jei tai tinka visam eksportui.

Naudokite konstantą tik tada, kai reikšmė iš tiesų galioja kiekvienam paveiktam produktui. Fiksuota reikšmė neturėtų būti naudojama neišsamiems ar nenuosekliems tiekėjo duomenims paslėpti.

Numatytosios reikšmės

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

Prieš pridėdami numatytąją reikšmę patikrinkite:

• Ar paskirties vieta leidžia šiam laukui naudoti atsarginę reikšmę.
• Ar ta pati atsarginė reikšmė tinka visiems paveiktiems produktams.
• Ar vietoj tuščios privalomos reikšmės produktas neturėtų būti neįtraukiamas.
• Ar trūkstamą reikšmę reikėtų pataisyti tiekėjo susiejime arba šaltinio duomenyse.

Sukurkite eksporto šabloną

Norėdami sukonfigūruoti XML struktūrą, atidarykite Eksportus savo paskyroje. Išsamesnės informacijos apie eksporto nustatymus ir šablono sąsają rasite čia: XML eksporto projekcijų kūrimas ir konfigūravimas.

1. Sukurkite naują eksportą arba atidarykite ruošiamą eksportą.
2. Sukonfigūruokite bendruosius eksporto nustatymus ir pasirinkite reikiamus tiekėjus bei produktus.
3. Nustatykite pasikartojančio 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. Pasirenkamus laukus pridėkite tik tada, kai juose pateikiami naudingi duomenys ir jie atitinka paskirties vietos specifikaciją.
7. Išsaugokite konfigūraciją ir peržiūrėkite sugeneruotą XML prieš naudodami jį gamybos kanale.

Naudokite transformacijas, kai reikšmės negalima eksportuoti tiesiogiai

Kai kuriuos paskirties vietos reikalavimus galima įgyvendinti naudojant standartinius susietus atributus. Kitos reikšmės turi būti paruoštos prieš įtraukiant jas į šabloną.

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

Dažniausiai naudojama:

• Paskirties vietai skirtai kainai apskaičiuoti.
• PVM, fiksuotai maržai arba procentinei maržai pritaikyti.
• Skaitinėms reikšmėms suapvalinti.
• Paskirties vietai skirtam pavadinimui sukurti.
• Pasirinktam turiniui išversti.
• HTML aprašymams paversti paprastu tekstu.
• Raidžių registrui arba pavadinimo formatui pakeisti.
• Keliems atributams sujungti į vieną išvesties reikšmę.
• Sąlyginei logikai naudoti, kai skirtingiems produktams reikia skirtingų reikšmių.
• Papildomam atributui sukurti nepakeičiant pradinės reikšmės.

Kada naudoti kategorijų ID arba kodus

Kategorijų pavadinimai gali būti ilgi, išversti arba skirtingų tiekėjų užrašyti 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ą reikšmę tik tada, kai category id sutampa su pasirinkta kategorija. Ji taip pat gali neįtraukti šios kategorijos produktų arba sukurti paskirties vietai skirtą atributą.

Norėdami peržiūrėti B2BLIX kategorijas ir jų ID, atidarykite Kategorijų žemėlapį savo paskyroje. Išsamesnės informacijos apie kategorijų hierarchiją ir tiekėjų bei kategorijų ryšius rasite čia: 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 reikšmę paruoškite taikydami tinkamą taisyklę arba susiejimą, o ne manydami, kad ID yra tarpusavyje pakeičiami.

Tvarkykite tuščias reikšmes, HTML ir specialiuosius simbolius

Tuščios reikšmės

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

Automatiškai nepridėkite numatytųjų reikšmių prie kiekvieno tuščio lauko. Pirmiausia patikrinkite, ar laukas privalomas ir ar siūloma atsarginė reikšmė 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 reikšmės rodomos 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. Šie reikalavimai turi būti paimti iš paskirties vietos specifikacijos.

Patvirtinkite sugeneruotą XML

Išsaugoję šabloną, atidarykite bendruosius eksporto nustatymus Eksportų skiltyje. Prisijungę naudokite viešąjį eksporto URL, kad naršyklėje atidarytumėte sugeneruotą XML ir peržiūrėtumėte dabartinį jo 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 tikėtinos produktų reikšmės.
• Konstantos naudojamos tik ten, kur numatyta.
• Pateikiamos apskaičiuotos ir transformuotos reikšmės.
• Tuščios reikšmės tvarkomos pagal jūsų planą.
• Nedidelis neįprastų duomenų turinčių produktų pasirinkimas 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ė arba partneris failą priėmė, importavo ar paskelbė.

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

Jei rezultatas netikėtas, patikrinkite atskirus produktus

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

Atidarykite Eksportų tikrintuvą savo paskyroje. Daugiau informacijos apie šaltinio duomenis, apdorojimo informaciją ir ten rodomą eksportuotą XML rasite čia: Eksportų tikrintuvas: produkto duomenų ir eksporto rezultatų peržiūra.

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

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

Dažniausios įgyvendinimo problemos

• Neteisingas išvesties lauko pavadinimas. Vietoj paskirties vietai reikalingo elemento pavadinimo buvo panaudotas B2BLIX atributo pavadinimas.
• Produkto kelias nustatytas netinkamame lygyje. Pasikartojantis kelias turi reikšti vieną visą produktą, o ne visą kolekciją arba vieną atskirą atributą.
• Privalomas laukas neturi susietos reikšmės. Patikrinkite tiekėjo susiejimą ir įsitikinkite, kad produkte yra reikiami šaltinio duomenys.
• Neįkurtas apskaičiuotas atributas. 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 atitikimo atveju.
• Konstanta naudojama ten, kur reikia konkretaus produkto duomenų. Pakeiskite ją susieta arba transformuota dinamine reikšme.
• Kategorijų identifikatoriai palaikyti paskirties vietos kodais. Patvirtinkite, kokios kategorijų sistemos tikisi paskirties vieta, ir prireikus transformuokite reikšmę.
• XML atidaromas tinkamai, bet išorėje atmetamas. Palyginkite jį su paskirties vietos privalomais laukais, formatais, leidžiamomis reikšmėmis ir importo taisyklėmis. Vien XML sugeneravimas neįrodo, kad paskirties vieta jį priims.

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

Tarkime, prekyvietei reikia vieno pasikartojančio product elemento, kuriame yra ean, price, stock, title ir currency.

• ean naudoja standartinį ean atributą.
• stock naudoja dabartinę eksportuojamą likučio reikšmę.
• title naudoja susietą pavadinimą arba paskirties vietai skirtą transformuotą pavadinimą.
• price naudoja transformuotą atributą, kuriame įtraukta reikiama marža 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.

Ką daryti toliau

1. Paskirties vietos specifikaciją paverskite privalomų ir pasirenkamų laukų kontroliniu sąrašu.
2. Patvirtinkite, kad reikiami tiekėjo atributai yra susieti ir pasiekiami B2BLIX.
3. Duomenų transformavimo taisyklėse sukurkite reikiamus skaičiavimus, formatavimo taisykles, numatytąsias arba sąlygines reikšmes.
4. Eksporto šablone sukurkite XML produkto kelią ir laukų susiejimus.
5. Sugeneruokite XML ir palyginkite jį su paskirties vietos specifikacija.
6. Patikrinkite reprezentatyvius produktus, įskaitant produktus su tuščiomis arba neįprastomis reikšmėmis.
7. Naudokite Eksportų tikrintuvą, kai atskiro produkto rezultatas neaiškus.
8. Prieš plėsdami eksportą, išbandykite failą su paskirties vieta naudodami kontroliuojamą produktų pasirinkimą.

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