Alta-Soft Wikipedia - Вклад участника [ru]

Экспорт данных в офисные приложения

2026-03-25T07:41:51Z

Rudometov:

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося '''вложенного''' блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося '''вложенного''' блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ДТ)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ДТ)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

или

'''%%START'''[BLOCK] ''Начало основного блока (товары ДТ)''
'''%%STARTSUB'''[TOVG] ''Начало вложенного блока (Описание и характеристики товара (Графа 31 ДТ))''
'''%%BLOCK\TOVG\G31_1''' ''Описание группы товаров''
'''%%BLOCK\TOVG\G31_14''' ''Марка''
'''%%BLOCK\TOVG\G31_15''' ''Артикул''
'''%%ENDSUB'''[TOVG] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для объединения ячеек в столбцах (ROWSPAN) ====

Если в столбце дописать ключевое слово '''%%JOIN''', то такой ячейки с одинаковыми значениями в столбце будут объединены.
Например, если шаблон вида

{| class="wikitable"
| %%FID1 || %%FID2
|}

формирует таблицу

{| class="wikitable"
| 1111 || aaaaa
|-
| 1111 || ббббб
|-
| 2222 || ввввв
|-
| 2222 || ггггг
|-
| 2222 || ддддд
|}

то шаблон

{| class="wikitable"
| %%FID1 %%JOIN || %%FID2
|}

cформирует

{| class="wikitable"
| rowspan="2"| 1111 || aaaaa
|-
| ббббб
|-
| rowspan="3"| 2222 || ввввв
|-
| ггггг
|-
| ддддд
|}

Применимо для печати в Excel и OpenOffice Calc.

==== Для очистки строки с вложенным блоком вместо её удаления ====

Если в любом месте главного цикла (START_END) вписать идентификатор '''%%CLEARSUBIFEMPTY''', то строка с вложенным циклом (STARTSUB_ENDSUB) не будет удаляться при пустом вложенном блоке,
а просто очистятся ячейки этого блока. Полезно, когда вложенный блок находится в одной строке с главным блоком. Обычно при пустом вложенном удаляется вся строка, вместе с главным блоком.
С таким идентификатором этого удаления можно избежать.

Применимо для печати в Excel и OpenOffice Calc.

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAME''' – извлекает из графы 31 наименование вместе с обороткой TXT. По настройке [ExtraPrint]G31NameTovG=1 добавляет TOVG; 
* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31.NAMETILLCOLON''' – извлекает из графы 31 наименование товара до двоеточия; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
* '''%%SUM3(''<ИМЯ_БЛОКА1>\<ИМЯ_БЛОКА2>\<ИМЯ_БЛОКА3>\<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля в блоке 3го уровня.
* '''%%31.PALCOUNT''' - количество паллет.
* '''%%31.PAKTYPE''' - тип упаковки.
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%31.PAKNAME''' - наименование упаковки.
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%FIRSTDT''' – извлечет номер первой ДТ; 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, либо в заданном вложенном блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%NUMBLOCKA(''<ИМЯ_БЛОКА>'')''' - Возвращает количество записей в заданном вложенном блоке всех товаров %%NUMBLOCK('BLOCK\TOVG')
* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)

* '''%%EXECMACROS(''<ИМЯ_МАКРОСА>'')''' - выполнит макрос, прописанный в шаблоне, после окончания выгрузки. Может находиться в любом месте шаблона.

* '''%%FORMULA([35_1]+[38_1])''' - выполнить операцию над полями (сложение, умножение, конкатекация строк и т.д.). Названия полей должны быть выделены скобками.

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'' или ''УСЛОВИЕ'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) или условия (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

==== Функции работы с датой ====

* '''%%TEXTDATE(''<ИМЯ_ПОЛЯ_С_ДАТОЙ>'')''' - конвертирует дату в текстовый формат (21 января 2025)
* '''%%DATE(''"dd mmmm yyyy"'',''[<ИМЯ_ПОЛЯ_С_ДАТОЙ>]'')''' - конвертирует дату в произвольный заданный формат
* '''%%CURDATE''' - возвращает текущую дату в формате dd.mm.yyyy
* '''%%CURTIME''' - возвращает текущее время в формате hh:nn:ss
* '''%%DASHDATE(''<ИМЯ_ПОЛЯ_С_ДАТОЙ>'')''' - заменяет точки на дефисы в дате dd-mm-yyyy

==== Прочие функции ====

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 
* '''%%COPY(''<ИМЯ_ПОЛЯ>'', ''X'', ''Y'')''' - копировать часть данных из поля
* '''%%TRIM(''<ИМЯ_ПОЛЯ>'')''' - чистит значение поля от незначащих символов (пробелов) в начале и в конце
* '''%%LEFTPAD(''<ИМЯ_ПОЛЯ>'',''" "'',''10'')''' - Дополняет значение поля символами слева до заданной длины. По умолчанию (если второй параметр пустой) пробелами.

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_04021''' - выгрузятся все инвойсы
'''%%@44_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_06011_nodate''' – выгружает номер без дат,
'''%%@44_06011_date''' - только первая дата,
'''%%@44_06011_LASTDATE''' - только дата ДО,
'''%%@44_06011_CODE''' - только код типа документа,
'''%%@44_04021''' - номер и дату инвойса.
'''%%@44_04021_date''' - только дату инвойса.
'''%%@44_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_04021_SIGN''' - только признак предоставления документа
'''%%@44_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_04021_COUNT''' - количество документов в товаре с данным кодом
'''%%@44_04021_FORMULA(G444+G442+"ОТ"+G443)''' - выгрузится согласно формуле

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

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

'''%%@44_014??_NODATE''' - соберет через запятую номера документов с кодами 01401, 01402, 01403 и до 01499

Если при помощи символов ? не удается закодировать маску для документов, то можно использовать символ & и указать несколько кодов документов

'''%%@44_01191&01402_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01402
'''%%@44_01191&0140?_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01401, 01402, 01403 ... до 01409

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.
'''%%@B_1010_DocNum''' – выгрузится номер платежного документа по коду 1010.
'''%%@B_0''' – выгрузится сумма всех платежей.
'''%%@B_0_Doc''' – выгрузятся номер и дата платежных документов по всем кодам.
'''%%@B_0_DocNum''' – выгрузятся номера платежных документов по всем кодам.
'''%%@B_0_Text''' – выгрузится вся строка, кроме ИНН\КПП.

==== Для получения информации из SQL таблиц по ДТ и процедуре ====

* '''%%PROCESSID''' - ID ЭД-процедуры.
* '''%%EDSTAT''' - ЭД-статус ДТ в текстовом виде.
* '''%%EDSENDDATE''' - Дата подачи ДТ.
* '''%%EDSENDTIME''' - Время подачи ДТ.
* '''%%EDREGISTERDATE''' - Дата регистрации ДТ.
* '''%%EDREGISTERTIME''' - Время регистрации ДТ.
* '''%%EDLASTDATE''' - Дата выпуска ДТ.
* '''%%EDLASTTIME''' - Время выпуска ДТ.
* '''%%EDDATEBYCMN()''' - Дата произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDDATEBYCMN(CMN.11001) - дата регистрации ДТ
* '''%%EDTIMEBYCMN()''' - Время произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDTIMEBYCMN(CMN.11001) - время регистрации ДТ
* '''%%EDDATETIMEBY11309''' - Дата и время ЭД-сообщения CMN.11309 по ДТ в формате dd.mm.yyyy hh:nn:ss. При условии что сообщение CMN.11306 в статусе 3.
* '''%%EDRESULTBYCMN()''' - Возвращает Result по сообщению или нескольким через запятую.

==== Специальные функции ====

* '''%%@#DTI\IDCODE'''

При добавлении к идентификатору из вложенного блока символов @# печать собирает все записи дополнение текущего товара в одну строку сохраняя переносы,
и создает строки в Excel (Calc) по количеству переносов, например %%@#DTI\IDCODE берет все записи DTI в текущем товаре, и делает общий массив значений IDCODE.
Потом одной операцией его вставляет, подсчитав и учтя в дальнейшем количество вставленных строк. Вставляет строго в строку где стоит конец товарного блока (%%END[BLOCK])
Поэтому в этой строке недопустимы какие-то идентификаторы, кроме самого %%END[BLOCK].

Есть вариант записи всей строки в одну ячейку, без добавления строк, для этого добавляется двойной символ @ - %%@@DTI\IDCODE

Дополнительная опция для идентификатора %%@#DTI\IDCODE - если вставить его внутри цикла по TOVG, то для каждого артикула будет выводить только те коды DTI, у которых в поле ART прописан этот артикул.
То есть получается фильтр кодов по артикулам.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2025-12-09T09:27:45Z

Rudometov:

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося '''вложенного''' блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося '''вложенного''' блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ДТ)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ДТ)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

или

'''%%START'''[BLOCK] ''Начало основного блока (товары ДТ)''
'''%%STARTSUB'''[TOVG] ''Начало вложенного блока (Описание и характеристики товара (Графа 31 ДТ))''
'''%%BLOCK\TOVG\G31_1''' ''Описание группы товаров''
'''%%BLOCK\TOVG\G31_14''' ''Марка''
'''%%BLOCK\TOVG\G31_15''' ''Артикул''
'''%%ENDSUB'''[TOVG] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для объединения ячеек в столбцах (ROWSPAN) ====

Если в столбце дописать ключевое слово '''%%JOIN''', то такой ячейки с одинаковыми значениями в столбце будут объединены.
Например, если шаблон вида

{| class="wikitable"
| %%FID1 || %%FID2
|}

формирует таблицу

{| class="wikitable"
| 1111 || aaaaa
|-
| 1111 || ббббб
|-
| 2222 || ввввв
|-
| 2222 || ггггг
|-
| 2222 || ддддд
|}

то шаблон

{| class="wikitable"
| %%FID1 %%JOIN || %%FID2
|}

cформирует

{| class="wikitable"
| rowspan="2"| 1111 || aaaaa
|-
| ббббб
|-
| rowspan="3"| 2222 || ввввв
|-
| ггггг
|-
| ддддд
|}

Применимо для печати в Excel и OpenOffice Calc.

==== Для очистки строки с вложенным блоком вместо её удаления ====

Если в любом месте главного цикла (START_END) вписать идентификатор '''%%CLEARSUBIFEMPTY''', то строка с вложенным циклом (STARTSUB_ENDSUB) не будет удаляться при пустом вложенном блоке,
а просто очистятся ячейки этого блока. Полезно, когда вложенный блок находится в одной строке с главным блоком. Обычно при пустом вложенном удаляется вся строка, вместе с главным блоком.
С таким идентификатором этого удаления можно избежать.

Применимо для печати в Excel и OpenOffice Calc.

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAME''' – извлекает из графы 31 наименование вместе с обороткой TXT. По настройке [ExtraPrint]G31NameTovG=1 добавляет TOVG; 
* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31.NAMETILLCOLON''' – извлекает из графы 31 наименование товара до двоеточия; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
* '''%%SUM3(''<ИМЯ_БЛОКА1>\<ИМЯ_БЛОКА2>\<ИМЯ_БЛОКА3>\<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля в блоке 3го уровня.
* '''%%31.PALCOUNT''' - количество паллет.
* '''%%31.PAKTYPE''' - тип упаковки.
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%31.PAKNAME''' - наименование упаковки.
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%FIRSTDT''' – извлечет номер первой ДТ; 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, либо в заданном вложенном блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%NUMBLOCKA(''<ИМЯ_БЛОКА>'')''' - Возвращает количество записей в заданном вложенном блоке всех товаров %%NUMBLOCK('BLOCK\TOVG')
* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)

* '''%%EXECMACROS(''<ИМЯ_МАКРОСА>'')''' - выполнит макрос, прописанный в шаблоне, после окончания выгрузки. Может находиться в любом месте шаблона.

* '''%%FORMULA([35_1]+[38_1])''' - выполнить операцию над полями (сложение, умножение, конкатекация строк и т.д.). Названия полей должны быть выделены скобками.

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'' или ''УСЛОВИЕ'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) или условия (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

==== Функции работы с датой ====

* '''%%TEXTDATE(''<ИМЯ_ПОЛЯ_С_ДАТОЙ>'')''' - конвертирует дату в текстовый формат (21 января 2025)
* '''%%DATE(''"dd mmmm yyyy"'',''[<ИМЯ_ПОЛЯ_С_ДАТОЙ>]'')''' - конвертирует дату в произвольный заданный формат
* '''%%CURDATE''' - возвращает текущую дату в формате dd.mm.yyyy
* '''%%CURTIME''' - возвращает текущее время в формате hh:nn:ss
* '''%%DASHDATE(''<ИМЯ_ПОЛЯ_С_ДАТОЙ>'')''' - заменяет точки на дефисы в дате dd-mm-yyyy

==== Прочие функции ====

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 
* '''%%COPY(''<ИМЯ_ПОЛЯ>'', ''X'', ''Y'')''' - копировать часть данных из поля
* '''%%TRIM(''<ИМЯ_ПОЛЯ>'')''' - чистит значение поля от незначащих символов (пробелов) в начале и в конце
* '''%%LEFTPAD(''<ИМЯ_ПОЛЯ>'',''" "'',''10'')''' - Дополняет значение поля символами слева до заданной длины. По умолчанию (если второй параметр пустой) пробелами.

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_04021''' - выгрузятся все инвойсы
'''%%@44_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_06011_nodate''' – выгружает номер без дат,
'''%%@44_06011_date''' - только первая дата,
'''%%@44_06011_LASTDATE''' - только дата ДО,
'''%%@44_06011_CODE''' - только код типа документа,
'''%%@44_04021''' - номер и дату инвойса.
'''%%@44_04021_date''' - только дату инвойса.
'''%%@44_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_04021_SIGN''' - только признак предоставления документа
'''%%@44_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_04021_COUNT''' - количество документов в товаре с данным кодом
'''%%@44_04021_FORMULA(G444+G442+"ОТ"+G443)''' - выгрузится согласно формуле

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

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

'''%%@44_014??_NODATE''' - соберет через запятую номера документов с кодами 01401, 01402, 01403 и до 01499

Если при помощи символов ? не удается закодировать маску для документов, то можно использовать символ & и указать несколько кодов документов

'''%%@44_01191&01402_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01402
'''%%@44_01191&0140?_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01401, 01402, 01403 ... до 01409

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.
'''%%@B_1010_DocNum''' – выгрузится номер платежного документа по коду 1010.
'''%%@B_0''' – выгрузится сумма всех платежей.
'''%%@B_0_Doc''' – выгрузятся номер и дата платежных документов по всем кодам.
'''%%@B_0_DocNum''' – выгрузятся номера платежных документов по всем кодам.
'''%%@B_0_Text''' – выгрузится вся строка, кроме ИНН\КПП.

==== Для получения информации из SQL таблиц по ДТ и процедуре ====

* '''%%PROCESSID''' - ID ЭД-процедуры.
* '''%%EDSTAT''' - ЭД-статус ДТ в текстовом виде.
* '''%%EDSENDDATE''' - Дата подачи ДТ.
* '''%%EDSENDTIME''' - Время подачи ДТ.
* '''%%EDREGISTERDATE''' - Дата регистрации ДТ.
* '''%%EDREGISTERTIME''' - Время регистрации ДТ.
* '''%%EDLASTDATE''' - Дата выпуска ДТ.
* '''%%EDLASTTIME''' - Время выпуска ДТ.
* '''%%EDDATEBYCMN()''' - Дата произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDDATEBYCMN(CMN.11001) - дата регистрации ДТ
* '''%%EDTIMEBYCMN()''' - Время произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDTIMEBYCMN(CMN.11001) - время регистрации ДТ
* '''%%EDDATETIMEBY11309''' - Дата и время ЭД-сообщения CMN.11309 по ДТ в формате dd.mm.yyyy hh:nn:ss. При условии что сообщение CMN.11306 в статусе 3.
* '''%%EDRESULTBYCMN()''' - Возвращает Result по сообщению или нескольким через запятую.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2025-10-22T09:01:22Z

Rudometov:

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося '''вложенного''' блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося '''вложенного''' блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ДТ)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ДТ)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

или

'''%%START'''[BLOCK] ''Начало основного блока (товары ДТ)''
'''%%STARTSUB'''[TOVG] ''Начало вложенного блока (Описание и характеристики товара (Графа 31 ДТ))''
'''%%BLOCK\TOVG\G31_1''' ''Описание группы товаров''
'''%%BLOCK\TOVG\G31_14''' ''Марка''
'''%%BLOCK\TOVG\G31_15''' ''Артикул''
'''%%ENDSUB'''[TOVG] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для объединения ячеек в столбцах (ROWSPAN) ====

Если в столбце дописать ключевое слово '''%%JOIN''', то такой ячейки с одинаковыми значениями в столбце будут объединены.
Например, если шаблон вида

{| class="wikitable"
| %%FID1 || %%FID2
|}

формирует таблицу

{| class="wikitable"
| 1111 || aaaaa
|-
| 1111 || ббббб
|-
| 2222 || ввввв
|-
| 2222 || ггггг
|-
| 2222 || ддддд
|}

то шаблон

{| class="wikitable"
| %%FID1 %%JOIN || %%FID2
|}

cформирует

{| class="wikitable"
| rowspan="2"| 1111 || aaaaa
|-
| ббббб
|-
| rowspan="3"| 2222 || ввввв
|-
| ггггг
|-
| ддддд
|}

Применимо для печати в Excel и OpenOffice Calc.

==== Для очистки строки с вложенным блоком вместо её удаления ====

Если в любом месте главного цикла (START_END) вписать идентификатор '''%%CLEARSUBIFEMPTY''', то строка с вложенным циклом (STARTSUB_ENDSUB) не будет удаляться при пустом вложенном блоке,
а просто очистятся ячейки этого блока. Полезно, когда вложенный блок находится в одной строке с главным блоком. Обычно при пустом вложенном удаляется вся строка, вместе с главным блоком.
С таким идентификатором этого удаления можно избежать.

Применимо для печати в Excel и OpenOffice Calc.

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAME''' – извлекает из графы 31 наименование вместе с обороткой TXT. По настройке [ExtraPrint]G31NameTovG=1 добавляет TOVG; 
* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31.NAMETILLCOLON''' – извлекает из графы 31 наименование товара до двоеточия; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
* '''%%SUM3(''<ИМЯ_БЛОКА1>\<ИМЯ_БЛОКА2>\<ИМЯ_БЛОКА3>\<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля в блоке 3го уровня.
* '''%%31.PALCOUNT''' - количество паллет.
* '''%%31.PAKTYPE''' - тип упаковки.
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%31.PAKNAME''' - наименование упаковки.
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%FIRSTDT''' – извлечет номер первой ДТ; 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, либо в заданном вложенном блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%NUMBLOCKA(''<ИМЯ_БЛОКА>'')''' - Возвращает количество записей в заданном вложенном блоке всех товаров %%NUMBLOCK('BLOCK\TOVG')
* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)

* '''%%EXECMACROS(''<ИМЯ_МАКРОСА>'')''' - выполнит макрос, прописанный в шаблоне, после окончания выгрузки. Может находиться в любом месте шаблона.

* '''%%FORMULA([35_1]+[38_1])''' - выполнить операцию над полями (сложение, умножение, конкатекация строк и т.д.). Названия полей должны быть выделены скобками.

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

==== Функции работы с датой ====

* '''%%TEXTDATE(''<ИМЯ_ПОЛЯ_С_ДАТОЙ>'')''' - конвертирует дату в текстовый формат (21 января 2025)
* '''%%DATE(''"dd mmmm yyyy"'',''[<ИМЯ_ПОЛЯ_С_ДАТОЙ>]'')''' - конвертирует дату в произвольный заданный формат
* '''%%CURDATE''' - возвращает текущую дату в формате dd.mm.yyyy
* '''%%CURTIME''' - возвращает текущее время в формате hh:nn:ss
* '''%%DASHDATE(''<ИМЯ_ПОЛЯ_С_ДАТОЙ>'')''' - заменяет точки на дефисы в дате dd-mm-yyyy

==== Прочие функции ====

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 
* '''%%COPY(''<ИМЯ_ПОЛЯ>'', ''X'', ''Y'')''' - копировать часть данных из поля
* '''%%TRIM(''<ИМЯ_ПОЛЯ>'')''' - чистит значение поля от незначащих символов (пробелов) в начале и в конце
* '''%%LEFTPAD(''<ИМЯ_ПОЛЯ>'',''" "'',''10'')''' - Дополняет значение поля символами слева до заданной длины. По умолчанию (если второй параметр пустой) пробелами.

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_04021''' - выгрузятся все инвойсы
'''%%@44_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_06011_nodate''' – выгружает номер без дат,
'''%%@44_06011_date''' - только первая дата,
'''%%@44_06011_LASTDATE''' - только дата ДО,
'''%%@44_06011_CODE''' - только код типа документа,
'''%%@44_04021''' - номер и дату инвойса.
'''%%@44_04021_date''' - только дату инвойса.
'''%%@44_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_04021_SIGN''' - только признак предоставления документа
'''%%@44_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_04021_COUNT''' - количество документов в товаре с данным кодом
'''%%@44_04021_FORMULA(G444+G442+"ОТ"+G443)''' - выгрузится согласно формуле

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

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

'''%%@44_014??_NODATE''' - соберет через запятую номера документов с кодами 01401, 01402, 01403 и до 01499

Если при помощи символов ? не удается закодировать маску для документов, то можно использовать символ & и указать несколько кодов документов

'''%%@44_01191&01402_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01402
'''%%@44_01191&0140?_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01401, 01402, 01403 ... до 01409

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.
'''%%@B_1010_DocNum''' – выгрузится номер платежного документа по коду 1010.
'''%%@B_0''' – выгрузится сумма всех платежей.
'''%%@B_0_Doc''' – выгрузятся номер и дата платежных документов по всем кодам.
'''%%@B_0_DocNum''' – выгрузятся номера платежных документов по всем кодам.
'''%%@B_0_Text''' – выгрузится вся строка, кроме ИНН\КПП.

==== Для получения информации из SQL таблиц по ДТ и процедуре ====

* '''%%PROCESSID''' - ID ЭД-процедуры.
* '''%%EDSTAT''' - ЭД-статус ДТ в текстовом виде.
* '''%%EDSENDDATE''' - Дата подачи ДТ.
* '''%%EDSENDTIME''' - Время подачи ДТ.
* '''%%EDREGISTERDATE''' - Дата регистрации ДТ.
* '''%%EDREGISTERTIME''' - Время регистрации ДТ.
* '''%%EDLASTDATE''' - Дата выпуска ДТ.
* '''%%EDLASTTIME''' - Время выпуска ДТ.
* '''%%EDDATEBYCMN()''' - Дата произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDDATEBYCMN(CMN.11001) - дата регистрации ДТ
* '''%%EDTIMEBYCMN()''' - Время произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDTIMEBYCMN(CMN.11001) - время регистрации ДТ
* '''%%EDDATETIMEBY11309''' - Дата и время ЭД-сообщения CMN.11309 по ДТ в формате dd.mm.yyyy hh:nn:ss. При условии что сообщение CMN.11306 в статусе 3.
* '''%%EDRESULTBYCMN()''' - Возвращает Result по сообщению или нескольким через запятую.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2025-10-03T13:09:18Z

Rudometov: /* Для извлечений из гр.31 ДТ */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося '''вложенного''' блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося '''вложенного''' блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ДТ)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ДТ)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

