Ecosystem infrastructure for smart and personalised inclusion and PROSPERITY for ALL stakeholders D204.4 Document Conversion Engine and Implementation Guide Project Acronym Prosperity4All Grant Agreement number FP7-610510 Deliverable number D204.4 Work package number WP204 Work package title Modularization and Replicability of Transformation Engine Authors Lars Ballieu Christensen and Paul Cosma Status Final Dissemination Level Public Delivery Date 30/03/2017 Number of Pages 42 Keyword List Document conversion, accessibility, RoboBraille, MP3, DAISY, EPUB, Braille, OCR, RESTful API, C#, IIS, Hawk, SQL Server, HTTP, MP3, DAISY EPUB, framework Version History Revision Date Author Organisation Description 1 01/01/2015 Saju Sathyan Sensus ApS Initial version 2 01/06/2015 Saju Sathyan Sensus ApS 3 01/09/2015 Milad Ruben Soro Sensus ApS Accessibility conversion added, database setup and entities defined 4 01/02/2016 Vlad Paul Cosma Sensus ApS E-book, HtmlToPdf conversion added 5 01/04/2016 Vlad Paul Cosma Sensus ApS Braille conversion added, solution refactored. 6 01/06/2016 Vlad Paul Cosma Sensus ApS Audio conversion added 7 01/07/2016 Vlad Paul Cosma Sensus ApS MSOffice, HTMLtoText conversion added 8 01/08/2016 Vlad Paul Cosma Sensus ApS Daisy conversion added 9 01/09/2016 Vlad Paul Cosma Sensus ApS Amara integration created. Translation and document structure recognition framework setup 10 01/11/2016 Vlad Paul Cosma Sensus ApS Refactoring solution and test cases. 11 31/01/2017 Vlad Paul Cosma Sensus ApS Extending Amara integration and wrapping up the overall solution. 12 31/01/2017 Lars Ballieu Sensus ApS Added executive summary. Christensen Review and final edit 13 13/03/2017 Manuel Ortega Moral; ilunion and RtF Internal review. Suggestion to Gregg Vanderheiden mention deployment with Cloud4all/GPII auto- personalization from profile in APfP infrastructure. Suggestion to focus on technical interface. Minor edits. Ecosystem infrastructure for smart and personalised inclusion and PROSPERITY for ALL stakeholders www.prosperity4all.eu Revision Date Author Organisation Description 14 30/03/2017 Lars Ballieu Sensus ApS Revised document in accordance Christensen with reviewer feedback. Ecosystem infrastructure for smart and personalised inclusion and PROSPERITY for ALL stakeholders www.prosperity4all.eu Table of Contents Executive Summary .......................................................................................................... 1 1 Contribution to the global architecture ................................................................... 2 2 Introduction ........................................................................................................... 4 3 System Architecture and Implementation ............................................................... 5 3.1 Component controllers ................................................................................................ 5 3.2 Class diagram ............................................................................................................... 6 3.3 RoboBraille API Structure .......................................................................................... 11 3.4 Supported Requests .................................................................................................. 11 3.4.1 Post ....................................................................................................................... 11 3.4.2 GetJobStatus ........................................................................................................ 12 3.4.3 GetJobResult ........................................................................................................ 12 3.4.4 Delete ................................................................................................................... 12 3.4.5 Other request methods ........................................................................................ 13 3.5 General workflow ...................................................................................................... 13 3.6 Example sequence diagram ....................................................................................... 13 3.7 Valid set of input parameters .................................................................................... 15 3.8 Amara integration ...................................................................................................... 20 3.9 Non-functional stubs ................................................................................................. 21 3.9.1 Document Structure Recognition ......................................................................... 21 3.9.2 Language-to-Language Translation ...................................................................... 21 4 Installing, building and testing the solution ............................................................22 4.1 Testing the solution ................................................................................................... 22 4.2 Authentication ........................................................................................................... 22 4.3 Data format ............................................................................................................... 23 4.4 Postman ..................................................................................................................... 23 5 Installation Prerequisites .......................................................................................24 5.1 Microsoft Windows, Visual Studio and .NET ............................................................. 24 5.2 Folder Configurations ................................................................................................ 24 Ecosystem infrastructure for smart and personalised inclusion and PROSPERITY for ALL stakeholders www.prosperity4all.eu 5.3 Sensus SB4 ................................................................................................................. 25 5.4 LibLouis ...................................................................................................................... 25 5.5 High-quality OCR engine ............................................................................................ 25 5.6 Tesseract 3.02 language data files for required files ................................................ 25 5.7 Windows Speech and Installed Voices ...................................................................... 26 5.8 Messaging .................................................................................................................. 26 5.9 DAISY Pipeline 1 and 2, Lame, ImageMagick, eSpeak ............................................... 26 5.9.1 Prerequisites ......................................................................................................... 26 5.9.2 Quick Run ............................................................................................................. 27 5.9.3 Extensive Setup .................................................................................................... 27 5.10 Calibre ........................................................................................................................ 28 5.11 Microsoft Office 2013 ................................................................................................ 28 5.12 Database setup and connection ................................................................................ 28 Annex I: Glossary .............................................................................................................29 List of Tables Table 1: Parameter value table for Accessible Conversions .................................................... 16 Table 2: Parameter value table for Audio ................................................................................ 16 Table 3: Parameter value table for Braille ............................................................................... 17 Table 4: Parameter value table for Daisy ................................................................................. 18 Table 5: Parameter value table for E-book .............................................................................. 18 Table 6: Parameter value table for HTMLtoPDF ...................................................................... 18 Table 7: Parameter value table for MSOfficeConversion ........................................................ 19 Table 8: Parameter value table for HTMLtoText...................................................................... 19 Table 9: Parameter value table for OcrConversion .................................................................. 19 Table 10: Parameter value table for Translation ..................................................................... 20 Table 11: Parameter value table for DocumentStructureRecognition .................................... 20 Table 12: Parameter value table for VideoConversion ............................................................ 20 Ecosystem infrastructure for smart and personalised inclusion and PROSPERITY for ALL stakeholders www.prosperity4all.eu List of Figures Figure 1: Overall Picture of Prosperity4all ................................................................................. 2 Figure 2: Overall RoboBraille System Architecture .................................................................... 5 Figure 3: Class diagram for audio conversions ........................................................................