ГОСТ Р ИСО/МЭК 26300-2010. Национальный стандарт Российской Федерации. Информационная технология. Формат Open Document для офисных приложений (OpenDocument) v1.0

(утв. и введен в действие Приказом Росстандарта от 21.12.2010 № 800-ст)

НАЦИОНАЛЬНЫЙ СТАНДАРТ РОССИЙСКОЙ ФЕДЕРАЦИИ

ИНФОРМАЦИОННАЯ ТЕХНОЛОГИЯ

ФОРМАТ OPEN DOCUMENT ДЛЯ ОФИСНЫХ ПРИЛОЖЕНИЙ (OpenDocument) v1.0

Information technology — Open Document Format for Office Applications (OpenDocument) v1.0

ISO/IEC 26300:2006 Information technology — Open Document Format for Office Applications (OpenDocument) v1.0 (IDT)

Предисловие

Цели и принципы стандартизации в Российской Федерации установлены Федеральным законом от 27 декабря 2002 г. № 184-ФЗ «О техническом регулировании», а правила применения национальных стандартов Российской Федерации — ГОСТ Р 1.0-2004 «Стандартизация в Российской Федерации. Основные положения».

Сведения о стандарте

1. Подготовлен Евро-Азиатской ассоциацией производителей товаров и услуг в области безопасности (Ассоциация ЕВРААС) на основе аутентичного перевода международного стандарта, указанного в пункте 4, который выполнен ООО «Инфра-Ресурс».

2. Внесен Техническим комитетом по стандартизации ТК 22 «Информационные технологии».

3. Утвержден и введен в действие Приказом Федерального агентства по техническому регулированию и метрологии от 21 декабря № 800-ст.

4. Настоящий стандарт идентичен международному стандарту ИСО/МЭК 26300:2006 «Информационная технология. Формат Open Document для офисных приложений (OpenDocument) v1.0» (ISO/IEC 26300:2006 «Information technology — Open Document Format for Office Applications (OpenDocument) v1.0»).

5. ISO/IEC 26300 был подготовлен техническим комитетом OpenDocument организации OASIS как «OASIS Open Document for Office Applications (OpenDocument) v1.0 (second edition)» и выдвинут по процедуре ПДС — публично доступная спецификация (PAS — Publicly Available Specification) совместным техническим комитетом ИСО/МЭК СТК 1 «Информационные технологии» (ISO/IEC JTC 1, Information technology) параллельно с его одобрением органами стандартизации ИСО и МЭК. Содержания ISO/IEC 26300 и второй редакции OASIS OpenDocument v1.0 идентичны.

6. Введен впервые.

Информация об изменениях к настоящему стандарту публикуется в ежегодно издаваемом информационном указателе «Национальные стандарты», а текст изменений и поправок — в ежемесячно издаваемых информационных указателях «Национальные стандарты». В случае пересмотра (замены) или отмены настоящего стандарта соответствующее уведомление будет опубликовано в ежемесячно издаваемом информационном указателе «Национальные стандарты». Соответствующая информация, уведомление и тексты размещаются также в информационной системе общего пользования — на официальном сайте Федерального агентства по техническому регулированию и метрологии в сети Интернет.

1. ВВЕДЕНИЕ

1.1. Структура и цель стандарта

В данном документе описана XML-схема для офисных приложений и ее семантика. Рассматриваемая схема охватывает офисные документы, включая текстовые документы, электронные таблицы, диаграммы и графические документы, такие как рисунки и презентации, но не ограничивается этими типами документов.

Рассматриваемая схема обеспечивает высокий уровень информативности, необходимый для редактирования документов. Она описывает структуры XML для офисных документов и достаточно просто изменяется с помощью XSLT или схожих инструментов, основанных на XML.

Раздел 1 содержит введение в формат OpenDocument. Структура документа, соответствующего спецификации OpenDocument, описана в разделе 2. Раздел 3 описывает метаинформацию, которая может содержаться в таких документах. Разделы 4 и 5 описывают текст документа в целом и его абзацы. Текстовые поля описываются в разделе 6, текстовые индексы — в разделе 7.

Раздел 8 описывает таблицы документа формата OpenDocument, раздел 9 - графические объекты, раздел 10 - диаграммы, раздел 11 - формы. Содержимое, общее для всех документов, описывается в разделе 12. Интеграция разметки SMIL-анимации в схему OpenDocument описана в разделе 13. В разделе 14 описаны стили, в разделе 15 определены свойства форматирования, которые могут быть использованы в стилях. Типы данных, используемые в схеме OpenDocument, описаны в разделе 16.

Формат OpenDocument поддерживает концепцию пакетов, представленную в разделе 17.

1.2. Нотация

В данной спецификации такие ключевые слова как «должен» («shall»), «не должен» («shall not»), «следует» («should»), «не следует» («should not») и «может» («may») необходимо трактовать как в Приложении H [ISO/IEC Directives], если они даны полужирным шрифтом.

1.3. Пространства имен

В таблице 1 представлены пространства имен, которые определены форматом OpenDocument, и их префиксы, используемые по умолчанию. Более подробную информацию о пространствах имен XML можно получить в спецификации Пространства имен в XML [xml-names].

В таблице 2 приведен список пространств имен, описанных в формате OpenDocument, которые содержат элементы и атрибуты, чья семантика совместима с элементами и атрибутами других спецификаций.

Пространства имен XML, определенные схемой OpenDocument, которые включают элементы и атрибуты, совместимые с другими стандартами

Таблица 3 содержит список пространств имен, импортированных в формат OpenDocument, и их префиксы по умолчанию.

Таблица 3

Пространства имен XML, используемые в схеме OpenDocument

1.4. Схема Relax-NG

Нормативная XML-схема для формата OpenDocument содержится внутри данной спецификации. Она может быть получена из документа спецификации путем объединения всех фрагментов схемы, содержащихся в разделах 1 - 16. Все фрагменты схемы имеют серый фон, а строки пронумерованы.

Язык схемы, применяемый в спецификации — Relax-NG (см. [RNG]). Значения по умолчанию атрибутов определены в спецификации [RNG-Compat], которая используется для обеспечения атрибутов значениями по умолчанию.

Схема, приведенная в этой спецификации, допускает произвольное наполнение в пределах элементов метаинформации, как описано в разделе 1.5. В Приложении A приведена схема, которая ограничивает содержимое в пределах этих элементов для атрибутов и элементов, определенных в данной спецификации.

Префикс для нормативной Relax-NG схемы:

1.5. Обработка документа и его соответствие спецификации

Документы, соответствующие спецификации OpenDocument, могут содержать элементы и атрибуты, не определенные данной схемой OpenDocument. Такие элементы и атрибуты не должны быть частью пространств имен, которые определены в данной спецификации, и называются внешними элементами и атрибутами.

Приложения, соответствующие спецификации, должны либо читать документы, соответствующие схеме, если все внешние элементы и атрибуты удалены до проверки соответствия, либо должны записывать документы, соответствующие схеме, если все внешние элементы и атрибуты удалены до проверки соответствия.

Приложения, соответствующие схеме, которые читают и записывают документы, могут сохранять внешние элементы и атрибуты.

Кроме того, приложения, соответствующие схеме, должны сохранять метаинформацию и содержание стилей. Это означает:

      произвольные  атрибуты   и   могут   иметь  произвольное   содержание
      элементов. Все атрибуты,  относящиеся к  таким элементам, и элементы,

содержащиеся в них, следует сохранять (см. раздел 15.1.3). - Элементы, содержащиеся в элементе office:meta, могут иметь произвольное содержимое, и их следует сохранять (см. раздел 2.2.1).

Внешние элементы могут иметь атрибут office:process-content с возможными значениями true или false. Если значение атрибута true, или если атрибут не существует, содержимое элемента следует обрабатывать приложениям, соответствующим данной спецификации. В противном случае приложениям не следует обрабатывать содержимое элементов, а можно только сохранять их содержимое. Если содержимое элемента требуется обработать, сам документ должен соответствовать схеме OpenDocument при условии замены неизвестных элементов на их содержимое.

Приложения, соответствующие схеме, должны читать документы, содержащие инструкции обработки, и данным приложениям следует сохранять их.

Не существует правил относительно элементов и атрибутов, которые следует поддерживать приложениям, соответствующим схеме, за исключением того, что приложения не должны использовать внешние элементы и атрибуты для реализации функциональности схемы OpenDocument (см. также Приложение D).

1.6. Обработка пробельных символов и символов конца строки

В соответствии со спецификацией W3C XML [XML1.0] необязательные пробельные символы, которые содержатся в элементах, являющихся контейнерами других элементов (содержащих только другие элементы, исключая текст), игнорируются. Данное правило применимо к следующим пробельным символам и символам конца строки (EOL) [UNICODE]:

• ГОРИЗОНТАЛЬНАЯ ТАБУЛЯЦИЯ (0x0009)
• ПЕРЕВОД СТРОКИ (0x000A)
• ВОЗВРАТ КАРЕТКИ (0x000D)
• ПРОБЕЛ (0x0020)

Для любых других элементов пробельные символы сохраняются по умолчанию. Если отдельно не оговорено, никакая другая специальная обработка пробельных символов не осуществляется. Для некоторых элементов возможна другая обработка пробельных символов, например, для элемента абзаца.

Спецификация XML также требует, чтобы любой из четырех пробельных символов, которые содержатся в значении атрибута, преобразовывался в символ ПРОБЕЛА.

Один из следующих символов может быть использован для отображения конца строки:

• ПЕРЕВОД СТРОКИ
• ВОЗВРАТ КАРЕТКИ
• последовательность символов ПЕРЕВОД СТРОКИ и ВОЗВРАТ КАРЕТКИ

В соответствии со спецификацией XML, все возможные варианты конца строки преобразуются в один символ ПЕРЕВОД СТРОКИ.

В соответствии с правилами обработки пробельных символов и символов конца строки, любой символ ВОЗВРАТА КАРЕТКИ, который находится либо в текстовом содержимом элемента, либо в значении атрибута, заменяется на символьную сущность . То же осуществляется с символами ГОРИЗОНТАЛЬНАЯ ТАБУЛЯЦИЯ и ПЕРЕВОД СТРОКИ, если они содержатся в значениях атрибута.

1.7. Типы MIME и расширения имен файлов

Для офисных документов, которые соответствуют данной спецификации, но не содержатся в пакетах, следует использовать тип MIME text/xml.

Для офисных документов, соответствующих данной спецификации, следует использовать только типы MIME и расширения имен файлов, зарегистрированные в соответствии с [RFC2048]. Типы MIME и расширения имен файлов, перечисленные в Приложении C, следует использовать по назначению.

2. СТРУКТУРА ДОКУМЕНТА

В данном разделе описана структура формата OpenDocument. Раздел содержит следующие подразделы:

• корни документа;
• метаданные документа;
• элемент основной части документа и типы документов;
• настройки приложений;

• объявления начертания шрифта;
• стили;
• стили и макеты страниц.

В формате OpenDocument каждый структурный компонент представлен элементом со связанными с ним атрибутами. Структура документа в формате OpenDocument применяется ко всем типам документов. Не существует разницы между текстовыми документами, электронными таблицами или графическими документами, различие лишь в их содержимом. Кроме того, все типы документов могут содержать различные стили. Содержимое документа, общее для всех типов документов, может быть использовано для обмена информацией между различными типами документов.

2.1. Корни документа

      имеет  свой   собственный   корень  и   содержит   отдельный   аспект

      XML-документа. Например, один поддокумент содержит  стили,  другой  -

      содержимое  документа.   Все  типы  документов,  например,  текстовые

      документы и электронные   таблицы,   используют   общие   определения

  документов и поддокументов.<br>

2.1.1 Модели содержимого корневых элементов документа

Корневой элемент	Метаданные	Настройки приложения	Скрипты	Определения шрифтов	Стили	Автоматические стили	Стили составных документов	Основная часть документа
office:document
	office:document-content
office:document-styles
office:document-meta
office:document-settings

Корень office:document-content включает только содержимое документа наряду с требуемыми для него автоматическими стилями.

Корень office:document-styles содержит все именованные стили документа наряду с необходимыми для них автоматическими стилями.

Корень office:document-settings содержит специфические настройки приложения, используемые для обработки документа.

2.1.2 Атрибуты корня документа

Все корневые элементы имеют атрибут office:version, который показывает, к какой версии спецификации он относится. Номер версии представлен в формате revision.version (ревизия.версия). Если файл имеет версию, известную XML-процессору, данный документ может быть проверен на соответствие. В противном случае проверка на соответствие документа необязательна, но при этом он должен быть правильно сформирован.

Элемент office:document имеет атрибут office:mimetype, который показывает тип документа (текст, электронная таблица и т.д.). Данный атрибут особенно важен для простых XML-файлов, для которых существует только один способ, которым может быть определен тип документа (в пакете тип MIME также представлен в отдельном файле, см. раздел 17.4). Значениями данного атрибута являются типы MIME, которые используются для пакетного варианта офисных документов (см. раздел 1.7).

2.2. Метаданные документа

Метаданные - главная информация о документе. В формате OpenDocument все элементы метаданных содержатся в элементе office:meta, располагаемом обычно в начале документа. Элементы метаданных могут быть опущены или встречаться несколько раз. Обновление множественных вхождений одного типа элементов зависит от приложения.

2.2.1 Предопределенные и специфические метаданные

В схеме OpenDocument метаданные состоят из предопределенных элементов метаданных, определяемых пользователем, а также специфических метаданных. Предопределенные элементы метаданных имеют предопределенную семантику. Их следует обрабатывать и обновлять редактирующим приложением. На них можно ссылаться из документа, используя подходящие текстовые поля.

Определяемые пользователем метаданные - более общий механизм определения тройки: имя, тип, значение. Поддерживающие приложения могут предоставлять эти значения пользователю, используя предоставляемые типы данных. На метаданные, определяемые пользователем, можно ссылаться из документа, используя подходящие текстовые поля.

Специфические метаданные - любые элементы внутри office:meta. Так как их семантика не определена в этой спецификации, приложения, соответствующие схеме, не могут обработать или показать такие данные. Приложениям следует сохранять эти данные при редактировании документа.

2.2.2 Образец метаданных

2.3. Элемент основной части документа и типы документов

Основная часть документа - это элемент, отображающий тип содержимого этого документа. В настоящее время поддерживаются следующие типы документов:

• текстовые документы;
• графические документы;
• документы презентаций;

• документы диаграмм;
• документы растровой графики.

Все типы документов используют одинаковые элементы содержимого, но каждый тип документа накладывает свои ограничения на использование различных элементов и их комбинации. В содержимом документа обычно выделяются пролог и эпилог, которые содержат дополнительную информацию для специфических типов документов, такую как данные формы или объявление переменных.

2.3.1 Текстовые документы

Содержимое текстовых документов в основном состоит из последовательности, содержащей любое число абзацев, таблиц, индексов, текстовых фреймов, текстовых разделов и графических элементов. В дополнение к этому, текстовый документ может содержать формы, отслеживание изменений и объявления переменных. Каждый из них определяется в прологе, и на них можно ссылаться из содержимого документа.

Модель содержимого текстового документа

Пролог текстового документа содержит данные формы документа, отслеживание изменений и объявления переменных. Для того чтобы разрешить офисным приложениям использовать в текстовых документах функциональные возможности, присущие электронным таблицам, они также могут содержать элементы, реализующие расширенные табличные свойства (см. раздел 2.3.4).

Содержимое основного документа состоит из любой последовательности элементов текстового содержимого, которое включает абзацы (и заголовки), текстовые разделы (и индексы), таблицы, объекты векторной графики. В качестве альтернативы текстовый документ может содержать отдельную последовательность страниц.

Необязательно текстовый документ должен содержать абзац. Текстовый документ может состоять из единственной последовательности фреймов.

Для текстовых документов нет специфических элементов эпилога, но эпилог может содержать элементы, которые реализуют расширенные табличные свойства (см. раздел 2.3.4).

Составные текстовые документы

Существует общий вариант использования больших документов, редактируемых в разных сущностях, основанный на том, что составной документ содержит несколько связанных поддокументов. Это может быть реализовано при использовании связанных разделов текста (см. раздел 4.4). С целью облегчения редактирующему приложению адаптации пользовательского интерфейса для лучшей поддержки представления составного документа с составляющими частями (в отличие от документа с произвольно связанными частями) может быть использован флаг text:global. Если он установлен в значение true, то это сообщает приложению, что связанные разделы документа несут семантику "часть - целое". Фактическое XML-представление раздела при этом не изменяется.

2.3.2 Графические документы

Содержимое графических документов состоит из последовательности страниц изображений.

Модель содержимого графического элемента

Пролог графического документа может содержать только текстовые объявления. Для того чтобы разрешить офисным приложениям использовать в графических документах функциональные возможности, присущие электронным таблицам, они также могут содержать элементы, реализующие расширенные табличные свойства (см. раздел 2.3.4).

Содержимое главного документа состоит из последовательности страниц изображений.

Для графических документов нет специфических элементов эпилога, но эпилог может содержать элементы, которые реализуют расширенные табличные свойства (см. раздел 2.3.4).

2.3.3 Документы презентаций

Содержимое документов презентаций состоит из последовательности страниц изображений.

Модель содержимого документа презентации

Пролог документа презентации идентичен графическому документу, но может содержать некоторые дополнительные определения (см. раздел 2.3.2).

Содержимое главного документа состоит из последовательности страниц изображений.

Эпилог документов презентаций может содержать настройки презентации. Дополнительно он может включать элементы, которые реализуют расширенные табличные свойства (см. раздел 2.3.4).

2.3.4 Документы электронных таблиц

Содержимое документов электронных таблиц в основном состоит из последовательности таблиц. Дополнительно документы электронных таблиц могут содержать формы, информацию о произведенных изменениях и различные виды объявлений, которые упрощают использование электронных таблиц и их анализ. Каждый из них содержится либо в прологе документа, либо в эпилоге.

Модель содержимого документа электронных таблиц

Пролог документа электронных таблиц содержит данные формы документа, информацию о произведенных изменениях, настройки вычислений для формул, правила проверки содержимого ячеек и объявления меток диапазонов.

Главный документ - это список таблиц.

Эпилог документов электронных таблиц содержит объявления для именованных выражений, диапазонов баз данных, сводных таблиц, операций по консолидации и DDE-ссылок.

2.3.5 Документы диаграмм

Содержимое документов диаграмм в основном состоит из элементов диаграмм.

Модель содержимого документа диаграмм

Для того чтобы позволить офисным приложениям использовать для таблиц, которые могут содержаться в диаграммах, функциональные возможности, присущие электронным таблицам, пролог документа диаграмм может содержать элементы, реализующие расширенные табличные свойства (см. раздел 2.3.4).

Главный документ представляет собой единственный элемент диаграммы.

Для документов диаграмм не существует специальных элементов, описываемых в эпилоге. Однако эпилог может содержать элементы, которые реализуют расширенные табличные свойства (см. раздел 2.3.4).

2.3.6 Документы растровой графики

Содержимое документа растровой графики представляет собой только элемент фрейма. Элемент фрейма должен содержать единственный элемент изображения.

Модель содержимого документа растровой графики

Содержимое главного документа состоит только из одного фрейма.

Для документов растровой графики не существует специальных элементов, описываемых в эпилоге.

2.4. Параметры настройки приложений

Параметры настройки офисных приложений можно разделить на несколько категорий, каждая из которых представлена элементом config:config-item-set. Например, могут существовать две категории:

• параметры документа, например, принтер, используемый по умолчанию;

2.4.1 Последовательность параметров настройки

Элемент config:config-item-set является контейнером для всех типов параметров настройки. Параметры настройки могут содержаться в элементе в любом порядке.

Имя параметров настройки

Атрибут config:name определяет имя контейнера параметров настройки. Для элементов верхнего уровня config:config-item-set существуют элементы, непосредственно дочерние элемента office:settings, имени которых должен предшествовать префикс пространства имен, определяющий приложение, к которому относятся параметры настройки.

Пример.

2.4.2 Основные параметры настройки

Элемент config:config-item содержит все основные параметры настройки. Значение параметра хранится в элементе.

Имя параметра настройки

Атрибут config:name устанавливает имя параметра настройки.

Тип параметра настройки

Атрибут config:type устанавливает тип данных параметра настройки.

2.4.3 Индексный доступ к последовательностям

Элемент config:config-item-map-indexed является контейнером для последовательностей. Порядок определяет индекс элементов.

Атрибут config:name устанавливает имя последовательности параметров настройки.

2.4.4 Запись в ассоциированный массив

Элемент config:config-item-map-entry представляет запись в проиндексированной или именованной последовательности параметров настройки. Он является контейнером для всех типов элементов параметров настройки.

Атрибут config:name устанавливает имя последовательности параметров настройки.

2.4.5 Именованный доступ к последовательностям

Элемент config:config-item-map-named является контейнером для последовательностей, где каждый параметр настройки в последовательности определяется по имени.

Атрибут config:name устанавливает имя последовательности параметров настройки.

2.4.6 Параметры настройки позиции курсора

Позиция текстового курсора во время сохранения документа является общим параметром настройки визуального отображения для приложений, осуществляющих редактирование. Для WYSIWYG-приложений это, как правило, только позиция в абзаце. Для приложений, которые обеспечивают просмотр документа на основе XML, позиция курсора также может быть между произвольными элементами, даже внутри тегов.

Для отображения позиции текстового курсора в документе следует использовать инструкцию обработки PITarget opendocument (см. § 2.6 в [XML1.0]). Имя инструкции обработки позиции курсора, cursor-position, должно следовать PITarget opendocument. Инструкция обработки может иметь произвольные атрибуты, специфические для приложения, например, для связи позиции курсора с определенным визуальным отображением документа, где сами виды отображения определяются параметрами настройки, специфичными для приложения. Синтаксис для таких атрибутов должен быть идентичен синтаксису атрибутов в начальных XML-тегах.

Там, где позиция курсора не важна для восстановления визуального отображения документа, приложения могут использовать произвольные параметры настройки, специфические для документа, в дополнение к инструкции обработки позиции курсора. Также они могут использовать произвольные параметры настройки, специфические для документа, если позиция курсора не является позицией курсора ввода, а, например, выделения графических объектов.

2.5. Скрипты

Документ может содержать несколько скриптов на разных языках. Каждый скрипт представлен элементом office:script. Все такие элементы скриптов содержатся в единственном элементе office:scripts.

Понятие скрипт не накладывает ограничения на язык скрипта или объектную модель. Скрипт может работать с объектной моделью документа (Document Object Model (DOM)) в формате OpenDocument или со специфичными функциями API приложения.

Скрипты не могут изменять документ во время его загрузки. Однако некоторые события вызываются немедленно после загрузки документа.

В дополнение к элементам office:script, элемент office:scripts может также содержать элемент office:event-listeners, который содержит события, связанные с самим документом. Примером являются события, вызываемые во время открытия или закрытия документа. См. раздел 12.4 для получения более подробной информации об элементе office:event-listeners.

2.5.1 Скрипт

Элемент office:script содержит специфичное для языка скрипта содержимое. В большинстве случаев элемент содержит исходный код скрипта, но также он может содержать скомпилированную версию скрипта или ссылку на некоторый внешний код скрипта.

Атрибут script:language определяет язык скрипта по его названию. Так как названия языков скрипта специфичны для приложения, названию должен предшествовать префикс пространства имен.

2.6. Объявления начертания шрифта

Документ в формате OpenDocument может содержать объявления начертания шрифта. Объявление начертания шрифта предусматривает информацию о шрифтах, используемых автором документа, так что эти шрифты или шрифты, очень близкие к ним, могут быть использованы на других системах (см. раздел 14.6).

2.7. Стили

Формат OpenDocument поддерживает три типа стилей. - Общие стили

      Большинство офисных  приложений поддерживает  стили в пределах своего
      пользовательского   интерфейса.    В   рамках   данной   спецификации
      XML-представления   таких   стилей   упоминаются   как  стили.  Когда
      требуется  дифференциация  с  другими  стилями,  они  упоминаются как
      общие  стили.   Термин  "общий"  показывает,  что   этот  тип   стиля

  воспринимается пользователем офисного приложения как стиль.
- <a id="p100390"></a>Автоматические стили

      Автоматические  стили  содержат  свойства  форматирования,  которые в
      пользовательском   интерфейсе   визуального   отображения   документа
      связаны   с  объектом,   таким  как  абзац.  Термин  "автоматический"
      показывает, что стиль формируется   автоматически.  Другими  словами,
      свойства   форматирования,   которые   непосредственно   связаны   со
      специфичным  объектом,  представлены   автоматическим  стилем.  Таким

  образом достигается разделение содержимого и дизайна.
- <a id="p100392"></a>Мастер-стили

      Мастер-стиль  -  это  общий  стиль,  который  содержит  информацию  о
      форматировании   и   дополнительное    содержимое,   отображаемое   с
      содержимым документа  при  применении  стиля.  Примером  мастер-стиля
      являются мастер-страницы.  Мастер-страницы  могут  быть  использованы
      в графических приложениях. В  этом случае дополнительное содержимое -
      векторные фигуры, отображаются в  качестве фона графической страницы.

  Мастер-страницы также могут быть использованы в текстовых документах.

      В  этом  случае  дополнительное  содержимое - это  верхние  и  нижние
      колонтитулы.  Отметьте,  пожалуйста,  что  содержимое, содержащееся в
      мастер-стилях,  -  дополнительное   содержимое,  которое   влияет  на

  отображение документа, но не изменяет содержимого документа.

Все типы стилей являются частью документа, что соответствует заинтересованности пользователей офисных приложений. Они представляют выходной аппаратно-независимый макет страницы и информацию о форматировании, необходимые пользователю для создания или редактирования документа. Предполагается, что автор документа хочет сохранить информацию о форматировании и макете страницы во время загрузки или отображения документа на любом устройстве, так как это общепринятая практика для документов, созданных текстовыми процессорами.

Этот тип стиля отличается от таблиц стилей [CSS2] или [XSLT], которые используются для отображения документа. Дополнительная таблица стилей для CSS, XSLT и т.д. требуется для отображения документа в формате OpenDocument на определенном устройстве. Эта таблица стилей должна учитывать стили, уже существующие в документе, так же как и требования совместимости с устройствами вывода. В идеальном варианте таблица стилей зависит только от устройств вывода.

Более подробную информацию о стилях см. в разделе 14.

2.7.1 Расположение стилей

Общие и автоматические стили имеют одинаковое XML-представление, но они содержатся в двух разных элементах-контейнерах:

• office:automatic-styles для автоматических стилей.

• office:master-styles

Пример. Стили OpenDocument:

2.8. Стили и макеты страницы

Стили и макеты страниц в документе определяются:

• макетами страниц;
• мастер-страницами.

Макет страницы описывает физические свойства или геометрию страницы, например, размер страницы, поля, высоту верхних и нижних колонтитулов.

Мастер-страница — это шаблон для страниц в документе. Он содержит ссылку на макет страницы, который определяет физические параметры страницы, а также может содержать статическое содержимое, отображаемое на всех страницах документа, которые используют мастер-страницу. Примером статического содержимого являются колонтитулы или фоновое изображение.

Если текстовый документ или электронная таблица отображаются в режиме макета страницы, то создаются экземпляры мастер-страницы для создания последовательности страниц, содержащих содержимое документа. При создании экземпляра мастер-страницы создается пустая страница со свойствами мастер-страницы и статическим содержимым мастер-страницы. После этого основная часть документа заполняется содержимым. Если несколько страниц в документе используют одинаковую мастер-страницу, то экземпляр может быть создан несколько раз в документе.

