Главное меню расположено в верхней части окна приложения и представляет собой горизонтальную строку, содержащую названия выпадающих меню. Главное меню предоставляет доступ к следующим выпадающим меню:
- "Файл"; в этом меню собраны команды для записи обрабатываемых данных на диск в виде файла и для чтения файла с диска, а также команды создания нового документа и выхода из приложения;
- "Правка"; в этом меню собраны команды редактирования документа;
- "Настройки"; в этом меню собраны команды по изменению поведения приложения, а также запуска редактора сценариев;
- "Вид"; в этом меню присутствуют команды настройки внешнего вида приложения;
- "Помощь"; это выпадающее меню обеспечивает доступ ко встроенной интерактивной системе помощи.
В ТИР существуют две панели инструментов: главная панель инструментов и панель управления выравниванием текста. Обе они могут быть перемещены на произвольное место любого из доков приложения. Иными словами, пользователь может их расположить вдоль любого края главного окна. При запуске с настройками по умолчанию панели инструментов расположены в верхнем доке, то есть вдоль верхнего края окна под главным меню.
Для удобства пользователя часто используемые функции вынесены на плавающие панели управления, которые, как и панели инструментов (см. «Панели инструментов»), могут быть перемещены в любой док, то есть могут находиться в любом месте окна приложения.
Для перемещения панели управления необходимо навести курсор на её заголовок, нажать левую кнопку манипулятора "мышь" и, удерживая её, переместить панель управления в нужное место, а затем отпустить левую кнопку манипулятора "мышь". Для помещения панели управления в док следует при перемещении панели навести курсор на край окна приложения таким образом, чтобы под окном панели отобразилось свободное место. После этого отпускание левой кнопки манипулятора "мышь" приведёт к помещению панели в док.
В случае, если в одном доке находится несколько панелей (именно такое их расположение задано в настройках по умолчанию), панели оформляются как вкладки или делят между собой пространство дока. В первом случае между ними можно переключаться, выбирая название панели в строке переключения вкладок; во втором панели доступны для работы одновременно.
Рабочая область окна приложения предназначена для редактирования документов. Она предоставляет пользователю инструменты для редактирования содержимого документов, а также для переключения между документами и переключения между разделами документов.
Рабочая область расположена в центральной части окна приложения. В её верхней части расположена область с названиями вкладок с документами и кнопкой закрытия документа. Помещение курсора на название документа и нажатие левой кнопки манипулятора "мышь" приводит к открытию в рабочей области соотвествующего документа; помещение курсора на кнопку закрытия документа и нажатие левой кнопки манипулятора "мышь" приводит к закрытию документа.
В левой части рабочей области расположена панель переключения разделов документа, в которой расположены закладки с названиями разделов. Помещение курсора на закладку с названием раздела и нажатие левой кнопки манипулятора "мышь" приводит к тому, что в рабочей области открывается соответствующий раздел.
В верхней чачти рабочей области расположена панель закладок, содержащая закладки с названиями всех документов открытых в ПК ПП ТИР (см. Рисунок 5.21, «Закладки документов»).
С помощью области закладок можно производить следующие действия:
перетаскивание закладок с названиями документов, что позволяет изменить взаиморасположение закладок на панели (для перетаскивания нажмите левую кнопку манипулятора "мышь" в момент, когда курсор находится над закладкой с названием документа, затем, удерживая левую кнопку нажатой, переместите курсор поверх другой закладки и отпустите левую кнопку манипулятора; после этих действий закладка переместится на новую позицию );
переименование документов (для переименования документа выполните двойной щелчок левой кнопкой манипулятора "мышь", наведя курсор на закладку документа или воспользуйтесь контекстным меню, нажав на правую кнопку манипулятора "мышь" в момент, когда курсор наведён на закладку документа и выбрав пункт меню "Переименовать"; после этих действий появится диалог, позволяющий задать новое название документа);
закрытие документа (для закрытия документа воспользуйтесь кнопкой закрытия документа в виде крестика в правой части области закладок, кликнув по ней левой кнопкой манипулятора "мышь" --- после этого произойдет закрытие текущего документа; также вы можете воспользоваться контекстным меню, нажав правой кнопкой манипулятора "мышь" на название документа, который вы хотите закрыть и выбрав пункт меню "Закрыть").
Панель закладок разделов документа отражает внутреннюю структуру документа ТИР. На панели закладок разделов документа могут быть расположены следующие закладки:
закладка титульного листа: позволяет переключить рабочую область в режим отображения и редактирования титульного листа (в каждом документе ТИР может присутствовать один титульный лист);
закладка содержания: позволяет переключить рабочую область в режим отображения и редактирования содержания (в каждом документе ТИР пристуствует одна закладка "Содержание"; содержание генерируется автоматически в соответствии со структурой документа и составом разделов);
закладки разделов: позволяют переключить рабочую область в режим отображения/редактирования раздела, а также изменять порядок расположения разделов в документе (в каждом документе может присутствовать одна или несколько закладок разделов документа);
закладка подписного листа позволяет переключить рабочую область в режим отображения и редактирования подписного листа (в каждом документе ТИР может присутствовать один подписной лист).
Нажав на правую кнопку манипулятора "мышь" в момент, когда курсор указывает на одну из закладок, вы получите доступ к контекстному меню, содержащему набор функций для работы с документом.
По двойному щелчку левой кнопкой манипулятора "мышь" на закладку раздела вызывается диалог, с помощью которого можно задать наименование раздела.
Для удобства работы с табличными разделами, в програмном комплксе ТИР предусмотрена возможность настраивать некоторые параметры визуального отображения табличных разделов.
Чтобы перейти к диалогу настройки параметров отображения, нажмите левую кнопку манипулятора "мышь", наведя курсор на иконку "Параметры отображения", расположенную на панели инструментов (см. Рисунок 5.22, «Пиктограмма "Параметры отображения"»).
Другой способ открыть диалог настройки параметров отображения
- открыть меню "Настройки" главного меню и выбрать пункт "Параметры
отображения".
После этих действий появится диалог настройки параметров отображения (см.Рисунок 5.23, «Диалог "Параметры отображения"»).
Диалог позволяет изменять такие параметры таблиц как:
шрифт текста шапки таблицы;
шрифт текста тела таблицы (данных);
цвет фона ячеек шапки;
цвет фона ячеек тела таблицы;
цвет фона ячеек нумерации.
Чтобы изменить параметр, нажмите левой кнопкой манипулятора "мышь" на соответствующее поле и выберите требуемое значение.
Также вы можете включить/отключить:
отображение нумерации столбцов и строк;
фиксацию боковика и шапки (при прокручивании таблицы вниз или вправо шапка таблицы или боковик всегда будут отображаться на рабочей области напротив соответствующих колонок или строк);
подсветку текущей строки;
отображение в рабочей области кнопкок действий над раделом;
отображение кнопок действий над ячейками.
Для этого просто нажмите левой кнопкой манипулятора "мышь" на соответствующее поле, поставив или убрав галочку. Присутствие галочки обозначает, что параметр активен.
Вы можете сохранить текущие настройки в файл на диск с помощью кнопки "Сохр. настройки" и загрузить настройки из файла с помощью кнопки "Загр. настройки".
Вы всегда можете вернуть параметры настройки по умолчанию, нажав кнопку "По умолчанию".
После того как вы настроили параметры так, как вам необходимо, нажмите кнопку "ОК", и вид таблицы изменится в соответствии с новыми настройками.
Нажатие кнопки "Отмена" закроет диалог настройки. Параметры отображения не изменятся.
Колонтитулы - это надписи на верхнем и нижнем крае каждой страницы документа ТИР
Колонтитул может содержать текст со сложным форматированием и таблицы. С технической точки зрения колонтитул представляет собой HTML-документ, поэтому в нём можно использовать любые выразительные средства, допускаемое этим стандартом.
Чтобы приступить к редактированию колонтитулов, убедитесь, что в рабочей области открыт соответствующий документ и нажмите левой кнопкой манипулятора «мышь» на кнопку «Редактировать колонтитулы», находящуюся на панели навигатора. В результате этих действий появится диалог редактирования и настройки колонтитулов (см. Рисунок 5.24, «Редактор колонтитулов»).
Чтобы установить верхний или нижний колонтитул, выполните
следующие действия:
установите галочку напротив соответствующего поля;
установите высоту поля для соответствующего колонтитула;
вводом с клавиатуры наберите текст соответствующего колонтитула в поле текст колонтитула.
В каждый из колонтитулов можно загрузить размеченный текст формата HTML из файла с расширением ".html" или ".htm". Для этого нажмите левой кнопкой манипулятора «мышь» на кнопку «Загрузить из файла» напротив соответствующего колонтитула. После этого выберите файл из которого вы хотите загрузить шаблон и нажмите кнопку «Открыть». После это в соответствующем поле «Текст колонтитула» появится тело колонтитула в формате, в котором колонтитул будет отображен при печати. Так же в поле «Текст колонтитула» доступны действия для элементарного редактирования колонтитула, такие как добавление и удаление текста.
Редактор колонтитулов позволяет создавать шаблоны для колонтитулов и параметров отображения при печати документов, такие как: размеры полей листа, параметры нумерации и настройки колонтитулов.
Для того чтобы создать шаблон колонтитулов, нажмите левой кнопкой манипулятора «мышь» на кнопку «Выгрузить шаблон». В появившемся диалоге выберите файл для сохранения шаблона и нажмите кнопку «Сохранить».
Для того чтобы загрузить шаблон, нажмите левой кнопкой манипулятора «мышь» на кнопку «Загрузить шаблон». В появившемся диалоге выберите файл, из которого требуется загрузить шаблон, и нажмите кнопку «Загрузить».
После завершения работы с редактором колонтитулов нажмите кнопку «Применять», после чего все изменения, внесенные в колонтитулы, применятся. Кнопка «Отмена» закрывает редактор колонтитулов и отменяет изменения, вносимые из диалога редактора колонтитулов, за исключением случая, когда имела место загрузка шаблона из файла. После загрузки шаблона из файла, все загруженные данные применяются к документу автоматически.
Встроенный язык формул позволяет задавать сложные формулы и накладывать определённые логические условия. Формулы и логику можно задавать для ячейки данных, колонки шапки и строки боковика.
Формула представляет собой выражение, результат выполнения которого будет отображен в ячейке данных, для которой она задана. Например: «2+5*5» такое выражение выдаст в ячейку результат «27». Так же в формулах допускается использование встроенных функций, таких как округление, например «round(8.345, 1)» вернет значение «8.3».
Одной из самых важных особенностей встроенного языка является возможность использовать в формулах значения других ячеек раздела, для получения результата. Например, для получения суммы двух ячеек или процентного соотношения. Механизм составления формул подробно описан далее.
Для того чтобы установить формулу для ячейки данных, колонки или строки, выполните следующие действия:
убедитесь, что в рабочей области ПП ТИР открыт нужный документ и выбран соответствующий раздел документа;
щелчком левой кнопки манипулятора «мышь» выберите ячейку раздела, для которой нужно задать формулу (если вы хотите задать формулу для всей строки раздела, то следует выбрать ячейку боковика, соответствующую этой строке; для установки формулы для колонки раздела, следует выбрать ячейку шапки, соответствующую колонке);
установите курсор в поле редактирования формул, кликнув по нему левой кнопкой манипулятора «мышь»;
введите формулу с клавиатуры;
проверьте правильность формулы, отсутствие ошибок и лишних символов;
нажмите клавишу «Enter» для того чтобы применить формулу.
Если перейти на другую ячейку таблицы раздела или на другой раздел, не нажав клавишу «Enter», то формула не применится и введенное выражение не сохранится.
Работа с формулами в ТИР предполагает следующие ограничения:
Все формулы применяются только к ячейкам данных раздела: результат выполнения формулы может быть отображен только в ячейках с данными, в выражение можно добавлять ссылки только на ячейки с данными
Ни ячейки боковика, ни ячейки шапки не могут участвовать в выражении формулы.
Результаты формул не могут быть отображены в боковике или шапке.
Вычисляемые по формулам значения ячеек не могут редактироваться вручную, за исключением некоторых специальных случаев, более подробно описанных ниже.
В формулах могут принимать участие ячейки, содержащие только числовые данные.
Результатом выполнения выражения формулы может быть только число.
Формулы не должны быть циклично замкнутыми, т.е. если в формуле имеется ссылка на другие ячейки, ссылающиеся на первоначальную ячейку с формулой, то формулы могут давать неверные результаты.
Формула не должна ссылаться на саму себя.
Чтобы удалить формулу, выделите ячейку, из которой требуется удалить формулу. После этого в строке редактирования формул появится текущая формула. Удалите полностью всё выражение и нажмите «Enter». После этого формула будет удалена, а ячейка данных будет доступна для редактирования (если только эту ячейку не затрагивает формула для строки или для столбца).
Формула, введённая в ячейку данных, распространяется только на эту ячейку. Формула, введённая в колонку боковика, распространяется на все ячейки данных находящихся в данной колонке. Формула, введённая в строку боковика, распространяется на все ячейки данной строки. У ячейки, колонки шапки и строки боковика есть приоритеты по вычислению. Самый высокий приоритет при вычислении имеет формула или логика, введённая непосредственно в ячейку данных. Немного меньший приоритет имеет формула, введённая в строку боковика, а самый низкий приоритет имеет формула, введённая в колонку шапки. Если в колонку шапки и строку боковика введена формула, то ячейка, находящаяся на пересечение колонки и боковика будет рассчитываться по формуле заданной в строке боковика, так как она имеет более высокий приоритет. Если в ячейке данных на пересечении введена формула, то ячейка будет рассчитываться по этой формуле, так как приоритет формулы введённой в ячейку данных самый высокий. При необходимости можно установить приоритет колонки выше, чем приоритет строки.
Перечень и краткое описание встроенных функций:
without(val) – если переданное функции значение равняется 0, или бесконечности, или значение не определено, то функция возвращает пустое значение;
round(val, level) – функция производит математическое округление значения val до заданного в level знака после запятой;
floor(val, level) – функция округляет значение val до меньшего заданного в level знака после запятой;
ceil(val, level, p) - функция округляет значение val до большего заданного в level знака после запятой;
range(val, min, max) – функция проверяет на вхождение значения val в заданные промежутки min и max (минимальное и максимальное значение соответственно). Если переданное значение меньше минимального, то функция возвращает минимальное значение, если больше максимального, то максимальное, а если значение попадает в промежуток, то возвращает переданное значение без изменений;
range_min(val, min) – функция проверяет переданное значение, меньше ли оно заданного минимума. Если переданное значение меньше минимального, то функция возвращает заданное минимальное, если больше минимального, то возвращает переданное значение без изменений;
range_max(val, max) - функция проверяет переданное значение, больше ли оно заданного максимума. Если переданное значение больше максимального, то функция возвращает заданное максимальное, если меньше максимального, то возвращает переданное значение без изменений;
row() – возвращает номер текущей строки, используется для составление выражения с ссылкой на другие ячейки той же строки;
col() – возвращает номер текущего столбца, используется для составление выражения с ссылкой на другие ячейки того же столбца;
C(i, j) – возвращает значение ячейки по координатам i, j (строка, столбец соответственно), нумерация столбцов и строк начинается с нуля, т.к. у первой ячейки первой строки координата (0,0); так же стоит отметить, что нумерация начинается с ячеек данных, т.е. боковик и шапка не нумеруются, например: «C(0,0) + C(0,1)» возвращает сумму первой и второй ячеек первой строки;
PERC(num, perc) – возвращает процент заданный параметром perc от числа заданного параметром num;
col_sum(col) – возвращает сумму всех ячеек заданного параметром col столбца;
row_sum(row) - возвращает сумму всех ячеек заданной параметром row строки.
Для облегчения ввода формул, содержащих ссылки на другие ячейки таблицы, и чтобы избежать громоздкого вида формул, в язык встроенных макросов добавлены следующие макросы:
СiКj - то же самое, что С(i, j), например «С0К0» возвращает значение первой ячейки первой строки, а «С0К0 + С0К1» - сумму первой и второй ячеек первой строки;
Сi – возвращает значение ячейки той же колонки, в которой введена формула но i-й строки, аналогична C(i, col()), например «С0» возвращает значение ячейки первой строки, той же колонки, что и ячейка с этой формулой;
Кj – возвращает значение ячейки той же строки, в которой введена формула но j-й колонки, аналогична C(row(), j), например «К0» возвращает значение ячейки первой колонки, той же строки, что и ячейка с этой формулой.
Формула для колонки вводится в том случае, если он должна быть общей для всех ячеек в колонке. Например, если ввести в формулу колонки «2+5», то во всех ячейках этой колонки будет значение «5»; если ввести «С(0,0)», то во всех ячейках этой колонки будут значения равные первой ячейке первой строки; если ввести «С(row(),0)» или «К1» (означает первая колонка), то в каждой ячейке этой колонки будет значение из ячейки первой колонки этой же строки.
Например, необходимо третья колонка раздела содержала сумму первой и второй колонок, т.е. для каждой строки в третьей ячейке должна содержаться формула, складывающая первую и вторую ячейки. Для этого следует ввести в третью колонку (в ячейку шапки, находящуюся непосредственно над этой колонкой) следующее выражение «С(row(), 0) + C(row(), 1)» или «К0 + К1». Фактически запись можно прочитать как «К0 (Первая колонка) + (плюс) К1 (вторая колонка)».
Для автоматического пересчёта в документе можно использовать все вышеперечисленные формулы и математические правила. То есть, результаты функций можно передавать в виде параметров другим функциям, а так же перемножать, делить, складывать и вычитать возвращаемые ими значения.
Встроенный язык сценариев позволяет автоматизировать выполнение последовательности операций над табличными документами. Синтаксис языка сценариев подобен языку JavaScript. Операции над документами в языке сценариев включают:
поиск документа по названию;
поиск раздела документа по названию;
перенос данных между двумя разделами со связыванием по значениям в боковике;
иерархическую проверку выбранного раздела;
пересчет выбранного раздела;
получение значений ячеек табличного раздела;
запись данных в табличный раздел.
Документы, участвующие в выполнении сценария, должны быть предварительно открыты в ТИР.
Пример. Требуется перенести данные первой и второй колонок раздела ""Раздел 1" документа "Документ 1" во вторую колонку раздела ""Раздел 1" документа "Документ 2", сопоставляя строки по значениям в двух первых колонках боковика, а затем произвести иерархическую проверку и пересчет второго раздела. Эта задача решается при помощи следующего сценария:
//Тестовый сценарий
// Получение количества открытых документов с названием "Документ 1"
var c1 = Application.Master.docCount("Документ 1");
// Получение количества открытых документов с названием "Документ 2"
var c2 = Application.Master.docCount("Документ 2");
// Выполнение сценария при условии, что каждый документ открыт в единственном экземпляре
if(c1 == 1 && c2 == 1)
{
// Получение ссылки на раздел "Раздел 1" документа "Документ 1"
var p1 = Application.Master.getDocument("Документ 1").getPartition("Раздел 1");
// Получение ссылки на раздел "Раздел 1" документа "Документ 2"
var p2 = Application.Master.getDocument("Документ 2").getPartition("Раздел 1");
// Перенос данных из одного раздела в другой (нумерация столбцов в параметрах функции начинается с 0)
// "0<-0;1<-1;" - соотнесение столбцов боковика
// (в примере - первый с первым, второй со вторым)
// "1<-К0 + К1;" - соотнесение столбцов шапки
// (перенос во вторую колонку целевого раздела суммы первой и второй колонок раздела-источника)
Application.Master.transferData(p1, p2, "0<-0;1<-1;", "1<-К0 + К1;");
// Иерархический пересчет по 1 колонке
// Первый параметр - количество колонок для проверки
// Второй параметр - признак строгой проверки (true - да, false - нет)
p2.check(1, true);
// Пересчет формул
p2.reEvaluate();
} else {
MessageBox.information("Ошибка");
}Главное окно модуля вызывается нажатием пиктограммы "Выполнение сценариев" на панели инструментов ТИР. Назначение полей и кнопок окна модуля выполнения сценариев следующее:
левое поле - список доступных сценариев;
правое поле - исходный код текущего сценария;
кнопка "Выполнить сценарий" запускает выполнение текущего сценария;
кнопка "Новый сценарий..." создает новый сценарий;
кнопка "Сохранить сценарий" сохраняет изменения в текущем сценарии;
кнопка "Удалить сценарий" удаляет текущий сценарий;
кнопкой "Поиск сценариев..." выбирается каталог, в котором будет произведен поиск сценариев.
По умолчанию поиск сценариев производится в подкаталоге Scripts каталога ТИР (/opt/irs/tir/share/scripts).