Kolekcje

Kolekcja grupuje produkty, aby kupujący mogli je szybciej znaleźć — pomyśl o „Butach do biegania” lub „Letniej wyprzedaży”.
DataEase pozwala na:

Tworzenie lub zmianę nazwy setek kolekcji w jednym przesłaniu.
Dodawanie lub usuwanie produktów, reguł, źródeł i warunków masowo.
Szybką zmianę kolejności sortowania, obrazów i tekstu SEO.

Nowy model kolekcji Shopify (Admin API 2026-07). Shopify nie dzieli już kolekcji na „inteligentne” i „manualne”. Kolekcja jest budowana z jednego lub kilku źródeł (sources); każde źródło ma warunki włączenia/wykluczenia i/lub ręcznie wybrane produkty, warianty lub podkolekcje. DataEase obsługuje ten model za pomocą kolumn Sources & conditions (szczegóły poniżej). Pliki z klasycznymi kolumnami reguł i produktów nadal działają dla kolekcji, które klasyczne kolumny wciąż mogą opisać.

Przewodnik po kolekcjach Shopify guide.

2. Eksport

Wybierz CSV lub Excel.
Wybierz Kolekcję jako jednostkę.
Wybierz potrzebne pola — title, sortOrder, ruleColumn itp. Aby wyeksportować kolekcje zbudowane w nowym modelu, włącz grupę kolumn Sources & conditions.
Opcjonalnie: zaznacz Matrixify-style headers and values, aby zapisać kolumny źródeł i warunków z nagłówkami i wartościami w stylu Matrixify (na przykład Source: Type, Include, any condition) zamiast wartości API (sourceType, INCLUDE, ANY).
Uruchom zadanie i pobierz plik.

Kolekcje, których klasyczne kolumny nie potrafią opisać. Jeśli kolekcja wykorzystuje nowy model w sposób, którego klasyczne kolumny reguł nie potrafią wyrazić (na przykład kilka źródeł, wykluczenia, źródła wariantów lub warunki połączone z ręcznym wyborem), jej komórki ruleColumn/ruleRelation/ruleCondition/appliedDisjunctively pozostają puste, a dziennik eksportu pokazuje ostrzeżenie z prośbą o włączenie kolumn Sources & conditions. Gdy włączone są tylko klasyczne kolumny, taka kolekcja jest eksportowana wyłącznie jako swój wiersz główny.

Krok po kroku: Przewodnik eksportu

3. Import

Obsługiwane polecenia w command: CREATE, UPDATE, REPLACE, DELETE, IGNORE
Polecenia dla pozycji (reguły lub produkty): CREATE, MERGE, UPDATE, DELETE, IGNORE

Dla kolekcji manualnych użyj linii produktów (productId).
Dla kolekcji inteligentnych użyj linii reguł (ruleColumn / ruleCondition…).
Dla kolekcji korzystających z nowego modelu (kilka źródeł, wykluczenia, źródła wariantów, podkolekcje) użyj kolumn Sources & conditions.

Tryb jest ustalany dla każdej kolekcji osobno: jeśli jakikolwiek wiersz kolekcji wypełnia kolumnę Sources & conditions (na przykład sourceType lub conditionField), cała kolekcja jest importowana w nowym trybie, a jej wiersze productId / productHandle / productPosition tylko ustawiają pozycję sortowania — nie dodają ani nie usuwają produktów. W przeciwnym razie obowiązuje klasyczne zachowanie: wiersze produktów dodają (CREATE, MERGE), przenoszą (UPDATE) lub usuwają (DELETE) ręcznie wybrane produkty.

Klasyczne wiersze produktów w kolekcji inteligentnej. Klasyczny plik z wierszami produktów (productId + itemCommand CREATE) dla istniejącej kolekcji inteligentnej teraz dodaje te produkty jako ręczny wybór, więc kolekcja staje się mieszanką warunków i wybranych produktów. Po tym klasyczne importy reguł dla tej kolekcji (w tym zapisane zaplanowane importy) kończą się błędem “The collection uses the new collections model (MIXED_SELECTIONS_AND_CONDITIONS)”. Dla takich kolekcji użyj kolumn Sources & conditions.

Wskazówka: Tylko kolekcje z sortOrder = MANUAL pozwalają ustawić productPosition.

Pobierz przykładowy plik: Collection-import-sample.xlsx
Wypełnij wymagane pola: title i handle dla CREATE; dołącz id lub handle dla UPDATE/DELETE.
Zmapuj kolumny w DataEase, prześlij i rozpocznij import.

Pełne kroki: Przewodnik importu

4. Odniesienie do pól

Podstawowe

