Bundle-tuotteiden vienti ja tuonti CSV-tiedostoilla
Opi helpot keinot viedä ja tuoda Bundle-tuotteita käyttämällä CSV-tiedostoja!
Sisällysluettelo
Bundle-tuotteiden massasiirto käyttää kahta aineistoa
Bundle-tuotteiden massamuokkaus onnistuu turvallisesti, kun käsittelet rakenteen kahdessa järjestyksessä. options-aineisto määrittää pakettivaihtoehdot, niiden otsikot, tyypit ja pakollisuuden. selections-aineisto liittää vaihtoehtoihin lapsituotteet, määrät, hinnat ja järjestyksen. Tuo vaihtoehdot ensin ja valinnat vasta sen jälkeen.
Turvallinen etenemisjärjestys:
- Vie sekä
options- ettäselections-aineisto ja säilytä ne muuttamattomina vertailua varten. - Testaa ensin yhdellä bundle-tuotteella, että koodit, kielitekstit, lapsituotteet ja hinnat muodostuvat oikein.
- Tuo vaihtoehdot, tarkista tulos ja tuo vasta sitten valinnat.
- Varmista lopuksi bundle-rakenne, oletusvalinnat, määrät ja hinnoittelu Hallintapaneelissa.
Vienti auttaa palautusvertailussa, mutta tuonti lisää ja päivittää rivejä eikä poista tiedostosta puuttuvia vaihtoehtoja tai valintoja.
Hallintapaneelissa massasiirrot kuuluvat Data Exchange-työtilaan. Käytä profiileja Pakettien vienti ja Pakettien tuonti. Kummassakin valitaan aineistolajiksi options tai selections.
Luo ensin yksi pieni bundle-tuote käyttöliittymässä ja varmista se verkkokaupassa. Vie sen molemmat aineistot, säilytä alkuperäiset tiedostot muuttamattomina ja tee muokkaukset kopioihin. Vienti toimii rakennepohjana, mutta tuonti ei ole täydellinen palautusmekanismi, koska se lisää tai päivittää rivejä eikä poista tiedostosta puuttuvia rivejä.
Vie pakettivaihtoehdot CSV-tiedostoon
Vie pakettivaihtoehdot avaamalla Data Exchange > Pakettien vienti, valitsemalla bundle-viennin lajiksi options ja käynnistämällä vienti. Lataa valmis CSV-artefakti. Tiedoston nimi alkaa muodolla bundle-options.
Pakettivaihtoehtojen sarakkeet ovat järjestyksessä option_code, parent_sku, required, position, type, language_code, title ja description.
Jokainen rivi kuvaa yhtä vaihtoehdon ja kielen yhdistelmää. Sama option_code ja parent_sku toistuvat jokaiselle kieliversiolle. required kertoo pakollisuuden kokonaislukuna, position järjestyksen, type valintatavan, language_code kielen sekä title ja description asiakkaalle näytettävät tekstit.
Vie bundle-valinnat CSV-tiedostoon
Vie bundle-valinnat samalla Pakettien vienti -profiililla valitsemalla lajiksi selections. Lataa valmis artefakti, jonka nimi alkaa muodolla bundle-selections. Jokainen rivi yhdistää yhden lapsituotteen yhteen pakettivaihtoehtoon ja päätuotteeseen.
Valintojen otsikot ovat täsmälleen:
option_code,parent_sku,sku,position,is_default,selection_price_type,selection_price_value,selection_qty,selection_can_change_qty
sku on lapsituotteen SKU. position ohjaa järjestystä, is_default oletusvalintaa, selection_price_type hinnoittelutapaa, selection_price_value hintalukua, selection_qty oletusmäärää ja selection_can_change_qty asiakkaan oikeutta muuttaa määrää. Jokainen lapsituote on omalla rivillään.
Muokkaa CSV-tiedostoa rikkomatta formaattia
Muokkaa aina viennin kopiota. Vienti ja tuonti käyttävät pilkkua erottimena ja lainausmerkkiä tekstikenttien suojaamiseen. Jos otsikko tai kuvaus sisältää pilkun, CSV-ohjelman pitää lainata kenttä oikein. Älä vaihda tiedostoa puolipiste-erotelluksi.
Tallenna tiedosto UTF-8-muodossa. Tuonti hyväksyy myös UTF-8 BOM -merkin ensimmäisen otsikon alusta, mutta tavallinen UTF-8 ilman BOM-merkkiä on siirrettävin vaihtoehto. Säilytä kaikki vaaditut otsikot. Otsikoiden fyysinen järjestys saa muuttua, koska tuonti kohdistaa arvot nimillä, mutta jokaisella datarivillä pitää olla sama määrä sarakkeita kuin otsikkorivillä.
Pidä SKU:t ja option_code-arvot tekstinä. Älä anna taulukkolaskennan muuttaa koodeja päivämääriksi, poistaa alkunollia tai käyttää desimaalipilkkua numeerisessa hinnassa. Tyhjät rivit ohitetaan, mutta tyhjä tiedosto ja pelkkä otsikkorivi hylätään.
Päivitä pakettivaihtoehdot ja kysymykset options-tuonnilla
options-tuonti lisää ja päivittää sekä tuotteita sisältäviä pakettivaihtoehtoja että paketin Kysymykset-välilehdellä hallittavia asiakaskysymyksiä. Vie ensin nykytila kohdasta Tiedonsiirto > Pakettien vienti valitsemalla Bundle-vienti-arvoksi options. Muokkaa ladatun bundle-options-tiedoston kopiota, jotta pysyvät kysymyskoodit, kielirivit ja nykyiset radiovalinnat säilyvät mukana.
options-tiedoston otsikkorivi on täsmälleen tässä järjestyksessä:
option_code,parent_sku,required,position,type,language_code,title,description,choice_id,choice_position,choice_label,show_when_option_code,show_when_choice_id
Säilytä otsikot ja niiden järjestys muuttumattomina. option_code on pakollinen pysyvä tunniste, parent_sku paketin päätuotteen SKU, required arvo 1 tai 0, position kokonaislukuna annettava järjestys, language_code aktiivisen kauppakielen koodi sekä title ja description kyseisen kielen asiakastekstit. Käytä omaa yksilöllistä koodia, kuten option_putkihattu_001; tyhjää arvoa tai mallimerkintää option_{ID} ei voi tuoda. Sama vaihtoehto tai kysymys kuvataan samalla option_code- ja parent_sku-yhdistelmällä kaikilla sen riveillä.
Tuotteita sisältävä tavallinen pakettivaihtoehto käyttää nykyisiä type-arvoja ja jättää viisi kysymyskohtaista saraketta tyhjiksi. Asiakaskysymyksen tyyppi on jokin seuraavista:
-
input_radionäyttää radiovalinnat. Tee yksi rivi jokaista kielen ja valinnan yhdistelmää kohti.choice_idon pysyvä valintakoodi,choice_positionvalinnan järjestys jachoice_labelkyseisen kielen näkyvä nimi. Toista samat valintakoodit ja järjestykset kaikilla mukana olevilla kielillä. Uudella valinnalla pitää olla nimi vähintään yhdellä kielellä. -
input_numberpyytää positiivisen luvun. Tee yksi rivi jokaista mukana olevaa kieltä kohti ja jätächoice_id,choice_positionjachoice_labeltyhjiksi. -
input_notepyytää enintään 200 merkin vapaaehtoisen huomautuksen. Käytärequired-arvoa0, tee yksi rivi jokaista mukana olevaa kieltä kohti ja jätä valintasarakekolmikko tyhjäksi.
Ehdollinen kysymys käyttää sarakkeita show_when_option_code ja show_when_choice_id aina yhdessä. Ensimmäiseen annetaan saman päätuotteen aiempana olevan input_radio-kysymyksen option_code ja toiseen sen olemassa oleva choice_id. Ehtoa ohjaavan radiokysymyksen pitää olla järjestyksessä ennen ehdollista kysymystä eikä se voi itse olla ehdollinen. Jätä molemmat sarakkeet tyhjiksi, kun kysymys näytetään aina.
- Avaa Tiedonsiirto > Pakettien tuonti ja valitse muokattu CSV-tiedosto. Tuonti tunnistaa
options- jaselections-aineistot niiden täsmällisistä otsikoista. - Valitse Esikatsele valittu CSV. Tarkista lisättäviksi, päivitettäviksi ja virheellisiksi luokitellut rivit. Esikatselu tarkistaa muun muassa päätuotteet, kielet, tyypit, pysyvät koodit, radiovalinnat ja näyttöehdot.
- Korjaa kaikki virheet tiedostoon ja esikatsele se uudelleen. Valitse vasta virheettömälle aineistolle Suorita tuonti, vahvista suoritus ja tarkista suoritusraportti.
- Vie
options-aineisto uudelleen ja tarkista yhden päätuotteen Paketti > Kysymykset -näkymä sekä asiakkaan pakettikonfiguraattori.
Tuonti on lisäävä ja päivittävä: tiedostosta puuttuvaa vaihtoehtoa, kysymystä, kielitekstiä tai radiovalintaa ei poisteta. Olemassa olevan radiokysymyksen päivityksessä jokainen sen nykyinen choice_id pitää kuitenkin sisällyttää vähintään kerran; puuttuva valintakoodi aiheuttaa esikatseluvirheen. Tiedostossa mukana oleva kielirivi päivitetään, mutta pois jätetty olemassa oleva kieli säilyy. Paketin tuotteet, hinnat ja määrät kuuluvat edelleen erilliseen selections-aineistoon, eikä kysymysrivi lisää tuotetta tai muuta paketin hintaa.
Päivitä lapsituotteet selections-tuonnilla
Päivitä vaihtoehtojen lapsituotteet valitsemalla Pakettien tuonti -profiilin lajiksi selections. Jokainen rivi etsii option_code-arvolla olemassa olevan pakettivaihtoehdon, parent_sku-arvolla päätuotteen ja sku-arvolla lapsituotteen.
Jos saman vaihtoehdon, päätuotteen ja lapsituotteen yhdistelmä on jo olemassa, tuonti päivittää järjestyksen, oletusvalinnan, hinnoittelutavan, hinnan, määrän ja määrän muokattavuuden. Muussa tapauksessa se lisää uuden valinnan. selection_price_value ja selection_qty ovat pakollisia numeerisia arvoja; niitä ei voi jättää tyhjäksi tuonnissa.
Tuo options ensin ja selections vasta sen onnistuttua. Valintatuonti ei luo puuttuvaa vaihtoehtoa, päätuotetta tai lapsituotetta. Kaikkien SKU-arvojen pitää viitata ennalta olemassa oleviin tuotteisiin.
Ymmärrä esikatselun ja ajon raja
Esikatselun ja ajon raja kulkee rakenteen ja liiketoimintaviittausten välissä. Esikatselu tarkistaa CSV:n otsikot, sarakemäärät, aineistolajin ja sen, että tiedostossa on rivejä. Se näyttää enintään 100 ensimmäistä riviä. Esikatselu ei ratkaise SKU:ita, kielikoodeja, option_code-viittauksia eikä kaikkien numeroarvojen kelvollisuutta.
Varsinainen Aja-toiminto validoi viittaukset ja arvot kirjoituksen aikana. Tuntematon päätuotteen SKU, lapsituotteen SKU, kielikoodi tai vaihtoehtokoodi aiheuttaa virheen. Myös virheellinen kokonaisluku tai numeerinen arvo keskeyttää ajon. Riviä ei ohiteta hiljaisesti.
Koko tuontiajo suoritetaan yhdessä tietokantatransaktiossa. Jos mikä tahansa rivi epäonnistuu, koko ajo perutaan eikä yksikään sen rivi jää voimaan. Onnistuneen ajon jälkeen järjestelmä laskee jokaisen muutetun päätuotteen bundle-hinnan uudelleen ja tyhjentää tuotekohtaisen välimuistin.
Käytä kenttiä niiden täsmällisen merkityksen mukaan
Käytä kenttiä niiden täsmällisen merkityksen mukaan. Pakettivaihtoehdon required käyttää kokonaislukua 1 pakolliselle ja 0 valinnaiselle. position on kokonaisluku, jossa pienempi arvo näytetään ensin. type tallennetaan tekstinä; käytä vain tuote-editorin tarjoamia tyyppejä, kuten radio, checkbox, select, multi tai dropdown.
Valinnan is_default käyttää arvoja 1 ja 0. selection_can_change_qty käyttää vastaavasti arvoa 1, jos asiakas saa muuttaa määrää, ja 0, jos määrä on lukittu. selection_qty on numeerinen oletusmäärä.
selection_price_type ja selection_price_value tallennetaan suoraan bundle-valinnan hinnoitteluun. selection_price_type-arvojen 0 ja 1 täsmällistä hinnoittelumerkitystä ei ole vahvistettu. Älä muuta näitä arvoja laajasti ennen kuin olet vienyt toimivan esimerkin ja varmistanut hinnan verkkokaupassa.
Käytä vientiä palautusvertailuna, ei sokeana varmuuskopiona
Tallenna ennen muutosta sekä options- että selections-vienti turvalliseen paikkaan. Nimeä tiedostot ympäristön, päivämäärän ja aineistolajin mukaan. Älä tallenna niihin henkilötietoja tai salaisuuksia; tuotetunnisteet voivat silti olla liiketoiminnallisesti luottamuksellisia.
Vienti auttaa vertaamaan ennen- ja jälkeen-tilaa ja palauttamaan muuttuneita rivejä uudella tuonnilla. Tuonti lisää tai päivittää rivejä eikä poista tiedostosta puuttuvia vaihtoehtoja tai valintoja. Tarvittavat poistot tehdään tuotteen Paketti-näkymässä tai erikseen hyväksytyllä poistoprosessilla.
Älä pidä onnistunutta ajotilaa ainoana palautustodisteena. Vie molemmat aineistot ajon jälkeen ja vertaa odotettuihin riveihin. Tarkista myös päätuotteen bundle-rakenne ja hinta verkkokaupassa.
Tarkista pieni koeajo ennen massamuutosta
Tee ensin koeajo yhdellä päätuotteella. Vie toimiva vaihtoehto ja valinta, muuta vain yhtä selkeästi havaittavaa arvoa ja suorita options- tai selections-tuonti sen mukaan. Tarkista ajon onnistuminen, käsitelty rivimäärä ja uusi vienti.
Tarkista seuraavaksi tuotteen Paketti-näkymästä vaihtoehdon koodi, pakollisuus, tyyppi, järjestys, kielitekstit, lapsituotteet, oletusvalinta, määrä ja hinnoittelu. Avaa sama tuote verkkokaupassa ja käy valinnat läpi asiakkaan näkökulmasta.
Laajenna tiedostoa vasta onnistuneen kokeen jälkeen. Koska yksi virhe peruu koko ajon, käsittele suuret muutokset loogisina, tarkistettavina erinä. Säilytä jokaisen erän syöte, ajon pyyntö-ID ja ajon jälkeinen vienti vianrajausta varten.
Esimerkit kahdesta CSV-aineistosta
Esimerkit kahdesta CSV-aineistosta alkavat pakettivaihtoehdoista: ensimmäinen sisältää kaksi kieltä samalle vaihtoehdolle ja yhden valinnaisen vaihtoehdon.
option_5,ABC-123,1,1,radio,fi,Kiinnikkeet,Valitse 2 kpl kiinnikkeitä
option_5,ABC-123,1,1,radio,en,Fixtures,Pick two
option_6,ABC-123,0,2,checkbox,fi,Jalusta,Valitse jalusta
Valintojen esimerkissä jokainen lapsituote on omalla rivillään:
option_code,parent_sku,sku,position,is_default,selection_price_type,selection_price_value,selection_qty,selection_can_change_qty
option_5,ABC-123,KNI-001,1,1,0,0.00,2,1
option_5,ABC-123,KNI-002,2,0,1,1.50,1,0
option_6,ABC-123,JAL-100,1,0,0,0.00,1,1
Esimerkkien SKU:t, koodit ja hinnat ovat malliarvoja. Korvaa ne oman ympäristösi viennistä saaduilla arvoilla. Älä aja esimerkkirivejä sellaisenaan tuotantoon.
Bundle-tuonti on valmis vasta rakenne- ja hintavarmennuksen jälkeen
Bundle-tuonti on valmis, kun molempien aineistolajien ajo on onnistunut, ajon jälkeinen vienti vastaa tarkoitusta, tuote-editorin rakenne on oikea ja asiakkaan valinnat sekä hinta toimivat verkkokaupassa. Tarkista myös lapsituotteiden olemassaolo ja saatavuus.
Jos ajo epäonnistuu, käytä virheen rivinumeroa ja koodia korjauksen lähtökohtana. Älä poista riviä vain saadaksesi ajon vihreäksi, vaan varmista, onko kyse puuttuvasta tuotteesta, kielestä, vaihtoehdosta, numeerisesta arvosta vai väärästä sarakerakenteesta.
Pidä pysyvät option_code-, parent_sku- ja sku-arvot integraatioiden yhteisenä sopimuksena. Näin myöhempi vienti, tuonti ja käsin tehty muokkaus kohdistuvat samoihin tuotteisiin ja vaihtoehtoihin ilman hiljaista ohitusta.