API интеграции с Document Builder

Когда вы интегрируете Document Builder в свое собственное приложение, это можно сделать двумя способами:

1. Если ваше приложение работает на C++ или .Net, вы можете встроить код Document Builder вместе с кодом скрипта для создаваемых файлов с документами в ваше приложение. В этом случае вам придется перекомпилировать ваше приложение каждый раз, когда в выходных файлах документов будут происходить какие-либо изменения. Этот вариант хорош, когда вам нужно более быстрое нативное приложение и вы уверены, что результирующие файлы документов всегда будут оставаться неизменными или будут изменяться только при перекомпиляции приложения.
   Для интеграции Document Builder в любое приложение используется библиотека doctrenderer C++ или .Net.
2. Если вы собираетесь использовать Document Builder с приложением, написанным на любом другом языке программирования, рекомендуется второй вариант: запустить исполняемый файл Document Builder из вашего приложения и использовать файл сценария .docbuilder для создаваемого документа в качестве параметра к нему. Это гораздо более гибко и позволяет в дальнейшем изменять файлы сценариев документа (особенно если их несколько) независимо от вашего приложения. Вам нужно будет только перекомпилировать ваше приложение, если потребуется добавить в него дополнительные файлы сценариев документов.
   Чтобы запустить Document Builder с помощью второго варианта, выполните следующую команду:

3. docbuilder.exe mydocument.docbuilder

Известные проблемы

Если вы используете Document Builder и как приложение, и как скрипт, то вам необходимо знать некоторые правила и ограничения:

1. Чтобы запустить исполняемый файл Document Builder в приложении C++, используйте метод CDocBuilder.Run следующим образом:

   CDocBuilder::Initialize(sWorkDirectory.c_str());
   CDocBuilder oBuilder;
   oBuilder.Run("path-to-script.docbuilder");
   CDocBuilder::Dispose();
   

   Another way to do this is to use the docbuilder.exe executable file and run it with the .docbuilder file as an argument, where all the code for the document file creation will be written:

   docbuilder.exe "path-to-script.docbuilder"
   

2.  Чтобы задать классу билдера аргумент, который можно передать программе вне метода CDocBuilder.ExecuteCommand, добавьте его как дополнительное свойство при запуске исполняемого файла Document Builder или как часть кода JavaScript программы, но не включайте в файл документа сценарий:
   

   Задает для свойства —argument значение CDocBuilder.Run.

   docbuilder.exe "--argument={\"company\":\"Р7\",\"product\":\"Document Builder\"}" "path-to-script.docbuilder"
   

   Задает свойство —argument с помощью кода JavaScript.

   var sCompany = Argument["company"];
   var sProduct = Argument["product"];
   

3.  Методы объекта построителя нельзя вызывать с помощью переменных JS. При необходимости оберните их инструкцией jsValue:

   var jsVar = "123.docx";
   builder.SaveFile("docx", jsVar); // Incorrect
   builder.SaveFile("docx", jsValue(jsVar)); // Correct
   

4. Для удобства типы форматов заменяются строками.На пример,

   builder.CreateFile("docx");
   

   то же самое, что

   CDocBuilder.CreateFile(AVS_OFFICESTUDIO_FILE_DOCUMENT_DOCX);
   

   И

   builder.SaveFile("docx", file_path);
   

   то же самое, что

   CDocBuilder.SaveFile(AVS_OFFICESTUDIO_FILE_DOCUMENT_DOCX, file_path);