Przejdź do treści
Intum Pomoc
Aktualizacja: 4 min czytania

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 w target: "toolkit_setting" (rekord Toolkit::Setting), pozostałe w target: "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 w target: "toolkit_setting", boolean, domyślnie false: 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łem helpdesk, a team_id, project_id i tasklist_ids - tylko z włączoną częścią modułu (organize.teams, organize.projects, organize.tasklists). Bez nich pola nie ma w fields i 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.