Histórico da Página
...
Método | Descrição |
---|---|
long getCompanyId() | Retorna o ID da empresa |
int getDocumentId() | Retorna o ID do documento (registro de formulário) |
int getVersion() | Retorna a versão do documento (registro de formulário) |
int getCardIndex() | Retorna o ID do formulário |
String getValue(String fieldName) | Obtém o valor de um campo do formulário |
void setValue(String fieldName, String fieldValue) | Define o valor de um campo do formulário |
boolean getEnabled(String fieldName) | Verifica se um campo está habilitado |
void setEnabled(String fieldName, boolean enabled) | Define se um campo deve estar habilitado ou não |
void setEnabled(String fieldName, boolean enabled, boolean protect) | Define se um campo deve estar habilitado ou não, e se o campo desabilitado deve ser protegido ou não. Quando definido o valor true para o parâmetro protect, o campo desabilitado não terá seu valor salvo no registro de formulário. |
void setEnhancedSecurityHiddenInputs(boolean boolean protect) | Quando definido com o valor true, todos os campos desabilitados pelo método setEnabled serão protegidos e não terão seus valores salvos no registro de formulário. |
String getFormMode() | Obtém o modo de edição do formulário, podendo retornar os seguintes valores: MOD: Formulário em edição VIEW: Visualização do formulário NONE: Não há comunicação com o formulário, por exemplo, ocorre no momento da validação dos campos do formulário onde este não está sendo apresentado. |
void setHidePrintLink(boolean hide) | Quando definido com o valor true, desabilita o botão de imprimir do formulário. |
boolean isHidePrintLink() | Verifica se o botão de imprimir está desabilitado. |
Map<String, String> getChildrenFromTable(String tableName) | Retorna um mapa contendo os nomes e valores dos campos filhos de uma tabela pai. |
void setHideDeleteButton(boolean hide) | Quando definido com o valor true, desabilita o botão de excluir registros filhos em um formulário com pai-filho. |
boolean isHideDeleteButton() | Verifica se a exclusão de registros filhos está desabilitada. |
boolean getMobile() | Verifica se o registro de formulário está sendo acessado através de um dispositivo mobile. |
boolean isVisible(String fieldName) | Verifica se um campo está marcado para ser visível |
void setVisible(String fieldName, boolean visible) | Define se um campo deve estar visível ou não |
boolean isVisibleById(String id) | Verifica se um item do html está marcado para ser visível |
void setVisibleById(String id, boolean enabled) | Define se um item do html deve estar visível ou não |
...
Bloco de código | ||
---|---|---|
| ||
function enableFields(form) {
if ( form.getFormMode() != 'ADD' ){
form.setEnabled("rnc_area",false);
form. setEnabled("rnc_tipo_ocorrencia",false);
}
} |
É importante destacar que o evento ocorre no momento da renderização do formulário e é o único que permite alterar o estado de apresentação dos campos do formulário.
Outra forma de desabilitar os campos é utilizando comandos JavaScript implementados diretamente em funções do formulário. Porém, neste caso, não é permitido utilizar a propriedade disabled, pois os campos não serão gravados ao salvar o registro de formulário. Para esta situação, deve-se utilizar a propriedade readonly conforme exemplo abaixo:
Bloco de código | ||
---|---|---|
| ||
document.forms['nomeForm'].nomeCampo.setAttribute('readonly',true); |
Protegendo campos desabilitados
Ao proteger um campo desabilitado, ele não terá o seu valor alterado no registro de formulário. Para isso, informe o valor true para o parâmetro protect do método setEnabled conforme o exemplo abaixo:
Bloco de código | ||
---|---|---|
| ||
function enableFields(form) {
if ( form.getFormMode() != 'ADD' ){
form.setEnabled("rnc_cod_ocorrencia",false, true);
}
} |
Também é possível utilizar o método setEnhancedSecurityHiddenInputs, que faz com que todos os campos desabilitados pelo método setEnabled fiquem protegidos:
Bloco de código | ||
---|---|---|
| ||
function enableFields(form) {
if ( form.getFormMode() != 'ADD' ){
form.setEnhancedSecurityHiddenInputs(true);
form.setEnabled("rnc_cod_ocorrencia",false);
}
} |
Nota | ||
---|---|---|
| ||
O método setEnhancedSecurityHiddenInputs só protegerá campos desabilitados após a sua executação no evento. |
InputFields
Esse evento é disparado no momento em que os dados do formulário são passados para a BO responsável por formulário do fluig. O evento recebe como parâmetro uma referência ao formulário da definição de formulário. Exemplo:
...