Instalacja

Aby zainstalować aplikacje musimy utworzyć wcześniej segment.
Instrukcja opisująca tworzenie segmentu -
https://userguide.ergonode.com/product-segmentation

Po lewej stronie wybierz zakładkę aplikacje, a następnie wybierz aplikacje
B2BOne i naciśnij zainstaluj

1. Po lewej stronie wybierz zakładkę aplikacje, a następnie wybierz aplikacje
B2BOne i naciśnij zainstaluj

2. W zakładce Opcje uzupełnij nazwę aplikacji (pojawi się ona w zainstalowanych
aplikacjach) oraz wybierz Segment

3. W zakładce konfiguracja wpisz:
a. token - API key
b. url ( w przypadku środowiska produkcyjnego - https://apiprod.onecommerce.shop/, w przypadku przedprodukcyjnego - https://apipreprod.one.unity.pl/
c. nazwę tenanta
d. wybierz domyślny język

4. Zapisz konfigurację (mapowanie atrybutów oraz atrybutów kategorii
przeprowadza się po ich wcześniejszym utworzeniu) - Kliknij tutaj i dowiedź się
jak zmapować produkty i kategorie

Atrybuty

Atrybuty w Ergonode to są pola w które będziemy mogli wstawić odpowiednią
wartość. Zbiór atrybutów tworzy opis produktu. Nazwa atrybutu jest brana z
tłumaczenia danego atrybutu i wyświetlana na ONe.

• Instrukcja jak utworzyć atrybuty - https://userguide.ergonode.com/workingwith-attributes#creating-an-attribute
• Przydatne do zarządzania atrybutami są grupy produktów -
  https://userguide.ergonode.com/using-attribute-groups#creating-a-group

Szablon produktowy

Szablon produktowy jest niezbędny do utworzenia produktów.
Instrukcja jak utworzyć szablon produktu
https://userguide.ergonode.com/discover-the-power-of-productdesigner#template-designer-tab
Przydatne do tworzenia szablonów jest utworzenie sekcji oraz zestawów
kompletności - https://userguide.ergonode.com/sections-and-completeness-sets

Kategorie

W celu utworzenia kategorii, które wyświetlą się na platformie ONe należy:
1. Utworzyć kategorie - https://userguide.ergonode.com/create-the-categories

⚠ Warto przed utworzeniem kategorii, utworzyć atrybuty kategorii, które
można wykorzystać przy tworzeniu kategorii. Instrukcja jak utworzyć
atrybuty kategorii - https://userguide.ergonode.com/category-attributes

2. Utworzyć drzewo kategorii - https://userguide.ergonode.com/multi-catalogs-withtree-designer

Na B2B ONe są widoczne tylko te kategorie, do których są przypisane produkty.
Puste kategorie nie są wyświetlane.

Produkt

⚠ W celu utworzenia produktu, należy najpierw utworzyć
- atrybuty
- kategorie oraz ich drzewo,
- szablon produktowy

Instrukcja jak utworzyć produkt prosty - https://userguide.ergonode.com/three-typesof-products

⚠ Jeśli produkt ma być widoczny na platformie ONe, należy ustawić na nim
etykietę, która definiuje widoczność produktu na platformie np.
eCommerce, B2B czy Public.
Brak etykiety spowoduje, że produkt widoczny będzie tylko w Backoffice

Instrukcja jak edytować produkty w katalogu -
https://userguide.ergonode.com/bulk-actions-edit-products-in-product-catalog
Instrukcja jak usuwać produkty w katalogu -
https://userguide.ergonode.com/bulk-actions-delete-option-in-product-catalog
Instrukcja jak edytować kategorie w katalogu -
https://userguide.ergonode.com/bulk-actions-delete-option-in-product-catalog-1

Warianty produktowe

Platforma ONe umożliwia tworzenie produktów wariantowych (przykład na
poniższym zdjęciu)

Aby dodać warianty do produktów należy:
1. Utworzyć produkt wariantowy - https://userguide.ergonode.com/creatingproducts-with-variants
2. Powiązać produkty po atrybucie (jak w powyższej instrukcji)
Warianty wyświetlą się na produktach wskazanych w produkcie wariantowym,
natomiast produkt wariantowy nie wyświetli się na platformie ONe. Służy on tylko
do tworzenia wariantów, jednak należy pamiętać 

Relacje produktowe

Na platformie ONe można wyświetlić relacje produktowe, które są podzielone na
następujące typy:
akcesoria
produkty podobne
inne

W celu zaprezentowania relacji produktowych dla danego produktu należy:
Utworzyć atrybut typu relacje produktowe
dodać atrybut do szablonu
Po wejściu w produkt nacisnąć w przycisk “dodaj relacje”

Pozostałe

Linki do przydatnych funkcji na Ergonode ułatwiających korzystanie z tego narzędzia

Wyświetlanie produktów w katalogu - https://userguide.ergonode.com/galleryview
Ustawienie filtrów w katalogu produktów -
https://userguide.ergonode.com/boost-your-catalog-management-usingadvanced-filtering
Eksport do pliku - https://userguide.ergonode.com/configuring-csv-file-export
Import z pliku - https://userguide.ergonode.com/configuring-csv-file-import
Ustawienia workflow - https://userguide.ergonode.com/setting-up-workflows
Konfiguracja zakładki system - https://userguide.ergonode.com/globalsettings/settings-overview

Mapowanie

Mapowanie atrybutów oraz atrybutów kategorii jest to powiązanie atrybutu
utworzonego w Ergonode z danymi występującymi na platformie ONe.

W celu zmapowania produktów przejdź do zakładki aplikacje i wybierz
zainstalowaną aplikacje. Następnie przejdź do zakładki konfiguracje. Na dole strony
znajdują się przyciski do zmapowania atrybutów oraz atrybutów kategorii.

Zarówno w mapowaniu atrybutów jak i mapowania atrybutów kategorii obszar
wygląda identycznie. Po lewej stronie znajdują się utworzone atrybuty utworzone w
Ergonode. Po prawej jest miejsce na atrybuty utworzone w Ergonode oraz znajdują
się atrybuty zaimportowe z systemu ONe

Zasada mapowania jest następująca z lewej strony (Atrybuty Ergonode)
przeciągamy atrybuty do prawej w kolumne Atrybuty Ergonode. Aby zmapować
dany atrybut musi mieć on ten sam typ co atrybut systemowy ONe.

Mapowanie atrybutów

Mapowanie atrybutów jest to powiazanie atrybutów utworzonych dla produtku z
danymi możliwymi do przypisania na platformie ONe

Dokumentacja mapowania Ergo ↔ ONe

Mapowanie atrybutów kategorii

Mapowanie atrybutów kategorii jest to powiązanie atrybutów utworzonych dla
kategorii z danymi możliwymi do przypisania na platformie ONe. Atrybuty
kategorii są dedykowane dla SEO takich jak

• tytuł - Powinien zawierać w pierwszej kolejności słowo kluczowe, które
  najbardziej identyfikuje produkt i posiada dużą ilość odsłon w Google
• opis - W tej sekcji dostarczamy bogaty opis uzupełniony o słowa kluczowe,
  wewnętrzne linkowanie do artykułów lub bloga
• h1 - to znacznik html wykorzystywany w pozycjonowaniu najczęściej jest
  identyczny z tytułem produktu. Pamiętaj, że najważniejsze słowa kluczowe
  powinny znaleźć się na początku tytułu - w pierwszych 3/4 słowach.
• follow - w tym przypadku decydujemy czy chcemy, aby nasze strony
  produktowe były indeksowane lub czy chcemy wykorzystać linkowanie
  podczas naszego pozycjonowania.

• index - w tym przypadku decydujemy czy chcemy indeksować nasz kontent
• www attribute - Jest to zasadniczo sposób na określenie dla wszelkich botów, które mogą odwiedzić stronę, czy poniższe informacje odnoszą się do nich czy nie.

Na przykład, włączenie oznacza, że wszystkie boty powinny zwrócić uwagę na dyrektywę "noindex" 

Przesyłanie danych z Ergonode do ONe

1. Wybierz zakładkę aplikację po lewej stronie
2. Wybierz aplikacje dla której chcesz zrobić import do platformy ONe
3. Wybierz jak chcesz wykonać synchronizację:
a. Ręczna synchronizacja - wybierz przycisk synchronizuj teraz

b. Harmonogram - w tym celu przesuń switcha i ustaw jak ma wyglądać
automatyczna synchronizacja

c. W zakładce historia można śledzić postęp synchronizacji

4. Błędy w synchronizacji

cURL error 28 - oznacza brak odpowiedzi od serwerów ONe. Należy w tym
przypadku ponowić synchronizację w późniejszym czasie

Product does not have all required fields, code 1 - tutaj code 1 może mieć
wartość od 1 do 13 . Każdy z kodów mówi o tym jakiej +/- części brakuje
1 - atrybuty
2 - kategorie
3 - etykiety ( Labels )
4 - elementy z sekcji orderInformation
5 - elementy z sekcji overallInformation
6 - identyfikator produktu
7, 8 - powiązane produkty
9 - elementy z sekcji searchAttributes
10 - elementy z sekcji seoAttributes
11 , 12 , 13 - elementy z sekcji urlInformation czyli pliki i zdjęcia

Default language not set - Ten błąd wyskakuje jak nie jest ustawiony domyślny
język w konfiguracji sterownika

Problem with parsing product relations - Sterownik ma problem odczytać tabelę
relacji z produktów w ergo

Client problem - connection - Nierozpoznany błąd - sterownik zwrócił
niepoprawny kod odpowiedzi lub niepoprawną treść odpowiedzi

Driver problem - transport layer - Bliżej nie określony problem z komunikacją ze
sterownikiem