Input

Nome

Descrizione

Tipo

Opzionale

serverAddress

Indirizzo server da un Dominio esterno (per il Dominio della sessione corrente, utilizzare nullo o vuoto).

String

Y

token

Token di sessione (per la sessione corrente nel dominio corrente potrebbe essere null o vuoto).

String

Y

credentialsReference

Collegamento alle Credenziali con scope RemoteQualifiedCertificate da utilizzare per apporre il sigillo elettronico qualificato.

E' possibile specificare un collegamento con valorizzata solo la proprietà Name pari al Nickname di una credenziale esistente.

Reference

resourceReference

Collegamento alla risorsa contenente il file da firmare.

Può essere un riferimento ad un Attachment, un FileComponent, un allegato di processo, un Document o un'altra risorsa contenente attachments.

Se la risorsa è di tipo Document e contiene più componenti file viene utilizzato:

•il componente principale, se è di tipo File;

•in assenza di componente principale, deve esserci un solo componente di tipo File.

Se la risorsa contiene una lista di attachments, deve esserci un solo file.

Reference

signatureType

Tipo di firma da applicare: può essere Pades, Cades o Xades.

Se non specificato e il file è in formato PDF viene utilizzato Pades, se è in formato XML Xades, in tutti gli altri casi Cades.

String

Y

testMode

True se è richiesta l'esecuzione del metodo in modalità test. Se non specificato, viene effettuata l'esecuzione del metodo in modalità live.

Boolean

Y

Output

Nome

Descrizione

Tipo

returnValue

Restituisce un dato strutturato che contiene i seguenti campi:

•SignedDocument: collegamento al documento firmato;

•SignedDocumentName: stringa che riporta il nome completo del file firmato.

In modalità test, la firma elettronica non viene applicata al documento e viene restituito in output il medesimo file di input.

Dataset

Restituisce

Condizione

Errore

PLUG_Error

Se signatureType riporta un tipo di firma che non si applica al documento da firmare resourceReference.

Errore

PLUG_Error

Se signatureType è diverso da Pades, Xades o Cades.

Errore

PLUG_Error

Se si vuole apporre una firma elettronica xades ad un file riportato in resourceReference su cui è già apposta una firma xades.

Errore

PLUG_Error

Se il file xml che si vuole firmare non è ben formato e la firma richiesta è di tipo xades.