или

'''%%START'''[BLOCK] ''Начало основного блока (товары ДТ)''
'''%%STARTSUB'''[TOVG] ''Начало вложенного блока (Описание и характеристики товара (Графа 31 ДТ))''
'''%%BLOCK\TOVG\G31_1''' ''Описание группы товаров''
'''%%BLOCK\TOVG\G31_14''' ''Марка''
'''%%BLOCK\TOVG\G31_15''' ''Артикул''
'''%%ENDSUB'''[TOVG] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для объединения ячеек в столбцах (ROWSPAN) ====

Если в столбце дописать ключевое слово '''%%JOIN''', то такой ячейки с одинаковыми значениями в столбце будут объединены.
Например, если шаблон вида

{| class="wikitable"
| %%FID1 || %%FID2
|}

формирует таблицу

{| class="wikitable"
| 1111 || aaaaa
|-
| 1111 || ббббб
|-
| 2222 || ввввв
|-
| 2222 || ггггг
|-
| 2222 || ддддд
|}

то шаблон

{| class="wikitable"
| %%FID1 %%JOIN || %%FID2
|}

cформирует

{| class="wikitable"
| rowspan="2"| 1111 || aaaaa
|-
| ббббб
|-
| rowspan="3"| 2222 || ввввв
|-
| ггггг
|-
| ддддд
|}

Применимо для печати в Excel и OpenOffice Calc.

==== Для очистки строки с вложенным блоком вместо её удаления ====

Если в любом месте главного цикла (START_END) вписать идентификатор '''%%CLEARSUBIFEMPTY''', то строка с вложенным циклом (STARTSUB_ENDSUB) не будет удаляться при пустом вложенном блоке,
а просто очистятся ячейки этого блока. Полезно, когда вложенный блок находится в одной строке с главным блоком. Обычно при пустом вложенном удаляется вся строка, вместе с главным блоком.
С таким идентификатором этого удаления можно избежать.

Применимо для печати в Excel и OpenOffice Calc.

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAME''' – извлекает из графы 31 наименование вместе с обороткой TXT. По настройке [ExtraPrint]G31NameTovG=1 добавляет TOVG; 
* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31.NAMETILLCOLON''' – извлекает из графы 31 наименование товара до двоеточия; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
* '''%%SUM3(''<ИМЯ_БЛОКА1>\<ИМЯ_БЛОКА2>\<ИМЯ_БЛОКА3>\<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля в блоке 3го уровня.
* '''%%31.PALCOUNT''' - количество паллет.
* '''%%31.PAKTYPE''' - тип упаковки.
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%31.PAKNAME''' - наименование упаковки.
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%FIRSTDT''' – извлечет номер первой ДТ; 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, либо в заданном вложенном блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%NUMBLOCKA(''<ИМЯ_БЛОКА>'')''' - Возвращает количество записей в заданном вложенном блоке всех товаров %%NUMBLOCK('BLOCK\TOVG')
* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)

* '''%%EXECMACROS(''<ИМЯ_МАКРОСА>'')''' - выполнит макрос, прописанный в шаблоне, после окончания выгрузки. Может находиться в любом месте шаблона.

* '''%%FORMULA([35_1]+[38_1])''' - выполнить операцию над полями (сложение, умножение, конкатекация строк и т.д.). Названия полей должны быть выделены скобками.

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

==== Функции работы с датой ====

* '''%%TEXTDATE(''<ИМЯ_ПОЛЯ_С_ДАТОЙ>'')''' - конвертирует дату в текстовый формат (21 января 2025)
* '''%%DATE(''"dd mmmm yyyy"'',''[<ИМЯ_ПОЛЯ_С_ДАТОЙ>]'')''' - конвертирует дату в произвольный заданный формат
* '''%%CURDATE''' - возвращает текущую дату в формате dd.mm.yyyy
* '''%%CURTIME''' - возвращает текущее время в формате hh:nn:ss
* '''%%DASHDATE(''<ИМЯ_ПОЛЯ_С_ДАТОЙ>'')''' - заменяет точки на дефисы в дате dd-mm-yyyy

==== Прочие функции ====

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 
* '''%%COPY(''<ИМЯ_ПОЛЯ>'', ''X'', ''Y'')''' - копировать часть данных из поля
* '''%%TRIM(''<ИМЯ_ПОЛЯ>'')''' - чистит значение поля от незначащих символов (пробелов) в начале и в конце
* '''%%LEFTPAD(''<ИМЯ_ПОЛЯ>'',''" "'',''10'')''' - Дополняет значение поля символами слева до заданной длины. По умолчанию (если второй параметр пустой) пробелами.

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_06011_LASTDATE''' - только дата ДО,
'''%%@44_!_06011_CODE''' - только код типа документа,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_!_04021_COUNT''' - количество документов в товаре с данным кодом
'''%%@44_!_04021_FORMULA(G444+G442+"ОТ"+G443)''' - выгрузится согласно формуле

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

С 2015 года так же допускается упрощенный синтаксис без _!_ в середине идентификатора.

'''%%@44_04021_TEXT'''
'''%%@44_01402_NODATE'''

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

'''%%@44_014??_NODATE''' - соберет через запятую номера документов с кодами 01401, 01402, 01403 и до 01499

Если при помощи символов ? не удается закодировать маску для документов, то можно использовать символ & и указать несколько кодов документов

'''%%@44_01191&01402_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01402
'''%%@44_01191&0140?_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01401, 01402, 01403 ... до 01409

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.
'''%%@B_1010_DocNum''' – выгрузится номер платежного документа по коду 1010.
'''%%@B_0''' – выгрузится сумма всех платежей.
'''%%@B_0_Doc''' – выгрузятся номер и дата платежных документов по всем кодам.
'''%%@B_0_DocNum''' – выгрузятся номера платежных документов по всем кодам.
'''%%@B_0_Text''' – выгрузится вся строка, кроме ИНН\КПП.

==== Для получения информации из SQL таблиц по ДТ и процедуре ====

* '''%%PROCESSID''' - ID ЭД-процедуры.
* '''%%EDSTAT''' - ЭД-статус ДТ в текстовом виде.
* '''%%EDSENDDATE''' - Дата подачи ДТ.
* '''%%EDSENDTIME''' - Время подачи ДТ.
* '''%%EDREGISTERDATE''' - Дата регистрации ДТ.
* '''%%EDREGISTERTIME''' - Время регистрации ДТ.
* '''%%EDLASTDATE''' - Дата выпуска ДТ.
* '''%%EDLASTTIME''' - Время выпуска ДТ.
* '''%%EDDATEBYCMN()''' - Дата произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDDATEBYCMN(CMN.11001) - дата регистрации ДТ
* '''%%EDTIMEBYCMN()''' - Время произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDTIMEBYCMN(CMN.11001) - время регистрации ДТ
* '''%%EDDATETIMEBY11309''' - Дата и время ЭД-сообщения CMN.11309 по ДТ в формате dd.mm.yyyy hh:nn:ss. При условии что сообщение CMN.11306 в статусе 3.
* '''%%EDRESULTBYCMN()''' - Возвращает Result по сообщению или нескольким через запятую.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2025-10-03T13:07:54Z

Rudometov: /* Для извлечений из гр.31 ДТ */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося '''вложенного''' блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося '''вложенного''' блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ДТ)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ДТ)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

или

'''%%START'''[BLOCK] ''Начало основного блока (товары ДТ)''
'''%%STARTSUB'''[TOVG] ''Начало вложенного блока (Описание и характеристики товара (Графа 31 ДТ))''
'''%%BLOCK\TOVG\G31_1''' ''Описание группы товаров''
'''%%BLOCK\TOVG\G31_14''' ''Марка''
'''%%BLOCK\TOVG\G31_15''' ''Артикул''
'''%%ENDSUB'''[TOVG] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для объединения ячеек в столбцах (ROWSPAN) ====

Если в столбце дописать ключевое слово '''%%JOIN''', то такой ячейки с одинаковыми значениями в столбце будут объединены.
Например, если шаблон вида

{| class="wikitable"
| %%FID1 || %%FID2
|}

формирует таблицу

{| class="wikitable"
| 1111 || aaaaa
|-
| 1111 || ббббб
|-
| 2222 || ввввв
|-
| 2222 || ггггг
|-
| 2222 || ддддд
|}

то шаблон

{| class="wikitable"
| %%FID1 %%JOIN || %%FID2
|}

cформирует

{| class="wikitable"
| rowspan="2"| 1111 || aaaaa
|-
| ббббб
|-
| rowspan="3"| 2222 || ввввв
|-
| ггггг
|-
| ддддд
|}

Применимо для печати в Excel и OpenOffice Calc.

==== Для очистки строки с вложенным блоком вместо её удаления ====

Если в любом месте главного цикла (START_END) вписать идентификатор '''%%CLEARSUBIFEMPTY''', то строка с вложенным циклом (STARTSUB_ENDSUB) не будет удаляться при пустом вложенном блоке,
а просто очистятся ячейки этого блока. Полезно, когда вложенный блок находится в одной строке с главным блоком. Обычно при пустом вложенном удаляется вся строка, вместе с главным блоком.
С таким идентификатором этого удаления можно избежать.

Применимо для печати в Excel и OpenOffice Calc.

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAME''' – извлекает из графы 31 наименование вместе с обороткой TXT. По настройке [ExtraPrint]G31NameTovG=1 добавляет TOVG; 
* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31.NAMETILLCOLON''' – извлекает из графы 31 наименование товара до двоеточия; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
* '''%%SUM3(''<ИМЯ_БЛОКА1>\<ИМЯ_БЛОКА2>\<ИМЯ_БЛОКА3>\<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля в блоке 3го уровня.
* '''%%31.PALCOUNT''' - количество паллет.
* '''%%31.PAKTYPE''' - тип упаковки.
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%31.PAKNAME''' - наименование упаковки.
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, либо в заданном вложенном блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%NUMBLOCKA(''<ИМЯ_БЛОКА>'')''' - Возвращает количество записей в заданном вложенном блоке всех товаров %%NUMBLOCK('BLOCK\TOVG')
* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)

* '''%%EXECMACROS(''<ИМЯ_МАКРОСА>'')''' - выполнит макрос, прописанный в шаблоне, после окончания выгрузки. Может находиться в любом месте шаблона.

* '''%%FORMULA([35_1]+[38_1])''' - выполнить операцию над полями (сложение, умножение, конкатекация строк и т.д.). Названия полей должны быть выделены скобками.

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

==== Функции работы с датой ====

* '''%%TEXTDATE(''<ИМЯ_ПОЛЯ_С_ДАТОЙ>'')''' - конвертирует дату в текстовый формат (21 января 2025)
* '''%%DATE(''"dd mmmm yyyy"'',''[<ИМЯ_ПОЛЯ_С_ДАТОЙ>]'')''' - конвертирует дату в произвольный заданный формат
* '''%%CURDATE''' - возвращает текущую дату в формате dd.mm.yyyy
* '''%%CURTIME''' - возвращает текущее время в формате hh:nn:ss
* '''%%DASHDATE(''<ИМЯ_ПОЛЯ_С_ДАТОЙ>'')''' - заменяет точки на дефисы в дате dd-mm-yyyy

==== Прочие функции ====

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 
* '''%%COPY(''<ИМЯ_ПОЛЯ>'', ''X'', ''Y'')''' - копировать часть данных из поля
* '''%%TRIM(''<ИМЯ_ПОЛЯ>'')''' - чистит значение поля от незначащих символов (пробелов) в начале и в конце
* '''%%LEFTPAD(''<ИМЯ_ПОЛЯ>'',''" "'',''10'')''' - Дополняет значение поля символами слева до заданной длины. По умолчанию (если второй параметр пустой) пробелами.

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_06011_LASTDATE''' - только дата ДО,
'''%%@44_!_06011_CODE''' - только код типа документа,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_!_04021_COUNT''' - количество документов в товаре с данным кодом
'''%%@44_!_04021_FORMULA(G444+G442+"ОТ"+G443)''' - выгрузится согласно формуле

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

С 2015 года так же допускается упрощенный синтаксис без _!_ в середине идентификатора.

'''%%@44_04021_TEXT'''
'''%%@44_01402_NODATE'''

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

'''%%@44_014??_NODATE''' - соберет через запятую номера документов с кодами 01401, 01402, 01403 и до 01499

Если при помощи символов ? не удается закодировать маску для документов, то можно использовать символ & и указать несколько кодов документов

'''%%@44_01191&01402_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01402
'''%%@44_01191&0140?_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01401, 01402, 01403 ... до 01409

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.
'''%%@B_1010_DocNum''' – выгрузится номер платежного документа по коду 1010.
'''%%@B_0''' – выгрузится сумма всех платежей.
'''%%@B_0_Doc''' – выгрузятся номер и дата платежных документов по всем кодам.
'''%%@B_0_DocNum''' – выгрузятся номера платежных документов по всем кодам.
'''%%@B_0_Text''' – выгрузится вся строка, кроме ИНН\КПП.

==== Для получения информации из SQL таблиц по ДТ и процедуре ====

* '''%%PROCESSID''' - ID ЭД-процедуры.
* '''%%EDSTAT''' - ЭД-статус ДТ в текстовом виде.
* '''%%EDSENDDATE''' - Дата подачи ДТ.
* '''%%EDSENDTIME''' - Время подачи ДТ.
* '''%%EDREGISTERDATE''' - Дата регистрации ДТ.
* '''%%EDREGISTERTIME''' - Время регистрации ДТ.
* '''%%EDLASTDATE''' - Дата выпуска ДТ.
* '''%%EDLASTTIME''' - Время выпуска ДТ.
* '''%%EDDATEBYCMN()''' - Дата произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDDATEBYCMN(CMN.11001) - дата регистрации ДТ
* '''%%EDTIMEBYCMN()''' - Время произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDTIMEBYCMN(CMN.11001) - время регистрации ДТ
* '''%%EDDATETIMEBY11309''' - Дата и время ЭД-сообщения CMN.11309 по ДТ в формате dd.mm.yyyy hh:nn:ss. При условии что сообщение CMN.11306 в статусе 3.
* '''%%EDRESULTBYCMN()''' - Возвращает Result по сообщению или нескольким через запятую.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2025-10-03T13:03:56Z

Rudometov: /* Для получения информации из SQL таблиц по ДТ и процедуре */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося '''вложенного''' блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося '''вложенного''' блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ДТ)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ДТ)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

или

'''%%START'''[BLOCK] ''Начало основного блока (товары ДТ)''
'''%%STARTSUB'''[TOVG] ''Начало вложенного блока (Описание и характеристики товара (Графа 31 ДТ))''
'''%%BLOCK\TOVG\G31_1''' ''Описание группы товаров''
'''%%BLOCK\TOVG\G31_14''' ''Марка''
'''%%BLOCK\TOVG\G31_15''' ''Артикул''
'''%%ENDSUB'''[TOVG] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для объединения ячеек в столбцах (ROWSPAN) ====

Если в столбце дописать ключевое слово '''%%JOIN''', то такой ячейки с одинаковыми значениями в столбце будут объединены.
Например, если шаблон вида

{| class="wikitable"
| %%FID1 || %%FID2
|}

формирует таблицу

{| class="wikitable"
| 1111 || aaaaa
|-
| 1111 || ббббб
|-
| 2222 || ввввв
|-
| 2222 || ггггг
|-
| 2222 || ддддд
|}

то шаблон

{| class="wikitable"
| %%FID1 %%JOIN || %%FID2
|}

cформирует

{| class="wikitable"
| rowspan="2"| 1111 || aaaaa
|-
| ббббб
|-
| rowspan="3"| 2222 || ввввв
|-
| ггггг
|-
| ддддд
|}

Применимо для печати в Excel и OpenOffice Calc.

==== Для очистки строки с вложенным блоком вместо её удаления ====

Если в любом месте главного цикла (START_END) вписать идентификатор '''%%CLEARSUBIFEMPTY''', то строка с вложенным циклом (STARTSUB_ENDSUB) не будет удаляться при пустом вложенном блоке,
а просто очистятся ячейки этого блока. Полезно, когда вложенный блок находится в одной строке с главным блоком. Обычно при пустом вложенном удаляется вся строка, вместе с главным блоком.
С таким идентификатором этого удаления можно избежать.

Применимо для печати в Excel и OpenOffice Calc.

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31.NAMETILLCOLON''' – извлекает из графы 31 наименование товара до двоеточия; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
* '''%%SUM3(''<ИМЯ_БЛОКА1>\<ИМЯ_БЛОКА2>\<ИМЯ_БЛОКА3>\<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля в блоке 3го уровня.
* '''%%31.PALCOUNT''' - количество паллет.
* '''%%31.PAKTYPE''' - тип упаковки.
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, либо в заданном вложенном блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%NUMBLOCKA(''<ИМЯ_БЛОКА>'')''' - Возвращает количество записей в заданном вложенном блоке всех товаров %%NUMBLOCK('BLOCK\TOVG')
* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)

