---
title: "Pola obiektów"
description: "Twórz pola dodatkowe na dane, których Requiply domyślnie nie przechowuje, np. numer prawa jazdy klienta lub numer seryjny pozycji."
canonical_url: "https://requiply.com/docs/pl/guides/settings/fields/entity-fields"
---
# Pola obiektów

> Twórz pola dodatkowe na dane, których Requiply domyślnie nie przechowuje, np. numer prawa jazdy klienta lub numer seryjny pozycji.

Na stronie **Pola obiektów** tworzysz pola dodatkowe, które rozszerzają dane zbierane w Twojej organizacji w Requiply, i zarządzasz nimi. Pozwala ona dopasować zbierane informacje ponad wbudowane pola i łączy się ze wszystkimi miejscami w produkcie, w których te pola dodatkowe są wyświetlane lub wypełniane.

Tutaj przychodzisz, aby **dodać dodatkowe pole do klienta, pozycji lub rezerwacji**, gdy Requiply domyślnie go nie przechowuje: numer prawa jazdy lub numer rejestrowy firmy przy kliencie, datę zakupu lub numer seryjny przy pozycji, nazwę wydarzenia przy rezerwacji. Utworzenie pola tutaj to pierwszy z dwóch kroków: gdy pole już istnieje, przypisz je do rekordów, do których należy, w [Konfiguracji poziomów](https://requiply.com/docs/pl/guides/settings/fields/level-configurations), i dopiero to sprawia, że pojawia się w formularzu.

Ta strona znajduje się w **Ustawienia → Pola → Pola obiektów**.

<warning>

**Tylko dla administratorów.** Strona jest chroniona przez middleware `admin`, więc użytkownicy bez uprawnień administratora nie mogą otwierać pól obiektów ani nimi zarządzać.

</warning>

<figure>

![Strona Pola obiektów z podzieloną na strony tabelą pól dodatkowych, ich kluczy i typów](https://requiply.com/docs/assets/settings/fields/entity-fields/entity-fields-screenshot.png)<figcaption>

Strona Pola obiektów pokazuje każde pole dodatkowe zdefiniowane w organizacji z nazwą, kluczem pola i typem.

</figcaption>
</figure>

## Dlaczego ta strona jest ważna

Pola obiektów pozwalają Twojej organizacji zbierać informacje specyficzne dla Twojej firmy. Pola standardowe obejmują podstawy, ale każda firma ma własne potrzeby: preferowany sposób kontaktu, informacje o alergiach, wewnętrzne numery referencyjne, specjalne instrukcje i tak dalej.

Gdy raz zdefiniujesz pola dodatkowe na tej stronie, Twój zespół może zbierać spójne, uporządkowane dane wszędzie tam, gdzie te pola są używane. Każde pole ma stały **Klucz pola** generowany automatycznie z nazwy pola, więc dane pozostają dostępne, nawet jeśli później zmienisz nazwę pola w interfejsie.

## Kto może korzystać z tej strony

- **Tylko administratorzy.** Strona, strona dodawania i strona edycji wymagają uprawnień administratora.
- Zwykli pracownicy nie widzą tego obszaru.
- Strona korzysta też z kontekstu aktywnej organizacji: wczytuje pola obecnie wybranej organizacji.

## Co widać na stronie

Gdy istnieją pola obiektów, strona pokazuje jedną kartę z podzieloną na strony tabelą wszystkich pól organizacji. Tabela zawiera:

- **Wiersz nagłówka** z tytułem strony, globalnym **polem wyszukiwania** i przyciskiem **+ Dodaj pole** po prawej.
- Kolumnę **Nazwa** z czytelną nazwą pola. Pola dostarczane przez Requiply mają oznaczenie **Systemowe** (zobacz [Pola systemowe](#pola-systemowe)).
- Kolumnę **Klucz pola** z automatycznie wygenerowanym kluczem technicznym zapisanym czcionką o stałej szerokości.
- Kolumnę **Typ pola** z typem pola jako kolorowym oznaczeniem (np. Tekst, Długi tekst, Liczba, Wybór z listy, Wielokrotny wybór, Pole wyboru, Data, Telefon).
- Kolumnę **Akcje**, przypiętą do prawej, z dwoma przyciskami w każdym wierszu: **ołówkiem** do edycji i **koszem** do usunięcia. Pola systemowe pokazują zamiast nich ikonę **kłódki**.

Tabela jest podzielona na strony, domyślnie po 10 wierszy, a użytkownik może przełączać między 5, 10, 20 lub 50 wierszami na stronę.

## Pusty stan

Gdy nie utworzono jeszcze żadnych pól obiektów, zamiast tabeli pojawia się pusty stan z:

- Ikoną listy.
- Tytułem pustego stanu zachęcającym administratora do dodania pierwszego pola.
- Głównym przyciskiem, który przenosi administratora na stronę **Dodaj pole obiektu**.

Pierwsze pole jest ważne, bo ustala, jak Twój zespół będzie odtąd zbierać dodatkowe dane. Wybranie od początku jasnej nazwy i właściwego typu pola pozwala uniknąć zamieszania później.

## Główne akcje

### Dodawanie nowego pola obiektu

Kliknięcie **+ Dodaj pole** (w nagłówku tabeli lub w pustym stanie) otwiera stronę **Dodaj pole obiektu**.

Strona dodawania jest podzielona na dwie kolumny:

- **Lewa:** formularz do zdefiniowania pola.
- **Prawa:** karta **Podgląd** na żywo, która pokazuje, jak pole będzie wyglądać po zapisaniu.

Formularz prosi o:

- **Nazwa**: czytelna etykieta pola. Wymagana, do 100 znaków. Klucz pola jest generowany automatycznie z tej nazwy (cyrylica jest transliterowana, wynik zamieniany na małe litery, znaki inne niż litery i cyfry usuwane, a spacje zamieniane na myślniki).
- **Typ pola**: wybierany z listy wszystkich obsługiwanych typów pól obiektów: Tekst, Długi tekst, Liczba, Wybór z listy, Wielokrotny wybór, Pole wyboru, **Data** i **Telefon**.

W zależności od wybranego typu pojawia się dodatkowa konfiguracja:

- **Wybór z listy / Wielokrotny wybór:** pole **Opcje** (w formie przycisków), w którym dodajesz wartości do wyboru.
- **Liczba:** sekcja **Format liczby** z regułami `min`, `max`, `minFractionDigits` i `maxFractionDigits`. Wartości domyślne to 0–1000 i 0–2 miejsca po przecinku.
- **Data:** sekcja **Format daty** z przełącznikiem **Pokazuj godzinę**. Gdy jest wyłączony, pole przechowuje zwykłą datę kalendarzową; gdy jest włączony, przechowuje moment w czasie, a notatka pomocnicza brzmi *„Wartości są zapisywane w UTC i wyświetlane w strefie czasowej organizacji.”* Sekcja pokazuje podgląd wybranego formatu jako *Wyświetlane jako: {value}* i podaje strefę czasową, w której będzie wyświetlane.
- **Telefon:** bez sekcji formatu. Pole jest wyświetlane jako pole numeru telefonu z wyborem kraju i flagą i zapisuje numer w międzynarodowym formacie E.164 (`+380953370000`). Wybór kraju otwiera się na kraju numeru telefonu organizacji, a gdy go nie ma, na kraju języka interfejsu.
- **Tekst / Długi tekst:** sekcja **Format tekstu** z regułami długości `min` i `max`. Wartości domyślne to 0–500.

Naciśnięcie **Zapisz** tworzy pole w bieżącej organizacji i wraca do listy pól obiektów z powiadomieniem o powodzeniu. **Anuluj** wraca do listy bez zapisywania. Podczas zapisywania strona jest zablokowana nakładką na cały ekran.

### Edycja pola obiektu

Kliknięcie ikony **ołówka** obok pola otwiera stronę **Edytuj pole obiektu**.

<figure>

![Strona Edytuj pole obiektu z polem typu Wybór z listy, jego opcjami i podglądem na żywo po prawej](https://requiply.com/docs/assets/settings/fields/entity-fields/edit-field.png)<figcaption>

Edycja pola Wybór z listy. Nazwa i typ pola są tylko do odczytu; można zmienić tylko listę opcji (i obserwować podgląd na żywo).

</figcaption>
</figure>

Strona edycji też ma układ dwukolumnowy z podglądem na żywo po prawej.

Na stronie edycji:

- **Nazwa** i **Typ pola** są pokazane jako tekst tylko do odczytu. Nie można ich zmienić po utworzeniu pola.
- Edytować można tylko konfigurację odpowiednią dla typu pola:

  - **Wybór z listy / Wielokrotny wybór:** listę **Opcje**.
  - **Liczba:** reguły formatu liczby (min, max, miejsca po przecinku).
  - **Data:** przełącznik **Pokazuj godzinę**.
  - **Tekst / Długi tekst:** reguły formatu tekstu (min, max długość).

Przycisk **Zapisz zmiany** jest nieaktywny, dopóki naprawdę czegoś nie zmienisz względem wczytanych wartości. **Anuluj** wraca do listy bez zapisywania. Podczas wczytywania lub zapisywania danych stronę zakrywa nakładka ładowania.

### Usuwanie pola obiektu

Strona daje dwa sposoby usunięcia pola:

- Na liście kliknij ikonę **kosza** w akcjach wiersza.
- Na stronie edycji kliknij przycisk **Usuń** w lewym dolnym rogu.

Oba sposoby otwierają okno potwierdzenia **Potwierdź usunięcie**. Po potwierdzeniu pole jest usuwane, a lista się odświeża (a jeśli usunięcie zostało uruchomione ze strony edycji, wracasz do listy).

<warning>

**Uwaga:** Usunięcie pola jest z założenia trwałe. Żadne miejsce, które wyświetla to pole lub z niego korzysta, nie będzie go już mieć, więc przed usunięciem upewnij się, że nie zależą od niego żadne ważne procesy.

</warning>

### Pola systemowe

Niektóre pola są zdefiniowane przez Requiply, a nie przez Ciebie, bo korzystają z nich inne części produktu. Na liście mają oznaczenie **Systemowe** i **kłódkę** w miejscu przycisków edycji i usuwania: *„Definicjami pól systemowych zarządza Requiply. Możesz ustawić, gdzie są używane.”*

<table>
<thead>
  <tr>
    <th>
      Pole
    </th>
    
    <th>
      Klucz
    </th>
    
    <th>
      Typ
    </th>
    
    <th>
      Poziomy
    </th>
    
    <th>
      Używane przez
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        ЄДРПОУ / РНОКПП (ІПН)
      </strong>
      
      : ukraiński kod podmiotu prawnego (8-cyfrowy EDRPOU) lub numer podatkowy osoby fizycznej (10-cyfrowy RNOKPP / IPN)
    </td>
    
    <td>
      <code>
        system_ua_legal_party_code
      </code>
    </td>
    
    <td>
      Tekst, 8–10 cyfr
    </td>
    
    <td>
      Klient, Organizacja
    </td>
    
    <td>
      <a href="https://requiply.com/docs/pl/guides/bookings/payments-and-documents/documents#wysy%C5%82anie-dokumentu-do-podpisu">
        Wysyłanie dokumentu do podpisu
      </a>
      
       wstępnie wypełnia kod klienta z tego pola.
    </td>
  </tr>
</tbody>
</table>

Pole systemowe jest tworzone dla każdej organizacji i po przypisaniu go w [Konfiguracji poziomów](https://requiply.com/docs/pl/guides/settings/fields/level-configurations) działa jak każde inne pole: pojawia się w formularzu klienta (lub w [Informacjach o organizacji](https://requiply.com/docs/pl/guides/settings/organization/info)), jest zapisywane dla każdego rekordu i jest dostępne jako zmienna w szablonach. Przyjmuje tylko cyfry i musi mieć dokładnie 8 lub 10 cyfr; nie ma wartości domyślnej.

### Wyszukiwanie

Nagłówek zawiera pole **globalnego wyszukiwania**. Wpisany tekst filtruje tabelę we wszystkich widocznych kolumnach według zawierania, więc łatwo znaleźć pole po nazwie, kluczu lub nazwie typu.

## Formularze i pola

### Strona dodawania

<table>
<thead>
  <tr>
    <th>
      Pole
    </th>
    
    <th>
      Wymagane
    </th>
    
    <th>
      Uwagi
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        Nazwa
      </strong>
    </td>
    
    <td>
      Tak
    </td>
    
    <td>
      1–100 znaków. Służy do wygenerowania klucza pola.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Typ pola
      </strong>
    </td>
    
    <td>
      Tak
    </td>
    
    <td>
      Musi być jedną z wartości <code>
        EntityFieldType
      </code>
      
      . Domyślnie <strong>
        Tekst
      </strong>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Opcje
      </strong>
    </td>
    
    <td>
      Gdy typ to Wybór z listy lub Wielokrotny wybór
    </td>
    
    <td>
      Dowolna lista przycisków z wartościami.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Format liczby
      </strong>
    </td>
    
    <td>
      Gdy typ to Liczba
    </td>
    
    <td>
      <code>
        min
      </code>
      
      , <code>
        max
      </code>
      
      , <code>
        minFractionDigits
      </code>
      
      , <code>
        maxFractionDigits
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Format daty
      </strong>
    </td>
    
    <td>
      Gdy typ to Data
    </td>
    
    <td>
      Przełącznik <strong>
        Pokazuj godzinę
      </strong>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Format tekstu
      </strong>
    </td>
    
    <td>
      Gdy typ to Tekst lub Długi tekst
    </td>
    
    <td>
      Długość <code>
        min
      </code>
      
      , <code>
        max
      </code>
      
      .
    </td>
  </tr>
</tbody>
</table>

Walidacja widoczna w kodzie: nazwa jest wymagana i ma limit 100 znaków; typ pola musi być prawidłową wartością `EntityFieldType`.

### Strona edycji

- **Nazwa** i **Typ pola** są tylko do odczytu.
- Pokazywane są te same sekcje konfiguracji zależne od typu co na stronie dodawania, wstępnie wypełnione zapisanymi wartościami pola.
- **Zapisz zmiany** jest aktywne tylko wtedy, gdy dana konfiguracja różni się od pierwotnie wczytanej.

## Typy pól Data i Telefon

Dwa typy pól dodano po pierwotnym zestawie i oba robią więcej niż tylko przechowywanie tekstu.

### Data

Pole **Data** jest wyświetlane jako wybór daty i sortuje, filtruje oraz porównuje wartości jako prawdziwe daty, a nie jako tekst, co ma znaczenie w warunkach [automatyzacji](https://requiply.com/docs/pl/guides/automations/workflows) i w kolumnach tabel.

Przełącznik **Pokazuj godzinę** decyduje, co jest faktycznie zapisywane:

<table>
<thead>
  <tr>
    <th>
      Pokazuj godzinę
    </th>
    
    <th>
      Zapisywane jako
    </th>
    
    <th>
      Wyświetlane jako
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        Wyłączony
      </strong>
    </td>
    
    <td>
      Data kalendarzowa, <code>
        YYYY-MM-DD
      </code>
      
      .
    </td>
    
    <td>
      Ten sam dzień wszędzie i dla wszystkich. Właściwe dla końca gwarancji, daty zakupu, ważności licencji.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Włączony
      </strong>
    </td>
    
    <td>
      Moment w czasie, w UTC.
    </td>
    
    <td>
      Przeliczany na strefę czasową organizacji z <a href="https://requiply.com/docs/pl/guides/settings/organization/date-and-time">
        Ustawień daty i godziny
      </a>
      
      . Właściwe dla godzin przeglądów i wszystkiego, w czym liczy się godzina.
    </td>
  </tr>
</tbody>
</table>

Pole z samą datą nie ma strefy czasowej, więc nigdy nie przesuwa się o dzień przy odczycie z innego kraju. Włączaj **Pokazuj godzinę** tylko wtedy, gdy pora dnia naprawdę jest częścią wartości.

### Telefon

Pole **Telefon** jest wyświetlane jako pole numeru telefonu z wyszukiwarką krajów i flagą i zapisuje wpisany numer w międzynarodowym formacie **E.164**: `+`, kod kraju, a potem numer krajowy, bez zer na początku. Wpisanie `095 337 0000` przy wybranej Ukrainie zapisuje `+380953370000`.

Zapisywanie jednej, kanonicznej postaci sprawia, że ten sam numer działa jako link do połączenia, jako kontakt WhatsApp, Viber lub Telegram z szybkich akcji przy kliencie i jako odbiorca [akcji automatyzacji SMS i Viber](https://requiply.com/docs/pl/guides/automations/workflows) bez żadnego porządkowania.

Wybór kraju otwiera się na kraju numeru telefonu organizacji, a gdy organizacja go nie ma, na kraju języka interfejsu.

## Jak ta strona łączy się z resztą Requiply

<table>
<thead>
  <tr>
    <th>
      Funkcja
    </th>
    
    <th>
      Jak wpływa na nią ta strona
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        Zbieranie dodatkowych danych
      </strong>
    </td>
    
    <td>
      Zdefiniowane tu pola stają się dodatkowymi polami, które Twój zespół może wypełniać dla obiektów, które je obsługują.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Stałość klucza pola
      </strong>
    </td>
    
    <td>
      Automatycznie wygenerowany <code>
        fieldKey
      </code>
      
       to stały identyfikator, którym pole jest wskazywane w zapisanych danych, więc należy go traktować jako trwały uchwyt dla integracji i raportów.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Działanie zależne od typu
      </strong>
    </td>
    
    <td>
      Wybrane tu reguły formatu i opcje sterują walidacją i wyborem wartości wszędzie, gdzie pole jest wyświetlane.
    </td>
  </tr>
</tbody>
</table>

## Typowe scenariusze

### Dodatkowe dane w nowej firmie

Administrator otwiera **Ustawienia → Pola → Pola obiektów**, trafia na pusty stan i dodaje kilka pierwszych pól, które chce śledzić, np. pole wyboru z listy „Preferowany kontakt”, pole tekstowe „Numer wewnętrzny” i pole liczbowe „Limit rabatu” z regułami min/max.

### Dodanie nowej opcji do istniejącej listy

Zespół potrzebuje nowej wartości w polu Wybór z listy. Administrator klika ołówek obok pola, dodaje nową wartość na liście **Opcje** i zapisuje. Nazwa i typ pola się nie zmieniają, więc istniejące dane nadal do siebie pasują.

### Zaostrzenie walidacji pola tekstowego

Po zauważeniu, że pracownicy wpisują do pola tekstowego bardzo długie notatki, administrator edytuje pole i obniża długość **max** w regułach formatu tekstu. Nowe wpisy są od tej chwili ograniczone.

### Porządkowanie nieużywanych pól

Administrator przegląda listę, wyszukuje pola, które prawdopodobnie nie są już używane, i usuwa je ikoną kosza po potwierdzeniu w oknie usuwania.

## Wskazówki i ostrzeżenia

<tip>

**Wskazówka:** Starannie wybierz nazwę pola przy tworzeniu: od niej zależy automatycznie generowany klucz pola, a nazwy i typu nie można później edytować. Jeśli potrzebujesz innej nazwy lub typu, musisz usunąć pole i utworzyć nowe.

</tip>

<tip>

**Wskazówka:** Przy polach Wybór z listy i Wielokrotny wybór zaplanuj listę opcji przed udostępnieniem pola, aby użytkownicy od pierwszego dnia widzieli spójny zestaw wartości.

</tip>

<warning>

**Uwaga:** Usunięcie pola obiektu usuwa je z systemu. Przed usunięciem upewnij się, że żaden ważny proces nadal od niego nie zależy.

</warning>

<note>

**Pól systemowych** nie można tu edytować ani usuwać. Jeśli któregoś nie potrzebujesz, po prostu nie dodawaj go do żadnego poziomu w [Konfiguracji poziomów](https://requiply.com/docs/pl/guides/settings/fields/level-configurations).

</note>


## Sitemap

See the full [sitemap](https://requiply.com/docs/sitemap.md) for all pages.
