Compartilhar via


setSubmitMode (referência da API do Cliente)

Define se os dados da coluna serão enviados quando o registro for salvo.

Tipos de coluna com suporte

All

Sintaxe

formContext.getAttribute(arg).setSubmitMode(mode)

Parâmetros

Tipo: cadeia de caracteres.

Descrição: defina um dos seguintes valores de modo:

  • always: os dados são sempre enviados com uma salvação.
  • never: os dados nunca são enviados com um salvamento. Quando esse valor é usado, as colunas no formulário dessa coluna não podem ser editadas.
  • dirty: comportamento padrão. Os dados são enviados com o salvamento quando são alterados.

Observações

Use esse método para controlar quando os dados de uma coluna são enviados quando um registro é criado ou salvo. Por exemplo, você pode ter uma coluna no formulário que se destina apenas a controlar a lógica no formulário. Você não está interessado em capturar os dados nele. Você pode defini-lo para que os dados não sejam salvos. Ou você pode ter um Plug-in que depende do valor sempre sendo incluído. Talvez você queira definir a coluna para que ela sempre seja incluída.

Observação

Os dados em uma coluna sempre serão atualizados após a operação de salvamento, mesmo se o modo de envio da coluna estiver definido como never. Por exemplo, se o valor de uma coluna no servidor for nulo e o modo de envio da coluna for definido nevercomo , e a coluna for modificada com algum valor pelo usuário, depois que o usuário salvar o formulário, o valor da coluna será substituído por nulo.

As colunas que não são atualizadas após o salvamento inicial do registro, como createdby, são definidas para que não sejam enviadas ao salvar. Para forçar um valor de coluna a ser enviado se ele foi alterado ou não, use esse método com o mode parâmetro definido como always.

getSubmitMode (referência da API do cliente)