Формат XLSReport
Що таке XLSReport
XLSReport — це формат авторингу на основі електронних таблиць для побудови report DINO / AJF (Advanced JSON Forms) без написання JSON чи коду вручну. Автор report заповнює звичайну робочу книгу Excel (.xlsx) за набором домовленостей, а конвертер (xls-report.ts, частина бібліотеки AJF reports) розбирає цю робочу книгу у form schema JSON AjfReport, яку платформа DINO може відобразити як живий дашборд: таблиці, діаграми, числа KPI, зображення, графіки, теплокарти тощо.
Дві речі це уможливлюють:
- Відповідність аркушів до віджетів — кожен аркуш у робочій книзі (за кількома спеціальними винятками) стає одним віджетом report. Порядок аркушів у робочій книзі — це порядок, у якому віджети розташовані в готовому report.
- Невелика формульна DSL ("мова індикаторів") — клітинки містять не лише буквальні значення; більшість із них містять короткі вирази (наприклад,
SUM(D04, $persone, $tipo='corso')), написані компактною мінімовою з білим списком. Цю DSL розбираєhindikit-parser.tsі транслює в JavaScript, який потім виконується щодо даних form під час відображення/оновлення за допомогою бібліотеки вбудованих функцій (expression-utils.ts).
Це означає, що XLSReport — насправді дві речі, накладені одна на одну: опис макета (які аркуші створюють які віджети і в якому порядку) та опис обчислень (які формули обчислюють числа, масиви й набори даних, що їх відображають ці віджети). Оскільки базові дані походять з form DINO (даних), будь-яка формула XLSReport зрештою читає з одного або кількох наборів даних form і формує їх у те, що потрібно віджету (одне число, масив для діаграми або таблиця рядків).
XLSReport не залежить від платформи чи проєкту: ті самі домовленості робочої книги застосовуються до будь-якого екземпляра DINO та будь-якого набору form — ніщо у форматі не прив'язане до конкретної організації чи розгортання.
Структура файлу
XLSReport — це одна робоча книга .xlsx. Конвертер перебирає аркуші робочої книги по порядку і вирішує, що робити з кожним, шукаючи ключове слово як підрядок у назві аркуша (а не точний збіг) — наприклад, аркуш із назвою table_activities або 2_table обидва розпізнаються як аркуш "table", бо назва містить table.
Категорії аркушів
| Назва аркуша містить | Роль |
|---|---|
variables (точна назва) |
Оголошує іменовані змінні/набори даних, які використовують наступні аркуші. Сам по собі не створює віджета. |
filter |
Оголошує form-фільтр (у стилі ODK/XLSForm survey + choices), прикріплений до наступного аркуша в робочій книзі. Сам по собі не створює віджета. |
filter і global |
Те саме, що вище, але отриманий фільтр застосовується до всього report, а не до окремого віджета. |
choices |
Допоміжний аркуш зі списками варіантів (list_name, name, label), який використовується разом з аркушами filter. |
table |
Віджет DynamicTable або PaginatedTable. |
chart |
Віджет Chart (стовпчикова, лінійна, кругова тощо). |
image |
Віджет Image. |
html |
Віджет Text, який рендерить сирий HTML. |
graph |
Віджет Graph (вузли/мережа). |
heatmap |
Віджет HeatMap. |
single |
Один або кілька віджетів Text, що утворюють картку KPI/"великого числа". |
paginatedlist |
Віджет PaginatedList (один рядок = мінітабличний віджет). |
paginatedDialogList |
Віджет PaginatedList, рядки якого відкривають діалогове вікно з деталями. |
В іншому назви аркушів довільні — використовуйте їх, щоб робоча книга сама себе документувала (наприклад, table_beneficiaries_by_month, chart_gender_split). Оскільки збіг — це перевірка на підрядок, уникайте назв, які випадково містять інше ключове слово (наприклад, не називайте аркуш діаграми charttable).
Домовленості щодо рядків у межах аркуша
Кожен аркуш віджета читається як звичайне перетворення електронної таблиці в JSON: рядок 1 містить заголовки стовпців, а рядок 2 і далі містять дані, один обʼєкт JSON на рядок із ключами за текстом заголовка. Окрім цього загального правила, кожен тип аркуша визначає власне значення для рядка заголовків і першого-двох рядків даних (задокументовано для кожного віджета в розділі 5).
Загальний макет
Уся робоча книга загортається в один макет верхнього рівня, що містить один стовпець, і кожен неспеціальний аркуш додає рівно один віджет (або, для single, кілька), доданий до цього стовпця в порядку аркушів. Іншими словами:
- Report завжди є єдиним вертикальним стеком віджетів — немає способу на рівні електронної таблиці створити стовпці поруч або вкладені контейнери; єдине "вкладення", яке існує, генерується внутрішньо за допомогою
paginatedlist/paginatedDialogList(кожен рядок сам по собі є невеликим табличним віджетом або діалогом). - Аркуш із назвою
filterприкріплює свій фільтр до того аркуша-віджета, який іде безпосередньо за ним; аркушglobal filterприкріплюється до зовнішнього контейнера report, а не до окремого віджета.
Універсальний шлях відходу: js:
Будь-яка клітинка, яку зазвичай розбирають через формульну DSL, натомість може починатися з js: — усе після цього префікса вважається сирим JavaScript і передається без розбору. Це дає доступ до кожної функції, експортованої бібліотекою утиліт часу виконання, а не лише до тих, що внесені до білого списку граматики DSL (див. розділ 4), а також до довільних виразів JS (IIFE, використання Set/Map, власні вбудовані допоміжні функції тощо). Використовуйте це, коли обчислення не вписується в білий список функцій DSL або форми аргументів.
Оголошення змінних
Аркуш variables — це місце, де ви завантажуєте дані form і попередньо обчислюєте все, що багаторазово використовується кількома віджетами далі в робочій книзі (набори даних, фільтри, значення індикаторів, Мітки).
Стовпці
| Стовпець | Значення |
|---|---|
name |
Ідентифікатор змінної. Має бути коректним ідентифікатором (літери, цифри, підкреслення, не починатися з цифри) — некоректні назви відхиляються. |
value |
Вираз, який розбирають тією самою формульною DSL, що й будь-яку іншу клітинку (або сирий JavaScript із префіксом js:). |
isAIPrompt (необовʼязкові) |
Булеве значення; позначає змінну як результат запиту AI, а не як звичайну формулу, щоб потім її можна було прочитати через PROMPT_RESULT. |
Рядки з порожнім name пропускаються. Змінні обчислюються згори донизу, і кожна змінна може посилатися на будь-яку змінну, оголошену вище неї, за її простою назвою (без префікса $ — цей префікс зарезервовано для полів form, див. розділ 4).
Завантаження даних form
Два пошуки в середовищі виконання завжди доступні:
forms['<назва form>']— сирий масив даних для заданого form DINO.schemas['<назва form>']— form schema цього form (використовується для визначення структури повторюваних груп і Мітки варіантів).
Точний рядок назви form, який слід використовувати, — це ідентифікатор, який DINO призначає цьому form; отримайте його з конфігурації DINO admin/forms для вашого екземпляра (зазвичай він збігатиметься, але не гарантовано точно збігатиметься, з іменем файлу xlsform цього form; перевіряйте на відмінності в пробілах/регістрі/кінцевих пробілах).
Стандартний вступний блок аркуша variables завантажує кожен потрібний form і перетворює його на структурований набір даних:
name | value
F01 | forms['my_form_name']
S01 | schemas['my_form_name']
D01 | BUILD_DATASET(F01,S01)
BUILD_DATASET(forms, schema) розділяє кожні пласкі дані на непосторювані поля верхнього рівня плюс обʼєкт reps, який групує примірники повторюваних груп ("repeat"/slide) за їхньою справжньою назвою групи (похідною від schema). Без schema він вдається до загальної евристики. З цього моменту D01 — це набір даних, який ви фільтруєте, агрегуєте й відображаєте.
Обмеження області / фільтрування набору даних один раз, для кожного наступного використання
Дуже поширений і рекомендований шаблон — відфільтрувати набір даних і перепризначити його тій самій назві змінної, щоб кожна формула, яка посилається на цю змінну від цього моменту, автоматично успадковувала фільтр — замість повторення умови фільтра в кожній формулі:
name | value
D01 | FILTER_BY(D01, $status='active')
Це особливо важливо, оскільки набори даних form часто спільно використовуються більш ніж одним проєктом, кампанією або областю на тому самому екземплярі DINO — ніколи не припускайте, що масив forms['...'] вже обмежений лише потрібними вам даними. Якщо ваші form містять поле проєкту/області (його точна назва залежить від дизайну form вашого екземпляра, наприклад щось на кшталт $project_name), фільтруйте кожен набір даних явно:
scope_name = 'MY PROJECT'
D0X = FILTER_BY(D0X, $project_field = scope_name OR $secondary_project_field = scope_name)
Якщо набір даних має повторювану групу, окремі примірники якої потребують власного обмеження області (наприклад, повтор "participants", де один колективний запис може містити учасників, що належать до різних областей), фільтруйте також на рівні окремого примірника, зазвичай через FLATTEN_REPS у поєднанні з FILTER_BY на пласкому масиві, перш ніж витягувати потрібні значення за допомогою ALL_VALUES_OF (див. розділ 4 для цих функцій). Завжди перевіряйте поле, яке насправді містить ідентифікаційне/довідкове значення примірника повтору — воно може містити не те, на що вказує його назва (наприклад, довідкове поле "participant" усередині повтору може зберігати відображувану назву пов'язаного запису, а не його код/id; перевіряйте на реальних експортованих даних, перш ніж з'єднувати/дедуплікувати за ним, і використовуйте той самий ключ з обох боків будь-якого порівняння).
Змінні AI-запитів
Якщо на рядку змінної встановлено isAIPrompt, її значення представляє результат згенерованого AI запиту, а не звичайну обчислену формулу. В іншому місці робочої книги ви можете отримати цей текст за допомогою PROMPT_RESULT(report_data, '<назва змінної>') та інтерполювати його у віджет HTML або single-indicator.
Огляд формульної DSL
Кожну клітинку без js: розбирає невеликий рекурсивний низхідний парсер у вираз JavaScript, який потім обчислюється щодо контексту даних під час виконання.
Основний синтаксис
| Синтаксис | Значення |
|---|---|
$fieldname |
Посилання на поле form. Транслюється в form.fieldname (form — це той запис, який перебуває в області видимості в цій частині виразу). |
bareIdentifier |
Посилання на назву з аркуша variables, назву функції або літеральне ключове слово. |
'text' / "text" |
Рядковий літерал. |
123, 1.5, 1e3 |
Числовий літерал. |
[a, b, c] |
Літерал масиву. |
func(arg1, arg2, ...) |
Виклик функції — приймаються лише назви функцій із білого списку (див. нижче); усе інше має проходити через js:. |
= |
Рівність (компілюється в JS ==). |
!= |
Нерівність. |
+ - * / , < <= > >= |
Арифметика / порівняння, те саме значення, що й у JavaScript. |
AND / OR |
Логічне і/або (компілюються в && / \|\|). |
!expr |
Логічне не. |
(expr) |
Групування. |
IF(cond, thenExpr, elseExpr) |
Тернарний умовний вираз — вбудована спеціальна форма, а не звичайна функція. |
Приклад:
IF($age >= 18 AND $status = 'active', 'adult-active', 'other')
→ (form.age >= 18 && form.status == 'active' ? 'adult-active' : 'other')
Види аргументів
Оскільки DSL компілюється в JavaScript, але має знати, як інтерпретувати кожен аргумент функції, кожна функція з білого списку має фіксовану сигнатуру аргументів, складену з цих видів:
arg— розбирається як звичайний вираз і передається як є (тож$fieldстаєform.field, тобто значенням поля).field— розбирається як вираз; якщо він виявляється простим посиланням$field, його перетворюють на рядок із назвою поля в лапках замість значення поля (наприклад,$age→'age'), бо функція очікує знати, над яким полем працювати, а не значення.func(form),func(elem),func(elemA, elemB)— розбирається як вираз (зазвичай булева/реляційна умова, написана через$field), а потім загортається у стрілкову функцію JS із зазначеними назвами параметрів, наприклад$gender = 'male'як аргументfunc(form)стає(form) => form.gender == 'male'.- Завершальний
?в аргументі позначає його як необовʼязкові — пропустіть його й усе після нього.
Знання виду аргументу підказує вам, коли писати $field (щоб посилатися на поточне значення поля), а коли той самий синтаксис $field непомітно перетворюється на рядок із назвою поля.
Довідник функцій
Завантаження та формування наборів даних
| Функція | Сигнатура (види) | Опис |
|---|---|---|
BUILD_DATASET |
(arg, arg?) |
Розділяє пласкі дані на поля верхнього рівня + reps (примірники повторюваних груп), використовуючи schema, якщо її надано. |
FLATTEN_REPS |
(arg, arg) |
Створює один вихідний рядок на кожен примірник названої повторюваної групи, об'єднуючи поля верхнього рівня батьківського запису з полями цього примірника. |
FROM_REPS |
(arg, func(form)) |
Обчислює вираз один раз на кожен примірник повторюваної групи (по всіх наданих записах), збираючи непорожні результати в плаский масив. |
APPLY |
(arg, field, func(form)) |
Повертає копію набору даних із новим/похідним полем, встановленим на кожному записі (та його reps). |
APPLY_LABELS |
(arg, arg, arg) |
Замінює сирі значення варіантів їхніми зрозумілими для людини Мітки (з schema) для заданого списку назв полів, на кожному записі та його reps. |
GET_LABELS |
(arg, arg) |
Окремий пошук: зіставляє масив сирих значень варіантів з їхніми Мітки за допомогою schema. |
MAP |
(arg, func(elem)) |
Звичайний map масиву. |
OP |
(arg, arg, func(elemA, elemB)) |
Зіставляє два масиви по індексу, комбінуючи кожну пару бінарним виразом. |
JOIN_FORMS |
(arg, arg, field, field?) |
Ліве з'єднання двох наборів даних за збігом ключового поля з кожного боку. |
JOIN_REPEATING_SLIDES |
(arg, arg, field, field, field, field?) |
Як JOIN_FORMS, але також з'єднує примірники повторюваних груп кожної зіставленої пари за підключем. |
Фільтрування
| Функція | Сигнатура | Опис |
|---|---|---|
FILTER_BY |
(arg, func(form)) |
Повертає відфільтровану копію набору даних; зберігає запис, якщо він збігається на верхньому рівні, або зберігає лише відповідні примірники повторюваних груп, якщо збіг на тому рівні. |
Підрахунок та агрегація
| Функція | Сигнатура | Опис |
|---|---|---|
COUNT_FORMS |
(arg, func(form)?) |
Підраховує записи, що відповідають умові, рахуючи кожен запис один раз, навіть якщо умова відповідає більш ніж одному з його примірників повтору. |
COUNT_REPS |
(arg, func(form)?) |
Підраховує кожен відповідний запис верхнього рівня та кожен відповідний примірник повтору окремо — використовуйте для "кількості входжень", а не "кількості записів". |
SUM |
(arg, field, func(form)?) |
Сума числового поля по записах і примірниках повтору, з необов'язковим фільтром. |
MEAN / MEDIAN / MODE / MIN / MAX |
(arg, field, func(form)?) |
Стандартні агрегатні статистики з необов'язковим фільтром. |
ALL_VALUES_OF |
(arg, field, func(form)?) |
Збирає кожне значення, яке набуває поле, по записах і примірниках повтору, що відповідають необов'язковому фільтру, без дублікатів. Стандартний інструмент для "кількості унікальних X": обгорніть у LEN(...). |
LEN |
(arg) |
Довжина масиву. |
REMOVE_DUPLICATES |
(arg) |
Видаляє дублікати з масиву (за ідентичністю глибокої рівності), зберігаючи порядок. |
INCLUDES |
(arg, arg) |
Чи містить масив (або рядок) значення. |
Дати
| Функція | Сигнатура | Опис |
|---|---|---|
TODAY |
() |
Сьогоднішня дата, YYYY-MM-DD. |
ADD_DAYS |
(arg, arg) |
Дата плюс N днів. |
DAYS_DIFF |
(arg, arg) |
Різниця в цілих днях між двома датами. |
GET_AGE |
(arg, arg?) |
Вік у повних роках за датою народження (і необов'язковою датою, станом на яку обчислюється, за замовчуванням сьогодні). |
IS_BEFORE / IS_AFTER |
(arg, arg) |
Порівняння дат. |
IS_WITHIN_INTERVAL |
(arg, arg, arg) |
Перевірка входження в діапазон дат включно. |
COMPARE_DATE |
(arg, arg, arg, arg?) |
Відносить дату до категорії до/в межах/після діапазону, з необов'язковими власними Мітки. |
Числа та форматування
| Функція | Сигнатура | Опис |
|---|---|---|
ROUND |
(arg, arg?) |
Округлює число до N знаків після коми (за замовчуванням 0). |
PERCENT |
(arg, arg) |
a/b як рядок відсотків. |
PERCENTAGE_CHANGE |
(arg, arg) |
Відсоткова зміна між значенням і опорним значенням. |
CHART_TO_DATA |
(arg, arg) |
Зіставляє паралельні масиви Мітки/значень в один об'єкт. |
FORMAT_TABLE_ROWS / FORMAT_TABLE_COLS / FORMAT_TABLE_FIELDS |
різні | Рендерить масив рядків/стовпців/записів як рядок HTML <table>, корисно всередині віджетів html. |
Вибір
| Функція | Сигнатура | Опис |
|---|---|---|
FIRST / LAST |
(arg, func(form), field?) |
Знаходить найраніший/найпізніший запис за полем дати (за замовчуванням стандартне поле "created at") і обчислює вираз щодо нього. |
AI / налагодження
| Функція | Сигнатура | Опис |
|---|---|---|
PROMPT_RESULT |
(arg, arg) |
Зчитує текст, створений змінною isAIPrompt. |
CONSOLE_LOG |
(arg) |
Виводить значення в консоль і повертає його без змін — зручно для налагодження формули на місці. |
Застарілі (збережені для зворотної сумісності; віддавайте перевагу показаній альтернативі)
| Функція | Краще використовувати |
|---|---|
FILTER_BY_VARS |
FILTER_BY |
COUNT_FORMS_UNIQUE |
LEN(ALL_VALUES_OF(...)) |
ISIN |
INCLUDES |
REPEAT |
MAP |
EVALUATE |
IF |
Поза білим списком
DSL приймає лише функції, наведені вище (плюс IF). Базова бібліотека часу виконання надає додаткові допоміжні функції (статистичні помічники, як-от стандартне відхилення, внутрішні конструктори таблиць/наборів даних віджетів, які використовує сам конвертер, тощо), які не доступні через звичайний синтаксис формул — лише через шлях відходу js: із сирим JavaScript, описаний у розділі 2.4.
Підтримувані віджети та їхні властивості
table — динамічна таблиця
Рядок 1: Мітки заголовків стовпців. Рядок 2: короткий код стилю для кожного стовпця, [colspan][alignment][sortable]:
- Перший символ: colspan (цифра, зазвичай
1). - Другий символ:
l= ліворуч,r= праворуч, будь-що інше = по центру. - Третій символ:
s= стовпець із сортуванням, пропущено/будь-що інше = без сортування.
Починаючи з рядка 3, аркуш поводиться в одному з двох режимів:
A. Таблиця-список form (прив'язана до набору даних) — використовується, коли присутній стовпець dataset:
| Стовпець конфігурації | Значення |
|---|---|
| (власний стовпець кожного заголовка) | Назва поля для відображення в цьому стовпці, узята з кожного запису набору даних. |
dataset |
Назва (масивної) змінної для перебору — зазвичай набору даних, побудованого в variables. |
pagination |
Істинне → створює посторінкову таблицю замість звичайної. |
dialog_fields / dialog_fields_labels |
Розділені комами додаткові назви полів / Мітки, показані в діалоговому вікні деталей "читати далі" для кожного рядка. |
link_field / link_position |
Поле для використання як URL посилання та індекс стовпця, який має рендерити його як посилання. |
B. Статична / обчислена таблиця (без стовпця dataset) — кожен наступний рядок є буквальним вихідним рядком, і кожна клітинка сама по собі є формулою (або літералом, або виразом js:); беріть рядковий літерал у лапки, щоб його не сплутали з простим посиланням на змінну (наприклад, "140" для тексту 140, на противагу my_indicator для відображення значення обчисленої змінної).
Клітинки заголовків стилізовані по центру, жирним, білим текстом на суцільному тлі; клітинки тіла автоматично чергують кольори тла рядків.
chart
Лише рядок 1 (крім Scatter/Bubble, див. нижче). Розпізнавані стовпці-опції (видаляються з рядка, перш ніж решту вважають серіями даних):
chartType, title, stacked, beginAtZeroX, beginAtZeroY, axisLabelX, axisLabelY, axisMinX, axisMinY, axisMaxX, axisMaxY, removeZeroValues, mainDataNumberThreshold.
chartTypeмає бути одним із:Line,Bar,HorizontalBar,Radar,Scatter,Doughnut,Pie,PolarArea,Bubble.labels(необовʼязкові) — формула, що створює масив Мітки категорій/осей.- Кожен інший заголовок стовпця називає одну серію даних; його значення клітинки — формула, що створює масив чисел цієї серії.
- Діаграмам
Scatterпотрібно рівно 2 рядки даних (значення X, значення Y); діаграмамBubbleпотрібно рівно 3 (X, Y, радіус); кожному іншому типу діаграми потрібен рівно 1 рядок даних. - Кольори призначаються автоматично з вбудованої палітри (один колір на серію або один на точку даних для кругової/пончикової/полярної діаграми).
image
Лише рядок 1. Обов'язково: url (формула, що створює URL зображення, або рядковий літерал; додайте префікс js: для виразу сирого JS). Необов'язково: align (left/center/right), width, height (рядки довжини CSS).
html
Лише рядок 1, один стовпець html, що містить сирий рядок HTML (не розбирається формульною DSL). Підтримує маркери інтерполяції у подвійних квадратних дужках [[expression]], які обчислюються й підставляються під час рендерингу — використовуйте це, щоб вбудувати значення обчисленої змінної в інакше статичну розмітку.
single — картка KPI / великого числа
Лише рядок 1:
| Стовпець | Значення |
|---|---|
html (необовʼязкові) |
Заголовок, показаний над числом. |
current_value |
Обов'язково. Змінна/вираз, значення якого показано як велике число (рендериться через [[current_value]]). |
percentage_change (необовʼязкові) |
Якщо присутнє, додає індикатор тенденції (стрілка вгору/вниз/без змін із кольором) на основі його знака, показаний як [[percentage_change]]%. |
Оскільки той самий текст клітинки використовується і як інтерпольоване значення, і як сирий вираз порівняння, current_value / percentage_change зазвичай мають бути простими назвами змінних, визначених на аркуші variables, а не повними вбудованими формулами.
graph
Кожен рядок потребує непорожнього стовпця id. Кожен стовпець у кожному рядку (окрім id) розбирається як формула, створюючи один набір даних вузлів графа на рядок.
heatmap
Лише рядок 1, усі стовпці необовʼязкові з розумними значеннями за замовчуванням: values (рядок сирого JS/формули, що створює дані інтенсивності — не розбирається через дужкову DSL, має вже бути коректним), idProp (за замовчуванням 'id'), features (рядок GeoJSON), startColor, endColor, highlightColor, showVisualMap.
paginatedlist
Рядок 1: числовий відсоток ширини стовпця для кожного стовпця. Рядок 2 (рядок конфігурації): назва поля для кожного стовпця, плюс dataset, title, pageSize (за замовчуванням 10), link_field/link_position, cellStyles, rowStyle (літерал сирого об'єкта стилю), backgroundColorA/backgroundColorB (кольори зебрового чергування). Кожен отриманий рядок рендериться як власний компактний табличний віджет, а не як одна велика таблиця.
paginatedDialogList
Та сама конфігурація, що й paginatedlist, плюс два додаткові рядки (коли присутні): Мітки полів діалогу, потім назви полів діалогу — клацання на рядку відкриває спливне вікно зі списком цих полів як пар Мітка/значення.
filter / global filter
Структурований як аркуш survey ODK/XLSForm (із супутнім аркушем choices у тій самій робочій книзі), перетворений на form schema і прикріплений як інтерактивний елемент керування фільтром:
- Аркуш із назвою, що містить
filter(але неglobal), прикріплюється до віджета наступного аркуша. - Аркуш із назвою, що містить і
filter, іglobal, прикріплюється до всього report, а не до окремого віджета.
Швидкий контрольний список для побудови нового XLSReport
- Визначте потрібний form(и) DINO та їхні точні назви form/schema на вашому екземплярі.
- Почніть аркуш
variables: завантажте кожен form за допомогоюforms[...]/schemas[...], побудуйте набори даних за допомогоюBUILD_DATASETі негайно застосуйте будь-які фільтри проєкту/області (перепризначте ту саму назву змінної). - Попередньо обчисліть усе, що використовується більш ніж одним віджетом, як окрему іменовану змінну.
- Додайте по одному аркушу на кожен віджет, названий правильним ключовим словом, у тому порядку, у якому ви хочете їх бачити.
- Віддавайте перевагу білому списку DSL із розділу 4.3; вдавайтеся до
js:лише тоді, коли обчислення в нього не вписується. - Перевірте назви полів і значення варіантів за фактичним schema/експортованими даними на вашому екземплярі, а не припускайте, що вони точно збігаються з назвами полів вихідного xlsform.