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-tuotteen rakenne siirretään kahdessa erillisessä CSV-aineistossa. options sisältää pakettivaihtoehdot, kuten otsikon, tyypin ja pakollisuuden. selections sisältää vaihtoehtoon liitetyt lapsituotteet, määrät, hinnan ja järjestyksen. Valinnat voidaan tuoda vasta, kun niiden vaihtoehdot ja kaikki pää- sekä lapsituotteet ovat olemassa.
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 options-tuonnilla
Päivitä vaihtoehdot avaamalla Data Exchange > Pakettien tuonti, valitsemalla lajiksi options ja lataamalla tai liittämällä CSV CSV-sisältö -kenttään. Valitse Esikatsele ennen ajoa ja tarkista enintään 100 näytettävää riviä sekä kokonaisrivimäärä.
Jos option_code vastaa olemassa olevaa vaihtoehtoa, tuonti päivittää sen päätuotteen, pakollisuuden, järjestyksen ja tyypin. Samalla se lisää tai päivittää kyseisen language_code-kielen otsikon ja kuvauksen. Jos koodia ei löydy, tuonti luo uuden vaihtoehdon annetulla koodilla.
Tyhjä option_code luo uuden vaihtoehdon ja antaa sille ajon aikana muodon option_{ID}. Käytä mieluummin omaa pysyvää ja yksilöllistä koodia, kuten option_putkihattu_001, jotta myöhempi valintatuonti ja päivitys kohdistuvat ennakoitavasti. Vie aineisto ajon jälkeen uudelleen, jos järjestelmä loi koodin.
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.