API di piattaforma > JamioPlug > JamioPlug Document Automation

Converte un file PDF in uno specifico sottoformato PDF (ad esempio PDF/A, PDF/X, etc.). In fase di conversione è possibile aggiungere al pdf ottenuto eventuali allegati disponibili come collegamenti in Jamio openwork.

Metodo

PlugDocumentAutomation /ConvertPdfToSubtype

Input
Nome	Descrizione	Tipo	Opzionale
serverAddress	Indirizzo del server per domini esterni (o "" per il dominio corrente)	String	Y
token	Il token di sessione (per la sessione corrente nel dominio corrente potrebbe essere null o vuoto)	String	Y
pdfFile	Collegamento al file in formato PDF che si deve convertire.	Reference
pdfSubtype	Sottoformato pdf che si desidere ottenere. Se non specificato il valore predefinito è PDF_A_2U.	PdfSubtypes	Y
attachmentStreams	Lista opzionale di collegamenti che si desidera inserire come allegati nel file pdf.	List of reference	Y
attachmentFilenames	Lista opzionale di nomi che si desidera assegnare gli allegati del file pdf. Valida solo per il sottoformato PDF_A_3A.	List of string	Y
Output
Nome	Descrizione	Tipo	Opzionale
returnValue	Collegamento all'allegato di processo che contiene il file convertito nel sottoformato PDF.	Reference

Commenti

Per poter convertire il file PDF passato al parametro pdfFile in uno specifico sottoformato PDF/A è necessario che esso soddisfi delle condizioni utili ad ottenere il sottoformato di destinazione. Pertanto il file PDF prima di essere convertito è sottoposto a verifica. Il metodo ConvertPdfToSubtype utilizza Adobe Preflight per verificare se un file PDF è valido per essere convertito in PDF/A. Se la verifica va a buon fine, il metodo restituisce il file atteso, diversamente il metodo restituisce un errore. In generale, in caso di problemi di conversione dei contenuti del PDF di partenza, si è scelto di far applicare per quanto possibile correzioni automatiche, piuttosto che ottenere errore.

Alcune note sulla conversione:

1) durante la conversione alcune caratteristiche del PDF di partenza possono essere rimosse perché incompatibili col formato di destinazione (trasparenze, ecc.);

2) i font non incorporati nel PDF di partenza, se non presenti sulla macchina al momento della conversione, vengono sostituiti con "Arial";

3) si può convertire nel formato PDF_A_3A anche un PDF che contiene già degli allegati, che verranno mantenuti nel PDF convertito (in formati diversi dal PDF_A_3A generalmente gli allegati verranno rimossi durante la conversione);

4) gli allegati eventualmente aggiunti al PDF durante la conversione, nel caso del formato PDF_A_3A, mostrano "Dimensione" = zero e "Modificato" = "Sconosciuto/a" nella finestra allegati del reader, ma vengono esportati correttamente;

5) nel caso del formato PDF_A_3A si possono aggiungere allegati al momento della conversione anche in aggiunta a quelli eventualmente già presenti nel PDF iniziale (anche file con lo stesso nome); vale comunque il punto 4).