xMova Android

INPUT

Versão 2.7+

Esta funcionalidade permite requerer valores ao usuário; tanto textuais como numéricos, permite também a utilização de algorítmos de geração de senhas que funcionam offline para avaliar se o usuário pode continuar a execução do fluxo ou não. Para continuar é preciso informar a senha correta. Quando é utilizada a funcionalidade com **passwordType* o valor retornado é 0 ou 1. (1 para a senha válida e 0 para a senha inválida).

Atributos:

• title : Define o título da tela que será exibida ao usuário, caso não seja informado é utilizado o nome do aplicativo. Pode conter um valor primitivo como no exemplo abaixo, valores de campo ou um valor de lang.
• text : Define a mensagem que será exibida ao usuário no topo da tela. Pode conter um valor primitivo como no exemplo abaixo, valores de campo ou um valor de lang.
• hint : Define a mensagem que será exida abaixo do campo de input. Pode conter valores primitivos, valores de campo ou um lang.
• type : Define o tipo do input, se será numérico ou textual. (Ex.: Integer, Long, Decimal, String...).
• minValue : Define o valor mínimo que o usuário deve informar para que o valor seja considerado como válido.
• maxLength: Define a quantidade máxima de caracteres que o usuário pode informar.
• mask : Define a máscara que deverá ser usada para a inserção do valor pelo usuário.
• defaultValue : Define o valor inicial que virá no input quando for solicitada a inserção do valor pelo usuário.
• decimalSize : Define a quantidade de casas decimais, quando o valor a ser inserido é do tipo decimal
• manualDecimal : Desabilita a formatação automática e apresenta o separador decimal no teclado para que o usuário possa definir quando inserir a separação decimal, quando o valor é do tipo decimal.
• password : Define que os valores digitados pelo usuário devem ser substituídos por ‘*’ para que não sejam visualizados.
• textArea : Define que será possível a inserção de quebras de linha, quando o input for textual.
• notBack: Desabilita a ação de voltar da tela
• backAfterOk : Determina que o aplicativo deve executar a ação de voltar após a inserção e confirmação do valor pelo usuário.
• passwordType : Determina qual algorítimo deve ser usado para a geração da senha que deve ser digitada pelo usuário. Valores: random, against ou counter
• passwordSeeds: Quando o tipo é against ou counter podem ser passados valores para serem usados para a geração da senha. Podem ser valores primitivos e ou valores de campo; os valores devem ser numéricos e separados por vírgula.

Langs :

• FixedKeyMsgInvalidValue : Exibida quando o valor digitado pelo usuário não atende aos requisitos de preenchimento.
• FixedKeyCommandOK : Exibida no teclado para que o usuário confirme a inserção do valor (Teclado Nativo).
• FixedKeyInputKeyboardDecimalSymbol : Usada para exibir o símbolo de separação decimal quando o input contém o atributo manualDecimal (Teclado Customizado).
• FixedKeyInputKeyboardDone : Exibida no teclado para que o usuário confirme a inserção do valor (Teclado Customizado).
• FixedKeyInputKeyboardBackspace : Exibida no teclado para que o usuário apague um valor digitado (Teclado Customizado).

Exemplo:

ApontamentoServico sync=out cleanupDays=20 notSavedMessage openFinish
      id inc
      codigoTecnico CodigoTecnico
      idOS int notFill
      codigoOS long notFormatThousand fillCondition="boletim.osIniciada == 0 && tipoApontamentoOS == %TipoCriarOS" maxLength=10
      server name=Apontamento
      fieldEvents
              onValidate
                      codigoOS
                              if codigoOS == 0
                                      toast @"Valor Inválido!"
                                      return false
                              OrdemServico os = SelectFirst FROM OrdemServico WHERE codigo == :codigoOS
                              if os != null
                                      if os.status == %TipoStatusOSAguardandoPecas
                                              toast @"OS está aguardando peça!"
                                              return false
                              if os != null
                                      if os.status == %TipoStatusOSFaturamento
                                              toast @"OS já finalizada!"
                                              return false
                              startWait
                              if os != null
                                      idOs = os.id
                                      stopWait
                                      return confirm text=custom.OSExistente
                              stopWait
                              return input title=@"Senha" text=@"Digite a senha para continuar" hint=@"Valor gerado <random_value>"  passwordType=counter passwordSeeds=codigoOs,codigoTecnico

A tag <random_value> deve ser adicionada onde deve aparecer o valor randômico gerado pelo aplicativo quando utilizando a funcionalidade de inserção de senha.