* '''%%EXECMACROS(''<ИМЯ_МАКРОСА>'')''' - выполнит макрос, прописанный в шаблоне, после окончания выгрузки. Может находиться в любом месте шаблона.

* '''%%FORMULA([35_1]+[38_1])''' - выполнить операцию над полями (сложение, умножение, конкатекация строк и т.д.). Названия полей должны быть выделены скобками.

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

==== Функции работы с датой ====

* '''%%TEXTDATE(''<ИМЯ_ПОЛЯ_С_ДАТОЙ>'')''' - конвертирует дату в текстовый формат (21 января 2025)
* '''%%DATE(''"dd mmmm yyyy"'',''[<ИМЯ_ПОЛЯ_С_ДАТОЙ>]'')''' - конвертирует дату в произвольный заданный формат
* '''%%CURDATE''' - возвращает текущую дату в формате dd.mm.yyyy
* '''%%CURTIME''' - возвращает текущее время в формате hh:nn:ss
* '''%%DASHDATE(''<ИМЯ_ПОЛЯ_С_ДАТОЙ>'')''' - заменяет точки на дефисы в дате dd-mm-yyyy

==== Прочие функции ====

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 
* '''%%COPY(''<ИМЯ_ПОЛЯ>'', ''X'', ''Y'')''' - копировать часть данных из поля
* '''%%TRIM(''<ИМЯ_ПОЛЯ>'')''' - чистит значение поля от незначащих символов (пробелов) в начале и в конце
* '''%%LEFTPAD(''<ИМЯ_ПОЛЯ>'',''" "'',''10'')''' - Дополняет значение поля символами слева до заданной длины. По умолчанию (если второй параметр пустой) пробелами.

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_06011_LASTDATE''' - только дата ДО,
'''%%@44_!_06011_CODE''' - только код типа документа,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_!_04021_COUNT''' - количество документов в товаре с данным кодом
'''%%@44_!_04021_FORMULA(G444+G442+"ОТ"+G443)''' - выгрузится согласно формуле

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

С 2015 года так же допускается упрощенный синтаксис без _!_ в середине идентификатора.

'''%%@44_04021_TEXT'''
'''%%@44_01402_NODATE'''

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

'''%%@44_014??_NODATE''' - соберет через запятую номера документов с кодами 01401, 01402, 01403 и до 01499

Если при помощи символов ? не удается закодировать маску для документов, то можно использовать символ & и указать несколько кодов документов

'''%%@44_01191&01402_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01402
'''%%@44_01191&0140?_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01401, 01402, 01403 ... до 01409

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.
'''%%@B_1010_DocNum''' – выгрузится номер платежного документа по коду 1010.
'''%%@B_0''' – выгрузится сумма всех платежей.
'''%%@B_0_Doc''' – выгрузятся номер и дата платежных документов по всем кодам.
'''%%@B_0_DocNum''' – выгрузятся номера платежных документов по всем кодам.
'''%%@B_0_Text''' – выгрузится вся строка, кроме ИНН\КПП.

==== Для получения информации из SQL таблиц по ДТ и процедуре ====

* '''%%PROCESSID''' - ID ЭД-процедуры.
* '''%%EDSTAT''' - ЭД-статус ДТ в текстовом виде.
* '''%%EDSENDDATE''' - Дата подачи ДТ.
* '''%%EDSENDTIME''' - Время подачи ДТ.
* '''%%EDREGISTERDATE''' - Дата регистрации ДТ.
* '''%%EDREGISTERTIME''' - Время регистрации ДТ.
* '''%%EDLASTDATE''' - Дата выпуска ДТ.
* '''%%EDLASTTIME''' - Время выпуска ДТ.
* '''%%EDDATEBYCMN()''' - Дата произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDDATEBYCMN(CMN.11001) - дата регистрации ДТ
* '''%%EDTIMEBYCMN()''' - Время произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDTIMEBYCMN(CMN.11001) - время регистрации ДТ
* '''%%EDDATETIMEBY11309''' - Дата и время ЭД-сообщения CMN.11309 по ДТ в формате dd.mm.yyyy hh:nn:ss. При условии что сообщение CMN.11306 в статусе 3.
* '''%%EDRESULTBYCMN()''' - Возвращает Result по сообщению или нескольким через запятую.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2025-10-03T13:02:31Z

Rudometov: /* Для получения информации из SQL таблиц по ДТ и процедуре */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося '''вложенного''' блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося '''вложенного''' блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ДТ)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ДТ)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

или

'''%%START'''[BLOCK] ''Начало основного блока (товары ДТ)''
'''%%STARTSUB'''[TOVG] ''Начало вложенного блока (Описание и характеристики товара (Графа 31 ДТ))''
'''%%BLOCK\TOVG\G31_1''' ''Описание группы товаров''
'''%%BLOCK\TOVG\G31_14''' ''Марка''
'''%%BLOCK\TOVG\G31_15''' ''Артикул''
'''%%ENDSUB'''[TOVG] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для объединения ячеек в столбцах (ROWSPAN) ====

Если в столбце дописать ключевое слово '''%%JOIN''', то такой ячейки с одинаковыми значениями в столбце будут объединены.
Например, если шаблон вида

{| class="wikitable"
| %%FID1 || %%FID2
|}

формирует таблицу

{| class="wikitable"
| 1111 || aaaaa
|-
| 1111 || ббббб
|-
| 2222 || ввввв
|-
| 2222 || ггггг
|-
| 2222 || ддддд
|}

то шаблон

{| class="wikitable"
| %%FID1 %%JOIN || %%FID2
|}

cформирует

{| class="wikitable"
| rowspan="2"| 1111 || aaaaa
|-
| ббббб
|-
| rowspan="3"| 2222 || ввввв
|-
| ггггг
|-
| ддддд
|}

Применимо для печати в Excel и OpenOffice Calc.

==== Для очистки строки с вложенным блоком вместо её удаления ====

Если в любом месте главного цикла (START_END) вписать идентификатор '''%%CLEARSUBIFEMPTY''', то строка с вложенным циклом (STARTSUB_ENDSUB) не будет удаляться при пустом вложенном блоке,
а просто очистятся ячейки этого блока. Полезно, когда вложенный блок находится в одной строке с главным блоком. Обычно при пустом вложенном удаляется вся строка, вместе с главным блоком.
С таким идентификатором этого удаления можно избежать.

Применимо для печати в Excel и OpenOffice Calc.

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31.NAMETILLCOLON''' – извлекает из графы 31 наименование товара до двоеточия; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
* '''%%SUM3(''<ИМЯ_БЛОКА1>\<ИМЯ_БЛОКА2>\<ИМЯ_БЛОКА3>\<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля в блоке 3го уровня.
* '''%%31.PALCOUNT''' - количество паллет.
* '''%%31.PAKTYPE''' - тип упаковки.
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, либо в заданном вложенном блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%NUMBLOCKA(''<ИМЯ_БЛОКА>'')''' - Возвращает количество записей в заданном вложенном блоке всех товаров %%NUMBLOCK('BLOCK\TOVG')
* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)

* '''%%EXECMACROS(''<ИМЯ_МАКРОСА>'')''' - выполнит макрос, прописанный в шаблоне, после окончания выгрузки. Может находиться в любом месте шаблона.

* '''%%FORMULA([35_1]+[38_1])''' - выполнить операцию над полями (сложение, умножение, конкатекация строк и т.д.). Названия полей должны быть выделены скобками.

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

==== Функции работы с датой ====

* '''%%TEXTDATE(''<ИМЯ_ПОЛЯ_С_ДАТОЙ>'')''' - конвертирует дату в текстовый формат (21 января 2025)
* '''%%DATE(''"dd mmmm yyyy"'',''[<ИМЯ_ПОЛЯ_С_ДАТОЙ>]'')''' - конвертирует дату в произвольный заданный формат
* '''%%CURDATE''' - возвращает текущую дату в формате dd.mm.yyyy
* '''%%CURTIME''' - возвращает текущее время в формате hh:nn:ss
* '''%%DASHDATE(''<ИМЯ_ПОЛЯ_С_ДАТОЙ>'')''' - заменяет точки на дефисы в дате dd-mm-yyyy

==== Прочие функции ====

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 
* '''%%COPY(''<ИМЯ_ПОЛЯ>'', ''X'', ''Y'')''' - копировать часть данных из поля
* '''%%TRIM(''<ИМЯ_ПОЛЯ>'')''' - чистит значение поля от незначащих символов (пробелов) в начале и в конце
* '''%%LEFTPAD(''<ИМЯ_ПОЛЯ>'',''" "'',''10'')''' - Дополняет значение поля символами слева до заданной длины. По умолчанию (если второй параметр пустой) пробелами.

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_06011_LASTDATE''' - только дата ДО,
'''%%@44_!_06011_CODE''' - только код типа документа,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_!_04021_COUNT''' - количество документов в товаре с данным кодом
'''%%@44_!_04021_FORMULA(G444+G442+"ОТ"+G443)''' - выгрузится согласно формуле

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

С 2015 года так же допускается упрощенный синтаксис без _!_ в середине идентификатора.

'''%%@44_04021_TEXT'''
'''%%@44_01402_NODATE'''

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

'''%%@44_014??_NODATE''' - соберет через запятую номера документов с кодами 01401, 01402, 01403 и до 01499

Если при помощи символов ? не удается закодировать маску для документов, то можно использовать символ & и указать несколько кодов документов

'''%%@44_01191&01402_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01402
'''%%@44_01191&0140?_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01401, 01402, 01403 ... до 01409

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.
'''%%@B_1010_DocNum''' – выгрузится номер платежного документа по коду 1010.
'''%%@B_0''' – выгрузится сумма всех платежей.
'''%%@B_0_Doc''' – выгрузятся номер и дата платежных документов по всем кодам.
'''%%@B_0_DocNum''' – выгрузятся номера платежных документов по всем кодам.
'''%%@B_0_Text''' – выгрузится вся строка, кроме ИНН\КПП.

==== Для получения информации из SQL таблиц по ДТ и процедуре ====

* '''%%PROCESSID''' - ID ЭД-процедуры.
* '''%%EDSTAT''' - ЭД-статус ДТ в текстовом виде.
* '''%%EDSENDDATE''' - Дата подачи ДТ.
* '''%%EDSENDTIME''' - Время подачи ДТ.
* '''%%EDREGISTERDATE''' - Дата регистрации ДТ.
* '''%%EDREGISTERTIME''' - Время регистрации ДТ.
* '''%%EDLASTDATE''' - Дата выпуска ДТ.
* '''%%EDLASTTIME''' - Время выпуска ДТ.
* '''%%EDDATEBYCMN()''' - Дата произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDDATEBYCMN(CMN.11001) - дата регистрации ДТ
* '''%%EDTIMEBYCMN()''' - Время произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDTIMEBYCMN(CMN.11001) - время регистрации ДТ
* '''%%EDDATETIMEBY11309''' - Дата и время ЭД-сообщения CMN.11309 по ДТ в формате dd.mm.yyyy hh:nn:ss. При условии что сообщение CMN.11306 в статусе 3.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2025-10-03T12:54:50Z

Rudometov: /* Для извлечений из гр.31 ДТ */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося '''вложенного''' блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося '''вложенного''' блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ДТ)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ДТ)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

или

'''%%START'''[BLOCK] ''Начало основного блока (товары ДТ)''
'''%%STARTSUB'''[TOVG] ''Начало вложенного блока (Описание и характеристики товара (Графа 31 ДТ))''
'''%%BLOCK\TOVG\G31_1''' ''Описание группы товаров''
'''%%BLOCK\TOVG\G31_14''' ''Марка''
'''%%BLOCK\TOVG\G31_15''' ''Артикул''
'''%%ENDSUB'''[TOVG] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для объединения ячеек в столбцах (ROWSPAN) ====

Если в столбце дописать ключевое слово '''%%JOIN''', то такой ячейки с одинаковыми значениями в столбце будут объединены.
Например, если шаблон вида

{| class="wikitable"
| %%FID1 || %%FID2
|}

формирует таблицу

{| class="wikitable"
| 1111 || aaaaa
|-
| 1111 || ббббб
|-
| 2222 || ввввв
|-
| 2222 || ггггг
|-
| 2222 || ддддд
|}

то шаблон

{| class="wikitable"
| %%FID1 %%JOIN || %%FID2
|}

cформирует

{| class="wikitable"
| rowspan="2"| 1111 || aaaaa
|-
| ббббб
|-
| rowspan="3"| 2222 || ввввв
|-
| ггггг
|-
| ддддд
|}

Применимо для печати в Excel и OpenOffice Calc.

==== Для очистки строки с вложенным блоком вместо её удаления ====

Если в любом месте главного цикла (START_END) вписать идентификатор '''%%CLEARSUBIFEMPTY''', то строка с вложенным циклом (STARTSUB_ENDSUB) не будет удаляться при пустом вложенном блоке,
а просто очистятся ячейки этого блока. Полезно, когда вложенный блок находится в одной строке с главным блоком. Обычно при пустом вложенном удаляется вся строка, вместе с главным блоком.
С таким идентификатором этого удаления можно избежать.

Применимо для печати в Excel и OpenOffice Calc.

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31.NAMETILLCOLON''' – извлекает из графы 31 наименование товара до двоеточия; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
* '''%%SUM3(''<ИМЯ_БЛОКА1>\<ИМЯ_БЛОКА2>\<ИМЯ_БЛОКА3>\<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля в блоке 3го уровня.
* '''%%31.PALCOUNT''' - количество паллет.
* '''%%31.PAKTYPE''' - тип упаковки.
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, либо в заданном вложенном блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%NUMBLOCKA(''<ИМЯ_БЛОКА>'')''' - Возвращает количество записей в заданном вложенном блоке всех товаров %%NUMBLOCK('BLOCK\TOVG')
* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)

* '''%%EXECMACROS(''<ИМЯ_МАКРОСА>'')''' - выполнит макрос, прописанный в шаблоне, после окончания выгрузки. Может находиться в любом месте шаблона.

* '''%%FORMULA([35_1]+[38_1])''' - выполнить операцию над полями (сложение, умножение, конкатекация строк и т.д.). Названия полей должны быть выделены скобками.

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

==== Функции работы с датой ====

* '''%%TEXTDATE(''<ИМЯ_ПОЛЯ_С_ДАТОЙ>'')''' - конвертирует дату в текстовый формат (21 января 2025)
* '''%%DATE(''"dd mmmm yyyy"'',''[<ИМЯ_ПОЛЯ_С_ДАТОЙ>]'')''' - конвертирует дату в произвольный заданный формат
* '''%%CURDATE''' - возвращает текущую дату в формате dd.mm.yyyy
* '''%%CURTIME''' - возвращает текущее время в формате hh:nn:ss
* '''%%DASHDATE(''<ИМЯ_ПОЛЯ_С_ДАТОЙ>'')''' - заменяет точки на дефисы в дате dd-mm-yyyy

==== Прочие функции ====

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 
* '''%%COPY(''<ИМЯ_ПОЛЯ>'', ''X'', ''Y'')''' - копировать часть данных из поля
* '''%%TRIM(''<ИМЯ_ПОЛЯ>'')''' - чистит значение поля от незначащих символов (пробелов) в начале и в конце
* '''%%LEFTPAD(''<ИМЯ_ПОЛЯ>'',''" "'',''10'')''' - Дополняет значение поля символами слева до заданной длины. По умолчанию (если второй параметр пустой) пробелами.

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_06011_LASTDATE''' - только дата ДО,
'''%%@44_!_06011_CODE''' - только код типа документа,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_!_04021_COUNT''' - количество документов в товаре с данным кодом
'''%%@44_!_04021_FORMULA(G444+G442+"ОТ"+G443)''' - выгрузится согласно формуле

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

С 2015 года так же допускается упрощенный синтаксис без _!_ в середине идентификатора.

'''%%@44_04021_TEXT'''
'''%%@44_01402_NODATE'''

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

'''%%@44_014??_NODATE''' - соберет через запятую номера документов с кодами 01401, 01402, 01403 и до 01499

Если при помощи символов ? не удается закодировать маску для документов, то можно использовать символ & и указать несколько кодов документов

'''%%@44_01191&01402_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01402
'''%%@44_01191&0140?_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01401, 01402, 01403 ... до 01409

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.
'''%%@B_1010_DocNum''' – выгрузится номер платежного документа по коду 1010.
'''%%@B_0''' – выгрузится сумма всех платежей.
'''%%@B_0_Doc''' – выгрузятся номер и дата платежных документов по всем кодам.
'''%%@B_0_DocNum''' – выгрузятся номера платежных документов по всем кодам.
'''%%@B_0_Text''' – выгрузится вся строка, кроме ИНН\КПП.

==== Для получения информации из SQL таблиц по ДТ и процедуре ====

