Siirry sisältöön
← Takaisin Journaliin
Oppaat
6 min lukeminen

Tarkista CSV-tuoteluettelo ennen tuhansien rivien tuontia

Tarkista SKU-tunnukset, variantit, hinnat ja tekstivirheet ennen tuontia. Kymmenen CSV-rivin harjoitus, jonka tulokset voit tarkistaa itse.

Kirjoittanut Frihet-tiimi
Tarkista CSV-tuoteluettelo ennen tuhansien rivien tuontia

TL;DR: Tarkista ensin, miten kohdejärjestelmä tulkitsee CSV-tuoteluettelon, ja käy sitten läpi sarakkeet, tunnisteet, variantit ja arvot. Kokeile tunnettuja virheitä sisältävää näytettä ja tarkista koko tiedosto ennen tuontia. Kymmenen hyväksyttyä riviä ei osoita, että muut ovat kunnossa tai että päivitys säilyttää kaikki tiedot.

Sisältö

CSV-tuoteluettelon validointi alkaa siitä, että tiedät, mitä muuttuu tuonnin yhteydessä. Sen jälkeen tulevat sarakkeet, tunnisteet ja arvot. Tiedosto, joka avautuu ilman varoituksia, voi sisältää kaksi tuotetta samalla SKU

tai koon ilman arvoa. Hyväksytty tiedosto voi myös päivittää väärän tuotteen.

Seuraava testi auttaa erottamaan nämä virheet. Esimerkissä on kymmenen kuvitteellista riviä, joiden tulokset voi tarkistaa. Se ei ole oikean kaupan näyte eikä Shopifylle tai Frihetille valmisteltu tiedosto: se on harjoitusta varten määritelty tiedostorakenne, joka sinun on korvattava kohdejärjestelmän vaatimalla rakenteella.

Aloita kohteesta, älä toimittajan tiedostosta

Lataa voimassa oleva mallipohja tai vie edustava tuote tiedot vastaanottavasta työkalusta. Merkitse ylös, aiotko luoda, päivittää vai yhdistää molemmat toiminnot; mikä yksilöi tietueen; mitä kenttiä vaaditaan; ja mitä tarkoittaa tyhjän solun jättäminen. Säilytä tämä määritelmä työtiedoston rinnalla.

Esimerkiksi Shopifylla päällekirjoitus perustuu URL-tunnisteeseen, jota kutsutaan handle-nimellä. Sen dokumentaatio edellyttää myös varianttikenttien ja vaihtoehtojen välisten riippuvuuksien tarkistamista. Meidän SKU-sääntömme ei kuvaa, miten kyseinen tuontitoiminto tunnistaa tuotteita. Shopifyn tuotteiden CSV-muoto.

Jos siirrät tietoja järjestelmien välillä, erota tämä tarkistus kaupan ja hallinnan välisestä yhteydestä (englanniksi). Saatavilla oleva liitin ei osoita, että se hyväksyy toimittajasi sarakkeet.

Määrittele säännöt, jotka voit tarkistaa

Harjoituksessa jokainen rivi edustaa myytävää tuotetta. product_key ryhmittelee sen variantit; sku-kentän on oltava täytetty ja sen arvon yksilöllinen. name on pakollinen. Variantti tarvitsee sekä option_name- että option_value-kentän. Jos molemmat ovat tyhjiä, vaihtoehtoa ei ole määritelty. Kun molemmat on täytetty, niiden ja product_key-kentän yhdistelmän on oltava yksilöllinen.

Tiedosto käyttää UTF-8-merkistöä, pilkkuja kenttien välissä ja kahdeksaa saraketta näytetyssä järjestyksessä. price sallii ei-negatiiviset luvut pisteellä ja kahdella desimaalilla, ilman tuhaterottimia. Tässä testissä currency-kentän arvon on oltava EUR. Nämä ovat tätä testiä varten valittuja ehtoja, eivät universaaleja sääntöjä tai kaupallisia hintoja. Harjoituksessa ei muunneta valuuttoja eikä lasketa veroja.

SKU

säilytetään tekstinä: 001 ei muutu muotoon 1. Microsoft selittää, miten vältetään automaattiset muunnokset tunnisteita Exceliin ladattaessa. Määritä sarakkeen tyyppi ennen tietojen muuntamista; sen ulkoasun muuttaminen jälkikäteen ei palauta alkuperäistä. Etunollien säilyttäminen Excelissä.

Kymmenen riviä, mukaan lukien yksi, joka näyttää oikealta

