Miten viedä ja tuoda valmistajat CSV:llä?
Massapäivitä brändit CSV:llä: vie, muokkaa ja tuo turvallisesti—vältä sarakevirheet ja säästä aikaa.
Sisällysluettelo
Vie valmistajat nykyiseksi CSV-pohjaksi
AI Commerce -valmistajat viedään Tietojenvaihto-näkymän Valmistajien vienti -profiililla. Vienti tuottaa UTF-8-koodatun manufacturers.csv-tiedoston, jonka erotin on pilkku. Tee vienti aina juuri ennen massamuokkausta, jotta otsakkeet, kielisarakkeet ja valmistajien nykyiset arvot vastaavat tuontiprosessorin sopimusta.
Vienti sisältää valmistajan koodin, nimen, käyttötilan, etusivunäkyvyyden, CMS-kuvauksen valinnan, sovitusarvon, järjestyksen, tuotekuvausautomaation sallitut verkkotunnukset, kolme kuvatiedostonimeä, luonti- ja muokkausajan sekä jokaisen datakielen yläkuvauksen ja varsinaisen kuvauksen. Vienti ei sisällä manufacturers_id- tai delete-saraketta, vaikka tuonti hyväksyy ne valinnaisina otsakkeina.
Valmistaja-CSV:n sarakkeet
AI Commerce -valmistajien CSV käyttää seuraavia perussarakkeita tässä järjestyksessä:
manufacturers_code,manufacturers_name,status,display_frontpage,cms_description,fit_value,sort_order,openai_product_description_allowed_domains,manufacturers_image,manufacturers_brand_page_image,manufacturers_listing_image,date_added,last_modified
Kielikohtaiset sarakkeet lisätään jokaiselle saatavilla olevalle datakielelle pareina manufacturers_description_top[fi] ja manufacturers_description[fi]. Tuonti hyväksyy lisäksi valinnaiset manufacturers_id- ja delete-otsakkeet. country_approved_product ei kuulu nykyisen valmistajatuonnin sallittuihin sarakkeisiin, joten maa- tai ISO-2-arvoja ei pidä lisätä tähän tiedostoon.
date_added ja last_modified tulevat vientiin tiedoksi, mutta nykyinen tuontiprosessori ei käytä niitä valmistajan luonti- tai päivityspyynnön muodostamiseen. Älä yritä muuttaa aikaleimoja CSV:llä.
Tunnisteet, käyttötila ja muut arvot
AI Commerce -valmistaja-CSV:n tunnisteet, käyttötila ja muut arvot käsitellään tarkkojen sarakesääntöjen mukaan. Valmistajatuonti tarvitsee otsakkeeksi vähintään manufacturers_code- tai manufacturers_id-sarakkeen. Prosessori etsii olemassa olevan valmistajan ensin annetulla positiivisella ID:llä ja sen jälkeen valmistajan koodilla. Jos samalla rivillä on ID ja koodi, niiden pitää kuulua samalle valmistajalle.
Uusi valmistaja tarvitsee sekä ei-tyhjän manufacturers_code- että manufacturers_name-arvon. CSV-tuonti ei muodosta puuttuvaa koodia nimestä. Päivityksessä mukana oleva kenttä korvaa nykyisen arvon, kun taas kokonaan puuttuva sarake säilyttää nykyarvon.
Boolean-kentät status, display_frontpage ja cms_description hyväksyvät käytössä olevalle arvolle 1 tai true ja ei käytössä olevalle arvolle 0, false tai tyhjän solun. Muu arvo on virhe. sort_order hyväksyy kokonaisluvun. fit_value ja openai_product_description_allowed_domains käsitellään tekstinä.
Kuvatiedostonimet eivät lataa etäkuvia
AI Commerce -valmistaja-CSV:n kuvatiedostonimet eivät lataa etäkuvia. Kuvasarakkeet ovat manufacturers_image, manufacturers_brand_page_image ja manufacturers_listing_image, ja ne sisältävät tiedostonimiä, eivät URL-osoitteita. Arvo ei saa sisältää kauttaviivaa, kenoviivaa, ..-osaa tai nollamerkkiä, ja kentillä on omat enimmäispituutensa.
Päivityksessä kokonaan puuttuva kuvasarake säilyttää nykyisen kuvan. Mukana oleva tyhjä kuvasolu asettaa kuvatiedostonimen tyhjäksi. DELETE ei ole kuville varattu poistokomento, vaan se käsiteltäisiin tavallisena tiedostonimenä. https://-osoite hylätään kauttaviivojen vuoksi, eikä valmistajatuonti lataa kuvaa mediakirjastoon. Lataa ja hyväksy kuvat erillisessä mediaprosessissa ja käytä CSV:ssä vain hyväksyttyä tiedostonimeä.
Kielikohtaisten kuvausten päivitys
AI Commerce -valmistaja-CSV:n kielikohtaisten kuvausten päivitys käsittelee jokaiselle datakielelle yläkuvauksen manufacturers_description_top[<kieli>] ja varsinaisen kuvauksen manufacturers_description[<kieli>]. Esimerkiksi suomen sarakkeet ovat manufacturers_description_top[fi] ja manufacturers_description[fi].
Kun kielisarake puuttuu tiedostosta kokonaan, olemassa oleva kuvaus säilyy. Kun sarake on mukana mutta solu on tyhjä, kyseisen kielen arvo päivitetään tyhjäksi. Uudelle valmistajalle puuttuvat tai tyhjät kuvaukset tallentuvat tyhjinä. Pidä siis vain tarkoituksella muokattavat kielisarakkeet mukana, jos et käytä tuoretta vientiä kokonaisena pohjana.
Luo, päivitä tai poista valmistaja
AI Commerce -valmistaja-CSV:llä voi luoda, päivittää tai poistaa valmistajan. Tuonti luo uuden valmistajan, kun annettu koodi tai ID ei löydä olemassa olevaa riviä ja rivillä on vaaditut nimi sekä koodi. Olemassa oleva valmistaja päivitetään ID:n tai täsmälleen saman koodin perusteella. Jos päivitysrivi ei muuta mitään arvoa, esikatselu luokittelee sen ohitettavaksi.
Valmistaja poistetaan lisäämällä delete-sarake ja kirjoittamalla siihen täsmälleen CONFIRM. Poisto vaatii olemassa olevan valmistajan ID:n tai koodin. CSV-poisto irrottaa tuotteet valmistajasta eikä poista tuotteita. Tyhjä delete tarkoittaa luontia tai päivitystä, ja mikä tahansa muu ei-tyhjä poistomerkintä on virhe.
manufacturers_code,manufacturers_name,status,sort_order,delete,manufacturers_description[fi]
acme,Acme,1,10,,Acme-valmistajan kuvaus
old-brand,Vanha valmistaja,0,0,CONFIRM,
Esikatsele ja suorita valmistajatuonti
AI Commerce -valmistajat tuodaan Tietojenvaihto-näkymän Valmistajien tuonti -profiililla. Käytä .csv-tiedostoa UTF-8-muodossa ja pilkulla eroteltuna. Otsikoiden järjestys voi poiketa viennistä, mutta otsikoiden pitää olla yksilöllisiä, sallittuja ja sisältää manufacturers_code tai manufacturers_id. Tuntematon tai kahteen kertaan esiintyvä otsake pysäyttää esikatselun.
Lataa tiedosto ja tarkista esikatselusta jokaisen rivin luokitus, muutokset ja virheet. Esikatselu laskee luotavat, päivitettävät, ohitettavat ja virheelliset rivit. Korjaa kaikki virheet ennen vahvistettua suoritusta. Suoritusraportti erottaa luodut, päivitetyt, poistetut, ohitetut ja epäonnistuneet rivit.
Testaa pienellä erällä ja tarkista tulos
AI Commerce -valmistaja-CSV testataan pienellä erällä ennen laajaa tuontia. Aloita valmistajien massamuokkaus 1–5 rivin otoksella. Säilytä alkuperäinen vienti palautuspisteenä, muuta vain tarkoitettuja kenttiä ja pidä koodit sekä kielisarakkeet tarkasti oikeassa muodossa. Taulukkolaskentaohjelmassa käytettävän erottimen pitää olla pilkku, ei vanhan ohjeen puolipiste.
Suorituksen jälkeen tarkista valmistajan nimi, koodi, käyttötila, järjestys, kuvatiedostonimet ja kielikuvaukset sekä mahdollinen vaikutus storefrontiin. Poiston jälkeen varmista, että tuotteet säilyivät ja vain valmistajaliitos poistui. Säilytä esikatselu- ja suoritusraportit hyväksytyn auditointi- ja palautuskäytännön mukaisesti.