История страницы

Создание шаблона docx

В новый документ docx добавить поля-метки. Метки добавляются следующим методом "Вставка" => "Экспресс-блоки" => "Поле: "Категория" = "Слияние" => "MERGEFIELD" => "Коды поля". Далее в кавычках добавляется название нового поля, например:

MERGEFIELD "Новое поле"

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

Имя метки в настройках и вводимое имя поля должны совпадать.

Поддерживается как чистый HTML, так и HTML + CSS (передаётся единой строкой в СЭД сервис).

Поле для вставки HTML должно находиться на новой строке, отдельно от остального текста, вне таблиц и списков.

пример.docx

Описание шаблона 

Создать файла tempate.xml, в котором:

<?xml version="1.1" encoding="UTF-8" standalone="yes"?>
<ReportMetadataConfig name="{name}" description="{description}" constructor="docx">
    <formats>
        <format>DOCX</format>
    </formats>
</ReportMetadataConfig>

Описание новых меток

Описание меток происходит в файле ss_labels_settings.csv по пути "отчеты\описание меток", где:

expression - выражение для вычисления значения, которое подставится вместо метки. Обязательное.

извлекает значение заданного поля из документа. Если поле множественное, можно задавать значение разделителя через запятую для вывода значений в нужном формате (getDocumentFieldValue('Subject', ', ')). По умолчанию разделитель запятая с пробелом, если разделитель явно не задан, а в поле множественное.

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

извлекает имена субъектов из заданного поля (S - имя поля в качестве примера) и заданным разделителем для множественного поля (т.е. краткие имена будут объединены заданным разделителем).

getDateFieldValueFromLinkedDocument(getDocumentFieldValue('RkkDocId'), 'RDate', 'dd.MM.yyyy') 

getDateFieldValueFromLinkedDocument(getDocumentFieldValue('RkkDocId'), 'RDate', 'dd.MM.yyyy') 

получает значение поля типа "дата" или "дата-время" из некоторого "связанного" документа (под "связанностью" понимается любой документ, который можно получить из данного).
Например, getDateFieldValueFromLinkedDocument(getDocumentFieldValue('RkkDocId'), 'RDate', 'dd.MM.yyyy') извлечет поле RDate из документа в заданном формате (dd.MM.yyyy), идентификатор которого является результатом вычисления getDocumentFieldValue('RkkDocId') на объектом текущего документа, иными словами идентификатор связанного документа извлекается из поля текущего документа, далее сам документ извлекается из хранилища по переданному идентификатору и из него берется указанное поле.

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

select mo.id from ss_moduleorg mo inner join ss_module m on m.id = mo.module inner join ss_moduletype mt on mt.id = m.type join SO_OrgSystem os on os.id = mo.organization join SO_StructureUnit su ON su.id = os.id where mt.alias = '{module}' AND m.complect='' AND m.isNamed=1 AND su.shortname = '{short name organization}'

TYPE_NAME=ss_labels_settings;KEYS=title,moduletype;
title;expression;moduleorg;moduletype;organization
{label};getAddressFromBeard(getDocumentFieldValue('{field name}'), true);;"alias=""{module}""";

Подключение отчета к формированию пакета для загрузки

Конфигурация иморта отчетов

<?xml version="1.0" encoding="UTF-8"?>
<report-import-config>

	<!-- Путь к конфигурационным файлам к описанию отчетов -->
	<csv>
		<!-- Описание шаблона -->
		<file-path>reports/descriptions/cp1251/report_template.csv</file-path>

		<!-- Описание отчета -->
		<file-path>reports/descriptions/cp1251/qr_report.csv</file-path>

		<!-- Подключение к форме с помощью ключевых слов -->
		<file-path>reports/descriptions/cp1251/qr_report_keyword.csv</file-path>

		<!-- Подключение к модулю -->
		<file-path>reports/descriptions/cp1251/qr_report_supported_type.csv</file-path>

		<!-- Метки шаблона -->
		<file-path>reports/descriptions/cp1251/ss_labels_settings.csv</file-path>
	</csv>

	<!-- Шаблоны отчетов -->
	<templates>

		<!-- Путь к шаблону -->
		<template>
			<file-path>reports/{path}/template.xml</file-path>
			<file-path>reports/{path}/{name}.docx</file-path>
		</template>
	</templates>

</report-import-config>

Описание шаблона

TYPE_NAME=report_template;KEYS=name;;
name;description;constructor;type
{name};{description};docx;printform

Описание отчета

TYPE_NAME=QR_Report;KEYS=Name,Template;;;;;;;
Name;Comment;Module;IsSelectionBased;Template;PredefinedParameters;DefaultParamFormula;DialogSchema;IsAvailableInAnalytics;notavailableinrepcoll;isprintimmediately;issendchlog;order
{description};;select m.id from ss_module m inner join ss_moduletype mt on mt.id = m.type where mt.alias = 'QRCentre-AF5';true;"name=""{name}""";;;;false;false;false;false;60

Подключение к форме с помощью ключевых слов

TYPE_NAME=QR_ReportKeyword;KEYS=Report,Keyword
Report;Keyword
"name=""{description}""";{keyword}

Подключение к модулю

Новые метки добавляются в файл ss_labels_settings.csv