Kopioi lohko tekstinä tarkastellaksesi sitä. Viimeisellä rivillä on tarkoituksella yksi sarake vähemmän. row_id on testin tunniste; R01 on tiedoston toisella rivillä, koska ensimmäinen sisältää otsikot.

Tuotenimet ja muut esimerkkiarvot säilyvät samoina kaikissa kieliversioissa, jotta tulokset ovat toistettavissa.

row_id,product_key,sku,name,option_name,option_value,price,currency
R01,P01,001,Taza,Color,Natural,19.90,EUR
R02,P01,002,Taza,Color,Ink,19.90,EUR
R03,P02,001,Bolsa,,,29.00,EUR
R04,P03,,Cuaderno,,,8.50,EUR
R05,P04,005,Café,,,6.00,EUR
R06,P05,006,Vaso,,,"12,50",EUR
R07,P06,007,Camiseta,Size,,24.00,EUR
R08,P01,008,Taza,Color,Natural,19.90,EUR
R09,P07,009,,,,15.00,EUR
R10,P08,010,Bandeja,,,25.00
RiviOdotettu tulosTutkittavaa
R01Estä: SKU ja variantti päällekkäisiäVertaile R03
ja R08
kanssa; tätä riviä ei myöskään hyväksytä.
R02Läpäisee harjoituksen säännötSäilytä kontrollina; ei osoita yhteensopivuutta kohteen kanssa.
R03Estä: SKU päällekkäinen001 tunnistaa myös R01
mukin.
R04Estä: SKU puuttuuPyydä SKU-tunnusta; älä keksi sitä nimen perusteella.
R05Tarkista tekstiVertaa Café-tekstiä toimittajan alkuperäiseen.
R06Estä: hinnan muotoDesimaalipilkku on vastoin valittua sääntöä.
R07Estä: variantti puutteellinenSize-vaihtoehdolta puuttuu arvo.
R08Estä: variantti päällekkäinenP01 + Color + Natural esiintyy jo R01
, vaikka SKU muuttuisi.
R09Estä: nimi puuttuuTunnista tuote ennen jatkamista.
R10Estä: rakenne puutteellinenKenttiä on seitsemän; odotettiin myös valuuttasaraketta.

Tulos on kahdeksan estettyä riviä, yksi tarkistusta odottava ja yksi hyväksytty. Nämä ovat rivien tiloja, eivät kahdeksan itsenäistä virhettä: R01

on kaksi ristiriitaa. Voit tarkistaa jokaisen tuloksen vertaamalla avaimia rivien välillä ja kenttiä edellisiin sääntöihin.

Duplikaattia ei ratkaista valitsemalla ensimmäinen rivi

R01 näyttää täydelliseltä yksinään luettuna. Ristiriita ilmenee, kun käydään läpi koko joukko: sama SKU esiintyy myös laukun rivillä ja sama varianttiyhdistelmä toisen mukin rivillä. Siksi tarkistuksen on merkittävä kaikki ryhmän jäsenet, ei hyväksyttävä ensimmäistä ja hylättävä viimeistä.

Pyydä luettelon ylläpitäjää vahvistamaan, onko olemassa väärä viite, toistuva tuote tai huonosti kuvattu variantti. Kirjaa päätös sekä vanha arvo, uusi arvo ja muutoksen perustelu. Älä poista R08

vain siksi, että sen nimi on sama; todellinen luettelo voi erottaa materiaalin, koon tai muut vaihtoehdot, joita tämä yksinkertaistettu arkki ei sisällä.

Todellista erää varten vertaile myös jo kohteessa oleviin viitteisiin. CSV-tiedoston sisäinen yksilöllinen SKU voi silti vastata toista tuotetta tiedoston ulkopuolella. Määrittele lisäksi, miten käsitellä välilyöntejä ja isojen ja pienten kirjainten eroja ennen normalisointia: tunnisteen puhdistaminen voi yhdistää viitteitä, joiden olisi pitänyt pysyä erillään.

Erottele muoto, teksti ja merkitys

R06 sisältää "12,50": lainausmerkit pitävät hinnan yhdessä solussa. Pilkkujen käsin laskeminen antaisi virheellisen diagnoosin; käytä CSV-lukijaa. RFC 4180 kuvaa tämän lainausmerkkikäytännön, mutta se ei määrittele, mitä sarakkeita luettelo tarvitsee tai miten hinta tulkitaan. R06

syntaksi on kelvollinen; sen arvo ei täytä kentälle asettamaamme sääntöä.

