Skip to content

Commit

Permalink
Version 1.1
Browse files Browse the repository at this point in the history
  • Loading branch information
alessiolombardo committed Jan 3, 2021
1 parent 31ae610 commit c6bac43
Show file tree
Hide file tree
Showing 49 changed files with 1,604 additions and 577 deletions.
38 changes: 30 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,39 @@
# RiscossioneConverter

RiscossioneConverter consente di convertire in file Excel 97/2003 (.xls) un file a blocchi contenente record a lunghezza fissa secondo le specifiche degli [Allegati 1/2 del Decreto 15/06/2015 del Ministero dell'Economia e delle Finanze](
https://www.gazzettaufficiale.it/atto/serie_generale/caricaDettaglioAtto/originario?atto.dataPubblicazioneGazzetta=2015-06-22&atto.codiceRedazionale=15A04675&elenco30giorni=false) inerente la trasmissione agli enti creditori delle quote annullate e di rimborso agli agenti della riscossione delle spese esecutive sostenute per i ruoli.
RiscossioneConverter consente la conversione di un file a blocchi contenente record a lunghezza fissa secondo le specifiche degli [Allegati 1/2 del Decreto 15/06/2015 del Ministero dell'Economia e delle Finanze](https://www.gazzettaufficiale.it/atto/serie_generale/caricaDettaglioAtto/originario?atto.dataPubblicazioneGazzetta=2015-06-22&atto.codiceRedazionale=15A04675&elenco30giorni=false) inerente la trasmissione agli enti creditori delle quote annullate e di rimborso agli agenti della riscossione delle spese esecutive sostenute per i ruoli. I formati di output supportati sono Excel (.xlsx), Excel 97-2003 (.xls), OpenDocument Spreadsheet (.ods), XML e JSON.

Il software è interamente sviluppato in Java e con interfaccia grafica minimale disponibile in due versioni:
- Swing: Testata su Windows XP (con JRE7), Windows 7 (con JRE8), Windows 10 (con JDK15), Ubuntu 20.04 (con JDK11);
- JavaFX: Testata su Windows 7 (con JRE8), Windows 10 (con JDK15), Ubuntu 20.04 (con JDK11). Windows XP non supportato.

Gli output in formato .xls, .xlsx e .ods sono stati testati su Microsoft Excel 2013 e LibreOffice Calc 6.4.6.2.

L'approccio di programmazione MVC consente facilmente di estrarre/modificare/sostituire il modello dei dati, il formato di output o l'interfaccia grafica.

Se viene selezionato un file di output non vuoto, i record convertiti vengono inseriti in coda, senza alterare i record precedenti.

Bug noti e Troubleshooting:
- Ove la libreria JavaFX non fosse già integrata nel JDK/JRE, specificarla avviando il jar con:

Interamente sviluppato in Java e con interfaccia grafica minimale disponibile in due versioni:
- Swing: Testata su Windows XP (con JRE7), Windows 7 (con JRE8), Windows 10 (con JDK15).
- JavaFX: Testata su Windows 7 (con JRE8), Windows 10 (con JDK15). Windows XP non supportato. NOTA: Ove la libreria JavaFX non fosse già integrata nel JDK/JRE, specificarla avviando il jar con:
```
java --module-path <PERCORSO LIBRERIA JAVAFX> --add-modules=javafx.controls,javafx.fxml -jar <NOME JAR>
java --module-path <PERCORSO LIBRERIA JAVAFX> --add-modules=javafx.controls,javafx.fxml -jar <NOME JAR>
```

L'approccio di programmazione MVC consente facilmente di estrarre/modificare/sostituire il modello dei dati, il formato di output o l'interfaccia grafica.
- Microsoft Excel richiede una correzione del contenuto del file generato se il formato scelto è ODS. Consentire la correzione e salvare da Excel per risolvere;
- Possibile ``OutOfMemoryError`` se il file di input ha una dimensione eccessiva. Eventualmente suddividerlo in porzioni.


Interfaccia Swing su Windows XP:

<img src="docs/images/screenshot_winxp_swing_1.1.png" width="500">

Interfaccia JavaFX su Windows 7:

<img src="docs/images/screenshot_win7_javafx_1.1.png" width="500">

Interfaccia JavaFX su Ubuntu 20.04:

<img src="docs/images/screenshot_ubuntu2004_javafx_1.1.png" width="500">

Se viene selezionato un file Excel non vuoto, i record convertiti vengono inseriti in coda, senza alterare i record precedenti.

[Documentazione API (Javadoc)](https://alessiolombardo.github.io/RiscossioneConverter/apidocs/)
Binary file not shown.
Binary file not shown.
7 changes: 4 additions & 3 deletions docs/apidocs/allclasses-frame.html
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,10 @@
<!-- NewPage -->
<html lang="it">
<head>
<!-- Generated by javadoc (1.8.0_74) on Thu Dec 17 13:26:19 CET 2020 -->
<!-- Generated by javadoc (1.8.0_74) on Sun Jan 03 20:30:46 CET 2021 -->
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>All Classes (RiscossioneConverter 1.0 API)</title>
<meta name="date" content="2020-12-17">
<title>All Classes (RiscossioneConverter 1.1 API)</title>
<meta name="date" content="2021-01-03">
<link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
<script type="text/javascript" src="script.js"></script>
</head>
Expand All @@ -18,6 +18,7 @@ <h1 class="bar">All&nbsp;Classes</h1>
<li><a href="view/RiscossioneConverterGUISwing.html" title="class in view" target="classFrame">RiscossioneConverterGUISwing</a></li>
<li><a href="model/RiscossioneModel.html" title="class in model" target="classFrame">RiscossioneModel</a></li>
<li><a href="model/RiscossioneModel.Campi.html" title="enum in model" target="classFrame">RiscossioneModel.Campi</a></li>
<li><a href="controller/RiscossioneWriter.html" title="class in controller" target="classFrame">RiscossioneWriter</a></li>
</ul>
</div>
</body>
Expand Down
7 changes: 4 additions & 3 deletions docs/apidocs/allclasses-noframe.html
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,10 @@
<!-- NewPage -->
<html lang="it">
<head>
<!-- Generated by javadoc (1.8.0_74) on Thu Dec 17 13:26:19 CET 2020 -->
<!-- Generated by javadoc (1.8.0_74) on Sun Jan 03 20:30:46 CET 2021 -->
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>All Classes (RiscossioneConverter 1.0 API)</title>
<meta name="date" content="2020-12-17">
<title>All Classes (RiscossioneConverter 1.1 API)</title>
<meta name="date" content="2021-01-03">
<link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
<script type="text/javascript" src="script.js"></script>
</head>
Expand All @@ -18,6 +18,7 @@ <h1 class="bar">All&nbsp;Classes</h1>
<li><a href="view/RiscossioneConverterGUISwing.html" title="class in view">RiscossioneConverterGUISwing</a></li>
<li><a href="model/RiscossioneModel.html" title="class in model">RiscossioneModel</a></li>
<li><a href="model/RiscossioneModel.Campi.html" title="enum in model">RiscossioneModel.Campi</a></li>
<li><a href="controller/RiscossioneWriter.html" title="class in controller">RiscossioneWriter</a></li>
</ul>
</div>
</body>
Expand Down
10 changes: 5 additions & 5 deletions docs/apidocs/constant-values.html
Original file line number Diff line number Diff line change
Expand Up @@ -2,18 +2,18 @@
<!-- NewPage -->
<html lang="it">
<head>
<!-- Generated by javadoc (1.8.0_74) on Thu Dec 17 13:26:19 CET 2020 -->
<!-- Generated by javadoc (1.8.0_74) on Sun Jan 03 20:30:46 CET 2021 -->
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Constant Field Values (RiscossioneConverter 1.0 API)</title>
<meta name="date" content="2020-12-17">
<title>Constant Field Values (RiscossioneConverter 1.1 API)</title>
<meta name="date" content="2021-01-03">
<link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
<script type="text/javascript" src="script.js"></script>
</head>
<body>
<script type="text/javascript"><!--
try {
if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="Constant Field Values (RiscossioneConverter 1.0 API)";
parent.document.title="Constant Field Values (RiscossioneConverter 1.1 API)";
}
}
catch(err) {
Expand Down Expand Up @@ -150,6 +150,6 @@ <h2 title="view">view.*</h2>
<!-- -->
</a></div>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<p class="legalCopy"><small>Copyright &#169; 2020. All rights reserved.</small></p>
<p class="legalCopy"><small>Copyright &#169; 2021. All rights reserved.</small></p>
</body>
</html>
Loading

0 comments on commit c6bac43

Please sign in to comment.