sign

Firma una lista de nodos determinada y coloca la firma en la ubicación de destino.

Sintaxis

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

Parámetros

param1

input

Una lista de nodos XFA válida con todos los nodos que se van a firmar.

param2

input

Una cadena válida que representa una expresión de sintaxis de referencia en el elemento principal del nodo de firma.

param3

input

Una cadena válida que representa un valor de identificación XML para la firma.

param4 (opcional)

input (opcional)

El único valor válido es open (predeterminado) que indica que los nodos de datos están abiertos para ser editados y pueden manipularse durante la ejecución.

param5 (opcional)

input (opcional)

Representa si se utiliza un cuadro de diálogo para permitir al usuario firmar el formulario.

  • true | 1 (JavaScript) o 1 (FormCalc) (predeterminado)

  • Indica que se utiliza un cuadro de diálogo para esta operación.

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

  • Indica que no se utiliza un cuadro de diálogo para esta operación. Si especifica este valor, deberá proporcionar un controlador de seguridad alternativo en param6 de tal forma que la aplicación donde se aloja el formulario pueda recuperar la contraseña y los credenciales correctos para utilizarlos al firmar el formulario.

param6 (opcional)

input (opcional)

Representa el objeto SecurityHandler que se utiliza para firmar. Los objetos de seguridad suelen requerir su inicialización antes de poder utilizarlos para firmar. Deberá proporcionar un valor para este parámetro si ajusta param5 en False.

param7 (opcional)

output (opcional)

Representa un objeto de salida SignatureInfo que contiene las propiedades de la firma que admiten escritura.

Devuelve

True si la firma se ha aplicado correctamente y False si se ha cancelado la opción de firma. Se devuelve una excepción en caso de error de la operación de firma.

Aplicable a

Versión

XFA 2,1

Ejemplos

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")