CSV Import a export značek

Unikátní systémový název definice importu/exportu.

Název se zobrazuje v AR.

String

✔

-

Definice sloupce, který jednoznačně identifikuje entitu. Povinná hodnota.

columns/entityCode

✔

-

Vlastnosti entity (entita musí implementovat MetadataContainerProvider)

List: columns/property

-

-

Lokalizované vlastnosti entity.

List: columns/localization

-

-

Media gallerie přiřazené k entitě

List: columns/gallery

-

-

Historické url entity.

List: columns/oldUrl

-

-

Štítky přiřazené k entitě.

Štítky lze importovat dvěmi způsoby:

1. Sloupec reprezentuje jeden štítek (viz tag) a hodnoty v jednotlivých řádcích udávají, zda daný produkt má/nemá přiřazen štítek. Výčet hodnot, které přiřadí štítek k entitě je definován v positiveValues. Ostatní hodnoty nebo prázdná hodnota, znamená, že štítek přiřazen není. Příklad:
   kódKopírovat

   1kod produktu; novinka201;ano302;ne

2. Sloupec obsahuje výčet všech štítků přiřazených k produktu. Pokud je hodnota prázdná, jsou všechny štítky odebrány. Pokud některý ze štítku není definován, je zobrazena příslušná chybová hláška. Příklad:
   csvKopírovat

   1kod produktu; štítky201;novinka|akce|doprava zdarma302;

List: columns/tag

-

-

Oddělovač hodnot v rámci jednoho sloupce.

String

-

\|

Pokud je hodnota true a entita nebyla podle entityCode nalezena, tak se vytvoří nová.

boolean

-

true

Výchozí com.fg.cps.eshop.catalogEntity.model.EdeeShopEntity#setStatus(CatalogEntityStatus) status při nové entity.

• ACTIVE - Entity is available on frontend.
• TRASHED - Entity is entirely not available on frontend.
• PRIVATE - Entity is entirely not available on frontend, but it's visible in administration.

-

ACTIVE

Výchozí viditelnost pro nově založené entity.

• INVISIBLE - Entita je dostupná pouze na konkrétní detail stránce (se znalostí URL), není vyhledatelná a není přítomná ve výpisech.

Entity is not browsable, searchable, but is still accessible on direct url (detail page).

• VISIBLE - Entita je viditelní v rozcestnících, lze vyhledat, je přístupná na detail stránce.

Entity is browsable, searchable and accessible on direct url (detail page).

-

VISIBLE

Kódování CSV souboru. Pokud není definováno, bere se globální nastavení 'csvIO/encoding'.

String

-

-

Filter, kterým lze omezit rozsah dat pro export.

String

-

-

Velikost dávky při exportu dat.

int

-

100

Slouží jako prefix pro název souboru s exportem dat. Název dále obsahuje aktuální čas ve formátu yyyyMMddHHmmss a příponu .csv.

Pokud není definován, použije se systemName hodnota.

String

-

-

Určuje, zda se formát používá pro import, export nebo obojí.

• IMPORT_EXPORT - Import i export.
• IMPORT_ONLY - Import pouze.
• EXPORT_ONLY - Export pouze.

-

IMPORT_EXPORT

Přepínač normalizace kódu.

Pokud je true (default), tak kód z importního souboru projde normalizací. Pokud je false, tak kód se nenormalizuje, ale pouze se validuje.

boolean

-

true

Property entity, podle které se bude mapovat importní data. Standardně bývá kód, ale může být například i název pokud je název v rámci dané entity unikátní.

String

-

code

Název sloupce v importu nebo exportu.

String

✔

-

Název/Názvy pro alternativní sloupec. V případě, že je standardní hodnota prázdná (tzv. hodnota ve sloupci dle title je prázdná), je možné použít hodnotu z jiných sloupců. Jiné sloupce jsou určeny tímto atributem, kde jako oddělovač pro jednotlivé sloupce je |.

String

-

-

Oddělovač hodnot pro tento sloupec. Pokud není definován použije se delimiter definovaný pro celý formát ImportEntityDefinition#getColumnValueDelimiter()

Tedy v rámci jednoho sloupce je možné použít více hodnot, které se oddělují tímto oddělovačem.

String

-

-

Pokud je importovaná hodnota prázdná, tak se doplní tato výchozí hodnota.

String

-

-

Určuje pořadí sloupců v exportu.

int

-

0

Seznam hodnot, které se mají při importu ignorovat.

String

-

-

Určuje prioritu zpracování importu atributů.

int

-

0

Režim určující, zda je možné provádět import, export nebo obojího.

• IMPORT_EXPORT - Import i export.
• IMPORT_ONLY - Import pouze.
• EXPORT_ONLY - Export pouze.

-

IMPORT_EXPORT

Určuje, že je hodnota povinná. Tedy pokud je hodnota true a importní soubor obsahuje daný sloupec, tak je nutné, aby sloupec obsahoval hodnotu. Jinak import entity selže.

