padosoft/tessera-sanitaria

Export delle prestazioni mediche per il servizio nazionale sanità secondo il formato XML della tessera sanitaria DM 31/07/2015.

PROGETTO TESSERA SANITARIA

![Software License][ico-license] ![HHVM Status][ico-hhvm-status] ![Coverage Status][ico-scrutinizer] ![Total Downloads][ico-downloads] , _(*1)

Il package permette la creazione di file XML delle prestazioni mediche per il servizio nazionale sanità secondo il formato XML della tessera sanitaria definito nel DM 31/07/2015. Per maggiori info si veda il Portale della Tessera Sanitaria: http://sistemats1.sanita.finanze.it/wps/portal/, _(*2)

Table of Contents

• PROGETTO TESSERA SANITARIA
• Table of Contents
• PREREQUISITI
  • INSTALLAZIONE OPENSSL
    • Windows
    • Linux
  • GENERAZIONE CERTIFICATO E CHIAVE PUBBLICA
    • Windows
    • Linux
    • Comandi da eseguire
  • CONFIGURAZIONE
    • Enviroment
    • Permission folder
• CHANGE LOG
• USO DELLA LIBRERIA
  • ESEMPIO BASE
  • OUTPUT
    • Output a video
    • Creazione File
  • VALIDAZIONE
• ESEMPIO COMPLETO
  • Screenshot esempio
• Contributing
• Security
• Credits
• About Padosoft
• License

PREREQUISITI

PHP 5.4+ OpenSSL, _(*3)

INSTALLAZIONE OPENSSL

Windows

Scaricare l'eseguibile da https://slproweb.com/products/Win32OpenSSL.html , lanciarlo e seguire le istruzioni a video., _(*4)

Linux

OpenSSL é già installato di default in tutte le principali distribuzioni. Eventualmente, controllare la versione tramite il comando:, _(*5)

``` bash openssl version, <sub>(*6)</sub>

se non aggiornata, lanciare i comandi:
``` bash
apt-get update && apt-get upgrade

apt-get install openssl

GENERAZIONE CERTIFICATO E CHIAVE PUBBLICA

Collocare i file del certificato e delle chiavi nella directory specificata nella classe PathHelper (default: /tests/certificates)., <sub>(*7)</sub>

Se non in possesso dei file ufficiali del ministero, è possibile crearli a scopo di test della libreria seguendo le istruzioni seguenti:, <sub>(*8)</sub>

Windows

Lanciare il comando dal prompt DOS posizionandosi nella directory dove si trova openssl, di default C:\OpenSSL-Win32\bin, <sub>(*9)</sub>

Linux

Non é necessario spostarsi nel path, in quanto openSSL dovrebbe essere già essere disponibile all'avvio della shell., <sub>(*10)</sub>

Comandi da eseguire

generazione chiave privata ``` bash openssl genrsa -out test.key 1024, <sub>(*11)</sub>

generazione chiave pubblica
``` bash
openssl rsa -in test.key -out test.pub -pubout

generazione certificato
``` bash openssl req -new -x509 -out test.crt -key test.key -days 30, <sub>(*12)</sub>

Vedere anche http://www.programmazione.it/index.php?entity=eitem&idItem=36568

## CONFIGURAZIONE

### Enviroment
Rinominare il file **.env.example** in **.env**
aprirlo con un editor di testo e impostare le variabili:
Esempio Windows:

    TMP_PATH = "c:/xampp/htdocs/tessera-sanitaria/tests/tmp/";
    CERT_FILE = "c:/xampp/htdocs/tessera-sanitaria/tests/certificates/test.crt";
    OPENSSL_EXE_PATH = "c:/OpenSSL-Win32/bin/";

Esempio Linux:

    TMP_PATH = "/var/www/html/tessera-sanitaria/tests/tmp/";
    CERT_FILE = "/var/www/html/tessera-sanitaria/tests/certificates/test.crt";
    OPENSSL_EXE_PATH = "";

### Permission folder
Rendere queste directory scrivibili da php:
``` bash
chmod -R 777 /var/www/html/padosoft/tessera-sanitaria/tests/tmp/
chmod -R 777 /var/www/html/padosoft/tessera-sanitaria/tests/output/
chmod -R 777 /var/www/html/padosoft/tessera-sanitaria/tests/log/
chmod -R 777 /var/www/html/padosoft/tessera-sanitaria/vendor/luminous/luminous/cache/

CHANGE LOG

