sign

Appone la firma all'elenco di nodi specificato e inserisce la firma nella posizione di destinazione.

Sintassi

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

Parametri

param1

input

Un elenco di nodi XFA valido contenente tutti i nodi da firmare.

param2

input

Una stringa valida che rappresenta un'espressione di sintassi di riferimento per il nodo principale del nodo firma.

param3

input

Una stringa valida che rappresenta un valore di identificazione XML per la firma.

param4 (facoltativo)

input (facoltativo)

L'unico valore valido è open (predefinito) e indica che i nodi di dati sono aperti per la modifica e possono essere modificati in fase di esecuzione.

param5 (facoltativo)

input (facoltativo)

Indica se utilizzare o meno una finestra di dialogo per consentire all'utente di firmare il modulo.

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

  • Indica che l'operazione specificata prevede l'utilizzo di una finestra di dialogo.

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

  • Indica che l'operazione specificata non prevede l'utilizzo di alcuna finestra di dialogo. Se si specifica questo valore è necessario fornire un gestore di protezione alternativo in param6, di modo che l'applicazione che ospita il modulo possa recuperare la password e le credenziali corrette da utilizzare per la firma del modulo.

param6 (facoltativo)

input (facoltativo)

Rappresenta l'oggetto SecurityHandler utilizzato per la firma. Gli oggetti di protezione in genere richiedono l'inizializzazione prima di poter essere utilizzati per la firma. Se si imposta param5 su False è necessario specificare un valore per questo parametro.

param7 (facoltativo)

output (facoltativo)

Rappresenta un oggetto SignatureInfo di output contenente le proprietà scrivibili della firma.

Valore restituito

True se la firma è stata applicata e False se l'opzione di firma è stata annullata. Se l'operazione di firma non riesce si genera un'eccezione.

Si applica a

Versione

XFA 2.1

Esempi

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