Wprowadzenie

Sprawdź przykładowy katalog (opens in a new tab)

Skąd będą pobierane dane do katalogu?

Wszystkie dane (modele, grafiki, BOMy) są pobierane z biblioteki, na bazie której będzie wygenerowany katalog. Biblioteka ta musi mieć status AKTYWNA co jest równoznaczne z jej zamknięciem. Takiej biblioteki nie można nadpisać.

Jedynym wyjątkiem jest plik konfiguracyjny, który zawsze pobierany jest z biblioteki dev. Jeśli zostaną wprowadzone w nim zmiany, nie trzeba tworzyć nowej biblioteki. Więcej o przebudowaniu katalogu przeczytasz w sekcji Przebudowa katalogu

Adres strony katalogu

Przeczytaj jak otworzyć katalog będąc w systemie Variantic.

Adres, pod którym po utworzeniu dostępny będzie katalog produktów:

https://library.variantic.com/models/katalog_v1_w2/catalog/index.html

gdzie:

models - to nazwa instancji Variantic,
katalog_v1_w2 - to nazwa zapisanej biblioteki

Szata graficzna i zawartość stron katalogu

Szata graficzna stron katalogu może być konfigurowana w ściśle określonm zakresie. Do zmiany są następujące komponenty:

Logo,
Języki (ilość, opisy) na stronie startowej katalogu,
Opisy na banerze,
Opisy na stronie z produktami,
Ikony, nazwy oraz opisy kategorii,
Nazwę produktu, opis, tabele BOM oraz listę z udostępnionymi konfiguracjami na stronie produktu,
Możliwość złożenia zapytania ofertowego,
Grafikę, opisy oraz linki na topce strony.

Odniesienia do grafik

Logo

Odniesienie do grafiki z logo fimy musi zostać podane w sposób bezpośredni. Poniższy przykład pokazuje odniesienie do zasobu znajdującego się w Przeglądarce Plików.

example.json

"logo": "https://library.variantic.com/models/katalog_v1/assets/1fbxxx7e-39fe-xxxx-xxxx-35eccxxxxc29",

gdzie:

models - to nazwa instancji Variantic,
katalog_v1 - to nazwa zapisanej biblioteki
1fbxxx7e-xxxx-xxxx-acae-35eccxxxxc29 - to ID grafiki

Ikony, grafiki produktu

Poniższe sposoby mogą być wykorzystane do pozostałych plików graficznych znajdujących się w Przeglądace Plików w Variantic.

Z wykorzystaniem URL do grafiki

Do wskazania zasobu wykorzystana jest właściwość image.url

example.json

"products":
[
	{
		"id": 2,
		"name": "product_2_name",
          "image": {
                  "url": "https://library.variantic.com/models/katalog_v1/assets/3Acxxx7e-xxxx-xxxx-acae-3Reccxxxxc58"
                },
		"bagdes": []
	}
]

gdzie:

models - to nazwa instancji Variantic,
katalog_v1 - to nazwa zapisanej biblioteki
3Acxxx7e-xxxx-xxxx-acae-3Reccxxxxc58 - to ID grafiki

Z wykorzystaniem ID grafiki

W tym przypadku zamiast image.url należy wykorzystać image.id. W poniższym przykładzie wykorzystany został fragment pliku konfiguracyjnego definiujący kategorię.

example.json

{
  "name": "category_2_name",
  "description": "category_2_description",
  "image": {
    "id": "f8xxxxx4-x2x5-xx2f-9xxd-6x21xxx4xxx9"
  },
  "products": [
    {
      "id": 2,
      "name": "product_2_name",
      "image": {
        "id": "3Acxxx7e-xxxx-xxxx-acae-3Reccxxxxc58"
      },
      "bagdes": []
    }
  ]
}

Z wykorzystaniem ścieżki do pliku

W tym przypadku definiując grafikę zamiast image.id należy wykorzystać image.absolutePath. W poniższym przykładzie wykorzystany został fragment pliku konfiguracyjnego definiujący zapisane konfiguracje na stronie produktu.

example.json

"configurations": [
        {
          "configurationId": "exxxxxxf-5xx4-4cxx-9xx9-fxxxxxxxxxx4",
          "name": "Default",
          "image": {
            "id": "7xxcxxxe-29xx-xx65-bxxxx-exxxxxxe1xf6"
          },
          "price": 49.27
        },
        {
          "configurationId": "3xxxx3xx5-16xx-xx44-bexx-2x17xxxx88xxax",
          "name": "Config 2",
          "image": {
            "absolutePath": "2025/katalogi/img/conf_2.png"
          },
          "price": 16.7
        }
      ]

Uruchomienie katalogu