* '''%%PROCESSID''' - ID ЭД-процедуры.
* '''%%EDSTAT''' - ЭД-статус ДТ в текстовом виде.
* '''%%EDSENDDATE''' - Дата подачи ДТ.
* '''%%EDSENDTIME''' - Время подачи ДТ.
* '''%%EDREGISTERDATE''' - Дата регистрации ДТ.
* '''%%EDREGISTERTIME''' - Время регистрации ДТ.
* '''%%EDLASTDATE''' - Дата выпуска ДТ.
* '''%%EDLASTTIME''' - Время выпуска ДТ.
* '''%%EDDATEBYCMN()''' - Дата произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDDATEBYCMN(CMN.11001) - дата регистрации ДТ
* '''%%EDTIMEBYCMN()''' - Время произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDTIMEBYCMN(CMN.11001) - время регистрации ДТ

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2025-10-03T12:50:20Z

Rudometov: /* Специальные идентификаторы */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося '''вложенного''' блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося '''вложенного''' блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ДТ)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ДТ)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

или

'''%%START'''[BLOCK] ''Начало основного блока (товары ДТ)''
'''%%STARTSUB'''[TOVG] ''Начало вложенного блока (Описание и характеристики товара (Графа 31 ДТ))''
'''%%BLOCK\TOVG\G31_1''' ''Описание группы товаров''
'''%%BLOCK\TOVG\G31_14''' ''Марка''
'''%%BLOCK\TOVG\G31_15''' ''Артикул''
'''%%ENDSUB'''[TOVG] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для объединения ячеек в столбцах (ROWSPAN) ====

Если в столбце дописать ключевое слово '''%%JOIN''', то такой ячейки с одинаковыми значениями в столбце будут объединены.
Например, если шаблон вида

{| class="wikitable"
| %%FID1 || %%FID2
|}

формирует таблицу

{| class="wikitable"
| 1111 || aaaaa
|-
| 1111 || ббббб
|-
| 2222 || ввввв
|-
| 2222 || ггггг
|-
| 2222 || ддддд
|}

то шаблон

{| class="wikitable"
| %%FID1 %%JOIN || %%FID2
|}

cформирует

{| class="wikitable"
| rowspan="2"| 1111 || aaaaa
|-
| ббббб
|-
| rowspan="3"| 2222 || ввввв
|-
| ггггг
|-
| ддддд
|}

Применимо для печати в Excel и OpenOffice Calc.

==== Для очистки строки с вложенным блоком вместо её удаления ====

Если в любом месте главного цикла (START_END) вписать идентификатор '''%%CLEARSUBIFEMPTY''', то строка с вложенным циклом (STARTSUB_ENDSUB) не будет удаляться при пустом вложенном блоке,
а просто очистятся ячейки этого блока. Полезно, когда вложенный блок находится в одной строке с главным блоком. Обычно при пустом вложенном удаляется вся строка, вместе с главным блоком.
С таким идентификатором этого удаления можно избежать.

Применимо для печати в Excel и OpenOffice Calc.

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31.NAMETILLCOLON''' – извлекает из графы 31 наименование товара до двоеточия; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
* '''%%31.PALCOUNT''' - количество паллет.
* '''%%31.PAKTYPE''' - тип упаковки.
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, либо в заданном вложенном блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%NUMBLOCKA(''<ИМЯ_БЛОКА>'')''' - Возвращает количество записей в заданном вложенном блоке всех товаров %%NUMBLOCK('BLOCK\TOVG')
* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)

* '''%%EXECMACROS(''<ИМЯ_МАКРОСА>'')''' - выполнит макрос, прописанный в шаблоне, после окончания выгрузки. Может находиться в любом месте шаблона.

* '''%%FORMULA([35_1]+[38_1])''' - выполнить операцию над полями (сложение, умножение, конкатекация строк и т.д.). Названия полей должны быть выделены скобками.

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

==== Функции работы с датой ====

* '''%%TEXTDATE(''<ИМЯ_ПОЛЯ_С_ДАТОЙ>'')''' - конвертирует дату в текстовый формат (21 января 2025)
* '''%%DATE(''"dd mmmm yyyy"'',''[<ИМЯ_ПОЛЯ_С_ДАТОЙ>]'')''' - конвертирует дату в произвольный заданный формат
* '''%%CURDATE''' - возвращает текущую дату в формате dd.mm.yyyy
* '''%%CURTIME''' - возвращает текущее время в формате hh:nn:ss
* '''%%DASHDATE(''<ИМЯ_ПОЛЯ_С_ДАТОЙ>'')''' - заменяет точки на дефисы в дате dd-mm-yyyy

==== Прочие функции ====

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 
* '''%%COPY(''<ИМЯ_ПОЛЯ>'', ''X'', ''Y'')''' - копировать часть данных из поля
* '''%%TRIM(''<ИМЯ_ПОЛЯ>'')''' - чистит значение поля от незначащих символов (пробелов) в начале и в конце
* '''%%LEFTPAD(''<ИМЯ_ПОЛЯ>'',''" "'',''10'')''' - Дополняет значение поля символами слева до заданной длины. По умолчанию (если второй параметр пустой) пробелами.

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_06011_LASTDATE''' - только дата ДО,
'''%%@44_!_06011_CODE''' - только код типа документа,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_!_04021_COUNT''' - количество документов в товаре с данным кодом
'''%%@44_!_04021_FORMULA(G444+G442+"ОТ"+G443)''' - выгрузится согласно формуле

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

С 2015 года так же допускается упрощенный синтаксис без _!_ в середине идентификатора.

'''%%@44_04021_TEXT'''
'''%%@44_01402_NODATE'''

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

'''%%@44_014??_NODATE''' - соберет через запятую номера документов с кодами 01401, 01402, 01403 и до 01499

Если при помощи символов ? не удается закодировать маску для документов, то можно использовать символ & и указать несколько кодов документов

'''%%@44_01191&01402_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01402
'''%%@44_01191&0140?_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01401, 01402, 01403 ... до 01409

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.
'''%%@B_1010_DocNum''' – выгрузится номер платежного документа по коду 1010.
'''%%@B_0''' – выгрузится сумма всех платежей.
'''%%@B_0_Doc''' – выгрузятся номер и дата платежных документов по всем кодам.
'''%%@B_0_DocNum''' – выгрузятся номера платежных документов по всем кодам.
'''%%@B_0_Text''' – выгрузится вся строка, кроме ИНН\КПП.

==== Для получения информации из SQL таблиц по ДТ и процедуре ====

* '''%%PROCESSID''' - ID ЭД-процедуры.
* '''%%EDSTAT''' - ЭД-статус ДТ в текстовом виде.
* '''%%EDSENDDATE''' - Дата подачи ДТ.
* '''%%EDSENDTIME''' - Время подачи ДТ.
* '''%%EDREGISTERDATE''' - Дата регистрации ДТ.
* '''%%EDREGISTERTIME''' - Время регистрации ДТ.
* '''%%EDLASTDATE''' - Дата выпуска ДТ.
* '''%%EDLASTTIME''' - Время выпуска ДТ.
* '''%%EDDATEBYCMN()''' - Дата произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDDATEBYCMN(CMN.11001) - дата регистрации ДТ
* '''%%EDTIMEBYCMN()''' - Время произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDTIMEBYCMN(CMN.11001) - время регистрации ДТ

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2025-10-03T12:45:06Z

Rudometov:

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося '''вложенного''' блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося '''вложенного''' блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ДТ)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ДТ)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

или

'''%%START'''[BLOCK] ''Начало основного блока (товары ДТ)''
'''%%STARTSUB'''[TOVG] ''Начало вложенного блока (Описание и характеристики товара (Графа 31 ДТ))''
'''%%BLOCK\TOVG\G31_1''' ''Описание группы товаров''
'''%%BLOCK\TOVG\G31_14''' ''Марка''
'''%%BLOCK\TOVG\G31_15''' ''Артикул''
'''%%ENDSUB'''[TOVG] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для объединения ячеек в столбцах (ROWSPAN) ====

Если в столбце дописать ключевое слово '''%%JOIN''', то такой ячейки с одинаковыми значениями в столбце будут объединены.
Например, если шаблон вида

{| class="wikitable"
| %%FID1 || %%FID2
|}

формирует таблицу

{| class="wikitable"
| 1111 || aaaaa
|-
| 1111 || ббббб
|-
| 2222 || ввввв
|-
| 2222 || ггггг
|-
| 2222 || ддддд
|}

то шаблон

{| class="wikitable"
| %%FID1 %%JOIN || %%FID2
|}

cформирует

{| class="wikitable"
| rowspan="2"| 1111 || aaaaa
|-
| ббббб
|-
| rowspan="3"| 2222 || ввввв
|-
| ггггг
|-
| ддддд
|}

Применимо для печати в Excel и OpenOffice Calc.

==== Для очистки строки с вложенным блоком вместо её удаления ====

Если в любом месте главного цикла (START_END) вписать идентификатор '''%%CLEARSUBIFEMPTY''', то строка с вложенным циклом (STARTSUB_ENDSUB) не будет удаляться при пустом вложенном блоке,
а просто очистятся ячейки этого блока. Полезно, когда вложенный блок находится в одной строке с главным блоком. Обычно при пустом вложенном удаляется вся строка, вместе с главным блоком.
С таким идентификатором этого удаления можно избежать.

Применимо для печати в Excel и OpenOffice Calc.

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31.NAMETILLCOLON''' – извлекает из графы 31 наименование товара до двоеточия; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
* '''%%31.PALCOUNT''' - количество паллет.
* '''%%31.PAKTYPE''' - тип упаковки.
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)

* '''%%EXECMACROS(''<ИМЯ_МАКРОСА>'')''' - выполнит макрос, прописанный в шаблоне, после окончания выгрузки. Может находиться в любом месте шаблона.

* '''%%FORMULA([35_1]+[38_1])''' - выполнить операцию над полями (сложение, умножение, конкатекация строк и т.д.). Названия полей должны быть выделены скобками.

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

==== Функции работы с датой ====

* '''%%TEXTDATE(''<ИМЯ_ПОЛЯ_С_ДАТОЙ>'')''' - конвертирует дату в текстовый формат (21 января 2025)
* '''%%DATE(''"dd mmmm yyyy"'',''[<ИМЯ_ПОЛЯ_С_ДАТОЙ>]'')''' - конвертирует дату в произвольный заданный формат
* '''%%CURDATE''' - возвращает текущую дату в формате dd.mm.yyyy
* '''%%CURTIME''' - возвращает текущее время в формате hh:nn:ss
* '''%%DASHDATE(''<ИМЯ_ПОЛЯ_С_ДАТОЙ>'')''' - заменяет точки на дефисы в дате dd-mm-yyyy

==== Прочие функции ====

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 
* '''%%COPY(''<ИМЯ_ПОЛЯ>'', ''X'', ''Y'')''' - копировать часть данных из поля
* '''%%TRIM(''<ИМЯ_ПОЛЯ>'')''' - чистит значение поля от незначащих символов (пробелов) в начале и в конце
* '''%%EXECMACROS(''<ИМЯ_МАКРОСА>'')''' - выполняет макрос в конце выгрузки. Расположить можно в любом месте шаблона
* '''%%BLOCKCOUNT''' - Возвращает количество записей в блоке
* '''%%BLOCKNUM''' - Возвращает номер записи в главном блоке (текущий номер товара) или номер вложенного блока ('''%%TOVG\BLOCKNUM''')
* '''%%NUMBLOCK''' - Возвращает количество записей в главном блоке
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' - Возвращает количество записей в заданном блоке %%NUMBLOCK('DOG'). Либо в заданном вложенном блоке текущего товара %%NUMBLOCK('BLOCK\TOVG')
* '''%%NUMBLOCKA(''<ИМЯ_БЛОКА>'')''' - Возвращает количество записей в заданном вложенном блоке всех товаров %%NUMBLOCK('BLOCK\TOVG')
* '''%%LEFTPAD(''<ИМЯ_ПОЛЯ>'',''" "'',''10'')''' - Дополняет значение поля символами слева до заданной длины. По умолчанию (если второй параметр пустой) пробелами.

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_06011_LASTDATE''' - только дата ДО,
'''%%@44_!_06011_CODE''' - только код типа документа,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_!_04021_COUNT''' - количество документов в товаре с данным кодом
'''%%@44_!_04021_FORMULA(G444+G442+"ОТ"+G443)''' - выгрузится согласно формуле

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

С 2015 года так же допускается упрощенный синтаксис без _!_ в середине идентификатора.

'''%%@44_04021_TEXT'''
'''%%@44_01402_NODATE'''

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

'''%%@44_014??_NODATE''' - соберет через запятую номера документов с кодами 01401, 01402, 01403 и до 01499

Если при помощи символов ? не удается закодировать маску для документов, то можно использовать символ & и указать несколько кодов документов

'''%%@44_01191&01402_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01402
'''%%@44_01191&0140?_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01401, 01402, 01403 ... до 01409

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.
'''%%@B_1010_DocNum''' – выгрузится номер платежного документа по коду 1010.
'''%%@B_0''' – выгрузится сумма всех платежей.
'''%%@B_0_Doc''' – выгрузятся номер и дата платежных документов по всем кодам.
'''%%@B_0_DocNum''' – выгрузятся номера платежных документов по всем кодам.
'''%%@B_0_Text''' – выгрузится вся строка, кроме ИНН\КПП.

==== Для получения информации из SQL таблиц по ДТ и процедуре ====

* '''%%PROCESSID''' - ID ЭД-процедуры.
* '''%%EDSTAT''' - ЭД-статус ДТ в текстовом виде.
* '''%%EDSENDDATE''' - Дата подачи ДТ.
* '''%%EDSENDTIME''' - Время подачи ДТ.
* '''%%EDREGISTERDATE''' - Дата регистрации ДТ.
* '''%%EDREGISTERTIME''' - Время регистрации ДТ.
* '''%%EDLASTDATE''' - Дата выпуска ДТ.
* '''%%EDLASTTIME''' - Время выпуска ДТ.
* '''%%EDDATEBYCMN()''' - Дата произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDDATEBYCMN(CMN.11001) - дата регистрации ДТ
* '''%%EDTIMEBYCMN()''' - Время произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDTIMEBYCMN(CMN.11001) - время регистрации ДТ

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2024-09-13T11:53:10Z

Rudometov:

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося '''вложенного''' блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося '''вложенного''' блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ДТ)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ДТ)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

или

'''%%START'''[BLOCK] ''Начало основного блока (товары ДТ)''
'''%%STARTSUB'''[TOVG] ''Начало вложенного блока (Описание и характеристики товара (Графа 31 ДТ))''
'''%%BLOCK\TOVG\G31_1''' ''Описание группы товаров''
'''%%BLOCK\TOVG\G31_14''' ''Марка''
'''%%BLOCK\TOVG\G31_15''' ''Артикул''
'''%%ENDSUB'''[TOVG] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для объединения ячеек в столбцах (ROWSPAN) ====

Если в столбце дописать ключевое слово '''%%JOIN''', то такой ячейки с одинаковыми значениями в столбце будут объединены.
Например, если шаблон вида

{| class="wikitable"
| %%FID1 || %%FID2
|}

формирует таблицу

{| class="wikitable"
| 1111 || aaaaa
|-
| 1111 || ббббб
|-
| 2222 || ввввв
|-
| 2222 || ггггг
|-
| 2222 || ддддд
|}

то шаблон

{| class="wikitable"
| %%FID1 %%JOIN || %%FID2
|}

cформирует

{| class="wikitable"
| rowspan="2"| 1111 || aaaaa
|-
| ббббб
|-
| rowspan="3"| 2222 || ввввв
|-
| ггггг
|-
| ддддд
|}

Применимо для печати в Excel и OpenOffice Calc.

==== Для очистки строки с вложенным блоком вместо её удаления ====

Если в любом месте главного цикла (START_END) вписать идентификатор '''%%CLEARSUBIFEMPTY''', то строка с вложенным циклом (STARTSUB_ENDSUB) не будет удаляться при пустом вложенном блоке,
а просто очистятся ячейки этого блока. Полезно, когда вложенный блок находится в одной строке с главным блоком. Обычно при пустом вложенном удаляется вся строка, вместе с главным блоком.
С таким идентификатором этого удаления можно избежать.

Применимо для печати в Excel и OpenOffice Calc.

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31.NAMETILLCOLON''' – извлекает из графы 31 наименование товара до двоеточия; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)

* '''%%EXECMACROS(''<ИМЯ_МАКРОСА>'')''' - выполнит макрос, прописанный в шаблоне, после окончания выгрузки. Может находиться в любом месте шаблона.

* '''%%31.PALCOUNT''' - количество паллет.

* '''%%31.PAKTYPE''' - тип упаковки.

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 

* '''%%COPY(''<ИМЯ_ПОЛЯ>'', ''X'', ''Y'')''' - копировать часть данных из поля

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_06011_LASTDATE''' - только дата ДО,
'''%%@44_!_06011_CODE''' - только код типа документа,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_!_04021_COUNT''' - количество документов в товаре с данным кодом
'''%%@44_!_04021_FORMULA(G444+G442+"ОТ"+G443)''' - выгрузится согласно формуле

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

С 2015 года так же допускается упрощенный синтаксис без _!_ в середине идентификатора.

'''%%@44_04021_TEXT'''
'''%%@44_01402_NODATE'''

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

'''%%@44_014??_NODATE''' - соберет через запятую номера документов с кодами 01401, 01402, 01403 и до 01499

Если при помощи символов ? не удается закодировать маску для документов, то можно использовать символ & и указать несколько кодов документов

'''%%@44_01191&01402_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01402
'''%%@44_01191&0140?_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01401, 01402, 01403 ... до 01409

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.
'''%%@B_1010_DocNum''' – выгрузится номер платежного документа по коду 1010.
'''%%@B_0''' – выгрузится сумма всех платежей.
'''%%@B_0_Doc''' – выгрузятся номер и дата платежных документов по всем кодам.
'''%%@B_0_DocNum''' – выгрузятся номера платежных документов по всем кодам.
'''%%@B_0_Text''' – выгрузится вся строка, кроме ИНН\КПП.

==== Для получения информации из SQL таблиц по ДТ и процедуре ====

* '''%%PROCESSID''' - ID ЭД-процедуры.
* '''%%EDSTAT''' - ЭД-статус ДТ в текстовом виде.
* '''%%EDSENDDATE''' - Дата подачи ДТ.
* '''%%EDSENDTIME''' - Время подачи ДТ.
* '''%%EDREGISTERDATE''' - Дата регистрации ДТ.
* '''%%EDREGISTERTIME''' - Время регистрации ДТ.
* '''%%EDLASTDATE''' - Дата выпуска ДТ.
* '''%%EDLASTTIME''' - Время выпуска ДТ.
* '''%%EDDATEBYCMN()''' - Дата произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDDATEBYCMN(CMN.11001) - дата регистрации ДТ
* '''%%EDTIMEBYCMN()''' - Время произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDTIMEBYCMN(CMN.11001) - время регистрации ДТ

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2024-09-13T09:25:21Z

Rudometov:

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося '''вложенного''' блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося '''вложенного''' блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ДТ)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ДТ)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

или

