Skip to content

intersystems-community/Converter

Repository files navigation

Converter

Convert documents from InterSystems Cache easily using:

  • LibreOffice

InterSystems Developer Community article.

Install

  1. Download and import code
  2. In OS:
    • Linux: apt-get install libreoffice-core libreoffice-writer
    • Windows: install libreoffice
  3. Add soffice to PATH

Use

Call from the terminal:

set sc = ##class(Converter.LibreOffice).convert(source, target, format)
write $System.Status.GetErrorText(sc)

Where:

  • source - file to convert
  • target - result file
  • format - specification for target file. Possible values: docx,html,mediawiki,csv,pptx,ppt,wmf,emf,svg,xlsx,xls. More possible values here.

Errors

  1. Libreoffice errors
    • Instal latest stable Libreoffice (5.2.5 atm). Minimally supported version is 4.2
    • Don't run more than one process of LibreOffice

Footer

Add footer to MS office documents from InterSystems Caché.

Install

  1. Download and import code
  2. In OS:
  3. Add binaries to path

Use

Call from the terminal:

do ##class(Converter.Footer).modifyFooter(source, target, text)

Where:

  • source - file to convert
  • target - result file
  • text - text to add to footer

Docker

Prerequisites

Make sure you have git and Docker desktop installed.

Installation

Clone/git pull the repo into any local directory

$ git clone https://github.com/rcemper/PR_Converter.git
$ docker compose up -d && docker compose logs -f

Container start
creates appropriate directory "/home/irisowner/dev/Unit Tests"
sets ^UnitTestRoot = "/home/irisowner/dev/"

To open IRIS Terminal do:

$ docker-compose exec iris iris session iris
USER>

or using WebTerminal
http://localhost:42773/terminal/

To access IRIS System Management Portal
http://localhost:42773/csp/sys/UtilHome.csp