パドソフト/テッサ・サニタリア

国家健康サービス用の医療サービスのエクスポート、2015年7月31日の医療証のXMLフォーマットに従っています。

1.0.5 2016-01-23 16:09 UTC

This package is auto-updated.

Last update: 2024-09-22 07:41:41 UTC


README

Latest Version on Packagist Software License Build Status HHVM Status Coverage Status Quality Score Total Downloads SensioLabsInsight

このパッケージは、2015年7月31日に定義された医療証のXMLフォーマットに従って、国家健康サービス用の医療サービスのXMLファイルを作成することができます。詳細については、医療証ポータルを参照してください:http://sistemats1.sanita.finanze.it/wps/portal/

目次

前提条件

PHP 5.4+ OpenSSL

OpenSSLのインストール

Windows

https://slproweb.com/products/Win32OpenSSL.htmlから実行ファイルをダウンロードし、実行し、ビデオインストラクションに従ってください。

Linux

OpenSSLは、主要なディストリビューションのすべてでデフォルトでインストールされています。必要に応じて、コマンドでバージョンを確認してください

openssl version

更新されていない場合、以下のコマンドを実行します

apt-get update && apt-get upgrade

apt-get install openssl

公開鍵と私钥の生成

証明書とキーファイルを、PathHelperクラスで指定されたディレクトリ(デフォルト:/tests/certificates)に配置します。

公式の省庁のファイルを持っていない場合、以下の手順に従ってテスト用のファイルを作成することができます

###Windows opensslが存在するディレクトリ(デフォルト:C:\OpenSSL-Win32\bin)に移動して、コマンドプロンプトからコマンドを実行します

###Linux シェルの起動時に既にopenSSLが利用可能であるため、パスに移動する必要はありません。

実行するコマンド

私钥の生成

openssl genrsa -out test.key 1024

公開鍵の生成

openssl rsa -in test.key -out test.pub -pubout

証明書の生成

openssl req -new -x509 -out test.crt -key test.key -days 30

http://www.programmazione.it/index.php?entity=eitem&idItem=36568も参照してください

設定

環境

ファイル.env.exampleを.envに改名し、テキストエディタで開き、変数を設定します。例: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/";

例:Linux

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

パーミッションフォルダ

これらのディレクトリをPHPで書き込み可能にします。

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/

変更履歴

最近の変更に関する詳細については、変更履歴を参照してください。

ライブラリの使用法

プロジェクトのインストール

デモと一緒にプロジェクトをインストールするには、ウェブサーバーのディレクトリに移動して、以下のコマンドを実行します

composer create-project padosoft/tessera-sanitaria --dev

Windows上のXAMPPでインストールされていると仮定します

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

この段階で、https:///tessera-sanitaria/tests/index.phpのURLにアクセスして、デモページを表示することができます。

基本的な例

依存関係のロードを除いた基本的なパッケージの使用には、トラッキングクラスのインスタンス、XML作成に必要なデータの渡し、そして文字列変数に結果を取得する手順が含まれます

// Istanzia la classe per il tracciato
$objTracciato = new Tracciato($objValidateHelper);

// Crea XML
$rispostaTracciato = $objTracciato->doTracciato($codiceRegione, $codiceAsl, $codiceSSA, $cfProprietario, $pIva, $arrSpesa, $arrVociSpesa);
    
// Recupera l'XML creato
$strXML = $objTracciato->getXml();

その後、取得した文字列は以下のために使用できます

  • 直接ビデオにコードを出力
  • XMLファイルの作成
  • 圧縮されたXMLファイルの作成

次の「出力」パラグラフで説明される様々なメソッドを通じて。

出力

从Tracciato类的getXml()方法中获取的XML字符串可以用以下方式使用

ビデオ出力

PrintHelper类的方法将生成的XML代码打印到屏幕上。通过使用Luminous库(https://github.com/markwatkinson/luminous),代码通过一个清晰且美观的界面进行格式化。

// 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();

ファイルの作成

IOHelper类允许将XML字符串转换为相应的文件,无论是扩展版本还是压缩版本。处理这些操作的两个方法如下

// Salva XML su file
IOHelper::outputFile($strXML, $pathOutput, $basePath);

// Crea lo zip al volo e salva su $destinationZip
IOHelper::zipFileOntheFly($pathOutput, $destinationZip, $strXML);

バリデーション

向doTracciato方法传递数据的验证以透明的方式进行,通过该方法调用的ValidateHelper类实现。验证参数基于卫生部门提供的官方文档: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

完全な例

所有上述功能的详尽示例可以在/tests/index.php中找到,它还加载了所有必需的依赖项。所有之前的代码示例都是从该文件中提取的。

スクリーンショットの例

示例截图位于resources/img文件夹中 demo tessera-sanitaria

貢献

有关详细信息,请参阅CONTRIBUTINGCONDUCT

セキュリティ

如果您发现任何与安全相关的问题,请通过电子邮件而不是使用问题跟踪器。

クレジット

パドソフトについて

Padosoft是一家位于意大利佛罗伦萨的软件公司。专注于电子商务和网站。

ライセンス

MIT许可(MIT)。有关更多信息,请参阅许可文件