id — ID kolekcji. Wymagane dla UPDATE, REPLACE lub DELETE.
command — Działanie dla wiersza kolekcji: CREATE, UPDATE, REPLACE, DELETE, IGNORE.
title — Nazwa pokazywana kupującym.
handle — Przyjazny dla URL ciąg znaków. Musi być unikalny.
descriptionHtml — Opis w formacie rich-text z HTML.
templateSuffix — Alternatywny szablon Liquid (bez .liquid).
sortOrder — Domyślna kolejność produktów: ALPHA_ASC, ALPHA_DESC, CREATED, CREATED_DESC, MANUAL, MOST_RELEVANT, PRICE_ASC, PRICE_DESC. Od Admin API 2026-07 Shopify zwraca kolekcje posortowane według popularności sprzedaży jako MOST_RELEVANT, więc eksport zapisuje MOST_RELEVANT zamiast BEST_SELLING. BEST_SELLING nie jest już obsługiwane przez DataEase — używaj MOST_RELEVANT w swoich plikach.
updatedAt — Data ostatniej modyfikacji (ISO 8601). Tylko eksport.

SEO

seoTitle — Niestandardowy tag tytułu strony.
seoDescription — Niestandardowy meta-opis.

Obraz

imageUrl — URL wyróżnionego obrazu.
imageAltText — Tekst alternatywny dla obrazu.
imageHeight — Wysokość obrazu (px). Tylko eksport.
imageWidth — Szerokość obrazu (px). Tylko eksport.

Pozycja (reguła lub produkt)

itemCommand — CREATE, MERGE, UPDATE, DELETE lub IGNORE dla tej pozycji.

Pola reguł dla kolekcji inteligentnych

Te klasyczne kolumny są wypełniane przy eksporcie tylko wtedy, gdy kolekcję nadal można opisać jednym zestawem reguł; w przeciwnym razie pozostają puste (zobacz Eksport).

ruleColumn — Atrybut produktu dla reguły (np. TITLE, TAG, VENDOR).
ruleCondition — Wartość, do której porównuje reguła, jak Shoes.
ruleConditionObjectId — Dodatkowe informacje dla niektórych typów reguł (np. ID kategorii).
ruleRelation — Operator: EQUALS, CONTAINS, NOT_EQUALS itp.
appliedDisjunctively — true = pasuje do DOWOLNEJ reguły; false = pasuje do WSZYSTKICH reguł.

Pola produktów dla kolekcji manualnych

productId — ID produktu do uwzględnienia.
productPosition — Numer pozycji (działa tylko, jeśli sortOrder = MANUAL).
productTitle — Tytuł produktu. Tylko eksport.
productHandle — Handle produktu. Tylko eksport.

Publikacja

publicationScope — Kanały sprzedaży, w których kolekcja jest publikowana.

Metafields

metafields — Dodatkowe pola aplikacji. Zobacz Przewodnik po metafields.

5. Filtry

CollectionType — Smart (with conditions) lub Custom (manual only). Nowy model Shopify nie ma typu kolekcji, więc DataEase wylicza go na podstawie źródeł kolekcji: smart = co najmniej jedno źródło z warunkiem włączenia; custom = wszystko inne (tylko ręcznie wybrane produkty, podkolekcje lub brak źródeł). Ponieważ ten filtr jest stosowany po tym, jak Shopify zwróci kolekcje, liczba kolekcji w formularzu eksportu może być pokazana jako ≤ N (co najwyżej N).
Handle — Eksportuj kolekcje, w których handle zawiera wprowadzony tekst.
Id — Eksportuj pojedynczą kolekcję według id.
ProductId — Eksportuj kolekcje, które zawierają określony productId.
ProductPublicationStatus — Filtruj według statusu publikacji produktu w kolekcji.
PublishableStatus — Wybierz gotowe, zaplanowane lub nieopublikowane kolekcje.
PublishedAt — Zakres dat, kiedy kolekcja stała się widoczna.
PublishedStatus — true dla opublikowanych, false dla ukrytych.
Title — Eksportuj kolekcje, których title zawiera Twój tekst.
UpdatedAt — Filtruj według zakresu dat ostatniej aktualizacji.

Źródła i warunki

Włącz grupę kolumn Sources & conditions, aby eksportować i importować kolekcje w nowym modelu kolekcji Shopify. Jeden wiersz = jeden warunek lub jeden ręcznie wybrany element jednego źródła; kolumny źródła powtarzają się w każdym wierszu tego źródła. Podstawowe kolumny kolekcji (handle, title, …) powtarzają się jak zwykle.

