WkfStateActionHelp.doc.stamp pdf

Azione di workflow "Timbratura PDF (doc/stamp_pdf)" che permette la timbratura PDF di uno o più documenti lato server senza richiedere interazione con l'utente. L'azione prende in input un elenco di pkid di documenti di repository e li timbra. In caso di documento firmato CAdES viene timbrato il documento originale. Se i documenti non sono in formato PDF ne viene eseguita la conversione in PDF, qualora il formato sia convertibile in PDF. In caso di formato non convertibile in PDF l'azione va in errore sollevando un'eccezione. Esempio di eccezione: "Il documento 'DOCUMENTO DI PROVA.zip' è in un formato non convertibile in PDF, pertanto non può essere timbrato."

INPUT

L'azione richiede in input anche una configurazione di timbro e un'eventuale suo posizionamento. Entrambe le configurazioni vengono memorizzate all'interno dell'azione di workflow. Opzionalmente è possibile indicare il nome di un DAC e relativo pkid da utilizzarsi come sorgente dati per estrarre informazioni da utilizzare nel timbro. In maniera simile a quanto avviene nella stampa copia, vengono utilizzati gli stessi datasource utilizzati per la compilazione dei modelli associati a quel DAC (DocModelDescriptor e DocModelDataSource). Oltre alle informazioni fornite dal DAC sono sempre disponibili per la compilazione del timbro le seguenti informazioni:

- numero di pagina

- numero totale pagine

- nome del documento timbrato

- descrizione del documento timbrato

- impronta SHA-256 del documento

- data odierna

e nel caso il file sia firmato:

- firmatario

- firmatario con data e ora di firma

OUTPUT

L'azione produce per default in uscita dei nuovi documenti di repository con il risultato della timbratura. I documenti timbrati vengono inseriti nella stessa libreria di repository del rispettivo documento originale. E' inoltre possibile indicare all'azione di non produrre dei nuovi documenti di repository, ma di sostituire il contenuto del documento originale con il contenuto del documento timbrato. Per farlo è necessario indicarlo accendendo la spunta "sovrascrive il contenuto dei documenti in ingresso" in fase di configurazione. In questo caso in output all'azione verranno riportati gli stessi pkid dei documenti passati in ingresso.

NOTA: in quest'ultimo caso se la libreria di repository è stata opportunamente configurata per gestire le versioni, sarà generata una nuova versione del documento originale.

Esempi di DAC Class name da usare:

Documento generico: it.saga.library.gestioneDocumentale.flows.DocDACDocumenti

Protocollo: it.saga.pubblici.protocollo.ProDACProtocollo

Per gli atti, non si deve usare il prefisso generico "Dlb" poiché non viene risolto, ma quelli specifici, ad esempio:

(serve in fase di progettazione per avere gli attributi corretti, altrimenti non vengono caricati dall'interfaccia)

Verbale Giunta: it.saga.pubblici.delibere.DlgDACVerbale

Verbale Consiglio: it.saga.pubblici.delibere.DlcDACVerbale

Proposta Giunta: it.saga.pubblici.delibere.DlgDACProposta

Proposta Consiglio: it.saga.pubblici.delibere.DlcDACProposta

Determina it.saga.pubblici.delibere.DetDACProposta

STAMPIGLIATURA

Con la issue SJIRDOC-3140 è stato introdotto il concetto di stampigliatura, utilizzabile solo tramite questa azione di workflow, che permette di apporre delle stampigliature su di un file PDF firmato (in formato PAdES) senza invalidarne le firme.

Questa modalità di timbratura non è così flessibile come i timbri PDF che sono ad oggi supportati, ma permette solamente di apporre una stampigliatura testuale su singola riga senza la possibilità di eseguire operazioni di rotazione o scala del timbro. Deve essere inoltre utilizzata singolarmente, senza la possibilità di raggruppare varie timbrature in gruppi di righe disposte in verticale o in orizzontale. Quindi sintetizzando con questo tipo di timbratura è possibile apporre solamente una stampigliatura su singola riga per ogni timbrata, senza possibilità di avere bordi, riquadri e rotazioni.

Al momento l'unico modo di creare un nuovo timbro di questo tipo è quello di partire dal template allegato alla issue SJIRDOC-3140: timbro_annotation.stamp , e solamente sulla action di workflow "Timbratura PDF" (doc/stamp_pdf).

Per la composizione del testo da inserire nel timbro le funzionalità sono le stesse utilizzate dalla vecchia modalità di timbratura: è possibile scrivere una formula utilizzando le stesse variabili messe a disposizione dai datasource di timbratura esistenti. Dal punto di vista della configurazione le opzioni sono le medesime dell'elemento testuale classico: testo, dimensione, colore, font.

La peculiarità di questo metodo di timbratura è che non invalida le firme nei documenti PDF sottoscritti con firma PAdES, per cui questo tipo di timbratura introduce una differenza sostanziale su come sono gestiti i documenti firmati con firma PAdES. Per questi documenti non viene più timbrato il documento originale, ma viene timbrato direttamente il documento PDF originale firmato.

NOTA BENE:

se applico un timbro classico, su un file PADES che ha una stampigliatura, inevitabilmente avrò un file con il timbro classico, ma senza la stampigliatura. Questo poiché usando il timbro classico, esso viene applicato sul file nudo e crudo, privato di tutte le revisioni, e anche la stampigliatura, così come la firma pades stessa, è di fatto una revisione