Please see CHANGELOG for more information what has changed recently., <sub>(*13)</sub>

USO DELLA LIBRERIA

INSTALLAZIONE DEL PROGETTO

Per installare il progetto con il demo, andare nella directory del proprio web server, e lanciare il comando:, <sub>(*14)</sub>

``` bash composer create-project padosoft/tessera-sanitaria --dev, <sub>(*15)</sub>

Supponendo un installazione su windows con XAMPP:

``` bash
cd C:\xampp\htdocs
composer create-project padosoft/tessera-sanitaria --dev

a questo punto è possibile visitare l'url http://localhost/tessera-sanitaria/tests/index.php e visualizzare la pagina demo., <sub>(*16)</sub>

ESEMPIO BASE

L'utilizzo base del pacchetto, al netto del caricamento delle dipendenze, prevede l'istanza della classe per il tracciato, il passaggio dei dati necessari alla creazione dell'XML e il successivo recupero del codice in una variabile di tipo stringa: ``` php // Istanzia la classe per il tracciato $objTracciato = new Tracciato($objValidateHelper);, <sub>(*17)</sub>

// Crea XML $rispostaTracciato = $objTracciato->doTracciato($codiceRegione, $codiceAsl, $codiceSSA, $cfProprietario, $pIva, $arrSpesa, $arrVociSpesa);, <sub>(*18)</sub>

// Recupera l'XML creato $strXML = $objTracciato->getXml();, <sub>(*19)</sub>

Successivamente, la stringa ricavata potrà essere usata per:

- Stampare direttamente il codice a video
- Creazione file XML
- Creazione file XML compresso

tramite vari metodi analizzati nel successivo paragrafo "Output".

## OUTPUT

La stringa XML recuperata dal metodo getXml() della classe Tracciato può essere utilizzata nei seguenti modi:

### Output a video

I metodi della classe PrintHelper stampano a video il codice XML generato.
Servendosi della libreria Luminous (https://github.com/markwatkinson/luminous) , il codice viene formattato tramite un'interfaccia chiara ed esteticamente gradevole.
``` php
// Stampa header template html
PrintHelper::printHtmlHeader();

// Recupera l'esito e gli eventuali errori
PrintHelper::printError($objTracciato, $logger, $objValidateHelper);

// Stampa l'XML formattato
PrintHelper::printXML($strXML);

// Stampa comandi
PrintHelper::printButton();

// Stampa html footer
PrintHelper::printHtmlFooter();

Creazione File

La classe IOHelper permette di trasformare la stringa XML nel corrispondente file, sia in versione estesa che compressa. I due metodi che si occupano di queste operazioni sono i seguenti: ``` php // Salva XML su file IOHelper::outputFile($strXML, $pathOutput, $basePath);, <sub>(*20)</sub>

// Crea lo zip al volo e salva su $destinationZip IOHelper::zipFileOntheFly($pathOutput, $destinationZip, $strXML); ```, <sub>(*21)</sub>

VALIDAZIONE

La validazione dei dati passati al metodo doTracciato avviene in modo trasparente per l'utente, tramite la classe ValidateHelper richiamata dal metodo stesso. I parametri di validazione si basano sul documento ufficiale fornito dal ministero della sanità: http://sistemats1.sanita.finanze.it/wps/wcm/connect/487b0bba-6a65-42f9-8b43-2fb907fe7e91/730+Schema+dati+spesa+sanitaria+(28_09_2015)_v2.pdf?MOD=AJPERES&CACHEID=487b0bba-6a65-42f9-8b43-2fb907fe7e91, <sub>(*22)</sub>

ESEMPIO COMPLETO

Un esempio esaustivo di tutte le funzionalità summenzionate si trova in /tests/index.php , che carica anche tutte le dipendenze necessarie. Tutti i precedenti esempi di codice sono stati ricavati da questo file., <sub>(*23)</sub>

Screenshot esempio

Uno screenshot di esempio si trova nella cartella resources/img , <sub>(*24)</sub>

Contributing

Please see CONTRIBUTING and CONDUCT for details., <sub>(*25)</sub>

Security

If you discover any security related issues, please email instead of using the issue tracker., <sub>(*26)</sub>

Credits

• Lorenzo Padovani
• Raffaele Masi
• All contributors

About Padosoft

Padosoft is a software house based in Florence, Italy. Specialized in E-commerce and web sites., <sub>(*27)</sub>

License

The MIT License (MIT). Please see License File for more information., <sub>(*28)</sub>