Dokumentacja dla programistów

Konfigurowanie aplikacji

Marketplace aplikacjiAplikacje monday.com
Aktualizacja 2025-10-23

Po przejściu procesu wdrożenia użytkownicy mogą skonfigurować aplikację i zacząć korzystać z jej funkcji. Aby przyspieszyć konfigurację, stworzyliśmy okno konfiguracji oraz kilka metod SDK. Pomagają one użytkownikom w pełni wykorzystać możliwości aplikacji i ograniczają potrzebę dodatkowego wsparcia.

W tym przewodniku omawiamy okno konfiguracji i sposób jego użycia. Opisujemy też każdą metodę SDK, wyjaśniamy, jak działa i jakie korzyści przynosi użytkownikom. Znajdziesz tu również linki do dokumentacji SDK ze szczegółowymi informacjami i przykładami dla każdej metody.

Okno konfiguracji

Za pomocą okna konfiguracji możesz od razu poprosić użytkowników o ustawienie konkretnych opcji. Dzięki temu szybciej zaczną korzystać z aplikacji i w pełni wykorzystają jej możliwości. Okno działa z aplikacjami widoku i nie wymaga dodatkowego kodu, ale żeby się pojawiło, musisz opublikować nową wersję minor.

W aplikacjach ze zdefiniowanym punktem początkowym okno konfiguracji pojawia się po przejściu przez początkowy proces wdrożenia. To Ty decydujesz, które ustawienia użytkownicy mają skonfigurować przed rozpoczęciem korzystania z aplikacji. Nie musisz jednak umieszczać w oknie wszystkich ustawień. Użytkownicy mogą przejść przez okno, otworzyć punkt początkowy i skonfigurować wybrane ustawienia później, jeśli zajdzie taka potrzeba.

Konfigurowanie aplikacji - ilustracja 1

Możesz dostosować ustawienia wyświetlane w oknie, korzystając z różnych pól w sekcji Ustawienia widoku (View Settings), takich jak kolor, tekst czy data. Dostępne opcje wprowadzania danych zależą od typu pola. Dla każdego pola możesz określić:

  • Tytuł: Tytuł wyświetlany użytkownikom
  • Podtytuł: Krótki opis pola konfiguracji
  • Nazwa: Klucz odpowiadający danym zwróconym z formularza
  • Informacje: Krótki opis lub dodatkowe informacje potrzebne użytkownikowi

Okno pojawi się wszystkim użytkownikom, którzy wybiorą funkcję początkową, ale domyślnie nie muszą oni wypełniać wyświetlonych w nim pól. Jeśli chcesz ustawić pole jako wymagane, zaznacz pole wyboru Wymagane podczas wdrożenia (Required for onboarding). Użytkownicy nie będą mogli pominąć okna konfiguracji bez wypełnienia wskazanych pól.

W przypadku pól wymaganych musisz też wpisać w polu Alias unikalny alias dla każdego pola. Jeśli dwa pola mają różne tytuły, ale ten sam alias, w oknie pojawi się tylko jedno z nich. Możesz też utworzyć kilka pól z tym samym aliasem, jeśli chcesz, aby użytkownicy skonfigurowali kilka ustawień jednocześnie. Wszystkie te pola muszą mieć takie same opcje wprowadzania danych.

Konfigurowanie aplikacji - ilustracja 2

Po wypełnieniu pól w oknie aplikacja zostanie skonfigurowana na podstawie danych wprowadzonych przez użytkownika. Jeśli użytkownik pominie te pola, nadal będzie mógł je skonfigurować w menu Dostosuj widok (Customize view). W tym celu kliknie ikonę koła zębatego po prawej stronie ekranu.

Okno konfiguracji pomaga klientom szybciej zacząć korzystać z aplikacji. To także pierwsza rzecz, którą zobaczą po rozpoczęciu pracy z aplikacją. Użytkownicy mogą w każdej chwili kliknąć przycisk Pomoc (Help), aby otworzyć kartę Jak korzystać (How to use), jeśli aplikacja ją zawiera. Warto jednak zadbać o to, by użytkownicy rozumieli, do czego służy każde pole. Pomoże to uniknąć nieporozumień i opóźnień. Jeśli nie wiesz, od czego zacząć, zobacz przykład konfiguracji pola kolumny!

Metody SDK

Możesz użyć tych metod SDK, aby pomóc użytkownikom skonfigurować aplikację i szybciej zacząć z niej korzystać!

Otwieranie i zamykanie okna modalnego

Metody openAppFeatureModal i closeAppFeatureModal otwierają i zamykają okno modalne. Za pomocą tej metody możesz umieścić w aplikacji stronę pomocy z przydatnymi instrukcjami wdrożeniowymi dla użytkowników.

Otwieranie i zamykanie okna ustawień

Metody openSettings i closeSettings rozwijają lub zwijają okno ustawień w widoku aplikacji. Po ich wdrożeniu użytkownicy mogą otwierać i zamykać okno ustawień według własnych preferencji. Metoda ta pozwala zachęcić użytkowników do skonfigurowania ustawień, aby mogli jak najszybciej zacząć korzystać z aplikacji.

Ustawianie ustawień

Metoda monday.set() pozwala skonfigurować dane w aplikacji. Możesz jej użyć do ustawienia wartości domyślnych, dzięki którym użytkownicy od razu zaczną korzystać z aplikacji.

📘 Dołącz do naszej społeczności deweloperów!

Stworzyliśmy społeczność dla deweloperów. Możesz tam przeszukiwać wcześniejsze wątki, aby znaleźć rozwiązania, zadawać pytania, poznawać nowe funkcje i aktualizacje oraz uczyć się wskazówek i trików od innych deweloperów. Dołącz do nas! 😎