boolean

-

false

Název sloupce v importu nebo exportu.

String

✔

-

Kód property z pohledu dědění alias-produktů.

Nepovinná hodnota, pokud není uvedeno, tak je použita hodnota BaseEntityProperty#getPropertyName()

String

-

-

Název/Názvy pro alternativní sloupec. V případě, že je standardní hodnota prázdná (tzv. hodnota ve sloupci dle title je prázdná), je možné použít hodnotu z jiných sloupců. Jiné sloupce jsou určeny tímto atributem, kde jako oddělovač pro jednotlivé sloupce je |.

String

-

-

Oddělovač hodnot pro tento sloupec. Pokud není definován použije se delimiter definovaný pro celý formát ImportEntityDefinition#getColumnValueDelimiter()

Tedy v rámci jednoho sloupce je možné použít více hodnot, které se oddělují tímto oddělovačem.

String

-

-

Pokud je importovaná hodnota prázdná, tak se doplní tato výchozí hodnota.

String

-

-

Určuje pořadí sloupců v exportu.

int

-

0

Seznam hodnot, které se mají při importu ignorovat.

String

-

-

Určuje prioritu zpracování v rámci importu.

int

-

1000

Režim určující, zda je možné provádět import, export nebo obojího.

• IMPORT_EXPORT - Import i export.
• IMPORT_ONLY - Import pouze.
• EXPORT_ONLY - Export pouze.

-

IMPORT_EXPORT

Název vlastnosti, která má bý importována/exportována.

String

✔

-

Určuje, že je hodnota povinná. Tedy pokud je hodnota true a importní soubor obsahuje daný sloupec, tak je nutné, aby sloupec obsahoval hodnotu. Jinak import entity selže.

boolean

-

false

Cílová entita, do které se má hodnota nastavit.

Pokud je hodnota rovna com.fg.cps.eshop.importExport.business.processor.editor.BasePropertyEditor#TARGET_ENTITY_MASTER_PRODUCT, tak se vlastnost uloží k master produktu (nastavení má smysl pouze pro varianty). V opačném případě se uloží do aktuálně importované entity.

String

-

-

Název sloupce v importu nebo exportu.

String

✔

-

Název/Názvy pro alternativní sloupec. V případě, že je standardní hodnota prázdná (tzv. hodnota ve sloupci dle title je prázdná), je možné použít hodnotu z jiných sloupců. Jiné sloupce jsou určeny tímto atributem, kde jako oddělovač pro jednotlivé sloupce je |.

String

-

-

Oddělovač hodnot pro tento sloupec. Pokud není definován použije se delimiter definovaný pro celý formát ImportEntityDefinition#getColumnValueDelimiter()

Tedy v rámci jednoho sloupce je možné použít více hodnot, které se oddělují tímto oddělovačem.

String

-

-

Pokud je importovaná hodnota prázdná, tak se doplní tato výchozí hodnota.

String

-

-

Určuje pořadí sloupců v exportu.

int

-

0

Seznam hodnot, které se mají při importu ignorovat.

String

-

-

Určuje prioritu zpracování importu atributů.

int

-

1000

Jazyk lokalizace

String

✔

-

Režim určující, zda je možné provádět import, export nebo obojího.

• IMPORT_EXPORT - Import i export.
• IMPORT_ONLY - Import pouze.
• EXPORT_ONLY - Export pouze.

-

IMPORT_EXPORT

Název vlastnosti, která má bý importována/exportována.

String

-

name

Určuje, že je hodnota povinná. Tedy pokud je hodnota true a importní soubor obsahuje daný sloupec, tak je nutné, aby sloupec obsahoval hodnotu. Jinak import entity selže.

boolean

-

false

Cílová entita, do které se má vlastnost nastavit.

Pokud je hodnota rovna rovna com.fg.cps.eshop.importExport.business.processor.editor.BasePropertyEditor#TARGET_ENTITY_MASTER_PRODUCT, tak se vlastnost uloží k master produktu (nastavení má smysl pouze pro varianty). V opačném případě se uloží do aktuálně importované entity.

String

-

-

Název sloupce v importu nebo exportu.

String

✔

-

Název/Názvy pro alternativní sloupec. V případě, že je standardní hodnota prázdná (tzv. hodnota ve sloupci dle title je prázdná), je možné použít hodnotu z jiných sloupců. Jiné sloupce jsou určeny tímto atributem, kde jako oddělovač pro jednotlivé sloupce je |.

String

-

-

Oddělovač hodnot pro tento sloupec. Pokud není definován použije se delimiter definovaný pro celý formát ImportEntityDefinition#getColumnValueDelimiter()

Tedy v rámci jednoho sloupce je možné použít více hodnot, které se oddělují tímto oddělovačem.

String

-

-

Pokud je importovaná hodnota prázdná, tak se doplní tato výchozí hodnota.

String

-

-

Určuje pořadí sloupců v exportu.

int

-

0

