Přehled

Automatické importy umožňují plánovat pravidelný příjem dat z externích zdrojů (URL) pomocí definovaných šablon mapování a konfiguračních pravidel. Tato příručka popisuje klíčové pracovní postupy pro vytváření a správu těchto importů.

Navigace

• Automatické importy: [navigate:/automaticImports|Automatické importy|upload]
• Šablony importů: [navigate:/importTemplates|Šablony importů|file-text]

1. Vytvoření základního importu z URL

Vytvořte automatický import, který načítá data z URL a importuje je pomocí šablony.

Vstupní bod: [navigate:/automaticImports|Automatické importy|upload] -> tlačítko Vytvořit -> Editor automatického importu

1. Klikněte na tlačítko **Vytvořit** (`data-testid="grid-add-new"`) v panelu nástrojů.
2. V **Editoru automatického importu** zadejte popisný název do pole `Název`.
3. Zadejte URL zdroje dat do pole `Url`.
4. Vyberte šablonu mapování v poli `Šablona importu`.
5. Vyberte `hodinová`, `denní`, `týdenní` nebo `měsíční` v rozevíracím seznamu `Frekvence`.
6. Klikněte na **Uložit** pro vytvoření plánu.

Mapování dat

2. Vytvoření importu s transformacemi mapování polí

Konfigurujte šablonu importu pro transformaci zdrojových dat pomocí výrazů.

Vstupní bod: [navigate:/importTemplates|Šablony importů|file-text] -> Upravit šablonu -> Mapper

1. Otevřete **Mapper** (zobrazen jako "Raw Mapper Syntax" nebo Konfigurátor).
2. Klikněte na hodnotu cílového pole (např. `description`).
3. Zadejte transformační výraz pomocí syntaxe `${...}`.
4. Zkontrolujte panel **Náhled** (pokud je k dispozici) pro zobrazení transformovaných hodnot.
5. Klikněte na **Uložit** v editoru mapperu.

**Příklad výrazu:** `${UPPER(name)} - ${TRIM(description)}`

Syntaxe transformace

3. Vytvoření importu se zpracováním vnořených vztahů

Importujte složité datové struktury se vztahy rodič-potomek (např. Produkty -> Varianty).

Vstupní bod: Mapper

1. Klikněte na tlačítko `+` vedle pole vztahu (např. `variants`).
2. Klikněte na tlačítko `+ @loop` na vnořeném řádku.
3. Zadejte cestu JSON k poli potomků ve zdrojových datech.
4. Mapujte pole uvnitř vnořeného řádku relativně k objektu potomka.

**Příklad cesty:** `$.variants[*]`

Direktiva smyčky

4. Vytvoření importu s Upsert a řešením konfliktů

Konfigurujte, jak se stávající záznamy zpracovávají během importu.

Vstupní bod: [navigate:/automaticImports|Automatické importy|upload] -> Upravit import -> Editor automatického importu

1. Otevřete **Editor automatického importu**.
2. V rozevíracím seznamu `Operace` vyberte požadovaný režim.
3. Ujistěte se, že pole `Vyhledávací pole` v propojené šabloně importu je nastaveno na jedinečný identifikátor (např. `code`, `ean`).

Režimy operace

5. Vytvoření importu se skriptem pro následné zpracování

Spusťte vlastní skript po importu pro obohacení nebo ověření dat.

Vstupní bod: [navigate:/automaticImports|Automatické importy|upload] -> Editor automatického importu

1. Otevřete **Editor automatického importu**.
2. Najděte pole `Import Script` (textové pole).
3. Napište logiku následného zpracování ve skriptovacím jazyce.
4. Uložte konfiguraci.

update(product, { "customStatus": "imported" })

6. Vytvoření importu s kontrolou sady změn

Připravte změny pro ruční schválení před jejich aplikací do databáze.

Vstupní bod: [navigate:/automaticImports|Automatické importy|upload] -> Editor automatického importu

1. Zaškrtněte políčko `Vyžaduje sadu změn` v **Editoru automatického importu**.
2. Když se import spustí, vytvoří `ChangeSet` namísto okamžitého použití změn.
3. Přejděte na [navigate:/changesets|Sady změn|list].
4. Klikněte na novou sadu změn pro zobrazení podrobností.
5. Zkontrolujte tabulku "Upravené entity" a statistiky.
6. Klikněte na **Použít** pro potvrzení nebo **Odmítnout** pro zrušení.

7. Vytvoření importu se zpracováním chybějících záznamů

Konfigurujte chování pro záznamy, které jsou přítomny v databázi, ale chybí v importovaném zdroji.

Vstupní bod: [navigate:/automaticImports|Automatické importy|upload] -> Editor automatického importu

1. Otevřete **Editor automatického importu**.
2. V rozevíracím seznamu `Zpracovat chybějící` vyberte požadované chování.
3. Uložte konfiguraci.

Možnosti

8. Vytvoření importu s agregací z více zdrojů

Slučte data z více zdrojů do jedné entity pomocí více automatických importů.

1. Vytvořte automatický import pro "Zdroj A" (např. Zdroj cen) mapující `code` a `price`. Nastavte operaci na `Pouze aktualizovat`.
2. Vytvořte automatický import pro "Zdroj B" (např. Zdroj popisu) mapující `code` a `description`. Nastavte operaci na `Pouze aktualizovat`.
3. Nastavte překrývající se nebo sekvenční plány pro oba importy.

Záznam produktu bude obohacen oběma zdroji, spárován pomocí pole `code`.

9. Vytvoření importu s proměnnou konfigurací

Použijte proměnné v šablonách mapování, abyste umožnili opakované použití v různých importech s různými parametry.

Vstupní bod: Mapper

1. V **Mapperu** otevřete konfigurátor proměnných (nebo upravte JSON ručně).
2. Definujte proměnnou (např. `defaultCategory`).
3. Použijte proměnnou v hodnotě pole pomocí `${defaultCategory}`.
4. Při vytváření `AutomaticImport` můžete volitelně přepsat výchozí hodnoty proměnných (pokud je to podporováno uživatelským rozhraním).

10. Vytvoření importu s podmíněným vytvářením záznamů

Podmíněně přeskočte nebo vytvořte záznamy na základě zdrojových dat.

Vstupní bod: Mapper

1. Vyberte mapování kořenové entity nebo konkrétní řádek v **Mapperu**.
2. Klikněte na tlačítko `+ @if`.
3. Zadejte výraz podmínky.

**Příklady:** `${price > 0}` nebo `${active == 'true'}`

Chování

• Pokud se podmínka vyhodnotí jako false, záznam (nebo pole) se přeskočí.
• Pokud true, je zpracován.