'''%%START'''[BLOCK] ''Начало основного блока (товары ДТ)''
'''%%STARTSUB'''[TOVG] ''Начало вложенного блока (Описание и характеристики товара (Графа 31 ДТ))''
'''%%BLOCK\TOVG\G31_1''' ''Описание группы товаров''
'''%%BLOCK\TOVG\G31_14''' ''Марка''
'''%%BLOCK\TOVG\G31_15''' ''Артикул''
'''%%ENDSUB'''[TOVG] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для объединения ячеек в столбцах (ROWSPAN) ====

Если в столбце дописать ключевое слово %%JOIN, то такой ячейки с одинаковыми значениями в столбце будут объединены.
Например, если шаблон вида

{| class="wikitable"
| %%FID1 || %%FID2
|}

формирует таблицу

{| class="wikitable"
| 1111 || aaaaa
|-
| 1111 || ббббб
|-
| 2222 || ввввв
|-
| 2222 || ггггг
|-
| 2222 || ддддд
|}

то шаблон

{| class="wikitable"
| %%FID1 %%JOIN || %%FID2
|}

cформирует

{| class="wikitable"
| rowspan="2"| 1111 || aaaaa
|-
| ббббб
|-
| rowspan="3"| 2222 || ввввв
|-
| ггггг
|-
| ддддд
|}

Применимо для печати в Excel и OpenOffice Calc.

==== Для очистки строки с вложенным блоком вместо её удаления ====

Если в любом месте главного цикла (START_END) вписать идентификатор %%CLEARSUBIFEMPTY, то строка с вложенным циклом (STARTSUB_ENDSUB) не будет удаляться при пустом вложенном блоке,
а просто очистятся ячейки этого блока. Полезно, когда вложенный блок находится в одной строке с главным блоком. Обычно при пустом вложенном удаляется вся строка, вместе с главным блоком.
С таким идентификатором этого удаления можно избежать.

Применимо для печати в Excel и OpenOffice Calc.

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31.NAMETILLCOLON''' – извлекает из графы 31 наименование товара до двоеточия; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)

* '''%%EXECMACROS(''<ИМЯ_МАКРОСА>'')''' - выполнит макрос, прописанный в шаблоне, после окончания выгрузки. Может находиться в любом месте шаблона.

* '''%%31.PALCOUNT''' - количество паллет.

* '''%%31.PAKTYPE''' - тип упаковки.

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 

* '''%%COPY(''<ИМЯ_ПОЛЯ>'', ''X'', ''Y'')''' - копировать часть данных из поля

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_06011_LASTDATE''' - только дата ДО,
'''%%@44_!_06011_CODE''' - только код типа документа,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_!_04021_COUNT''' - количество документов в товаре с данным кодом
'''%%@44_!_04021_FORMULA(G444+G442+"ОТ"+G443)''' - выгрузится согласно формуле

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

С 2015 года так же допускается упрощенный синтаксис без _!_ в середине идентификатора.

'''%%@44_04021_TEXT'''
'''%%@44_01402_NODATE'''

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

'''%%@44_014??_NODATE''' - соберет через запятую номера документов с кодами 01401, 01402, 01403 и до 01499

Если при помощи символов ? не удается закодировать маску для документов, то можно использовать символ & и указать несколько кодов документов

'''%%@44_01191&01402_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01402
'''%%@44_01191&0140?_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01401, 01402, 01403 ... до 01409

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.
'''%%@B_1010_DocNum''' – выгрузится номер платежного документа по коду 1010.
'''%%@B_0''' – выгрузится сумма всех платежей.
'''%%@B_0_Doc''' – выгрузятся номер и дата платежных документов по всем кодам.
'''%%@B_0_DocNum''' – выгрузятся номера платежных документов по всем кодам.
'''%%@B_0_Text''' – выгрузится вся строка, кроме ИНН\КПП.

==== Для получения информации из SQL таблиц по ДТ и процедуре ====

* '''%%PROCESSID''' - ID ЭД-процедуры.
* '''%%EDSTAT''' - ЭД-статус ДТ в текстовом виде.
* '''%%EDSENDDATE''' - Дата подачи ДТ.
* '''%%EDSENDTIME''' - Время подачи ДТ.
* '''%%EDREGISTERDATE''' - Дата регистрации ДТ.
* '''%%EDREGISTERTIME''' - Время регистрации ДТ.
* '''%%EDLASTDATE''' - Дата выпуска ДТ.
* '''%%EDLASTTIME''' - Время выпуска ДТ.
* '''%%EDDATEBYCMN()''' - Дата произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDDATEBYCMN(CMN.11001) - дата регистрации ДТ
* '''%%EDTIMEBYCMN()''' - Время произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDTIMEBYCMN(CMN.11001) - время регистрации ДТ

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Структура SQL-таблиц ГТД

2023-02-09T09:29:48Z

Rudometov:

=Основные таблицы БД программы Альта-ГТД=

Неиспользуемые поля выделены серым, самые важные '''жирным'''.

==Таблица '''Docs''' (основное хранилище документов программы)==

{| class="standard"
!Поле
!Тип
!Описание
|-
|ID
|[int] IDENTITY(1,1)
|Автоинкрементный ключ ''(устаревший, см. GID)''
|-
|PathId
|[int]
|Ссылка на путь, т.е. поле ID с именем папки ''(устаревший, см. PathGID)''
|-
|'''DocKey'''
|[varchar](50)
|Номер документа или имя папки, для показа в списке
|-
|Dir
|[int]
|Признак типа записи, 0-документ, 10-папка. Возможно появление других служебных записей с Dir>0.
|-
|'''DocTyp'''
|[varchar](50)
|Тип документа, например 'GTD' для ГТД
|-
|DocDate
|[datetime]
|Дата из номера документа, там где оно применимо (прописано в структуре документа *.dcf)
|-
|'''ModDate'''
|[datetime]
|Дата последней модификации документа
|-
|RegDate
|[datetime]
|Дата выпуска для ГТД, проставляется вручную по кнопке "синяя печать", или при выпуске по ЭД-2 ''(устаревший)''
|-
|CrDate
|[datetime]
|Дата создания (первого сохранения) документа
|-
|GoodsNum
|[int]
|Кол-во товаров в документе, там где оно применимо (прописано в структуре документа *.dcf)
|-
|UserName
|[varchar](20)
|Имя пользователя, последним сохранявшего документ. Присваивается только если в Альте настроены внутренние имена пользователей, к имени компьютера и пользователя в смысле Windows отношения не имеет.
|-
|EDSender
|[varchar](20)
|Пользователь, отославший документ по ЭД-2. Или логин в смысле Альты, или, если нет, то имя компьютера.
|-
|Binded
|[varchar](100)
|Взаимосвязанные документы, русские имена через запятую, для показа в списке. На 100% верить нельзя, т.к. не все помещаются и не всегда обновляются. Связь считается по одинаковому номеру в пределах одной папки (ГТД+ДТС+КТС+КУТС+Опись) или по происхождению (Инвойс=>ГТД=>ЭД-Инвойс).
|-
|Status
|[varchar](10)
|Статус. В большой степени заготовка, сейчас используется только '0000000001' для обозначения регистрации синей печатью. Не путать с EdStatus!
|-
|'''Blob'''
|[image]
|Главное поле! Собственно сохраненный документ. К сожалению в виде малочитабельного бинарника, хотя слова в кодировке WIN-1251 разобрать можно (на этом строится индексация для Full Text Search).
|-
|DocSize
|[int]
|Размер поля Blob (он же размера выгруженного файла документа во внутреннем формате Альта)
|-
|SDSId
|[int]
|Код пограничного поста при "удаленном декларировании по ЭД-2". Отменено Спецификацией ЭД от 01.10.15. ''Изначально здесь была ссылка на номер СДС в смысле ЭД-1, но это тем более устарело.''
|-
|Locked
|[int]
|Значение Locked>0 признак того, что документ уже открыт другим пользователем (занят). В списке отображается желтым.
|-
|LockTime
|[datetime]
|Время, когда документ был открыт другим пользователем. Для показа в списке. Если время залочки больше суток, то считаем что это зависший компьютер и в списке желтым не отображаем.
|-
|LockUser
|[varchar](15)
|Имя пользователя, который занял документ
|-
|Comment
|[varchar](50)
|Короткий комментарий, показывается и редактируется вручную в режиме "широкого списка"
|-
|ParentId
|[int]
|Ссылка на родительский документ ''(Устаревший, см. ParentGID)'''
|-
|'''ProcessId'''
|[varchar](36)
|Номер процедуры ЭД-2, присваивается таможней в момент "открытия процедуры". Один из способов связки с таблицей EdMsgs.
|-
|'''EDStat'''
|[int]
|Статус процедуры ЭД-2. Отвечает за подсветку, "молнию" и подписи в списке документов. Подробнее см. [[Статусы документа при ЭД-2, поле Docs.EdStatus|Статусы документов ЭД-2]].
|-
|'''RegNum'''
|[varchar](25)
|Регистрационный номер ГТД, полученный из таможни по ЭД-2. Виден в режиме "широкого списка". Может использоваться в отчетах.
|-
|DocumentID
|[varchar](36)
|Уникальный номер документа, существует только для документов ЭД-2 (но не для ГТД!). При отправке в таможню не должен повторяться, поэтому при каждом сохранении создается заново. Не путать с главным ключом GID!
|-
|ArchId
|[varchar](50)
|Номер ЭД-2 архива таможни, в который последний раз отправляли документ.
|-
|ArchDocID
|[varchar](50)
|Номер документа в ЭД-2 архиве, присваивается таможней в ответном сообщении.
|-
|ArchDocumentID
|[varchar](36)
|Номер DocumentID экземпляра документа переданного в ЭД-2 архив таможни.
|-
|'''GID'''
|[uniqueidentifier] ROWGUIDCOL
|Первичный ключ, уникальный ID документа. Служит для связки с таблицами EdMsgs и *List.
|-
|ParentGID
|[uniqueidentifier]
|Ссылка на GID родительского документа. Проставляется при создании взаимосвязанного (ГТД из Инвойса, ДТС из ГТД и т.д.). Используется для показа и совместной выгрузки во внутреннем формате.
|-
|PathGID
|[uniqueidentifier]
|Указатель на папку, в которой лежит документ. Используется для структуризации списка. Папка - это такая же запись таблицы Docs, только с пустым Blob и Dir>0. По умолчанию ссылается на корневую папку с GUID(0)
|-
|TXT
|[char](3)
|Способ индексации, необходим для полнотекстового индекса. По умолчанию всегда "txt".
|-
|Thumb
|[varchar](40)
|Идентификатор сертификата ЭЦП, с которой документ был отправлен по ЭД-2. Для предотвращения отправки с подписью разных фирм в рамках одной процедуры декларирования.
|-
|Firm
|[varchar](100)
|Фирма в смысле ЭД-2, для связки с таблицей EdFirms "ЭД-2 для нескольких фирм в одной базе"
|-
|FirstDT
|[varchar](25)
|Ссылка на первичную ДТ (регистрационный номер) у ЭД-документа для признака подачи /2.
|-
|ScanID
|[varchar](36)
|ID сканированной копии документа.
|-
|Hash
|[varchar](50)
|Hash для XML-блобов.
|-
|Comment2
|[varchar](50)
|Дополнительный короткий комментарий, показывается в списке документов по настройке
[System] 
ListComment2=1
|-
|Timestamp
|[timestamp]
|Служебное поле, хранит информацию о времени последнего обновления строки таблицы. Для динамического обновления списка документов.
|}

==Таблица '''EdMsgs''' (заголовки всех сообщений ЭД-2)==

Большая часть полей соответствует одноименным тэгам XML-сообщения ЭД-2
{| class="standard"
!Поле
!Тип
!Описание
|-
|'''EnvelopeID'''
|[varchar](36)
|Идентификатор сообщения, уникальный ключ.
|-
|'''InitialEnvelopeID'''
|[varchar](36)
|Ссылка на идентификатор предыдущего сообщения. Для ответов, например при получении ошибки позволяет проследить к чему она относится.
|-
|SenderInformation
|[varchar](100)
|Имя отправителя сообщения. Обычно имеет вид "smtp://eps.customs.ru/''company_name''". Выдается таможней, прописано в настройке ЭД-2.
|-
|ReceiverInformation
|[varchar](100)
|Имя получателя сообщения. Обычно фиксированное "smtp://eps.customs.ru/gateway". Прописано в настройке ЭД-2. Для входящих сообщений от таможни SenderInformation и ReceiverInformation меняются местами.
|-
|PreparationDateTime
|[datetime]
|Время создания сообщения. По часам отправляющего компьютера, поэтому для разных поясов или летнего-зимнего времени может сильно не совпадать у входящих и исходящих сообщений.
|-
|InOutDateTime
|[datetime]
|Время приема сообщения в базу. По времени SQL-сервера. Используется для сортировки сообщений по умолчанию.
|-
|Priority
|[int]
|Используется для контроля ЭД сообщений. Сообщение на контроле - 1, снято с контроля - 0. Значение по умолчанию 4
|-
|Expiration
|[int]
|Фактически не используется, значение по умолчанию null
|-
|ConfirmationRequest
|[varchar](10)
|Фактически не используется, значение по умолчанию null
|-
|'''MessageType'''
|[varchar](10)
|Тип сообщения. Имеет вид "CMN.01234". Основное поле для понимания смысла сообщения. Все типы прописаны в "Спецификации ЭД".
|-
|'''ProccessID'''
|[varchar](36)
|Идентификатор процедуры. Объединяет сообщения относящиеся к одной ГТД (кроме самого первого, "запрос на открытие процедуры")
|-
|CustomsCode
|[varchar](8)
|Код таможенного поста, всегда 8 знаков. Служит дополнением к адресу получателя, который один на всю таможню.
|-
|ParticipantID
|[varchar](15)
|Идентификатор участника ВЭД. Служит дополнением к адресу отправителя. Выдается таможней, прописан в настройке ЭД-2.
|-
|'''Status'''
|[int]
|Статус сообщения ЭД. Позволяет определить что оно доставлено, не обработано или обработано с ошибкой. Подробнее см. [[Статусы сообщений ЭД-2, поле EdMsgs.Status|Статусы сообщений ЭД-2]]
|-
|Msg
|[image]
|Устаревшее поле. Раньше здесь хранилось тело сообщения в формате XML. Сейчас такого поля нет, а тело сообщения вынесено в связанную таблицу EDMsgsXML, которая в общем случае может находиться в другой БД - см. поле MsgDB.
|-
|DocumentID
|[varchar](50)
|Идентификатор документа внутри сообщения, уникальный.
|-
|RefDocumentID
|[varchar](50)
|Ссылка на идентификатор документа в предыдущем сообщении. В некотором роде дублирует пару EnvelopeID/InitialEnvelopeID. По идее должны присутствовать обе связки, но в сообщениях от таможни одной из них может не быть. Приходится смотреть на обе связки по "или".
|-
|'''Incoming'''
|[bit]
|Признак входящего сообщения. 0-сообщения декларанта, 1-сообщение таможенника.
|-
|DocumentName
|[varchar](50)
|Тип документа. Соответствует первому информативному тэгу XML (который обернут снаружи конвертом SOAP с тэгом <Envelope> и подписью Крипто-ПРО с тэгом <Object>). Зависит от MessageType, причем один тип документа (например <Result>) может встречаться во многих разных "CMN.XXXXX". Используется, в частности, для проверки соответствия содержимого XML одноименной XSD-схеме.
|-
|Result
|[varchar](250)
|Текст для показа в списке сообщений. Для разных типов содержит выборку из разных полей XML. Например русское название и номер ЭД-документа для сообщения "передан в ответ на запрос". Или текст ошибки для таможенного сообщения об ошибке.
|-
|'''DocGuid'''
|[uniqueidentifier]
|Служит для связки с таблицей Docs по главному ключу GID. В большинстве случаев дублирует связь по ProccessID. Но особенно важен для "запроса на открытие процедуры" (когда идентификатор процедуры еще не присвоен), и для отправки ПИ и ЭД-2 в архив (когда процедуры вообщен нет).
|-
|SoftVersion
|[varchar](20)
|Версия использованного формата XML. Регулярно меняется таможней. Первая цифра - версия "Альбома форматов", вторая "Спецификации ЭД". На момент ноября 2011 года используется "5.0.3/3.0.1".
|-
|Sender
|[varchar](15)
|Имя пользователя, либо имя компьютера, который отправил либо принял сообщение. Используется в основном техподдержкой для диагностики проблем со связью. Аналогично полю EDSender таблицы Docs.
|-
|'''MsgDB'''
|[varchar](50)
|Если XML-тело сообщения вынесено в другую БД, то в данном поле хранится имя БД, в чьей таблице EDMsgsXML оно находится. По умолчанию данное поле пусто (NULL), что означает что используется таблица EDMsgsXML самой базы ГТД.
|-
|NameDS
|[varchar](100)
|Имя подписавшего сообщение (берется из ЭЦП).
|-
|ProgVers
|[varchar](20)
|Версия программы, сформировавшей запись сообщения.
|-
|FPD
|[varbinary]
|Former Protect Data - данные о рабочем месте Альта-ГТД, на котором сформировано сообщение. Служебное поле в двоичном формате.
|-
|MainProccessID
|[varchar](36)
|Ссылка на основную процедуру с ДТ, при ответвлении сообщения о досмотре со своим ProccessID.
|}

==Таблица '''EdMsgsXML''' (тело сообщений ЭД-2)==

Данная таблица всегда есть в самой базе ГТД и связана с ''EdMsgs'' по полю ''EnvelopeID'' (связь "один к одному"). Однако, часть ЭД-сообщений (или все) могут быть вынесены в дополнительные БД на этом же SQL-сервере - см. описание поля ''EdMsgs.MsgDB'' выше и меню "Настройка / Сервер и сетевые настройки / Доп. базы для ЭД" в программе Альта-ГТД.
По умолчанию XML-тело сообщений сжимается (архивируется) для экономии места в БД, поэтому если предполагается напрямую читать XML-содержимое сообщений, то рекомендуется отключить функцию сжатия в вышеупомянутом меню Альта-ГТД, там же есть кнопка "Разжать" для уже записанных в БД сообщений (если вовремя не отключили сжатие).

{| class="standard"
!Поле
!Тип
!Описание
|-
|'''EnvelopeID'''
|[varchar](36)
|Идентификатор сообщения, уникальный ключ. Связка с EdMsgs.
|-
|'''Msg'''
|[image]
|Тело сообщения в формате XML подписанное ЭЦП и возможно сжатое - см. след. поле.
|-
|'''Zip'''
|[int]
|Признак сжатия поля Msg: 0 - нет сжатия (можно прочитать XML из поля Msg средствами SQL Server), 1 - сжатие по алгортму [http://www.zlib.net zlib] версии 1.2.3.
|}

[[Категория:Альта-ГТД]]
[[Категория:Автоматизация]]
[[Категория:ЭД-2]]

Экспорт данных в офисные приложения

2019-08-19T13:59:48Z

Rudometov:

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося '''вложенного''' блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося '''вложенного''' блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ДТ)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ДТ)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

или

