Селектор дозволяє працювати зі списками та таблицями як зі звичайним текстом або математичними об'єктами.
Загальна інформація
Основне призначення об'єкта автоматизації Selector — інтеграція табличних даних з обчисленнями в документі.
Працюючи з селектором, ви можете:
- додавати до звіту або діаграми випадаючий список;
- передавати в документ будь-які структуровані дані: текст, числа, фізичні величини, формули;
- гнучко керувати одиницями вимірювання кожного параметру списку або таблиці;
- інтегрувати список або таблицю з математичною моделлю документу;
- використовувати ресурсні документи як єдине джерело даних, та ін.
Принцип дії селектора
Selector виводить на екран елемент списку або комірку таблиці. В документі ці дані відображаються простим текстом, то ж візуально їх неможливо вирізнити з-поміж інших. Це властиво й іншим об'єктам автоматизації (наприклад, Math Object або Slider).
Порада: якщо вам потрібно швидко знаходити селектор в документі, виділіть його напівжирним шрифтом або іншим кольором.
Щоб відкрити пов'язаний з селектором елемент управління (випадаючий список), двічі клацніть по ньому. Обираючи потрібний рядок, ви змінюєте дані селектора. Щоб налаштувати джерело даних та інші опції, натисніть кнопку "...".
Робота з об'єктом Selector
Як додати Selector
Щоб додати новий селектор до документу, скористайтеся командою Selector на стрічці інструментів Automation > Common Objects:
Оберіть тип селектора:
- Single selector or root object (кореневий селектор)
- Reference to an existing selector (посилання на існуючий селектор)
Як обрати тип селектора
Логіка побудови документу може потребувати неодноразово звертатися до різних комірок однієї й тієї ж таблиці, в тому числі з різних місць. Щоб не дублювати дані і керувати ними більш централізовано, достатньо додати до документу один "кореневий" селектор (опція Single selector or root object), а інші дані цієї таблиці виводити на екран через посилання (опція Reference to an existing selector).
Звертаючись до таблиці вперше, завжди обирайте опцію Single selector or root object.
Як налаштувати селектор
Редактор селектора має наступний вигляд:
Секція Source
Секція Source містить таблицю даних та опції, які керують форматом:
- Name — назва селектора (використовується опціонально, для селекторів-посилань);
- Resource — перелік доступних ресурсних документів;
- Separator — роздільник стовпців, що використовується в таблиці.
Дані в таблиці повинні мати однотипний формат і бути відокремлені однаковим роздільником (опція Separator). Кількість стовпців і рядків в загальному випадку не обмежується.
Секція Input
Секція Input визначає, які дані потрібно синхронізувати з математичною моделлю документа. Ця секція є опціональною.
За базовими налаштунками, поле Use in document порожнє (жодні дані таблиці в обчислення не передаються). В математичну модель можна передати параметри, які розташовані в таблиці у рядку з номером Parameter Row. Не обов'язково передавати до розрахунку усі параметри; в полі Use in document достатньо перелічити лише ті, що потрібні в обчисленнях. Параметри мають бути розділені символом Separator.
Якщо таблиця містить числові дані, то поле Units Row можна лишити порожнім. Якщо таблиця оперує фізичними величинами, то в полі Units Row потрібно вказати рядок, де записані їхні одиниці вимірювання (зазвичай, це наступний рядок після Parameter Row).
Кнопка Auto-header передає в поле Use in document рядок таблиці, вказаний в Parameter Row.
Як і в інших об'єктах автоматизації TechEditor (наприклад, Math LaTeX Object), інформація в секції Input не відображається на екрані. Тут ми лише вказуємо програмі, які параметри потрібно передати в обчислення. Вивести ці дані на екран або виконати над ними певні операції можна в секції Output, або за допомогою інших об'єктів (наприклад Math Object).
Секція Output
Секція Output відповідає за інформацію, яка буде виведена на екран.
Призначення полів:
- title — довільний текст;
- expression — довільний математичний вираз;
- column — номер стовпця;
- format — формат числових даних.
Якщо заданий номер стовпця (column), то на екран виводиться комірка таблиці, що відповідає цьому стовпцю.
Якщо заданий математичний вираз (expression), то на екран виводиться результат його обчислення. Зверніть увагу, що в полі expression можна використовувати будь-які параметри, що вказані в Use in document секції Input.
Поле title можна використати, щоб додати до фінального тексту довільний текстовий префікс.
Отримання даних для селектора
Табличні дані для селектора можуть бути доступні:
- безпосередньо з секції Source;
- з ресурсного документа;
- через посилання на існуючий (кореневий) селектор.
Дані з секції Source
Цей варіант рекомендується, якщо селектор виконує свою функцію один раз. У такому випадку, просто заповніть таблицю Source і користуйтеся селектором.
Дані з ресурсного документу
В процесі розробки документації вам може знадобитися кілька разів звернутися до однієї й тієї ж таблиці.
Найпростіше це зробити, скопіювавши селектор в потрібне місце документу. У такому випадку, об'єкт продублюється з усіма даними, проте зміни в попередньому об'єкті не вплинуть на новий об'єкт. Щоб обидва об'єкти "зверталися" до однієї й тієї ж таблиці, створіть ресурсний документ типу Data table. Сформуйте потрібну таблицю в цьому документі. Після цього, оберіть цей документ у списку Resource селектора.
Увага! Щойно ви обираєте документ в списку Resource, інформація з нього автоматично додається до таблиці даних. Попередні дані таблиці видаляються.
Селектор-посилання
Якщо під час створення селектора ви обрали Reference to an existing selector, то замість нового селектора ви додасте посилання на існуючий селектор:
Селектор-посилання використовує дані наявного селектора, лише змінюючи стовпець таблиці. Це може значно прискорити роботу з таблицею, адже не потрібно заповнювати усі поля селектора.
Опції селектора-посилання:
- Name of the root selector — назва основного "кореневого" селектора (має співпадати з його полем Name);
- Column index — номер стовпця, дані з якого потрібно вивести на екран.
