setSubmitMode (referenční dokumentace k rozhraní API klienta)

Nastaví, jestli se data ze sloupce odesílají při uložení záznamu.

Podporované typy sloupců

Všechno

Syntaxe

formContext.getAttribute(arg).setSubmitMode(mode)

Parametry

Typ: Řetězec.

Popis: Nastavte jednu z následujících hodnot režimu:

• always: Data se vždy odesílají s uložením.
• never: Data se nikdy neodesílají s uložením. Pokud použijete tuto hodnotu, sloupce ve formuláři pro tento sloupec nelze upravit.
• dirty: Výchozí chování. Data se po změně odesílají spolu s uložením.

Poznámky

Tato metoda slouží k řízení, kdy se data pro sloupec odesílají při vytvoření nebo uložení záznamu. Například ve formuláři můžete mít sloupec, který je určený pouze k řízení logiky ve formuláři. Nezajímá vás zachytávání dat v něm. Můžete ho nastavit tak, aby se data neuložila. Nebo můžete mít modul plug-in, který závisí na hodnotě, která je vždy zahrnuta. Sloupec můžete chtít nastavit tak, aby byl vždy zahrnutý.

Poznámka:

Data ve sloupci se po operaci uložení vždy aktualizují, i když je režim odeslání sloupce nastavený na never. Pokud je například hodnota sloupce na serveru null a režim odeslání sloupce je nastaven na neverhodnotu a sloupec se upraví o určitou hodnotu uživatelem, po uložení formuláře se hodnota sloupce nahradí hodnotou null.

Sloupce, které se neaktualizují po počátečním uložení záznamu, například createdby, jsou nastaveny tak, aby se při uložení neodeslaly. Chcete-li vynutit odeslání hodnoty sloupce bez ohledu na to, zda se změnil, nebo ne, použijte tuto metodu s parametrem mode nastaveným na always.

Související články

getSubmitMode (referenční dokumentace k rozhraní API klienta)