Kód galerie v rámci konfigurace com.fg.cps.eshop.mediaGallery.MediaGalleryFeature

String

-

-

Název sloupečku s textem k obrázku - to co se vyplňuje tady

String

-

-

Seznam hodnot, které se mají při importu ignorovat.

String

-

-

Určuje prioritu zpracování importu atributů.

int

-

0

Režim určující, zda je možné provádět import, export nebo obojího.

• IMPORT_EXPORT - Import i export.
• IMPORT_ONLY - Import pouze.
• EXPORT_ONLY - Export pouze.

-

IMPORT_EXPORT

Název sloupečku, ve kterém je určena priorita zobrazení daného media. Pokud není uvedeno je jako default 0;

String

-

-

Určuje, že je hodnota povinná. Tedy pokud je hodnota true a importní soubor obsahuje daný sloupec, tak je nutné, aby sloupec obsahoval hodnotu. Jinak import entity selže.

boolean

-

false

Cílová entita, do které se má galerie importovat.

Pokud je hodnota rovna rovna com.fg.cps.eshop.importExport.business.processor.editor.BasePropertyEditor#TARGET_ENTITY_MASTER_PRODUCT, tak se mediaGallery uloží k master produktu (nastavení má smysl pouze pro varianty). V opačném případě se uloží do aktuálně importované entity.

String

-

-

Název sloupce v importu nebo exportu.

String

✔

-

Název/Názvy pro alternativní sloupec. V případě, že je standardní hodnota prázdná (tzv. hodnota ve sloupci dle title je prázdná), je možné použít hodnotu z jiných sloupců. Jiné sloupce jsou určeny tímto atributem, kde jako oddělovač pro jednotlivé sloupce je |.

String

-

-

Oddělovač hodnot pro tento sloupec. Pokud není definován použije se delimiter definovaný pro celý formát ImportEntityDefinition#getColumnValueDelimiter()

Tedy v rámci jednoho sloupce je možné použít více hodnot, které se oddělují tímto oddělovačem.

String

-

-

Pokud je importovaná hodnota prázdná, tak se doplní tato výchozí hodnota.

String

-

-

Určuje pořadí sloupců v exportu.

int

-

0

Seznam hodnot, které se mají při importu ignorovat.

String

-

-

Určuje prioritu zpracování importu atributů.

int

-

0

Jazyk, ke kterému se url vztahuje.

String

✔

-

Režim určující, zda je možné provádět import, export nebo obojího.

• IMPORT_EXPORT - Import i export.
• IMPORT_ONLY - Import pouze.
• EXPORT_ONLY - Export pouze.

-

IMPORT_EXPORT

Určuje, že je hodnota povinná. Tedy pokud je hodnota true a importní soubor obsahuje daný sloupec, tak je nutné, aby sloupec obsahoval hodnotu. Jinak import entity selže.

boolean

-

false

Název sloupce v importu nebo exportu.

String

✔

-

Hodnoty, které určují, že štítek má být přidělen k entitě.

String

-

-

Pokud je hodnota vyplněna, tak hodnota určuje štítek (přesněji Tag#getSystemId()), který se k entitě přidělí pokud je hodnota importu odpovídá nějaké hodnotě z EntityTagAttribute#positiveValues.

Příklad:

1<tag>2        <title>Novinky</title><!-- název štítku -->3        <tag>novinka</tag><!-- systemId štítku -->4        <positiveValues><!-- hodnoty, které určují, že štítek má být přidělen k entitě -->5            <value>ano</value>6            <value>Ano</value>7        </positiveValues>8</tag>

String

-

-

Název/Názvy pro alternativní sloupec. V případě, že je standardní hodnota prázdná (tzv. hodnota ve sloupci dle title je prázdná), je možné použít hodnotu z jiných sloupců. Jiné sloupce jsou určeny tímto atributem, kde jako oddělovač pro jednotlivé sloupce je |.

String

-

-

Oddělovač hodnot pro tento sloupec. Pokud není definován použije se delimiter definovaný pro celý formát ImportEntityDefinition#getColumnValueDelimiter()

Tedy v rámci jednoho sloupce je možné použít více hodnot, které se oddělují tímto oddělovačem.

String

-

-

Pokud je importovaná hodnota prázdná, tak se doplní tato výchozí hodnota.

String

-

-

Určuje pořadí sloupců v exportu.

int

-

0

Seznam hodnot, které se mají při importu ignorovat.

String

-

-

Určuje prioritu zpracování importu atributů.

int

-

0

Režim určující, zda je možné provádět import, export nebo obojího.

• IMPORT_EXPORT - Import i export.
• IMPORT_ONLY - Import pouze.
• EXPORT_ONLY - Export pouze.

-

IMPORT_EXPORT

String

-

-

Určuje, že je hodnota povinná. Tedy pokud je hodnota true a importní soubor obsahuje daný sloupec, tak je nutné, aby sloupec obsahoval hodnotu. Jinak import entity selže.

boolean

-

false