Interface BaseFormEngine<D extends BaseFormData>
- All Known Subinterfaces:
FormEngine<D>,HasSubFormsEngine<D>,PanelFormEngine,SubFormEngine<D>
- All Known Implementing Classes:
AbstractBaseTaskFormPresenter.AbstractBaseFormEngine,AbstractTaskFormPresenter.AbstractTaskFormPresenterFormEngine,DefaultSubFormPresenter.MasterDetailSubFormEngine,TaskExecutionFormPresenter.TaskExecutionFormPresenterEngine
public interface BaseFormEngine<D extends BaseFormData>
Define a engine de um Formulario Instanciado
- Author:
- Eduardo Frazao
-
Method Summary
Modifier and TypeMethodDescriptionConstroi uma String informando detalhes sobre o contexto da enginebooleanclose()Caso o presenter esteja disposto em uma janela, solicita o fechamento do mesmobooleanclose(boolean forceClose) Caso o presenter esteja disposto em uma janela, solicita o fechamento do mesmovoidvoiddownloadUrl(String url) voidexecuteClientSideJavaScript(String script) Executa o comando javascript no browser host do vitruviovoidexecuteUrl(String url) formKey()Acesso ao formKeyRetorna a lista imutavel de taskIds participantes do bulk.getContextData(String key) Coleta os dados de contexto que podem ter qualquer formato ou nulo se nao existirem (ou forem realmente nulos)Field<?> Acesso a um campo de dados, via IDColeta os campos disponveis na engineHandler de output infoObtem a descricao parametrizada no formulario, ou NULL se nao for definidaObtem o nome do form associado a enginegetGlobalVariable(String key) Acessa uma variavel global definida no escopo da engine do formularioHistoricTaskInstanceAcesso ao processoLabelObtem uma referencia para o label informadoAcesso ao Wrapper de Layout, via IDObtem uma colecao de paineis identificadosUsuarioDTOAcesso ao usuario logadogetModifiedFields(String fieldId) Obtem uma relacao de todos os fields modificadosID da definicao do processoID do ProcessoAcesso as variaveis do processoTaskgetTask()Acesso a tarefa vigenteID da tarefagetValidator(String id) Obtem um validador por IDAcesso a colecao de validadoresObtem o acesso ao controlador de widget, via IDvoidhandleDebugInfo(String data) booleanhasContextData(String key) Determina se existem informacoes de contexto identificadas pela KEYdefault booleanisBulk()Determina se a engine esta operando em modo bulk (finalizacao agrupada de tarefas).booleanVerifica se a engine permite neste momento o cancelamento do formbooleanisFieldModified(String fieldId) Determina se o campo sofreu modificacao desde seu ultimo estado comitadobooleanbooleanbooleanRetorna a analise de estado se o formulario foi alterado deste o utlimo commitbooleanDetermina se a variavel global existebooleanisMobile()booleanbooleanDetermina o estado da enginebooleanbooleanisValid()Determina se a engine de formularios considera os campos validosbooleanisWeb()voidmakeResponsive(Layout l) voidvoidvoidregisterAttachmentProvider(AttachmentProvider provider) registerRepeatingTimer(int miliSeconds, Runnable runnable) Registra um timer para execucao de comandos com repeticao.registerTimerCommand(int miliSeconds, Runnable runnable) Registra um timer para execucao de um comando, uma unica vez.voidregisterValidator(String id, Validator validator) Registra dinamicamente um validador.voidsetCancelEnabled(boolean enabled) Informa para a engine se e permitido cancelar o form atualvoidsetFinishEnabled(boolean enabled) voidsetGlobalVariable(String key, Object value) Seta uma variavel com escopo na instancia do formulario vigente.voidvoidsetSaveEnabled(boolean enabled) voidsetStrictMode(boolean strict) Configura a engine em modo estrito.voidsetZoom(double zoom) voidvoidRemove a variavel do escopovoidMetodos que executam tarefas em background, podem necessitar atualizar a UI de referencia da Engine.
-
Method Details
-
getEngineUUID
String getEngineUUID() -
generateUUID
String generateUUID() -
isBulk
default boolean isBulk()Determina se a engine esta operando em modo bulk (finalizacao agrupada de tarefas).- Returns:
- true se o formulario foi aberto para finalizar multiplas tarefas simultaneamente
-
getBulkTaskIds
Retorna a lista imutavel de taskIds participantes do bulk.- Throws:
RuntimeException- se a engine nao esta em modo bulk
-
formKey
String formKey()Acesso ao formKey- Returns:
-
getFormName
String getFormName()Obtem o nome do form associado a engine- Returns:
-
getFormDescription
String getFormDescription()Obtem a descricao parametrizada no formulario, ou NULL se nao for definida- Returns:
-
getTask
Task getTask()Acesso a tarefa vigente- Returns:
-
getHistoricTask
HistoricTaskInstance getHistoricTask()Acesso ao processo- Returns:
-
getTaskId
String getTaskId()ID da tarefa- Returns:
-
getProcessInstanceId
String getProcessInstanceId()ID do Processo- Returns:
-
getProcessDefinitionId
String getProcessDefinitionId()ID da definicao do processo- Returns:
-
getLabel
Obtem uma referencia para o label informado- Parameters:
id-- Returns:
-
getField
Acesso a um campo de dados, via ID- Parameters:
fieldId-- Returns:
-
getFieldIds
Collection<String> getFieldIds()Coleta os campos disponveis na engine- Returns:
-
getLayout
Acesso ao Wrapper de Layout, via ID- Parameters:
layoutId-- Returns:
-
getLayoutIds
Collection<String> getLayoutIds()Obtem uma colecao de paineis identificados- Returns:
-
getValidators
Collection<Validator> getValidators()Acesso a colecao de validadores- Returns:
-
getValidator
Obtem um validador por ID- Parameters:
id-- Returns:
-
registerValidator
Registra dinamicamente um validador. Caso o mesmo ID já exista um erro será lançado -
isValid
boolean isValid()Determina se a engine de formularios considera os campos validos- Returns:
-
isFieldModified
Determina se o campo sofreu modificacao desde seu ultimo estado comitado- Parameters:
fieldId-- Returns:
-
getModifiedFields
Obtem uma relacao de todos os fields modificados- Parameters:
fieldId-- Returns:
-
isFormModified
boolean isFormModified()Retorna a analise de estado se o formulario foi alterado deste o utlimo commit- Returns:
-
getLoggedUser
UsuarioDTO getLoggedUser()Acesso ao usuario logado- Returns:
-
getWidgetController
Obtem o acesso ao controlador de widget, via ID- Parameters:
id-- Returns:
- Controlador do Widget ou Nulo caso nao exista
-
getProcessVariables
Acesso as variaveis do processo- Returns:
-
setGlobalVariable
Seta uma variavel com escopo na instancia do formulario vigente. Essa variavel nao sera persistida- Parameters:
key-value-
-
unsetGlobalVariable
Remove a variavel do escopo- Parameters:
key-
-
isGlobalVariableSet
Determina se a variavel global existe- Parameters:
key-- Returns:
-
getGlobalVariable
Acessa uma variavel global definida no escopo da engine do formulario- Parameters:
key-- Returns:
-
hasContextData
Determina se existem informacoes de contexto identificadas pela KEY- Parameters:
key-- Returns:
-
getContextData
Coleta os dados de contexto que podem ter qualquer formato ou nulo se nao existirem (ou forem realmente nulos)- Parameters:
key-- Returns:
-
setCancelEnabled
void setCancelEnabled(boolean enabled) Informa para a engine se e permitido cancelar o form atual- Parameters:
enabled-
-
isCancelEnabled
boolean isCancelEnabled()Verifica se a engine permite neste momento o cancelamento do form- Returns:
-
setSaveEnabled
void setSaveEnabled(boolean enabled) -
isSaveEnabled
boolean isSaveEnabled() -
setFinishEnabled
void setFinishEnabled(boolean enabled) -
isFinishEnabled
boolean isFinishEnabled() -
debug
-
commitAndGetFormData
D commitAndGetFormData() -
getFormData
D getFormData() -
registerRepeatingTimer
Registra um timer para execucao de comandos com repeticao. E responsabilidade de quem invocar este metodo da engine controlar a parada do timer, exceto se a interface for desligada, quando a engine ira interromper automaticamente- Parameters:
miliSeconds-runnable-- Returns:
-
registerTimerCommand
Registra um timer para execucao de um comando, uma unica vez. Este timer nao devera ser reusado pois ele sera destruido assim que o comando for executado- Parameters:
miliSeconds-runnable-- Returns:
-
updateUI
Metodos que executam tarefas em background, podem necessitar atualizar a UI de referencia da Engine. Neste caso, qualquer atualizacao deve ser realizada dentro de um bloco seguro que pode locar a interface para garantir o correto envio das alteracoes para o Browser- Parameters:
runnable-
-
close
boolean close()Caso o presenter esteja disposto em uma janela, solicita o fechamento do mesmo- Returns:
- se a janela foi fechada
-
close
boolean close(boolean forceClose) Caso o presenter esteja disposto em uma janela, solicita o fechamento do mesmo- Parameters:
forceClose- fecha o presenter ignorando qualquer confirmacao que possa ser necessaria- Returns:
- se o presenter foi fechado
-
executeClientSideJavaScript
Executa o comando javascript no browser host do vitruvio- Parameters:
script-
-
setStrictMode
void setStrictMode(boolean strict) Configura a engine em modo estrito.- Parameters:
strict- - Quando falso (padrao), a engine sera leniente com chamadas de metodo problematicas, como coletar fields que nao existem, etc
-
isStrictMode
boolean isStrictMode()Determina o estado da engine- Returns:
-
isMobile
boolean isMobile() -
isWeb
boolean isWeb() -
isTouchDevice
boolean isTouchDevice() -
setZoom
void setZoom(double zoom) -
buildEngineContextInfo
String buildEngineContextInfo()Constroi uma String informando detalhes sobre o contexto da engine- Returns:
-
getFormDebugMode
FormDebugMode getFormDebugMode()Handler de output info -
getFormDebugOutput
FormDebugOutput getFormDebugOutput() -
getFormDebugFormat
FormDebugFormat getFormDebugFormat() -
handleDebugInfo
-
isForInitialized
boolean isForInitialized() -
openUrl
-
executeUrl
-
downloadUrl
-
openUrlCurrentWindow
-
registerAttachmentProvider
-
unregisterAttachmentProvider
-
getAttachmentProviders
Collection<AttachmentProvider> getAttachmentProviders() -
makeResponsive
void makeResponsive(Layout l) -
setResponsiveMobile
void setResponsiveMobile()
-