HideColumn()

Zastosowanie

Funkcja HideColumn ukrywa wskazaną kolumnę we wskazanej tabeli. Działa także dla tabel zagnieżdżonych w innych tabelach.

Uwaga: w wersji AMODIT 250331 i wcześniejszych funkcja HideColumn nie działa, gdy tabela jest wyświetlana w trybie formularza. W takim przypadku użyj funkcji HideField w regule tabeli albo w pętli foreachrow. Od wersji 250630 funkcja HideColumn działa także dla tabel wyświetlanych w trybie formularza.

Efekt działania

Kolumna z podanym polem znika z tabeli. Domyślnie kolumna jest nadal generowana w kodzie strony, ale niewidoczna. Z argumentem hideFromSource równym true kolumna w ogóle nie trafia do kodu strony.

Ukrycie kolumny jest tymczasowym efektem interfejsu. Nie zapisuje się w bazie danych i może zmienić się po odświeżeniu strony, ponownym otwarciu sprawy albo ponownym przeliczeniu reguł. Jeżeli efekt ma się utrzymywać podczas edycji, używaj funkcji w regule automatycznej, która przelicza się w trakcie pracy z formularzem.

Składnia

HideColumn("tableName[>tableName>...]","fieldName");

HideColumn("tableName[>tableName>...]","fieldName",hideFromSource);

Argumenty

Argument	Typ	Wymagany	Opis
`tableName`	tekst	Tak	Nazwa tabeli, w której ma zostać ukryta kolumna. Tabelę zagnieżdżoną wskażesz łańcuchem nazw rozdzielonych znakiem `>`, np. `Orders>Positions`.
`fieldName`	tekst	Tak	Nazwa pola w tabeli. Kolumna z tym polem zostanie ukryta.
`hideFromSource`	wartość logiczna	Nie	`true` sprawia, że kolumna nie jest generowana w kodzie strony. Domyślnie `false`.

Zwracana wartość

Funkcja zawsze zwraca true.

Przykłady

Przykład 1: kolumna w tabeli

Funkcja ukrywa kolumnę Quantity w tabeli Orders.

HideColumn("Orders","Quantity");

Przykład 2: kolumna w tabeli zagnieżdżonej

Funkcja ukrywa kolumnę Quantity w tabeli Positions, która jest zagnieżdżona w tabeli Orders.

HideColumn("Orders>Positions","Quantity");

Przykład 3: kolumna pominięta w kodzie strony

Funkcja ukrywa kolumnę Quantity w tabeli Orders i nie generuje jej w kodzie strony.

HideColumn("Orders","Quantity",true);

Dobre praktyki

Podawaj nazwy tabeli i pola dokładnie tak, jak w konfiguracji formularza.
Używaj argumentu hideFromSource tylko wtedy, gdy kolumna ma w ogóle nie trafić do kodu strony.

Typowe błędy

Nazwa tabeli albo pola z błędem. Jeżeli nazwy są wpisane wprost, walidacja reguły zgłosi nieistniejącą tabelę albo pole. Jeżeli pochodzą ze zmiennych, funkcja nie znajdzie kolumny i niczego nie zmieni. Sprawdź nazwy tabeli i pola przed wywołaniem funkcji.