Gli oggetti del mondo Jamio > I tipi strutturati

Definisce le impostazioni per l'apposizione di firme elettroniche che devono rispondere a determinate caratteristiche.

Il tipo è una struttura composta da alcune proprietà comuni ed altre specifiche per la tipologia di firma. Ad esempio, per le firme visibili sono disponibili due specializzazioni di questa proprietà:

•AdHocSignatureSettings, che definisce il punto specifico di un documento in cui apporre la firma elettronica visibile (firma di tipo pades);

•AutoplaceSignatureSettings, che permette l'apposizione automatica della firma elettronica visibile in maniera ricorsiva, come ad esempio per l'apposizione di molteplici firme all'interno di contratti. Il punto in cui deve essere visualizzata la firma viene individuato dalla presenza di una stringa riportata nel documento in ogni specifico punto in cui si deve firmare, un esempio di stringa può essere "Firma del contraente". La Firma digitale automatica ha ampie applicazioni nella vita quotidiana, soprattutto per le aziende e per gli uffici della Pubblica Amministrazione, che si ritrovano a dover gestire e smaltire un gran numero di documenti informatici ogni giorno.

Le proprietà comuni sono:

Nome	Descrizione	Tipo
Parametri generali
PageNumber	Numero di pagina del documento in cui apporre la firma. Il valore di default è 0, assume significati diversi a seconda della modalità di apposizione della firma nel documento (vedasi commenti proprietà specifiche AdHocSignatureSettings e AutoplaceSignatureSettings)	Integer
Width	Larghezza del riquadro di firma, espressa in centimetri. Il valore di default è 0.	Float
Height	Altezza del riquadro di firma, espressa in centimetri. Il valore di default è 0.	Float
Parametri relativi al contenuto testuale della firma visibile
SignatureTitle	Testo che riporta eventuale titolo per il riquadro di firma.	String
SignerName	True se il nome del firmatario deve essere visualizzato. Il valore di default è False.	Boolean
SignerCf	True se il codice fiscale del firmatario deve essere visualizzato. Il valore di default è False.	Boolean
SignTime	True se le informazioni cronologiche della firma devono essere visualizzate. Il valore di default è False.	Boolean
SignerEmail	True se l'indirizzo e-mail del firmatario deve essere visualizzato. Il valore di default è False.	Boolean
SignerPhone	True se il numero di telefono del firmatario deve essere visualizzato. Il valore di default è False.	Boolean
Parametri relativi al contenuto grafico della firma visibile
HandSignature	True indica che è presente una parte grafica della firma (immagine del logo o della firma manuale), collegata alla proprietà Signature dell'Identità associata al certificato di firma (definibile tramite il metodo SetSignature) in caso di elementi organizzativi il file deve essere inserito in un campo custom. Se False, vengono ignorate le proprietà che seguono e impostato il valore del parametro PdfProportionBitmapText a 0. Il valore di default è False.	Boolean
Orientation	Sigla che indica se la grafica si sviluppa in orizzontale o verticale. Può assumere solo i valori H (horizontal) e V (vertical). Il valore di default è H. Le combinazioni con i valori del parametro TextAfter sono illustrate negli esempi qui sotto.	String
TextAfter	True se il testo segue la parte grafica della firma. Il valore di default è False.	Boolean
PdfBackgroundImage	Collegamento al file immagine da utilizzare come sfondo della firma. Può essere un riferimento ad un Attachment, un FileComponent, un allegato di processo, un Document o un'altra risorsa contenente Attachment. 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 allegati, solo uno deve essere di tipo File.	Reference
PdfProportionBitmapText	Percentuale del riquadro di firma da utilizzare per la parte grafica. Può assumere valori da 0 a 100. Se il parametro HandSignature è False, assume valore 0, se HandSignature è True il valore di default è 50.	Integer

Se la firma da apporre è di tipo visibile, oltre a queste proprietà comuni, vanno valorizzate quelle specifiche relative alle indicazioni di come apporla relativamente al documento:

