big3/document-converter repository overview

⁠Конфертер офисных документов в pdf и png/jpg

Умеет конвертировать doc, docx, xls, xlsx в pdf и картинки формата png/jpg

⁠Пример

Протестровать можно, запустив образ командой:

docker run -v "$(pwd):/app" -v "$(pwd)/storage:/app/storage" -p "9099:9099" registry.big3.ru/rpn/services/document-converter:master

В папку проекта app/storage закинуть файл, например 3.xlsx и через веб вызвать http://0.0.0.0:9099/?source=/app/storage/3.xlsx&format=png&target=/app/storage/3.png&width=300

В результате появится /app/storage/3.png шириной 300px.

⁠Использование

Для использования совместно с другим приложением, нужно в образ примонтировать папку с документами приложения по тому же самомму пути, что и для самого приложения. Иначе говоря, если приложения файл доступен по пути /app/storage/3.xlsx, то и конвертеру он будет доступен по этому же пути.

Приложение должно дергать HTTP API конвертера, передавая GET параметры:

• source - Обязательно Полный путь до файла-источника, форматы doc, docx, xls, xlsx, pdf
• format - Формат резльтирующего файла, один из png, jpg, pdf
• target - Полный путь целевого файла, по которому нужно положить результат, опционально. По умолчанию файл будет размещен рядом с исходным, с расширением, соответствующим запрашиваемому формату
• width - Если выбран формат изображения, то это его ширина
• height - Если выбран формат изображения, то это его высота

⁠Ответ сервера

  {
    "source":"\/app\/storage\/3.xlsx",
    "target":"\/app\/storage\/3.png",
    "width":300,
    "height":0,
    "format":"png",
    "result":"\/app\/storage\/3.png",
    "success":true,
    "stdout":["convert \/app\/storage\/3.xlsx -> \/app\/storage\/3.png using filter : calc_png_Export\n","Overwriting: \/app\/storage\/3.png\n"],
    "stderr":[],
    "exists":true,
    "outdir":"\/app\/storage",
    "command":"soffice --headless --convert-to 'png' --outdir '\/app\/storage' '\/app\/storage\/3.xlsx' ",
    "code":0,
  }

где

• source - путь до файла источника
• target - запрошенный путь до файла результата
• width - запрошенная ширина картинки
• height - высота картинки
• format - формат выходного файла
• result - полный путь до файла результата
• success - флаг удачи true|false
• stdout - массив вывода stdout конвертера
• stderr - массив вывода stderr конвертера
• exists - флаг наличия исходного файла true|false
• command - выполняемая команда конвертации
• code - код завершения команды конвертации