Älä korvaa kaikkia pilkkuja pisteillä: vaihtaisit sekä erottimet että sisällön. Tunnista ensin kenttä, vahvista lähdemuoto ja muunna sen arvo hallitusti. Tyhjä ei myöskään vastaa nollaa; nollahinnan kirjaaminen olisi kaupallinen päätös, jota kukaan ei ole vahvistanut.

R05 vaatii toisen tarkistuksen. Teksti Café on tallennettu kelvollisilla UTF-8-tavuilla; tämä ei todista, että nimi olisi oikea. Tämän harjoituksen varoitus on valmisteltu juuri tuota arvoa varten, se ei ole universaali koodaustunnistin. Vertaile nimeä lähteeseen ja tarkista, missä vaiheessa se vääristyi. Jo vaurioituneen tekstin tallentaminen uudelleen UTF-8-muodossa ei automaattisesti palauta sen merkkejä.

Ennen päivitystä tarkista, mitä säilyy

Puuttuva sarake ja tyhjä solu voivat tuottaa erilaisia muutoksia. Shopify dokumentoi, että päällekirjoitettaessa tyhjäksi jätetty valinnainen kenttä voi tyhjentää olemassa olevan; sen sarakkeen pois jättäminen voi säilyttää sen. Se myös varoittaa, että aloitettua tuontia ei voi peruuttaa ja suosittelee varmuuskopion ottamista ennen tuontia. Shopifyn tuontiehdot.

Variantin identiteetti voi myös muuttua: Shopify varoittaa, että variantin vaihtoehtoarvojen muuttaminen poistaa variantin aiemmat tunnisteet ja luo uudet. Tarkista niistä riippuvat yhteydet ennen vaihtoehdon korjaamista CSV-tiedoston avulla. Varianttien vaihtoehdot ja tunnisteet.

Valmistele vertailu edellisen tilan, odotetun muutoksen ja havaitun tuloksen välillä. Sisällytä kentät, joiden on pysyttävä samoina. Kokeile käytettävissä olevassa testausympäristössä ja säilytä tuotteeseen liittyvät rivit yhdessä; kymmenen peräkkäistä riviä eivät aina edusta kymmentä kokonaista tuotetta.

Todellisessa toiminnossa valitsisit erilaisia tapauksia: yksinkertainen tuote, useita vaihtoehtoja, aksenttimerkkejä, tyhjä hinta ja olemassa olevan viitteen päivitys. Tämä näyte testaa prosessin. Sen jälkeen sovella sääntöjä koko tiedostoon: duplikaatit voivat olla tuhansien rivien erottamia. Katso integraatiot tunnistaaksesi työnkulkuusi kuuluvat työkalut ja varmista kunkin työkalun tietovaatimukset.

Jätä päätös, jonka toinen henkilö voi tarkistaa

Ennen lataamista merkitse ylös tiedoston versio, kohde, vastuuhenkilö, sovelletut säännöt, ratkaistut tapaukset ja testin vertailu. Jos vahvistus puuttuu, säilytä erä odottamassa; «tuotu»-viesti ei korvaa tätä tarkistusta.

Frihet tukee tuotteiden CSV-tuontia hallintatoimintojensa puitteissa. Tämän artikkelin tiedostorakenne ja käsin tehtävät tarkistukset ovat erillisiä harjoitusvälineitä: ne eivät osoita, mitä kenttiä tai automaattisia tarkistuksia Frihet tukee. Käytä tuontiohjelmasi mallia ja aloita sellaisten rivien ratkaisemisesta, joita et vielä pysty selittämään.

Jaa

Oliko tästä artikkelista hyötyä?

Usein kysytyt kysymykset

Korvaavatko nämä tarkistukset tuontityökalun säännöt?

Eivät: rakenne ja manuaaliset tarkistukset ovat erillinen harjoitus. Käytä kohdejärjestelmän nykyistä mallia ja tarkista sen luontia, päivitystä ja tyhjiä kenttiä koskevat säännöt.

Takaako kymmenen rivin tarkistus muun luettelon oikeellisuuden?

Ei. Otoksella kokeillaan työnkulkua; sovella sitten sääntöjä koko tiedostoon ja vertaa sitä kohdejärjestelmän nykyisiin tunnisteisiin, sillä kaksoiskappaleita voi olla otoksen ulkopuolella.

Liittyvät artikkelit

Frihet — Liiketoiminta ilman draamaa

Aloita Ilmaiseksi