Використовуючи об'єкт Application Object, ви можете показати у звіті змінну, константу або скриптову функцію застосунку.

Each application is a mini-program (plug-in) that runs directly in TechEditor. The application is developed in the TechEditor IDE using the Pascal or Basic programming language (Pascal is the primary language).

Взаємодія застосунку і звіту

Розглянемо взаємодію застосунку і звіту на прикладі. Припустимо, ми маємо застосунок для розрахунку балки "LVL Calculator" і текстовий шаблон "Main Report":

TechEditor | Application Integration Object

Потрібно, щоб в процесі роботи застосунку розрахункові дані автоматично з'являлися у звіті. Для цього у звіт "Main Report" на потрібні місця додані об'єкти Application Object. Кожен такий об'єкт містить посилання на віконний компонент, змінну або функцію застосунку. На рисунку вище показаний об'єкт з наступним скриптом:

Form2.EditBeamLengthL.Text

Тут

  • Form2 — програмне ім'я вікна (форма);
  • EditBeamLengthL — програмне ім'я текстового поля, яке відповідає за довжину балки;
  • Text — текст, який користувач вводить в поле EditBeamLengthL (власне, довжина балки).

Застосунок запрограмований таким чином, що після натискання кнопки "CALCULATE" відбувається автоматичне оновлення звіту. За це відповідає спеціальна скриптова команда

Report.Update;

яка оновлює Application Object у звіті. Завжди додавайте цю команду в код вашого застосунку, якщо потрібно актуалізувати значення усіх Application Object.

Важливо, що "Report.Update;" оновлює тільки активний звіт (тобто звіт, відкритий в активній вкладці редактора). Якщо кілька звітів проекту містять однаковий Application Object, то застосунок може взаємодіяти з кожним з цих звітів — вам достатньо перемикати вкладки і активувати потрібний звіт. Цей функціонал зручно використовувати для створення шаблонів документації.

Як дізнатися імена ідентифікаторів

Імена програмних компонентів, змінні та функції відомі вам, якщо ви власноруч розробляєте застосунки через TechEditor IDE. Імена віконних компонентів та їхні властивості можна дізнатися через Object Inspector.

Якщо функції TechEditor IDE вам недоступні, то цю інформацію потрібно запросити у розробників застосунку (як своєрідне API).

Як додати Application Object до звіту

Помістіть курсор у потрібне місце. Додайте об'єкт до звіту, скориставшись командою Application Object на стрічці інструментів Automation > Report Automation:

TechEditor | Automation ribbon tab

Вікно редактора має вигляд:

TechEditor | Application Integration Object

В загальному випадку, в текстове поле можна записати:

  • змінну, константу чи функцію без аргументів, наприклад "x";
  • функцію з аргументами, наприклад "sin(90*Pi/180)";
  • будь-який скриптовий вираз, наприклад "3*a+b/8".

Формат: текст, багаторядковий текст, формула

У прикладі, наведеному вище, Application Object має вигляд звичайного тексту (Static text). Проте, ви можете додавати до звіту об'єкти у вигляді математичних формул (LaTeX equation) або багаторядкового тексту (Multiline text). Формат об'єкту обирається під час його створення і надалі не може бути змінений.

Static text

Об'єкт виглядає як звичайний текст. Ви можете редагувати шрифт, кегль, колір та інші атрибути в будь-який момент. Об'єкт завжди виводиться суцільно, в один рядок (без переносів), тому найбільш підходить для числових даних, дати/часу або коротких строк.

LaTeX equation

Об'єкт виводиться у вигляді математичної формули, тому застосунок має генерувати строку тексту у форматі LaTeX.

Multiline text

Об'єкт виводиться як багаторядковий текст у таблиці. За стандартними налаштуваннями, таблиця має невидимі границі. Ви можете редагувати шрифт, кегль, колір та інші атрибути тексту, а також формат таблиці, у будь-який момент. Об'єкт підходить для строк тексту будь-якої довжини.