Produkt

Konfigurace dostupnosti produktů.

Dostupnost produktu určuje, zda je produkt možné objednat nebo zda má být viditelný v seznamech. Objednatelnost i viditelnost může být ovlivněno skladovým množstvím.

Konfigurace dostupnosti je povinná a nemá žádné výchozí nastavení. Konfigurace se provádí v rámci konfigurace produktu.

Dále je potřeba definovat lokalizované zprávy v properties souborech, které použijí pro lidsky čitelný popis dané dostupnosti v AR.

Formát klíče je availability.[availability.code]. Příklad:

1 availability.ALWAYS_AVAILABLE=Skladem2availability.NOT_AVAILABLE=Nedostupné3availability.DEPEND_ON_STOCK=Dle stavu na skladě

availabilityConfig

✔

-

Konfigurace periodu vracení zboží produktů.

returnConfig

-

ReturnConfig(defaultPeriod=null, unit=DAY)

Konfigurace záruční doby produktů.

warrantyConfig

-

WarrantyConfig(defaultPeriod=null, unit=MONTH)

Výchozí hodnota pro maximální množství produktu, které lze vložit do košíku.

Tato hodnota se aplikuje v případě, že maxOrderValue není uvedeno přímo u produktu.

BigDecimal

-

999

Seznam obsahových bloků.

Aby byly obsahové bloky pro tento typ entit povoleny, musí být definován alespoň jeden obsahový blok.

Pokud již existuje schéma v evitaDB, zapnutí této feature vyžaduje FULL reindexaci evitaDB.

Tuto vlastnost nelze nastavit specificky pro konkrétní katalog. Více zde.

blockConfig

-

-

Definice providerů, které poskytujcí data pro jednotlivé sekce (viz ).

List: fulltextConfig/providers/provider

-

-

Seznam konfigurací fulltext sekcí. Na základě této konfigurace se následně vytváření sekce, které se registrují do fulltext modulu. Také se automaticky zaregistrují providery, poskytující data o publikovaných entitách pro potřeby fulltextu.

V případě, že je seznam prázdný, tak se entita nebude indexovat, tedy nebude vyhledatelná přes fulltext.

List: fulltextConfig/sections/section

-

-

Konfigurace médií pro daný typ entity.

Konfigurace se po inicializaci registruje do mediaGalleryFeature, odkud s ním nadále tato feature pracuje.

mediaConfig

-

-

Konfigurace štítků.

Jedná se o seznam, který primárně obsahuje systémové id kategorie štítků. V rámci entity je pak možné pracovat se štítky, které jsou zařazeny do těchto kategorií (pozor nejedná se o kategorie produktů, ale kategorie štítků).

Konfigurace dále obsahuje informaci, zda se tyto štítky mají publikovat nebo zda se mají zobrazit ve filtru produktů na FE.

tagConfig

-

-

Pravidla pro generování URL pro entity e-shopu, které mají na FE svůj vlastní detail, tedy produkty, kategorie, značky, skupiny.

Pravidla se aplikují v pořadí, ve kterém jsou definována. Url se vygeneruje pro první pravidlo, pro které je splněna podmínka a zároveň se podaří vygenerovat url.

Pokud nejsem definována žádná pravidla, tak se použije výchozí pravidlo, které obsahuje tyto 3 vzory:

• normalize(edeeShopEntity.name),
• normalize(edeeShopEntity.catalogNumber),
• edeeShopEntity.code.

Tedy nejprve se URL generuje z názvu. Pokud se to nepodaří, tak se url generuje z katalogového čísla. Poslední pokus je generování URL z kódu. Standardně se však url vygeneruje vždy z názvu.

urlConfig

-

-

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

-

-

Seznam konfigurací jednotlivých dostupností.

List: availabilities/availability

-

-

Kód defaultní dostupnosti, v případě že u produktu není dostupnost uvedena.

Povinná hodnota pro globální nastavení.

String

-

-

Kód defaultní dostupnosti masteru, v případě že nemá žádnou dostupnou variantu.

Pokud není nastaveno, pro konkrétní katalog, použije se globální nastavení defaultAvailabilityOfMaster. Pokud není uvedeno, použije se nastavení defaultAvailability.

String

-

-

Kód defaultní dostupnosti setu, v případě že nemá žádnou dostupnou položku.

Pokud není nastaveno, pro konkrétní katalog, použije se globální nastavení defaultAvailabilityOfSet. Pokud není uvedeno, použije se nastavení defaultAvailability.

String

-

-

Pokud je hodnota true, tak se produkt tváří skladem i když reálně žádné skladové množství nemá.

Hodnota true má smysl pouze v případě, že hodnota orderability je ALWAYS. V ostatních případech je tato hodnota ignorována.

