Przejdź do głównej zawartości

Magazyn: kartoteka, stany i ruchy

Dla: Programista

Magazyn drukarni w API to karty materiałów (papier, farby, folie) ze stanem, narzędzia (wykrojniki i matryce), dostawcy, zamówienia zakupu i ruchy magazynowe. Czytasz je zakresem warehouse:read. Stan zmieniasz zakresem warehouse:write, przyjęciem albo wydaniem (receivePaper, withdrawPaper i odpowiedniki farb i folii). Karty zakłada i zmienia drukarnia w aplikacji.

Gotowe przepisy:

Ekrany magazynu w aplikacji opisuje dokumentacja użytkownika.

Karta farby (Paint) ma kolor w polu colorHex (#RRGGBB), gdy drukarnia go wpisała; inaczej pole jest null (nigdy pustym tekstem). Gdy pola nie ma, aplikacja Prynt pokazuje farbę w kolorze przybliżonego wzorca Pantone o nazwie farby (name). Listę tych wzorców pobierzesz z dokumentacji, żeby Twoja aplikacja pokazywała farby w tych samych kolorach co Prynt:

Pobierz wzorce (JSON)

Pobierz wzorce (CSV)

Lista ma 1341 wzorców. Plik JSON to obiekt z notą o pochodzeniu kolorów (notice) i listą colors, np. { "name": "186 C", "hex": "#C8102E" }. Plik CSV (UTF-8) ma te same wzorce w kolumnach name i hex, z wierszem nagłówka. Lista jest taka sama dla każdej drukarni i zmienia się tylko z wydaniem Prynt, więc trzymaj jej kopię u siebie i odświeżaj ją co jakiś czas.

  1. Kolor z karty: colorHex, gdy nie jest null.
  2. Wzorzec o nazwie farby: porównaj name farby z name wzorców po tych samych zmianach w obu nazwach — usuń odstępy z początku i końca, zamień każdy ciąg odstępów na jedną spację, pomiń wielkość liter i słowo „Pantone” na początku nazwy. Nazwy wzorców są po tych zmianach unikalne, więc pasuje najwyżej jeden.
  3. Bez koloru: farba bez colorHex i bez pasującego wzorca nie ma koloru (lista farb w aplikacji pokazuje wtedy białą próbkę, a karta farby — żadnej).
Nazwa farby (name) colorHex Kolor farby
186 C null #C8102E — wzorzec 186 C
Pantone 186 C null #C8102E — wzorzec 186 C
pantone warm red c null #F9423A — Warm Red C
Pantone 186 C #B00020 #B00020 — kolor z karty
Złoty metalik null brak koloru

Kolor z karty zmienia drukarnia w aplikacji. Taka zmiana przesuwa Paint.updatedAt, więc synchronizacja przyrostowa (updatedFrom, Paginacja, filtry i synchronizacja) ją widzi.

Listę farb z kolorami w aplikacji opisuje strona Farby dokumentacji użytkownika.