'''%%START'''[BLOCK] ''Начало основного блока (товары ДТ)''
'''%%STARTSUB'''[TOVG] ''Начало вложенного блока (Описание и характеристики товара (Графа 31 ДТ))''
'''%%BLOCK\TOVG\G31_1''' ''Описание группы товаров''
'''%%BLOCK\TOVG\G31_14''' ''Марка''
'''%%BLOCK\TOVG\G31_15''' ''Артикул''
'''%%ENDSUB'''[TOVG] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для объединения ячеек в столбцах (ROWSPAN) ====

Если в столбце дописать ключевое слово %%JOIN, то такой ячейки с одинаковыми значениями в столбце будут объединены.
Например, если шаблон вида

{| class="wikitable"
| %%FID1 || %%FID2
|}

формирует таблицу

{| class="wikitable"
| 1111 || aaaaa
|-
| 1111 || ббббб
|-
| 2222 || ввввв
|-
| 2222 || ггггг
|-
| 2222 || ддддд
|}

то шаблон

{| class="wikitable"
| %%FID1 %%JOIN || %%FID2
|}

cформирует

{| class="wikitable"
| rowspan="2"| 1111 || aaaaa
|-
| ббббб
|-
| rowspan="3"| 2222 || ввввв
|-
| ггггг
|-
| ддддд
|}

Применимо для печати в Excel и OpenOffice Calc.

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31.NAMETILLCOLON''' – извлекает из графы 31 наименование товара до двоеточия; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)

* '''%%EXECMACROS(''<ИМЯ_МАКРОСА>'')''' - выполнит макрос, прописанный в шаблоне, после окончания выгрузки. Может находиться в любом месте шаблона.

* '''%%31.PALCOUNT''' - количество паллет.

* '''%%31.PAKTYPE''' - тип упаковки.

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_06011_LASTDATE''' - только дата ДО,
'''%%@44_!_06011_CODE''' - только код типа документа,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_!_04021_COUNT''' - количество документов в товаре с данным кодом
'''%%@44_!_04021_FORMULA(G444+G442+"ОТ"+G443)''' - выгрузится согласно формуле

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.
'''%%@B_1010_DocNum''' – выгрузится номер платежного документа по коду 1010.
'''%%@B_0''' – выгрузится сумма всех платежей.
'''%%@B_0_Doc''' – выгрузятся номер и дата платежных документов по всем кодам.
'''%%@B_0_DocNum''' – выгрузятся номера платежных документов по всем кодам.
'''%%@B_0_Text''' – выгрузится вся строка, кроме ИНН\КПП.

==== Для получения информации из SQL таблиц по ДТ и процедуре ====

* '''%%PROCESSID''' - ID ЭД-процедуры.
* '''%%EDSTAT''' - ЭД-статус ДТ в текстовом виде.
* '''%%EDSENDDATE''' - Дата подачи ДТ.
* '''%%EDSENDTIME''' - Время подачи ДТ.
* '''%%EDREGISTERDATE''' - Дата регистрации ДТ.
* '''%%EDREGISTERTIME''' - Время регистрации ДТ.
* '''%%EDLASTDATE''' - Дата выпуска ДТ.
* '''%%EDLASTTIME''' - Время выпуска ДТ.
* '''%%EDDATEBYCMN()''' - Дата произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDDATEBYCMN(CMN.11001) - дата регистрации ДТ
* '''%%EDTIMEBYCMN()''' - Время произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDTIMEBYCMN(CMN.11001) - время регистрации ДТ

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Структура SQL-таблиц ГТД

2019-03-11T13:11:41Z

Rudometov: /* Таблица EdMsgs (заголовки всех сообщений ЭД-2) */

=Основные таблицы БД программы Альта-ГТД=

Неиспользуемые поля выделены серым, самые важные '''жирным'''.

==Таблица '''Docs''' (основное хранилище документов программы)==

{| class="standard"
!Поле
!Тип
!Описание
|-
|ID
|[int] IDENTITY(1,1)
| Автоинкрементный ключ ''(устаревший, см. GID)''
|-
|PathId
|[int]
| Ссылка на путь, т.е. поле ID с именем папки ''(устаревший, см. PathGID)''
|-
|'''DocKey'''
|[varchar](50)
| Номер документа или имя папки, для показа в списке
|-
|Dir
|[int]
| Признак типа записи, 0-документ, 10-папка. Возможно появление других служебных записей с Dir>0.
|-
|'''DocTyp'''
|[varchar](50)
| Тип документа, например 'GTD' для ГТД
|-
|DocDate
|[datetime]
| Дата из номера документа, там где оно применимо (прописано в структуре документа *.dcf)
|-
|'''ModDate'''
|[datetime]
| Дата последней модификации документа
|-
|RegDate
|[datetime]
| Дата выпуска для ГТД, проставляется вручную по кнопке "синяя печать", или при выпуске по ЭД-2
|-
|CrDate
|[datetime]
| Дата создания (первого сохранения) документа
|-
|GoodsNum
|[int]
| Кол-во товаров в документе, там где оно применимо (прописано в структуре документа *.dcf)
|-
|UserName
|[varchar](20)
| Имя пользователя, последним сохранявшего документ. Присваивается только если в Альте настроены внутренние имена пользователей, к имени компьютера и пользователя в смысле Windows отношения не имеет.
|-
|EDSender
|[varchar](20)
| Пользователь, отославший документ по ЭД-2. Или логин в смысле Альты, или, если нет, то имя компьютера.
|-
|Binded
|[varchar](100)
| Взаимосвязанные документы, русские имена через запятую, для показа в списке. На 100% верить нельзя, т.к. не все помещаются и не всегда обновляются. Связь считается по одинаковому номеру в пределах одной папки (ГТД+ДТС+КТС+КУТС+Опись) или по происхождению (Инвойс=>ГТД=>ЭД-Инвойс).
|-
|Status
|[varchar](10)
| Статус. В большой степени заготовка, сейчас используется только '0000000001' для обозначения регистрации синей печатью. Не путать с EdStatus!
|-
|'''Blob'''
|[image]
| Главное поле! Собственно сохраненный документ. К сожалению в виде малочитабельного бинарника, хотя слова в кодировке WIN-1251 разобрать можно (на этом строится индексация для Full Text Search).
|-
|DocSize
|[int]
| Размер поля Blob (он же размера выгруженного файла документа во внутреннем формате Альта)
|-
|SDSId
|[int]
| Код пограничного поста при "удаленном декларировании по ЭД-2". Отменено Спецификацией ЭД от 01.10.15. ''Изначально здесь была ссылка на номер СДС в смысле ЭД-1, но это тем более устарело.''
|-
|Locked
|[int]
| Значение Locked>0 признак того, что документ уже открыт другим пользователем (занят). В списке отображается желтым.
|-
|LockTime
|[datetime]
| Время, когда документ был открыт другим пользователем. Для показа в списке. Если время залочки больше суток, то считаем что это зависший компьютер и в списке желтым не отображаем.
|-
|LockUser
|[varchar](15)
| Имя пользователя, который занял документ
|-
|Comment
|[varchar](50)
| Короткий комментарий, показывается и редактируется вручную в режиме "широкого списка"
|-
|ParentId
|[int]
| Ссылка на родительский документ ''(Устаревший, см. ParentGID)'''
|-
|'''ProcessId'''
|[varchar](36)
| Номер процедуры ЭД-2, присваивается таможней в момент "открытия процедуры". Один из способов связки с таблицей EdMsgs.
|-
|'''EDStat'''
|[int]
| Статус процедуры ЭД-2. Отвечает за подсветку, "молнию" и подписи в списке документов. Подробнее см. [[Статусы документа при ЭД-2, поле Docs.EdStatus|Статусы документов ЭД-2]].
|-
|'''RegNum'''
|[varchar](25)
| Регистрационный номер ГТД, полученный из таможни по ЭД-2. Виден в режиме "широкого списка". Может использоваться в отчетах.
|-
|DocumentID
|[varchar](36)
| Уникальный номер документа, существует только для документов ЭД-2 (но не для ГТД!). При отправке в таможню не должен повторяться, поэтому при каждом сохранении создается заново. Не путать с главным ключом GID!
|-
|ArchId
|[varchar](50)
| Номер ЭД-2 архива таможни, в который последний раз отправляли документ.
|-
|ArchDocID
|[varchar](50)
| Номер документа в ЭД-2 архиве, присваивается таможней в ответном сообщении.
|-
|ArchDocumentID
|[varchar](36)
| Номер DocumentID экземпляра документа переданного в ЭД-2 архив таможни.
|-
|'''GID'''
|[uniqueidentifier] ROWGUIDCOL
| Первичный ключ, уникальный ID документа. Служит для связки с таблицами EdMsgs и *List.
|-
|ParentGID
|[uniqueidentifier]
| Ссылка на GID родительского документа. Проставляется при создании взаимосвязанного (ГТД из Инвойса, ДТС из ГТД и т.д.). Используется для показа и совместной выгрузки во внутреннем формате.
|-
|PathGID
|[uniqueidentifier]
| Указатель на папку, в которой лежит документ. Используется для структуризации списка. Папка - это такая же запись таблицы Docs, только с пустым Blob и Dir>0. По умолчанию ссылается на корневую папку с GUID(0)
|-
|TXT
|[char](3)
| Способ индексации, необходим для полнотекстового индекса. По умолчанию всегда "txt".
|-
|Thumb
|[varchar](40)
| Идентификатор сертификата ЭЦП, с которой документ был отправлен по ЭД-2. Для предотвращения отправки с подписью разных фирм в рамках одной процедуры декларирования.
|-
|Firm
|[varchar](100)
| Фирма в смысле ЭД-2, для связки с таблицей EdFirms "ЭД-2 для нескольких фирм в одной базе"
|-
|FirstDT
|[varchar](25)
| Ссылка на первичную ДТ (регистрационный номер) у ЭД-документа для признака подачи /2.
|-
|ScanID
|[varchar](36)
| ID сканированной копии документа.
|-
|Hash
|[varchar](50)
| Hash для XML-блобов.
|-
|Comment2
|[varchar](50)
| Дополнительный короткий комментарий, показывается в списке документов по настройке
[System] 
ListComment2=1
|-
|Timestamp
|[timestamp]
| Служебное поле, хранит информацию о времени последнего обновления строки таблицы. Для динамического обновления списка документов.
|}

==Таблица '''EdMsgs''' (заголовки всех сообщений ЭД-2) ==

Большая часть полей соответствует одноименным тэгам XML-сообщения ЭД-2
{| class="standard"
!Поле
!Тип
!Описание
|-
|'''EnvelopeID'''
|[varchar](36)
|Идентификатор сообщения, уникальный ключ.
|-
|'''InitialEnvelopeID'''
|[varchar](36)
|Ссылка на идентификатор предыдущего сообщения. Для ответов, например при получении ошибки позволяет проследить к чему она относится.
|-
|SenderInformation
|[varchar](100)
|Имя отправителя сообщения. Обычно имеет вид "smtp://eps.customs.ru/''company_name''". Выдается таможней, прописано в настройке ЭД-2.
|-
|ReceiverInformation
|[varchar](100)
|Имя получателя сообщения. Обычно фиксированное "smtp://eps.customs.ru/gateway". Прописано в настройке ЭД-2. Для входящих сообщений от таможни SenderInformation и ReceiverInformation меняются местами.
|-
|PreparationDateTime
|[datetime]
|Время создания сообщения. По часам отправляющего компьютера, поэтому для разных поясов или летнего-зимнего времени может сильно не совпадать у входящих и исходящих сообщений.
|-
|InOutDateTime
|[datetime]
|Время приема сообщения в базу. По времени SQL-сервера. Используется для сортировки сообщений по умолчанию.
|-
|Priority
|[int]
|Фактически не используется, значение по умолчанию 4
|-
|Expiration
|[int]
|Фактически не используется, значение по умолчанию null
|-
|ConfirmationRequest
|[varchar](10)
|Фактически не используется, значение по умолчанию null
|-
|'''MessageType'''
|[varchar](10)
|Тип сообщения. Имеет вид "CMN.01234". Основное поле для понимания смысла сообщения. Все типы прописаны в "Спецификации ЭД".
|-
|'''ProccessID'''
|[varchar](36)
|Идентификатор процедуры. Объединяет сообщения относящиеся к одной ГТД (кроме самого первого, "запрос на открытие процедуры")
|-
|CustomsCode
|[varchar](8)
|Код таможенного поста, всегда 8 знаков. Служит дополнением к адресу получателя, который один на всю таможню.
|-
|ParticipantID
|[varchar](15)
|Идентификатор участника ВЭД. Служит дополнением к адресу отправителя. Выдается таможней, прописан в настройке ЭД-2.
|-
|'''Status'''
|[int]
|Статус сообщения ЭД. Позволяет определить что оно доставлено, не обработано или обработано с ошибкой. Подробнее см. [[Статусы сообщений ЭД-2, поле EdMsgs.Status|Статусы сообщений ЭД-2]]
|-
|Msg
|[image]
|Устаревшее поле. Раньше здесь хранилось тело сообщения в формате XML. Сейчас такого поля нет, а тело сообщения вынесено в связанную таблицу EDMsgsXML, которая в общем случае может находиться в другой БД - см. поле MsgDB.
|-
|DocumentID
|[varchar](50)
|Идентификатор документа внутри сообщения, уникальный.
|-
|RefDocumentID
|[varchar](50)
|Ссылка на идентификатор документа в предыдущем сообщении. В некотором роде дублирует пару EnvelopeID/InitialEnvelopeID. По идее должны присутствовать обе связки, но в сообщениях от таможни одной из них может не быть. Приходится смотреть на обе связки по "или".
|-
|'''Incoming'''
|[bit]
|Признак входящего сообщения. 0-сообщения декларанта, 1-сообщение таможенника.
|-
|DocumentName
|[varchar](50)
|Тип документа. Соответствует первому информативному тэгу XML (который обернут снаружи конвертом SOAP с тэгом <Envelope> и подписью Крипто-ПРО с тэгом <Object>). Зависит от MessageType, причем один тип документа (например <Result>) может встречаться во многих разных "CMN.XXXXX". Используется, в частности, для проверки соответствия содержимого XML одноименной XSD-схеме.
|-
|Result
|[varchar](250)
|Текст для показа в списке сообщений. Для разных типов содержит выборку из разных полей XML. Например русское название и номер ЭД-документа для сообщения "передан в ответ на запрос". Или текст ошибки для таможенного сообщения об ошибке.
|-
|'''DocGuid'''
|[uniqueidentifier]
|Служит для связки с таблицей Docs по главному ключу GID. В большинстве случаев дублирует связь по ProccessID. Но особенно важен для "запроса на открытие процедуры" (когда идентификатор процедуры еще не присвоен), и для отправки ПИ и ЭД-2 в архив (когда процедуры вообщен нет).
|-
|SoftVersion
|[varchar](20)
|Версия использованного формата XML. Регулярно меняется таможней. Первая цифра - версия "Альбома форматов", вторая "Спецификации ЭД". На момент ноября 2011 года используется "5.0.3/3.0.1".
|-
|Sender
|[varchar](15)
|Имя пользователя, либо имя компьютера, который отправил либо принял сообщение. Используется в основном техподдержкой для диагностики проблем со связью. Аналогично полю EDSender таблицы Docs.
|-
|'''MsgDB'''
|[varchar](50)
|Если XML-тело сообщения вынесено в другую БД, то в данном поле хранится имя БД, в чьей таблице EDMsgsXML оно находится. По умолчанию данное поле пусто (NULL), что означает что используется таблица EDMsgsXML самой базы ГТД.
|-
|NameDS
|[varchar](100)
|Имя подписавшего сообщение (берется из ЭЦП).
|-
|ProgVers
|[varchar](20)
|Версия программы, сформировавшей запись сообщения.
|-
|FPD
|[varbinary]
|Former Protect Data - данные о рабочем месте Альта-ГТД, на котором сформировано сообщение. Служебное поле в двоичном формате.
|-
|MainProccessID
|[varchar](36)
|Ссылка на основную процедуру с ДТ, при ответвлении сообщения о досмотре со своим ProccessID.
|}

==Таблица '''EdMsgsXML''' (тело сообщений ЭД-2) ==

Данная таблица всегда есть в самой базе ГТД и связана с ''EdMsgs'' по полю ''EnvelopeID'' (связь "один к одному"). Однако, часть ЭД-сообщений (или все) могут быть вынесены в дополнительные БД на этом же SQL-сервере - см. описание поля ''EdMsgs.MsgDB'' выше и меню "Настройка / Сервер и сетевые настройки / Доп. базы для ЭД" в программе Альта-ГТД.
По умолчанию XML-тело сообщений сжимается (архивируется) для экономии места в БД, поэтому если предполагается напрямую читать XML-содержимое сообщений, то рекомендуется отключить функцию сжатия в вышеупомянутом меню Альта-ГТД, там же есть кнопка "Разжать" для уже записанных в БД сообщений (если вовремя не отключили сжатие).

