Prehľad

Automatické importy vám umožňujú naplánovať pravidelné načítavanie dát z externých zdrojov (URL adries) pomocou definovaných šablón mapovania a konfiguračných pravidiel. Táto príručka popisuje kľúčové pracovné postupy pre vytváranie a správu týchto importov.

Navigácia

• Automatické importy: [navigate:/automaticImports|Automatické importy|upload]
• Šablóny importu: [navigate:/importTemplates|Šablóny importu|file-text]

1. Vytvorenie základného URL importu

Vytvorte automatický import, ktorý načíta dáta z URL adresy a importuje ich pomocou šablóny.

Vstupný bod: [navigate:/automaticImports|Automatické importy|upload] -> tlačidlo Vytvoriť -> Editor automatického importu

1. Kliknite na tlačidlo **Vytvoriť** na paneli s nástrojmi.
2. V **Editore automatického importu** zadajte popisný názov do poľa `Názov`.
3. Zadajte URL adresu zdroja dát do poľa `Url`.
4. Vyberte šablónu mapovania v poli `Šablóna importu`.
5. Vyberte `hodinový`, `denný`, `týždenný` alebo `mesačný` v rozbaľovacom zozname `Frekvencia`.
6. Kliknite na **Uložiť** pre vytvorenie plánu.

Mapovanie dát

2. Vytvorenie importu s transformáciami mapovania

Nakonfigurujte šablónu importu na transformáciu zdrojových dát pomocou výrazov.

Vstupný bod: [navigate:/importTemplates|Šablóny importu|file-text] -> Upraviť šablónu -> Mapovač

1. Otvorte **Mapovač** (zobrazený ako "Surová syntax mapovača" alebo Konfigurátor).
2. Kliknite na hodnotu cieľového poľa (napr. `description`).
3. Zadajte transformačný výraz pomocou syntaxe `${...}`.
4. Skontrolujte panel **Náhľad** (ak je k dispozícii) pre zobrazenie transformovaných hodnôt.
5. Kliknite na **Uložiť** v editore mapovača.

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

Syntax transformácie

3. Vytvorenie importu so spracovaním vnorených relácií

Importujte komplexné dátové štruktúry s vzťahmi rodič-dieťa (napr. Produkty -> Varianty).

Vstupný bod: Mapovač

1. Kliknite na tlačidlo `+` vedľa poľa relácie (napr. `variants`).
2. Kliknite na tlačidlo `+ @loop` na vnorenom riadku.
3. Zadajte JSON cestu k poľu dieťaťa v zdrojových dátach.
4. Mapujte polia v rámci vnoreného riadku relatívne k objektu dieťaťa.

**Príklad cesty:** `$.variants[*]`

Direktíva cyklu

4. Vytvorenie importu s Upsert a riešením konfliktov

Nakonfigurujte, ako sa majú existujúce záznamy spracovávať počas importu.

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

1. Otvorte **Editor automatického importu**.
2. V rozbaľovacom zozname `Operácia` vyberte požadovaný režim.
3. Uistite sa, že pole `Vyhľadávacie pole` v prepojenej šablóne importu je nastavené na jedinečný identifikátor (napr. `code`, `ean`).

Režimy operácie

5. Vytvorenie importu so skriptom následného spracovania

Spustite vlastný skript po importe na obohatenie alebo overenie dát.

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

1. Otvorte **Editor automatického importu**.
2. Nájdite pole `Importný skript` (textové pole).
3. Napíšte logiku následného spracovania v skriptovacom jazyku.
4. Uložte konfiguráciu.

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

6. Vytvorenie importu s kontrolou sady zmien

Pripravte zmeny na manuálne schválenie pred ich aplikovaním do databázy.

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

1. Začiarknite políčko `Vyžaduje sadu zmien` v **Editore automatického importu**.
2. Keď sa import spustí, vytvorí sa `Sada zmien` namiesto okamžitého použitia zmien.
3. Prejdite na [navigate:/changesets|Sady zmien|list].
4. Kliknite na novú sadu zmien pre zobrazenie detailov.
5. Skontrolujte tabuľku "Upravené entity" a štatistiky.
6. Kliknite na **Použiť** pre potvrdenie alebo **Odmietnuť** pre zrušenie.

7. Vytvorenie importu so spracovaním chýbajúcich záznamov

Nakonfigurujte správanie pre záznamy, ktoré sú prítomné v databáze, ale chýbajú v importovanom zdroji.

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

1. Otvorte **Editor automatického importu**.
2. V rozbaľovacom zozname `Spracovať chýbajúce` vyberte požadované správanie.
3. Uložte konfiguráciu.

Možnosti

8. Vytvorenie importu s agregáciou z viacerých zdrojov

Zlúčte dáta z viacerých zdrojov do jednej entity pomocou viacerých automatických importov.

1. Vytvorte automatický import pre "Zdroj A" (napr. Zdroj cien) mapujúci `code` a `price`. Nastavte operáciu na `Iba aktualizovať`.
2. Vytvorte automatický import pre "Zdroj B" (napr. Zdroj popisov) mapujúci `code` a `description`. Nastavte operáciu na `Iba aktualizovať`.
3. Nastavte prekrývajúce sa alebo sekvenčné plány pre oba importy.

Záznam produktu bude obohatený oboma zdrojmi, spárovaný pomocou poľa `code`.

9. Vytvorenie importu s premenlivou konfiguráciou

Použite premenné v šablónach mapovania, aby ste umožnili opakované použitie v rôznych importoch s rôznymi parametrami.

Vstupný bod: Mapovač

1. V **Mapovači** otvorte konfigurátor premenných (alebo upravte JSON manuálne).
2. Definujte premennú (napr. `defaultCategory`).
3. Použite premennú v hodnote poľa pomocou `${defaultCategory}`.
4. Pri vytváraní `Automatického importu` voliteľne prepíšte predvolené hodnoty premenných (ak to podporuje UI).

10. Vytvorenie importu s podmieneným vytváraním záznamov

Podmienene preskočte alebo vytvorte záznamy na základe zdrojových dát.

Vstupný bod: Mapovač

1. Vyberte mapovanie koreňovej entity alebo špecifický riadok v **Mapovači**.
2. Kliknite na tlačidlo `+ @if`.
3. Zadajte výraz podmienky.

**Príklady:** `${price > 0}` alebo `${active == 'true'}`

Ďalšie kroky

Po automatizovaní importov sa naučte migrovať existujúce dáta o produktoch.

[navigate:/help/en/user-flows/data-migration|Pokračovať na migráciu dát|upload]

Súvisiace články

• [navigate:/help/en/api/imports|Dokumentácia systému importu|upload]
• [navigate:/help/en/api/mapper|Dokumentácia mapovača|settings]
• [navigate:/help/en/changesets|Sady zmien: Bezpečné koncepty pre vaše dáta|git-branch]