Текстовые документы OpenDocument могут содержать переменные, которые обрабатываются или отображаются с помощью полей-переменных. Переменной называется пара имя/значение. Имя переменной используется во всем документе для обозначения конкретной переменной, и потому имя переменной не может быть заново использовано для определения других типов переменных. Большинство полей-переменных поддерживают различные типы значений, таких как числа, даты, строки и др. В формате файла OpenDocument переменная должна быть объявлена в начале документа.
Имеется три типа переменных.
Простые переменные
Простые переменные, обычно называемые просто переменными, могут принимать различные значения в различных позициях на всем протяжении документа. Простые переменные могут быть установлены с использованием либо полей установки, либо полей ввода. Поля установки содержат выражение, которое используется для вычисления нового значения переменной. Поля ввода запрашивают у пользователя новое значение. Простые переменные могут быть использованы для отображения различного текста в повторяющихся элементах, таких как верхние или нижние колонтитулы.
Переменные пользователя
Переменные пользователя имеют одно и то же значение на протяжении всего документа. Если переменная пользователя установлена в любом месте в пределах документа, все поля в документе, которые отображают переменную пользователя, имеют то же самое значение. В пользовательском интерфейсе офисного приложения переменная пользователя может быть установлена в любом экземпляре поля пользователя или с использованием входных полей переменной пользователя. В формате файла OpenDocument значение переменной пользователя может быть установлено только после объявления переменной.
Переменные последовательности
Переменные последовательности используются для нумерации определенных объектов в текстовом документе OpenDocument, например изображений или таблиц.
Выражения и поля ввода текста также являются полями-переменными, но они не связаны с какими-либо конкретными переменными. Однако, поскольку по функциональности они тесно связаны с полями-переменными, то они также описаны в данном разделе руководства.
Переменные должны быть объявлены прежде, чем они могут быть использованы. Объявления переменных собраны в элементах-контейнерах для переменных определенного типа. Код OpenDocument для объявления переменных описан в разделах 6.3.1, 6.3.5 и 6.3.8.