{| class="standard"
!Поле
!Тип
!Описание
|-
|'''EnvelopeID'''
|[varchar](36)
|Идентификатор сообщения, уникальный ключ. Связка с EdMsgs.
|-
|'''Msg'''
|[image]
|Тело сообщения в формате XML подписанное ЭЦП и возможно сжатое - см. след. поле.
|-
|'''Zip'''
|[int]
|Признак сжатия поля Msg: 0 - нет сжатия (можно прочитать XML из поля Msg средствами SQL Server), 1 - сжатие по алгортму [http://www.zlib.net zlib] версии 1.2.3.
|}

[[Категория:Альта-ГТД]]
[[Категория:Автоматизация]]
[[Категория:ЭД-2]]

Структура SQL-таблиц ГТД

2019-03-11T12:35:11Z

Rudometov: /* Таблица Docs (основное хранилище документов программы) */

=Основные таблицы БД программы Альта-ГТД=

Неиспользуемые поля выделены серым, самые важные '''жирным'''.

==Таблица '''Docs''' (основное хранилище документов программы)==

{| class="standard"
!Поле
!Тип
!Описание
|-
|ID
|[int] IDENTITY(1,1)
| Автоинкрементный ключ ''(устаревший, см. GID)''
|-
|PathId
|[int]
| Ссылка на путь, т.е. поле ID с именем папки ''(устаревший, см. PathGID)''
|-
|'''DocKey'''
|[varchar](50)
| Номер документа или имя папки, для показа в списке
|-
|Dir
|[int]
| Признак типа записи, 0-документ, 10-папка. Возможно появление других служебных записей с Dir>0.
|-
|'''DocTyp'''
|[varchar](50)
| Тип документа, например 'GTD' для ГТД
|-
|DocDate
|[datetime]
| Дата из номера документа, там где оно применимо (прописано в структуре документа *.dcf)
|-
|'''ModDate'''
|[datetime]
| Дата последней модификации документа
|-
|RegDate
|[datetime]
| Дата выпуска для ГТД, проставляется вручную по кнопке "синяя печать", или при выпуске по ЭД-2
|-
|CrDate
|[datetime]
| Дата создания (первого сохранения) документа
|-
|GoodsNum
|[int]
| Кол-во товаров в документе, там где оно применимо (прописано в структуре документа *.dcf)
|-
|UserName
|[varchar](20)
| Имя пользователя, последним сохранявшего документ. Присваивается только если в Альте настроены внутренние имена пользователей, к имени компьютера и пользователя в смысле Windows отношения не имеет.
|-
|EDSender
|[varchar](20)
| Пользователь, отославший документ по ЭД-2. Или логин в смысле Альты, или, если нет, то имя компьютера.
|-
|Binded
|[varchar](100)
| Взаимосвязанные документы, русские имена через запятую, для показа в списке. На 100% верить нельзя, т.к. не все помещаются и не всегда обновляются. Связь считается по одинаковому номеру в пределах одной папки (ГТД+ДТС+КТС+КУТС+Опись) или по происхождению (Инвойс=>ГТД=>ЭД-Инвойс).
|-
|Status
|[varchar](10)
| Статус. В большой степени заготовка, сейчас используется только '0000000001' для обозначения регистрации синей печатью. Не путать с EdStatus!
|-
|'''Blob'''
|[image]
| Главное поле! Собственно сохраненный документ. К сожалению в виде малочитабельного бинарника, хотя слова в кодировке WIN-1251 разобрать можно (на этом строится индексация для Full Text Search).
|-
|DocSize
|[int]
| Размер поля Blob (он же размера выгруженного файла документа во внутреннем формате Альта)
|-
|SDSId
|[int]
| Код пограничного поста при "удаленном декларировании по ЭД-2". Отменено Спецификацией ЭД от 01.10.15. ''Изначально здесь была ссылка на номер СДС в смысле ЭД-1, но это тем более устарело.''
|-
|Locked
|[int]
| Значение Locked>0 признак того, что документ уже открыт другим пользователем (занят). В списке отображается желтым.
|-
|LockTime
|[datetime]
| Время, когда документ был открыт другим пользователем. Для показа в списке. Если время залочки больше суток, то считаем что это зависший компьютер и в списке желтым не отображаем.
|-
|LockUser
|[varchar](15)
| Имя пользователя, который занял документ
|-
|Comment
|[varchar](50)
| Короткий комментарий, показывается и редактируется вручную в режиме "широкого списка"
|-
|ParentId
|[int]
| Ссылка на родительский документ ''(Устаревший, см. ParentGID)'''
|-
|'''ProcessId'''
|[varchar](36)
| Номер процедуры ЭД-2, присваивается таможней в момент "открытия процедуры". Один из способов связки с таблицей EdMsgs.
|-
|'''EDStat'''
|[int]
| Статус процедуры ЭД-2. Отвечает за подсветку, "молнию" и подписи в списке документов. Подробнее см. [[Статусы документа при ЭД-2, поле Docs.EdStatus|Статусы документов ЭД-2]].
|-
|'''RegNum'''
|[varchar](25)
| Регистрационный номер ГТД, полученный из таможни по ЭД-2. Виден в режиме "широкого списка". Может использоваться в отчетах.
|-
|DocumentID
|[varchar](36)
| Уникальный номер документа, существует только для документов ЭД-2 (но не для ГТД!). При отправке в таможню не должен повторяться, поэтому при каждом сохранении создается заново. Не путать с главным ключом GID!
|-
|ArchId
|[varchar](50)
| Номер ЭД-2 архива таможни, в который последний раз отправляли документ.
|-
|ArchDocID
|[varchar](50)
| Номер документа в ЭД-2 архиве, присваивается таможней в ответном сообщении.
|-
|ArchDocumentID
|[varchar](36)
| Номер DocumentID экземпляра документа переданного в ЭД-2 архив таможни.
|-
|'''GID'''
|[uniqueidentifier] ROWGUIDCOL
| Первичный ключ, уникальный ID документа. Служит для связки с таблицами EdMsgs и *List.
|-
|ParentGID
|[uniqueidentifier]
| Ссылка на GID родительского документа. Проставляется при создании взаимосвязанного (ГТД из Инвойса, ДТС из ГТД и т.д.). Используется для показа и совместной выгрузки во внутреннем формате.
|-
|PathGID
|[uniqueidentifier]
| Указатель на папку, в которой лежит документ. Используется для структуризации списка. Папка - это такая же запись таблицы Docs, только с пустым Blob и Dir>0. По умолчанию ссылается на корневую папку с GUID(0)
|-
|TXT
|[char](3)
| Способ индексации, необходим для полнотекстового индекса. По умолчанию всегда "txt".
|-
|Thumb
|[varchar](40)
| Идентификатор сертификата ЭЦП, с которой документ был отправлен по ЭД-2. Для предотвращения отправки с подписью разных фирм в рамках одной процедуры декларирования.
|-
|Firm
|[varchar](100)
| Фирма в смысле ЭД-2, для связки с таблицей EdFirms "ЭД-2 для нескольких фирм в одной базе"
|-
|FirstDT
|[varchar](25)
| Ссылка на первичную ДТ (регистрационный номер) у ЭД-документа для признака подачи /2.
|-
|ScanID
|[varchar](36)
| ID сканированной копии документа.
|-
|Hash
|[varchar](50)
| Hash для XML-блобов.
|-
|Comment2
|[varchar](50)
| Дополнительный короткий комментарий, показывается в списке документов по настройке
[System] 
ListComment2=1
|-
|Timestamp
|[timestamp]
| Служебное поле, хранит информацию о времени последнего обновления строки таблицы. Для динамического обновления списка документов.
|}

==Таблица '''EdMsgs''' (заголовки всех сообщений ЭД-2) ==

Большая часть полей соответствует одноименным тэгам XML-сообщения ЭД-2
{| class="standard"
!Поле
!Тип
!Описание
|-
|'''EnvelopeID'''
|[varchar](36)
|Идентификатор сообщения, уникальный ключ.
|-
|'''InitialEnvelopeID'''
|[varchar](36)
|Ссылка на идентификатор предыдущего сообщения. Для ответов, например при получении ошибки позволяет проследить к чему она относится.
|-
|SenderInformation
|[varchar](100)
|Имя отправителя сообщения. Обычно имеет вид "smtp://eps.customs.ru/''company_name''". Выдается таможней, прописано в настройке ЭД-2.
|-
|ReceiverInformation
|[varchar](100)
|Имя получателя сообщения. Обычно фиксированное "smtp://eps.customs.ru/gateway". Прописано в настройке ЭД-2. Для входящих сообщений от таможни SenderInformation и ReceiverInformation меняются местами.
|-
|PreparationDateTime
|[datetime]
|Время создания сообщения. По часам отправляющего компьютера, поэтому для разных поясов или летнего-зимнего времени может сильно не совпадать у входящих и исходящих сообщений.
|-
|InOutDateTime
|[datetime]
|Время приема сообщения в базу. По времени SQL-сервера. Используется для сортировки сообщений по умолчанию.
|-
|Priority
|[int]
|Фактически не используется, значение по умолчанию 4
|-
|Expiration
|[int]
|Фактически не используется, значение по умолчанию null
|-
|ConfirmationRequest
|[varchar](10)
|Фактически не используется, значение по умолчанию null
|-
|'''MessageType'''
|[varchar](10)
|Тип сообщения. Имеет вид "CMN.01234". Основное поле для понимания смысла сообщения. Все типы прописаны в "Спецификации ЭД".
|-
|'''ProccessID'''
|[varchar](36)
|Идентификатор процедуры. Объединяет сообщения относящиеся к одной ГТД (кроме самого первого, "запрос на открытие процедуры")
|-
|CustomsCode
|[varchar](8)
|Код таможенного поста, всегда 8 знаков. Служит дополнением к адресу получателя, который один на всю таможню.
|-
|ParticipantID
|[varchar](15)
|Идентификатор участника ВЭД. Служит дополнением к адресу отправителя. Выдается таможней, прописан в настройке ЭД-2.
|-
|'''Status'''
|[int]
|Статус сообщения ЭД. Позволяет определить что оно доставлено, не обработано или обработано с ошибкой. Подробнее см. [[Статусы сообщений ЭД-2, поле EdMsgs.Status|Статусы сообщений ЭД-2]]
|-
|Msg
|[image]
|Устаревшее поле. Раньше здесь хранилось тело сообщения в формате XML. Сейчас такого поля нет, а тело сообщения вынесено в связанную таблицу EDMsgsXML, которая в общем случае может находиться в другой БД - см. поле MsgDB.
|-
|DocumentID
|[varchar](50)
|Идентификатор документа внутри сообщения, уникальный.
|-
|RefDocumentID
|[varchar](50)
|Ссылка на идентификатор документа в предыдущем сообщении. В некотором роде дублирует пару EnvelopeID/InitialEnvelopeID. По идее должны присутствовать обе связки, но в сообщениях от таможни одной из них может не быть. Приходится смотреть на обе связки по "или".
|-
|'''Incoming'''
|[bit]
|Признак входящего сообщения. 0-сообщения декларанта, 1-сообщение таможенника.
|-
|DocumentName
|[varchar](50)
|Тип документа. Соответствует первому информативному тэгу XML (который обернут снаружи конвертом SOAP с тэгом <Envelope> и подписью Крипто-ПРО с тэгом <Object>). Зависит от MessageType, причем один тип документа (например <Result>) может встречаться во многих разных "CMN.XXXXX". Используется, в частности, для проверки соответствия содержимого XML одноименной XSD-схеме.
|-
|Result
|[varchar](250)
|Текст для показа в списке сообщений. Для разных типов содержит выборку из разных полей XML. Например русское название и номер ЭД-документа для сообщения "передан в ответ на запрос". Или текст ошибки для таможенного сообщения об ошибке.
|-
|'''DocGuid'''
|[uniqueidentifier]
|Служит для связки с таблицей Docs по главному ключу GID. В большинстве случаев дублирует связь по ProccessID. Но особенно важен для "запроса на открытие процедуры" (когда идентификатор процедуры еще не присвоен), и для отправки ПИ и ЭД-2 в архив (когда процедуры вообщен нет).
|-
|SoftVersion
|[varchar](20)
|Версия использованного формата XML. Регулярно меняется таможней. Первая цифра - версия "Альбома форматов", вторая "Спецификации ЭД". На момент ноября 2011 года используется "5.0.3/3.0.1".
|-
|Sender
|[varchar](15)
|Имя пользователя, либо имя компьютера, который отправил либо принял сообщение. Используется в основном техподдержкой для диагностики проблем со связью. Аналогично полю EDSender таблицы Docs.
|-
|'''MsgDB'''
|[varchar](50)
|Если XML-тело сообщения вынесено в другую БД, то в данном поле хранится имя БД, в чьей таблице EDMsgsXML оно находится. По умолчанию данное поле пусто (NULL), что означает что используется таблица EDMsgsXML самой базы ГТД.
|}

==Таблица '''EdMsgsXML''' (тело сообщений ЭД-2) ==

Данная таблица всегда есть в самой базе ГТД и связана с ''EdMsgs'' по полю ''EnvelopeID'' (связь "один к одному"). Однако, часть ЭД-сообщений (или все) могут быть вынесены в дополнительные БД на этом же SQL-сервере - см. описание поля ''EdMsgs.MsgDB'' выше и меню "Настройка / Сервер и сетевые настройки / Доп. базы для ЭД" в программе Альта-ГТД.
По умолчанию XML-тело сообщений сжимается (архивируется) для экономии места в БД, поэтому если предполагается напрямую читать XML-содержимое сообщений, то рекомендуется отключить функцию сжатия в вышеупомянутом меню Альта-ГТД, там же есть кнопка "Разжать" для уже записанных в БД сообщений (если вовремя не отключили сжатие).

{| class="standard"
!Поле
!Тип
!Описание
|-
|'''EnvelopeID'''
|[varchar](36)
|Идентификатор сообщения, уникальный ключ. Связка с EdMsgs.
|-
|'''Msg'''
|[image]
|Тело сообщения в формате XML подписанное ЭЦП и возможно сжатое - см. след. поле.
|-
|'''Zip'''
|[int]
|Признак сжатия поля Msg: 0 - нет сжатия (можно прочитать XML из поля Msg средствами SQL Server), 1 - сжатие по алгортму [http://www.zlib.net zlib] версии 1.2.3.
|}

[[Категория:Альта-ГТД]]
[[Категория:Автоматизация]]
[[Категория:ЭД-2]]

Экспорт данных в офисные приложения

2019-02-25T15:02:46Z

Rudometov: /* Специальные идентификаторы */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося '''вложенного''' блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося '''вложенного''' блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ДТ)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ДТ)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

или

'''%%START'''[BLOCK] ''Начало основного блока (товары ДТ)''
'''%%STARTSUB'''[TOVG] ''Начало вложенного блока (Описание и характеристики товара (Графа 31 ДТ))''
'''%%BLOCK\TOVG\G31_1''' ''Описание группы товаров''
'''%%BLOCK\TOVG\G31_14''' ''Марка''
'''%%BLOCK\TOVG\G31_15''' ''Артикул''
'''%%ENDSUB'''[TOVG] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для объединения ячеек в столбцах (ROWSPAN) ====

Если в столбце дописать ключевое слово %%JOIN, то такой ячейки с одинаковыми значениями в столбце будут объединены.
Например, если шаблон вида

{| class="wikitable"
| %%FID1 || %%FID2
|}

формирует таблицу

{| class="wikitable"
| 1111 || aaaaa
|-
| 1111 || ббббб
|-
| 2222 || ввввв
|-
| 2222 || ггггг
|-
| 2222 || ддддд
|}

то шаблон

{| class="wikitable"
| %%FID1 %%JOIN || %%FID2
|}

cформирует

{| class="wikitable"
| rowspan="2"| 1111 || aaaaa
|-
| ббббб
|-
| rowspan="3"| 2222 || ввввв
|-
| ггггг
|-
| ддддд
|}

Применимо для печати в Excel и OpenOffice Calc.

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31.NAMETILLCOLON''' – извлекает из графы 31 наименование товара до двоеточия; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)

* '''%%EXECMACROS(''<ИМЯ_МАКРОСА>'')''' - выполнит макрос, прописанный в шаблоне, после окончания выгрузки. Может находиться в любом месте шаблона.

* '''%%31.PALCOUNT''' - количество паллет.

* '''%%31.PAKTYPE''' - тип упаковки.

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_06011_LASTDATE''' - только дата ДО,
'''%%@44_!_06011_CODE''' - только код типа документа,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_!_04021_COUNT''' - количество документов в товаре с данным кодом
'''%%@44_!_04021_FORMULA(G444+G442+"ОТ"+G443)''' - выгрузится согласно формуле

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.
'''%%@B_1010_DocNum''' – выгрузится номер платежного документа по коду 1010.
'''%%@B_0''' – выгрузится сумма всех платежей.
'''%%@B_0_Doc''' – выгрузятся номер и дата платежных документов по всем кодам.
'''%%@B_0_DocNum''' – выгрузятся номера платежных документов по всем кодам.
'''%%@B_0_Text''' – выгрузится вся строка, кроме ИНН\КПП.

==== Для получения информации из SQL таблиц по ДТ и процедуре ====

* '''%%EDSTAT''' - ЭД-статус ДТ в текстовом виде.
* '''%%EDSENDDATE''' - Дата подачи ДТ.
* '''%%EDSENDTIME''' - Время подачи ДТ.
* '''%%EDREGISTERDATE''' - Дата регистрации ДТ.
* '''%%EDREGISTERTIME''' - Время регистрации ДТ.
* '''%%EDLASTDATE''' - Дата выпуска ДТ.
* '''%%EDLASTTIME''' - Время выпуска ДТ.
* '''%%PROCESSID''' - ID ЭД-процедуры.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2018-08-07T12:37:39Z

Rudometov: /* Для гр.44 ДТ или гр. "Документы 1-15" Инвойса */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося '''вложенного''' блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося '''вложенного''' блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ДТ)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ДТ)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

или

'''%%START'''[BLOCK] ''Начало основного блока (товары ДТ)''
'''%%STARTSUB'''[TOVG] ''Начало вложенного блока (Описание и характеристики товара (Графа 31 ДТ))''
'''%%BLOCK\TOVG\G31_1''' ''Описание группы товаров''
'''%%BLOCK\TOVG\G31_14''' ''Марка''
'''%%BLOCK\TOVG\G31_15''' ''Артикул''
'''%%ENDSUB'''[TOVG] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для объединения ячеек в столбцах (ROWSPAN) ====

Если в столбце дописать ключевое слово %%JOIN, то такой ячейки с одинаковыми значениями в столбце будут объединены.
Например, если шаблон вида

{| class="wikitable"
| %%FID1 || %%FID2
|}

формирует таблицу

{| class="wikitable"
| 1111 || aaaaa
|-
| 1111 || ббббб
|-
| 2222 || ввввв
|-
| 2222 || ггггг
|-
| 2222 || ддддд
|}

то шаблон

{| class="wikitable"
| %%FID1 %%JOIN || %%FID2
|}

cформирует

{| class="wikitable"
| rowspan="2"| 1111 || aaaaa
|-
| ббббб
|-
| rowspan="3"| 2222 || ввввв
|-
| ггггг
|-
| ддддд
|}

Применимо для печати в Excel и OpenOffice Calc.

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)
* '''%%EDSTAT''' - статус ЭД в текстовом виде

* '''%%EXECMACROS(''<ИМЯ_МАКРОСА>'')''' - выполнит макрос, прописанный в шаблоне, после окончания выгрузки. Может находиться в любом месте шаблона.

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_06011_LASTDATE''' - только дата ДО,
'''%%@44_!_06011_CODE''' - только код типа документа,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_!_04021_COUNT''' - количество документов в товаре с данным кодом
'''%%@44_!_04021_FORMULA(G444+G442+"ОТ"+G443)''' - выгрузится согласно формуле

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.
'''%%@B_1010_DocNum''' – выгрузится номер платежного документа по коду 1010.
'''%%@B_0''' – выгрузится сумма всех платежей.
'''%%@B_0_Doc''' – выгрузятся номер и дата платежных документов по всем кодам.
'''%%@B_0_DocNum''' – выгрузятся номера платежных документов по всем кодам.
'''%%@B_0_Text''' – выгрузится вся строка, кроме ИНН\КПП.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2017-12-01T09:07:56Z

Rudometov: /* Для графы 47 и B документа ДТ */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося '''вложенного''' блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося '''вложенного''' блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ДТ)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ДТ)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

или

'''%%START'''[BLOCK] ''Начало основного блока (товары ДТ)''
'''%%STARTSUB'''[TOVG] ''Начало вложенного блока (Описание и характеристики товара (Графа 31 ДТ))''
'''%%BLOCK\TOVG\G31_1''' ''Описание группы товаров''
'''%%BLOCK\TOVG\G31_14''' ''Марка''
'''%%BLOCK\TOVG\G31_15''' ''Артикул''
'''%%ENDSUB'''[TOVG] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)
* '''%%EDSTAT''' - статус ЭД в текстовом виде

