ShowColumn()

Zastosowanie

Funkcja ShowColumn pokazuje 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 ShowColumn nie działa, gdy tabela jest wyświetlana w trybie formularza. W takim przypadku użyj funkcji ShowField w regule tabeli albo w pętli foreachrow. Od wersji 250630 funkcja ShowColumn działa także dla tabel wyświetlanych w trybie formularza.

Efekt działania

Kolumna z podanym polem staje się widoczna w tabeli.

Pokazanie 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

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

Argumenty

Argument	Typ	Wymagany	Opis
`tableName`	tekst	Tak	Nazwa tabeli, w której ma zostać pokazana 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 pokazana.

Zwracana wartość

Funkcja zawsze zwraca true.

Przykłady

Przykład 1: kolumna w tabeli

Funkcja pokazuje kolumnę Quantity w tabeli Orders.

ShowColumn("Orders","Quantity");

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

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

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

Dobre praktyki

Podawaj nazwy tabeli i pola dokładnie tak, jak w konfiguracji formularza.
Łańcucha nazw ze znakiem > używaj tylko dla tabel zagnieżdżonych.

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.
Tabela zagnieżdżona wskazana samą nazwą, np. Positions zamiast Orders>Positions. Funkcja może nie znaleźć tabeli. Rozdziel nazwy tabel w łańcuchu znakiem >.