Partilhar 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 suportados

Todos

Sintaxe

formContext.getAttribute(arg).setSubmitMode(mode)

Parâmetros

Tipo: String.

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

  • always: Os dados são sempre enviados com um save.
  • never: Os dados nunca são enviados com um save. Quando esse valor é usado, a(s) coluna(s) no formulário desta coluna não podem ser editadas.
  • dirty: Comportamento padrão. Os dados são enviados com o save quando ele é alterado.

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 Plugin que depende do valor sempre sendo incluído. Você pode definir a coluna para que ela seja sempre incluída.

Observação

Os dados em uma coluna sempre serão atualizados após a operação de salvamento, mesmo que o modo de envio da coluna esteja definido como never. Por exemplo, se o valor de uma coluna no servidor for nulo e o modo de envio da coluna estiver definido como never, 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 null.

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, quer tenha sido alterado ou não, use este método com o mode parâmetro definido como always.

getSubmitMode (referência da API do cliente)