Import i eksport
Zestawy i skórki przenosi się między sklepami — na przykład ze sklepu testowego do produkcyjnego — jako pliki JSON. Są dwa ekrany o tej samej formie:
- Filters → Filter sets → Import and export: zestaw filtrów albo ustawienia domyślne sklepu;
- Filters → Skins → Import and export: skórka albo dostosowania skórki w kanale.
Katalogi dopasowań mają własny import i eksport węzłów i dopasowań: zobacz Katalogi dopasowań.
Import nigdy sam nie zmienia sklepu: zawsze trafia do wersji roboczej, a sklep zmienia się, gdy wersja robocza zostanie opublikowana w kreatorze albo w edytorze skórek.
Eksport
Dział zatytułowany „Eksport”Karta Export tworzy jeden plik:
| Ustawienie | Skutek |
|---|---|
| Set / Skin | Co trafia do pliku. Lista zestawów zaczyna się od ustawień domyślnych sklepu; lista skórek kończy się dostosowaniami kanałów. |
| Version | Published v…: wersja, którą pokazuje sklep. Draft: wersja robocza w obecnym stanie, z liczbą jej nieopublikowanych zmian. Wbudowana skórka nie ma wersji roboczej do eksportu. |
| Translations | Tylko zestawy: teksty w każdym języku sklepu (etykiety grup, teksty pomocy, jednostki, nazwy zakresów). |
| Settings of the sources it uses (labels, ranges, units) | Tylko zestawy: własne ustawienia źródeł też trafiają do pliku, do wglądu. |
Download JSON zapisuje plik. Jego nazwa to nazwa techniczna z wersją, na przykład outdoor-v4.json, albo outdoor-draft.json dla wersji roboczej.
Plik zestawu nie zawiera przypisań: inny sklep ma inne kategorie i kanały. Przypisz zestaw po imporcie w Where sets show. Plik skórki zawiera skórkę, na której ona stoi (po nazwie technicznej), i tylko wartości, które skórka ustawia sama.
Import JSON… otwiera import w trzech krokach: File, Check, Import.
Plik musi być plikiem JSON wyeksportowanym przez P2LabFilter, do 2 MB. Najpierw sprawdzany jest jego format i wersja, potem jego odwołania i różnice względem wersji roboczej. Krok podaje, co zawiera plik (zestaw, ustawienia domyślne sklepu, skórkę albo dostosowania, jego wersję, liczbę grup albo wartości oraz kiedy i z którego sklepu został wyeksportowany).
Plik złego rodzaju jest odrzucany: zestawy i ustawienia domyślne sklepu importuje się w Filter sets, skórki i dostosowania kanału w Skins. Plik w innej wersji formatu albo z ustawieniami, których ta wersja wtyczki nie zna, jest odrzucany z podaniem przyczyny; wyeksportuj go ponownie ze sklepu z tą samą wersją wtyczki.
Import as decyduje, dokąd trafia plik:
- New draft: nowy zestaw albo nowa skórka. Nadaj nazwę; jej Technical name wynika z nazwy i nie może być zajęta. Gdy nazwa z pliku jest już zajęta, import proponuje „… (import)”.
- Overwrite draft ’…’: wersja robocza zestawu albo skórki o nazwie technicznej z pliku zostaje zastąpiona plikiem. Opublikowana wersja zostaje w sklepie, dopóki wersja robocza nie zostanie opublikowana.
Ustawienia domyślne sklepu zawsze nadpisują wersję roboczą ustawień domyślnych sklepu. Dostosowania kanału trafiają do kanału o domenie albo nazwie z pliku; gdy takiego kanału nie ma, wybierz go w Adjustments for the channel. Kanał z dostosowaniami ma zastępowaną ich wersję roboczą; kanał bez nich dostaje je jako nową wersję roboczą.
Skórka stoi na swojej skórce nadrzędnej. Gdy skórki nadrzędnej wskazanej w pliku nie ma w tym sklepie, wybierz w Stands on, na której ma stać.
Differences wymienia każde ustawienie, które się zmienia, z jego Place, wartością In the draft now (albo In this shop) i wartością From the file. Pole wyszukiwania zawęża listę.
References in the file (tylko zestawy) wymienia właściwości, wartości właściwości, producentów, kategorie, strony docelowe, pola dodatkowe i ikony, które nazywa zestaw. Każde odwołanie jest odnajdywane po ID, a w przeciwnym razie po nazwie:
| Stan | Znaczenie |
|---|---|
| same ID | Znalezione bez zmian. Pola dodatkowe i ikony mówią same name. |
| matched by name (other ID) | Znalezione pod innym ID; import używa ID tego sklepu. |
| not here | Brak: wybierz zamiennik albo je pomiń. |
Pominięcie odwołania usuwa to, co od niego zależy, jak mówi wiersz: grupę, kartę filtra złożonego, ikonę grupy, jej warunek strony, właściwość z grup automatycznych albo wartość z własnej kolejności grupy. Import rusza dopiero wtedy, gdy rozstrzygnięto każde brakujące odwołanie; o wartości właściwości można zdecydować dopiero po jej właściwości.
Translations pokazuje każdy język pliku i tego sklepu:
- język pliku, który ma ten sklep, jest Imported;
- język, którego ten sklep nie ma, jest Skipped;
- język tego sklepu, dla którego plik nie ma tekstów, dostaje Leave empty (sklep pokazuje tekst języka domyślnego) albo Copy from … (teksty pierwszego języka pliku, do przetłumaczenia później).
Krok ostrzega też, gdy:
- ustawienie z pliku ma wartość, której ten sklep nie przyjmuje (niedozwoloną, podwójną w zestawie, nieznaną): zostaje pominięte;
- grupa pokazywała się tylko na stronach, których ten sklep nie ma: po imporcie pokazuje się wszędzie, więc ustaw jej strony w kreatorze;
- plik zawiera ustawienia źródeł: import ich nie przejmuje, bo źródła dotyczą całego sklepu naraz. Ustaw je w Źródłach.
Import to the draft zapisuje wersję roboczą. Ostatni krok mówi, dokąd trafiła:
- nowy zestaw jest wersją roboczą bez przypisania: sprawdź go w kreatorze, opublikuj i przypisz;
- nowa skórka jest wersją roboczą bez kanału: sprawdź ją w edytorze skórek, opublikuj i przydziel kanałowi;
- nadpisana wersja robocza zawiera plik, a sklep pokazuje opublikowaną wersję, dopóki wersja robocza nie zostanie opublikowana;
- dostosowania kanału są wersją roboczą, a kanał wygląda tak samo, dopóki nie zostaną opublikowane w edytorze skórek.
Open in the builder (albo Open in the skin editor, Open the shop defaults) prowadzi do wersji roboczej; Import another file zaczyna od nowa.
O publikowaniu zobacz Zestawy filtrów i Skórki.