setSubmitMode (dokumentacja interfejsu API klienta)

Określa, czy dane z kolumny zostaną przesłane podczas zapisywania rekordu.

Obsługiwane typy kolumn

Wszystko

Składnia

formContext.getAttribute(arg).setSubmitMode(mode)

Parametry

Typ: Ciąg.

Opis: Ustaw jedną z następujących wartości trybu:

• always: dane są zawsze wysyłane przy użyciu zapisu.
• never: dane nigdy nie są wysyłane przy użyciu zapisu. Jeśli ta wartość jest używana, kolumny w formularzu dla tej kolumny nie mogą być edytowane.
• dirty: zachowanie domyślne. Dane są wysyłane przy użyciu zapisywania, gdy uległy zmianie.

Uwagi

Ta metoda służy do kontrolowania, kiedy dane kolumny są przesyłane podczas tworzenia lub zapisywania rekordu. Na przykład może istnieć kolumna w formularzu, która ma kontrolować logikę tylko w formularzu. Nie interesuje Cię przechwytywanie w nim danych. Można je ustawić tak, aby dane nie zostały zapisane. Możesz też mieć wtyczkę, która zależy od wartości, która jest zawsze uwzględniana. Możesz ustawić kolumnę tak, aby zawsze była uwzględniana.

Uwaga / Notatka

Dane w kolumnie będą zawsze odświeżane po operacji zapisywania, nawet jeśli tryb przesyłania kolumny ma wartość never. Jeśli na przykład wartość kolumny na serwerze ma wartość null, a tryb przesyłania kolumny ma wartość never, a kolumna zostanie zmodyfikowana przy użyciu pewnej wartości przez użytkownika, po zapisaniu formularza wartość kolumny zostanie zamieniona na wartość null.

Kolumny, które nie są aktualizowane po początkowym zapisie rekordu, na przykład createdby, są ustawione tak, aby nie były przesyłane podczas zapisywania. Aby wymusić przesłanie wartości kolumny niezależnie od tego, czy została zmieniona, czy nie, użyj tej metody z parametrem ustawionym mode na alwayswartość .

Powiązane artykuły

getSubmitMode (dokumentacja interfejsu API klienta)