Valider dit CSV-katalog, før du importerer ti tusind rækker

At validere et katalog-CSV starter med at vide, hvad der vil ændre sig ved import. Derefter kommer kolonnerne, identifikatorerne og værdierne. Et regneark, der åbnes uden advarsler, kan indeholde to produkter med samme SKU eller en størrelse uden værdi. En accepteret fil kan også opdatere det forkerte produkt.

Øvelsen nedenfor hjælper dig med at skelne mellem fejltyperne. Det er ti opfundne rækker med kontrollerbare resultater. Det er ikke en prøve fra en rigtig butik eller en fil forberedt til Shopify eller Frihet: det er et selvstændigt øvelsesformat, som du skal erstatte med destinationssystemets format.

Start med destinationen, ikke leverandørens fil

Download en aktuel skabelon, eller eksporter et repræsentativt produkt fra det værktøj, der skal modtage dataene. Notér, om du vil oprette, opdatere eller kombinere begge operationer; hvad der identificerer en post; hvilke felter der kræves; og hvad det betyder at lade en celle stå tom. Gem denne definition sammen med arbejdsfilen.

I Shopify er overskrivning for eksempel baseret på URL-identifikatoren, kaldet handle. Deres dokumentation kræver også, at man gennemgår afhængighederne mellem variantfelter og valgmuligheder. Vores SKU-regel beskriver ikke, hvordan denne importfunktion identificerer produkter. Shopifys produktformat.

Hvis du flytter data mellem systemer, skal du adskille denne gennemgang fra forbindelsen mellem butik og administration (på engelsk). En tilgængelig konnektor garanterer ikke, at den accepterer din leverandørs kolonner.

Definer regler, du kan kontrollere

I øvelsen repræsenterer hver række en salgbar vare. product_key grupperer dens varianter; sku skal være til stede og være unikt. name er obligatorisk. En variant kræver option_name og option_value; Hvis begge er tomme, er der ikke angivet en valgmulighed. Hvis de er udfyldte, må deres kombination med product_key ikke gentages.

Filen bruger UTF-8, kommaer mellem felter og otte kolonner i den viste rækkefølge. price accepterer ikke-negative tal med punktum og to decimaler, uden tusindtalsseparator. I currency kræver vi EUR til denne test. Disse er betingelser valgt til denne test, ikke universelle regler eller kommercielle priser. Der er ingen valutaomregning eller skatteberegning.

SKU’er bevares som tekst: 001 konverteres ikke til 1. Microsoft forklarer, hvordan man undgår automatiske konverteringer ved indlæsning af identifikatorer i Excel. Definer kolonnetypen, før du transformerer dataene; at ændre udseendet bagefter genskaber ikke originalen. Bevaring af foranstillede nuller i Excel.

Ti rækker, herunder én der ser korrekt ud

Kopier blokken som tekst for at undersøge den. Den sidste række har bevidst en kolonne mindre. row_id er testidentifikatoren; R01 er på den anden linje i filen, fordi den første indeholder overskrifterne.

Produktnavnene og de øvrige eksempelværdier er faste på tværs af sprog, så resultaterne kan efterprøves.

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

Resultatet er otte blokerede rækker, én afventende gennemgang og én, der godkendes. Dette er rækkestatusser, ikke otte uafhængige fejl: R01 har to konflikter. Du kan kontrollere hvert resultat ved at sammenligne nøglerne mellem rækkerne og felterne med de tidligere regler.

En dublet løses ikke ved at vælge den første række

R01 virker komplet, når den læses isoleret. Konflikten opstår, når hele sættet gennemgås: den deler SKU med en taske og variantkombination med en anden kop. Derfor skal kontrollen markere alle medlemmer af gruppen, ikke godkende den første og afvise den sidste.

Bed den ansvarlige for kataloget om at bekræfte, om der er en forkert reference, et gentaget produkt eller en dårligt beskrevet variant. Gem beslutningen med den tidligere værdi, den nye og dens årsag. Slet ikke R08 blot fordi dens navn stemmer overens; et rigtigt katalog kan skelne mellem materiale, størrelse eller andre muligheder, som dette forenklede ark ikke inkluderer.

