Prehľad
Tento sprievodca vás prevedie presunom vášho existujúceho katalógu produktov do {productName}, či už sa nachádza v inom e-shope, systéme ERP alebo v súbore tabuliek. Odporúčaný prístup je jednoduchý: pripravte súbor, raz ho namapujte, skontrolujte výsledok v sade zmien a až potom ho použite. Keď budete s výsledkom spokojní, môžete rovnaké nastavenie premeniť na naplánovaný automatický import.
Predtým, ako začnete
Venujte pár minút príprave. Ušetrí to veľa práce s čistením neskôr.
- Exportujte svoje dáta. {productName} akceptuje súbory CSV, Excel a XML, alebo URL, kde je kanál publikovaný.
- Rozhodnite sa pre jedinečný identifikátor. Každý záznam potrebuje hodnotu, ktorá sa nikdy neopakuje, napríklad
kódproduktu aleboean. Toto je Vyhľadávacie pole, ktoré umožňuje {productName} rozpoznať záznam pri ďalšom importe namiesto vytvorenia duplikátu. - Začnite s malou vzorkou. Zmenšite svoj súbor na 20-50 riadkov pre prvý pokus. Oprava mapovania na malom súbore je oveľa rýchlejšia.
- Skontrolujte svoje dáta. Hľadajte prázdne identifikátory, duplicitné kódy a ceny napísané ako text (napríklad “1 200,-”).
**Tip:** Ak vaše dáta pochádzajú z dodávateľského kanála, ktorý sa bude neustále aktualizovať, prečítajte si aj [navigate:/help/en/user-flows/supplier-integration|Pipeline integrácie dodávateľa|truck]. Kroky migrácie nižšie sú rovnaké, líši sa len plán.
Krok 1: Nahrajte a namapujte svoj súbor
[navigate:/products/import|Otvoriť import|upload]
1. Otvorte stránku **Import** v katalógu produktov.
2. Vyberte kartu **Vytvoriť šablónu a importovať**.
3. Nahrajte svoj súbor alebo vložte URL kanála.
4. Kliknite na **Potvrdiť** a počkajte, kým asistent navrhne, ako sa vaše stĺpce zhodujú s poliami {productName}.
5. Skontrolujte navrhované zhody v **Mapovači importu** a opravte všetky nesprávne.
6. Nastavte **Vyhľadávacie pole** na váš jedinečný identifikátor.
**Skontrolujte mapovanie:** Vždy skontrolujte navrhované zhody pred importom. Dvojzmyselné názvy stĺpcov, ako napríklad "Hmotnosť" a "Prepravná hmotnosť", môžu byť priradené k nesprávnemu poľu.
Asistent je podrobne popísaný v [navigate:/help/en/user-flows/ai-mapping|Automaticky mapovať stĺpce dodávateľa|bot]. Ak uprednostňujete ručné vytváranie mapovania alebo potrebujete transformácie, ako je rozdelenie stĺpca alebo výpočet ceny, pozrite si [navigate:/help/en/api/mapper|Dokumentácia Mapovača|settings].
Vaše mapovanie je uložené ako Šablóna importu, takže ho môžete opätovne použiť pre celý súbor a pre neskoršie aktualizácie.
[navigate:/importTemplates|Šablóny importu|file-text]
Krok 2: Importujte vzorku
Stránka Import zapisuje priamo do vášho živého katalógu, takže prvý import spustite iba s malým vzorovým súborom.
1. Kliknite na **Importovať** v **Mapovači importu**.
2. Otvorte [navigate:/products|Produkty|package] a skontrolujte importované záznamy.
3. Porovnajte niekoľko z nich s vaším zdrojom: názvy, ceny, sklad, obrázky a kategórie.
4. Ak je niečo nesprávne, opravte mapovanie v šablóne a importujte vzorku znova. Vďaka **Vyhľadávaciemu poľu** sa záznamy aktualizujú namiesto duplikovania.
Krok 3: Importujte kompletnú sadu dát
Pre kompletný súbor máte dve možnosti.
Možnosť A: Priamy import. Zopakujte import na stránke Import s kompletným súborom. Toto je najrýchlejší spôsob pre katalóg, ktorý sa ešte len nastavuje.
Možnosť B: Import s kontrolou. Ak je súbor dostupný na URL adrese a váš katalóg už obsahuje dáta, na ktorých vám záleží, vytvorte [navigate:/automaticImports|Automatický import|upload], ktorý používa vašu šablónu a povoľte Vyžaduje Sadu zmien. Import potom vytvorí sadu zmien namiesto zmeny živých dát.
1. Otvorte [navigate:/automaticImports|Automatické importy|upload] a kliknite na **Vytvoriť**.
2. Zadajte názov, URL súboru a vyberte svoju **Šablónu importu**.
3. V rozbaľovacom zozname `Operácia` vyberte, ako sa spracujú existujúce záznamy (pozrite si tabuľku nižšie).
4. Začiarknite **Vyžaduje Sadu zmien** a kliknite na **Uložiť**.
5. Keď sa import spustí, otvorte [navigate:/changesets|Sady zmien|git-branch] a kliknite na novú sadu zmien.
6. Skontrolujte počet vytvorených, aktualizovaných a odstránených záznamov a kliknite na názov entity, aby ste videli upravené záznamy.
7. Kliknite na **Použiť** pre aktiváciu zmien, alebo na **Odmietnuť** pre ich zahodenie a opätovný pokus.
| Operácia | Kedy ju použiť |
|---|---|
iba-vytvoriť |
Prvé načítanie do prázdneho katalógu, alebo keď nesmiete meniť už existujúce záznamy |
vytvoriť-aktualizovať |
Nové záznamy sa vytvoria a existujúce sa aktualizujú |
iba-aktualizovať |
Oprava alebo obohatenie záznamov, ktoré už sú v {productName}, bez pridávania nových |
Ak vaše dáta obsahujú štruktúry rodič-dieťa, ako napríklad produkty s variantmi, použite direktívu @loop v mapovači na importovanie podradených riadkov spolu s ich rodičom. Viac informácií o kontrole a aplikovaní zmien nájdete v [navigate:/help/en/changesets|Sadách zmien: Bezpečné koncepty pre vaše dáta|git-branch].
Krok 4: Skontrolujte výsledok
Po úplnom importe:
- Hľadajte prázdne povinné polia alebo chýbajúce vzťahy. Článok [navigate:/help/en/user-flows/data-quality-management|Správa kvality dát|activity] ukazuje, ako ich hromadne nájsť a opraviť.
- Porovnajte počty záznamov so zdrojom. Rozdiel zvyčajne poukazuje na riadky s prázdnym alebo duplicitným identifikátorom.
Krok 5: Udržujte dáta synchronizované
Ak starý systém zostane na nejaký čas zdrojom pravdy, nastavte automatický import pomocou šablóny, ktorú ste práve vytvorili.
1. Otvorte [navigate:/automaticImports|Automatické importy|upload] a kliknite na **Vytvoriť**.
2. Zadajte URL súboru a vyberte svoju **Šablónu importu**.
3. Zvoľte frekvenciu: `hourly` (hodinovo), `daily` (denne), `weekly` (týždenne) alebo `monthly` (mesačne).
4. Vyberte **Operáciu**, zvyčajne `create-update`.
5. Kliknite na **Uložiť**.
Možnosť Handle Missing (Spracovať chýbajúce) rozhoduje o tom, čo sa stane so záznamami, ktoré sú v {productName}, ale už nie sú vo feede. Predvolená možnosť nothing (nič) ich ponechá.
**Buďte opatrní s `delete` (vymazať):** Voľba `delete` (vymazať) odstráni každý záznam, ktorý chýba vo feede. Používajte ju len vtedy, ak feed vždy obsahuje váš kompletný katalóg, a ponechajte možnosť **Requires Change Set** (Vyžaduje Sadu zmien) povolenú, aby ste mohli skontrolovať odstránenia predtým, ako k nim dôjde.
Všetky možnosti sú vysvetlené v [navigate:/help/en/user-flows/automatic-imports|Pracovných postupoch automatického importu|refresh-cw].
Bežné problémy
| Problém | Pravdepodobná príčina a riešenie |
|---|---|
| Duplicitné záznamy po druhom importe | Pole Lookup Field (Vyhľadávacie pole) nie je nastavené alebo je namapované na stĺpec, ktorý nie je jedinečný. Nastavte ho na stabilný identifikátor, ako napríklad code alebo ean. |
| Nič nebolo aktualizované | Operácia je create-only (iba vytvoriť), alebo sa hodnoty identifikátorov v súbore líšia od už uložených (napríklad úvodné nuly alebo extra medzery). |
| Ceny alebo čísla vyzerajú nesprávne | Zdroj používa iný desatinný oddeľovač alebo obsahuje text ako „EUR“. Použite výraz mapovača na vyčistenie hodnoty. |
| Súvisiace dáta, ako napríklad kategórie, sú prázdne | Vzťah nebol namapovaný, alebo súvisiaci záznam nebolo možné nájsť s hodnotou vo vašom súbore. |
Ďalšie kroky
Teraz, keď sú vaše dáta v {productName}, nastavte kompletný pipeline s validáciou, plánovaním a notifikáciami.
[navigate:/help/en/user-flows/product-catalog-sync|Pokračovať na synchronizáciu katalógu produktov|refresh-ccw]
Súvisiace články
- [navigate:/help/en/user-flows/automatic-imports|Pracovné postupy automatického importu|refresh-cw]
- [navigate:/help/en/user-flows/ai-mapping|Automaticky mapovať stĺpce dodávateľa|bot]
- [navigate:/help/en/changesets|Sady zmien: Bezpečné koncepty pre vaše dáta|git-branch]
- [navigate:/help/en/api/imports|Dokumentácia importného systému|upload]