Omnix · dokumentace · import kategorií

Import kategorií {pomocí CSV}

Dokumentace popisuje strukturu importního CSV souboru pro systém Omnix, základní pravidla importu a význam jednotlivých sloupců. Je určená pro uživatele, kteří chtějí kategorie hromadně zakládat nebo upravovat pomocí importu.

Základní {pravidla}

Jeden řádek = jeden záznam kategorie

Každý datový řádek v CSV představuje jednu kategorii nebo jednu položku, která se má pomocí importu vytvořit nebo upravit.

Párování podle code

Kategorie se při importu vyhledává a páruje podle sloupce code. Hodnota musí být v systému jedinečná a dlouhodobě konzistentní.

Povinná pole pro novou kategorii

Při založení nové kategorie je potřeba vyplnit alespoň code, section_code a name.

Prázdná hodnota maže data

Pokud je v importovaném sloupci prázdná hodnota, stávající hodnota se smaže. Výsledné chování mohou dále upravit volby nastavení importu.

Formát souboru

CSV se středníkem ; jako oddělovačem. První řádek obsahuje názvy sloupců. Soubor ukládejte v kódování UTF-8.

Zachování struktury

Doporučujeme vycházet ze vzorového souboru a zachovat názvy záhlaví i logiku opakujících se bloků.

Doporučení: Před větší úpravou vždy pracujte s kopií původního souboru. U hromadných změn je vhodné nejdřív otestovat menší vzorek dat.

Import

CSV soubor slouží k hromadnému založení nebo aktualizaci kategorií v systému Omnix. V jednom souboru je možné pracovat se základními údaji o kategorii i vazbami na další kategorie.

  1. Vycházejte ze vzorového importního CSV souboru.
  2. Zachovejte názvy sloupců a strukturu souboru.
  3. Vyplňte nebo upravte hodnoty v jednotlivých řádcích.
  4. Zkontrolujte sloupec code, podle kterého se kategorie párují.
  5. U nových kategorií doplňte alespoň code, section_code a name.
  6. Soubor uložte ve formátu CSV v kódování UTF-8 a následně proveďte import.

Opakující se bloky, například additional_content, lze v souboru použít vícekrát. Počet vyplněných bloků záleží na konkrétní kategorii.

Podívat se na video

Video se otevře na YouTube.

Definice záhlaví jednotlivých {sloupců}

V této části je uveden přehled sloupců, které se ve vzorovém importním CSV používají. Sloupce jsou rozdělené do logických bloků podle typu dat.

U opakujících se bloků označuje X pořadí dané položky. Tento princip se používá u přídavného obsahu.

Základ kategorie

Sloupec Popis
code Kód kategorie. Podle tohoto sloupce se kategorie při importu páruje.
section_code Kód sekce. Podle tohoto sloupce se kategorie zařadí do příslušné sekce stránky.
parent_code Kód nadřazené kategorii. Podle tohoto sloupce se vytváří hierarchie kategorií.
order Pořadí kategorií. Podle tohoto sloupce se řadí zobrazení kategorií.
name Název kategorie.
long_name Rozšířený název kategorie.
short_description Krátký popis kategorie.
description Podrobný popis kategorie. Ve vzorovém souboru je vedený jako HTML obsah.
state Stav kategorie. Podporované hodnoty jsou active, hidden a inactive.

SEO a identifikace

Sloupec Popis
seo_title SEO titulek kategorie.
seo_description SEO popis kategorie.
seo_url URL adresa kategorie.

Další nastavení

Sloupec Popis
category_text Text kategorie pro vyhledávač Heuréka.
category_text2 Text kategorie pro vyhledávač Zboží.
google_product_category Zařazení do kategorií Googlu dle taxonomie.
additional_content# Přídavný obsah.