Hodí se například pro produkty typy dárkové poukazy.

boolean

-

false

Unikátní kód dostupnosti, který se ukládá k produktu. Povinná hodnota.

String

-

-

Hodnota určuje, zda lze produkt objednat.

• ALWAYS - Objednávat lze vždy bez ohledu na skladové množství.
• NEVER - Produkt nelze objednat.
• UP_TO_STOCK_QUANTITY - Produkt lze objednat pouze do výše skladového množství.

-

-

Priorita zobrazení dostupnosti v administraci.

int

-

0

Priorita pro výpočet dostupnosti master produktů na základě dostupnosti variant.

Pro master bude použita dostupnost varianty s nejvyšší prioritou.

int

-

0

Priorita pro výpočet dostupnosti setů na základě dostupnosti položek setu.

Pro set bude použita dostupnost položek s nejvyšší prioritou.

int

-

0

Hodnota určuje, jaká viditelnost () se má použít pro tuto dostupnost. Pokud není uvedeno (hodnota je rovna null), tak dostupnost viditelnost produktu neovlivňuje. Jedná se o defaultní hodnotu.

Pozn.: Viditelnost ovlivní i další atributy viz .

• VISIBLE - Produkt bude viditelný na FE.
• INVISIBLE - Produkt nebude viditelný na FE.
• INVISIBLE_WHEN_OUT_OF_STOCK - Produkt nebude viditelný, pokud není skladem na FE.

-

-

Délka periody vracení zboží ve dnech

Pokud je uvedeno, tak se hodnota publikuje k produktům, která nemají definovanou vlastní periodu vracení zboží. Pokud uvedeno není (výchozí stav), tak se k produktům (které nemají definovanou vlastní periodu vracení zboží) perioda vracení zboží nepublikuje, tedy produktu nemají žádnou periodu vracení zboží.

Integer

-

-

Jednotka, ve které je vracení zboží.

V případě změny této hodnoty je nutné upravit uložené hodnoty u produktů a přepublikovat záruční dobu všech produktů.

• DAY - Dny.
• MONTH - Měsíce.
• YEAR - Roky.

-

DAY

Délka záruční doby v jednotkách určených v hodnotou unit.

Pokud je uvedeno, tak se hodnota publikuje k produktům, která nemají definovanou vlastní záruční dobu. Pokud uvedeno není (výchozí stav), tak se k produktům (které nemají definovanou vlastní záruční dobu) záruční doba nepublikuje, tedy produktu nemají žádnou záruční dobu.

Integer

-

-

Jednotka, ve které je záruční doba.

V případě změny této hodnoty je nutné upravit uložené hodnoty u produktů a přepublikovat záruční dobu všech produktů.

• DAY - Dny.
• MONTH - Měsíce.
• YEAR - Roky.

-

MONTH

Konfigurace vytváření fulltext indexu

builder

✔

-

Query ovlivňující načtení produktů, které má provider poskytnout k indexaci.

Pokud je null, pak se použije výchozí query, která vrací všechny produkty. Resp. všechny produkty, které jsou k dispozici v daném katalogu pro anonymního uživatele.

ProductQuery

-

-

Identifikace provideru pro fulltext module. Identifikátor musí být unikátní napříč všemi providery ve všech katalozích.

