Termékimportálás WooCommerce-be CSV-n vagy API-n keresztül, duplikációk nélkül

WooCommerce termékek biztonságos importja CSV-n vagy API-n keresztül: leképezés, SKU, variánsok, képek, validáció, kötegek, újrapróbálkozás és rollback.

Termékimportálás WooCommerce-be CSV-n vagy API-n keresztül, duplikációk nélkül
Rövid válasz

A termékeket stabil SKU vagy külső azonosító alapján párosítsa, határozza meg minden mező hiteles forrását, és az importot először előnézeti módban, kis mintán futtassa. Az érvénytelen sorokat különítse el egy riportba, a kötegeket idempotens módon dolgozza fel, és az éles frissítés előtt készítsen biztonsági mentést az adatbázisról és a médiafájlokról is.

A WooCommerce-be történő termékimport gyorsabban feltöltheti vagy frissítheti a katalógust, mint a kézi szerkesztés, de egyetlen hibás leképezés felülírhatja az árakat, duplikált attribútumokat hozhat létre vagy leválaszthatja a változatokat. A CSV kötegelt állapotot rögzít, az API folyamatosan is továbbíthatja a változásokat. Mindkét esetben a legfontosabb a rekord stabil azonossága és annak pontos szabálya, hogy mely mezők a forrás tulajdonában vannak.

A biztonságos import megismételhető folyamat validációval, a változások előnézetével, kötegekkel, hibajelentéssel és visszaállítási lehetőséggel. Az első próba stagingre és egy kis, reprezentatív mintára való, nem a teljes éles katalógusra. A képek, taxonómiák és variánsok külön leképezést igényelnek, mert a név szöveges egyezése nem elegendő az egyértelmű összekapcsoláshoz.

Válasszon CSV-t, API-t vagy ezek kombinációját

A CSV egyszeri migrációhoz, ellenőrzött kötegelt feldolgozáshoz vagy ritkábban készülő beszállítói exporthoz alkalmas. Kézzel ellenőrizhető és archiválható, de a változások ütközését önmagában nem kezeli. Az API folyamatos adatcserét és állapotválaszokat biztosít, de hitelesítést, korlátokat, sort, monitorozást és szerződésverziót igényel. A választás a szükséges adatfrissességen és az üzemeltetési szempontokon alapul.

Gyakran a kombináció működik: az események frissítik az árat és a készletet, a rendszeres teljes export pedig ellenőrzi az eltéréseket. Határozza meg, mi történik a forrás kiesésekor, és mekkora adatkor elfogadható. A kézi feltöltés nem versenghet az automatikus szinkronizálással ugyanazért a mezőért elsőbbségi szabály nélkül.

Készítsen adattérképet és stabil identitást

Minden oszlophoz vagy API-mezőhöz rendeljen célmezőt, típust, kötelezőséget, formátumot, mértékegységet, szótárt és hiteles adatforrást. Különböztesse meg az üres értéket a törlési utasítástól. Az SKU-nak vagy a külső azonosítónak a név megváltozása után is stabilnak kell maradnia. Az azonosító duplikációját az írás előtt állítsa meg, ne két termék létrehozása után.

A változatoknak szülő-azonosítóra és saját változat-SKU-ra van szükségük. Az attribútumokat stabil slug vagy szinonimatáblázat segítségével feleltesse meg a meglévő globális termeknek, hogy az importálás ne hozzon létre külön `modrá`, `Modra` és `blue` értéket. A kategóriáknak saját leképezésük van a forráskódról a cél-taxonómiára. A szabad szöveget ne használja kritikus besorolás levezetésére ellenőrzés nélkül.

  • Stabil SKU vagy külső azonosító
  • Az üres érték egyértelmű jelentése
  • Szülőtermék és a változat azonossága
  • Taxonómiák és mértékegységek leképezése

Validálja a fájlt, és jelenítse meg a módosítások előnézetét

Importálás előtt ellenőrizze a kódolást, az elválasztót, a fejléceket, az oszlopok számát, az adattípusokat, a kötelező értékeket és az egyediséget. Árnál validálja a tizedes formátumot és a pénznemet a folyamatnak megfelelően, készletnél az egész számot vagy a támogatott értéket. Az érvénytelen sor kapjon sorszámot, mezőt és érthető hibaüzenetet anélkül, hogy leállítaná a biztonságosan független sorokat.

