Scripts

<< Clique para Mostrar o Sumário >>

Navegação:  Gerenciamento de Aplicações > Páginas e Controles > Form >

Scripts

Os scripts no Elipse Mobile Server são escritos em JavaScript. Os parâmetros globais disponíveis para acesso via scripts em um Formulário estão descritos na tabela a seguir.

Parâmetros de um script em um Formulário

Parâmetro

Descrição

state

Estado do Formulário. Os valores possíveis para este parâmetro são 0: Pendente, 1: Atribuído, 2: Finalizado ou 3: Aprovado

assignedUser

Nome do usuário atribuído a este Formulário

user

Nome do usuário responsável pela última alteração neste Formulário

timestamp

Data e hora da última atualização neste Formulário

fields

Campos deste Formulário

 

Para acessar os parâmetros descritos anteriormente, use o formato do exemplo a seguir.

WriteTag("demo:TagInterno1",
  form.assignedUser,
  function(er) {
});

 

Os campos de um Formulário, no parâmetro fields, contêm a propriedade id, que é o código interno do campo, a propriedade notes, para o caso de campos com anotações adicionais, a propriedade value, que é o valor do campo, e a propriedade timestamp, que é a data e hora da última atualização do campo. O acesso às propriedades de um campo deve ser realizado conforme o exemplo a seguir.

WriteTag("demo:TagInterno1",
  form.fields.campo1.value,
  function(er) {
});

 

Quando uma resposta é criada em um Formulário, um evento OnChange é disparado no servidor. Este evento pode ser usado para validar um Formulário, copiar os dados para um outro sistema ou enviar um e-mail notificando da alteração de um Formulário, conforme o exemplo a seguir.

function OnChange(form) {
  //Se o parâmetro state é igual a 2,
  //O valor do campo é escrito no TagInterno1
  if (form.state == 2) {
    WriteTag("demo:TagInterno1",
      form.fields.campo1.value,
      function(er) {}
    );
  }
}

 

Para criar um script de agendamento de criação de um Formulário em um dia específico, por exemplo, siga estes procedimentos em uma Conexão do tipo Demo.

1.Selecione a aba Eventos Eventos e clique em Adicionar Adicionar.

2.Selecione o item Script.

3.Digite um nome para o evento.

4.Na opção Condição, digite a expressão a seguir.

(new Date(ValueOf("demo:_now"))).getDay() == 5

 

5.A expressão anterior cria um novo objeto Date do JavaScript a partir do Tag _now e compara com o valor 5 (cinco, sexta-feira).

 

NOTA

Para mais informações sobre o objeto Date do JavaScript, consulte a documentação na Rede de Desenvolvedores da Mozilla (MDN).

 

6.Na opção Script, digite o código a seguir.

SendMail("usuario",
  "Preenchimento Form",
  "Mensagem",
  function(er) {
});

 

7.Este script é executado quando o evento entra na condição verdadeira, ou seja, quando o dia da semana é sexta-feira. Em todos os outros dias o script não é disparado.