Přehled
Tento průvodce vás provede přesunem vašeho stávajícího produktového katalogu do {productName}u, ať už se nachází v jiném e-shopu, ERP systému nebo sadě tabulek. Doporučený přístup je jednoduchý: připravte soubor, jednou ho namapujte, zkontrolujte výsledek v sadě změn a teprve poté ho aplikujte. Když budete s výsledkem spokojeni, můžete stejné nastavení proměnit v plánovaný automatický import.
Než začnete
Věnujte několik minut přípravě. Ušetříte si tak spoustu práce s čištěním dat později.
- Exportujte svá data. {productName} přijímá soubory CSV, Excel a XML, nebo URL, kde je kanál publikován.
- Rozhodněte se pro jedinečný identifikátor. Každý záznam potřebuje hodnotu, která se nikdy neopakuje, například
kódproduktu neboean. Toto je vyhledávací pole, které {productName}u umožní rozpoznat záznam při dalším importu namísto vytvoření duplikátu. - Začněte s malým vzorkem. Pro první pokus zkraťte soubor na 20-50 řádků. Oprava mapování na malém souboru je mnohem rychlejší.
- Zkontrolujte svá data. Hledejte prázdné identifikátory, duplicitní kódy a ceny napsané jako text (například „1 200,-“).
**Tip:** Pokud vaše data pocházejí z dodavatelského kanálu, který se bude neustále aktualizovat, přečtěte si také [navigate:/help/en/user-flows/supplier-integration|Integrace dodavatelů|truck]. Níže uvedené kroky migrace jsou stejné, liší se pouze plán.
Krok 1: Nahrajte a namapujte svůj soubor
[navigate:/products/import|Otevřít import|upload]
1. Otevřete stránku **Import** v katalogu produktů.
2. Vyberte záložku **Vytvořit šablonu a importovat**.
3. Nahrajte svůj soubor nebo vložte URL kanálu.
4. Klikněte na **Potvrdit** a počkejte, než asistent navrhne, jak se vaše sloupce shodují s poli {productName}u.
5. Zkontrolujte navržené shody v **Mapovači importu** a opravte ty, které jsou chybné.
6. Nastavte **vyhledávací pole** na svůj jedinečný identifikátor.
**Zkontrolujte mapování:** Před importem vždy zkontrolujte navržené shody. Dvojznačné názvy sloupců, jako například „Hmotnost“ a „Přepravní hmotnost“, mohou být namapovány na špatné pole.
Asistent je podrobně popsán v [navigate:/help/en/user-flows/ai-mapping|Automatické mapování sloupců dodavatele|bot]. Pokud dáváte přednost ručnímu sestavení mapování nebo potřebujete transformace, jako je rozdělení sloupce nebo výpočet ceny, viz [navigate:/help/en/api/mapper|Dokumentace Mapovače|settings].
Vaše mapování je uloženo jako šablona importu, takže ji můžete znovu použít pro celý soubor a pro pozdější aktualizace.
[navigate:/importTemplates|Šablony importu|file-text]
Krok 2: Importujte vzorek
Stránka Import zapisuje přímo do vašeho živého katalogu, proto spusťte první import pouze s malým vzorovým souborem.
1. Klikněte na **Importovat** v **Mapovači importu**.
2. Otevřete [navigate:/products|Produkty|package] a zkontrolujte importované záznamy.
3. Porovnejte několik z nich s vaším zdrojem: názvy, ceny, sklad, obrázky a kategorie.
4. Pokud je něco špatně, opravte mapování v šabloně a importujte vzorek znovu. Díky **vyhledávacímu poli** se záznamy aktualizují namísto duplikování.
Krok 3: Importujte kompletní datovou sadu
Pro kompletní soubor máte dvě možnosti.
Možnost A: Přímý import. Zopakujte import na stránce Import s kompletním souborem. Toto je nejrychlejší způsob pro katalog, který se teprve nastavuje.
Možnost B: Import s kontrolou. Pokud je soubor dostupný na URL a váš katalog již obsahuje data, na kterých vám záleží, vytvořte [navigate:/automaticImports|Automatický import|upload], který používá vaši šablonu a povolte Vyžaduje sadu změn. Import pak vytvoří sadu změn namísto změny živých dat.
1. Otevřete [navigate:/automaticImports|Automatické importy|upload] a klikněte na **Vytvořit**.
2. Zadejte název, URL souboru a vyberte svou **šablonu importu**.
3. V rozbalovací nabídce `Operace` zvolte, jak se zachází s existujícími záznamy (viz tabulka níže).
4. Zaškrtněte **Vyžaduje sadu změn** a klikněte na **Uložit**.
5. Po spuštění importu otevřete [navigate:/changesets|Sady změn|git-branch] a klikněte na novou sadu změn.
6. Zkontrolujte počty vytvořených, aktualizovaných a smazaných záznamů a klikněte na název entity pro zobrazení upravených záznamů.
7. Klikněte na **Použít** pro aktivaci změn, nebo **Zamítnout** pro jejich zrušení a nový pokus.
| Operace | Kdy ji použít |
|---|---|
create-only |
První načtení do prázdného katalogu, nebo když nesmíte měnit existující záznamy |
create-update |
Nové záznamy jsou vytvořeny a existující jsou aktualizovány |
update-only |
Oprava nebo obohacení záznamů, které již jsou v {productName}u, bez přidávání nových |
Pokud vaše data obsahují struktury rodič-dítě, jako jsou produkty s variantami, použijte v mapovači direktivu @loop k importu podřízených řádků společně s jejich rodičem. Více o revizi a aplikaci změn se dozvíte v [navigate:/help/en/changesets|Sady změn: Bezpečné koncepty pro vaše data|git-branch].
Krok 4: Zkontrolujte výsledek
Po úplném importu:
- Hledejte prázdná povinná pole nebo chybějící vztahy. Článek [navigate:/help/en/user-flows/data-quality-management|Správa kvality dat|activity] ukazuje, jak je hromadně najít a opravit.
- Porovnejte počty záznamů se zdrojem. Rozdíl obvykle ukazuje na řádky s prázdným nebo duplicitním identifikátorem.
Krok 5: Udržujte data synchronizovaná
Pokud starý systém zůstane po nějakou dobu zdrojem pravdy, nastavte automatický import pomocí šablony, kterou jste právě vytvořili.
1. Otevřete [navigate:/automaticImports|Automatické importy|upload] a klikněte na **Vytvořit**.
2. Zadejte URL souboru a vyberte svou **Šablona importu**.
3. Zvolte frekvenci: `hourly` (hodinově), `daily` (denně), `weekly` (týdně) nebo `monthly` (měsíčně).
4. Vyberte **Operace**, obvykle `create-update`.
5. Klikněte na **Uložit**.
Možnost Handle Missing (Zpracování chybějících záznamů) rozhoduje o tom, co se stane se záznamy, které jsou v {productName}, ale již nejsou ve zdroji. Výchozí hodnota nothing (nic) je ponechá.
**Buďte opatrní s `delete`:** Volba `delete` (smazat) odstraní každý záznam, který chybí ve zdroji. Použijte ji pouze v případě, že zdroj vždy obsahuje váš kompletní katalog, a ponechte zapnutou možnost **Requires Change Set** (Vyžaduje sadu změn), abyste mohli smazání zkontrolovat, než k němu dojde.
Všechny možnosti jsou vysvětleny v [navigate:/help/en/user-flows/automatic-imports|Pracovní postupy automatického importu|refresh-cw].
Běžné problémy
| Problém | Pravděpodobná příčina a řešení |
|---|---|
| Duplicitní záznamy po druhém importu | Vyhledávací pole není nastaveno nebo je mapováno na sloupec, který není unikátní. Nastavte jej na stabilní identifikátor, jako je code nebo ean. |
| Nic nebylo aktualizováno | Operace je create-only, nebo se hodnoty identifikátorů v souboru liší od již uložených (například úvodní nuly nebo mezery navíc). |
| Ceny nebo čísla vypadají špatně | Zdroj používá jiný desetinný oddělovač nebo obsahuje text jako „EUR“. Použijte výraz mapovače k vyčištění hodnoty. |
| Související data, jako jsou kategorie, jsou prázdná | Vztah nebyl namapován, nebo související záznam nebyl nalezen s hodnotou ve vašem souboru. |
Další kroky
Nyní, když jsou vaše data v {productName}, nastavte kompletní pipeline s validací, plánováním a notifikacemi.
[navigate:/help/en/user-flows/product-catalog-sync|Pokračovat na synchronizaci katalogu produktů|refresh-ccw]
Související články
- [navigate:/help/en/user-flows/automatic-imports|Pracovní postupy automatického importu|refresh-cw]
- [navigate:/help/en/user-flows/ai-mapping|Automatické mapování sloupců dodavatele|bot]
- [navigate:/help/en/changesets|Sady změn: Bezpečné koncepty pro vaše data|git-branch]
- [navigate:/help/en/api/imports|Dokumentace importního systému|upload]