Skip to content

Latest commit

 

History

History
56 lines (43 loc) · 2.66 KB

README.md

File metadata and controls

56 lines (43 loc) · 2.66 KB

convert-spreadsheet

The program converts any input spreadsheet file format to any output spreadsheet file format using Excel or LibreOffice in the background. If output file format is xlsx, the program can convert to meet archival data quality specifications. The program is intended for use in archival workflows.

  • For more information, see repository CLISC

Dependencies

⚠️ Microsoft Excel

Excel can be used as conversion tool.

⚠️ LibreOffice

LibreOffice can be used as conversion tool.

⚠️ ODS-ArchivalRequirements

ODS-ArchivalRequirements are used for policy compliance for ODS spreadsheets.

How to use

Download the executable version here. There's no need to install. In your terminal change directory to the folder where convert-spreadsheet.exe is. Then, to execute the program input:

.\convert-spreadsheet.exe --inputfilepath="[filepath]" --outputfileformat="[extension]"

Parameters

Required

--inputfilepath="[filepath]" // path to the file you want to convert
--outputfileformat="[extension]" // your output file format e.g. "ods", "xlsx", "xlsx-strict", "csv"

Optional

--outputfolder="[folder]" // your custom folder for output file, i.e. "C:\Users\%USERNAME%\Desktop"
--libreoffice // if you want to use LibreOffice as conversion tool instead of Excel
--policy // if you want to convert data to comply with regular archiving requirements
--policy-strict // if you want to convert data to comply with strict archiving requirements
--delete // if original file should be deleted
--rename="[filename]" // your custom filename e.g. "1".

Exit codes

The program writes information to the console and it also returns an exit code to integrate in workflows.

0 = File failed conversion
1 = File completed conversion

Packages and software

The following packages and software are used under license.