edee.oneDocs
EdeeShop · Implementace

CSV Import a export dat

Upraveno

Zdrojová data e-shopu je možné importovat a exportovat. Formát vstupních a výstupních dat je CSV, kde jako oddělovač je doporučen ; (středník).

Aktuálně je podporován import a export těchto entit:

Obecná pravidla pro import

  • Každá definice importu/exportu je identifikována systemName. Tento systémové název musí být unikátní.
  • První řádek obsahuje hlavičku importu, podle které se mapují jednotlivé sloupce v CSV na sloupce v konfiguraci (columns).
  • Každý záznam (řádek) musí obsahovat identifikátor (entityCode). Pokud identifikátor chybí, import selže.
  • Na pořadí sloupců nezáleží.
  • Pokud nějaký sloupec, který je nadefinován ale v importu chybí, data se nemění.
  • Pokud import obsahuje nějaký sloupec, který není znám (není v definici importu), tak je ignorován.
  • Pokud import obsahuje nové entity, tak je vytvoří nebo ignoruje (dle nastavení). Existující entity aktualizuje.
  • Standardní oddělovač pro více hodnot je používán znak |.

Příklad konfigurace

xml
<csvIO>    <products>        <product/>    </products>    <categories>        <category/>    </categories>    <groups>        <group/>    </groups>    <brands>        <brand/>    </brands>    <parameterTypes>        <parameterType/>    </parameterTypes>    <parameterItems>        <parameterItem/>    </parameterItems>    <localizations>        <localization/>    </localizations>    <trashEntities>        <trashEntity/>    </trashEntities>    <backup>        <backupPath>import-backups</backupPath>        <limit>3</limit>    </backup>    <delimiter>;</delimiter>    <encoding>utf-8</encoding>    <exportStoragePath>/edeeShop/export/</exportStoragePath>    <removeExportFilesOlderThenDays>/edeeShop/export/</removeExportFilesOlderThenDays>    <catalogSpecific>        <catalogCode/>        <products>            <product/>        </products>        <categories>            <category/>        </categories>        <groups>            <group/>        </groups>        <brands>            <brand/>        </brands>        <parameterTypes>            <parameterType/>        </parameterTypes>        <parameterItems>            <parameterItem/>        </parameterItems>        <localizations>            <localization/>        </localizations>        <trashEntities>            <trashEntity/>        </trashEntities>        <backup>            <backupPath>import-backups</backupPath>            <limit>3</limit>        </backup>        <delimiter>;</delimiter>        <encoding>utf-8</encoding>        <exportStoragePath>/edeeShop/export/</exportStoragePath>        <removeExportFilesOlderThenDays>/edeeShop/export/</removeExportFilesOlderThenDays>    </catalogSpecific></csvIO>

Popis

csvIO

Konfigurace importu/exportu a z/do souboru ve formátu CSV.

Vlastnosti této konfigurace lze specifikovat pro konkrétní katalog. Více zde.

VlastnostPopisHodnotaPovinnáVýchozí hodnota
products/product

Konfigurace importu a exportu produktů.

products/product

-

-

categories/category

Konfigurace importu a exportu kategorií.

categories/category

-

-

groups/group

Konfigurace importu a exportu skupin.

groups/group

-

-

brands/brand

Konfigurace importu a exportu značek.

brands/brand

-

-

parameterTypes/parameterType

Konfigurace importu a exportu typů parametrů.

parameterTypes/parameterType

-

-

parameterItems/parameterItem

Konfigurace importu a exportu hodnot parametrů.

parameterItems/parameterItem

-

-

localizations/localization

Konfigurace importu a exportu lokalizace entit.

localizations/localization

-

-

trashEntities/trashEntity

Konfigurace importu pro hromadný výmaz entit.

trashEntities/trashEntity

-

-

backup

Konfigurace zálohování importovaných souborů.

Pokud není definováno, tak se importované soubory nezálohují.

backup

-

-

delimiter

Oddělovač pro jednotlivé atributy.

char

-

;

encoding

Kódování CSV souboru exportovaných data a také výchozí kódování importních souborů (kódování se může přepsat v konkrétní definici importu).

String

-

utf-8

exportStoragePath

Cesta pro exportované soubory ve storage.

String

-

/edeeShop/export/

removeExportFilesOlderThenDays

Hodnota určuje počet dní, kdy starší exporty, než daný počet dnů, budou automaticky smazány s výsledků exportu.

TimeInterval

-

-

catalogSpecific

Vlastnosti této konfigurace lze specifikovat pro konkrétní katalog. Více zde.

-

-

backup

Konfigurace zálohování importovaných souborů.

Pokud není definováno, tak se importované soubory nezálohují.

VlastnostPopisHodnotaPovinnáVýchozí hodnota
backupPath

Cesta v interním úložišti, kam se mají zálohy ukládat.

String

-

import-backups

limit

Udává počet souborů, které se mají historicky držet.

Integer

-

3