Wprowadzenie
Ten dokument opisuje funkcjonalności zawarte w tym pakiecie narzędzi oraz instrukcje instalacji niezbędne do wdrożenia jego funkcji.
Informacje o wersji
Integracja Shopify 1.0.30 jest przeznaczona do zastosowania na BPA Platform w wersji 4.6 build 1944 lub nowszej. Komponenty mają wersję 1.0.30.0.
Nowe funkcje
W tej wersji zostały dodane następujące funkcje:
Zmiany w wersji 1.0.30
Dodano obsługę wersji API „2024-07”
Ta wersja narzędzia Shopify Integration obejmuje obsługę najnowszej przetestowanej wersji API 2024-07 w ustawieniach połączenia.
Dodano właściwość do obiektu Payments: Transaction
Do obiektu Payments: Transaction została dodana nowa właściwość adjustment_reason. Jest to nowość w wersji API 2024-07.
Dodano podobiekt „variants” do operacji typu aktualizacja dla obiektu „Products: Product”
Podobiekt variants został dodany do operacji aktualizacji produktu oraz dodawania lub aktualizacji produktu dla obiektu Products: Product. Wcześniej variants mogły być mapowane tylko w operacji dodawania produktu.
Należy zauważyć, że podczas podawania variants w operacji typu aktualizacja, wszystkie istniejące variants produktu muszą również zostać uwzględnione (poprzez podanie id lub odpowiednich pól opcji, takich jak option1, option2, które definiują wariant), aby uniknąć usunięcia istniejących variants z produktu.
Zaktualizowano treść pomocy w formularzu połączenia narzędzia Shopify Integration
Treść pomocy w formularzu połączenia narzędzia Shopify Integration została zmieniona w celu wyjaśnienia, że aby pomyślnie przetestować połączenie, aplikacji musi być przypisany co najmniej zakres read_orders.
Zmiany w wersji 1.0.29
Dodano obsługę wersji API „2024-04”
Ta wersja narzędzia Shopify Integration obejmuje obsługę najnowszej przetestowanej wersji API 2024-04 w ustawieniach połączenia.
Dodano obsługę protokołu TLS 1.3
TLS 1.3 został dodany do listy obsługiwanych protokołów przy nawiązywaniu połączenia z API Shopify.
Należy zauważyć, że TLS 1.3 nie jest obecnie obsługiwany ani włączony we wszystkich wersjach systemu operacyjnego Windows. W momencie pisania tego dokumentu jest obsługiwany jedynie w systemach Windows Server 2022 i Windows 11.
Dodano właściwość do obiektu „Orders: Transaction”
Właściwość source została dodana do operacji dodawania transakcji zamówienia. Ta opcjonalna właściwość może być użyta do ustawienia źródła transakcji, a w przypadku ustawienia na „external” może być używana do importowania transakcji gotówkowych.
Dodano właściwość do obiektu „Orders: Order”
Właściwość is_removed została dodana do podobiektu ShippingLine w obiekcie Order w wersji API 2024-04.
Może być ona używana do określenia, czy linia wysyłki została usunięta.
Zaktualizowano treść pomocy dla „Orders: Fulfillment”
Od wersji API 2024-04 Shopify zacznie weryfikować duplikaty dla właściwości fulfillment_order_id w Orders: Fulfillment. Dokumentacja pomocy dla tej właściwości została zaktualizowana, aby odzwierciedlić tę zmianę.
Zmiany w wersji 1.0.28
Dodano obsługę wersji API „2024-01”
Ta wersja narzędzia Shopify Integration obejmuje obsługę najnowszej przetestowanej wersji API 2024-01 w ustawieniach połączenia.
Rozwiązano problem z operacjami „Get” nie zwracającymi wszystkich rekordów
Operacje „Get” dla wszystkich obiektów korzystających z paginacji wcześniej nie zwracały wszystkich oczekiwanych rekordów.
Ten problem został rozwiązany i teraz wszystkie dane będą pobierane, chyba że w wywołaniu do Shopify wyraźnie zostanie określona właściwość limit.
Usunięto właściwości z obiektu „Customers: Customer”
Właściwości accepts_marketing, accepts_marketing_updated_at oraz marketing_opt_in_level w obiekcie Customers: Customer zostały wycofane w wersji API 2022-04 i nie są już dostępne w wersji API 2024-01. Zostały one usunięte z tej wersji API i nowszych.
Usunięto właściwości z obiektu „Orders: Draft Order”
Właściwości customer_accepts_marketing oraz customer_accepts_marketing_updated_at w obiekcie Orders: Draft Order zostały usunięte przy korzystaniu z połączenia z wersją API 2024-01 lub nowszą.
Usunięto właściwość z obiektu „Orders: Order”
Właściwość customer_accepts_marketing w obiekcie Orders: Order została usunięta przy korzystaniu z połączenia z wersją API 2024-01 lub nowszą.
Dodano nową właściwość do obiektu „Orders: Order”
Dodano nowe właściwości do obiektu „Orders: FulfillmentOrder”
Nowe właściwości include_financial_summaries oraz include_order_reference_fields zostały dodane do operacji Get Fulfillment Orders.
Kiedy include_financial_summaries jest ustawione na „true”, nowe pole financial_summaries, zawierające informacje o cenach/rabatach, zostanie dołączone do podobiektu line item.
Kiedy include_order_reference_fields jest ustawione na „true”, nowe pola channel_id, order_name oraz order_processed_at będą dostępne.
Instrukcje instalacji
Wymagane wersje platformy BPA
Do instalacji narzędzia Shopify Integration wymagana jest platforma BPA (wcześniej „TaskCentre”) w wersji 4.6 build 1944 lub wyższej.
Kroki instalacji i aktualizacji
Poniżej opisano proces instalacji narzędzia Shopify Integration:
Aby uruchomić instalator, kliknij dwukrotnie pakiet instalacyjny Shopify Integration.
Kliknij Install, aby rozpocząć proces.
Kliknij Next, aby kontynuować.
Jeśli to konieczne, zmień domyślny folder instalacyjny.
Kliknij Next, aby kontynuować.
Kliknij Install, aby rozpocząć proces instalacji.
Postęp będzie wyświetlany na ekranie. Po zakończeniu kliknij Finish, aby zakończyć instalację.
Postęp będzie wyświetlany na ekranie.
Po zakończeniu kliknij Close, aby zakończyć instalację.
Odświeżenie schematu
Jeśli zainstalowałeś zaktualizowaną wersję narzędzia Shopify Integration, która zawiera nowe obiekty i operacje, musisz odświeżyć schematy połączenia, aby te aktualizacje były dostępne dla istniejącego połączenia.
Aby to zrobić, przejdź do globalnej konfiguracji narzędzia, edytując istniejące połączenie i włączając opcję Update objects and operations (Aktualizuj obiekty i operacje). Schematy zostaną odświeżone po zapisaniu tej zmiany. Proces ten należy powtórzyć dla każdego zdefiniowanego istniejącego połączenia.
Kroki zadań zawierające te połączenia również muszą zostać odświeżone, aby uwzględnić zmiany tam, gdzie jest to możliwe.
UWAGA: Jeśli nie odświeżysz swoich połączeń, zadania będą nadal działać, ale nie będziesz mógł korzystać z zaktualizowanych schematów. Jednak krok zadania zawierający usunięty obiekt lub pole zakończy się niepowodzeniem, chyba że połączenia zostaną odświeżone.
