Обзор

  • Post category:Начало работы
  • Запись изменена:07.11.2022

Плагины и макросы

Р7 Сервер документов и декстопные редакторы предлагают поддержку подключаемых плагинов, позволяющих разработчикам добавлять в редакторы определенные функции, не связанные напрямую с форматом OOXML.

В этой документации описаны:

Как собрать, локализовать, запустить, протестировать и опубликовать плагин
Как написать, отладить и запустить макрос или конвертировать макросы VBA для использования в Р7
Как использовать методы и события Р7

Что могут плагины

Вот несколько примеров того, что вы можете делать с плагинами Р7:

  • подключить сторонние сервисы, такие как Telegram, YouTube, Thesaurus, Translator, Zotero, OCR и т. д.;
  • добавить пользовательские компоненты и элементы управления в пользовательский интерфейс, такие как Trackchanges, Trackchanges_off;
  • улучшить существующий пользовательский интерфейс и функциональность редакторов: автозаполнение, поиск &  замена, перемещение курсора, расширенные комментарии;
  • автоматизируйте задачи в документах с помощью макросов.

Как создавать плагины

Чтобы создать свой собственный плагин, вам нужно выполнить несколько шагов:

  1. Изучите основные принципы создания плагинов на странице начало работы с плагинами и напишите код, определяющий внешний вид и поведение плагина.
  2. После сборки плагина тщательно протестируйте его и убедитесь, что плагин выглядит и работает так, как вы ожидали. Постарайтесь предвидеть проблемы, которые могут возникнуть, и предложите свои пути их решения.

Как получить помощь

Если у вас есть какие-либо вопросы о плагинах, попробуйте сначала найти их в разделе часто задаваемых вопросов.

Р7 DocumentBuilderv7.2

Document Builder позволяет легко построить документ без необходимости реального запуска редактора обработки документов. Он также позволяет разработчикам автоматизировать создание документов, используя созданные вами шаблоны или вставляя данные из какой-либо вашей базы данных в документ или набор документов. Он обладает всеми функциями обычного редактора документов, но при этом является легковесным и может быть легко интегрирован в вашу систему управления документами, CRM-систему и т.д. с помощью JavaScript API.

Document Builder в действии

Это живой пример того, как работает Document Builder. Вы можете загрузить собственный скрипт для документов, нажав кнопку «Загрузить свой скрипт» и выбрав нужный файл на своем ПК.

Создайте документ из приведенного ниже скрипта, отредактируйте его или загрузите свой собственный скрипт.

Используйте скрипт в текстовой области ниже как есть для создания документа или отредактируйте его в окне текстовой области. Или, если у вас есть собственный скрипт, воспользуйтесь кнопкой под текстовой областью, чтобы загрузить его.

builder.CreateFile(«docx»);
var oDocument = Api.GetDocument();
var oParagraph, oRun;
oParagraph = oDocument.GetElement(0);
oParagraph = Api.CreateParagraph();
oParagraph.AddText(«Dear John Smith.»);
oDocument.Push(oParagraph);
oParagraph = Api.CreateParagraph();
oParagraph.AddText(«Р7 is glad to announce that starting today, you are appointed Commercial director to the company of your dream.»);
oDocument.Push(oParagraph);
oParagraph = Api.CreateParagraph();
oRun = Api.CreateRun();
oRun.SetBold(true);
oRun.AddText(«Please note: «);
oParagraph.AddElement(oRun);
oRun = Api.CreateRun();
oRun.AddText(«this text is used to demonstrate the possibilities of «);
oParagraph.AddElement(oRun);
oRun = Api.CreateRun();
oRun.SetBold(true);
oRun.AddText(«Document Builder»);
oParagraph.AddElement(oRun);
oRun = Api.CreateRun();
oRun.AddText(» and cannot be used as real appointment to the position in any real company.»);
oParagraph.AddElement(oRun);
oDocument.Push(oParagraph);
oParagraph = Api.CreateParagraph();
oParagraph.AddText(«Best regards,»);
oParagraph.AddLineBreak();
oParagraph.AddText(«Document Builder Team»);
oDocument.Push(oParagraph);
builder.SaveFile(«docx», «SampleText.docx»);
builder.CloseFile();

ЗАГРУЗИТЬ СВОЙ СОБСТВЕННЫЙ СКРИПТ

Или создайте новый файл из образца скрипта с вашими собственными данными

Введите данные в текстовые области ниже, чтобы они появились в выходном документе. После этого воспользуйтесь кнопками справа от полей, чтобы создать соответствующий тип документа с введенными данными.

    

Хотите узнать, как это работает?

Начните здесь и узнайте основные принципы работы Document Builder, или прочитайте статьи Integration API,  Text document API, Spreadsheet API, Presentation API или Form API,  чтобы узнать, как автоматизировать создание документов с помощью Document Builder.

Получить помощь

Если у вас есть какие-либо вопросы или пожелания относительно Document Builder, посетите GitHub.

Вы также можете задать вопрос нашим разработчикам на форуме Р7 (требуется регистрация).