Strona /toolkit/ui/settings (Toolkit → UI → Ustawienia) ma dwie części:
-
Twoje ustawienia - każdy user zmienia je dla siebie (
target: "user_setting"), -
Ustawienia konta - tylko z uprawnieniem do ustawień konta (
:account): wartości domyślne paska górnego dla wszystkich - awatar wtarget: "toolkit_setting"(rekordToolkit::Setting), pozostałe wtarget: "organize_setting".
Obie części mają ten sam zestaw pól “Pasek górny”.
| Klucz | Target | Typ | Domyślnie | Co robi |
|---|---|---|---|---|
toolkit.settings.navbar_avatar |
user_setting / toolkit_setting
|
boolean | false |
Na komputerze: true - profil i wylogowanie w menu pod awatarem w prawym górnym rogu (tuż przed przyciskiem menu modułów), false - na dole panelu modułów (przycisk z czterema kwadratami). Nie zmienia przeglądarki na telefonie ani aplikacji mobilnej - tam menu osoby jest zawsze w menu modułów |
organize.navbar.changelog |
user_setting / organize_setting
|
boolean | true |
Widget z nowościami i komunikatami w górnym pasku |
organize.workinfo.start_stop |
user_setting / organize_setting
|
boolean | true |
Przycisk Play (Start/Stop rejestracji czasu pracy) w górnym pasku (przycisk na zadaniu to ustawienie konta organize.workinfo.task_play, zob. prompt workinfo_api). Ma sens tylko z modułem Organizacja i gdy konto używa czasu pracy (część modułu organize.workinfo, /account/modules/organize). Wartość konta (organize_setting) jest też w /organize/settings, sekcja Ustawienia WorkInfo. Wartość usera wygrywa z wartością konta; ukryty przycisk i tak pojawia się w trakcie pracy (np. Play na zadaniu) i znika po Stopie |
organize.navbar.search_expanded |
user_setting / organize_setting
|
boolean | true |
Pole wyszukiwania w górnym pasku zawsze rozwinięte |
Każdy klucz czytany jest łańcuchem: ustawienie usera → ustawienie konta (toolkit_setting dla
awatara, organize_setting dla organize.*) → wartość domyślna z tabeli. Zmiana w ustawieniu
konta nie nadpisuje wyborów, które user zapisał sam.
Odczyt
GET /toolkit/ui/settings.json
Wymaga :account (bez niego 403). Zwraca rekord Toolkit::Setting; wartości są
w fields.toolkit.settings. Brak klucza = wartość domyślna z tabeli.
Zapis
Domyślna wartość paska górnego dla całego konta (wymaga :account):
POST /account/set_field.json
{"target": "toolkit_setting", "key": "toolkit.settings.navbar_avatar", "value": "true"}
POST /account/set_field.json
{"target": "organize_setting", "key": "organize.workinfo.start_stop", "value": "false"}
Własny wybór usera (dla zalogowanego, bez dodatkowych uprawnień):
POST /account/set_field.json
{"target": "user_setting", "key": "organize.navbar.search_expanded", "value": "true"}
POST /account/set_field.json
{"target": "user_setting", "key": "toolkit.settings.navbar_avatar", "value": "true", "skip_cleanup": "true"}
Przy user_setting wysyłaj "skip_cleanup": "true" - bez tego zapis wartości równej domyślnej
usuwa klucz i obowiązuje ustawienie konta, a nie wybór usera. Powrót do ustawienia konta:
"value": "default".
Odpowiedź {"status": "ok"}. Ustawienie wartości domyślnej usuwa klucz z fields - to normalne,
odczyt i tak zwróci wartość domyślną.
Formatki - pola obowiązkowe
Strona /toolkit/ui/forms?form=organize_task (Toolkit → UI → Formatki, tylko z :account)
- pola formatki, które trzeba wypełnić przy dodawaniu i edycji, dla całego konta. Na razie jest
jedna formatka:
organize_task(zadanie). Klucze wtarget: "toolkit_setting", boolean, domyślniefalse:toolkit.form_organize_task.required_<pole>, gdzie<pole>to jedno z:status_id,responsible_id,event_start,deadline,estimated_hours,team_id,department_id,project_id,tasklist_ids,ticket_ids,client_id,deal_id,owner_id,tag_names.ticket_ids(powiązane zgłoszenia) działa tylko na koncie z modułemhelpdesk, ateam_id,project_iditasklist_ids- tylko z włączoną częścią modułu (organize.teams,organize.projects,organize.tasklists). Bez nich pola nie ma wfieldsi wymóg nie obowiązuje.
GET /toolkit/ui/forms.json?form=organize_task
# {"form": "organize_task", "fields": [{"code": "responsible_id", "required": true}, ...]}
POST /account/set_field.json
{"target": "toolkit_setting", "key": "toolkit.form_organize_task.required_project_id", "value": "true"}
Wymóg działa przy POST /organize/tasks i PATCH /organize/tasks/:id (formatka i API): brak
pola daje 422 z błędem przy tym polu. Zadania tworzone automatycznie (reguły automatyzacji,
zadania cykliczne) i szybkie akcje (zamknięcie, odłożenie, przeniesienie, odpięcie
od zgłoszenia) zapisują się bez wymogu.
Akcje masowe (change_bulk_option, change_bulk_option_multiple) sprawdzają tylko zmieniane pole:
nie wyczyszczą wymaganego (wartość none zostaje odrzucona), ale zmienią je na inną wartość.
Powiadomienia
Przełączniki dzwonka są na /toolkit/notifications/settings (dawniej /toolkit/notifications
i /account/menu?type=notification) - po API opisuje je prompt notification_settings_api.
Lista powiadomień to /toolkit/notifications (dawniej /account/notifications - stary adres HTML
przekierowuje); po API lista jest pod GET /account/notifications.json albo
GET /toolkit/notifications.json (ta sama odpowiedź). Lista zwraca powiadomienia zalogowanego
użytkownika; ?all=1 (wszystkie na koncie) działa tylko dla administratora konta (uprawnienie
Konto) - innym zwraca nadal tylko ich własne. Cudze powiadomienie po id (GET/DELETE
/account/notifications/:id) też widzi i usuwa tylko administrator konta, reszta dostaje 404.