1) se la firma deve essere applicata in punto specifico della pagina di un documento, vanno specificate le coordinate X e Y della posizione dell'angolo superiore sinistro del rettangolo di firma rispetto alla pagina di un documento, utilizzando il tipo AdHocSignatureSettings, che è una struttura composta dalle seguenti proprietà:

Nome

Descrizione

Tipo

OriginX

Definisce la coordinata X (espressa in cm) del punto della pagina del documento in cui verrà applicata la firma.

Il margine inferiore sinistro della pagina corrisponde a X = 0.

Float

OriginY

Definisce la coordinata Y, espressa in cm, rispetto alla pagina del documento in cui verrà applicata la firma.

Il margine inferiore sinistro della pagina corrisponde a Y = 0.

Float

I valori delle coppie di coordinate devono essere maggiori o uguali a 0. E' ammessa solo la coppia (-1,-1) per indicare il posizionamento della firma nell'angolo in basso a destra, indipendentemente dalla misura in centimetri della pagina.

Per quanto riguarda l'indicazione della pagina in cui apporre la firma, è necessario valorizzare la proprietà PageNumber delle proprietà comuni, in particolare, il valore di default 0 indica che la firma deve essere apposta sulla prima pagina.

2) se la firma deve essere applicata ricorsivamente in seguito alla ricerca di una stringa nel testo del documento da firmare, vanno specificate le proprietà del tipo AutoplaceSignatureSettings

Il tipo è una struttura composta dalle seguenti proprietà:

Nome	Descrizione	Tipo
PointText	Specifica la stringa che deve essere ricercata nel documento per posizionare il rettangolo di firma	String
RelatedPosition	Specifica il posizionamento del rettangolo di firma, rispetto al rettangolo che circoscrive la stringa di testo. Può assumere i valori: •TL (top-left); •T (top); •TR (top-right); •DL (down-left); •D (down); •DR (down-right); •L (left); •R (right); •C (center). Il valore di default è TR.	String
Overlap	True se il rettangolo di firma deve coprire il rettangolo della stringa di testo. E' sempre True se il parametro RelatedPosition assume il valore C.	Boolean

Per quanto riguarda l'indicazione della pagina in cui apporre la firma, va valorizzata la proprietà PageNumber delle proprietà comuni, in particolare, il valore di default 0 indica che la firma deve essere apposta su tutte le pagine che contengono la stringa di riferimento (PointText), se viene specificato il numero di una pagina, verranno apposte le firme in relazione alle sole stringhe di riferimento contenute nella pagina specificata.

E' possibile apporre ricorsivamente un massimo di 50 firme in un singolo documento.

Esempio 1

Di seguito alcuni esempi di posizionamento della firma rispetto alla stringa di riferimento (indicata nella proprietà PointText) "Firma del cliente":

Esempi di apposizioni di firma visibile con autoplace

Se Overlap è True, il valore assegnato a RelatedPosition indica quali bordi del rettangolo di firma e della stringa PointText devono sovrapporsi. Ad esempio, se Overlap è True e il valore indicato in RelatedPosition è DL, vengono sovrapposti i bordi inferiori e a sinistra dei due rettangoli.

Se Overlap è False, il valore assegnato a RelatedPosition indica la posizione del rettandolo di firma rispetto alla stringa PointText. Ad esempio, se Overlap è False e il valore indicato in RelatedPosition è DL, il posizionamento del rettangolo di firma rispetto alla stringa è in basso a sinistra.

Esempio 2

Di seguito alcuni esempi di impostazioni per la visualizzazione dell'immagine grafica della firma insieme alle informazioni testuali.

E' stata utilizzata l'apposizione della firma tramite autoplace con il parametro PointText valorizzato con la stringa "Firma", le informazioni testuali da visualizzare sono il nome e cognome e la data di apposizione della firma e l'immagine della firma associata all'identità Jamio