Přeskočit na hlavní obsah

Pokročilý import

Administrátorské funkce pro import velkých objemů dat, pokročilé mapování a správu importních procesů.

Přístupová práva​

Import je přístupný pouze administrátorům. Přístup pro běžné uživatele lze udělit přes ACL (Access Control List).

Nastavení ACL pro import​

  • Přejděte do Administrace → Role
  • Vyberte roli uživatele
  • Povolte práva pro Import

Pokročilé možnosti importu​

Režim nečinnosti (Idle Mode)​

Pro velké importy (tisíce až statisíce řádků):

  • Zaškrtněte "Spustit v režimu nečinnosti"
  • Import se zpracuje na pozadí přes cron
  • Nedojde k timeout při dlouhém zpracování
  • Systém zůstává responzivní

Kdy použít:

  • Více než 10 000 záznamů
  • Komplexní data s mnoha poli
  • Import během pracovní doby

Detekce duplikátů​

Přeskočení detekce duplikátů:

  • Zaškrtněte "Přeskočit detekci duplikátů"
  • Rychlejší zpracování
  • Použít, pokud víte, že data jsou unikátní

Pole pro identifikaci duplikátů:

  • E-mail (kontakty)
  • IČ (organizace)
  • Vlastní kombinace polí
  • Systémové ID

Tichý režim (Silent Mode)​

"Tichý režim" přeskakuje:

  • Workflow pravidla
  • Automatické akce
  • E-mailové notifikace
  • Scripty a hooks
  • Validační pravidla (kromě povinných polí)

Použití:

  • Migrace dat z jiného systému
  • Hromadné opravy dat
  • Testovací importy
  • Výkonově náročné dávky

Pokročilé mapování polí​

Výchozí hodnoty​

Nastavení výchozích hodnot pro pole, která nejsou v CSV:

  • Vlastník - přiřazení všech záznamů konkrétnímu uživateli
  • Tým - přiřazení do týmu
  • Status - např. "Nový lead", "Aktivní zákazník"
  • Zdroj - označení původu dat

Transformace dat​

Automatické úpravy během importu:

  • Formátování telefonních čísel
  • Konverze datumů
  • Normalizace e-mailů
  • Trimování mezer

Relační pole​

Import propojených záznamů:

  • Kontakt → Organizace - propojení podle názvu nebo IČ
  • Příležitost → Kontakt - podle e-mailu
  • Vlastní vztahy - podle libovolného pole

Příklad CSV s relacemi:

Jméno;Příjmení;Email;Organizace
Jan;Novák;jan@firma.cz;ABC s.r.o.

Systém najde organizaci "ABC s.r.o." a propojí kontakt.

Správa po importu​

Protokol importu​

Podrobný záznam všech operací:

  • Čas spuštění/dokončení
  • Počet vytvořených/aktualizovaných záznamů
  • Seznam chyb a varování
  • Změněná pole u každého záznamu

Akce s protokolem:

  • Zobrazit - prohlédnout detaily
  • Stáhnout - export do CSV
  • Odstranit - smazat protokol

Vrácení importu (Rollback)​

Kompletní zrušení provedeného importu:

  • Otevřete protokol importu
  • Klikněte na "Vrátit import"
  • Všechny vytvořené záznamy budou smazány
  • Aktualizované záznamy vráceny na původní hodnoty

Upozornění: Vrátit lze pouze importy provedené s povolením "Zaznamenat změny"

Odstranění duplikátů​

Po importu můžete:

  • Vyhledat duplicitní záznamy
  • Sloučit duplikáty
  • Smazat duplicity

Detekce duplikátů:

  • Stejný e-mail
  • Stejné jméno + příjmení
  • Stejné IČ (organizace)
  • Vlastní pravidla

Hromadný import přes API​

REST API import​

curl -X POST https://autocrm.example.com/api/v1/Import \
 -H "X-Api-Key: your-api-key" \
 -H "Content-Type: application/json" \
 -d '{
 "entityType": "Contact",
 "action": "createAndUpdate",
 "params": {
 "silentMode": true,
 "idleMode": true
 },
 "data": [
 {"firstName": "Jan", "lastName": "Novák", "email": "jan@email.cz"},
 {"firstName": "Marie", "lastName": "Svobodová", "email": "marie@email.cz"}
 ]
 }'

Automatizované importy​

Pravidelný import přes cron:

# Každý den v 2:00 import z FTP
0 2 * * * /usr/bin/php /var/www/autocrm/import-script.php

Best practices​

Testovací prostředí - velké importy vždy nejprv otestovat

Záloha - před importem provést backup databáze

Validace dat - zkontrolovat data před importem

Logování - vždy povolit zaznamenávání změn

Monitoring - sledovat průběh velkých importů

Dokumentace - poznamenat si nastavení a mapování polí

Řešení problémů​

Import trvá příliš dlouho​

  • Použít režim nečinnosti
  • Zapnout tichý režim
  • Rozdělit na menší dávky

Chyby při importu​

  • Zkontrolovat formát CSV (UTF-8)
  • Ověřit povinná pole
  • Zkontrolovat datové typy
  • Podívat se do protokolu importu

Chybí relace​

  • Ověřit, že cílové záznamy existují
  • Zkontrolovat mapování relačních polí
  • Použít systémová ID místo názvů

Výkonové problémy​

  • Vypnout detekci duplikátů
  • Zapnout tichý režim
  • Importovat mimo pracovní dobu
  • Zvýšit PHP memory limit