A dry run megmutatja az új, frissített, változatlan, deaktivált és hibás termékek számát, valamint a mezőnkénti eltérések mintáját. Így a képek vagy árak váratlan tömeges törlése még az írás előtt megállítható. A jóváhagyó megerősíti a terjedelmet, a checksummal együtt elmentett bemeneti fájl pedig később lehetővé teszi annak megmagyarázását, mi került importálásra.

Dolgozza fel a kötegeket idempotensen és biztonságosan

A nagy importot bontsa ellenőrzőponttal és időkorláttal rendelkező kötegekre. Ugyanaz a köteg megszakítás után megismételhető legyen duplikátumok vagy második kép létrehozása nélkül. Minden rekordot lehetőség szerint tranzakciósan mentsen, és rögzítse az eredményt. A külső képeket időkorláttal, engedélyezett típus- és méretkorláttal töltse le, és ellenőrizze, hogy az URL nem vezet-e a belső hálózatba.

Az importálás során vegye figyelembe a cache-t, a keresési indexet, az újraszámításokat és a webhookokat. Ne indítson költséges utólagos műveletet minden egyes mezőre, ha az biztonságosan elvégezhető a köteg után. Korlátozza a párhuzamosságot, hogy az import ne blokkolja a checkoutot. Az éles folyamatnak legyen monitoringja a sebességre, a hibákra és a várólista korára, valamint lehetősége az állapot elvesztése nélküli szüneteltetésre.

  • Kötegek ellenőrzőponttal
  • Ugyanazon bemenet biztonságos ismétlése
  • Külső médiafájlok korlátozása és validálása
  • Ellenőrzött utólagos újraszámítások

Készítse elő a visszaállítást és az utólagos ellenőrzést

Tömeges módosítás előtt készítsen visszaállítható biztonsági mentést az adatbázisról, és az importtól függően a feltöltésekről is. A visszaállítás helyreállíthatja a teljes állapotot, vagy használhatja a régi értékek naplóját, de ezt előzetesen tesztelni kell. Élő rendelések esetén az adatbázis teljes visszaállítása új tranzakciók elvesztésével járhat, ezért tervezze meg az időzítést, és különítse el a katalógusmódosításokat.

Az importálás után vesse össze a darabszámokat, egy véletlenszerű és egy kockázatos mintát, az árakat, a készletet, a változatokat, a kategóriákat, a képeket és a termék-URL-eket. Ellenőrizze a keresést, a szűrőt, a kosarat és a rendelésexportot. A hibás sorokat a forrásban javítsa, és futtassa újra az importot, ne a célt módosítsa kézzel, mert azt a következő köteg felülírja. A jelentést és a leképezést őrizze meg üzemeltetési dokumentációként.

Gyakori kérdések

Hogyan importáljunk termékeket duplikátumok létrehozása nélkül?

Használjon egyedi, stabil SKU-t vagy külső azonosítót, és minden sornál végezzen upsertet e kulcs alapján. A duplikált vagy hiányzó azonosítókat írás előtt utasítsa el. A termék neve nem megbízható azonosító.

Importálhatok képeket külső URL-ekről?

Igen, de időkorláttal, méretkorláttal, típusellenőrzéssel és a belső hálózathoz való hozzáférés elleni védelemmel. Tartsa nyilván az eredetet és a jogokat. Az ismételt import ne mentse el szükségtelenül újra ugyanazt a fájlt.

Mit jelent az import próbafuttatása (dry run)?

Ez egy írás nélküli előnézet, amely validálja a bemenetet, és megmutatja a tervezett új, módosított, változatlan és hibás rekordokat. Lehetővé teszi a hibás leképezés vagy a tömeges felülírás felismerését, mielőtt az a katalógust érintené.

Források és további olvasnivaló

Adam Antoni, digitális megoldások fejlesztője
Adam Antoni · Webiant

Adam Antoni vyvíja weby, aplikácie a softvér na mieru. Prepája firemné systémy, automatizuje procesy a vytvára AI agentov. Pôsobí v Spišskej Novej Vsi a spolupracuje s firmami na celom Slovensku.

Szeretné ezt a témát megoldani a saját projektjében?

Írja le, mit szeretne javítani, milyen nehézségekkel küzd jelenleg, és milyen eredményt vár. Az első konzultáción átbeszéljük a megfelelő terjedelmet és a további lépéseket.

Válassza ki, mely sütiket engedélyezi. Döntését bármikor módosíthatja a lábléc hivatkozásán vagy a sütik gombon keresztül.

Adatvédelem és a cookie-k részletei