Właściwości listy — karta Edycja inline

Podsumowanie:
Na tej karcie można włączyć jeden z dwóch trybów edytowania danych bezpośrednio na liście (edycja inline). W jednym z trybów rekordy edytuje się pojedynczo, a przyciski edycji i zapisu znajdują się w kolumnie akcji. Drugi tryb umożliwia edytowanie danych bezpośrednio po kliknięciu w komórkę listy i zbiorcze zapisywanie zmian w wielu rekordach na stronie. W tym drugim trybie nie można dodawać rekordów.

Zakres operacji (dodawanie, edycji, usuwanie) dostępnych w trybie edycji inline definiuje się osobnymi przełącznikami. Włączenie przełączników poszczególnych funkcji edycji na karcie Edycja inline powoduje dodanie odpowiednich obiektów w drzewie elementów listy, w gałęzi Przyciski listy/Wiersz i/lub Przyciski listy/Górny panel. Przyciski Zapisz i Usuń wymagają zdefiniowania indywidualnych akcji SQL, które będą wykonywane po kliknięciu przycisku.
Ponadto, po włączeniu trybu edycji inline we właściwościach kolumn pojawi się karta Edycja inline, na której określa się między innymi typ kontrolki wyświetlanej w danej kolumnie podczas edycji inline, wartość domyślną oraz, zależnie od typu danych kolumny, wartość minimalną i maksymalną.

☛ AdminSPA > INTERFEJS UŻYTKOWNIKA > Listy >Edytuj > Edycja inline

Na karcie można ustawić następujące właściwości:

Tryb edycji inline: dostępne wartości:
- po kliknięciu w wiersz: aby edytować dane na liście, należy kliknąć odpowiednią komórkę. W tym trybie można zmieniać wartości w wielu wierszach i zbiorczo zapisać (anulować) zmiany; przyciski zapisu i zanulowania zmian znajdują się na górnym panelu listy. Dodawanie wierszy nie jest obsługiwane.
- po kliknięciu w przycisk edycji: wejście w tryb edycji wymaga kliknięcia przycisk w kolumnie akcji w danym rekordzie. W tym trybie trzeba zapisać (anulować) zmiany w każdym rekordzie osobno; przyciski zapisu i anulowania znajdują się w każdym wierszu w kolumnie akcji, przycisk dodawania nowego wiersza znajduje się na panelu górnym.
- wyłączona: edycja inline jest wyłączona.
Nie można używać jednocześnie funkcji Wywołaj akcje po interakcji z rekordem listy na karcie Ustawienia listy oraz trybu edycji inline po kliknięciu w wiersz. Włączenie jednej z tych funkcji spowoduje wyświetlenie komunikatu o konieczności wyłączenia drugiej.
Dostępne operacje:
- Dodawanie rekordu: (tylko tryb po kliknięciu w przycisk edycji) wstawia przycisk Dodaj na górnym panelu listy; kliknięcie tego przycisku dodaje nowy, pusty wiersz do listy z włączonym trybem edycji inline; ten przycisk jest wyświetlany na górnym panelu listy z lewej strony.
- Edycja rekordu: zależnie od trybu edycji inline, wstawia w kolumnie akcji przycisk Edycja, którego kliknięcie włącza tryb edycji danych w bieżącym wierszu listy, lub aktywuje włączanie trybu edycji po kliknięciu w komórkę danych na liście.
- Usuwanie rekordu: wstawia przycisk Usuń w kolumnie akcji; kliknięcie tego przycisku usuwa bieżący wiersz; we właściwościach tego przycisku należy skonfigurować zapytanie SQL dla właściwości Akcja.
Włączenie przełącznika Dodawanie i/lub Edycja powoduje także dodanie w kolumnie akcji przycisków Zapisz i Anuluj. Dla przycisku zapisu należy zdefiniować akcję zapisu w jego właściwościach.
Identyfikator rekordu do obsługi błędów: dowolna kolumna listy, np. Id, Code itp., z której wartość będzie używana w wyświetlanych komunikatach o błędach.
Zbiór akcji do wywołania na otwarcie i zmianę wartości rekordu w edycji inline: zestaw akcji Javascript, których celem powinno być konfigurowanie możliwości edycji i wymagalności poszczególnych komórek w trybie edycji inline. Akcje są wykonywane po wejściu w tryb edycji oraz po wprowadzeniu zmian w komórkach rekordu (zmiana kontekstu rekordu).
W akcjach można korzystać z obiektu rowContext, który zawiera wartości z poszczególnych pól rekordu oraz dodatkowo wartości pomocnicze zwracane przez listy rozwijane używane w polach rekordu. Do odwoływania się do poszczególnych komórek służy funkcja GetControlByColumnId(columnName), gdzie columnName to wartość atrybutu Nazwa SQL danej kolumny. Funkcja zwraca obiekt reprezentujący kontrolkę używaną w danej kolumnie lub null, jeśli kolumna o podanej nazwie nie istnieje.
Dla zwróconego obiektu kontrolki są dostępne dwie metody:
- setRequired(isRequired: boolean): void;
- setDisabled(isDisabled: boolean): void; Pierwsza z nich ustawia właściwość iSRequired (wymagalność), a druga isDisabled (edytowalność). Obie właściwości można ustawić za pomocą jednej instrukcji:
```
const ctrlEnvType = getControlByColumn('RodzajKoperty');
if (rowContext.RodzajWysylki === 'list'){
ctrlEnvType
.setDisabled(false)
.setRequired(true);
}
```
Uwagi
- Nie jest obsługiwane jednoczesne włączenie dla kontrolki obu właściwości (kontrolka tylko do odczytu nie może być wymagalna).
- W przypadku kontrolki typu checkbox ustawienie wymagalności oznacza, że pole wyboru w danym rekordzie musi być zaznaczone.
- Warto zwrócić uwagę na różnice w działaniu operatorów == i === w JavaScript.

|← Właściwości listy — karta Ustawienia listy |↑ Do góry |→ Właściwości listy — karta Globalne ustawienia kolumn |