For din faktiske importfil skal du også sammenligne med de referencer, der allerede findes på destinationen. En unik SKU inden for CSV’en kan stadig matche et andet produkt uden for filen. Definer desuden, hvordan mellemrum og forskelle i store og små bogstaver skal behandles, før normalisering: at rense en identifikator kan forene referencer, der skulle have forblevet adskilt.

Adskil format, tekst og betydning

R06 indeholder "12,50": anførselstegnene holder prisen i en enkelt celle. At tælle kommaer manuelt ville give en forkert diagnose; brug en CSV-læser. RFC 4180 beskriver denne anførselstegns-konvention, men definerer ikke, hvilke kolonner et katalog behøver, eller hvordan en pris skal fortolkes. Syntaksen i R06 er gyldig; værdien overholder ikke vores regel for feltet.

Foretag ikke en global erstatning af kommaer med punktummer: du ville ændre både separatorer og indhold. Identificer først feltet, bekræft kildeformatet, og konverter dets værdi på en kontrolleret måde. En tom værdi svarer heller ikke til nul; at registrere en nulpris ville være en kommerciel beslutning, som ingen har bekræftet.

R05 kræver endnu en kontrol. Teksten Café er gemt med gyldige UTF-8-bytes; dette beviser ikke, at navnet er korrekt. Advarslen i denne øvelse er forberedt til denne specifikke værdi, det er ikke en universel kodningsdetektor. Sammenlign navnet med kilden, og gennemgå, i hvilket trin teksten blev forvansket. At gemme allerede beskadiget tekst som UTF-8 igen gendanner ikke automatisk dens tegn.

Før du opdaterer, skal du kontrollere, hvad der bevares

En manglende kolonne og en tom celle kan medføre forskellige ændringer. Shopify dokumenterer, at ved overskrivning kan et tomt valgfrit felt tømme det eksisterende; at udelade dets kolonne kan bevare det. De advarer også om, at en påbegyndt import ikke kan annulleres og anbefaler en sikkerhedskopi inden import. Shopifys importbetingelser.

Identiteten af en variant kan også ændre sig: Shopify advarer om, at ændring af valgmulighedsværdier fjerner deres tidligere identifikatorer og opretter nye. Gennemgå forbindelser, der afhænger af dem, før du korrigerer en valgmulighed via CSV. Variantmuligheder og identifikatorer.

Forbered en sammenligning mellem tidligere tilstand, forventet ændring og observeret resultat. Inkluder de felter, der skal forblive uændrede. Test i et tilgængeligt testmiljø, og opbevar relaterede rækker for et produkt sammen; ti på hinanden følgende linjer repræsenterer ikke altid ti komplette produkter.

I en reel operation ville du vælge forskellige scenarier: et simpelt produkt, flere valgmuligheder, accentuerede tegn, tom pris og opdatering af en eksisterende reference. Denne prøve tester forløbet. Anvend derefter reglerne på hele filen: duplikater kan være adskilt af tusindvis af rækker. Se integrationer for at identificere værktøjerne i dit workflow, og bekræft hvert værktøjs regler for data.

Efterlad en beslutning, som en anden person kan gennemgå

Før upload skal du notere filversion, destination, ansvarlig, anvendte regler, afklarede fejl og sammenligning af testen. Hvis en bekræftelse mangler, skal du vente med importen; en «importeret»-meddelelse erstatter ikke den gennemgang.

Frihet understøtter CSV-import af produkter inden for sine administrationsfunktioner. Skemaet og de manuelle kontroller i denne artikel er uafhængige: de dokumenterer ikke, hvilke felter Frihet understøtter, eller hvilke automatiske kontroller produktet udfører. Brug skabelonen til din importfunktion, og start med at løse de rækker, du endnu ikke kan forklare.