ESign(ObjName, [Description], [Action], [From], [To], [User], [Comment])
Este método é utilizado para validar a alteração de um campo através de assinatura eletrônica. Quando este método é utilizado, a caixa de diálogo da figura a seguir é mostrada.
Caixa de Diálogo de Assinatura Eletrônica
Parâmetros do método ESign
Parâmetro |
Descrição |
|---|---|
ObjName |
Texto que contém o nome de um Tag ou outro objeto da aplicação |
Description |
Texto que contém a descrição de ObjName. Este parâmetro é opcional e, se omitido, a caixa de diálogo tenta buscar os dados da propriedade DocString de ObjName |
Action |
Texto que contém a ação a ser executada, como por exemplo "Alteração do valor". Este parâmetro é opcional e, se omitido, insere uma String vazia no campo Ação |
From |
Variant que contém o valor original ou o estado a ser alterado. Este parâmetro é opcional e, se omitido, insere uma String vazia no campo De |
To |
Variant que contém o novo valor do Tag ou o valor a ser aplicado em Action. Este parâmetro é opcional e, se omitido, insere uma String vazia no campo Para |
User |
Texto de retorno. Recebe o nome de login selecionado na caixa de diálogo. Este parâmetro é opcional e, se omitido, insere uma String vazia no campo Usuário |
Comment |
Texto de retorno. Recebe o comentário digitado na caixa de diálogo. Este parâmetro é opcional e, se omitido, insere uma String vazia no campo Comentário |
Ao clicar em 
, abre-se uma janela que permite autenticar o usuário. Se a opção Windows é selecionada, os campos Nome do usuário e Senha são automaticamente desabilitados. Clique em Outro usuário para selecionar um usuário pertencente ao domínio de rede. Caso a opção E3 seja selecionada, digite as informações de um usuário pertencente ao Domínio do Elipse Water nos campos Nome do usuário e Senha.
Login integrado
Este método retorna Verdadeiro se o usuário clica em OK, e se os campos Usuário e Senha são válidos. Caso contrário, se a caixa de diálogo é cancelada ou se o login ou a senha estiverem errados, após três tentativas o método retorna Falso. Em caso de falha, User e Comment são configurados para uma String vazia.
Os comentários pré-definidos são armazenados no Registro do Windows. Apenas os últimos 26 comentários são salvos. Cada vez que a janela é criada, os últimos comentários são buscados no Registro e usados para preencher a lista de seleção. Se um novo comentário é informado pelo usuário, este é salvo e o mais antigo é descartado, caso não haja posição livre. Se um comentário já existente é utilizado, este passa a ser o primeiro da lista de comentários mais recentes. O código a seguir contém um exemplo de uso deste método.
Sub Button1_Click()
Dim Tag, User, Comment
Set Tag = Application.GetObject("IO.Inputs.I001")
If Application.ESign(Tag.PathName, , "Alteração do Valor", _
Tag.Value, 1, User, Comment) Then
If Tag.WriteEx(1) Then
Application.TrackEvent _
"Tag IO.Inputs.I001 alterado para 1 " &_
"pelo usuário" & User, Comment
End If
End If
End Sub