sign

Unterschreibt eine bestimmte Node-Liste und platziert die Unterschrift am Zielort.

Syntax

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

Parameter

param1

input

Eine gültige XFA-Node-Liste aller zu unterschreibenden Nodes.

param2

input

Eine gültige Zeichenfolge, die einen Referenzsyntax-Ausdruck für die übergeordnete Node der Unterschrifts-Node darstellt.

param3

input

Eine gültige Zeichenfolge, die einen XML-Kennzeichnungswert für die Unterschrift darstellt.

param4 (Optional)

Eingabe (Optional)

Der einzige gültige Wert ist open (Standard). Der Wert bedeutet, dass Daten-Nodes für die Bearbeitung geöffnet sind und zur Laufzeit geändert werden können.

param5 (Optional)

Eingabe (Optional)

Gibt an, ob ein Dialogfeld verwendet werden soll, damit der Benutzer das Formular unterzeichnen kann.

  • true | 1 (JavaScript) oder 1 (FormCalc) (Standard)

  • Gibt an, dass für diesen Vorgang ein Dialogfeld verwendet wird.

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

  • Gibt an, dass für diesen Vorgang kein Dialogfeld verwendet wird. Wenn Sie diesen Wert verwenden, müssen Sie in param6 einen alternativen Sicherheits-Handler angeben, damit die Host-Anwendung des Formulars bei der Formularunterzeichnung das korrekte Kennwort und die entsprechenden Unterschriftsberechtigungen abrufen kann.

param6 (Optional)

Eingabe (Optional)

Stellt das SecurityHandler-Objekt dar, das zum Unterschreiben verwendet wird. Sicherheitsobjekte können in der Regel erst zum Unterschreiben verwendet werden, nachdem sie initialisiert wurden. Die Angabe eines Werts für diesen Parameter ist erforderlich, wenn Sie param5 auf False setzen.

param7 (Optional)

Ausgabe (Optional)

Stellt ein SignatureInfo-Ausgabeobjekt dar, das die nicht schreibgeschützten Eigenschaften der Unterschrift enthält.

Rückgabe

True , wenn die Unterschrift erfolgreich angewendet wurde, und False , wenn die Unterschriftsoption abgebrochen wurde. Wenn beim Unterschreibvorgang ein Fehler auftritt, wird ein Ausnahmefehler zurückgegeben.

Gilt für

Version

XFA 2.1

Beispiele

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