Wartości są akceptowane w stylu API (INCLUDE, ALL, TAGGED_WITH, COMPARE_AT_PRICE) lub w stylu Matrixify (Include, all conditions, Includes, Compare at price), bez rozróżniania wielkości liter. Pliki wyeksportowane z arkusza Collections w Matrixify są rozpoznawane po ich nagłówkach (Source: ID, Condition: Field, …).

sourceId — ID źródła. Użyj wyeksportowanego ID, aby zmienić istniejące źródło, lub własnej etykiety (na przykład s1), aby zgrupować wiersze nowego źródła.
sourceCommand — MERGE (domyślnie) dodaje wiersze do źródła; REPLACE czyści źródło i wypełnia je z pliku; DELETE usuwa źródło.
sourceType — PRODUCTS, VARIANTS, COLLECTIONS (podkolekcje), lub APP <app id> | PRODUCTS / APP <app id> | VARIANTS dla źródła współdzielonego przez inną aplikację (tylko do odczytu przy imporcie). UNKNOWN jest tylko do eksportu.
sourceTitle — Tytuł źródła. Jeśli jest pusty przy tworzeniu źródła, DataEase generuje go z tytułu kolekcji.
sourceDescription — Opis źródła.
inclusionType — INCLUDE (domyślnie) lub EXCLUDE.
inclusionMatch — ALL lub ANY: czy produkty muszą spełniać wszystkie, czy dowolny z warunków włączenia (lub wykluczenia) źródła. Nowe źródło domyślnie ustawia ALL.
conditionCommand — MERGE (domyślnie) dodaje warunek, jeśli jeszcze nie istnieje; DELETE go usuwa. Aby zmienić wartość warunku, usuń stary warunek i dodaj nowy, albo użyj sourceCommand = REPLACE.
conditionField — TAG, TITLE, TYPE, VENDOR, STATUS, CATEGORY, CATEGORY_WITH_SUBCATEGORIES, PRICE, COMPARE_AT_PRICE, INVENTORY_STOCK, WEIGHT, VARIANT_TITLE, COLLECTION (tylko dla wykluczenia), MANUAL_SELECTION, METAFIELD: namespace.key, VARIANT_METAFIELD: namespace.key. UNKNOWN jest tylko do eksportu (warunek, którego DataEase nie może zapisać; takie wiersze są pomijane przy imporcie z ostrzeżeniem).
conditionRelation — Operator, na przykład TAGGED_WITH, EQUALS, CONTAINS, DOES_NOT_CONTAIN, GREATER_THAN, IS_SET, INCLUDES. Pozostaw puste dla MANUAL_SELECTION i COLLECTION.
conditionValue — Wartość(ci), oddzielone przecinkami (\, dla dosłownego przecinka). Ceny akceptują opcjonalną walutę (12.50 EUR, domyślnie waluta sklepu); wagi — opcjonalną jednostkę (1.5 kg, domyślnie jednostka sklepu). Dla MANUAL_SELECTION podaj jeden handle lub ID produktu na wiersz, product-handle | Variant Title dla wariantu, lub handle kolekcji w źródle COLLECTIONS. Eksport zapisuje handle, aby pliki mogły być przenoszone między sklepami.
conditionMatch — ANY (domyślnie) lub ALL dla warunku z kilkoma wartościami; przy imporcie akceptowane są też OR / AND.

W nowym trybie wiersze productId / productHandle / productPosition tylko ustawiają pozycję sortowania (dla sortOrder = MANUAL). Limity Shopify dla nowego modelu są sprawdzane przed wywołaniem importu do Shopify: do 10 źródeł na kolekcję, 60 warunków na źródło (każda wartość jest liczona osobno), 5 wykluczonych kolekcji, 10 podkolekcji i 1000 ręcznych wykluczeń.

Przykład — warunek tagu plus ręczny wybór i ręczne wykluczenie w jednym źródle:

handle,title,sourceId,sourceType,sourceTitle,inclusionType,inclusionMatch,conditionField,conditionRelation,conditionValue,conditionMatch
vegan,Vegan picks,s1,PRODUCTS,Vegan tag,INCLUDE,ANY,TAG,TAGGED_WITH,"vegan,plant-based",ANY
vegan,Vegan picks,s1,PRODUCTS,Vegan tag,INCLUDE,,MANUAL_SELECTION,,oat-milk,
vegan,Vegan picks,s1,PRODUCTS,Vegan tag,EXCLUDE,,MANUAL_SELECTION,,leather-belt,

Ponowny import tego samego pliku nie tworzy zduplikowanych źródeł ani warunków.

Potrzebujesz pomocy? Nasz zespół wsparcia odpowiada w ciągu 24 godzin.

Dodatkowe pola

Więcej kolumn obsługiwanych przez DataEase dla tej jednostki:

productsCount — Liczba produktów w kolekcji.