Функция ДОБ_ПОДСТ
Функция ДОБ_ПОДСТ добавляет простую подстановку для осуществления экспорта данных в офисные приложения при помощи функции ЭКСПОРТ_ФОРМЫ. Также данная функция используется для управления типом и другими параметрами диаграмм при использовании совместно с функцией ЭКСПОРТ_ГРАФИКА.
ФУНКЦИЯ ДОБ_ПОДСТ(ТИП_СТРОКА: ключ; *: значение)
Параметры
- ключ
- Фрагмент текста документа, требующий замены (например, "_Адрес").
- значение
- Значение для подстановки, преобразуемое в текстовый вид (например, "не облагается", 20 или 12.07.2013). Если необходимо передать строковое значение, длина которого превышает 255 символов, следует использовать объект типа список. Строки списка "склеиваются" без разделительного символа, т.е. для списка "А","Б","В" результирующий текст будет "АБВ".
После вызова функции ЭКСПОРТ_ФОРМЫ все вхождения ключевых строк в шаблоне документа будут заменены на соответствующие значения.
Управления настройками диаграмм
При использовании совместно с функцией ЭКСПОРТ_ГРАФИКА функция ДОБ_ПОДСТ позволяет задавать вид экспортируемых диаграмм. В этом случае ключ – это имя элемента диаграммы, а значение – значение определенного свойства данного элемента.
Для управления параметрами диаграмм имя элемента диаграммы задается с именами подэлементов, разделенных точками. Например, текст подписи оси X имеет имя "ОСЬ.X.ЗАГОЛОВОК". Имена всех элементов продублированы на английском языке. Эквивалентное имя для заголовка оси будет "AXIS.X.TITLE". Установка текста заголовка выглядит так:
ДОБ_ПОДСТ("ОСЬ.X.ЗАГОЛВОК", "Ось категорий")
Полный список элементов диаграммы приведен ниже.
Описание элементов диаграммы
| Имя | Эквивалент | Тип | Описание |
|---|---|---|---|
| ТИП | TYPE | строка | Идентификатор типа диаграммы. |
| 3D | 3D | логика | Определяет объемный вид диаграммы. |
| С_НАКОПЛЕНИЕМ | STACKED | логика | Определяет отображение вклада каждой категории в общую сумму. |
| ЛИНИИ | LINES | логика | Определяет отображения соединяющих точки линий на графиках и некоторых видах диаграмм. По умолчанию ДА. |
| ТОЧКИ | MARKERS | логика | Определяет отображения значков для точек данных на графиках и некоторых видах диаграмм. По умолчанию ДА. |
| ЛЕГЕНДА | LEGEND | логика | Определяет видимость легенды. По умолчанию ДА. |
| ЛЕГЕНДА.ШРИФТ | LEGEND.FONT | шрифт | Шрифт для надписей в легенде. По умолчанию берется из настройки "Пояснения". |
| ДАННЫЕ.ТЕКСТ | DATA.TEXT | логика | Определяет видимость описания данных, если диаграмма ее поддерживает. |
| ДАННЫЕ.ЗНАЧЕНИЕ | DATA.VALUE | логика | Определяет видимость значений, если график или диаграмма ее поддерживает. |
| ДАННЫЕ.ПРОЦЕНТ | DATA.PERCENT | логика | Определяет видимость процентного отношения значения, если диаграмма ее поддерживает. |
| ДАННЫЕ.ШРИФТ | DATA.FONT | шрифт | Шрифт для подписей данных. По умолчанию берется из настройки "По осям". |
| ЗАГОЛОВОК | TITLE | строка | Текст заголовка диаграммы. |
| ЗАГОЛОВОК.ШРИФТ | TITLE.FONT | шрифт | Шрифт для заголовка диаграммы. По умолчанию берется из настройки "Заголовок". |
| ОСЬ.X | AXIS.X | ось | Группа настроек оси категорий. |
| ОСЬ.Y | AXIS.Y | ось | Группа настроек оси категорий. |
| ОСЬ.Z | AXIS.Z | ось | Группа настроек оси Z, появляющейся в некоторых объемных диаграммах. |
Типы графиков и диаграмм
| Имя | Эквивалент | Описание |
|---|---|---|
| ГИСТОГРАММА | BAR | Столбчатая диаграмма. Столбики соответствуют столбцам таблицы данных, а группы столбиков – категориям. При включении признака "с накоплением" значения для каждой категории отображаются в одном столбце (разны цветом частей столбца). Этот тип используется по умолчанию. |
| КРУГОВАЯ | PIE | Круговая диаграмма. Отображает данные в виде секторов. Секторам соответствуют категории таблицы данных. Используется только первый столбец таблицы данных. |
| ГРАФИК | XY | Обычный график с непрерывными отсчетами по оси X. Категории не используются, а значения X берутся из первого столбца таблицы данных. |
| ОБЛАСТИ | AREA | Диаграмма с закрашенными областями. Вариант графика с закрашенными областями между осью X и значениями. Категории таблицы данных соответствуют отсчетам оси X. Столбцы таблицы данных соответствуют разным областям на графике. При включении объемности области разделяются по оси Z. |
| КОЛЬЦЕВАЯ | DONUT | Кольцевая диаграмма. Разновидность круговой диаграммы. Позволяет отображать не только первый столбец таблицы данных. Столбцам соответствуют концентрические кольца, а частям каждого кольца – категории. |
| ЛИНИИ | LINE | График с точками и линиями. Категории таблицы данных соответствуют отсчетам по оси X. Столбцы таблицы данных соответствуют разным линиям на графике. |
| ЛЕПЕСТКОВАЯ | NET | Лепестковая (сетчатая) диаграмма. |
Элементы шрифта
| Имя | Эквивалент | Тип | Описание |
|---|---|---|---|
| по_умолчанию | default | логика | Отменяет использование шрифта из настроек Инфо-Бухгалтера. В результате шрифт назначается целевым приложением по своему разумению. Если эта опция включена, то все остальные настройки для данного шрифта игнорируются. По умолчанию НЕТ. |
| название | facename | строка | Название шрифта. Например, "Arial". |
| размер | size | число | Размер в пунктах. |
| жирный | bold | логика | Признак жирности шрифта. |
| наклонный | italic | логика | Признак наклонности шрифта. |
| подчеркнутый | underline | логика | Признак подчеркивания. |
| зачеркнутый | strikeout | логика | Признак зачеркивания. |
| кодировка | charset | число | Номер кодовой страницы. Например, 204 для русской (RUSSIAN_CHARSET). |
Элементы оси
| Имя | Эквивалент | Тип | Описание |
|---|---|---|---|
| СЕТКА | GRID | логика | Признак отображения основной сетки. |
| СЕТКА.ДОПОЛНИТЕЛЬНАЯ | GRID.SECONDARY | логика | Признак отображения дополнительной сетки. |
| ЗАГОЛОВОК | TITLE | строка | Текст заголовка оси. |
| ЗАГОЛОВОК.ШРИФТ | TITLE.FONT | шрифт | Шрифт для заголовка оси. По умолчанию берется из настройки "По осям". |
| ШРИФТ | FONT | шрифт | Шрифт для отметок оси. По умолчанию берется из настройки "По осям". |
Пример использования
// выбираем тип диаграммы
ДОБ_ПОДСТ("ТИП", "ГИСТОГРАММА")
// делаем диаграмму объемной и включаем признак накопления
ДОБ_ПОДСТ("3D", ДА)
ДОБ_ПОДСТ("С_НАКОПЛЕНИЕМ", ДА)
// пусть шрифт легенды выберет приложение
ДОБ_ПОДСТ("ЛЕГЕНДА.ШРИФТ.по_умолчанию", ДА)
// включает подписи данных в виде процентного отношения
ДОБ_ПОДСТ("ДАННЫЕ.ПРОЦЕНТ", ДА)
// задаем заголовок диаграммы
ДОБ_ПОДСТ("ЗАГОЛОВОК", "I квартал 2013 года")
// и шрифт заголовка
ДОБ_ПОДСТ("ЗАГОЛОВОК.ШРИФТ.название", "Times New Roman")
ДОБ_ПОДСТ("ЗАГОЛОВОК.ШРИФТ.размер", 18)
ДОБ_ПОДСТ("ЗАГОЛОВОК.ШРИФТ.жирный", ДА)
ДОБ_ПОДСТ("ЗАГОЛОВОК.ШРИФТ.наклонный", НЕТ)
// настраиваем ось Y
ДОБ_ПОДСТ("ОСЬ.Y.ЗАГОЛОВОК", "млн. руб.")
ДОБ_ПОДСТ("ОСЬ.Y.ЗАГОЛОВОК.ШРИФТ.по_умолчанию", ДА)
ДОБ_ПОДСТ("ОСЬ.Y.СЕТКА", ДА)
В результате диаграмма будет выглядеть следующим образом:
