Рекомендации по исправлению ошибок#

Ошибка импорта шаблона FreeMarker#

Ошибка, возвращаемая от DCGN при импорте шаблона: Template starts with both BOM bytes and <#ftl> tag, invalid usage of <#ftl> tag.

Причина: в шаблоне FreeMarker используется тег <#ftl>, и перед этим тегом содержатся дополнительные символы — BOM (Byte order mark). Тег <#ftl> можно использовать только с первого байта документа, иначе при генерации документа через FreeMarker возникнет ошибка генерации — особенность FreeMarker. В силу этой ошибки запрещается импорт шаблонов с одновременным использованием BOM и тега <#ftl>.

Как проверить:

  1. Открыть файл с помощью командной строки: терминал или консоль.

  2. Посмотреть, есть ли дополнительные символы (efbbbf) перед тегом <#ftl>:

Решение:

  1. Сохранить файл в формате UTF-8 без BOM:

    • на macOS достаточно открыть файл в приложении textEdit и сохранить его еще раз без внесения изменений в файл;

    • на ОС Windows нужно пересохранить файл в кодировке UTF-8 без BOM.

  2. Проверить через командную строку, что файл корректный — без BOM: