Модуль «Word»

Основные моменты модуля

Модуль Word обеспечивает работу с документами Microsoft Word пакета Microsoft Office. С помощью модуля можно создавать и редактировать документы с популярными текстовыми расширениями, такими как .doc, .docx, .html.

Интерфейс окна

Окно модуля состоит из трех основных частей, первая – часть, содержащая в себе поля для создания команд и кнопок управления ими, вторая – таблица «Список команд», которая будет содержать все добавленные действия для работы с файлом, и третья – окно с предварительным просмотром загруженного файла.

Рис. 1. Интерфейс окна

Окно предварительного просмотра позволяет просмотреть весь загруженный документ в том же виде, в котором он виден в самом Microsoft Word.

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

  • «Путь к файлу» - поле с кнопкой, открывающей диалог выбора файла. Данное поле предназначено для выбора существующего файла, с которым предстоит далее работать, либо для введения в него пути, по которому необходимо будет создать новый файл. Обязательное поле;

  • «Действие» - выпадающий список, состоящий из действий, которые можно применить к загруженному файлу или создать новый с указанным путем в поле «Путь к файлу». Обязательное поле;

Рис. 2. Перечень доступных действий модуля

  • «Описание» - поле, необходимое для удобной навигации по действиям, заполняется комментарием разработчика о создаваемом действии. Необязательное поле.

Все возможные действия будут описаны в следующей главе.

Для добавления действия в таблицу «Список команд» необходимо воспользоваться кнопкой «Добавить» под полями настройки действия.

Рис. 3. Расположение кнопки «Добавить»

После нажатия на кнопку созданное действие добавится в «Список команд». Для редактирования существующей команды или её удаления, необходимо выбрать строку с командой в таблице команд и нажать «Удалить» для её удаления, или отредактировать необходимые поля действия и затем нажать «Редактировать».

Для того, чтобы поменять существующие действия местами, необходимо выбрать одно действие и нажать на необходимые кнопки «Поднять» или «Опустить», которые расположены в правом углу над таблицей с командами.

Рис. 4. Кнопки «Поднять/Опустить» и выбор строки в таблице

Действия модуля

Создать файл

Данное действие создает файл с указанным путем, именем и расширением. Для настройки действия необходимо заполнить поле «Путь к файлу» строкой типа «Путь до файла/Название файла.Требуемое расширение», например, «C:/Reports/Documents/Test.docx».

Рис. 5. Пример заполнения действия «Создать файл»

Получить текст

Действие «Получить текст» позволяет считать весь текст из загруженного файла в переменную. Для настройки действия появляется еще одно поле помимо стандартных трёх – «Переменная», в которую записывается название переменной (с символов «v.»), в которую будет записан считанный текст.

Рис. 6. Пример настройки действия «Получить текст»

Записать текст

С помощью действия можно записать имеющийся текст, например, считанный из другого текстового файла, в текущий загруженный файл. Для настройки обязательно заполнение поля «Значение», куда вводится либо переменная (с символов «v.»), содержащая текст, либо сам текст. Обратите внимание, что текст, введенный данным действием, полностью затрет существующий текст в файле.

Рис. 7. Пример настройки действия «Записать текст»

Добавить текст

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

«После символа №» - данное поле ожидает ввод целого числа, обозначающего, после какого по счету символа необходимо вставить текст (с учетом пробелом и символов переноса строки или разрыва страницы).

Рис. 8. Пример настройки действия «Добавить текст»

«Размер текста» - аналогичен полю «Размер шрифта» в Microsoft Word – устанавливает размер добавляемого текста. Ожидается ввод целого или десятичного числа.

«Шрифт» - выпадающий список, содержащий в себе набор стандартных шрифтов пакета Micrisift Office – устанавливает шрифт добавляемого текста.

«Цвет текста» и «Цвет фона» – поля с иконкой палетки сбоку, по нажатию на которые открывается диалог выбора цвета – устанавливают цвет добавляемого текста и его фона соответственно. Вводится в формате цвета HEX – шестнадцатеричное представление RGB.

«Текст» - поле, в которое указывается добавляемый текст или переменная, которая его содержит.

Добавить перенос строки

Данное действие добавляет символ переноса строки в файл. Не требует заполнения дополнительных полей.

Рис. 9. Пример настройки действия добавление перехода на новую строку

Удалить текст

С помощью данного действия можно удалить текст, зная количество символов в нем и его расположение. Для настройки необходимо ввести в поле «После символа №, количество» два целых числа через запятую, где первое число – номер символа, после которого необходимо удалить текст, а второе – количество символов в удаляемом тексте.

Рис. 10. Пример настройки действия «Удалить текст»

Экспорт

С помощью данного действия можно менять расширение загруженного файла. Для настройки действия нужно выбрать из выпадающего списка «Тип» тип файла, в который нужно экспортировать, и указать путь с названием и расширением будущего файла в поле «Путь выходного файла».

Рис. 11. Пример настройки действия «Экспорт»

Найти слово

Данное действие ищет слово или словосочетание (его точное совпадение) в тексте и возвращает все его вхождения в тексте в виде массива объектов (или таблицы с именованными колонками). Возвращаемые поля:

  • start – начальный символ слова или словосочетания;

  • end – конечный символ слова или словосочетания;

  • text – искомое слово или словосочетание вместе с прилегающими к нему символами;

  • pageNum – номер страницы, на которой было найдено слово или словосочетание.

Рис. 12. Пример настройки действия Найти слово

Результат поиска будет выглядеть следующим образом:

Рис. 13. Пример результирующей переменной