Dle této hodnoty se mapují providery definované v rámci sekcí v atributu providers (viz SectionConfig#getProviders()).

String

✔

-

Pokud je true, pak se do indexu budou zahrnovat pouze produkty viditelné na skladech.

V případně, že je nutné zobrazovat jen produkty, které jsou viditelné na konkrétních skladech, je nutné využít filtraci pomocí query.visibleForStockCodes.

Pokud není uvedeno nebo je false, tak se do indexu zahrnují všechny produkty.

Boolean

-

-

Seznam výrazů (SpEL), které vrací hodnoty, které se pro danou entitu zapíší do data. Výraz je definován hodnot pro klíč Tyto data jsou uložena u výsledků fulltext pro následné použití (více viz dokumentace fulltext modulu).

Ve výrazu lze přistupovat přímo k publikované entitě.

Příklady výrazu:

• 'productType' - textová hodnota pro klíč productType pod kterým bude hodnota uložena v datech.
• subType.name -
• catalogNumber -

Ve výchozím nastavení se do data ukládá id entity, pod klíčem id. Pro produkty pak dále typ produktu, kód master produktu a kód pod kterým se mají seskupovat varianty.

dataList/data

-

-

Výchozí boost dokumentů.

Výpočet boost lze projektově ovlivnit pomocí vlastní implementace . Tuto implementaci následně stačí registrovat do aplikačního kontextu.

float

-

10000.0

Kód galerie, která se použije při získávání url obrázku, které se exportuje pro každý produkt v sitemap.

String

-

-

Seznam výrazů (SpEL), které vrací hodnoty, které se pro danou entitu indexují. Podle těch hodnot fulltext vyhledává entity.

Ve výrazu lze přistupovat přímo k publikované entitě.

Příklady výrazu:

• name - zaindexuje název entity v aktuální jazyce (jazyce regionu, pro který se generuje index)
• code
• descriptionShort
• catalogNumber
• getLocalizedTextByCode("fulltextKeywords") - zaindexuje hodnotu z lokalizovaného textu s kódem fulltextKeywords

String

-

-

Seznam výrazů (SpEL), které vrací hodnoty, které se pro danou entitu indexují jako promoKeywords (více viz dokumentace fulltext modulu).

Ve výrazu lze přistupovat přímo k publikované entitě.

Příklady výrazu:

• code
• descriptionShort
• getLocalizedTextByCode("fulltextKeywords") - zaindexuje hodnotu z lokalizovaného textu s kódem fulltextKeywords

Výchozí hodnota je "getLocalizedTextByCode("fulltextKeywords")".

String

-

[getLocalizedTextByCode("fulltextKeywords")]

Fulltext ve výchozím nastavení vyhledává podle názvu dokumentů, v případě e-shopu např. podle názvu produktů. Toto chování je možné vypnout pomocí tohoto atributu, kdy pro vypnutí nastavte hodnotu na false.

Boolean

-

-

Seznam výrazů (SpEL), které vrací hodnoty, které se pro danou entitu zapíší do variables. Podle nich lze následně výsledky fulltextu filtrovat (více viz dokumentace fulltext modulu).

Ve výrazu lze přistupovat přímo k publikované entitě.

Příklady výrazu:

• productType.name - do variables se zapíše typ produktu,
• hasTag("checkTag") ? "checkTag" : null

String

-

-

kód varianty obrázku, která se použije při získávání url obrázku, které se exportuje pro každý produkt v sitemap

String

-

-

Výraz (SpEL), který vrací název data, tedy klíč pod kterým bude hodnota z výrazu dataValue uložena v datech.

String

-

-

Výraz (SpEL), který vrací hodnotu data, která se uloží pod klíčem dataName.

String

-

-

Analyzer fulltext modulu, pokud není uvedeno, tak se použije analyzer dle jazyku aktuálního regionu nebo katalogu.

Konkrétně:

• pro en universal
• pro de universal
• pro sk universal
• pro pl universal
• pro všechny ostatní czech

String

-

-

Identifikátor sekce v rámci katalogu a regionu. Musí být unikátní. Povinná hodnota. Typickým příkladem hodnoty je: products,categories.

Pozn.: Název sekce (=identifikátor) se generuje podle klíče: catalog_region_fragment, kde catalog, region a fragment jsou nahrazeny odpovídajícími hodnotami.

String

-

-

Seznam poskytovatelů (přesněji jich FulltextResourceProvider#getType()) dat pro danou sekci. Poskytovatelé jsou vyhledávány v aplikaci a musí implementovat com.fg.fulltext.provider.FulltextResourceProvider.

Povinná položka.

String

-

-

Seznam regionů, pro které se má sekce generovat. Pokud není uvedeno, generují se sekce pro všechny regiony v rámci daného katalogu.

regions/region

-

-

ID sitemap. Více zde: https://edee.dev/cs/git/fulltext/sections/sitemap-generating/microsites.md

String

-

-

Kód země (ISO 3166 - 2 znaky).

Povinná hodnota.

String

-

-

Měna regionu ( ISO 4217 - 3 znaky).

Povinná hodnota.

currency

-

-

Kód jazyka (ISO 639 - 2 znaky).

Povinná hodnota.

locale

-

-

Umožňuje povolit duplicitní hodnoty pro porovnání u intervalových hodnot parametrů. Standardně tato situace není povolena.

boolean

-

false

Konfigurace médií pro daný typ entity.

Konfigurace se po inicializaci registruje do mediaGalleryFeature, odkud s ním nadále tato feature pracuje.

mediaConfig

-

-

Konfigurace médií pro daný typ entity.

Konfigurace se po inicializaci registruje do mediaGalleryFeature, odkud s ním nadále tato feature pracuje.

mediaConfig

-

-

Typy vazeb mezi produkty.

U produktů je možné definovat mezi produkty vazby. Typickým příkladem jsou související nebo alternativní produkty.

V AR se názvy vazeb lokalizují pomocí properties, kde poslední fragment klíče relatedEntityListingMWC.relatedEntityTagSelect.title.code, kde code je kód vazby. Příklad:

1 relatedEntityListingMWC.relatedEntityTagSelect.title.relatedProduct=Související produkty2relatedEntityListingMWC.relatedEntityTagSelect.title.alternativeProduct=Podobné produkty

List: relations/relation

-

-

Jedinečný identifikátor vazby.

Identifikátor se používá pro lokalizaci, identifikaci na FE apod.

String

-

-

Maximální počet vazeb na produkty.

Integer

-

100

Kód katalogu, ze kterého je možné vybírat předlohy pro aliasy.

Např.: Pokud chci v katalogu "A" vytvořit alias produktu X z katalogu B, Musí konfigurace pro katalog "A" obsahovat hodnotu B. Tedy například:

1 <aliasConfig>2    <catalogSpecific>3    		<catalogCode>A</catalogCode>4    		 	<catalogCodeOfOrigin>B</catalogCode>5    </catalogSpecific>6</aliasConfig>

Pokud je potřeba vytvářet aliasy v rámci stejného katalogu, tak konfigurace bude obsahovat referenci na stejný katalog. Tedy například:

1 <aliasConfig>2    <catalogSpecific>3    		<catalogCode>A</catalogCode>4    		 	<catalogCodeOfOrigin>A</catalogCodeOfOrigin>5    </catalogSpecific>6</aliasConfig>

String

-

-

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

-

-

Způsob, jakým se publikují parametry k master-produktu.

Default hodnota je MasterParameterPublicationMethod.ONLY_VARIANT_PARAMETERS.

• ONLY_VARIANT_PARAMETERS - K master-produktu se vypublikují parametry, které jsou definovány přímo na masteru a také všechny variantní parametry.
• ALL_VARIANT_PARAMETERS - K master-produktu se vypublikují parametry, které jsou definováný přímo na masteru a také všechny parametry variant (variantní i nevariantní).

V případě, že existuje nějaké parametr na masteru i na variantně, tak se vezme upřednostní ten, který je na masteru.

-

ONLY_VARIANT_PARAMETERS

Konfigurace skladů.

Na základě této konfigurace se automaticky založí sklady.

Pokud není uvedeno, je automaticky vytvořen pro každý katalog jeden sklad, kde kód skladu odpovídá kódu katalogu. Takový sklad je možné v AR vymazat. Takový sklad se pak automaticky nevytváří ani neobnovuje.

List: stocks/stock

-

-

Specifikuje čas, po který jsou maximálně uchovány data o skladech na FE. Po uplynutí tohoto času jsou data označena za zastaralé a dojde k opětovnému dotazu na REST API.

Tato doba by měla být uzpůsobena danému prostředí, pro dynamický projekt s častými změnami podmínek využití skladu lze interval zmenšit.

int

-

30

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

-

-

Kód skladu.

Kód musí být unikátní v rámci katalogu.

String

-

-

Název skladu v jazyce katalogu.

Název lze následně lokalizovat v AR.

Pokud není uvedeno, použije se kód.

String

-

-

Priorita skladu, v jakém bude zboží rezervováno na jednotlivých skladech.

Čím vyšší priorita, tím dříve bude na tomto skladu zboží rezervováno.

Pozn.: V případě, že nevyhovuje tento princip rezervace dle priority, tak je toto chování možné ovlivnit pomocí vlastní implementací , případně vlastní implementací celé strategie rezervace zboží . Tato hodnota potom nemusí být brána v potaz.

Long

-

-

Zapnutí a konfigurace funkce "Uživatelé prohlížející si produkt".

currentlyViewingConfig

-

-

Počet dnů, po kterých nechat uložená data o zobrazení.

Výchozí hodnota je 29.

int

-

29

Limit velikosti fronty, která zachycuje záznamy o navštívených produktech v paměti. Fronta by se měla díky asynchronní úloze pravidelně vyprazdňovat a odkládat do databáze, ale pokud by úloha nestíhala data zpracovávat, je vhodné kvůli stabilitě aplikace (a obsazené paměti) limitovat velikost fronty. Pokud je dosaženo limitu, začnou se zahazovat nejstarší údaje.

Výchozí hodnota je 100 tisíc záznamů.

int

-

100000

Zapnutí zobrazení funkce "Naposledy zobrazené produkty".

recentlyVisitedConfig

-

-

Počet minut pro získání výsledků pro "Uživatelé prohlížející si produkt".

Výchozí hodnota je 10.

int

-

10

Zapnutí virtuálního počtu "Uživatelé prohlížející si produkt".

virtualArithmetic

-

-

Maximální očekávaný počet návštěvníků produktu.

Výchozí hodnota je 4.

int

-

4

Minimální očekávaný počet návštěvníků produktu.

Výchozí hodnota je 1.

int

-

1