xml-to-pdf-automation-linux

Permette di trasformare in file pdf le fatture elettroniche xml oppure file xml.p7m scaricate dallo SDI o da chi vi fornisce il servizio di destinatario, attraverso i fogli di stile presenti nel prgramma Gestionale Open

Script di automazione da XML a PDF per Linux

Procede fondamentalmente in questo modo:

• cerca tutti i file.xml-p7m
• li trasforma in xml normali
• prende tutti i file xml presenti nella directory
• li trasforma in pdf In questo modo si hanno a disposizione sia i file xml non firmati che firmati, che file pdf da poter stampare e controllare nella contabilità

🛠️ Panoramica

Questo repository contiene uno script bash, genera_pdf.sh, progettato per automatizzare la conversione di file XML in PDF utilizzando i fogli di stile XSL su sistemi Linux. È stato scritto principalmente per il programma Gestionale Open per tanto i fogli di stile verranno cercati nella sotto cartella dell'utente in /home/utente/.wine/... Lo script è altamente flessibile e facile da usare, consentendo agli utenti di:

• Selezionare tra più fogli di stile XSLT, presenti nella directory exe del programma GestionaleOpen.
• trasformare i file xml.p7m (che sono firmati digitalmente) in file xml
• Elaborare i file da qualsiasi directory specificata.
• Produrre file PDF nella directory dei dati o in una destinazione predefinita.

Questo strumento è ideale per sviluppatori, aziende o chiunque abbia bisogno di automatizzare la trasformazione di dati XML e xml.p7m in documenti PDF dall'aspetto professionale, da un singolo file a una quantità anche annuale di file.

---

✨ Caratteristiche

• Rilevamento automatico dell'utente: Non è necessario configurare manualmente il nome utente; si adatta all'utente Linux corrente.
• Va specificato l'azienda: è necessario specificare l'azienda e la relativa directoy dove andare a salvare i file se si vuole utlizzare una directory standard.
• Percorsi di ingresso e di uscita dinamici: Supporta directory XML e XML.P7M personalizzate e posizioni di output predefinite.
• Selezione interattiva: Permette di scegliere tra una serie di fogli di stile XSLT per una maggiore flessibilità.
• Generazione di PDF: Crea automaticamente file PDF in formato A4 utilizzando wkhtmltopdf.
• Gestione degli errori: Assicura un funzionamento regolare con messaggi informativi per gli errori e i file mancanti.

---

📝 Modifiche da Effetture dall'utente

• file genera_pdf.sh : va modificato il nome della directory finale,

  1. dove documenti_XXXX corrisponde alla cartelle documenti dell'utente che utilizzate
  2. dove Fatture_elettroniche_AAAA : corrisponde alla cartella dove volete salvare le vostre fatture in formato PDF o entrambe sia XLS che PDF, oppure lasciare l'opzione $YEAR che vi genererà i file pdf nella cartella dell'anno corrente

• La riga da modificare è riga 11 corrispondente alla directoy di default.

  ../documenti_TEX9/Fatture_elettroniche_AAAA

🚀 Requisiti

Prima di eseguire lo script, assicuratevi di avere installato i seguenti strumenti:

1. xsltproc
   Per applicare le trasformazioni XSLT, serve per trasformare XML con un maschera XSL in HTML:
2. wkhtmltopdf Per trasformare da HTML a file PDF:
3. openssl per estrarre XML dai .p7m:
4. openssl-ibmpkcs11 potrebbe essere necessario se genera file pdf bianchi

🛠️ Installazione per derivate Debian

sudo apt-get install xsltproc wkhtmltopdf openssl

🛠️ Installazione per OpenSuse

Vanno installati tramite Yast i seguenti file:

• xlstproc (serve per trasformare XML con un maschera XSL in HTML)
• wkhtmltopdf (serve per trasformare un file HTML in file PDF)

per gli utenti OpenSuse effettuare la ricerca anche per tipo di file in quanto potrebbe essere contenuto il file all'interno di altre librerie/programmi

🎥 Video Dimostrativo

Guarda il video dimostrativo su [YouTube](https://www.youtube.com/watch?v=WmFyPfeM_6o.

Permessi di esecuzione

Una volta scaricato il file, vanno dati i permessi di esecuzione o graficamente come nel video oppure da terminale col comando chmod +x genera_pdf.sh dopo di che si può lanciare col comando ./genera_pdf.sh oppure creare un lanciatore sul vostro desktop come da video.

🤝 Contribuire

I contributi sono benvenuti! Sentitevi liberi di inviare una richiesta di pull o di aprire un problema per suggerire miglioramenti o segnalare bug, sarò ben lieto di modificare e migliorare questo script.