sign

Assina uma determinada lista de nós e coloca a assinatura no local de destino.

Sintaxe

Reference_Syntax.sign( OBJECT param1, STRING param2, STRING param3 [, STRING param4 [, BOOLEAN param5 [, OBJECT param6 [, OBJECT param7 ] ] ] ] )

Parâmetros

param1

input

Uma lista válida de nós XFA de todos os nós a serem assinados.

param2

input

Uma sequência válida que representa uma expressão da sintaxe de referência para o pai do nó de assinatura.

param3

input

Uma string válida que representa um valor de identificação XML para a assinatura.

param4 (Opcional)

input (Opcional)

O único valor válido é open (padrão) indicando que os nós de dados estão abertos para edição e podem ser manipulados no tempo de execução.

param5 (Opcional)

input (Opcional)

Representa se é usada uma caixa de diálogo para permitir que o usuário assine o formulário.

  • true | 1 (JavaScript) ou 1 (FormCalc)(padrão)

  • Indica que uma caixa de diálogo é usada para esta operação.

  • false | 0 (JavaScript) ou 0 (FormCalc)

  • Indica que uma caixa de diálogo não é usada para esta operação. Se você especificar esse valor, deve fornecer um manipulador alternativo de segurança em param6 para que o aplicativo host do formulário possa recuperar a senha e as credenciais corretas para usar quando o formulário for assinado.

param6 (Opcional)

input (Opcional)

Representa o objeto SecurityHandler usado para assinar. Em geral, objetos de segurança requerem inicialização antes de poderem ser usados para assinatura. É necessário fornecer um valor para esse parâmetro se você configurar o param5 como False.

param7 (Opcional)

output (Opcional)

Representa um objeto SignatureInfo de saída que contém as propriedades graváveis da assinatura.

Retorna

True se a assinatura tiver sido aplicada com êxito e False se a opção de assinatura tiver sido cancelada. Uma exceção será retornada se ocorrer uma falha na operação de assinatura.

Aplica-se a

Versão

XFA 2.1

Exemplos

JavaScript

//This example signs all of the form objects that currently contain data. 
var oData = xfa.resolveNode("xfa.data.form1"); 
xfa.signature.sign(oData, "xfa.data.signatures", "mySignature");

FormCalc

//This example signs all of the form objects that currently contain data. 
var oData = xfa.resolveNode("xfa.data.form1") 
xfa.signature.sign(oData, "xfa.data.signatures", "mySignature")