* '''%%EXECMACROS(''<ИМЯ_МАКРОСА>'')''' - выполнит макрос, прописанный в шаблоне, после окончания выгрузки. Может находиться в любом месте шаблона.

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_06011_LASTDATE''' - только дата ДО,
'''%%@44_!_06011_CODE''' - только код типа документа,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_!_04021_COUNT''' - количество документов в товаре с данным кодом

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.
'''%%@B_1010_DocNum''' – выгрузится номер платежного документа по коду 1010.
'''%%@B_0''' – выгрузится сумма всех платежей.
'''%%@B_0_Doc''' – выгрузятся номер и дата платежных документов по всем кодам.
'''%%@B_0_DocNum''' – выгрузятся номера платежных документов по всем кодам.
'''%%@B_0_Text''' – выгрузится вся строка, кроме ИНН\КПП.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2017-08-02T10:39:48Z

Rudometov: /* Для гр.44 ДТ или гр. "Документы 1-15" Инвойса */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося '''вложенного''' блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося '''вложенного''' блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ДТ)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ДТ)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

или

'''%%START'''[BLOCK] ''Начало основного блока (товары ДТ)''
'''%%STARTSUB'''[TOVG] ''Начало вложенного блока (Описание и характеристики товара (Графа 31 ДТ))''
'''%%BLOCK\TOVG\G31_1''' ''Описание группы товаров''
'''%%BLOCK\TOVG\G31_14''' ''Марка''
'''%%BLOCK\TOVG\G31_15''' ''Артикул''
'''%%ENDSUB'''[TOVG] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)
* '''%%EDSTAT''' - статус ЭД в текстовом виде

* '''%%EXECMACROS(''<ИМЯ_МАКРОСА>'')''' - выполнит макрос, прописанный в шаблоне, после окончания выгрузки. Может находиться в любом месте шаблона.

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_06011_LASTDATE''' - только дата ДО,
'''%%@44_!_06011_CODE''' - только код типа документа,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_!_04021_COUNT''' - количество документов в товаре с данным кодом

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.
'''%%@B_1010_DocNum''' – выгрузится номер платежного документа по коду 1010.
'''%%@B_0''' – выгрузится сумма всех платежей.
'''%%@B_0_Doc''' – выгрузятся номер и дата платежных документов по всем кодам.
'''%%@B_0_DocNum''' – выгрузятся номера платежных документов по всем кодам.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2017-02-09T06:51:50Z

Rudometov: /* Для графы 47 и B документа ДТ */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося '''вложенного''' блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося '''вложенного''' блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ДТ)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ДТ)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

или

'''%%START'''[BLOCK] ''Начало основного блока (товары ДТ)''
'''%%STARTSUB'''[TOVG] ''Начало вложенного блока (Описание и характеристики товара (Графа 31 ДТ))''
'''%%BLOCK\TOVG\G31_1''' ''Описание группы товаров''
'''%%BLOCK\TOVG\G31_14''' ''Марка''
'''%%BLOCK\TOVG\G31_15''' ''Артикул''
'''%%ENDSUB'''[TOVG] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)
* '''%%EDSTAT''' - статус ЭД в текстовом виде

* '''%%EXECMACROS(''<ИМЯ_МАКРОСА>'')''' - выполнит макрос, прописанный в шаблоне, после окончания выгрузки. Может находиться в любом месте шаблона.

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_!_04021_COUNT''' - количество документов в товаре с данным кодом

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.
'''%%@B_1010_DocNum''' – выгрузится номер платежного документа по коду 1010.
'''%%@B_0''' – выгрузится сумма всех платежей.
'''%%@B_0_Doc''' – выгрузятся номер и дата платежных документов по всем кодам.
'''%%@B_0_DocNum''' – выгрузятся номера платежных документов по всем кодам.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2017-02-09T06:51:22Z

Rudometov: /* Для графы 47 и B документа ДТ */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося '''вложенного''' блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося '''вложенного''' блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ДТ)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ДТ)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

или

'''%%START'''[BLOCK] ''Начало основного блока (товары ДТ)''
'''%%STARTSUB'''[TOVG] ''Начало вложенного блока (Описание и характеристики товара (Графа 31 ДТ))''
'''%%BLOCK\TOVG\G31_1''' ''Описание группы товаров''
'''%%BLOCK\TOVG\G31_14''' ''Марка''
'''%%BLOCK\TOVG\G31_15''' ''Артикул''
'''%%ENDSUB'''[TOVG] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)
* '''%%EDSTAT''' - статус ЭД в текстовом виде

* '''%%EXECMACROS(''<ИМЯ_МАКРОСА>'')''' - выполнит макрос, прописанный в шаблоне, после окончания выгрузки. Может находиться в любом месте шаблона.

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_!_04021_COUNT''' - количество документов в товаре с данным кодом

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.
'''%%@B_1010_DocNum''' – выгрузится номер платежного документа по коду 1010.
'''%%@B_0_''' – выгрузится сумма всех платежей.
'''%%@B_0_Doc''' – выгрузятся номер и дата платежных документов по всем кодам.
'''%%@B_0_DocNum''' – выгрузятся номера платежных документов по всем кодам.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2017-02-09T06:50:55Z

Rudometov: /* Для графы 47 и B документа ДТ */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося '''вложенного''' блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося '''вложенного''' блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ДТ)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ДТ)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

или

'''%%START'''[BLOCK] ''Начало основного блока (товары ДТ)''
'''%%STARTSUB'''[TOVG] ''Начало вложенного блока (Описание и характеристики товара (Графа 31 ДТ))''
'''%%BLOCK\TOVG\G31_1''' ''Описание группы товаров''
'''%%BLOCK\TOVG\G31_14''' ''Марка''
'''%%BLOCK\TOVG\G31_15''' ''Артикул''
'''%%ENDSUB'''[TOVG] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)
* '''%%EDSTAT''' - статус ЭД в текстовом виде

* '''%%EXECMACROS(''<ИМЯ_МАКРОСА>'')''' - выполнит макрос, прописанный в шаблоне, после окончания выгрузки. Может находиться в любом месте шаблона.

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_!_04021_COUNT''' - количество документов в товаре с данным кодом

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_0_''' – выгрузится сумма всех платежей.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.
'''%%@B_0_Doc''' – выгрузятся номер и дата платежных документов по всем кодам.
'''%%@B_1010_DocNum''' – выгрузится номер платежного документа по коду 1010.
'''%%@B_0_DocNum''' – выгрузятся номера платежных документов по всем кодам.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2017-01-12T14:16:36Z

Rudometov: /* Для графы 47 и B документа ДТ */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося '''вложенного''' блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося '''вложенного''' блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ДТ)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ДТ)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

или

'''%%START'''[BLOCK] ''Начало основного блока (товары ДТ)''
'''%%STARTSUB'''[TOVG] ''Начало вложенного блока (Описание и характеристики товара (Графа 31 ДТ))''
'''%%BLOCK\TOVG\G31_1''' ''Описание группы товаров''
'''%%BLOCK\TOVG\G31_14''' ''Марка''
'''%%BLOCK\TOVG\G31_15''' ''Артикул''
'''%%ENDSUB'''[TOVG] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)
* '''%%EDSTAT''' - статус ЭД в текстовом виде

* '''%%EXECMACROS(''<ИМЯ_МАКРОСА>'')''' - выполнит макрос, прописанный в шаблоне, после окончания выгрузки. Может находиться в любом месте шаблона.

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_!_04021_COUNT''' - количество документов в товаре с данным кодом

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.
'''%%@B_1010_DocNum''' – выгрузится номер платежного документа по коду 1010.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2016-11-08T11:35:22Z

Rudometov: /* Функции */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося '''вложенного''' блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося '''вложенного''' блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ДТ)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ДТ)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

или

'''%%START'''[BLOCK] ''Начало основного блока (товары ДТ)''
'''%%STARTSUB'''[TOVG] ''Начало вложенного блока (Описание и характеристики товара (Графа 31 ДТ))''
'''%%BLOCK\TOVG\G31_1''' ''Описание группы товаров''
'''%%BLOCK\TOVG\G31_14''' ''Марка''
'''%%BLOCK\TOVG\G31_15''' ''Артикул''
'''%%ENDSUB'''[TOVG] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)
* '''%%EDSTAT''' - статус ЭД в текстовом виде

* '''%%EXECMACROS(''<ИМЯ_МАКРОСА>'')''' - выполнит макрос, прописанный в шаблоне, после окончания выгрузки. Может находиться в любом месте шаблона.

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_!_04021_COUNT''' - количество документов в товаре с данным кодом

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2016-11-08T11:34:44Z

Rudometov: /* Функции */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося '''вложенного''' блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося '''вложенного''' блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ДТ)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ДТ)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

или

'''%%START'''[BLOCK] ''Начало основного блока (товары ДТ)''
'''%%STARTSUB'''[TOVG] ''Начало вложенного блока (Описание и характеристики товара (Графа 31 ДТ))''
'''%%BLOCK\TOVG\G31_1''' ''Описание группы товаров''
'''%%BLOCK\TOVG\G31_14''' ''Марка''
'''%%BLOCK\TOVG\G31_15''' ''Артикул''
'''%%ENDSUB'''[TOVG] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)
* '''%%EDSTAT''' - статус ЭД в текстовом виде

* '''%%EXECMACROS(<ИМЯ_МАКРОСА>)''' - выполнит макрос, прописанный в шаблоне, после окончания выгрузки.

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_!_04021_COUNT''' - количество документов в товаре с данным кодом

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2016-09-29T11:53:30Z

Rudometov: /* Правила составления идентификаторов */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося '''вложенного''' блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося '''вложенного''' блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ДТ)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ДТ)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

или

'''%%START'''[BLOCK] ''Начало основного блока (товары ДТ)''
'''%%STARTSUB'''[TOVG] ''Начало вложенного блока (Описание и характеристики товара (Графа 31 ДТ))''
'''%%BLOCK\TOVG\G31_1''' ''Описание группы товаров''
'''%%BLOCK\TOVG\G31_14''' ''Марка''
'''%%BLOCK\TOVG\G31_15''' ''Артикул''
'''%%ENDSUB'''[TOVG] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)
* '''%%EDSTAT''' - статус ЭД в текстовом виде

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_!_04021_COUNT''' - количество документов в товаре с данным кодом

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2016-09-14T11:40:24Z

Rudometov: /* Функции */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося вложенного блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося вложенного блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ГТД)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ГТД)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)
* '''%%EDSTAT''' - статус ЭД в текстовом виде

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_!_04021_COUNT''' - количество документов в товаре с данным кодом

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2016-09-14T11:37:41Z

Rudometov: /* Для гр.44 ДТ или гр. "Документы 1-15" Инвойса */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося вложенного блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося вложенного блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ГТД)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ГТД)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_!_04021_COUNT''' - количество документов в товаре с данным кодом

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2016-07-25T11:34:22Z

Rudometov: /* Для графы 47 и B документа ДТ */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося вложенного блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося вложенного блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ГТД)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ГТД)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2016-07-25T11:31:50Z

Rudometov: /* Для гр.44 ДТ или гр. "Документы 1-15" Инвойса */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося вложенного блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося вложенного блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ГТД)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ГТД)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2016-02-03T08:46:13Z

Rudometov: /* Для графы 47 и B документа ДТ */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося вложенного блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося вложенного блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ГТД)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ГТД)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)

==== Обработка по условию =====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2015-06-05T12:06:44Z

Rudometov: /* Для гр.44 ДТ или гр. "Документы 1-15" Инвойса */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося вложенного блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося вложенного блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ГТД)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ГТД)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для извлечения из справочников ====

Например, нам требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 

==== Функции ====

* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)

==== Обработка по условию =====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

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

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

==== Для графы 47 и B документа ДТ ====

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2013-10-31T18:10:12Z

Rudometov: /* Правила составления идентификаторов */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося вложенного блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося вложенного блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ГТД)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ГТД)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 
Иногда возникает необходимость при печати в шаблоны получать информацию, не доступную в явном виде в документе Альта-ГТД. Например требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,ALFA2,34_1,NAME) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

Другие специальные идентификаторы: 
* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 
* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 
* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон). 
Существует возможность при выгрузке одного документа выводить в шаблон значения полей из другого, взаимосвязанного, документа. Для этого необходимо перед идентификатором добавить трехбуквенный код связанного документа через точку. Например использованный в шаблоне выгрузки для ГТД идентификатор:

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44, 47 и B документа ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 

- %%@44_!_код документа_дополнительные параметры. Примеры использования:

'''%%@44_!_06011''' – выгрузятся документы гр.44 с кодом 06011,
'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcodes''' - Выдаст все документы начинающиеся на 01* с пятизначными кодами типа документа

Документы берутся как с лицевой стороны, так и из дополнения гр.44. Так же эти переменные работают и в документе [[Инвойс]], в нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2013-04-12T11:58:06Z

Rudometov: /* Правила составления идентификаторов */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося вложенного блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося вложенного блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ГТД)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ГТД)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 
Иногда возникает необходимость при печати в шаблоны получать информацию, не доступную в явном виде в документе Альта-ГТД. Например требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,CODE,34_1,NAME17) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

Другие специальные идентификаторы: 
* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 
* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 
* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон). 
Существует возможность при выгрузке одного документа выводить в шаблон значения полей из другого, взаимосвязанного, документа. Для этого необходимо перед идентификатором добавить трехбуквенный код связанного документа через точку. Например использованный в шаблоне выгрузки для ГТД идентификатор:

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44 и 47 ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 
- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@44_!_код документа_дополнительные параметры. Примеры использования:

'''%%@44_!_06011''' – выгрузятся документы гр.44 с кодом 06011,
'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2013-04-12T11:47:35Z

Rudometov: /* Правила составления идентификаторов */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося вложенного блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося вложенного блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ГТД)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ГТД)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 
Иногда возникает необходимость при печати в шаблоны получать информацию, не доступную в явном виде в документе Альта-ГТД. Например требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,CODE,34_1,NAME17) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

Другие специальные идентификаторы: 
* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ПОЛЕ>'')''' – Выводит значение поля <ПОЛЕ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 
* '''%%IIF(''<ПОЛЕ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ПОЛЕ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ПОЛЕ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ПОЛЕ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ПОЛЕ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ПОЛЕ> данный фрагмент будет удален из шаблона. 
* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''SUMALL(''<ПОЛЕ>'')''' - сумма значений поля <ПОЛЕ> по всем документам (при выгрузке списка документов в один шаблон). 
Существует возможность при выгрузке одного документа выводить в шаблон значения полей из другого, взаимосвязанного, документа. Для этого необходимо перед идентификатором добавить трехбуквенный код связанного документа через точку. Например использованный в шаблоне выгрузки для ГТД идентификатор:

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44 и 47 ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 
- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@44_!_код документа_дополнительные параметры. Примеры использования:

'''%%@44_!_06011''' – выгрузятся документы гр.44 с кодом 06011,
'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2013-04-12T11:47:01Z

Rudometov: /* Правила составления идентификаторов */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

=== Механизм выгрузки данных ===
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ Альта-программы. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей.
Таким образом, при выполнении выгрузки программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей документа и заменяет их соответствующими значениями.
Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным.
Полный перечень идентификаторов, предназначенных для использования в шаблонах для ГТД, содержится в файле [[alta\data\gtdwin.dcf]] (файл можно открыть в любом текстовом редакторе).
Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна ГТД (в правом нижнем углу):

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

=== Правила составления идентификаторов ===
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля. 
'''%%7_1''' ''Вставить значение поля 7_1 (регистрационный номер ГТД)''
%%START[''<ИМЯ_БЛОКА>''] - начало повторяющегося блока; 
%%END[''<ИМЯ_БЛОКА>''] - конец повторяющегося блока 
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

'''%%START'''[BLOCK] %%31.NAME '''%%END'''[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров». 
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. 
Если добавить после <ИМЯ_БЛОКА> номера первого и последнего товара, то будут выгружены записи только из указанного диапазона, например:

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

%%STARTSUB[''<ИМЯ_БЛОКА>''] - начало повторяющегося вложенного блока 
%%STARTSUB[''<ИМЯ_БЛОКА>''] - конец повторяющегося вложенного блока 

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

'''%%START'''[BLOCK] ''Начало основного блока (графа 31 ГТД)''
'''%%STARTSUB'''[TXT] ''Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ГТД)''
'''%%BLOCK\TXT\TEXT''' ''Собственно, сам текст''
'''%%ENDSUB'''[TXT] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 
Иногда возникает необходимость при печати в шаблоны получать информацию, не доступную в явном виде в документе Альта-ГТД. Например требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор
%%REF[''<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>''] , где ''<CПР>'' - имя файла справочника, ''<ПОЛЕ1>'' - название поля в справочнике, по которому ищем информацию, ''<ИМЯ_ПОЛЯ>'' - поле документа, откуда извлекается информация, ''<ПОЛЕ2>'' - название поля с возвращаемым значением.

'''%%REF'''(COUNTRS,CODE,34_1,NAME17) ''Возьмем значение из графы 34 ГТД (код страны происхождения),''
''и используя его найдем наименование страны.''

Другие специальные идентификаторы: 
* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31ВСЕГОШТ''' – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»; 
* '''%%SUM(''<ИМЯ_ПОЛЯ>'')''' – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара).
Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%TOVG(''<ИМЯ_ПОЛЯ>'')''' – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%NEW_PAGE''' - разрыв страницы; 
* '''%%RATE(''<КОД_ВАЛЮТЫ>'')''' – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

'''%%RATE'''(BLOCK\DOG\PRVAL)

* '''%%LABELEDFIELD(<КОММЕНТАРИЙ>, <ПОЛЕ>)''' – Выводит значение поля <ПОЛЕ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(<ИМЯ_БЛОКА>)''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

* '''%%TNVEDTEXT''' – выводится описание кода ТНВЭД для текущего выгружаемого товара; 
* '''%%PRICESCOLOR''' – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES). 
* '''%%IIF(''<ПОЛЕ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ПОЛЕ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ПОЛЕ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ПОЛЕ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ПОЛЕ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ПОЛЕ> данный фрагмент будет удален из шаблона. 
* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''SUMALL(''<ПОЛЕ>'')''' - сумма значений поля <ПОЛЕ> по всем документам (при выгрузке списка документов в один шаблон). 
Существует возможность при выгрузке одного документа выводить в шаблон значения полей из другого, взаимосвязанного, документа. Для этого необходимо перед идентификатором добавить трехбуквенный код связанного документа через точку. Например использованный в шаблоне выгрузки для ГТД идентификатор:

%%'''INV.'''42_ZAEDINIC

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Часто количество товаров в ГТД и связанном с ней Инвойсе не совпадает. В этом случае для выгрузки в шаблон ГТД полей из инвойса можно использовать специальный вложенный блок INVDOC. То есть вложенный блок в этом случае будет представлять собой не дополнение ГТД, а товары из связанного с ней инвойса, из которых состоит соответствующий товар ГТД. Например:

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Еще один тип идентификаторов – предваряется символами %%@ и используется для граф 44 и 47 ГТД. Используется для частичной выгрузки поля. Синтаксис следующий: 
- %%@47_код вида платежа_номер столбика. Например:

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@44_!_код документа_дополнительные параметры. Примеры использования:

'''%%@44_!_06011''' – выгрузятся документы гр.44 с кодом 06011,
'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.

Документы берутся как с лицевой стороны, так и из дополнения гр.44.

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]