В текстовом документе или электронной таблице мастер-страница может быть связана со стилями абзацев или таблиц через использование атрибута style:master-page-name. Каждый раз, когда стиль абзаца или таблицы будет использован для текста, перед абзацем или таблицей будет вставлен разрыв страницы. Страница, которая начинается с позиции разрыва страницы, использует указанную мастер-страницу.

В графических документах и презентациях мастер-страницы могут быть связаны с графической страницей через использование атрибута style:parent-style-name.

Примечание. Методология организации страниц в формате OpenDocument значительно отличается от методологии, принятой в [XSL]. В XSL колонтитулы содержатся внутри последовательности страниц, которые также содержат содержимое документа. В формате OpenDocument колонтитулы содержатся в стилях страницы. Таким образом, содержимое колонтитулов может быть изменено или пропущено без последствий для содержимого документа.

3. ЭЛЕМЕНТЫ МЕТАДАННЫХ

Элементы метаданных в большой степени заимствованы из стандарта на метаданные, разработанного проектом Dublin Core Metadata Initiative (http://www.dublincore.org). Элементы метаданных взяты напрямую из Дублинского ядра с использованием их префикса пространства имен (см. раздел 1.3).

3.1. Предопределенные элементы метаданных

Существует набор предопределенных метаданных, которые приложениям следует обрабатывать и обновлять. Элементы метаданных могут быть пропущены или встречаться неоднократно. Как обновлять множественные вхождения одинаковых элементов, определяется приложением.

3.1.1 Генератор

Элемент meta:generator содержит строку, которая идентифицирует приложение или средство, которое использовалось для создания или последней модификации XML-документа. Данную строку следует записывать в соответствии с определением user-agent в протоколе HTTP, описанным в разделе 14.43 [RFC2616]. Данной строкой следует давать представления о разных версиях использованной программы, указывая, в том числе, номер сборки или номер заплатки.

Приложение, соответствующее спецификации, может использовать строку генератора для обхода ошибок, которые существуют или существовали в обозначенном приложении, но оно не должно сознательно реализовывать различное поведение приложения в зависимости от содержания данной строки.

Если приложение, создавшее документ, не может предоставить идентификационную строку, то этот элемент не используется. Если приложение, в котором данный документ модифицируется, не может записать в строку свой уникальный идентификатор, оно не должно использовать идентификатор приложения, создавшего документ.

3.1.2 Заголовок

3.1.3 Описание

3.1.4 Тема

3.1.5 Ключевые слова

Элемент meta:keyword содержит ключевые слова, свойственные документу. Метаданные могут содержать любое число элементов meta:keyword. Каждый элемент описывает одно ключевое слово.

3.1.6 Автор первоначального документа

Элемент meta:initial-creator определяет имя автора, изначально создавшего документ.

3.1.7 Автор

Элемент dc:creator определяет имя автора последней модификации документа. Данный элемент был выбран для совместимости с Дублинским ядром, но данное определение отличается от использованного в Дублинском ядре, которое определяет создателя (автора) как «Сущность, изначально ответственную за создание содержимого ресурса». В терминологии OpenDocument последний редактировавший документ автор в первую очередь ответственен за его содержимое.

3.1.8 Кем распечатан документ

Элемент meta:printed-by определяет имя исполнителя, который последним распечатал документ.

3.1.9 Дата и время создания документа

Элемент meta:creation-date определяет дату и время изначального создания документа.

Для соответствия [xmlschema-2] используется следующий формат даты и времени: YYYY-MM-DDThh:mm:ss.

3.1.10 Дата и время последней модификации документа

Элемент dc:date определяет дату и время последнего изменения документа.

Для соответствия [xmlschema-2] используется следующий формат даты и времени: YYYY-MM-DDThh:mm:ss.

3.1.11 Дата и время печати документа

Элемент meta:print-date определяет дату и время последней печати документа.

Для соответствия [xmlschema-2] используется следующий формат даты и времени: YYYY-MM-DDThh:mm:ss.

3.1.12 Шаблон документа

Элемент meta:template содержит URL на шаблон, который использовался при создании документа. URL оформляется как XLink.

Элемент подчиняется правилам, описанным в спецификации XLink (см. [XLink]).

С элементом meta:template могут быть связаны следующие атрибуты:

• имя шаблона;
• дата и время последней модификации шаблона.

Местоположение шаблона

Атрибут xlink:href определяет местоположение шаблона документа.

Имя шаблона

Дата и время модификации шаблона

Атрибут meta:date определяет дату и время последней модификации шаблона до момента его использования для создания данного документа.

Для соответствия [xmlschema-2] используется следующий формат даты и времени: YYYY-MM-DDThh:mm:ss.

3.1.13 Автоматическая перезагрузка

Элемент meta:auto-reload определяет, будет ли перезагружен или заменен документ по истечении установленного периода времени другим документом.

С элементом meta:auto-reload могут быть связаны следующие атрибуты:

• URL перезагрузки;
• задержка перед перезагрузкой.

URL перезагрузки

Если загруженный документ подлежит замене на другой по истечении указанного периода времени, элемент meta:auto-reload представляет собой XLink. Атрибут xlink:href определяет URL заменяющего документа.

Задержка перед перезагрузкой

Атрибут meta:delay определяет задержку перед перезагрузкой.

Для соответствия типу данных длительности в [xmlschema-2] используется следующий формат значений данного атрибута PnYnMnDTnHnMns. См. § 3.2.6 [xmlschema-2] для получения более детальной информации о данном формате.

3.1.14 Поведение гиперссылок

Элемент meta:hyperlink-behaviour определяет поведение по умолчанию для гиперссылок в документе.

С элементом meta:hyperlink-behaviour может быть связан только один атрибут:

• целевой фрейм.

Целевой фрейм

Атрибут meta:target-frame-name определяет имя целевого фрейма, в котором по умолчанию будет отображаться документ, на который указывает гиперссылка.

Данный атрибут может принимать одно из следующих значений: - _self — документ по ссылке заменяет содержимое текущего фрейма; - _blank — документ по ссылке открывается в новом фрейме; - _parent — документ по ссылке открывается в родительском по отношению

  к текущему документу фрейме;

- <a id="p100501"></a>_top - документ по  ссылке отображается в самом  верхнем  фрейме, это
  фрейм,  который  содержит  текущий  фрейм  в  качестве  дочернего, но
  который не содержится внутри никакого другого фрейма;
- <a id="p100502"></a>имя фрейма - документ по ссылке  отображается в заданном фрейме, если
  фрейм с таким именем отсутствует, будет создан новый фрейм с заданным
  именем.

Для соответствия спецификации XLink добавлен дополнительный атрибут xlink:show для элемента meta:hyperlink-behaviour. Если значением атрибута meta:target-frame-name является _blank, то значение атрибута xlink:show будет new. Если значением атрибута meta:target-frame-name является одно из других возможных, то значение атрибута xlink:show будет replace.

3.1.15 Язык

Элемент dc:language определяет язык по умолчанию для документа.

Метод определения данного элемента такой же, как и при определении языкового тега, описанного в [RFC3066]. Возможное значение состоит из двух или трех букв языкового кода, взятого из стандарта ISO 639, затем может следовать дефис (-) и два символа кода страны, взятых из стандарта ISO 3166.

3.1.16 Циклы редактирования

Элемент meta:editing-cycles определяет число циклов редактирования, которого достиг документ.

Значение данного элемента увеличивается каждый раз, когда документ сохраняется. Элемент содержит число циклов редактирования в виде текста.

3.1.17 Время редактирования

Элемент meta:editing-duration определяет общее время, затраченное на редактирование документа.

Оно представляется в типе данных длительности [xmlschema-2], который выглядит следующим образом: PnYnMnDTnHnMnS. См. § 3.2.6 в [xmlschema-2] для получения более детальной информации по формату записи длительности.

3.1.18 Статистика документа

Элемент meta:document-statistic определяет статистику документа, например, число страниц, число слов и др. Статистика записывается в виде атрибутов элемента meta:document-statistic, статистика, экспортированная в документ, зависит от типа документа и от приложения, в котором он создавался:

3.2. Метаданные, определяемые пользователем

Элемент meta:user-defined определяет дополнительные метаданные документа, определяемые пользователем. Каждый из таких элементов может содержать одну часть метаданных, определяемых пользователем. Элемент состоит из: - Атрибута meta:name, который определяет имя элемента метаданных. - Необязательного атрибута meta:value-type, определяющего тип элемента метаданных. Допустимы метатипы float, date, time, boolean и string (см. также раздел 6.7.1). - Значения элементов метаданных задаются в формате, описанном в разделе 6.7.1, как значения атрибутов office:value для различных типов

  данных.

Типом по умолчанию элементов метаданных является строка (string).

3.3. Специфические метаданные

Помимо определяемых пользователем элементов метаданных приложениям следует также сохранять любое дополнительное содержимое, найденное внутри элемента office:meta. Так как не существует специфической семантики для подобного внешнего содержимого, приложению не обязательно обрабатывать данную информацию, ее лишь следует сохранять при редактировании документа.

4. ТЕКСТОВОЕ СОДЕРЖИМОЕ

4.1. Заголовки, абзацы и основная текстовая структура

В этом разделе описаны элементы XML и атрибуты, которые используются для представления заголовков и абзацев в текстовом документе.

Элементы text:h и text:p представляют заголовки и абзацы соответственно, вместе упоминаются как элементы абзаца. Все текстовое содержимое в файле OpenDocument должно содержаться в любом из этих элементов.

4.1.1 Заголовки

Заголовки определяют структуру разделов в документе. Раздел или подраздел начинается с заголовка и продолжается до следующего заголовка такого же или более высокого уровня.

Уровень заголовка

Атрибут text:outline-level связан с элементом заголовка и определяет уровень заголовка, начиная с 1. Уровень заголовка без данного атрибута принимается равным 1.

Нумерация заголовков

Нумерация заголовка может быть изменена за счет использования дополнительных атрибутов, подобных пунктам списка (см. раздел 4.3.2). Нумерация заголовков может быть запущена сначала установкой значения true для атрибута text:restart-numbering.

Стартовое значение

Атрибут text:start-value может быть использован для возобновления нумерации заголовков на текущем уровне при помощи установки нового значения нумерации.

Подавление нумерации заголовка

Иногда необходим специальный заголовок, который не должен быть пронумерован. Это соответствует ненумерованным заголовкам в списках (см. раздел 4.3). Чтобы достичь этого, можно использовать дополнительный атрибут text:is-list-header. Если его значение true, то данный заголовок не будет пронумерован, даже если будет явно указан list-style.

Форматированная нумерация заголовков

Если заголовок пронумерован, текст форматированного номера может быть добавлен в элемент text:number. Этот текст может использовать приложение, не поддерживающее нумерацию заголовков, но он будет проигнорирован, если такая поддержка присутствует.

4.1.2 Абзацы

Абзацы — основные единицы текста.

4.1.3 Общие атрибуты элементов абзаца

Элементы абзаца имеют следующие атрибуты: text:style-name, text:class-names и text:cond-style-name. Эти атрибуты должны ссылаться на стиль абзаца.

Атрибут text:style-name указывает на стиль абзаца, в то время как атрибут text:cond-style-name ссылается на условный стиль, то есть стиль, который содержит указатели на другие стили (см. раздел 14.1.1). Если к абзацу применен условный стиль, то атрибут text:style-name содержит имя стиля, который стал результатом условной оценки, в то время как само имя условного стиля является значением атрибута text:cond-style-name. Такая структура XML упрощает преобразование [XSLT], поскольку XSLT должен воспользоваться только условным стилем, если атрибуты форматирования корректны. Указанный стиль может быть общим или автоматическим.

Атрибут text:class-names содержит список имен стилей в абзаце, разделенных пробелами. Указанные стили применяются в порядке, в котором они содержатся в списке. Если указаны атрибуты text:style-name и text:class-names, то стиль, на который ссылается атрибут text:style-name, будет в text:class-names как первый стиль в списке. Если условный стиль определен совместно с атрибутом style:class-names, но без атрибута text:style-name, тогда первый стиль в списке стилей используется как значение пропущенного атрибута text:style-name.

Соответствующие спецификации приложения должны поддерживать атрибут text:class-names, а также сохранять их в процессе редактирования.

Пример. Стили и условные стили:

Абзац может иметь идентификатор, который может быть использован для ссылки на абзац из других элементов.

4.2. Последовательности страниц

Элемент последовательности страниц text:page-sequence определяет последовательность мастер-страниц, которые представлены в том же порядке, в каком на них имеются ссылки в последовательности страниц. Если текстовый документ содержит последовательность страниц, то он будет состоять из точно такого количества страниц, какое определено. Документ с последовательностью страниц не имеет основного потока текста, состоящего из заголовков и абзацев, как в случае, если документ не содержит последовательности страниц. Для документов с последовательностью страниц текстовое наполнение заключается внутри текстовых блоков. Единственно допустимым содержимым другого характера являются графические объекты.

Пример. Последовательность страниц:

4.2.1 Страница

Элемент text:page описывает отдельную страницу из последовательности страниц.

Имя мастер-страницы

Атрибут text:master-page-name определяет имя мастер-страницы, которой он присваивается.

4.3. Списки

Формат OpenDocument поддерживает структуру списков, подобную описанной в [HTML4]. Список является элементом уровня абзаца, который содержит необязательный заголовок списка, следующего за последовательностью пунктов списка. Заголовок списка, а также каждый пункт списка содержат последовательность абзацев или элементов списка. Списки могут быть вложенными.

Списки могут быть нумерованными. Нумерация возможна с произвольного номера, который может быть присвоен в каждом пункте списка. Нумерация списка может также продолжать нумерацию другого списка, что позволяет пользователю объединять несколько списков в один прерывающийся список. Отметим, что отображение нумерации зависит от использованного стиля списка.

В дополнение к этой структурной информации списки могут иметь стили, связанные с ними, которые содержат информацию о разметке, такую как:

• тип метки пункта списка, такой как маркер или номер;
• ширина метки пункта списка и отступ;
• символ маркера или изображения (если есть);
• формат номера для нумерованных списков (если есть);
• отступ абзаца для пунктов списка.

4.3.1 Блок списка

Списки описываются элементом text:list. Он содержит необязательный заголовок списка со следующим за ним произвольным числом пунктов списка.

Каждый список имеет свой уровень (list level), который определяется вложенностью элементов text:list. Если список не находится внутри другого списка, то его уровень равен 1. Если список находится внутри другого списка, его уровень равен уровню списка, в котором он содержится, увеличенному на единицу. Если список содержится внутри ячейки таблицы или текстового блока, его уровень равен единице даже в том случае, когда таблица или текстовый блок сами являются вложенными в другой список.

С элементом списка могут быть связаны следующие атрибуты:

• имя стиля;
• продолжение нумерации.

Имя стиля

Необязательный атрибут text:style-name определяет имя стиля списка, который применяется для списка.

Если данный атрибут пропущен, следовательно, стиль списка не определен, применяется одно из следующих действий. - Если список содержится внутри другого, стилем списка по умолчанию является стиль внешнего списка. - Если для внешнего списка не определен стиль списка, но список содержит абзацы, у которых описан стиль абзаца с определенным стилем списка, этот стиль списка используется для любого из этих абзацев. - Для всех остальных абзацев применяется стиль списка по умолчанию.

Для определения свойств форматирования списка принимается во внимание уровень списка и имя стиля списка (см. раздел 14.10 для получения дополнительной информации о свойствах форматирования списка).

Продолжение нумерации

По умолчанию первый пункт списка начинается с номера, определенного в стиле списка. Атрибут продолжения нумерации может использоваться для продолжения нумерации от предшествующего списка.

Атрибут может использоваться с элементом text:list и может принимать значения true и false.

Если значение атрибута равно true и стиль нумерации предшествующего списка такой же, как в текущем списке, то номер первого пункта списка в текущем списке равен номеру последнего пункта предыдущего списка, увеличенному на единицу.

4.3.2 Пункт списка

Пункты списка содержат текстовое содержимое списка. Элемент text:list-item может содержать абзацы или списки. Пункт списка не может содержать заголовки или таблицы.

Первой строке в пункте списка предшествует маркер или номер, в зависимости от стиля списка, связанного с данным списком. Если пункт списка непосредственно начинает другой список и не содержит никакого текста, маркер или номер не отображается.

С элементом text:list-item может быть связан только следующий атрибут:

• начальное значение.

Начальное значение

Нумерация текущего списка может быть начата заново с указанного номера. Атрибут text:start-value используется для определения начального номера списка.

Этот атрибут может быть применен только к пунктам с нумерованным типом списка. Он начинает нумерацию списка заново в текущем пункте.

Форматированный номер

Если к пункту списка применяется нумерация, то текст форматированного номера может быть включен в элемент text:number. Этот текст может быть использован приложениями, которые не поддерживают нумерацию, но он не будет рассматриваться приложением, которое нумерацию поддерживает (см. также раздел 4.1.1).

Пример. Списки и вложенные списки:

4.3.3 Заголовок списка

Заголовок списка — это специальный вид пункта списка. Он содержит один или несколько абзацев, которые отображаются перед списком. Абзацы отображаются как пункты списка, но без предшествующего номера или маркера. Заголовок списка представляется элементом заголовка списка.

4.3.4 Нумерованные абзацы

В некоторых случаях желательно определять список не как структурный элемент, состоящий из нескольких пунктов списка, а определять его на уровне целых абзацев, установив, нумерован ли абзац и на каком уровне. Для обеспечения этого используется элемент text:numbered-paragraph, который позволяет осуществлять нумерацию отдельных абзацев, как если бы они являлись частью списка на определенном уровне.

Нумерованные абзацы могут использовать те же самые свойства сквозной нумерации, что и пункты списков, таким образом формируется похожий, альтернативный способ определения списков. Список, представленный в text:list, может быть преобразован в список, представленный в text:numbered-paragraph, и наоборот.

Нумерованному абзацу может быть назначен уровень списка. Нумерованный абзац эквивалентен вложенному списку представленного уровня, содержащего один пункт списка с одним абзацем. Если уровень не назначен, нумерованный абзац интерпретируется как находящийся на первом уровне.

Так как нумерованный абзац совмещает функциональность списка (возможно, вложенного) с одним пунктом списка, он также может использовать атрибуты этого элемента.

Текст форматированного номера может быть включен в элемент text:number Этот текст может быть использован приложением, которое не поддерживает нумерацию, но он не будет использоваться, если нумерация поддерживается приложением (см. также раздел 4.1.1).

4.4. Текстовые разделы

Текстовый раздел — это именованная область текстового содержимого уровня абзаца. Раздел начинается и заканчивается на границах абзаца и может содержать любое количество абзацев.

В формате OpenDocument есть два способа применения разделов: для назначения определенных свойств оформления области текста; для группировки текста, который получается автоматически из некоторого внешнего источника данных.

В дополнении разделы могут содержать обычное текстовое содержимое или текст может содержаться в другом файле, связанном с разделом. Раздел также может иметь защиту от записи или быть скрытым.

Раздел может иметь параметры текстовых колонок, цвета фона или образца и настройку сносок. Параметры настройки формируют стиль раздела, который представлен в элементе style:style (см. раздел 14.8.3).

Свойства форматирования для разделов объясняются в разделе 15.7.

Разделы поддерживают два способа связи с внешним содержимым. Если раздел связан с другим документом, связь может быть организована одним из следующих способов. - Источник, определяемый XLink, задается элементом text:section-source. - Динамический обмен данными (Dynamic Data Exchange, DDE) задается элементом office:dde-source.

Ссылочная информация на внешнее содержимое располагается в первом потомке элемента раздела. Раздел, который ссылается на внешнее содержимое, содержит полное представление источника данных, так что приложения нуждаются в понимании информации о связях, только если они предполагают обновить содержимое раздела.

Примечание. Пункты списка не могут содержать разделов. Таким образом, списки могут только полностью содержаться внутри элементов раздела. Если решено достичь эффекта наложения списков и разделов или разделы содержатся внутри списков, то списки должны быть разбиты на несколько списков, каждый из которых находился бы полностью внутри раздела. Разбивая список, атрибуты сквозной нумерации следует установить такими, чтобы отображение и поведение их совпадало с исходным списком, не прерванным разделами.

4.4.1 Атрибуты раздела

Текстовые индексы, описанные в разделе 7, можно считать специальным видом текстового раздела, поскольку они разделяют такую же самую общую структуру, а также определенные атрибуты. Они собраны в следующем определении:

Остальные атрибуты в этом разделе относятся к элементу text:section.

Стиль раздела

Атрибут text:style-name ссылается на стиль раздела.

Имя раздела

Каждый раздел должен иметь уникальное имя, которое определяет его однозначно. Атрибут text:name содержит имя раздела.

Защищенные разделы

Раздел может быть защищен, это означает, что пользователь не может редактировать его. Атрибут text:protected показывает, защищен ли раздел. Пользовательский интерфейс должен реализовывать защиту, если атрибут установлен.

Средствами пользовательского интерфейса можно сбросить флаг защиты, если раздел не защищен паролем. В этом случае пользователь должен знать пароль, чтобы сбросить флаг защиты. Атрибут text:protection-key определяет пароль защиты раздела. Для предотвращения сохранения пароля непосредственно в XML-файле, сохраняется только хэш-значение пароля.

Скрытые и условные разделы

Разделы могут быть скрыты при выполнении определенного условия или скрыты безусловно.

Атрибут text:display определяет, скрыт раздел или нет. Этот атрибут может принимать следующие значения: - true — раздел отображается (значение по умолчанию); - none — раздел скрыт безусловно; - condition — раздел скрыт по условию, определенному в атрибуте text:condition.

Атрибут text:condition определяет условие, по которому раздел становится скрытым. Условие представляется в виде строки. Если значение атрибута text:display равно condition, атрибут text:condition должен быть определен.

4.4.2 Источник раздела

Элемент text:section-source указывает на то, что включенный раздел является связанным. Если этот элемент используется, то он должен быть первым элементом в элементе text:section.

• URL источника раздела;

• имя фильтра.

URL источника раздела

Этот атрибут определяет документ или раздел, с которым связан данный раздел. Имя целевого раздела устанавливается локальной частью URL, следующей после знака диез. Подразумевается использование атрибута xlink:href, потому что элементы text:section-source могут также ссылаться на внутренние разделы.

Имя связанного раздела

Если целевой объект ссылки является разделом документа, атрибут text:section содержит имя целевого раздела. Если атрибут не задан, целевым объектом ссылки является документ целиком.

Имя фильтра

Атрибут text:filter-name определяет, какой фильтр будет использован при импорте целевого объекта ссылки. Значение этого атрибута обусловливается реализацией.

4.4.3 Источник DDE

Если разделы связаны по DDE, то информация об их присоединении представлена в элементах office:dde-source. Он содержит атрибуты, которые определяют приложение, тему и пункт DDE-соединения. Отметим это, потому что раздел содержит XML-интерпретацию содержимого DDE-ссылки, эта информация нужна только в том случае, если желательно обновление данных по DDE.

4.5. Графическое наполнение, привязанное к странице

В пределах текстовых документов изображения, вложенные объекты и другие графические объекты представляются на уровне абзаца, если они привязаны к странице, а не к абзацу или символьной позиции внутри абзаца (см. раздел 9.2 для получения детальной информации о графических объектах и раздел 9.2.16 для информации по их привязке).

4.6. Отслеживание изменений

В этом разделе описано, как могут быть представлены изменения в документе.

4.6.1 Отслеженные изменения

Все отслеженные изменения в текстовом документе сохраняются в списке. Список содержит элементы для каждого произошедшего изменения документа. Если элемент text:tracked-changes отсутствует, значит отслеживание изменений выключено.

Слежение за изменениями

Этот атрибут определяет, должны ли пользовательские приложения отслеживать и записывать изменения в данном документе.

4.6.2 Измененные области

Для каждой измененной области документа есть только одна запись в списке отслеженных изменений. Эта запись содержит список всех изменений, которые были сделаны в этой области. Начало и конец данной области обозначены с помощью элементов начала и конца, которые описаны ниже.

Каждый элемент имеет идентификатор. Элементы, обозначающие начало и конец области, используют этот идентификатор определения области, к которой они относятся.

4.6.3 Вставка

Элемент text:insertion содержит информацию, необходимую для определения вставки в содержимое. Содержимое может быть частью текста внутри абзаца, целым абзацем или целой таблицей. Вставленное содержимое — непосредственно часть текстового документа, отмеченная элементами начала и конца изменения.

4.6.4 Удаление

Элемент text:deletion содержит содержимое, которое было удалено при включенном слежении за изменениями. Позиция, где текст был удален, обозначена с помощью элемента позиции изменения.

Если часть абзаца была удалена, то удаленный текст содержится в этом элементе как элемент абзаца. Если удаленный текст был повторно вставлен в документ, абзац объединяется с абзацем, где было удаление.

Этот пример показывает следующее: - текст, который был удален = , but this has been deleted, содержится в

  элементе <text:p> внутри элемента <text:deletion>;

- <a id="p100748"></a>текущий  текст = This is  the original  text  содержится  в  элементе

  <text:p> в конце примера;

- <a id="p100749"></a>до удаления текст был следующим = This is the original text, but this
  has been deleted.

Отметим, что удаленный текст, как и весь текст в формате OpenDocument, содержится в элементе абзаца. Для восстановления изначального текста, абзац объединяется с его окружением. Другими словами, удаленный фрагмент, состоящий из одного слова, будет представлен в виде абзаца, содержащего одно слово.

- <a id="p100752"></a>если метка  изменения  находится внутри  абзаца,  вставьте  текстовое
  содержимое  элемента <text:deletion>, как будто начальный <text:p>  и
  конечный </text:p> теги пропущены;
- <a id="p100753"></a>если  метка  изменения  находится  внутри  заголовка,  поступайте как
  описано выше, но  приспосабливая вставляемые  теги под особенности их
  нового прототипа;
- <a id="p100754"></a>иначе  просто  скопируйте   содержимое  элемента   <text:deletion>  в
  место метки изменения.

Пример.

Даны следующие изменения:

Первый (и самый обычный) случай — если метка изменения находится внутри обычного абзаца:

Для восстановления изначального текста, два элемента text:p копируются взамен метки изменения, за исключением тех случаев, когда теги начала и конца отсутствуют:

Второй случай — метка изменения встречается внутри заголовка, следует такая же процедура, только скопированные теги адаптируются, чтобы быть уверенными, что мы все еще имеем правильно сформированный XML:

становится:

Третий случай — изменения встречаются вне абзаца. При этом удаленный текст просто копируется:

становится:

Если бы в первых двух случаях удаленный фрагмент содержал целый абзац, то дополнительные пустые абзацы должны были бы быть вставлены в элемент text:deletion для достижения желаемого результата.

до

будет восстановлено так:

4.6.5 Изменение формата

Элемент изменения формата отражает любые изменения в атрибутах форматирования. Область, в которой произошли изменения, отмечается элементами начала и конца изменения.

Примечание. Элемент изменения формата не содержит фактических изменений.

4.6.6 Информация об изменениях

Информация об изменениях содержит метаинформацию о том, кто сделал изменения и когда. Она также используется для электронных таблиц, в соответствии с описанием в разделе 12.3 (Метаданные отслеживания изменений).

4.6.7 Метки изменения

Три элемента отмечают начало и конец области изменений.

- <a id="p100786"></a>Элемент начала изменений - <text:change-start>.

Этот элемент отмечает начало области с содержимым, где текст был вставлен или был изменен формат. - Элемент окончания изменений - text:change-end.

Этот элемент отмечает конец области с содержимым, где текст был

  вставлен или был изменен формат.

- <a id="p100790"></a>Элемент позиции изменений - <text:change>.

Этот элемент отмечает позицию в пустой области, где текст был удален.

Все три элемента имеют атрибуты, определяющие идентификатор области, к которой они относятся.

4.7. Текстовые объявления

Некоторые текстовые элементы нуждаются в предварительном объявлении прежде, чем они могут быть использованы. Например, переменные поля требуют, чтобы используемые переменные были объявлены в начале документа. Эти объявления собраны в начале текстового документа. Такие объявления необязательны. Детальное описание таких объявлений доступно в соответствующем разделе.

Поддерживаются следующие текстовые объявления: - объявление переменной — эти объявления используются для переменных полей (см. раздел 6.3.1); - объявление поля пользователя — эти объявления используются для полей, определяемых пользователем (см. раздел 6.3.5); - объявление последовательности — эти объявления используются для последовательных полей (см. раздел 6.3.8); - DDE-ссылки — эти объявления используются для DDE-полей и DDE-разделов

- <a id="p100801"></a>файл  с автоматическими  метками - это  объявление  используется  для

5. СОДЕРЖИМОЕ ЭЛЕМЕНТОВ АБЗАЦА

5.1. Основное текстовое содержимое

Потомки элементов абзаца составляют текстовое содержимое любого документа. Весь текст в элементах абзаца или их потомках — текстовое содержимое, за некоторыми исключениями, описанными ниже. Это значительно упрощает преобразование в другие форматы, так как при преобразовании могут игнорироваться любые дочерние элементы элемента абзаца и обрабатываться только их текстовое содержимое, при этом получается правильное отображение текстового содержимого.

Элементами текстового содержимого, не содержащими внутренних текстовых дочерних элементов, являются:

• Обычные и концевые сноски (см. раздел 5.3). Обычные и концевые сноски содержат текстовое содержимое, но обычно отображаются вне основного текста, например, в конце страницы или документа.
• Транскрипции (см. раздел 5.4). Тексты транскрипции обычно отображаются над или под основным текстом.
• Аннотации (см. раздел 5.5). Аннотации обычно не отображаются.

5.1.1 Пробельные символы

Если элемент абзаца или любой его дочерний элемент содержит пробельные символы, то они объединяются; другими словами, они обрабатываются тем же путем, как их обрабатывает [HTML4]. Следующие символы кодовой таблицы [UNICODE] приводятся к символу ПРОБЕЛ:

• ВОЗВРАТ КАРЕТКИ (0x000D)

• ПРОБЕЛ (0x0020)

Кроме того, эти символы игнорируются, если предыдущий символ является пробельным. Предыдущий символ может находиться в таком же элементе, в родительском элементе или предыдущем элементе того же уровня при условии, что он находится в том же элементе абзаца. В этом случае пробельные символы обрабатываются так, как описано выше.

Обработка пробельных символов имеет место в пределах следующих элементов:

• text:p
• text:h
• text:span
• text:a
• text:ref-point
• text:ref-point-start
• text:ref-point-end

• text:bookmark-start
• text:bookmark-end

Примечание. В [XSL] обработку пробельных символов текста абзаца можно активировать за счет добавления атрибута fo:white-space=«collapse» элементу fo:block, который соответствует элементу абзаца.

Символ пробела

Обычно подряд идущие пробельные символы в абзаце сокращаются. Поэтому в XML есть специальный элемент, используемый для отображения символов ПРОБЕЛ (0x0020) кодовой таблицы [UNICODE].

Этот элемент использует необязательный атрибут text:c для определения числа символов ПРОБЕЛ, которое представляет элемент. Если атрибут text:c пропущен, то считается что символ ПРОБЕЛ один.

Элемент требуется для представления второго и всех последующих символов ПРОБЕЛ в последовательности символов ПРОБЕЛ. Не считается ошибкой, если символ, предшествующий элементу, будет не пробельный символ, но хорошей практикой считается использование данного элемента для второго и всех последующих символов ПРОБЕЛ в последовательности. Таким образом, приложение распознает один пробельный символ без распознания данного элемента.

Символ табуляции

Элемент text:tab представляет символ табуляции в кодовой таблице [UNICODE] ГОРИЗОНТАЛЬНАЯ ТАБУЛЯЦИЯ (0x0009) в заголовках и абзацах. Элемент text:tab резервирует пространство от текущей позиции до следующего табулостопа, как определено в стиле абзаца.

Для определения того, на какой табулостоп переместится символ табуляции, необходима информация о разметке. Чтобы не ориентированные на разметку приложения могли проще определять эту информацию, приложения могут формировать атрибут text:tab-ref, указывающий на связь символа табуляции с табулостопом в текущем стиле абзаца. Он содержит количество табулостопов, на которые ссылается символ табуляции. Нулевая позиция имеет особое значение и указывает на начальный отступ абзаца.

Примечание. Атрибут text:tab-ref является только подсказкой для помощи не ориентированным на разметку приложениям с целью определения связи символов табуляции с табулостопом. Ориентированные на разметку приложения должны определить позиции табуляции, исключительно основываясь на информации о стилях.

Разрывы строки

Атрибут text:line-break определяет разрыв строки в заголовке или абзаце.

5.1.2 Мягкие переносы, переносы и неразрывные пробелы

Мягкие переносы, переносы и неразрывные пробелы в кодовой таблице [UNICODE] представлены следующими символами:

5.1.3 Текст с присвоенными атрибутами

Элемент text:span представляет части текста, которым присвоены атрибуты, с использованием определенного текстового стиля или класса. Содержимым этого элемента является текст, использующий текстовый стиль.

Имя текстового стиля или текстового класса записывается в атрибуты text:style-name или text:class-names соответственно, прикрепленные к элементу text:span. Эти атрибуты должны ссылаться на текстовые стили или классы.

Атрибут text:style-name описывает один текстовый стиль. Атрибут text:class-names содержит список имен текстовых стилей, разделенных пробелами. Указанные текстовые стили применяются в той последовательности, в которой они содержатся в списке. Если представлены атрибуты text:style-name и text:class-names, стиль, на который ссылается атрибут text:style-name, обрабатывается как первый стиль в списке text:class-names. Соответствующему спецификации приложению следует поддерживать атрибут text:class-names, а также сохранять его при редактировании.

Пробельные символы, содержащиеся в этом элементе, объединяются.

5.1.4 Гиперссылки

Гиперссылки в текстовом документе описываются элементом text:a.

Этот элемент также содержит элемент таблицы событий office:event-listeners, который содержит события, связанные с гиперссылками. См. раздел 12.4 для получения дополнительной информации об элементе таблицы событий.

С элементом text:a могут быть связаны следующие атрибуты:

• адрес ссылки;
• целевой фрейм;
• стили текста.

Гиперссылка может иметь имя, но оно не обязательно. Атрибут office:name определяет имя гиперссылки, если таковое присутствует. Это имя может служить целью для других гиперссылок.

Адрес ссылки

Целевой фрейм

Атрибут office:target-frame-name определяет целевой фрейм ссылки. Этот атрибут может принимать следующие значения: - _self — документ по ссылке заменяет содержимое текущего фрейма; - _blank — документ по ссылке открывается в новом фрейме; - _parent — документ по ссылке открывается в родительском по отношению к текущему документу фрейме; - _top — документ по ссылке отображается в самом верхнем фрейме, это фрейм, который содержит текущей фрейм в качестве дочернего, но

  который не содержится внутри никакого другого фрейма;

- <a id="p100884"></a>имя фрейма - документ по ссылке отображается в заданном фрейме.  Если
  фрейм с таким именем отсутствует, будет создан новый фрейм с заданным
  именем.

Для соответствия спецификации XLink добавлен дополнительный атрибут xlink:show элементу text:a. Если значением атрибута является _blank, то значение атрибута xlink:show будет new. Если значением атрибута является одно из других возможных, то значение атрибута xlink:show будет replace (см. [XLink]).

Стили текста

Каждая ссылка имеет два стиля текста. - Если ссылка не посещалась, то стиль текста, определенный атрибутом text:style-name, применяется к тексту гиперссылки. - Если ссылка посещалась, то стиль текста, определенный атрибутом text:visited-style-name, применяется к тексту гиперссылки.

5.2. Закладки и перекрестные ссылки

5.2.1 Закладки

Закладки могут помечать текстовую позицию или диапазон текста. Текстовый диапазон может начинаться в любой текстовой позиции и заканчиваться в другой текстовой позиции. В частности, закладка может начинаться в середине одного абзаца, а заканчиваться в середине другого. Элемент XML, используемый для представления закладки, изменяется в зависимости от ее типа следующим образом:

• text:bookmark-start - для пометки начала текстового диапазона;
• text:bookmark-end - для пометки конца текстового диапазона.

Для каждого элемента text:bookmark-start должен быть элемент text:bookmark-end в том же текстовом потоке, использующем тот же атрибут text:name, и наоборот. Элемент text:bookmark-start должен предшествовать элементу text:bookmark-end.

Пример. Закладки:

5.2.2 Перекрестные ссылки

Представление перекрестных ссылок основано на XML-представлении закладок.

Есть два типа перекрестных ссылок. - Перекрестная ссылка на точку, которая помечает специфическую позицию в тексте и определяется одним атрибутом text:reference-mark. - Перекрестная ссылка на диапазон, которая помечает диапазон символов в тексте и определяется двумя элементами: text:reference-mark-start для пометки начала диапазона и text:reference-mark-end для пометки

  конца диапазона.

Каждая перекрестная ссылка идентифицируется по ее имени, которое должно быть уникальным. В перекрестных ссылках на диапазон начальный и конечный элементы должны использовать одинаковое имя перекрестной ссылки.

Перекрестная ссылка на точку

Элемент text:reference-mark определяет перекрестную ссылку на точку.

Элементы text:reference-mark-start и text:reference-mark-end определяют перекрестную ссылку на диапазон.

В схеме OpenDocument три элемента используются для представления перекрестных ссылок вместо одного, потому что перекрестные ссылки, представленные как один элемент XML:

• не поддерживают перекрывающиеся перекрестные ссылки;
• плохо взаимодействует с другими элементами.

Рассмотрим следующий пример.

Пример. Перекрывающиеся перекрестные ссылки на диапазон:

Пример показывает две перекрестные ссылки, которые покрывают следующий текст:

Эта перекрывающая структура не может быть представлена с использованием одного элемента перекрестной ссылки, чтобы содержать тот текст, на который ссылаются. Точно также перекрестные ссылки, охватывающие несколько абзацев, создают такую же ситуацию, как и два перекрывающих XML-элемента. Получается, что в пределах текста, на который организована ссылка, есть метки начала или конца, но не обе.

5.3. Сноски

Сноски состоят из элементов text:note, которые встречаются в тексте на той позиции, к которой сноска привязана. То, как сноски нумеруются и отображаются, определяется элементом text:notes-configuration, который встречается в разделе office:styles.

5.3.1 Элемент сноски

Элемент сноски определяется как текстовые примечания, которые добавляются в определенные позиции текста. Общую реализацию концепции обычных и концевых сносок можно встретить в большинстве текстовых процессоров. Сноска содержит элемент цитирования и элементы основной части, которые формируют содержимое сносок.

В документах OpenDocument сноски представлены в виде, подобном обычным сноскам в [XSL]. В XSL первый потомок элемента сноски содержит цитату в виде элемента fo:inline. Схема OpenDocument использует такую же структуру, но вводится элемент text:note-citation. Вторая часть содержит основную часть сноски, так же как и в XSL.

В дополнение, в OpenDocument есть особенный элемент text:notes-configuration. Чтобы в конфигурации сноски достичь такого же эффекта как и в XSL, каждый элемент цитаты сноски должен быть отформатирован соответственно.

Каждая сноска принадлежит классу, который определяет особенности ее отображения. Поддерживаются два класса сносок: обычные и концевые.

Ссылочный идентификатор обычной сноски

Ссылочный идентификатор обычной сноски используется ссылкой на обычную сноску для идентификации обычной сноски, на которую ссылаются.

Элемент text:note-citation содержит отформатированный цитатный элемент сноски, равно как и отформатированный номер или строку.

Маркирование сноски

Цитатные элементы сноски могут быть маркированы или нумерованы. Если они нумеруются, то номер выбирается и форматируется автоматически, в соответствии с элементом конфигурации сноски. Если они маркированы, то пользователь должен задать маркер для каждой сноски, вставленной в документ. Маркер хранится в атрибуте text:label элемента text:note-citation.

Основная часть сноски

Элемент text:note-body содержит актуальное содержимое обычной сноски. У него нет никаких атрибутов.

Схема разрешает включение сносок в основную часть сноски. Хотя это может быть применимо для будущих типов сносок, но это неприменимо для обычных и концевых сносок. Приложения, соответствующие спецификации, могут поддерживать, а могут и не поддерживать такие вложенные сноски.

Пример. Обычная сноска:

5.4. Транскрипция

Транскрипция — это дополнительный текст, который отображается выше или ниже основного текста. Назначение транскрипции — пояснять основной текст или давать дополнительную информацию о его произношении.

Есть два элемента, которые могут содержаться в элементе text:ruby:

• основа транскрипции;
• текст транскрипции.

Элемент text:ruby-base содержит текст, который комментируется. Он содержит любой элемент содержимого абзаца, например, текстовые диапазоны. Атрибут text:style-name элемента ссылается на стиль транскрипции, который определяет форматирующие атрибуты транскрипции (см. раздел 14.8.4).

Элемент text:ruby-text содержит текст комментария. Он может содержать только простой текст. Атрибут text:style-name элемента ссылается на текстовый стиль, который определяет форматирующие атрибуты, используемые для текста.

5.5. Аннотации к тексту

Формат OpenDocument позволяет добавлять аннотацию к элементам абзаца. См. раздел 12.1 для получения детальной информации по аннотациям.

5.6. Индексные метки

Индексные метки используются для пометки фрагментов с целью включения в текстовые индексы. Они имеют схожую структуру с закладками и перекрестными ссылками. Детально они описаны в разделе 7.1 вместе с текстовыми индексами.

5.7. Отслеживание изменений и метки изменений

Абзацы также могут содержать метки отслеживания изменений. Они уже описаны в разделе об отслеживании изменений (см. раздел 4.6) и упоминаются в данном разделе для полноты.

5.8. Внедренные графические объекты и текстовые блоки

В пределах текстовых документов изображения, вставленные объекты и другие графические объекты могут быть привязаны к абзацу, к символу или как символ. Если они привязаны к абзацу, то отображаются в пределах абзаца в произвольном месте. Если они привязаны к символу или как символ, то они отображаются в пределах абзаца в определенной позиции, к которой они прикреплены. См. раздел 9.2 для получения детальной информации о графических объектах и раздел 9.2.16 об их привязке.

6. ТЕКСТОВЫЕ ПОЛЯ

Текстовые документы OpenDocument или текстовое содержимое OpenDocument, вставленное в другие типы документов, может иметь изменяемые элементы текста, называемые полями. Существует несколько различных типов полей, каждый из которых представляет определенный тип изменяемого элемента текста. Поля обычно используются для определения:

- <a id="p100972"></a>номера страницы

Поле номера страницы отображает номер страницы, на которой оно

  находится.  Это  поле полезно  для нижних колонтитулов.  На каждой из

      страниц, на которой  показан нижний колонтитул, поле присваивает себе
      номер  текущей страницы так,  что все страницы оказываются  корректно

  пронумерованными;

- <a id="p100974"></a>даты создания

      Поле даты  создания  отображает дату создания текущего документа. Это
      поле  полезно  использовать в шаблонах документов.  Каждый  документ,

  созданный с использованием шаблона, содержит дату его создания;

- <a id="p100976"></a>диапазона чисел

Поле диапазона чисел позволяет пользователю нумеровать определенные

  элементы, например, изображения  или  таблицы.  Поле диапазона  чисел

      отображает  его   собственную  позицию   относительно  другого   поля
      диапазона   чисел  для   того  же   диапазона.   Следовательно,  если
      изображение  и связанное  с ним  поле  диапазона  чисел  перемещаются

  внутри  документа,  поля  автоматически  обновляются,  чтобы отразить

  новый порядок.

6.1. Общие характеристики элементов поля

Каждый тип поля представлен соответствующим типом элемента. Поле в документе закодировано как одиночный элемент подходящего типа. Содержимым элемента является текстовое представление значения текущего поля, соответствующее тому, как оно должно быть отображено или напечатано. Следовательно, игнорирование всех элементов поля и отображение только текстового содержания элементов обеспечивает приближенную, состоящую только из текста версию документа.

Значение поля обычно хранится в атрибуте. Необходимо хранить значение для того, чтобы представление поля могло заново вычисляться в случае необходимости, например, если пользователь решает изменить стиль форматирования поля. Также необходимо хранение стиля представления содержимого элемента, чтобы способствовать легкой обработке XML-документа. Например, если полная обработка поля невозможна или нежелательна, приложение может проигнорировать поле и использовать в этой ситуации только содержимое. Для строковых значений, если значение идентично его представлению, значение атрибута пропускается во избежание дублирования хранимой информации.

Для полей, которые могут хранить содержимое различных типов, например, числа, строки или даты, тип значения хранится в дополнение к самому значению. Значение и атрибуты типа значения объясняются в разделе 6.7.1. Если необходимо больше информации для восстановления поля, она хранится в дополнительных атрибутах.

Ниже приведены наиболее используемые атрибуты элементов поля. - Фиксированные поля

      Многие поля  имеют разновидность,  где содержимое не изменяется после
      того, как  задано начальное  значение. Эти поля  отмечаются атрибутом

text:fixed. См. раздел 6.7.2 для более подробной информации по этому атрибуту. - Стиль форматирования

      Несколько типов  полей, особенно те, которые представляют числа, дату
      или  данные  времени,   содержат  стиль   форматирования.  В  формате
      OpenDocument   этот  стиль   форматирования   представлен   атрибутом
      style:data-style-name.  Так  как  пользователь  может  изменять стиль
      представления  для полей, приложения  должны  быть способны вычислять
      заново новое представление содержимого поля в  любой  момент времени.

См. раздел 6.7.7 для более подробной информации по этому атрибуту.

6.2. Поля документа

Поля OpenDocument могут отображать информацию о текущем документе или о специфичной части текущего документа, такую как автор, номер текущей страницы или дата создания документа. Эти поля имеют общее название — поля документа.

Поля документа часто фиксированы. Поле может быть отмечено как фиксированное, чтобы указать, что содержимое становится неизменяемым, а не пересчитывается при редактировании документа. Например, поле даты показывает текущую дату. Если поле даты было отмечено как фиксированное, значение поля становится неизменяемым в течение последующих редактирований и всегда отражает дату, когда поле было вставлено в документ. Если поле не было отмечено как фиксированное, то его значение изменяется, когда документ редактируется. Также поле автора может отображать автора оригинала или последнего автора документа в зависимости от того, отмечено поле как фиксированное или нет.

Группа полей документа включает:

• поля даты и времени;
• поля номеров страниц;
• поля автора и отправителя;
• поля главы;
• поля имени файла;
• поля шаблона документа.

6.2.1 Поля даты

Поля даты отображают текущую дату. Дата может быть скорректирована для отображения даты, отличной от текущей. Например, дата может изменяться в документе, который был отредактирован поздно ночью так, чтобы отображать дату следующего дня или на несколько дней позже.

Этот элемент содержит представление значения поля даты в зависимости от установленного стиля даты. Дата по умолчанию — текущая дата. Значение этого элемента может быть задано неизменяемым при использовании атрибута text:fixed, описанного в разделе 6.7.2.

С элементом text:date могут быть связаны следующие атрибуты: - значение даты; - корректировка даты;

• фиксирование (см. раздел 6.7.2);

данных типа дата (см. раздел 14.7 для получения более подробной информации).

Значение даты

Атрибут text:date-value определяет конкретное значение даты. Например, если поле даты отмечено как фиксированное, этот атрибут может использоваться для определения даты, когда поле было отмечено как фиксированное. Этот атрибут может также быть использован, чтобы определить будущую дату. Некоторые приложения поддерживают значение даты и времени в дополнение к значению, состоящему только из даты.

Значение даты должно соответствовать форматам даты, описанным в § 3.2.7 и § 3.2.9 в [xmlschema-2]. Если не задано никакого значения, то устанавливается текущая дата, даже если поле было отмечено как фиксированное.

Корректировка даты

Значение поля даты может быть скорректировано на определенный промежуток времени, который определен с использованием атрибута text:date-adjust. Если промежуток времени отрицательный, он вычитается из значения поля даты, получается дата более ранняя, чем текущая.

Значение этого атрибута должно соответствовать формату промежутка времени, описанному в § 3.2.6 в [xmlschema-2]. Значение может следовать за необязательным знаком минус, чтобы показать отрицательную продолжительность времени.

6.2.2 Поля времени

Поля времени отображают текущее время. Они подобны полям даты, описанным в разделе 6.2.1, и поддерживают те же атрибуты, за исключением того, что для полей времени они называются атрибутами text:time-value и text:time-adjust.

Этот элемент содержит представление значения поля времени, зависящего от установленного стиля даты. Время по умолчанию — текущее время. Значение данного элемента может быть задано неизменяемым при использовании атрибута text:fixed, описанного в разделе 6.7.2.

С элементом text:time могут быть связаны следующие атрибуты: - значение времени;

- <a id="p101022"></a>корректировка времени;

• фиксирование (см. раздел 6.7.2);
• стиль форматирования (см. раздел 6.7.7), который должен быть стилем данных типа время (см. раздел 14.7 для получения более подробной информации).

Значение времени

Атрибут text:time-value отмечает время последнего редактирования документа.

Некоторые приложения поддерживают значение даты и времени в дополнение к значению, состоящему только из даты.

Значение данного атрибута должно соответствовать типам данных «dateTime» или «time», описанным в § 3.2.7 и § 3.2.8 в [xmlschema-2]. Если не задано никакого значения, то устанавливается значение текущего времени, даже если поле было отмечено как фиксированное.

Корректировка времени

Значение поля времени может быть скорректировано к определенному промежутку времени, который определен с использованием атрибута text:time-adjust.

Значение этого атрибута должно соответствовать формату промежутка времени, описанному в § 3.2.6 в [xmlschema-2]. Значение может следовать за необязательным знаком минус, чтобы показать отрицательную продолжительность времени. Положительные значения корректируют время к более позднему значению времени, в то время как отрицательные значения корректируют время к более раннему значению времени. Продолжительность времени усекается до целого значения минут.

Пример. Атрибуты корректировки времени и вызываемый ими эффект:

6.2.3 Поля номера страницы

Поля номера страницы отображают номер текущей страницы. Эти поля особенно полезны в колонтитулах. Например, если поле номера страницы вставлено в нижний колонтитул, номер текущей страницы отображается на каждой странице, на которой появляется нижний колонтитул.

С элементом text:page-number могут быть связаны могут следующие атрибуты:

- <a id="p101040"></a>корректировка номеров страниц;

- <a id="p101041"></a>отображение номера предыдущей или следующей страницы;

• фиксирование (см. раздел 6.7.2);
• стиль форматирования (см. раздел 6.7.8).

Номера страниц могут быть отформатированы в соответствии с форматом чисел, описанным в разделе 12.2. Если стиль номера не определен, номера страниц форматируются в соответствии со стилем чисел,

  определенным в стиле текущей страницы.

Примечание. Для отображения общего числа страниц в документе используйте поле text:page-count/, описанное в разделе 6.4.17.

Значение поля номера страницы может быть скорректировано на определенное число, что позволяет отображать номера следующих или предыдущих страниц. Корректировка осуществляется с использованием атрибута text:page-adjust. Когда используется этот атрибут, приложение: - добавляет значение атрибута к номеру текущей страницы; - проверяет, существует ли результирующая страница;

- <a id="p101052"></a>если страница существует, отображается номер этой страницы;

- <a id="p101053"></a>если  страница не существует, значение поля  номера страницы остается
  пустым и никакое значение не отображается.

Отображение номера предыдущей или следующей страницы

Атрибут text:select-page используется для отображения номера предыдущей или следующей страницы, а не номера текущей страницы.

Примечание. Для отображения номера текущей страницы на всех страницах за исключением первой или последней, используйте комбинацию атрибутов text:select-page и text:page-adjust.

Пример. Отображение номера текущей страницы на всех страницах, за исключением первой:

6.2.4 Текст, указывающий на продолжение страницы

В некоторых публикациях в нижней части страницы в дополнение к номеру страницы печатается текст, указывающий на продолжение. Для добавления текста, указывающего на продолжение, используется элемент text:page-continuation.

С элементом text:page-continuation могут быть связаны следующие атрибуты:

• предыдущая или следующая страница;
• строковое значение.

Предыдущая или следующая страница

Этот атрибут указывает на необходимость проверить наличие предыдущей или следующей страницы, и если страница существует, печатается текст, указывающий на продолжение.

Строковое значение

Этот атрибут определяет отображение текста, указывающего на продолжение. Если атрибут опущен, используется содержимое элемента.

6.2.5 Поля отправителя

Есть несколько полей, которые содержат информацию об отправителе текущего документа, например, имя и адрес электронной почты. Информация об отправителе берется из диалогового окна информации о пользователе OpenDocument. Если поле отправителя отмечено как фиксированное использованием атрибута text:fixed, информация о первоначальном отправителе в полях отправителя остается неизменной (см. раздел 6.7.2). В противном случае информация обновляется каждый раз, когда редактируется файл, и изменение значений данных полей происходит всегда, когда документ редактируется другим пользователем.

Имя

Фамилия

Инициалы

Этот элемент представляет инициалы отправителя.

Титул

Должность

Адрес электронной почты

Этот элемент представляет адрес электронной почты отправителя.

Личный телефонный номер

Номер факса

Название компании

Номер рабочего телефона

Улица

Город

Почтовый индекс

Страна

Штат или регион

Этот элемент представляет название штата или региона, в котором проживает отправитель, если применимо.

6.2.6 Поля автора

Есть два элемента, доступных для отображения автора документа. Первый элемент отображает полное имя автора, второй — его инициалы.

Значение полей автора может быть зафиксировано использованием атрибута text:fixed. Отметка в поле автора как фиксированного оставляет неизменным начальное содержимое поля. В противном случае содержимое поля изменяется каждый раз, когда документ обновляется, чтобы отразить последнего автора документа.

Имя автора

Инициалы автора

6.2.7 Поля главы

Поля главы отображают одно из следующего:

• название текущей главы;
• номер текущей главы;

Если поле главы расположено внутри верхнего или нижнего колонтитула, оно отображает название или номер текущей главы на каждой странице.

• отображение;
• уровень структуры.

Отображение

Атрибут text:display определяет информацию, которую поле главы должно отобразить.

Пример.

Если номер текущей главы 2.4, заголовок главы «Работа с таблицами», возможные варианты отображения и результаты следующие:

Уровень структуры

Этот атрибут применяется, чтобы определить используемый уровень структуры. Поле главы отображает номер или название главы вплоть до определенного уровня структуры.

6.2.8 Поля имени файла

Поля имени файла отображают имя файла, который в настоящее время редактируется.

С элементом text:file-name могут быть связаны следующие атрибуты:

• отображение;
• фиксирование.

Атрибут text:display определяет, как отображать имя файла. Следующие варианты позволяют отобразить:

• полное имя файла, включая расширение и путь к нему;
• только путь к файлу;
• только имя файла;

Имя файла должно быть записано в формате IRI потому, что формат IRI используется для получения файла или из-за того, что приложение внутренне использует формат IRI и поэтому конвертирует даже специфические для системы пути в формат IRI. Если указанные факторы являются причиной и если путь, имя или расширение файла не могут быть вычислены из IRI, тогда IRI должен отображаться неизмененным.

Если поле имени файла фиксировано, его значение не изменяется, когда файл редактируется.

6.2.9 Поля имени шаблона документа

Поле имени шаблона документа отображает информацию об используемом шаблоне документа, такую как имя шаблона или имя файла.

С элементом text:template-name может быть связан атрибут:

Отображение

Этот атрибут определяет, какую информацию о шаблоне документа отображать. Доступны следующие варианты отображения:

• полное имя файла, включающее путь и расширение;
• только путь к файлу;
• только имя файла;
• имя файла и расширение;

• область шаблона документа.

Последние два значения могут быть использованы для диалогов шаблона. Они являются расширенным набором значений отображения для элемента text:file-name.

6.2.10 Поля имен листов

Для документов электронных таблиц поля имен листов отображают имя листа, который в настоящий момент редактируется.

6.3. Поля-переменные

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

Имеется три типа переменных. - Простые переменные

      Простые  переменные,  обычно  называемые  просто  переменными,  могут
      принимать   различные   значения   в   различных  позициях   на  всем
      протяжении  документа.  Простые  переменные  могут быть установлены с
      использованием   либо  полей   установки,  либо   полей  ввода.  Поля
      установки  содержат  выражение,  которое  используется для вычисления
      нового  значения переменной.  Поля ввода запрашивают  у  пользователя
      новое  значение.  Простые  переменные  могут  быть  использованы  для
      отображения  различного  текста в  повторяющихся элементах, таких как

  верхние или нижние колонтитулы.

- <a id="p101201"></a>Переменные пользователя

      Переменные  пользователя имеют  одно и то же  значение на  протяжении
      всего документа. Если  переменная пользователя  установлена  в  любом
      месте в пределах документа, все поля  в документе, которые отображают

  переменную   пользователя,    имеют   то   же   самое   значение.   В

  пользовательском    интерфейсе    офисного    приложения   переменная

  пользователя  может   быть  установлена   в  любом  экземпляре   поля

      пользователя   или   с   использованием   входных   полей  переменной
      пользователя.  В  формате  файла   OpenDocument  значение  переменной
      пользователя   может   быть   установлено  только   после  объявления

  переменной.
- <a id="p101203"></a>Переменные последовательности

Переменные последовательности используются для нумерации определенных объектов в текстовом документе OpenDocument, например, изображений или таблиц.

Выражения и поля ввода текста также являются полями-переменными, но они не связаны с какими-либо конкретными переменными. Однако, поскольку по функциональности они тесно связаны с полями-переменными, то они также описаны в данном разделе руководства.

Переменные должны быть объявлены прежде, чем они могут быть использованы. Объявления переменных собраны в элементах-контейнерах для переменных определенного типа. Код OpenDocument для объявления переменных описан в разделах 6.3.1, 6.3.5 и 6.3.8.

6.3.1 Объявление простых переменных

Простые переменные объявляются с использованием элементов text:variable-decl. Объявление устанавливает имя и тип значения переменной.

Для определения имени и типа значения простой переменной с элементом text:variable-decl могут быть связаны следующие атрибуты: - text:name

Имя переменной должно быть уникально. Оно не может использоваться для переменной любого другого типа (см. раздел 6.7.3 для получения информации по использованию этого атрибута). - office:value-type

См. раздел 6.7.1 для получения информации по использованию этого атрибута.

6.3.2 Задание значения простой переменной

Значения простых переменных могут быть заданы с использованием элементов-установщиков переменных. Эти элементы содержат представление значения переменной, которое может быть пустым, если атрибут text:display установлен в значение none.

С элементом text:variable-set могут быть связаны следующие атрибуты: - text:name

      Этот атрибут определяет  имя  устанавливаемой  переменной. Оно должно
      соответствовать  имени  переменной,  которая  уже была объявлена (см.

раздел 6.7.3 для получения информации по использованию этого атрибута). - text:formula

      Этот    атрибут    содержит    формулу    для   вычисления   значения
      поля-переменной.  Если  формула совпадает с содержимым элемента поля,

этот атрибут может быть опущен (см. раздел 6.7.6 для получения информации по использованию этого атрибута). - office:value-type и соответствующий атрибут значения (см. раздел 6.7.1 для получения информации по использованию этих атрибутов).

      Примечание.  Простая  переменная   не  должна  иметь  различные  типы
      значения  в  различных  местах  документа.  Тем  не менее  реализация
      может допускать использование  различных типов значения для различных

  экземпляров  той  же  самой  переменной.   В  случае  типов  числовых

      значений  float,  percentage   и   currency  значение   автоматически
      преобразуется  в  другой  тип  значения. Для типов значений,  которые
      имеют  внутреннее  представление в виде чисел, такие как date, time и
      boolean значения  интерпретируются  как  числа соответствующего типа.
      Если   переменная   используется  как  для   строкового,  так  и  для
      нестрокового типов,  то   поведение  не  определено,   следовательно,

  подобная практика не рекомендована.

- <a id="p101224"></a>text:display

      Этот  атрибут может  использоваться, чтобы определить, необходимо или
      нет  отображать значение  элемента .  Если атрибут
      text:display установлен  в  value,  значение переменной отображается.
      Если атрибут установлен  в none, значение не отображается (см. раздел

6.7.5 для получения информации по использованию этого атрибута). - style:data-style-name

      Этот атрибут определяет  стиль данных для использования, чтобы задать
      формат   числовой,   логической   переменной   или   переменной  типа
      дата/время.  Если  стиль   данных  не   определен,  то   используется

стандартный стиль данных (см. раздел 6.7.7 для получения информации по использованию этого атрибута).

6.3.3 Отображение простых переменных

Элемент text:variable-get читает и отображает значение простой переменной. Значение этого элемента является значением последнего предшествовавшего элемента text:variable-set с таким же атрибутом text:name. Этот элемент определяет, как представлять значение переменной в зависимости от выбранного стиля форматирования.

С элементом text:variable-get могут быть связаны следующие атрибуты: - text:name

Этот атрибут определяет имя отображаемой переменной. Имя должно соответствовать имени предшествовавшего элемента text:variable-decl (см. раздел 6.7.3 для получения информации по использованию этого атрибута). - text:display

      Этот  элемент   может  быть  использован  для  определения  того, что
      отображать: формулу для  простой переменной или вычисленное  значение

переменной (см. раздел 6.7.5 для получения информации по использованию этого атрибута). - style:data-style-name

      Этот атрибут определяет  используемый стиль данных для форматирования
      числовой,  логической переменной или переменной типа дата/время. Если

  стиль данных  не  определен,  используется  стандартный  стиль данных

(см. раздел 6.7.7 для получения информации по использованию этого

  атрибута).

6.3.4 Поля ввода простой переменной

Как альтернатива установке значений простых переменных с использованием формул в элементах-установщиках переменных, значения переменных могут запрашиваться у пользователя. Для этого используется элемент text:variable-input, содержащий представление значения переменной в соответствии с выбранным стилем форматирования. Представление может быть пустым, если атрибут text:display установлен в none.

С элементом text:variable-input могут быть связаны следующие атрибуты: - text:name

Этот атрибут определяет имя отображаемой переменной. Оно должно совпадать с именем ранее объявленной переменной (см. раздел 6.7.3 для получения информации по использованию этого атрибута). - text:description

      Этот  необязательный  атрибут  содержит короткое  сообщение,  которое
      представляется   пользователям  во  время  запроса  ввода.  Сообщение
      должно давать  пользователям достаточную  информацию о переменной или
      об  использовании  значения  внутри  документа,  чтобы  позволить  им

выбрать подходящее значение (см. раздел 6.7.4 для получения информации по использованию этого атрибута). - office:value-type и соответствующий атрибут значения (см. раздел

6.7.1 для получения информации по использованию этого атрибута). - text:display

      Этот атрибут может  быть  использован для определения, отображать или
      спрятать  значение  переменной  в поле  ввода  переменной (см. раздел

- <a id="p101253"></a>style:data-style-name

  числовой,  логической переменной или переменной типа дата/время. Если
  стиль данных не определен, используется стандартный стиль данных (см.

раздел 6.7.7 для получения информации по использованию этого атрибута).

6.3.5 Определение переменных пользователя

Переменные пользователя содержат значения, которые отображаются с помощью соответствующих полей. В отличие от простых переменных, переменные пользователя имеют одно и то же значение на всем протяжении документа. По этой причине значение переменной пользователя хранится в самом объявлении переменной.

С элементом text:user-field-decl могут быть связаны следующие атрибуты: - text:name

      Этот  атрибут определяет имя  объявляемой  переменной, которое должно
      быть  уникально.  Оно  также  не может использоваться  для переменных
      любого  другого  типа,   включая  простые   переменные  и  переменные

последовательности (см. раздел 6.7.3 для получения информации по использованию этого атрибута). - text:formula

Этот атрибут содержит формулу для вычисления значения поля переменной пользователя. Если формула совпадает с содержимым элемента поля, этот атрибут может быть опущен (см. раздел 6.7.6 для получения информации по использованию этого атрибута). - office:value-type и соответствующий атрибут значения (см. раздел

6.7.1 для получения информации по использованию этого атрибута).

6.3.6 Отображение переменных пользователя

Содержимое переменных пользователя может быть отображено с использованием элементов text:user-field-get.

- <a id="p101271"></a>text:name

      Этот атрибут  определяет имя  отображаемой  переменной, которе должно
      полностью   соответствовать     имени     предшествующего    элемента

text:user-field-decl (см. раздел 6.7.3 для получения информации по использованию этого атрибута). - text:display

Этот атрибут может быть использован для определения одной из следующих возможностей: - отображение формулы, используемой для вычисления значения переменной пользователя; - отображение значения переменной пользователя; - спрятать поля переменной пользователя. См. раздел 6.7.5 для получения информации по использованию этого атрибута.

      Примечание. Так  как  пользовательские интерфейсы  офисных приложений
      обычно позволяют  редактировать переменные  пользователя щелчком мыши
      на поле пользователя, то, чтобы иметь возможность простого  доступа к
      конкретной  переменной пользователя, в  качестве  привязки может быть

  использован скрытый элемент <text:user-field-get>.

- <a id="p101279"></a>style:data-style-name

      Этот  атрибут  определяет   стиль   данных   для   использования  при
      форматировании  числовой, логической  переменной или переменной  типа
      дата/время.  Если   стиль  данных  не   определен,  то   используется

стандартный стиль данных (см. раздел 6.7.7 для получения информации по использованию этого атрибута).

6.3.7 Поля ввода переменной пользователя

Альтернативным способом установки значений переменных пользователя является использование полей ввода, подобных полям ввода простых переменных. Переменная пользователя может быть установлена этим способом при использовании элемента text:user-field-input. С того момента как значение изменяемого поля пользователя сохранено в элементе text:user-field-decl, элемент text:user-field-input не содержит атрибуты значения и типа значения из поля text:variable-input.

Представление может оказаться пустым, если атрибут text:display установлен в none.

С элементом text:user-field-input могут быть связаны следующие атрибуты: - text:name

Этот атрибут определяет имя устанавливаемой переменной. Оно должно совпадать с именем ранее объявленной переменной (см. раздел 6.7.3 для получения информации по использованию этого атрибута). - text:description

      Этот  необязательный  атрибут  содержит короткое  сообщение,  которое
      представляется  пользователям   во  время  запроса  ввода.  Сообщение
      должно давать пользователям  достаточную  информацию о переменной или
      об использовании   значения  внутри  документа,  чтобы  позволить  им

выбрать подходящее значение (см. раздел 6.7.4 для получения информации по использованию этого атрибута). - style:data-style-name

Этот атрибут определяет стиль данных, используемый для форматирования

      числовой, логической переменной  или переменной типа дата/время. Если
      стиль данных  не  определен,  используется  стандартный  стиль данных

(см. раздел 6.7.7 для получения информации по использованию этого атрибута).

6.3.8 Объявление переменных последовательности

Переменные последовательности используются для нумерации объектов внутри текстового документа OpenDocument. Переменные последовательности наиболее часто используются для последовательной нумерации. Тем не менее формулы выражения могут быть включены в поля последовательности для поддержки более расширенных последовательностей (см. раздел 6.3.9 для получения более подробной информации о полях последовательности и их использовании).

Переменные последовательности объявляются с использованием элемента text:sequence-decl.

Для упрощения специфичной для главы нумерации, к переменной последовательности могут быть присоединены атрибуты для определения уровня главы и символа-разделителя. С элементом text:sequence-decl могут быть связаны следующие атрибуты: - text:name

      Этот атрибут  определяет имя  объявляемой переменной,  которое должно
      быть   уникально.   Оно  также   не  может   быть   использовано  для
      переменных  любого   другого  типа,   включая  простые  переменные  и

переменные пользователя (см. раздел 6.7.3 для получения информации по этому атрибуту). - text:display-outline-level

См. ниже раздел «Уровень структуры» для получения информации по этому атрибуту. - text:separation-character

См. ниже раздел «Символ-разделитель» для получения информации по этому атрибуту.

Уровень структуры

Последовательности могут быть пронумерованы по главам. Для использования этой особенности применяется атрибут text:display-outline-level, чтобы определить уровень структуры, задающий, какие главы ссылаются на специфичную для главы нумерацию. Все главы с определенного и ниже уровня структуры сбрасывают значение последовательности в ноль — значение по умолчанию. Кроме того, номер последней главы с определенного или ниже уровня структуры добавляется в начало номера последовательности. Выбор нуля в качестве уровня структуры приводит к прямому порядку следования всех элементов последовательности для этой переменной последовательности.

Если последовательности нумеруются по главам, то этот атрибут используется для выбора символа, который будет отделять номер главы от номера последовательности.

Если значение атрибута text:display-outline-level отлично от нуля, символ-разделитель может быть определен. Символ-разделитель по умолчанию — «.». В противном случае, если значение text:display-outline-level равно нулю, этот атрибут может быть опущен.

Пример. Переменная последовательности:

Переменная последовательности 3.7.36#5 со значением, равным 5, объявляется с использованием:

6.3.9 Использование полей последовательности

С того момента как переменная последовательности объявлена, она может использоваться в полях последовательности всюду в документе. Большинство полей последовательности просто увеличивают и отображают переменную последовательности. Однако поля последовательности также могут принимать новое начальное значение в любом заданном месте документа. Это начальное значение вычисляется с использованием формулы, которая находится в поле последовательности. Если поле последовательности добавлено без начального значения, офисное приложение автоматически вставляет выражение типа variable+1.

Поля последовательности чаще всего используются для простых счетных последовательностей. Однако способность поддерживать произвольные выражения позволяет задавать более сложные последовательности. Для того чтобы сформировать последовательность четных чисел, все элементы последовательности для этой конкретной переменной должны содержать формулу, увеличивающую значение на два, например, variable+2. Последовательность с начальным значением, равным 1, и всеми последующими элементами, использующими формулу variable*2, приводит ко всем степеням 2. Так как различные элементы последовательности для одной и той же переменной последовательности могут содержать различные формулы, возможно построение сложных последовательностей.

- <a id="p101325"></a>text:name

      Этот  атрибут   определяет  имя   переменной,  которую   данное  поле
      отображает.    Оно   должно    совпадать    с    именем    переменной

последовательности, которая ранее определена (см. раздел 6.7.3

  для получения информации по использованию этого атрибута).

- <a id="p101327"></a>text:formula

      Этот необязательный атрибут  содержит формулу для вычисления значения
      поля  последовательности.  Если  этот  атрибут  опущен,  используется

выражение, соответствующее содержимому элемента (см. раздел 6.7.6 для получения информации по использованию этого атрибута).

- <a id="p101329"></a>style:num-format и style:num-letter-sync

Эти атрибуты определяют использование стиля нумерации. Если стиль нумерации не определен, стиль нумерации наследуется из стиля страницы

(см. раздел 6.7.8 для получения более подробной информации по использованию этого атрибута).

- <a id="p101332"></a>text:ref-name<br>

  атрибуту.

Имя ссылки

Поля последовательности могут быть целью ссылок, в соответствии с представлением используемых полей ссылки (см. раздел 6.6.5 для получения более подробной информации о полях ссылки). Чтобы позволить полю ссылки указывать на определенное поле последовательности, поле последовательности должно иметь дополнительный атрибут, содержащий имя. Никакие два поля последовательности не могут иметь одинаковое имя ссылки.

Если поле последовательности не является целью ссылки, этот атрибут может быть опущен.

6.3.10 Поля выражений

Поля выражений содержат выражения, которые вычисляются, и после чего отображается результирующее значение. Значение выражения форматируется в соответствии с выбранным стилем форматирования.

С элементом text:expression могут быть связаны следующие атрибуты: - text:formula

Этот атрибут содержит текущее выражение, используемое для вычисления значения поля выражения (см. раздел 6.7.6 для получения информации об использовании этого атрибута). - office:value-type и соответствующий атрибут значения (см. раздел

6.7.1 для получения информации об использовании этих атрибутов). - text:display

Этот атрибут применяется для отображения: - значения поля; - формулы, используемой для вычисления значения.

См. раздел 6.7.5 для получения информации об использовании

    этого атрибута.

- <a id="p101351"></a>style:data-style-name

      Этот атрибут определяет  стиль данных, применяемый для форматирования
      числовой,  логической переменной или переменной типа дата/время. Если
      стиль данных  не  указан,  используется стандартный стиль данных (см.

раздел 6.7.7 для получения информации об использовании этого

  атрибута).

6.3.11 Поля ввода текста

Поля ввода текста являются полями-переменными. С точки зрения пользовательского интерфейса поля ввода текста подобны полям text:variable-input и text:user-field-input. Тем не менее поле ввода текста не изменяет значение какой-либо переменной.

С элементом text:text-input может быть связан атрибут: - text:description

      Этот  атрибут  содержит  короткое сообщение,  которое  представляется
      пользователю,  во  время   запроса  ввода.  Сообщение  должно  давать

  пользователю достаточно информации о назначении поля и о том, как оно
  будет  использоваться  в  пределах  документа,  чтобы  позволить  ему

выбрать подходящее значение (см. раздел 6.7.4 для получения информации по использованию этого атрибута).

6.4. Поля метаданных

Поля метаданных отображают метаинформацию о документе, такую как дату создания документа или время последнего распечатывания документа. Имена элементов поля метаданных аналогичны элементам метаданных, описанным в разделе 3.

Все элементы поля метаданных могут быть отмечены как фиксированные с помощью атрибута text:fixed (см. раздел 6.7.2).

Несколько полей метаданных отображают дату или время. Элементы этих полей требуют наличия атрибутов text:date-value или text:time-value и необязательного атрибута style:data-style-name (см. раздел 6.7.1 для получения более подробной информации по этим атрибутам).

6.4.1 Автор первоначального документа

Этот элемент представляет имя автора, создавшего исходный документ.

6.4.2 Дата создания документа

Этот элемент представляет дату создания документа.

6.4.3 Время создания документа

Этот элемент представляет время создания документа.

6.4.4 Описание документа

Этот элемент содержит краткое описание документа.

6.4.5 Информация о документе, определяемая пользователем

Этот элемент содержит информацию о документе, определяемую пользователем. Он отображает информацию, находящуюся внутри элемента meta:user-defined, имеющем то же самое имя.

6.4.6 Время печати

6.4.7 Дата печати

6.4.8 Кем распечатан документ

Этот элемент представляет имя человека, который последним распечатал документ.

6.4.9 Заголовок документа

Этот элемент представляет заголовок документа.

6.4.10 Тема документа

Этот элемент представляет тему документа.

6.4.11 Ключевые слова документа

Этот элемент содержит список ключевых слов, используемых для описания документа.

6.4.12 Номер редакции документа

Этот элемент содержит номер редакции документа. При создании документа номер редакции устанавливается равным 1. Каждый раз, когда документ сохраняется, номер редакции документа увеличивается на 1.

Примечание. Так как поле text:editing-cycles не может быть отформатировано, номер редакции может быть прочитан из содержимого элемента. Поэтому нет необходимости в дополнительном атрибуте.

6.4.13 Продолжительность редактирования документа

Каждый раз, когда документ редактируется, офисное приложение записывает продолжительность интервала между временем открытия документа и временем его закрытия. Затем оно прибавляет эту продолжительность к внутреннему счетчику, тем самым отслеживая общее время, затраченное на редактирование документа.

6.4.14 Время изменения документа

Этот элемент представляет время последнего изменения документа.

Этот элемент отображает информацию из элемента meta:date. Такое имя выбрано во избежание путаницы с полями text:date.

6.4.15 Дата изменения документа

Этот элемент представляет дату последнего изменения документа.

Этот элемент отображает информацию из элемента meta:date. Такое имя выбрано во избежание путаницы с полями text:date.

6.4.16 Автор изменений документа

Этот элемент представляет имя человека, который последним изменял документ.

6.4.17 Поля статистики документа

Эти поля отображают количество объектов определенного типа, содержащихся в документе. Они могут отображать число:

• страниц;
• абзацев;

• символов;

• изображений;
• вложенных объектов.

6.5. Поля базы данных

Документы могут ссылаться на базы данных и отображать информацию из базы данных как текстовое содержимое. Для отображения информации базы данных схема OpenDocument использует группу текстовых полей под общим названием полей базы данных. Офисные приложения могут использовать таблицы базы данных с SQL-серверов, следовательно, поля базы данных могут быть использованы для доступа к любой базе данных SQL при условии доступа к соответствующим драйверам.

База данных может содержать следующие компоненты:

• таблицы, хранящие фактические данные;
• запросы, извлекающие подмножество данных из одной или более таблиц;

• отчеты, суммирующие содержимое базы данных.

Поскольку формы и отчеты базы данных не относятся к текстовому содержанию, то они в данном разделе не обсуждаются. С точки зрения вставки информации базы данных в текстовый документ OpenDocument, запросы и таблицы представляются одинаково. Поэтому в оставшейся части этого раздела фраза таблица базы данных относится равно как к таблицам базы данных, так и к запросам.

Сами по себе поля базы данных не извлекают информацию из базы данных. В дополнение к полям базы данных набор строк базы данных также добавляется в документ. Когда к документу добавляются новые данные, то обновляются все поля базы данных, относящиеся к связанной таблице базы данных. С помощью пользовательского интерфейса офисного приложения строки базы данных могут быть добавлены одним из следующих способов: - вручную, с использованием навигатора источников данных или функции

  передачи данных в поля;

- <a id="p101437"></a>с использованием пункта меню "Стандартное письмо" в меню "Файл", этот
  пункт  меню добавляет каждую строку из выбранного множества  данных в
  отдельно созданную копию стандартного письма.

Для отображения данных из таблицы базы данных используйте элемент text:database-display. Элементы text:database-select и text:database-next могут использоваться для определения строки в пределах текущего выбора, которая должна отображаться. Номер текущей строки для конкретной таблицы может быть отображен с использованием элемента text:database-row-number. И в заключение, поле text:database-name отображает имя последней используемой базы данных, которой по умолчанию является база данных файла адресной книги.

6.5.1 Источник данных поля базы данных

Источник полей базы данных может быть или именем базы данных, или IRI, содержащий данные ресурса подключения базы данных. Если источником является имя базы данных, тогда это имя используется всеми компонентами офисных приложений для идентификации базы данных. Все поля базы данных содержат имя базы данных или ресурса подключения, а большинство полей также содержит имя таблицы базы данных, которая должна храниться в базе данных. Дополнительный атрибут определяет, имеет ли отношение таблица базы данных к таблице SQL, запросу OpenDocument или является результатом команды SQL.

Имя базы данных

Атрибут text:database-name устанавливает исходную базу данных по ее имени.

Элемент form:connection-resource устанавливает исходную базу данных по [XLink], Ее атрибут xlink:href является ссылкой на файл, содержащий базу данных, или содержит информацию о том, как осуществить соединение с базой данных, например, [JDBC] URL (см. также раздел 11.1.20).

Имя таблицы базы данных

Атрибут text:table-name определяет таблицу в пределах исходной базы данных.

Тип базы данных

Атрибут text:table-type определяет, имеет ли отношение таблица базы данных к таблице SQL, запросу OpenDocument или является результатом команды SQL

6.5.2 Отображение содержимого базы данных

Элемент text:database-display отображает данные из базы данных. Когда в документ добавляется новый набор данных, все поля, отображающие данные из таблиц базы данных, обновляют свое содержимое.

С элементом text:database-display могут быть связаны следующие атрибуты:

- <a id="p101458"></a>text:database-name, text:table-name и text:table-type

Эти атрибуты определяют базу данных и таблицу базы данных, используемые этими полями. - text:database-column-name

См. ниже раздел «Имя столбца» для получения информации об этом

  атрибуте.

- <a id="p101462"></a>style:data-style-name

      Если  столбец  определяет числовое, логическое  значение или значение
      даты или времени,  данные форматируются  в  соответствии с подходящим
      стилем  данных.  Если   не  определено   никакого  стиля  данных,  то

  используется  стиль данных, связанный  с  этим  столбцом  (см. раздел

6.7.7 для получения более подробной информации по использованию этого атрибута).

Атрибут text:column-name определяет столбец, из которого отображаются данные. Значение этого атрибута должно быть столбцом, содержащимся в указанной базе данных.

6.5.3 Выборка следующей строки базы данных

Элемент text:database-next изменяет строку в текущей выборке, используемой для отображения во всех последующих полях text:database-display. Следующая строка из текущего выделения выбирается, если она удовлетворяет заданным условиям. Если требуется следующая строка независимо от каких-либо условий, условие может быть опущено или установлено в значение true.

- <a id="p101472"></a>text:database-name, text:table-name и text:table-type

Эти атрибуты определяют базу данных и таблицу базы данных, которые это поле использует. - text:condition

См. ниже раздел «Условие» для получения информации об этом атрибуте.

Условие

Атрибут text:condition определяет условное выражение. Выражение вычисляется, и, если результат интерпретируется как логическое значение «истина», в качестве новой текущей строки используется следующая строка. Значения поля базы данных могут использоваться в выражениях, путем указания в квадратных скобках имени базы данных, имени таблицы и имени столбца, разделенных точками.

Если атрибут text:condition не представлен, считается, что результатом выражения является true, означающее, что следующая строка выбирается без условия.

Пример.

Этот пример определяет условие, которое истинно, если текущая строка из таблицы базы данных адресной книги является адресом человека по имени Юлия. Если показанное в этом примере условие используется в элементе text:database-next, произойдет следующее. - Элементы text:database-display отобразят данные из первой строки текущего выделения. - Если столбец FIRSTNAME текущей строки читается как Юлия, текущая

  строка заменяется, в противном случае ничего не происходит.

- <a id="p101487"></a>Если первая  строка Юлия, следующие  элементы <text:database-display>
  отображают  данные  из   второй  строки,   в  противном  случае,  они
  отображают данные из первой строки.

См. раздел 6.7.6 для получения более подробной информации по синтаксису формулы атрибута text:condition, который аналогичен атрибуту text:formula.

6.5.4 Выбор номера строки

Элемент text:database-row-select выбирает определенную строку из текущего выделения. Как и с элементом text:database-row-next, условие может быть определено так, что указанная строка выбирается, только если условие принимает значение true.

С элементом text:database-row-select могут быть связаны следующие атрибуты: - text:database-name, text:table-name и text:table-type

Эти атрибуты определяют базу данных и таблицу базы данных, которые используются данным полем.

- <a id="p101494"></a>text:condition

Этот атрибут определяет условное выражение (см. раздел 6.5.3 для

  получения полного представления об использовании этого атрибута).

- <a id="p101496"></a>text:row-number

См. ниже атрибут «Выбор номера» строки для получения дополнительной информации.

Выбор номера строки

Этот атрибут определяет номер выбираемой строки, когда условие принимает значение true.

6.5.5 Отображение номера строки

Элемент text:database-row-number отображает номер текущей строки для заданной таблицы. Имейте в виду, что элемент отображает фактически номер строки из базы данных, а не номер строки в текущем выделении, который используется как значение атрибута в элементе text:database-row-select.

С элементом text:database-row-number могут быть связаны следующие атрибуты: - text:database-name, text:table-name и text:table-type

Эти атрибуты определяют базу данных и таблицу базы данных, которые использует данное поле. - style:num-format и style:num-letter-sync

Эти атрибуты определяют, как должно форматироваться число (см. раздел

6.7.8 для получения более подробной информации по использованию этого атрибута). - text:value

Этот атрибут определяет номер текущей строки. Номер изменяется, когда в текущий документ добавляются новые данные.

6.5.6 Отображение текущей базы данных и таблицы

Офисные приложения могут отслеживать последние базу данных и таблицу, которые использовались в документе. Другими словами, таблицу, которая использовалась последним полем, вставленным в документ. Элемент text:database-name отображает базу данных и имя таблицы, которая использовалась самой последней.

С элементом text:database-name могут быть связаны следующие атрибуты: - text:database-name, text:table-name и text:table-type

Эти атрибуты определяют базу данных и таблицу базы данных, которые использует данное поле.

6.6. Прочие поля

6.6.1 Поля переменных страницы

Переменные страницы позволяют определять альтернативную схему нумерации страниц. Есть только одна переменная страницы, и она задается любым способом задания поля переменной страницы в документе. Значение переменной страницы увеличивается на каждой странице таким же образом, как и обычные номера страниц.

Установка значений полей переменных страницы

Для установки значения поля переменной страницы используйте элемент text:variable-page-set.

Включение или выключение переменных страницы

В начале документа переменная страницы неактивна. Атрибут text:active может быть использован для блокировки переменной страницы после того, как она была использована в документе.

Корректировка переменной страницы

Атрибут text:page-adjust определяет корректировку страницы. Значение активной переменной страницы — номер текущей страницы плюс значение корректировки ближайшей страницы, которое было установлено ранее.

Отображение полей переменных страницы

Элемент text:variable-page-get отображает значение переменной страницы. Поле может быть форматировано так же, как и поля обычных номеров страниц.

С элементом text:get-page-variable могут быть связаны следующие атрибуты: - style:num-format и style:num-letter-sync

раздел 6.7.8 для получения более подробной информации об

  использовании этих атрибутов).

6.6.2 Поля для заполнения

Формат OpenDocument использует поля для заполнения с целью указания места в документе, которое пользователь должен заполнить некоторой информацией. Например, в шаблоне письма раздел документа может быть зарезервирован для адреса получателя. Поле для заполнения отображает текст, информирующий пользователя о назначении поля для заполнения, и иногда содержит описание. Поля для заполнения могут представлять различные текстовые элементы, такие как текст или таблицы.

Этот элемент содержит некоторый короткий текст, который отображается полем для заполнения.

С элементом text:placeholder могут быть связаны следующие атрибуты:

• тип поля для заполнения;
• описание поля для заполнения.

Имеется пять различных типов полей для заполнения, представляющих пять возможных типов содержимого: текст, таблицы, текстовые блоки, изображения или объекты. Атрибут text:placeholder-type представляет тип содержимого. Этот атрибут обязателен, и он указывает, какой тип текстового содержимого представляет поле для заполнения. Атрибут может принимать значения text, text-box, image, table или object.

Описание поля для заполнения

В дополнение к краткому тексту, хранящемуся в содержимом элемента, с элементом поля для заполнения может быть связан атрибут text:description. Этот атрибут необязателен. Предназначение — содержать более подробное описание цели полей для заполнения, чем описание, сохраненное в содержимом элемента (см. раздел 6.7.4 для получения информации по использованию атрибута text:description).

6.6.3 Условные текстовые поля

Текстовые поля могут быть использованы для отображения одного или другого текста, в зависимости от условия. Условные текстовые поля задаются с помощью условия и двух текстовых строк. Если условие истинно, отображается первая из текстовых строк. Если условие ложно, отображается другая текстовая строка.

С элементом text:conditional-text могут быть связаны следующие атрибуты:

• условие;
• текст, отображаемый в случае, если условие истинно;
• текст, отображаемый в случае, если условие ложно;
• текущее состояние.

Атрибут text:condition содержит логическое выражение. В зависимости от результата, отображается значение атрибута text:display-if-true или text:display-if-false.

Отображаемый текст, если условие истинно

Атрибут text:string-value-if-true содержит текстовую строку, которая отображается, если условие вернуло значение true.

Отображаемый текст, если условие ложно

Атрибут text:string-value-if-false содержит текстовую строку, которая отображается, если условие вернуло значение false.

Атрибут text:current-value содержит результат вычисления условия, заданного выражением в атрибуте text:condition. Результат, заданный в явном виде, позволяет приложениям отложить вычисление результата, пока он не потребуется. Этот атрибут полезен по следующим причинам: - если вычисление выражения требует больших издержек, например, выражение содержит ссылки на несколько баз данных; - чтобы позволить преобразованиям корректно отображать состояние

  документа без необходимости анализа и вычисления условия.

Примечание. Значение этого атрибута перезаписывается каждый раз, как только приложение вычисляет выражение. Этот атрибут не имеет другой функции, кроме упрощения преобразования или первоначального отображения документа.

6.6.4 Скрытое текстовое поле

Скрытое текстовое поле тесно связано с условным текстовым полем. Оно отображает определенный текст, кроме случаев, когда условие возвращает значение true. В этом случае оно ничего не отображает.

С элементом text:hidden-text могут быть связаны следующие атрибуты:

• текст;
• скрытость.

Условие

Атрибут text:condition содержит логическое выражение. Если результат вычисления выражения — true, то текст скрытый.

Атрибут text:string-value определяет отображаемый текст, если значение условия — false.

Скрытость

Атрибут text:is-hidden определяет, является ли в настоящий момент поле видимым или нет. Цель этого атрибута подобна назначению атрибута text:current-value в поле text:condition. Запись результатов позволяет при изменениях корректно представлять документ без необходимости анализа условного выражения или вычисления условия при загрузке документа.

Примечание. Значение этого атрибута перезаписывается каждый раз, как только приложение вычисляет выражение. Этот атрибут не имеет другой функции, кроме упрощения преобразования или первоначального отображения документа.

6.6.5 Поля ссылок

Формат OpenDocument использует четыре типа поля ссылки и каждый тип представлен своим собственным элементом. Типы полей ссылок основываются на типах элементов, на которые они ссылаются: сноски, закладки, ссылки и последовательности. Каждая ссылка содержит формат ссылки, определяющий, какая информация отображается о указанном объекте цели. Например, ссылки могут отображать: - номер страницы указанного объекта; - номер главы указанного объекта; - текст, отражающий, выше или ниже относительно поля ссылки находится

  указанный объект.

Кроме того, каждое поле ссылки должно определять свою цель, что, как правило, делается с использованием атрибута имени. Закладки и ссылки задаются именем соответствующей закладки или ссылки. Обычные сноски, концевые сноски и последовательности связываются именами, используемыми приложением для автоматического создания файла формата OpenDocument.

• имя ссылки;

Имя ссылки

Атрибут text:ref-name однозначно определяет ссылочный элемент. Поскольку закладки и ссылки имеют имя, оно используется соответствующими полями ссылок. Обычные сноски, концевые сноски и последовательности определяются именем, которое обычно генерируется автоматически.

Класс сноски

Для элементов text:note-ref атрибут text:note-class определяет, ссылается ли поле на обычную или на концевую сноску.

Формат ссылки

Атрибут text:reference-format определяет, какую информацию о ссылке следует отображать. Если формат ссылки не определен, то по умолчанию используется формат страницы.

Все типы полей ссылок поддерживают следующие значения форматов для этого атрибута: - page — отображается номер страницы, на которой встречается указанный

  объект;

- <a id="p101614"></a>chapter - отображается  номер главы, на которой встречается указанный
  объект;
- <a id="p101615"></a>direction - отображается,  выше  или  ниже  относительно  поля ссылки
  находится указанный объект;

- <a id="p101616"></a>text - отображается текст указанного объекта.

Ссылки на поля последовательности поддерживают следующие три дополнительных значения: - category-and-value — отображается имя и значение последовательности; - caption — отображается заголовок, в котором используется последовательность; - value — отображается значение последовательности.

Пример. Различные форматы ссылок и их отображения.

Следующая таблица иллюстрирует все возможные форматы ссылок и результирующее отображение ссылки, которое может быть использовано, чтобы сослаться на саму таблицу. В левом столбце перечислены значения атрибута text:reference-format, а в правом — отображение ссылки:

6.6.6 Поля скриптов

Поле скрипта хранит скрипты или фрагменты скриптов. Поле может быть использовано для хранения или редактирования скриптов, которые прикреплены к документу. Первичная цель этого поля — обеспечить эквивалент тегу <script> в [HTML4] так, чтобы содержание тега <script> из HTML могло импортироваться, редактироваться и экспортироваться с использованием офисных приложений.

Исходный код скрипта может быть сохранен одним из следующих способов. - Исходный код может содержаться в элементе text:script. - Исходный код может храниться во внешнем файле. Используйте атрибут xlink:href, чтобы определить местоположение файла.

Элемент должен иметь атрибут xlink:href или содержимое, но не оба одновременно.

URL скрипта

Атрибут xlink:href определяет местоположение файла, содержащего исходный код скрипта. Поле скрипта должно иметь либо атрибут URL, либо содержимое, но не оба одновременно.

Язык скрипта

Атрибут script:language определяет язык, на котором написан исходный код скрипта, например, JavaScript.

6.6.7 Поля макросов

Поле макроса содержит имя макроса, который выполняется, когда поле активируется. Поле также содержит описание, которое отображается как содержимое поля.

С элементом text:execute-macro может быть связан атрибут:

Имя макроса

6.6.8 Скрытые поля абзаца

Скрытое поле абзаца имеет функционал, подобный функционалу скрытых текстовых полей. Однако скрытое поле абзаца не имеет какого-либо содержимого. Оно скрывает абзац, в котором находится, что позволяет скрывать или отображать абзац форматированного текста в зависимости от того, какое значение вернуло определенное условие: true или false.

Скрытые поля абзаца часто используются совместно со стандартным письмом. Например, если состояние зависит от поля базы данных, скрытое поле абзаца может использоваться для выборочного включения абзацев в стандартное письмо, в зависимости от содержимого базы данных. В одном абзаце может находиться множество полей абзаца. Абзац отображается, если хотя бы в одном скрытом поле абзаца условие вернуло значение false. Как вариант, условия, связанные с несколькими скрытыми полями абзаца, могут быть объединены в одно в единственном поле с помощью логических операций в условиях.

Примечание. В отличие от большинства полей это поле не отображает текст, а влияет на абзац, в котором оно содержится.

С элементом text:hidden-paragraph могут быть связаны следующие атрибуты:

• условие;
• скрытость.

Атрибут text:condition содержит логическое выражение. Если результатом выполнения логического выражения является true, абзац скрывается. Если же результатом выполнения логического выражения является false, абзац отображается.

Скрытость

Атрибут text:is-hidden хранит значение: отображается ли абзац или нет. Его цель аналогична соответствующему атрибуту скрытого текстового поля, а именно — позволить правильно отображать абзац без необходимости сначала вычислять условное выражение. Значение этого атрибута перезаписывается новым значением каждый раз, когда приложение вычисляет значение выражения.

Примечание. Этот атрибут не имеет другого назначения, кроме упрощения преобразований или начального отображения документа.

6.6.9 Поля DDE-соединения

Поле DDE позволяет отображать информацию из DDE-соединения. Только один параметр требуется для поля DDE — имя DDE-соединения, которое передает данные в это поле. Этот элемент DDE-соединения определяет фактическое поле DDE, которое появляется в тексте.

Элемент поля содержит самые последние данные, которые были пересланы через DDE-соединение. Это может быть использовано для представления документа в том случае, если невозможно получить доступ к DDE-соединению.

С элементом text:dde-connection может быть связан атрибут:

• имя DDE-соединения.

Имя DDE-соединения

Атрибут text:name определяет имя DDE-соединения, на которое ссылается поле.

6.6.10 Поля измерений

В пределах текста, содержащегося в измеряемых векторных объектах (см. раздел 9.2.11), поле text:measure отображает текущие размеры. Атрибут draw:kind определяет, какую часть измерения отображать. Он может принимать одно из следующих значений: - value — отображается измеренное значение, например, «12»;

- <a id="p101684"></a>unit - отображается единица измерения, например, "см";

- <a id="p101685"></a>gap - промежуток или пробел  отображается тогда и только тогда, когда

      направление   написания  текста   измерения   перпендикулярно   линии
      измерения.  Цель   этого  значения  -  добавить  немного   свободного
      пространства   между   линией  измерения   и   текстом,   если  текст

  отображается перпендикулярно к линии измерения.

6.6.11 Поле формулы таблицы

Поле формулы таблицы унаследовано от предыдущих версий современных офисных приложений. Оно не должно использоваться в новых документах. В нем хранится формула, применяемая в таблицах, функция которой лучше выполняется атрибутом table:formula ячейки таблицы.

Элемент поле формулы таблицы может иметь следующие атрибуты: - text:formula

Этот атрибут содержит выражение, используемое для вычисления значения поля формулы таблицы (см. раздел 6.7.6 для получения информации по

  использованию этого атрибута).

- <a id="p101693"></a>text:display

Используйте этот атрибут для следующего: - отобразить значение поля; - отобразить формулу, используемую для вычисления значения.

См. раздел 6.7.5 для получения информации по использованию этого атрибута. - style:data-style-name

Этот атрибут определяет стиль данных, используемый для форматирования

      числовой,  логической переменной или переменной типа дата/время. Если
      стиль данных  не  определен,  используется  стандартный  стиль данных

(см. раздел 6.7.7 для получения информации по использованию этого атрибута).

6.7. Общие атрибуты полей

Атрибуты, описанные в этом разделе, могут быть использованы различными элементами поля.

6.7.1 Переменные значения и типы значения

Переменные и большинство полей переменных имеют текущие значения. Каждая переменная имеет тип значения, который должен быть определен, когда поле поддерживает множество типов значений. Тип значения определяется использованием атрибута office:value-type.

В зависимости от типа значения само значение записывается в различные атрибуты значения. Поддерживаемые типы значения, их соответствующие атрибуты и способ кодирования описаны в следующей таблице:

Понятие значений полей OpenDocument, типов значений и их кодирование в XML подобно понятиям соответствующих элементов XML для атрибутов ячеек таблицы (см. раздел 8.1.3 для получения информации по ячейкам таблиц и их атрибутам).

6.7.2 Фиксация

Атрибут text:fixed определяет, фиксировано или нет значение элемента поля. Если значение поля фиксировано, то значение элемента поля, к которому присоединен этот атрибут, будет неизменно на протяжении всех будущих редактирований документа. Если значение поля не фиксировано, то оно может быть заменено новым значением в процессе редактирования документа.

Этот атрибут может использоваться с:

• полями даты;
• полями времени;

• всеми полями отправителя;

6.7.3 Имя переменной

Используйте атрибут text:name для задания имени переменной при ее объявлении, установке значения или отображении. Этот атрибут может использоваться с любым из следующих элементов:

• text:variable-decl
• text:variable-set
• text:variable-get
• text:variable-input
• text:user-field-decl
• text:user-field-get
• text:user-field-input

• text:sequence

Когда этот атрибут используется для определения имени отображаемой переменной, переменная соответствующего типа и с таким же именем уже должна быть объявлена.

6.7.4 Описание

Атрибут text:description содержит краткое сообщение, которое отображается, когда у пользователя запрашивается ввод данных. Этот атрибут может использоваться с любым из следующих элементов:

• text:placeholder

• text:user-field-input
• text:text-input

6.7.5 Отображение

Атрибут text:display поддерживает до трех следующих величин: - value

Это значение отображает значение поля. Некоторые поля не поддерживают это значение. Тогда атрибут text:display только лишь принимает значения value или none и value или formula соответственно. - formula

      Это  значение  позволяет  отображать формулу,  а  не  значение  поля.
      Некоторые   поля  не   поддерживают   это  значение.   Тогда  атрибут
      text:display только  принимает  значения  value  или  none   и  value

  или formula соответственно.
- <a id="p101783"></a>none

      Несколько  полей  переменных   поддерживают   это  значение,  которое
      скрывает содержимое  поля. Это позволяет задавать значения переменных

  в одной части документа, а отображать их в другой части документа.

Этот атрибут может использоваться с любым из следующих элементов:

• text:variable-set
• text:variable-get

• text:user-field-get

6.7.6 Формула

Атрибут text:formula содержит формулу или выражение для вычисления значения поля. Этот атрибут может использоваться с любым из следующих элементов:

• text:variable-set
• text:user-field-decl

• text:expression

Формула должна начинаться с префикса, указывающего на синтаксис и семантику, используемые в формуле.

6.7.7 Стиль форматирования

Атрибут style:data-style-name ссылается на стиль данных, используемый при форматировании числового значения. Для получения общей информации о стилях см. раздел 14. Для получения более подробной информации по стилям данных см. раздел 14.7.

Для строковых переменных этот атрибут должен быть опущен. В других случаях этот атрибут необходим.

Имя должно соответствовать имени стиля данных.

Этот атрибут может использоваться с любым из следующих элементов:

• text:date
• text:time
• text:page-number
• text:variable-set
• text:variable-get
• text:variable-input

• text:user-field-input
• text:expression

6.7.8 Стиль форматирования чисел

Числа, используемые в числовых последовательностях, таких как номера страниц или поля последовательности, могут форматироваться в соответствии со стилями чисел, описанными в разделе 12.2. Поддерживаются следующие стили чисел:

• числовой — 1, 2, 3, ...;
• алфавитный — a, b, c,... или A, B, C, ...;
• римский — i, ii, iii, iv, ... или I, II, III, IV, ....

Примечание. Значение этого атрибута может быть любым из [XSLT] ключей форматов чисел 1, i, I, a или A.

Алфавитный стиль чисел нуждается в дополнительном атрибуте, определяющем способ отображения чисел, которые не могут быть представлены одной буквой. Формат OpenDocument поддерживает: - синхронизированную буквенную нумерацию, где буквы используются

  многократно, например aa, bb, cc и т.д.;

- <a id="p101824"></a>несинхронизированную буквенную нумерацию, например, aa, ab, ac и т.д.

7. ТЕКСТОВЫЕ ИНДЕКСЫ

Текст документов OpenDocument может содержать автоматически сформированные индексы. Индекс содержит отсортированный список всех элементов определенного типа, где критерии сортировки (положение в документе, алфавитный и т.д.) и типы элементов (заголовки глав, таблиц, и т.д.) определены типом индекса.

7.1. Индексные метки

Существует три типа индексных меток, соответствующие трем типам индексов, использующих индексные метки:

• индексные метки оглавления;
• определяемые пользователем индексные метки;
• алфавитные индексные метки.

XML-код для индексных меток похож на код для закладок и перекрестных ссылок. Ниже указаны некоторые основные правила для индексных меток: - каждая индексная метка представлена начальным и конечным элементами; - оба элемента используют атрибут ID, чтобы определить соответствующее начало и конец метки; - для каждого начального элемента должен быть определен конечный элемент в том же самом абзаце, с начальным элементом, определенным первым; - атрибуты, связанные с индексной меткой, присоединяются к начальному элементу; - текст, размещенный между начальным и конечным элементами, является текстом индексной записи;

- <a id="p101839"></a>атрибуты форматирования индексных меток могут перекрываться.

7.1.1 Индексные метки оглавления

Элемент меток text:toc-mark-start определяет начало индексной записи оглавления. ID, определяемый атрибутом text:id, должен быть уникальным, за исключением соответствующих конечных элементов индексных меток. Для каждого начального элемента должен быть определен конечный элемент в том же самом абзаце, с начальным элементом, определенным первым.

С элементом text:toc-mark-start могут быть связаны следующие атрибуты: - атрибут text:id, позволяющий начальному и конечному элементам соответствовать друг другу; - атрибут text:outline-level, устанавливающий уровень структуры

  индексов оглавления.

Элемент text:toc-mark-end определяет окончание индексной записи оглавления. Для каждого конечного элемента должен быть начальный элемент с таким же значением text:id, расположенный в том же абзаце, с начальным элементом, определенным первым.

Индексные метки в оглавлении также имеют вариант, который предполагает не включать текст для индексирования. Это реализуется использованием элемента text:toc-mark с атрибутом text:string-value для индекса. В этом случае атрибут text:id не требуется, потому что нет стартового и конечного элементов.

7.1.2 Индексные метки, определяемые пользователем

Элемент text:user-index-mark-start определяет начало определяемой пользователем индексной метки. ID, определяемый атрибутом text:id, должен быть уникальным, за исключением соответствующих конечных элементов индексных меток. Для каждого начального элемента должен быть определен конечный элемент, расположенный в том же абзаце, с начальным элементом, определенным первым.

Элемент text:user-index-mark-end обозначает окончание определяемой пользователем индексной метки. Для каждого конечного элемента должен быть начальный элемент с таким же значением text:id, расположенный в том же абзаце, с начальным элементом, определенным первым.

Определяемые пользователем индексные метки также имеют вариант, который не предполагает внесения текста для индексирования. Это реализуется использованием элемента text:user-index-mark с атрибутом text:string-value для текста индексирования. В этой ситуации атрибут text:id не является обязательным, так как нет соответствующих начального и конечного элементов.

Имя индекса, определяемого пользователем

Можно использовать больше одного определяемого пользователем индекса. В этом случае для определяемого пользователем индекса должно быть определено имя атрибутом text:index-name. Этот атрибут определяет, какому определяемому пользователем индексу соответствует индексная метка. Если имя не определено, то используется определяемый пользователем индекс, заданный по умолчанию.

7.1.3 Алфавитные индексные метки

Элемент text:alpha-index-mark-start определяет начало алфавитной индексной записи. Существует два дополнительных атрибута, которые могут содержать ключи для алфавитных индексов, позволяющие их структурировать. Есть также атрибут логического типа, определяющий их вхождение в главную конструкцию, если имеется несколько равносильных полей.

ID, определяемый атрибутом text:id, должен быть уникальным, за исключением соответствующих конечных элементов индексных меток. Для каждого начального элемента должен быть определен конечный элемент в том же самом абзаце, с начальным элементом, определенным первым.

С элементом text:toc-mark-start могут быть связаны следующие атрибуты: - атрибут text:id, определяющий соответствующие начальные и конечные элементы; - дополнительные ключи; - главная запись.

Элемент text:alpha-index-mark-end определяет окончание алфавитной индексной записи. Для каждого конечного элемента должен быть начальный элемент с таким же значением text:id, расположенный в том же абзаце, с начальным элементом, определенным первым.

Алфавитные индексные метки имеют вариант, который не предполагает внесения текста для индексирования. Это обеспечивается использованием элемента text:alpha-index-mark, с атрибутом text:string-value для текста в индексной записи. В этой ситуации атрибут text:id не является обязательным, так как нет соответствующих начального и конечного элементов.

Дополнительные ключи

Атрибуты text:key1 и text:key2 определяют дополнительные ключи для алфавитных индексов. Если используется только один ключ, то он должен быть определен в атрибуте text:key1.

Фонетические ключи

Для идеографических языков иногда характерны ситуации, когда нет очевидных или общих способов сортировки символов. Один из общих способов определения алфавитных индексов для них — сортировка на основании их фонетических описаний времени поиска. В файле формата OpenDocument это достигается за счет дополнительных атрибутов для текстового значения и двух ключей для фонетического описания. Для отображения используются значение и ключевые атрибуты, но если фонетические варианты существуют, то они должны использоваться для сортировки индексов.

Главная запись

Если есть несколько индексных меток в одной записи, одна из этих записей может быть объявлена как главная при помощи атрибута text:main-entry.

7.1.4 Библиографические индексные метки

Элемент text:bibliography-mark включает текст и информацию для библиографического индекса. Этот элемент поддерживает атрибуты для всех типов библиографических описаний, которые могут быть в них включены.

7.2. Структура индексов

Индекс состоит из двух частей: источника индекса и его тела. Каждая из частей описывается собственным элементом, которые в свою очередь разбиваются на два дочерних элемента.

Источник индекса зависит от типа индекса, для которого он будет использоваться. Источник содержит информацию, необходимую для генерирования содержания индекса. Источник индекса не имеет графического отображения.

Тело индекса одинаково для всех индексных типов. Оно содержит текст, сформированный, исходя из данных выбранного источника. Текст, указанный в теле индекса, никоим образом не отличается и не обособляется от текста, используемого в другом месте этой спецификации.

Содержимое тела индекса может быть восстановлено в любое время исходя из информации, указанной в источнике индекса и остальной части документа. Можно сказать, что источник индекса содержит всю логическую информацию об индексе, в то время как тело индекса содержит его исполнение. Средства, извлекающие информацию о структуре документа, могут просматривать только источник индекса, в то время как программа может просматривать только тело индекса.

7.2.1 Источник индекса

Элемент источника индекса содержит информацию, необходимую для генерации тела индекса. В дополнение к ряду флагов, которые определяют, какая информация включается в индекс, источник индекса содержит ряд шаблонов. Такие шаблоны определяют, как должно быть представлено поле, включенное в индекс.

Например, оглавление может быть представлено следующим образом:

Источник индекса для оглавления содержал бы флаги, которые указывали бы на то, что заголовок глав должен содержать хотя бы 2 уровня. Шаблоны индекса определили бы, что конструкция состоит из номера главы, пробела, названия главы, табуляции (заполненной символом «.») и номера страницы.

Различные шаблоны индексов описаны вместе с их элементами. Использование элементов шаблона индексов описано в разделе 7.12.

Различные элементы источников индексов описаны вместе с соответствующими элементами индексов.

7.2.2 Тело индекса

Тело индекса содержит текущее текстовое наполнение индекса. Его формат такой же, как и формат регулярного текста в этой спецификации, например, текст разделов, за исключением разделов индексного заголовка.

7.2.3 Заголовок индекса

Заголовок индекса обычно содержится в собственном разделе, поскольку это дает возможность размещения заголовка индекса в популярных макетах поперек всей страницы, тогда как сам индекс занимает две колонки.

7.3. Оглавление

Оглавление позволяет пользователю перемещаться по содержанию документа. Обычно оно размещается в начале документа, содержит заголовки глав и соответствующие им номера страниц. Пример оглавления можно посмотреть в начале этого документа.

Пункты, которые могут быть перечислены в оглавлении:

• заголовки (определенные структурой документа) до выбираемого уровня;
• индексные метки оглавления;
• форматирование абзаца с выбираемым набором стилей.

Оглавление представляется элементом text:table-of-content, который поддерживает те же атрибуты стиля (и класса), что и разделы текста (см. раздел 4.4).

7.3.1 Источник оглавления

Элемент text:table-of-content-source определяет, как генерируется оглавление. Он также определяет, как собраны записи оглавления.

Элемент text:table-of-content-source включает: - дополнительный шаблон для заголовка индекса; - дополнительные шаблоны для индексных записей, по одному для уровня; - необязательный список стилей, которые используются для индексных записей.

С элементом text:table-of-content-source могут быть связаны следующие атрибуты:

• уровень структуры;
• использование структуры;
• использование индексных меток;
• использование стилей источников индексов;
• источник индексов;
• относительное положение табулостопов.

Уровень структуры

Атрибут text:outline-level определяет, какой уровень структуры используется для формирования оглавления.

Значения этого атрибута должны быть целыми числами больше нуля. Если этот атрибут пропущен, то все уровни структуры используются по умолчанию.

Использование структуры

Атрибут text:use-outline-level определяет, используются ли заголовки для генерации индексных полей. Если значение равно true, то записи оглавления формируются из заголовков. Атрибут text:outline-level определяет уровень, до которого будут включены заголовки (см. раздел 7.1 для получения более подробной информации об индексных метках).

Использование индексных меток

Атрибут text:use-index-marks определяет, используются или нет индексные метки для формирования индексных полей. Если значение равно true, то в оглавление включаются записи, сформированные индексными метками оглавления. Атрибут text:outline-level определяет уровень, до которого будут включены индексные метки (см. раздел 7.1 для получения более подробной информации об индексных метках).

Использование стилей источников индексов

Атрибут text:use-index-source-styles определяет, сформированы или нет индексные записи из абзацев, отформатированных определенными стилями абзацев. Если значение равно true, то в оглавление добавляется запись для каждого абзаца, в форматировании которого используется один из стилей, определенных в элементе text:index-source-style. Атрибут text:outline-level определяет уровень, до которого используются стили источников индексов.

Охват индекса

Атрибут text:index-scope определяет, формируется ли содержание для всего документа или только для текущей главы.

Относительное положение табулостопов

Атрибут text:reiative-tab-stop-position определяет, относительно левого поля или левого отступа, определенного стилем абзаца, отсчитывается положение табулостопов. Это обычно используется для копирования конфигурации записей всех уровней структуры, поскольку относительная позиция табуляции не должна быть настроена так же, как в соответствующем абзаце.

7.3.2 Шаблоны записей оглавления

Элемент text:table-of-content-entry-template определяет формат индексной записи для определенного уровня структуры. Для каждого оглавления может быть не более одного элемента для любого уровня структуры (см. ниже).

Шаблоны записей оглавления поддерживают следующие текстовые элементы:

• глава и номер страницы;
• текст ссылки;
• диапазон текста;
• табулостопы;
• начало и конец гиперссылки.

С элементом text:table-of-content-entry-template могут быть связаны следующие атрибуты:

• шаблон уровня структуры;
• стиль абзаца.

Шаблон уровня структуры

Этот атрибут определяет, к какому уровню структуры применяется конфигурация записи. Уровни структуры должны быть уникальными для элементов шаблона в пределах одного источника индекса.

Стиль абзаца

Атрибут text:style-name определяет стиль абзаца, используемый в этом шаблоне.

7.4. Индексы иллюстраций

Индексы иллюстраций — это список всех рисунков и изображений в текущем документе или главе. Входные индексы могут быть получены из заголовков иллюстраций или их названий.

С элементом text:illustration-index может быть связан следующий атрибут:

• text:style-name

Этот атрибут определяет стиль раздела, используемый для индекса иллюстраций.

7.4.1 Индексы источников иллюстраций

Элемент text:illustration-index-source устанавливает, как формируется индекс иллюстраций.

С элементом text:illustration-index-source могут быть связаны следующие атрибуты: - использование подписи; - имя последовательности подписей; - формат последовательности подписей; - охват индекса — атрибут указывает, устанавливается ли индекс для всего документа или только для текущей главы; - text:relative-tab-stop-position — атрибут определяет, относительно левого края или левого отступа отсчитывается положение табулостопов.

Использование подписи

Каждый объект, находящийся в документе, имеет свое название (имя). Помимо этого рисунки также имеют подпись. Подпись рисунка или название рисунка могут быть объединены для индекса иллюстрации.

Имя последовательности подписей

Подписи ассоциируются с именем последовательности. Если атрибут text:use-caption установлен в true, то этот атрибут должен использоваться для определения последовательности, с которой связаны подписи.

Если этот атрибут опущен, то по умолчанию используется последовательность в зависимости от типа объектов, например, последовательность «Иллюстрация» используется для иллюстраций.

Формат последовательности подписей

Если индексные записи иллюстраций получены из подписей рисунков, то этот атрибут должен использоваться для определения формата записей.

7.4.2 Шаблон индексных записей иллюстраций

Шаблон индексных записей иллюстраций определяет формат индексной записи для определенного уровня структуры.

С элементом text:illustration-index-entry-template может быть связан следующий атрибут:

• стиль абзаца.

Стиль абзаца

Данный атрибут определяет стиль абзаца, используемый данным шаблоном.

7.5. Индексы таблиц

Индекс таблиц перечисляет все таблицы в текущем документе или главе. Он обрабатывается точно так же, как и индекс иллюстраций.

7.5.1 Источник индекса таблиц

Элемент text:table-index-source определяет, как формируется индекс таблиц.

Атрибуты, которые могут быть связаны с этим элементом, те же, что могут быть связаны с элементом text:illustration-index-source (см. раздел 7.4.1 для получения детальной информации об этих атрибутах).

7.5.2 Шаблон индексных записей таблицы

Шаблон индексных записей таблицы определяет формат индексной записи для определенного уровня структуры.

Атрибуты, которые связаны с этим элементом, те же, что могут быть связаны с элементом text:illustration-index-entry-template (см. раздел 7.4.2 для получения детальной информации об этих атрибутах).

7.6. Индексы объектов

Индекс объектов перечисляет все объекты в текущем документе или главе. Он формируется из записей объектов известных типов.

7.6.1 Источник индекса объектов

Элемент text:object-index-source определяет типы объектов, включенных в индекс объектов. Он также поддерживает стандартные атрибуты источников индексов.

С элементом text:object-index-source могут быть связаны следующие атрибуты: - использование атрибутов text:use-*-objects;

• охват индексов (см. раздел 7.4.1) — атрибут определяет, применяется

  ли индекс ко всему документу или только к текущей главе;

• относительная позиция табулостопов (см. раздел 7.4.1) — атрибут определяет, относительно левого края или левого отступа отсчитывается положение табулостопов.

Использование атрибутов

Атрибуты text:use-*-objects определяют, какой тип объектов включать в индекс объектов. Существуют атрибуты для каждого типа объектов:

• text:use-spreadsheet-objects

• text:use-chart-objects
• text:use-math-objects

Другие объекты, включенные или пропущенные, используют атрибут:

• text:use-other-objects

7.6.2 Шаблон индексных записей объекта

Шаблон индексных записей объекта определяет формат индексной записи для определенного уровня структуры.

Атрибуты, которые могут быть связаны с этим элементом, те же, что могут быть связаны с элементом text:illustration-index-entry-template (см. раздел 7.4.2 для получения детальной информации об этих атрибутах).

7.7. Индексы, определяемые пользователем

Индексы, определяемые пользователем, комбинируют возможности индексов, описанных ранее в этом разделе. Определяемый пользователем индекс может содержать записи из следующих источников:

• индексные метки;
• отформатированные определенными стилями абзацы;

• текстовые фреймы.

Элемент text:user-index представляет определяемый пользователем индекс.

7.7.1 Источник индекса, определяемого пользователем

Элемент text:user-index-source может содержать несколько атрибутов, которые определяют, как сформированы индексные записи. Этот элемент также поддерживает атрибут, определяющий, как сформированы уровни структуры индексных записей.

Форматирование абзаца, которое используется как индексные метки, заключено в элементах text:index-source-styles точно так же, как и в элементах text:table-of-content-source.

С элементом text:user-index-source могут быть связаны следующие атрибуты. - Использование атрибутов — text:use-* - Копирование уровня структуры.

Этот атрибут определяет, применяется ли индекс ко всему документу или

  только к текущей главе.

- <a id="p102058"></a>Имя индекса.

      Для  поддержки  нескольких   определяемых  пользователем  индексов  с
      различным  содержимым,  определяемые  пользователем   метки  индексов
      имеют атрибут text:index-name. Этот  атрибут может быть использован с

  элементом <text:user-index-source>, чтобы определить, какие индексные
  метки относятся к текущему индексу.

• Относительная позиция табулостопов (см. раздел 7.4.1).

Данный атрибут определяет, относительно левого края или левого отступа отсчитывается положение табулостопов.

Использование атрибутов

Атрибуты text:use-* определяют, какие записи включить в пользовательский индекс. Существуют следующие атрибуты:

• text:use-index-marks
• text:use-graphics
• text:use-tables

• text:use-objects

Копирование уровня структуры

Этот атрибут может принимать значение true или false.

Если установлено значение true, то поля собираются на уровне структуры элемента источника, к которым они относятся.

Если установлено значение false, все записи индекса собираются в главном уровне структуры. Например, если изображение появляется в разделе 1.2.3, то поле изображения располагается на уровне структуры 3.

7.7.2 Шаблоны индексных записей, определяемых пользователем

Шаблоны индексных записей, определяемых пользователем, поддерживают элементы записей для номера главы, номера страницы, текста записи, диапазона текста и табулостопов.

С элементом text:user-index-entry-template могут быть связаны следующие атрибуты:

• стиль абзаца.

Уровень структуры шаблона

Атрибут text:outline-level определяет, к какому уровню структуры относится данная конфигурация.

Все элементы text:outline-level, включенные в предыдущий элемент, определяют различные уровни структуры.

Стиль абзаца

Атрибут text:style-name определяет стиль абзаца, используемый в шаблоне.

7.8. Алфавитные индексы

Записи алфавитных индексов формируются только из индексных меток.

7.8.1 Источник алфавитного индекса

Элемент text:alphabetical-index-source определяет, как формируется алфавитный индекс.

С элементом text:alphabetical-index-source могут быть связаны следующие атрибуты:

- <a id="p102096"></a>без учета регистра;

- <a id="p102097"></a>имя стиля основной записи;
- <a id="p102098"></a>алфавитные разделители;
- <a id="p102099"></a>атрибуты объединенных записей;
- <a id="p102100"></a>использование ключей в качестве записей;

- <a id="p102101"></a>записи заглавными буквами;

- <a id="p102102"></a>записи с разделителями в виде запятых;
- <a id="p102103"></a>сортировка по языку, стране и алгоритму;

• охват индекса (см. раздел 7.4.1) — атрибут определяет, относится ли индекс ко всему документу или только к текущей главе;
• относительная позиция табулостопов (см. раздел 7.4.1) — атрибут определяет, относительно левого поля или левого отступа отсчитывается положение табулостопов.

Без учета регистра

Атрибут text:ignore-case определяет, игнорируется ли верхний регистр записи. Если значение равно true, то верхний регистр игнорируется, и записи, которые различаются только регистром, считаются одинаковыми. Если значение равно false, то учитывается разница между заглавными и строчными буквами.

Атрибут text:main-entry-style-name определяет стиль символов, применяемый для основных записей. Подзаписи форматируются с использованием стиля символов по умолчанию, определенного стилем абзаца записей.

Алфавитные разделители

Атрибут text:alphabetical-separators определяет, будут ли группироваться записи, начинающиеся с одной буквы, и отделяться от записей, начинающихся с другой буквы, и т.д.

Если значение true, то все записи, начинающиеся с одинаковых букв, группируются. Индекс включает заголовки для каждой секции, например, А — для всех записей, начинающихся на букву А, Б — для всех записей, начинающихся с буквы Б, и т.д.

Объединение записей

Есть несколько вариантов обработки в общей ситуации, когда существуют множественные индексные записи для одинаковых слов или фраз, такие как: - многократная запись для одного и того же слова может быть объединена в одну, с использованием атрибута text: combine-entries; - страницы, на которые ссылаются сгруппированные записи, могут быть

  отформатированы:

  - <a id="p102124"></a>как  диапазон  чисел,  разделенных  дефисом,  при  помощи  атрибута

    text:combine-entries-with-dash;

  - <a id="p102125"></a>как  начальный номер  с  меткой  pp, или соответствующей меткой для
    выбранного языка, при помощи атрибута text:combine-entries-with-pp.

Пример. Комбинирование индексных записей.

Индексная метка для слова «XML» находится на страницах 45, 46, 47 и 48. Записи могут быть отформатированы следующими способами:

Использование ключей в качестве записей

В дополнение к ключевому слову, индексные метки могут иметь до двух ключей. Если значение этого атрибута равно true, то ключи используются как дополнительные записи. Если значение этого атрибута false, то ключи используются как подзаписи.

Записи заглавными буквами

Атрибут text:capitalize-entries определяет, должны ли индексные записи отображаться заглавными буквами.

Записи с разделителями в виде запятых

Атрибут text:comma-separated определяет, как рассматривать многократные записи индекса. Вместо того чтобы перечислять каждое вхождение индекса на отдельной строке, многократные записи могут быть перечислены в одной строке, разделяясь запятой. Если значение этого атрибута равно true, то многократные записи перечисляются в одной строке. По умолчанию значение этого атрибута равно false, и каждая индексная запись указывается на отдельной строке.

Сортировка по языку, стране и алгоритму

Если индексные записи должны быть отсортированы, то данные атрибуты могут быть использованы для определения принципа сортировки. Атрибуты страны и языка определяют местную специфику сортировки. Для некоторых местных специфик применяют разнообразные алгоритмы сортировки. В этом случае атрибут алгоритма может быть использован для определения названия определенного алгоритма.

7.8.2 Файл с автоматическими метками

Алфавитный индекс поддерживает так называемый файл с автоматическими метками. Такой файл содержит список терминов, и каждое вхождение термина включается в алфавитный индекс. Файл с автоматическими алфавитными метками декларируется как часть текстовых объявлений (см. раздел 4.7). Данный элемент — это XLink, указывающий на ресурс, содержащий список терминов.

7.8.3 Шаблон алфавитных индексных записей

Алфавитные индексы поддерживают три уровня — один уровень для главной индексной записи и два дополнительных уровня для ключей, ассоциированных с индексными записями. Алфавитные индексы также используют шаблон записи для алфавитного разделения.

С элементом text:alphabetical-index-entry-template могут быть связаны следующие атрибуты:

• уровень структуры шаблона;
• стиль абзаца.

Уровень структуры шаблона

Этот атрибут определяет, применяется ли шаблон к одному из трех уровней (1, 2 или 3) или алфавитному разделителю.

Стиль абзаца

Атрибут text:style-name определяет стиль абзаца, используемый в шаблоне.

7.9. Библиография

В библиографическом индексе собираются записи из библиографических индексных меток. Элемент text:bibliography представляет библиографию.

7.9.1 Источник библиографического индекса

Элемент text:bibliography-source определяет, как формируется библиография.

7.9.2 Шаблон библиографических записей

Шаблоны библиографических записей поддерживают элементы записей для библиографических данных, диапазонов текста и табулостопов. Для каждого типа записи существует только один шаблон записей.

С элементом text:bibliography-entry-template могут быть связаны следующие атрибуты:

• тип библиографии;
• стиль абзаца.

Тип библиографии

Этот атрибут определяет, к какому типу библиографической записи применяется шаблон. Этот атрибут должен быть уникальным среди всех элементов text:bibliography-type в пределах того же самого исходного элемента.

Стиль абзаца

Атрибут text:style-name определяет стиль абзаца, используемый в шаблоне.

7.10. Стили источника индекса

Некоторые индексы могут собирать записи из глав, отформатированных с помощью определенного стиля абзаца. Элемент text:index-source-styles содержит все элементы text:index-source-style для задания определенного уровня структуры. Атрибут text:outline-levels определяет, на каком уровне структуры выстраивать индексные записи, собранные из соответствующих стилей абзацев. Может быть только один элемент text:index-source-style для каждого уровня структуры.

7.10.1 Стиль источника индекса

Все абзацы, отформатированные при помощи стиля или класса, указанного в элементе text:index-source-style, включаются в индекс.

7.11. Шаблон заголовков индекса

Элемент text:index-title-template определяет стиль и содержание заголовка индекса. Только один элемент text:index-title-template может содержаться В элементе text:table-of-content-source.

7.12. Записи индексного шаблона

Существует восемь типов индексных полей:

• информация о главе;
• текст записи;
• номер страницы;
• фиксированная строка;
• библиографическая информация;
• табулостоп;
• начало и конец гиперссылки.

7.12.1 Информация о главе

Элемент text:index-entry-chapter показывает номер главы индексной записи. Стиль символов номера главы может быть включен в элемент индексной записи как атрибут text:style-name.

Примечание. Этот элемент может отображать только номер главы. Для отображения названия главы нужно использовать элементы text:index-entry-text.

Отображение формата главы

Атрибут text:display отображает номер главы, название главы или оба эти значения.

7.12.2 Текст записи

Элемент text:index-entry-text отображает текст индексной записи, например, название главы, если поле выведено из заголовка, или фразу, содержащуюся в индексной метке, если запись получена из индексной метки. Стиль символов текста записи может быть включен в элемент индексной записи как атрибут text:style-name.

7.12.3 Номер страницы

Элемент text:index-entry-page-number отображает номер страницы, на которой располагается индексная запись. Стиль абзаца номера страницы может быть включен в элемент индексной записи как атрибут text:style-name.

7.12.4 Фиксированная строка

Элемент text:index-entry-span представляет фиксированную строку в пределах индексной записи. Стиль символа текста записи может быть включен в элемент индексной записи как атрибут text:style-name. В отличие от элемента text:span, элемент text:index-entry-span не имеет никаких дочерних элементов.

7.12.5 Библиографическая информация

Элемент text:index-entry-bibliography представляет библиографические данные в шаблонах индексных полей.

С элементом text:index-entry-bibliography могут быть связаны следующие атрибуты:

• text:style-name
• text:bibliography-data-field

Имя стиля текста

Атрибут text:style-name определяет стиль для отображения записи.

Поле идентификатора библиографических данных

Атрибут text:bibliography-data-field определяет, какая часть поля библиографических данных будет отображена.

7.12.6 Табулостоп

Элемент text:index-entry-tab-stop представляет табулостоп в индексной записи. Данный элемент также содержит информацию о позиции табулостопа.

С элементом text:index-entry-tab-stop могут быть связаны следующие атрибуты:

• style:leader-char
• style:type
• style:position

Первый символ

Атрибут style:leader-char определяет первый символ.

Тип и позиция табулостопа

Атрибут style:type определяет тип табулостопа. Элемент text:index-entry-tab-stop поддерживает только два типа табулостопа: left и right.

Если значение этого атрибута равно left, то также должен быть использован атрибут style:position. В противном случае этот атрибут не должен указываться. Атрибут style:position определяет позицию табулостопа. В зависимости от значения атрибута text:relative-tab-stop-position элемента text:index-entry-config, позиция табулятора определяется относительно левого поля или левого отступа.

7.12.7 Начало и конец гиперссылки

Элементы text:index-entry-link-start и text:index-entry-link-end помечают начало и конец гиперссылки индексной записи. Стиль символов для гиперссылки может быть включен в элемент индексной записи как атрибут text:style-name.

7.12.8 Пример конфигурации индексной записи

Рассмотрим пример кода XML для оглавления с именем «Table of Content» со следующими особенностями: - используются два верхних уровня структуры; - каждая запись состоит из номера главы, закрывающей скобки, названия главы, табулостопа и номера страницы; - для уровня структуры, номера страницы используется стиль с именем bold; - для второго уровня структуры вместо закрывающей скобки используется квадратная скобка.

8. ТАБЛИЦЫ

В данном разделе описывается структура таблиц, используемая для таблиц, вложенных в текстовые документы, и электронных таблиц.

8.1. Общая модель таблиц

Структура таблиц OpenDocument подобна структуре таблиц [HTML4] или [XSL], и, как и они, таблицы могут вкладываться.

Представление таблиц основано на сетке строк и столбцов. Строки имеют больший приоритет, чем столбцы. Таблица делится на строки, строки делятся на ячейки. Каждый столбец включает описание столбца, но это описание не содержит ячеек.

Строки таблиц могут быть пустыми, различные строки могут содержать разное количество ячеек. Это не является ошибкой, но разные приложения могут трактовать это неодинаково. Приложения электронных таблиц обычно работают с большими таблицами, которые имеют фиксированные, зависящие от приложения, номера строк и столбцов, но могут содержать неиспользуемые области. В файле сохраняется только используемая область таблицы. Когда в приложении электронных таблиц загружается таблица с пустыми или неполными строками, пустые строки обычно представляются строками по умолчанию (как пустая таблица), а неполные строки заполняются пустыми ячейками (подобно пустой таблице). Все другие приложения обычно имеют фиксированный размер таблицы. Неполные строки обычно обрабатываются как имеющие достаточное количество пустых ячеек. Так же обрабатываются пустые строки. Пустые ячейки обычно занимают пространство пустого абзаца.

Строки и столбцы фигурируют в группах строк и группах столбцов. Эти группы определяют, должны ли повторяться строки или столбцы на следующей странице.

8.1.1 Элемент таблицы

Элемент таблицы является корнем для таблиц.

Модель содержимого таблиц весьма сложна. Детали будут рассмотрены в разделе 8.2. Сейчас можно допустить, что элемент таблицы состоит из элементов строки и столбца.

Имя таблицы

Атрибут table:name определяет имя таблицы.

Стиль таблицы

Атрибут table:style-name ссылается на стиль таблицы, т.е. на элемент style:style типа таблица. Стиль таблицы описывает свойства форматирования таблицы, такие как ширина и цвет фона. Стиль таблицы может быть автоматическим или общим стилем.

Пример. Стиль таблицы:

Защищенность

Атрибут table:protected определяет, защищена ли таблица от редактирования. Если таблица защищена, атрибут table:protection-key может определять пароль с целью предотвращения возможности сброса флага защищенности пользователем для разрешения редактирования. Если таблица защищена, все ее элементы и элементы ячеек с атрибутом style:cell-protect, со значением true, являются защищенными.

Во избежание сохранения пароля напрямую в XML-файл, в атрибуте table:protection-key сохраняется только значение хэш-функции пароля.

Печать

Атрибут table:print определяет, является ли таблица печатаемой. Он принимает логическое значение. Если оно равно true, таблица печатаемая, если false, таблица непечатаемая. Значение по умолчанию равно true. Атрибут table:print переопределяется атрибутом table:display, описанным в разделе 15.8.14. Т.е. если таблица неотображаемая, то она непечатаемая.

Если таблица печатаемая, фактически печатаемый диапазон таблицы может быть определен атрибутом table:print-ranges (см. следующий раздел). Если этот атрибут не существует, будет распечатана используемая область таблицы.

Диапазон печати

Атрибут table:print-ranges определяет области печати таблицы, т.е. ячейки, которые должны быть напечатаны. Он содержит список адресов ячеек или диапазон адресов ячеек, как описано в разделе 8.3.1.

8.1.2 Строка таблицы

Элемент table:table-row представляет строку таблицы. Он содержит элементы, определяющие ячейки данной строки таблицы.

Элемент table:table-row подобен элементу [XSL] fo:table-row.

Количество повторяемых строк

Атрибут table:number-rows-repeated определяет количество строк, к которым применяется данный элемент строки. Если две или более строки являются соседними, имеют одинаковое содержимое и свойства и не содержат вертикально объединенных ячеек, то они могут быть описаны одним элементом table:table-row, который имеет атрибут table:number-rows-repeated со значением, большим 1.

Стиль строки

Стиль строки таблицы хранит свойства форматирования строки таблицы, такие как высота и цвет фона. Стиль строки определяется элементом style:style со значением семейства атрибутов table-row. Стиль строки таблицы может быть автоматическим либо общим стилем. Он связывается атрибутом строки таблицы table:style-name.

Стиль ячейки по умолчанию

Атрибут table:default-cell-style-name определяет стиль ячейки по умолчанию. Ячейки, содержащиеся в строке, не имеющей индивидуального стиля ячейки, используют этот стиль по умолчанию.

Видимость

Атрибут table:visibility определяет, является ли строка видимой, отфильтрованной или свернутой. Отфильтрованные и свернутые строки невидимы. Отфильтрованные строки невидимы, так как фильтр применяется к таблице, которая не выбирает свою строку. Свернутые строки становятся невидимыми при помощи пользовательского интерфейса.

Пример. Таблица с тремя строками и тремя столбцами.

В данном примере приведен код OpenDocument для таблицы с тремя строками и тремя столбцами. Цвет фона первых двух строк таблицы — синий.

8.1.3 Ячейки таблицы

Элементы table:table-cell и table:covered-table-cell определяют содержимое ячеек таблицы. Они содержатся в элементах строк таблицы. Ячейки таблицы могут содержать абзацы и другое текстовое содержимое, включая подтаблицы. Ячейки таблицы могут быть пустыми.

Элемент table:table-cell очень похож на элемент ячейки таблицы [XSL] и [HTML4], Существующие HTML и XSL правила, относящиеся к ячейкам, охватывающим несколько столбцов или строк, также применимы и к спецификации OpenDocument. Это означает, что элементы table:table-cell отсутствуют в строках/столбцах сетки для позиций, которые перекрыты объединенными ячейками, охватывающими несколько столбцов или строк. С целью определения ячеек для таких позиций используется элемент table:covered-table-cell. Он должен появляться в каждой позиции строки/столбца сетки, перекрытой ячейкой, охватывающей несколько строк или столбцов. Эта позиция в сетке вычисляется в предположении, что диапазон объединения столбца и строки равен 1 для всех ячеек, независимо от того, определены они элементом table:table-cell или table:covered-table-cell. Элемент table:covered-table-cell обычно используется в приложениях электронных таблиц, для которых характерно наличие содержимого в объединенной ячейке.

Количество повторяемых ячеек

Атрибут table:number-columns-repeated определяет количество последовательных столбцов, в которых повторяются ячейки. Он может быть использован для описания двух и более соседних ячеек в одном элементе ячейки, если выполняются следующие условия:

• ячейки имеют одинаковые содержимое и свойства;
• ячейки не объединены по горизонтали или по вертикали.

В этом случае для задания количества последовательных столбцов, в которых будут повторяться ячейки, должен использоваться атрибут table:number-columns-repeated. Этот атрибут определяется с одним из двух элементов: table:table-cell или table:covered-table-cell.

Количество объединенных строк и столбцов

Эти атрибуты определяют количество объединенных ячейкой строк и столбцов. Атрибуты могут использоваться только с элементом table:table-cell.

В том случае, когда ячейка перекрывает другие ячейки, так как значение объединения столбцов или строк более одного, для представления объединенной ячейки должен использоваться элемент table:covered-table-cell.

Стиль ячейки

Стиль ячейки таблицы хранит свойства форматирования ячейки, такие как:

• цвет фона;
• формат числа;
• вертикальное выравнивание;
• обрамление.

Стиль ячейки таблицы может быть автоматическим или общим стилем. Стиль определяется атрибутом table:style-name. Если ячейка не имеет назначенного стиля ячейки, приложение проверяет, определен ли в текущей строке стиль ячейки по умолчанию. Если текущая строка не имеет стиля ячейки по умолчанию, приложение проверяет, определен ли стиль ячейки по умолчанию в текущем столбце.

Проверка содержимого ячейки

Атрибут table:content-validation-name указывается, если в ячейке осуществляется проверка правильности содержимого. Значение этого атрибута является именем элемента table:cell-content-validation. Если атрибут не представлен, ячейка может иметь произвольное содержимое.

Более детальные сведения о проверке содержимого ячейки и об элементе table:cell-content-validation приведены в разделе 8.5.3.

Формулы

Формулы позволяют производить вычисления в ячейках таблицы. Каждая формула начинается с префикса пространства имен, задающего синтаксис и семантику, используемые в формуле. Обычно формула начинается со знака равенства (=) и может включать следующие компоненты: - числа; - текст; - именованные диапазоны; - знаки арифметических операций; - логические операторы; - вызовы функций; - адреса ячеек, содержащих числа, — адрес может быть относительным или абсолютным (см. раздел 8.3.1), адреса в формулах начинаются с символа «[» и заканчиваются символом «]» (сведения об адресации ячеек или диапазонов ячеек приведены в разделе 8.3.1).

Рассмотрим пример простой формулы:

= sum ([.A1:.A5])

Формула вычисляет сумму значений во всех ячейках в диапазоне «.A1:.A5». Используется функция «sum». Параметры заключены в круглые скобки «(» в начале и «)» в конце. Если функция содержит более одного параметра, параметры разделяются символом «;».

Формулу, приведенную выше, можно представить в виде:

= sum([.A1];[.A2];[.A3];[.A4];[.A5])

Результат будет тем же. Компоненты, используемые в формуле, зависят от используемого приложения.

Атрибут table:formula содержит формулу ячейки таблицы.

В дополнение, вычисленное значение формулы доступно обычным способом. Текущее значение ячейки представляется одним из следующих атрибутов:

• office:value
• office:date-value
• office:time-value
• office:boolean-value
• office:string-value

Матрицы

В том случае, когда приложение выполняет вычисления электронной таблицы, связный диапазон ячеек, содержащих значения, называется матрицей. Если диапазон ячеек содержит m строк и n столбцов, матрица называется матрицей размера m x n. Минимально возможные матрицы состоят из двух соседних ячеек и имеют размеры 1 x 2 или 2 x 1. Для использования матрицы в формуле в нее включается диапазон адресов ячеек матрицы. В матричной формуле допустимо использование только специальных операций с матрицами.

Количество строк и столбцов, объединенных в матрицу, представляется атрибутами table:number-matrix-rows-spanned и table:number-matrix-columns-spanned, привязанными к элементам ячеек.

Тип значения

Атрибут table:value-type определяет тип значения, размещенного в ячейке. Он может принимать одно из следующих значений: - float, percentage или currency — вещественные, процентный или денежный числовые типы; - date — дата; - time — время; - boolean — логический; - string — текстовый.

Текущее числовое значение ячейки

Атрибут office:value определяет текущее числовое значение ячейки. Этот атрибут вычисляется только для ячеек, содержащих следующие типы данных:

• float — вещественный;
• percentage — процентный;
• currency — денежный.

Текущая денежная единица ячейки

Атрибут tableoffice:currency определяет текущую денежную единицу ячейки. Значение этого атрибута — обычно информация о валюте, например, DEM или EUR. Данный атрибут определяется для ячеек, имеющих тип данных currency.

Текущее значение даты ячейки

Атрибут office:date-value определяет текущее значение даты ячейки. Данный атрибут определяется для ячеек, имеющих тип данных date.

Некоторые приложения поддерживают значения даты и времени в дополнение к датам.

Текущее значение времени ячейки

Атрибут office:time-value определяет текущее значение времени ячейки. Данный атрибут определяется для ячеек, имеющих тип данных time.

Текущее логическое значение ячейки

Атрибут office:boolean-value определяет текущее логическое значение ячейки. Данный атрибут определяется для ячеек, имеющих тип данных boolean.

Текущее текстовое значение ячейки

Атрибут office:string-value определяет текущее текстовое значение в ячейке. Данный атрибут определяется для ячеек, имеющих тип данных string.

Защита ячеек таблицы

Атрибут table:protected обеспечивает защиту ячеек таблицы. Пользователи не могут редактировать содержимое ячейки, помеченной как защищенная.

Данный атрибут не связан с атрибутом table:protected табличного элемента (см. раздел 8.1.1) и атрибутом стиля ячейки таблицы table:cell-protect (см. раздел 15.11.14).

8.2. Расширенная модель таблиц

8.2.1 Описание столбца

Каждый столбец таблицы имеет элемент описания столбца таблицы table:table-column. Он подобен [XSL] элементу fo:table-column и используется, главным образом, для указания стиля столбца, который определяет, например, ширину столбца.

Количество повторяемых столбцов

Атрибут table:number-columns-repeated определяет количество столбцов, в которых повторяется описание столбца. Если два или более соседних столбца имеют одинаковые свойства, этот атрибут позволяет описать их одним элементом table:table-column.

Стиль столбца

Стиль столбца таблицы хранит информацию о свойствах форматирования столбца, таких как ширина и цвет фона. Он определяется элементом style:style со значением семейства атрибутов table-column и может быть автоматическим или общим стилем. Стиль столбца определяется с использованием атрибута table:style-name.

Видимость

Атрибут table:visibility определяет, является ли столбец видимым, отфильтрованным или свернутым. Более детальные сведения приведены в разделе 8.1.2.

Стиль ячейки по умолчанию

Атрибут table:default-cell-style-name определяет стиль ячейки по умолчанию. Ячейки, стиль которых не определен, используют данный стиль в том случае, если не задан стиль по умолчанию ячеек строки.

Пример. Таблица с тремя столбцами.

В примере приведен код OpenDocument для таблицы с тремя столбцами:

8.2.2 Заголовки столбцов

Если таблица не может быть размещена на одной странице, то несколько соседних столбцов могут автоматически повторяться на каждой странице. Для этого описания столбцов должны быть включены в элемент table:table-header-columns. Описания столбцов, которые не должны повторяться на каждой странице, могут быть включены в элемент table:table-columns, но это не обязательно. Таблица не должна содержать более одного элемента table:table-header-columns, и за элементом table:table-columns не должен следовать другой элемент table:table-columns. Единственным исключением являются таблицы, содержащие сгруппированные столбцы (см. раздел 8.2.3). Такие таблицы содержат более одного элемента table:table-header-columns, при этом они должны входить в различные группы столбцов, состоящих из соседних элементов.

Приложения, которые не поддерживают заголовки столбцов, должны обрабатывать их описания так же, как и описания столбцов без заголовков.

Элементы table:table-header-columns и table:table-columns очень похожи на элементы [HTML4] и  для строк.

8.2.3 Группы столбцов

Соседние столбцы таблицы могут быть сгруппированы с использованием элемента table:table-column-group. Каждая группа может содержать новую группу, столбцы и заголовки столбцов. Группа столбцов может быть видимой и скрытой. Группы столбцов могут, например, использоваться приложениями электронных таблиц для группировки столбцов, данные которых суммируются. Таким образом, отдельные столбцы, вносящие вклад в сумму, можно сделать невидимыми, в то время как сумма остается видимой.

Если набор заголовков столбцов и группа столбцов перекрываются, то заголовок группы столбцов разрывает набор заголовков столбцов. Т.е. table:table-column-group может содержать элементы table:table-header-columns, но не наоборот.

Видимость

Атрибут table:display определяет, является ли группа видимой или невидимой.

8.2.4 Заголовки строк

Если таблица не может быть размещена на одной странице, то несколько соседних строк могут автоматически повторяться на каждой странице. Для этого описания строк должны быть включены в элемент table:table-header-rows. Описания столбцов, которые не должны повторяться на каждой странице, могут быть включены в элемент table:table-rows, но не обязательно. Таблица может содержать более одного элемента table:table-header-rows, и за table:table-rows не должен следовать другой элемент table:table-rows. Единственным исключением являются таблицы, содержащие сгруппированные строки (см. раздел 8.2.5). Такие таблицы содержат более одного элемента table:table-header-rows, при этом обеспечивается их вхождение в различные группы строк, состоящих из соседних элементов.

Приложения, которые не поддерживают заголовки строк, должны обрабатывать их описания так же, как и описания строк без заголовков.

Элементы table:table-header-rows и table:table-rows очень похожи на элементы [HTML4] и .

8.2.5 Группы строк

Соседние строки таблицы могут быть сгруппированы с использованием элемента table:table-row-group. Каждая группа может содержать новую группу, строки и заголовки строк. Группа строк может быть видимой и скрытой. Группы строк могут, например, использоваться приложениями электронных таблиц для группировки строк, данные которых суммируются. Таким образом, отдельные строки, вносящие вклад в сумму, можно сделать невидимыми, в то время как сумма остается видимой.

Если набор заголовков строк и группа строк перекрываются, то заголовок группы строк разрывает набор заголовков строк. Т.е. table:table-row-group может содержать элементы table:table-header-rows, но не наоборот.

Видимость

Атрибут table:display определяет, является ли группа видимой или невидимой.

8.2.6 Подтаблицы

Если ячейка таблицы содержит одну таблицу и не содержит абзацев и других элементов, то такая таблица определяется как подтаблица. Она занимает всю ячейку, и в этой ячейке не может быть другого содержимого.

Обрамление подтаблицы объединяется с обрамлением ячейки, в которой она расположена. Подтаблица не содержит никаких свойств форматирования. Подтаблица — это, по существу, контейнер для некоторого количества дополнительных строк, которые неразрывно связаны с родительской таблицей.

Вложенная таблица преобразуется в подтаблицу атрибутом table:is-subtable, который включается в элемент таблицы. Вложенная таблица, не определенная как подтаблица, рассматривается как таблица в таблице, т.е. она имеет собственное обрамление и подчиняется правилам выравнивания родительской ячейки.

Пример. Представление подтаблицы.

В схеме OpenDocument такая таблица может быть представлена двумя способами, представленными в Примере 1 и Примере 2.

Пример 1

При использовании ячеек, объединяющих несколько строк, таблица определяется следующим образом:

Пример 2

При использовании подтаблиц таблица определяется следующим образом:

8.3. Расширенные таблицы

8.3.1 Ссылки на ячейки таблицы

Для ссылки на ячейки таблицы используются так называемые адреса ячеек. Адрес ячейки имеет следующую структуру:

1. <a id="p102460"></a>Имя таблицы.

2. <a id="p102461"></a>Точка (.).

3. <a id="p102462"></a>Буквенное  значение,  идентифицирующее  столбец. Буква A  обозначает
   столбец  1,  B - столбец 2, и так далее. AA представляет столбец 27,
   AB - столбец 28 и так далее.

4. <a id="p102463"></a>Числовое  значение,  идентифицирующее  строку.  Число 1 представляет
   первую строку, число 2 - вторую и так далее.

Это означает, что A1 представляет ячейку на пересечении столбца 1 и строки 1. B1 представляет ячейку на пересечении столбца 2 и строки 1. A2 представляет ячейку на пересечении столбца 1 и строки 2.

Например, в таблице с именем SampleTable ссылка на ячейку на пересечении столбца 34 и строки 16 представляется адресом SampleTable.AH16. В некоторых случаях имя таблицы указывать не обязательно. Однако точка должна быть представлена. Если имя таблицы не требуется, то адрес из предыдущего примера будет иметь вид .AH16.

Адрес ячейки подтаблицы имеет следующую структуру:

1. Адрес ячейки, содержащей подтаблицу.

2. Точка (.).

3. Адрес ячейки в подтаблице.

Например, ссылка на ячейку на пересечении столбца 1 и строки 1 подтаблицы с именем Subtable, расположенной в ячейке на пересечении столбца 34 и строки 16 таблицы SampleTable, будет представлена адресом SampleTable.AH16.A1. Если имя таблицы содержит пробелы, оно должно быть заключено в апострофы (').

Абсолютная и относительная адресация

Ссылки на ячейки могут быть заданы абсолютными либо относительными адресами. При выполнении операции с ячейкой таблицы, например, копировании формулы, абсолютная ссылка на ячейку не меняется. В отличие от этого, относительные ссылки адаптируются к адресу ячейки, в которую осуществляется копирование. В предыдущем примере использована относительная адресация.

Адрес диапазона ячеек

Диапазон ячеек — это набор соседних ячеек, образующих прямоугольник. Прямоугольник простирается от верхней левой ячейки до нижней правой.

Адрес диапазона ячеек ссылается на диапазон ячеек. Он имеет следующую структуру:

1. Адрес верхней левой ячейки диапазона.

2. Двоеточие (:).

3. Адрес нижней правой ячейки диапазона.

Например, адрес .A1:.B2 является ссылкой на диапазон ячеек от находящейся на пересечении столбца 1 и строки 1 до находящейся на пересечении столбца 2 и строки 2. Минимальный диапазон определяется как одна ячейка. В этом случае адрес диапазона совпадает с адресом ячейки.

Список адресов диапазонов ячеек

Список адресов диапазонов ячеек — это список диапазонов ячеек и адресов ячеек. Элементы списка отделяются пробелом. Если имя таблицы содержит пробелы, оно должно быть заключено в апострофы (').

8.3.2 Связанные таблицы

Если таблица связана с первичной таблицей, информация о таблице-источнике содержится в элементе table:table-source. С элементом table:table-source могут быть связаны следующие атрибуты:

• режим;
• имя таблицы;
• URL;
• имя фильтра;
• параметры фильтра;

Режим

Атрибут table:mode определяет, какие данные должны быть скопированы из исходной таблицы в целевую таблицу. Если атрибут имеет значение, равное copy-all, то будут скопированы формулы и стили. Если атрибут имеет значение copy-results-only (копировать только результаты), то будут скопированы только результаты вычислений и невычисляемое содержимое ячеек.

Имя таблицы

Атрибут table:table-name определяет имя таблицы первичного документа. Если имя таблицы не определено, то будет использована первая таблица документа.

URL

Первичная таблица определяется посредством XLink, где атрибут xlink:href определяет URL документа, содержащего первичную таблицу.

Имя фильтра

Атрибут table:filter-name определяет тип файла документа, содержащего первичную таблицу. Значение этого атрибута зависит от конкретного приложения.

Параметры фильтра

Атрибут table:filter-options определяет необязательные настройки типа файла. Значение этого атрибута зависит от конкретного приложения.

Интервал обновления

Атрибут table:refresh-delay определяет интервал времени между обновлениями связанной таблицы.

8.3.3 Таблицы сценариев

Сценарий — это область таблицы, данные в которой временно связаны с другой таблицей, называемой таблицей сценария. Если несколько сценариев определены для одной и той же области, пользователь может переключаться от одного к другому. Будет ли таблица сценария видимой, определяется стилем таблицы. Только одна таблица сценария может быть активной в отдельной таблице.

Таблица, содержащая table:scenario, представляет собой таблицу сценария. Имя таблицы и имя сценария совпадают. Сценарий отображается в обычной таблице, предшествующей таблице сценария. Если таблица сценария для таблицы существует, сценарий отображается в этой таблице автоматически. Это означает, что существование таблицы сценария предполагает существование сценария.

С данным элементом могут быть связаны следующие атрибуты:

• диапазоны сценария;
• активность;
• отображение обрамления;
• цвет обрамления;
• копирование обратно;
• копирование стилей;
• копирование формул;
• комментарий;
• защищенность.

Диапазоны сценария

Атрибут table:scenario-ranges определяет диапазон ячеек таблицы, который отображается как сценарий. Значением этого атрибута является список адресов диапазонов ячеек.

Активность

Атрибут table:is-active определяет, является ли активным сценарий, принадлежащий таблице сценария.

Отображение обрамления

Атрибут table:display-border определяет, отображается ли обрамление вокруг сценария, принадлежащего таблице сценария.

Цвет обрамления

Атрибут table:border-color определяет цвет обрамления, отображаемого вокруг сценария, принадлежащего таблице сценария.

Копирование обратно

Атрибут table:copy-back определяет, копируются ли данные обратно в таблицу сценария, если активизируется другой сценарий.

Копирование стилей

Атрибут table:copy-styles определяет, копируются ли стили из таблицы сценария в целевую таблицу вместе с данными.

Копирование формул

Атрибут table:copy-formulas определяет, копируются ли формулы из таблицы сценария в целевую таблицу. Значение атрибута может принимать значение true или false. Если значение равно true, то формулы копируются. Если значение равно false, то будут копироваться только результаты формул.

Комментарий

Атрибут table:comment содержит комментарий о сценарии.

Защищенность

Атрибут table:protected определяет, защищены ли от редактирования данные, отображаемые в сценарии. Значение атрибута анализируется только в том случае, если таблица, в которой отображается сценарий также является защищенной (см. раздел 8.1.1).

8.3.4 Фигуры

Элемент table:shapes содержит все графические фигуры с привязкой к таблице, потомком которой является элемент. Этот элемент является контейнером и не имеет сопутствующих атрибутов.

8.4. Расширенные ячейки таблицы

8.4.1 Связанные ячейки таблицы

Диапазон ячеек может быть связан с диапазоном базы данных или именованным диапазоном другого файла. В этом случае информация о первичном диапазоне базы данных или именованном диапазоне содержится в элементе table:cell-range-source, расположенном в первой ячейке диапазона. С данным элементом могут быть связаны следующие атрибуты:

• имя;
• последний размер;
• URL;
• имя фильтра;
• параметры фильтра;
• интервал обновления.

Имя

Атрибут table:name определяет имя исходного диапазона базы данных или именованного диапазона.

Последний размер

Атрибуты table:last-column-spanned и table:last-row-spanned определяют последний известный размер диапазона. Если размер диапазона изменяется с момента последней операции, значение данного атрибута ошибочно.

URL, имя фильтра, параметры фильтра и интервал обновления

Атрибуты xlink:href, xlink:type, xlink:actuate, table:filter-name и table:filter-options подобны атрибутам связанных таблиц. Детальные сведения приведены в разделе 8.3.2.

8.4.2 Аннотация ячейки

Формат OpenDocument позволяет размещать аннотацию внутри ячеек таблицы. Для получения детальной информации об аннотациях см. раздел 12.1.

8.4.3 Слежение

Элемент table:detective имеет двойное назначение. С одной стороны, он содержит информацию о связях, которые существуют между ячейками таблицы как следствие применения формул и которые должны выделяться в пользовательском интерфейсе цветом. С другой стороны, элемент содержит информацию о ячейках, которые на данный момент выделены цветом в пользовательском интерфейсе либо вследствие упомянутых выше связей, либо вследствие ошибочных условий.

В элементе table:detective могут содержаться следующие элементы:

• операция слежения;
• диапазон выделения цветом.

8.4.4 Операция слежения

Элемент table:operation определяет, какие конкретные связи, существующие между ячейкой, потомком которой является элемент, и другими ячейками, должны быть сделаны видимыми или невидимыми в пользовательском интерфейсе. Одна и та же операция слежения может быть повторена несколько раз по отношению к одной и той же ячейке. В этом случае вторая операция применяется к результирующей ячейке первой операции и так далее. Это означает, что операция не обязательно применяется только к ячейке, в которой она определена, но и к другим ячейкам, благодаря чему может взаимодействовать с операциями, определенными в других ячейках. Главным образом это применяется в операциях, которые делают связи невидимыми. Для обеспечения детерминированного поведения операции имеют индексы и применяются в порядке, определенном ими. С элементом table:operation могут быть связаны следующие атрибуты:

• имя;
• индекс.

Имя

Атрибут table:name определяет имя операции слежения. Возможны следующие имена: trace-dependents, remove-dependents, trace-precedents, remove-precedents и trace-errors. Trace-dependents и remove-dependents отображают или скрывают ячейки, которые используют значение текущей ячейки в их формулах. Trace-precedents и remove-precedents отображают или скрывают ячейки, чьи значения используются в формуле текущей ячейки. Trace-errors отображает ячейки, которые привели к ошибке при вычислении результата формулы текущей ячейки.

Индекс

Атрибут table:index определяет порядок, в котором применяются операции слежения.

8.4.5 Диапазон выделения цветом

Элемент table:highlighted-range определяет диапазон ячеек, который в пользовательском интерфейсе выделяется цветом вследствие ошибки или некорректных данных.

Информация, содержащаяся в этом элементе, может быть устаревшей, но отражает состояние, вычисленное на данный момент операциями слежения или условиями ошибки.

С элементом table:highlighted-range могут быть связаны следующие атрибуты:

• адрес диапазона ячеек;
• направление;
• наличие ошибки;
• метка некорректности.

Адрес диапазона ячеек

Атрибут table:cell-range-address содержит адрес диапазона, который в данный момент выделяется цветом.

Направление

Атрибут table:direction определяет направление связи между данной ячейкой и диапазоном, выделенным цветом. Например, направление может быть представлено стрелкой.

Наличие ошибки

Атрибут table:contains-error определяет, содержит ли диапазон ячеек ошибку.

Метка некорректности

Атрибут table:marked-invalid определяет, помечена ли текущая ячейка как некорректная. Этот атрибут не может быть использован с другими атрибутами.

8.5. Содержимое документов электронных таблиц

8.5.1 Защита документа

Структура документа электронной таблицы может быть защищена с использованием атрибута table:structure-protected, чтобы пользователи не имели возможности вставлять, удалять или переименовывать таблицы в документе. Необязательный атрибут table:protection-key может быть использован для задания пароля, предотвращающего сброс пользователями флага защиты для разрешения редактирования. Во избежание сохранения пароля напрямую в XML-файле в атрибуте table:protection-key сохраняется только значение хэш-функции пароля.

8.5.2 Настройки вычислений

Документы электронных таблиц содержат настройки, которые влияют на вычисления формул, например, настройки нулевой даты и итерации. Эти настройки могут быть сохранены в документе с помощью элемента table:calculation-settings.

С элементом table:calculation-settings могут быть связаны следующие атрибуты:

• чувствительность к регистру;
• точность как на экране;
• распространенность условий поиска на всю ячейку;
• автоматический поиск надписей;
• использование регулярных выражений;
• нулевой год;
• нулевая дата;
• итерации.

Чувствительность к регистру

Атрибут table:case-sensitive определяет, учитывается ли различие между верхним и нижним регистрами при применении к содержимому ячейки операторов сравнения.

Точность как на экране

Атрибут table:precision-as-shown определяет, выполняются ли вычисления с округленными числами электронной таблицы, отображаемыми на экране, или с использованием всех цифр числа. Если значение атрибута равно true, вычисления выполняются с округленными числами электронной таблицы, отображаемыми на экране. Если значение атрибута равно false, вычисления выполняются с использованием всех цифр числа, но результаты также отображаются в округленном виде.

Распространенность условий поиска на всю ячейку

Атрибут table:search-criteria-must-apply-to-whole-cell определяет, должно ли условие поиска, соответствующее используемому регулярному выражению, применяться ко всему содержимому ячейки.

Автоматический поиск надписей

Атрибут table:automatic-find-labels определяет, будет ли осуществляться автоматический поиск надписей строк и столбцов.

Использование регулярных выражений

Атрибут table:use-regular-expressions определяет, разрешено ли использование регулярных выражений при выполнении операций сравнения строк и поиске.

Нулевой год

Атрибут table:null-year определяет начальный год для значений годов, содержащих только две цифры. Две цифры значения года интерпретируются как год, равный или следующий за начальным годом.

Нулевая дата

Элемент table:null-date определяет нулевую дату. Нулевая дата — это дата, которая при преобразовании ее в числовой формат дает значение 0. Нулевая дата определяется в атрибуте table:date-value элемента. Обычно используются значения 12/30/1899, 01/01/1900 и 01/01/1904.

Итерации

Элемент table:iteration разрешает вычисление формул с итеративными (или циклическими) ссылками после заданного количества итераций. Вычисление формул с итеративными ссылками повторяется до тех пор, пока задача не будет решена. Если итеративные вычисления не разрешены, появление в таблице формулы с итеративной ссылкой приведет к появлению сообщения об ошибке.

Итеративные вычисления разрешаются и запрещаются атрибутом table:status. Если итеративные вычисления разрешены, в атрибуте table:steps определяется максимально допустимое количество итераций. Атрибут table:maximum-difference определяет максимально допустимую разность между двумя результатами вычислений. Итерация останавливается, если результат меньше значения данного атрибута.

8.5.3 Проверки содержимого ячеек таблицы

Данный элемент определяет правила проверки правильности содержимого ячеек таблицы. Элемент table:content-validation определяет такое правило. Все правила проверки, имеющиеся в документе, содержатся в элементе table:content-validations. Сами правила проверки именуются, и эти имена используются для ссылок на них из ячейки таблицы.

С элементом table:content-validation могут быть связаны следующие атрибуты:

• имя;
• условие;
• адрес базовой ячейки;
• допустимость пустых ячеек;
• отображение списка.

Имя

Атрибут table:name определяет имя проверки содержимого. Он используется в ячейке, к которой должно быть применено правило, для ссылки на правило проверки. Имя создается приложением автоматически.

Условие

Атрибут table:condition определяет условие, которое должно принимать значение true для всех ячеек, к которым применено правило проверки. Значение атрибута должно быть префиксом пространства имен, за которым следует логическое выражение.

Типовой синтаксис выражения может быть подобен синтаксису XPath. Ниже приведены существующие условия. - Condition ::= ExtendedTrueCondition | TrueFunction 'and' TrueCondition - TrueFunction ::= cell-content-is-whole-number() | cell-content-is-decimal-number() | cell-content-is-date() | cell-content-is-time() | cell-content-is-text() - ExtendedTrueCondition ::= ExtendedGetFunction | cell-content-text-length() Operator Value - TrueCondition ::= GetFunction | cell-content() Operator Value - GetFunction ::= cell-content-is-between (Value, Value) | cell-content-is-not-between(Value, Value) - ExtendedGetFunction ::= cell-content-text-length-is-between (Value, Value) | cell-content-text-length-is-not-between (Value, Value) | cell-content-is-in-list (StringList) - Operator ::= '<' | '>' | '<=' | '>=' | '=' | '!=' - Value ::= NumberValue | String | Formula - StringList ::= StringList ';' String | String - Formula — это формула без знака равно (=) в начале. Более подробные сведения приведены в разделе 8.1.3. - String — включает один или более символов, заключенных в кавычки. - NumberValue — целое или вещественное число. Оно не должно содержать десятичный разделитель, если число больше или равно 1000.

Адрес базовой ячейки

Атрибут table:base-cell-address определяет адрес базовой ячейки для относительных адресов в формулах, появляющихся в условиях. Этот атрибут обязателен только в том случае, если условие содержит формулу. Значением данного атрибута должен быть абсолютный адрес ячейки, включающий имя таблицы.

Допустимость пустых ячеек

Атрибут table:allow-empty-cell определяет, может ли ячейка быть пустой.

Отображение списка

Атрибут table:display-list определяет, отображается ли список значений, который появляется в условии, в пользовательском интерфейсе в процессе редактирования значения ячейки. Этот атрибут может принимать значения none, unsorted или sort-ascending. - none — список значений не отображается; - unsorted — список значений отображается в порядке их появления в условии; - sort-ascending — список значений отображается в порядке возрастания.

Справочные сообщения

Элемент table:help-message определяет сообщения, отображаемые при выборе пользователем ячейки. Элемент имеет необязательный атрибут table:title, который определяет заголовок справочного сообщения. Также он имеет необязательный атрибут table:display, который может быть использован для запрета отображения справочного сообщения.

Сообщения об ошибке

Элемент table:error-message определяет сообщение, отображаемое при попытке пользователя ввести недопустимые данные в ячейку, т.е. когда условие правила проверки принимает значение false. Элемент имеет необязательный атрибут table:title, который определяет заголовок сообщения. Также он имеет атрибут table:display, который может быть использован для запрета отображения сообщения. Атрибут table:message-type, который может принимать значения stop, warning, или information, определяет, должно ли сообщение отображаться как ошибка (stop), предупреждение (warning) или только информация (information). В случае если отображается сообщение об ошибке, операция, которая вызывала проверку правильности, останавливается (например, перемещение курсора из ячейки).

Макрос ошибки

Если ячейка содержит недопустимое содержимое, вместо вывода сообщения может вызываться макрос. В данном случае макрос определяется элементом office:event-listeners, как описано в разделе 12.4. Имя, определяющее событие, которое вызывается в случае недопустимого ввода пользователя, должно быть единственным.

В дополнение к элементу office:event-listeners элемент table:error-macro определяет, должен ли выполняться макрос.

8.5.4 Диапазоны надписей

Диапазоны надписей могут использоваться для назначения имен строк и столбцов или частей строк и столбцов, где имена ячеек рассматриваются как их же содержимое. Точнее, элемент диапазона надписей table:label-range определяет диапазон ячеек надписей, содержащих надписи, и диапазон ячеек данных, определяющий строки и столбцы, на содержимое которых ссылаются надписи.

Существует два типа диапазонов надписей:

• диапазоны надписей для столбцов;
• диапазоны надписей для строк.

Диапазон ячеек данных должен иметь те же высоту и позицию по вертикали, что и диапазон ячеек надписей, если это надписи строк, или те же ширину и позицию по горизонтали, если это надписи столбцов. Сведения об определении диапазона ячеек приведены в разделе 8.3.1.

Надписи могут быть использованы в формуле так же, как и другие имена. Все диапазоны надписей, существующие в документе, содержатся в одном элементе table:label-ranges.

Адрес диапазона ячеек надписей

Атрибут table:label-cell-range-address определяет адрес диапазона ячеек надписей.

Адрес диапазона ячеек данных

Атрибут table:data-cell-range-address определяет адрес диапазона ячеек данных.

Ориентация

Атрибут table:orientation определяет ориентацию диапазона надписей. Этот атрибут может иметь значения column (столбец) или row (строка).

8.5.5 Именованные выражения

Элемент именованных выражений table:named-expressions содержит совокупность присваиваний имен выражениям, чтобы имена могли быть использованы для ссылок на выражения.

Имена могут иметь следующие выражения:

• диапазон ячеек;
• другие выражения, например, части формулы.

Именованный диапазон

Элемент «именованный диапазон» table:named-range определяет диапазон ячеек, которому назначено имя. Сведения об определении диапазона ячеек приведены в разделе 8.3.1.

Атрибут table:name определяет имя диапазона, а атрибут table:cell-range-address — его адрес. Адрес может быть абсолютным или относительным. Если адрес диапазона относительный, дополнительно должен существовать атрибут table:base-cell-address. Он определяет адрес базовой ячейки диапазона ячеек. Этот адрес должен быть абсолютным. Поэтому в этом адресе должно быть обязательно указано имя таблицы, но символы доллара, которые служат признаком абсолютного адреса, могут быть опущены.

Дополнительный атрибут table:range-usable-as определяет, может ли имя диапазона использоваться в определении диапазона печати, фильтра, повторяющейся строки или повторяющегося столбца. Этот атрибут может принимать значения: - none (нет); - список, разделенный пробелами, содержащий значения print-range (диапазон печати), filter (фильтр), repeat-row (повторяющаяся строка) или repeat-column (повторяющийся столбец).

Именованное выражение

Элемент именованного выражения table:named-expression содержит выражения с именами, например части, формулы.

Атрибут table:name определяет имя выражения, а атрибут table:expression — само выражение. Выражение не должно содержать знак равенства (=) в качестве первого символа. Если выражение содержит именованный диапазон или другое именованное выражение, то именованный диапазон или другое именованное выражение должны быть определены первыми, до включения в выражение. Если выражение содержит относительный адрес диапазона ячеек, дополнительно должен существовать атрибут table:base-cell-address. Он определяет адрес базовой ячейки для диапазона ячеек. Этот адрес должен быть абсолютным. Поэтому в этом адресе должно быть обязательно указано имя таблицы, но символы доллара, которые служат признаком абсолютного адреса, могут быть опущены.

Пример. Элемент именованных выражений с именованным диапазоном и именованным выражением:

8.6. Диапазоны баз данных

Диапазон баз данных — это именованная область в таблице, в которой могут выполняться операции базы данных, но также выполняются и операции другого вида, такие как фильтрация и сортировка. Элемент table:database-ranges содержит набор всех диапазонов баз данных, определенных в документе.

8.6.1 Диапазон базы данных

Элемент table:database-range определяет один диапазон базы данных.

Имя диапазона базы данных

Атрибут table:name определяет имя диапазона базы данных, на котором выполняются операции. В одном документе только один диапазон базы данных может не иметь имени. Этот диапазон базы данных обычно создается приложением автоматически и используется для фильтрации или сортировки данных в диапазонах ячеек без явного создания пользователем диапазона базы данных.

Выборка

Атрибут table:is-selection определяет, включает ли диапазон полную базу данных или только выборку записей из базы данных.

Сохранение стиля при обновлении

Атрибут table:on-update-keep-styles определяет поведение диапазона базы данных при обновлении. Если значение атрибута true, то стили, назначенные ячейкам первой строки диапазона базы данных, не являющейся надписью, используются для всех строк в диапазоне базы данных. Если значение атрибут false, все ячейки диапазона базы данных используют назначенный в документе стиль ячеек по умолчанию.

Сохранение размера при обновлении

Атрибут table:on-update-keep-size определяет поведение диапазона базы данных при изменении размера данных в источнике данных. Если значение атрибута true, диапазон сохраняет свой размер. Если значение атрибута false, диапазон не изменяет свой размер.

Постоянство данных

Атрибут table:has-persistent-data определяет, будут ли сохранены текущие данные диапазона базы данных при сохранении документа.

Ориентация

Атрибут table:orientation определяет ориентацию диапазона базы данных. Возможные значения этого атрибута row и column. Ориентация, например, используется при сортировке диапазона базы данных (см. раздел 8.6.5). Если ориентация имеет значение row, осуществляется сортировка строк, иначе — столбцов.

Содержание заголовка

Атрибут table:contains-header определяет, должны ли первая строка или столбец диапазона базы данных использоваться для определения надписей. Если значение атрибута равно true, то содержимое первой ячейки строки или столбца может быть использовано для ссылки на всю строку или столбец во многих операциях электронных таблиц, например, внутри сводных таблиц.

Отображение кнопок фильтра

Атрибут кнопок table:display-filter-buttons определяет, будут ли отображаться кнопки фильтра. Кнопки фильтра — это списковые элементы управления, отображаемые в ячейках надписей. Элементами списка являются все значения, существующие в обозначаемой надписью строке или столбце. При выборе одного из полей фильтр с его значением применяется к диапазону базы данных и выбирает все строки или столбцы, где ячейки в обозначенной надписью строке или столбце имеют выбранное значение.

Адрес целевого диапазона

Атрибут table:target-range-address определяет адрес диапазона ячеек диапазона базы данных. Выделение абсолютных и относительных адресов невозможно. Поэтому в адресе должно быть определено имя таблицы, а символ доллара проигнорирован.

Интервал обновления

Атрибут table:refresh-delay определяет интервал времени между автоматическими обновлениями.

8.6.2 SQL источника базы данных

Элемент table:database-source-sql описывает SQL-базу данных, которая содержит источник данных для диапазона базы данных.

Имя базы данных

Атрибут table:database-name определяет имя SQL-базы данных, из которой импортируются данные.

SQL-выражение

Атрибут table:sql-statement определяет SQL-выражение, используемое при импортировании данных из SQL-базы данных.

Анализ SQL-выражения

Атрибут table:parse-sql-statement определяет, осуществляется ли анализ SQL-инструкций.

8.6.3 Таблица источника базы данных

Элемент таблицы источника базы данных table:database-source-table определяет, что исходные данные диапазона базы данных хранятся в таблице базы данных.

Имя базы данных

Атрибут table:database-name определяет имя базы данных, из которой импортируются данные.

Имя таблицы

Атрибут table:database-table-name определяет имя таблицы базы данных, из которой импортируются данные.

8.6.4 Запрос источника базы данных

Элемент запроса источника базы данных table:database-source-query определяет, что исходные данные диапазона базы данных являются результатом запроса к базе данных.

Имя базы данных

Атрибут table:database-name определяет имя базы данных, из которой импортируются данные.

Имя запроса

Атрибут table:query-name определяет запрос, выполняемый к базе данных, из которой импортируются данные.

8.6.5 Сортировка

Элемент сортировки table:sort описывает принципы сортировки, которые должны быть применены к диапазону базы данных.

Привязка стилей к содержимому

Атрибут table:bind-styles-to-content определяет, сохраняют ли ячейки свои атрибуты стиля после выполнения операции сортировки.

Адрес целевого диапазона

Если представлен необязательный атрибут table:target-range-address, результат сортировки копируется в определенный им диапазон ячеек вместо исходного диапазона ячеек, определенного диапазоном базы данных. Различия между абсолютными и относительными адресами невозможны. Поэтому в адресе должно присутствовать имя таблицы, а знак доллара игнорируется.

Чувствительность к регистру

Атрибут table:case-sensitive определяет, учитывать ли в операциях сортировки регистр символов.

Язык

Атрибут table:language определяет естественный язык, в котором осуществляется сравнение.

Страна

Атрибут table:country определяет наличие специфичных для страны правил, используемых при сортировке строк на конкретном естественном языке.

Алгоритм

Атрибут table:algorithm определяет алгоритм, используемый для сравнения сортируемых ключей. Значение атрибута определяется приложением, но язык и страна также влияют на название алгоритма сортировки, например, «фонетический (сначала алфавитно-цифровые)». Для недопущения разногласий между различными приложениями название должно начинаться с префикса пространства имен.

8.6.6 Поле сортировки

Элемент сортировки посредством table:sort-by определяет ключ или поле для сортировки, тип данных этого поля и способ сортировки.

Номер поля

Атрибут номера table:field-number определяет строку или столбец для сортировки. Это номер строки или столбца в диапазоне базы данных.

Тип данных

Атрибут table:data-type определяет тип данных поля для сортировки. Он может принимать значения text, number, automatic или имя определяемого пользователем параметра сортировки. Если атрибут имеет значение automatic, то приложение должно определить тип данных в поле. Например, определяемый пользователем порядок сортировки — список названий месяцев. Задание определяемого пользователем порядка сортировки специфично для различных приложений.

Порядок

Атрибут table:order определяет, сортируются ли данные в порядке возрастания или убывания.

8.6.7 Правила промежуточных сумм

Элемент правила промежуточных сумм table:subtotal-rules определяет, что для диапазона базы данных должны вычисляться промежуточные результаты (называемые промежуточными суммами). Он содержит информацию о строках и столбцах, для которых должны вычисляться промежуточные результаты, а также как эти результаты вычисляются. Для вычисления промежуточных результатов ячейки строк и столбцов группируются по их значениям, т.е. все ячейки с одинаковым содержимым в одном и том же поле образуют группу. Промежуточный результат вычисляется и отображается в конце каждой группы.

Привязка стилей к содержимому

Атрибут table:bind-styles-to-content определяет, сохраняют ли ячейки свои атрибуты стиля после вычисления промежуточных сумм. Этот атрибут оценивается, только если имеется элемент table:sort-groups.

Чувствительность к регистру

Атрибут table:case-sensitive определяет, имеет ли значение регистр символов при сравнении записей, например, при сортировке групп.

Разрывы страницы при изменении группы

Атрибут разрыва страницы при изменении группы table:page-breaks-on-group-change определяет, должен ли вставляться разрыв страницы после промежуточного результата каждой группы.

8.6.8 Отсортированные группы промежуточных сумм

Необязательный элемент отсортированных групп table:sort-groups определяет, что столбцы или строки сортируются перед группировкой, а также способ сортировки. Он относится к элементу правил промежуточных сумм (см. раздел 8.6.7).

Тип данных

Атрибут table:data-type определяет тип данных сортируемых столбца или строки. Детальная информация приведена в разделе 8.6.6.

Порядок

Атрибут table:order определяет, сортируются ли данные группы в порядке возрастания или убывания. Детальная информация приведена в разделе 8.6.6.

8.6.9 Правило промежуточной суммы

Элемент правила промежуточной суммы table:subtotal-rule определяет способ вычисления промежуточной суммы для конкретной строки или столбца. Правило содержит номер поля группировки, определяющий группу столбцов, для которых используется правило, и одно поле или более полей промежуточных сумм, определяющих строку или столбец, где должны быть вычислены промежуточные суммы, а также функцию, используемую для вычисления.

Группировка по номеру поля

Атрибут table:group-by-field-number определяет поле, например, столбец, по которому должна осуществляться группировка. Это номер строки или столбца в диапазоне базы данных.

8.6.10 Поле промежуточной суммы

Элемент поля промежуточной суммы table:subtotal-field содержит номер поля и функцию, которая используется для вычисления промежуточной суммы.

Номер поля

Атрибут table:field-number определяет строку или столбец, для которых должны вычисляться промежуточные суммы. Это номер строки или столбца в диапазоне базы данных.

Функция

Атрибут table:function определяет способ вычисления промежуточной суммы. Атрибут принимает следующие значения: auto, average, count, countnums, max, min, product, stdev, stdevp, sum, var и varp.

Пример. Поле промежуточных сумм:

8.7. Фильтры

Фильтры определяют, что должны быть видимыми только строки, удовлетворяющие определенным условиям.

8.7.1 Фильтр таблицы

Элемент фильтра таблицы table:filter определяет, как фильтруются данные, содержащиеся в диапазоне базы данных или сводной таблице. Условие, определенное в элементе, применяется ко всем строкам, определенным в диапазоне базы данных или сводной таблице. Строки, в которых условие не принимает истинное значение, делаются невидимыми.

Адрес целевого диапазона

Если представлен необязательный атрибут table:target-range-address, результат работы фильтра копируется в определенный диапазон ячеек, но все строки таблицы остаются видимыми. Выделение абсолютных и относительных адресов невозможно. Поэтому в адресе должно быть определено имя таблицы, а символ доллара проигнорирован.

Источник условия

Атрибут table:condition-source определяет, содержится ли условие в фильтре или приведено в диапазоне таблицы. Если атрибут имеет значение self, то условие определено в дочернем элементе элемента table:filter. Если атрибут имеет значение cell-range, условие содержится в диапазоне ячеек, определенном атрибутом table:condition-source-range-address.

Адрес диапазона источника условия

Атрибут table:condition-source-range-address определяет диапазон ячеек, который содержит условие. Первая строка диапазона должна содержать надписи столбцов, содержимое которых должно быть отфильтровано. Следующие строки содержат условия, которые должны выполняться для ячеек, содержащихся в столбце. Условия в каждой из строк объединяются посредством логической операции «и», в то время как строки — посредством логической операции «или». Это означает, что строки исходной таблицы отображаются, если в диапазоне условия имеется по крайней мере одна строка, в которой все условия, примененные к столбцам, определенным в первой строке диапазона условия, приняли истинное значение.

Пример.

Если диапазон источника условия E1:F3 (выделено желтым) и исходный диапазон A1:C3 (выделено зеленым), будут отображены только строки 2 и 3.

Строка 2 отображается потому, что ячейка в столбце A имеет значение 1, а ячейка в столбце B — 5, т.е. все условия 2-й строки диапазона условия приняли истинное значение. Строка 3 отображается потому, что ячейка в столбце A больше или равна 2, и, поскольку это единственное условие, все условия 3-й строки принимают истинное значение.

Отображение дубликатов

Атрибут table:display-duplicates определяет, должны ли отображаться повторяющиеся пригодные результаты.

8.7.2 Фильтр And (И)

Элемент table:filter-and определяет, что к условиям, определенным в дочерних элементах данного элемента, применяется логический оператор AND (И).

8.7.3 Фильтр Or (ИЛИ)

Элемент table:filter-or определяет, что к условиям, определенным в дочерних элементах данного элемента, применяется логический оператор OR (ИЛИ).

8.7.4 Условие фильтра

Элемент таблицы table:filter-condition определяет одно условие, применяемое при фильтрации.

Номер поля

Атрибут «номер поля» table:field-number определяет, какое поле используется для условия. Номер поля — это номер строки или столбца в исходном диапазоне фильтра.

Значение

Атрибут table:value определяет значение для условия фильтра.

Оператор

Атрибут «оператор» table:operator определяет, какой оператор используется в условии фильтра. Это означает, что каждая ячейка, содержащаяся в столбце, определенном номером поля (т.е. атрибутом table:field-number), сравнивается со значением (т.е. атрибутом table:value), с использованием данного оператора. Результат этого сравнения — это результат условия фильтра, определенного элементом table:filter-condition.

Операторы могут использовать или не использовать регулярные выражения. Следующие операторы используют регулярные выражения:

• match (совпадает);
• !match (не совпадает).

В обоих случаях атрибут table:value содержит регулярное выражение, с которым ячейки таблицы должны совпадать или не совпадать.

Операторы отношения, которые не используются в регулярных выражениях:

• = (равно);
• != (не равно);
• < (меньше);
• > (больше);
• <= (меньше или равно);
• >= (больше или равно).

Дополнительно могут использоваться empty (пусто), !empty (не пусто), bottom values (нижнее значение), top values (верхнее значение), bottom percent (нижний процент) и top percent (верхний процент). Например, для выборки нижней и верхней величины в процентах могут использоваться два последних оператора.

Чувствительность к регистру

Атрибут table:case-sensitive определяет, чувствительно ли условие фильтра к регистру.

Тип данных

Атрибут table:data-type определяет, будут ли сравниваться значения как текстовые или числовые.

Пример. Представление фильтра:

8.8. Сводные таблицы

Сводные таблицы позволяют анализировать и оценивать данные, содержащиеся в электронных таблицах. Элемент «сводные таблицы» table:data-pilot-tables содержит перечень всех сводных таблиц документа.

8.8.1 Сводная таблица

Элемент table:data-pilot-table определяет одну сводную таблицу. Внутри сводных таблиц собираются все комбинации значений, существующих в выделенных столбцах, и для каждой из комбинаций к ячейкам других столбцов применяется формула.

Пример.

Дана следующая исходная таблица:

Следующая сводная таблица группирует исходную таблицу по столбцам «Страна», «Город» и «Изделие», и вычисляются суммы столбцов «Количество» и «Цена» для каждой из комбинаций значений этих трех столбцов. Значения столбцов «Страна» и «Город» приведены в столбцах, в то время как значения столбца «Изделие» — в строках.

Столбцы, используемые для группировки (здесь «Страна», «Город» и «Изделие») называются столбцами категорий. Столбцы, для которых на основе комбинаций значений столбцов категорий вычисляется формула (здесь «Количество» и «Цена»), называются столбцами данных. Отдельные значения, которые содержатся в столбце категории, называются элементами.

В основном поведение сводной таблицы определяется полями, где каждое поле имеет имя и так называемую ориентацию. Столбцы категорий определяются полями с ориентацией row (строка) или column (столбец), а столбцы данных определяются полями, которые имеют ориентацию data (данные). В примере выше «Изделие» — это поле со столбцовой ориентацией, в то время как «Страна» и «Город» — поля со строковой. «Количество» и «Цена» — поля с ориентацией data.

Третий вид полей — это поля разметки данных. Поля разметки данных не связаны со столбцами исходной таблицы и используются только для изменения разметки сводной таблицы. Например, «Данные» — это поле разметки данных.

Порядок, в котором определяются поля, — реляционный. Они определяются в порядке, в котором данные столбцов категорий группируются, а результаты отображаются. Приведенная ниже сводная таблица демонстрирует, как меняется сводная таблица, если, например, поле разметки данных определяется перед полями столбцов категорий.

Пример. Сводная таблица с модифицированной разметкой:

С элементом сводная таблица могут быть связаны следующие атрибуты:

• имя сводной таблицы;
• данные приложения;
• итоговая сумма;
• пропуск пустых строк;
• распознавание категории;
• адрес целевого диапазона;
• отображение кнопки фильтра;
• переход к деталям по двойному щелчку.

Источник сводной таблицы

Источником сводной таблицы может быть база данных, т.е. таблица базы данных, SQL-запрос или именованный запрос, или диапазон ячеек, расположенный в самом документе. Он также может обеспечиваться внешним компонентом путем, зависящим от реализации.

Источник сводной таблицы определяется одним из следующих элементов, содержащихся в элементе table:data-pilot-table:

• table:database-source-sql (см. раздел 8.6.2);
• table:database-source-table (см. раздел 8.6.3);
• table:database-source-query (см. раздел 8.6.4);
• table:source-cell-range (см. раздел 8.8.2);
• table:source-service (см. раздел 8.8.3).

Имя сводной таблицы

Атрибут table:name определяет имя сводной таблицы.

Данные приложения

Атрибут table:application-data определяет дополнительную информацию о сводной таблице, которая может быть использована приложением, например, в макросах. Эти данные не оказывают воздействия на поведение сводной таблицы.

Итоговая сумма

Атрибут table:grand-total определяет, где в дополнение к значениям, вычисленным для каждой комбинации значений в столбцах категорий, должна отображаться итоговая сумма: в столбцах, строках или в обоих. В примере выше итоговая сумма разрешена. Она отображается в строке и столбце, обозначенном «Итого».

Пропуск пустых строк

Атрибут table:ignore-empty-rows определяет, должны ли пропускаться пустые строки в исходном диапазоне.

Распознавание категории

Атрибут table:identify-categories определяет, должны ли строки, не содержащие значения в одном из столбцов категорий, использовать значение ближайшей предшествующей строки, имеющей значение, или такие строки должны перемещаться в собственную группу (или категорию). Если атрибут имеет значение false, пустые значения формируют собственную категорию.

Адрес целевого диапазона

Атрибут table:target-range-address определяет целевой диапазон для вывода сводной таблицы, т.е. ее отображения. Выделение абсолютных и относительных адресов невозможно, т.е. адрес интерпретируется как абсолютный, даже если он содержит знаки доллара. Адрес диапазона должен содержать имя таблицы.

Кнопки

Внутри сводной таблицы некоторые ячейки для обеспечения интерактивных операций с таблицей, подобных изменению порядка столбцов, могут отображаться как кнопки. Атрибут table:buttons определяет все ячейки, которые должны отображаться таким образом. Его значением является список адресов ячеек. Выделение абсолютных и относительных адресов невозможно, т.е. адрес интерпретируется как абсолютный, даже если он содержит знаки доллара. Все адреса должны содержать имя таблицы.

В примерах выше ячейки кнопок отображаются с серым фоном.

Отображение кнопки фильтра

Атрибут table:show-filter-button определяет, должна ли внутри сводной таблицы в пользовательском интерфейсе отображаться кнопка фильтра. При нажатии на кнопку фильтра отображается диалог фильтра.

Переход к деталям по двойному щелчку

Атрибут table:drill-down-on-double-click определяет, как сводная таблица реагирует на двойной щелчок мышью внутри ее. Если значение атрибута false, двойной щелчок на надписи элемента или на пустой области приведет к переходу в режим редактирования ячейки, подобно ячейкам за пределами сводной таблицы. Это может использоваться для переименования полей групп или элементов. Если значение атрибута true, двойной щелчок на надписи элемента или на пустой области приведет к появлению или скрытию деталей этого элемента. Двойной щелчок в любом другом месте сводной таблицы не приведет к изменениям.

8.8.2 Источник-диапазон ячеек

Если источником сводной таблицы является диапазон ячеек, элемент table:source-cell-range содержит информацию о диапазоне ячеек и о том, как сводная таблица получает данные из диапазона. Перед тем как исходные данные преобразуются в данные сводной таблицы, к ним должен быть применен фильтр. Этот фильтр должен быть определен дочерним элементом table:filter.

С данным элементом может быть связан атрибут:

• адрес диапазона ячеек.

Адрес диапазона ячеек

Атрибут table:cell-range-address определяет диапазон ячеек, содержащий исходные данные. Адрес исходного диапазона ячеек должен быть абсолютным. Поэтому адрес диапазона ячеек должен содержать имя таблицы, а знаки доллара пропускаются.

8.8.3 Источник-служба

Источником сводной таблицы может быть «служба», т.е. данные могут предоставляться внешним компонентом. Элемент table:source-service содержит информацию о службе, которая используется для создания сводной таблицы.

С данным элементом могут быть связаны следующие атрибуты:

• имя службы;
• имя источника;
• имя объекта;
• имя пользователя источника;
• пароль источника.

Имя службы

Атрибут table:name определяет имя службы. Его значение зависит от конкретной реализации.

Имя источника

Атрибут table:source-name определяет имя источника, который относится к реализации службы. Его значение определяется особенностями приложения и службы.

Имя объекта

Атрибут table:object-name определяет имя объекта в источнике, который относится к реализации службы. Его значение определяется особенностями приложения и службы.

Имя пользователя источника

Атрибут table:user-name определяет имя пользователя, необходимое для доступа к источнику. Он относится к реализации службы. Его значение определяется особенностями приложения и службы.

Пароль источника

Атрибут table:password определяет пароль, необходимый для доступа к источнику. Он относится к реализации службы. Его значение определяется особенностями приложения и службы.

8.8.4 Поле сводной таблицы

Поля сводной таблицы определяются элементами table:data-pilot-field.

С данным элементом могут быть связаны следующие атрибуты:

• имя поля источника;
• ориентация;
• поле разметки данных;
• функция;
• используемая иерархия.

Имя поля источника

Для полей, которые определяют столбцы категорий или данных, атрибут table:source-field-name определяет имя или надпись столбца, в котором содержится поле. Если источником сводной таблицы является, например, диапазон ячеек, значением атрибута должна быть надпись столбца.

Может быть несколько элементов table:data-pilot-field с одним и тем же значением данного атрибута.

Ориентация

Атрибут table:orientation определяет ориентацию поля источника. Если значение атрибута data, то поле определяет столбец данных. Если значение атрибута row или column, то поле определяет столбец категории. Значение hidden (скрытый) используется для полей, которые имеют соответствующие столбцы в источнике, но невидимы в сводной таблице. Значение page указывает, что для соответствующего столбца должен быть сформирован автоматический фильтр (т.е. некоторый, позволяющий выбрать одно из значений, содержащихся в таблице). В этом случае для столбца должно существовать дополнительное поле с ориентацией row, column или data.

Если значение атрибута равно page, для определения выбранного для фильтра значения может использоваться атрибут table:selected-page.

Поле разметки данных

Атрибут table:is-data-layout-field определяет, является ли поле полем разметки данных (см. раздел 8.8.1). Поля разметки данных обычно не имеют имени.

Функция

Атрибут table:function определяет функцию, которая применяется к значениям ячеек столбцов данных. Он рассматривается только в случае, если атрибут table:orientation имеет значение data. Возможные значения данного атрибута: auto, average, count, countnums, max, min, product, stdev, stdevp, sum, var и varp. Для столбцов категорий значение атрибута auto может использоваться для определения того, что функция вообще не применяется.

Используемая иерархия

Если источник сводной таблицы предоставляется внешним компонентом или службой, данные, содержащиеся в столбцах категорий, могут быть не только сгруппированы по значению, но и могут быть далее разделены на подгруппы или иерархии. Значения дат, например, могут быть сгруппированы по правилу:

• «год», «месяц» и «день месяца»;
• «год», «неделя» и «день недели».

Если внешние компоненты поддерживают иерархии, то должны быть назначены уникальные номера. Эти номера могут быть использованы в атрибуте table:used-hierarchy для выбора иерархии, которая должна быть применена к полю источника. Значение по умолчанию означает, что иерархия вообще не применяется.