Содержание

1.     Введение.. 3

1.1.     Назначение и структура документа. 3

1.2.     Перечень сокращений. 3

2.     Общая часть.. 5

3.     Экспорт документов.. 6

3.1.     Порядок действий при ручном экспорте. 6

3.2.     Порядок действий при автоматическом экспорте. 11

3.3.     Настройка форматов экспорта. 13

3.3.1.      Настройка системных констант. 14

3.3.2.      Настройка шаблонов экспорта. 15

4.     Импорт документов.. 16

4.1.     Порядок действий при ручном импорте. 16

4.2.     Порядок действий при автоматическом импорте. 23

4.3.     Настройка форматов импорта. 25

4.3.1.      Настройка системных констант. 25

4.3.2.      Настройка шаблонов импорта. 26

ЛИСТ РЕГИСТРАЦИИ ИЗМЕНЕНИЙ.. 28

1.          Введение

1.1.   Назначение и структура документа

Настоящий документ является инструкцией по экспорту/импорту документов прикладного программного обеспечения «Автоматизированная система электронного документооборота Федерального казначейства (СЭД)» (далее – ППО «СЭД»). Здесь подробно описан алгоритм ручного и автоматического экспорта документов, а также алгоритм ручного и автоматического импорта на примере электронного документа «Расходное расписание». Приведены настройки шаблонов экспорта/импорта и автопроцедур, отвечающих за автоматическое исполнение экспорта/импорта.

Данный документ предназначен для пользователей ППО «СЭД».

Структура инструкции изложена в таблице 1.

Таблица                1. Структура документа

1.2.   Перечень сокращений

Таблица                2. Перечень сокращений

2.          Общая часть

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

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

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

Импорт данных из ППО «СЭД» реализован по встроенному алгоритму, по которому внешний текстовый файл распознается ППО «СЭД», обрабатывается и преобразовывается в системные данные.

При этом формат и структура файла однозначно определены и пригодны для распознавания и обработки, как внешними системами, так и ППО «СЭД».

В документе приведено описание настройки и использования экспорта и импорта документа, как в ручном, так и автоматическом режиме. Для примера выбран электронный документ «Расходное расписание». Все остальные электронные документы ППО «СЭД» экспортируются и импортируются аналогично приведенному примеру.

3.          Экспорт документов

В ППО «СЭД» реализованы следующие типы экспорта документов:

–      «Ручной» (командой контекстного меню из списка документов);

–      «Автоматический» (при помощи автопроцедуры).

Алгоритм ручного экспорта:

–      Определить вид документа и тип ручного экспорта.

Например, если необходимо экспортировать принятый ЭД «Расходное расписание» на АРМ органа ФК, нужно выбрать тип импорта «Экспорт расходного расписания на ТОФК-сервере в формате ФК со сменой статуса».

Если необходимо экспортировать ЭД «Расходное расписание», созданный на АРМ СЭД, нужно выбрать тип импорта «Экспорт расходного расписания с любого статуса».

–      Настроить выбранный шаблон экспорта (указать директорию выгрузки файла экспорта).

–      В списке документов выбранного типа выбрать по правой кнопке мыши команду контекстного меню «Экспорт».

–      Выбрать настроенный шаблон экспорта в открывшейся форме. При необходимости отредактировать параметры шаблона по кнопке .

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

–      Запустить процедуру экспорта и проверить результаты экспортирования.

Алгоритм автоматического экспорта:

–      Определить вид документа и тип автоматического экспорта.

Например, если необходимо экспортировать принятый ЭД «Расходное расписание» на АРМ органа ФК, нужно выбрать тип импорта «Экспорт расходного расписания на ТОФК-сервере в формате ФК со сменой статуса (автоматический)».

–      Настроить выбранный шаблон автоматического экспорта (указать директорию выгрузки файла экспорта).

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

Например, если необходимо автоматически экспортировать принятый ЭД «Расходное расписание» с АРМ Сервер-ТОФК до ПБС, нужно найти автопроцедуру с названием «{Расходные расписания}100-Экспорт на промежуточном сервере».

Если необходимо автоматически экспортировать все ЭД «Расходное расписание», нужно найти автопроцедуру с названием «{Расходные расписания} 100-Экспорт».

–      Настроить условие запуска автопроцедуры экспорта – периодический или по изменению документа.

–      Включить автопроцедуру, если автопроцедура выключена.

–      Перезапустить автопроцедуры.

Для примера рассмотрим экспорт документа «Расходное расписание». Выберем шаблон «Экспорт расходного расписания на ТОФК-сервере в формате ФК со сменой статуса» и рассмотрим автоматический и ручной экспорт документа в части настройки и использования.

3.1.   Порядок действий при ручном экспорте

1. Настройка шаблона ручного экспорта. Выберите пункт главного меню «Справочники – Системные – Настройки экспорта – Шаблоны экспорта». Откроется форма «Шаблоны экспорта», содержащая все шаблоны экспорта документов и справочников ППО «СЭД».

Рисунок          1. Список всех шаблонов экспорта

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

Рисунок                2. Список шаблонов экспорта по фильтру

Примечание.   Шаблоны автоматического экспорта отмечены комментарием в скобках «Автоматический», все остальные шаблоны являются шаблонами ручного экспорта.

b.  Выделите курсором название шаблона и перейдите к редактированию его параметров при помощи кнопки . Откроется форма «Шаблон экспорта».

Рисунок    3. Параметры шаблона ручного экспорта

c.  В форме «Шаблон экспорта» выберите параметр «Путь к файлам экспорта», нажмите кнопку . Откроется форма редактирования значения параметра.

Рисунок          4. Редактирование параметра шаблона ручного экспорта

d.  Введите в поле «Администраторское значение» или поле «Пользовательское значение» путь к директории, в которую ППО будет экспортировать файлы документов, и нажмите кнопку «Ok».

Примечание.   Поле «Администраторское значение» доступно для редактирования только для пользователей, авторизовавшихся в ППО под администраторским профилем. Остальным пользователям необходимо заполнять поле «Пользовательское значение».

e.  Остальные параметры оставьте без изменений.

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

Внимание!       После обновления версии ППО «СЭД» пользовательские настройки пути выгрузки «Путь к файлу экспорта для секретных организаций» автоматически будут изменены на настройки по умолчанию.

1. Сохраните настройки при помощи кнопки «Ok».
2. Вызов процедуры ручного экспорта. Перейдите из главного меню к списку документов, из которого необходимо экспортировать документ («Документы – Распорядительные – Расходные расписания». Откроется форма списка документов «Расходные расписания»).

g.  Выберите необходимый для экспорта документ в статусе «Принят» и команду контекстного меню «Эскпорт/импорт – Экспорт». Откроется форма выбора шаблона экспорта.

h.  Выберите настроенный в пункте 1.2 шаблон «Экспорт расходного расписания на ТОФК-сервере со сменой статуса». При необходимости отредактируйте параметры шаблона по кнопке . Нажмите кнопку «Ok». Откроется форма выбора директории экспорта.

Рисунок                      5. Окно «Выбор директории экспорта»

1. В окне выбора директории в поле «В директорию по умолчанию» указан путь, заданный в настройках шаблона в поле «Администраторское значение» (см. шаг 1.4). В поле «В пользовательскую директорию» указан путь, заданный в настройках шаблона в поле «Пользовательское значение». При необходимости вы можете изменить путь к директории выгрузки при помощи кнопки . Выберите нужный тип выгрузки и нажмите «Ok».
2. По окончании импорта ППО «СЭД» выдаст результаты в информационном окне. Статус экспортированного документа примет значение «Экспортирован».
3. Настройка шаблона автоматического экспорта. Выберите пункт главного меню «Справочники – Системные – Настройки экспорта – Шаблоны экспорта». Откроется форма «Шаблоны экспорта».

3.2.   Порядок действий при автоматическом экспорте

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

Настройка шаблона автоматического экспорта производится точно так же, как и настройка шаблона ручного импорта (см. пункт 3.1, шаг 1.1 – 1.6.).

Примечание.   Следует выбирать шаблоны импорта, отмеченные комментарием «Автоматический». В нашем примере будем использовать шаблон «Экспорт принятого расходного расписания на ТОФК-сервере со сменой статуса (автоматический)».

1. Настройка действия автопроцедуры. Выберите пункт главного меню «Сервис – Автопроцедуры – Настройка автопроцедур». Откроется форма «Схема автопроцедур».

Рисунок                6. Автопроцедуры экспорта

1. Найдите автопроцедуру, выполняющую экспорт расходного расписания, в нашем примере «{Расходные расписания} 100 – Экспорт», и нажмите кнопку  на панели инструментов. Откроется форма свойств автопроцедуры.

Рисунок          7. Свойства автопроцедуры экспорта

m.Выберите тип запуска автопроцедуры в поле «Тип запуска». Рекомендуется указывать следующие типы запуска:

2.1.1.           «Периодический» – экспорт документа выполняется по истечении заданного интервала времени. Например, можно настроить экспорт всех расходных расписаний каждые двадцать минут. Период выполнения задается при помощи кнопки «Изменить». В открывшемся окне введите значение в секундах.

Рисунок          8. Редактирование периода запуска автопроцедуры экспорта

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

Рисунок     9. Окно «Условия запуска»

n.  В окне «Условия запуска» в поле «Имя схемы» выберите схему документа, для которого настраиваете автопроцедуру.

Схема документа – это возможные статусы, принимаемые данным документом на АРМ СЭД. Например, если необходимо настроить экспорт ЭД «Расходное расписание», следует выбирать схему «DocRRSheme», где «RR» – маркер документа «Расходное расписание». Если настраивается экспорт ЭД «Реестр Расходных расписаний», выбирается схема «DocRRRSheme». Как правило, маркеры и схемы документов подробно описываются в проектной документации (соответствующих ТЗ)

Автопроцедура экспорта запускается при достижении документом статусов, отмеченных в списке «Итоговые статусы» флагом . Например, необходимо автоматически экспортировать принятые на АРМ серверной части ППО «СЭД» с АРМ клиентской части ППО «СЭД» расходные расписания во внешнюю директорию. Расходное расписание, принятое и распознанное на сервере СЭД принимает статус «*Принят+». Таким образом, для автоматического экспорта таких расходных расписаний следует отметить флагом название статуса «*Принят+». Как только расходное расписание примет статус «*Принят+», автопроцедура экспортирует данный документ, инициируя смену статуса на «Экспортирован».

• o.  Сохраните изменения с помощью кнопки «Ok».

p.  Если автопроцедура выключена (стоит символ ), включите ее при помощи кнопки  на панели инструментов.

q.  Перезапустите автопроцедуры для вступления в силу изменений. Для этого выберите команду главного меню «Сервис – Автопроцедуры – Останов автопроцедур», и затем меню «Сервис – Автопроцедуры – Запуск автопроцедур».

3.3.   Настройка форматов экспорта

Структурированные файлы документов, выгружаемые из ППО «СЭД» при экспорте, имеют определенный формат выгрузки.

Настройка форматов экспорта документов задается в:

–      системных константах форматов экспорта данного типа документа (см. пункт 3.3.1);

–      настройках шаблона экспорта данного документа (см. пункт 3.3.2).

В первую очередь ППО «СЭД» использует значение, проставленное в параметре шаблона экспорта «Формат выгрузки документов». Если в шаблоне не указан формат выгрузки, то ППО «СЭД» обращается к системной константе форматов экспорта для данного типа документа. Если в системной константе введены значения в полях «Администраторское значение» или «Пользовательское значение», ППО «СЭД» использует указанные в этих полях форматы. При этом поле «Пользовательское значение» перекрывает значение поля «Администраторское значение». Если данные поля в системной константе не заполнены, то ППО «СЭД» обращается к значению поля «Системное значение» и выгружает документы в указанном в этом поле формате.

3.3.1.          Настройка системных констант

Для настройки системных констант форматов выгрузки следует выбрать пункт меню «Справочники – Системные – Параметры – Системные константы». В открывшемся окне следует при помощи области фильтров найти требуемую для настройки константу.

Для просмотра параметров константы следует нажать кнопку  на панели инструментов. Откроется форма «Системная константа».

Рисунок    10. Настройка системной константы

По умолчанию используется формат выгрузки, указанный в поле «Системное значение». Для перекрытия данного значения следует ввести название формата в поле «Администраторское значение» или «Пользовательское значение» и сохранить изменения нажатием кнопки «Ok» или кнопки «Применить».

Примечание.     Поле «Администраторское значение» доступно для редактирования только под администраторским профилем на АРМ серверной части ППО «СЭД».

3.3.2.          Настройка шаблонов экспорта

Для настройки формата экспорта в шаблоне экспорта документа следует в настройках шаблона выбрать параметр «Формат выгрузки документов» и нажать кнопку .

Рисунок                      11. Настройка формата экспорта в шаблоне экспорта

В открывшейся форме «Параметр экспорта» следует ввести название формата в поле «Администраторское значение» или поле «Пользовательское значение» и сохранить изменения нажатием кнопки «Ok» или кнопки «Применить».

Примечание.     Поле «Администраторское значение» доступно для редактирования только под администраторским профилем на АРМ серверной части ППО «СЭД».

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

4.          Импорт документов

В ППО «СЭД» реализованы следующие типы импорта документов:

–      «Ручной» (командой контекстного меню из списка документов);

–      «Автоматический» (при помощи автопроцедуры).

Алгоритм ручного импорта:

–      Определить класс документа и шаблон ручного импорта. Например, если необходимо импортировать ЭД «Расходное расписание» на АРМ органа ФК от РБС, нужно выбрать тип импорта «Импорт расходного расписания из формата ФК», шаблон импорта «РУЧН. {от распорядителя средств органу ФК} импорт расходного расписания».

–      Настроить выбранный шаблон импорта (указать директорию загрузки файла импорта).

–      В списке документов выбранного типа правой кнопкой мыши вызвать контекстное меню и выбрать команду «Импорт».

–      Выбрать настроенный шаблон импорта в открывшейся форме. При необходимости выбрать другой шаблон импорта.

–      Выбрать режим импорта. Если нужно импортировать несколько файлов, отметить найденные ППО «СЭД» файлы для загрузки.

–      Запустить процедуру импорта и проверить результаты импортирования.

Алгоритм автоматического импорта:

–      Определить класс документа и шаблон автоматического импорта. Например, если необходимо импортировать ЭД «Расходное расписание» на АРМ органа ФК от РБС, нужно выбрать тип импорта «Импорт расходного расписания из формата ФК», шаблон импорта «АВТО. {от распорядителя средств органу ФК} импорт расходного расписания».

–      Настроить выбранный шаблон автоматического импорта (указать директорию загрузки файла импорта).

–      Найти автопроцедуру, выполняющую импорт данного класса документов по выбранному шаблону. Например, если необходимо автоматически импортировать ЭД «Расходное расписание» на АРМ органа ФК от РБС, нужно найти автопроцедуру с названием «{Расходное расписание} 005-Импорт расходных расписаний от распорядителя средств органу ФК».

–      Настроить период запуска автопроцедуры импорта.

–      Включить автопроцедуру, если автопроцедура выключена.

–      Перезапустить автопроцедуры.

Для примера рассмотрим автоматический и ручной импорт документа «Расходное расписание» на АРМ СЭД, начиная с настройки шаблона и заканчивая импортом файлов.

4.1.   Порядок действий при ручном импорте

1. Настройка шаблона ручного импорта. Выберите пункт главного меню «Справочники – Системные – Настройки импорта – Шаблоны импорта». Откроется список «Шаблоны импорта» (см. рисунок 12), содержащий все шаблоны импорта документов и справочников ППО «СЭД».

Примечание.      Шаблоны автоматического импорта содержат в своем названии пометку «АВТО», все остальные шаблоны являются шаблонами ручного импорта.

Рисунок                12. Список всех шаблонов импорта

1. Найдите нужный шаблон импорта. Для этого введите вручную поисковое значение в поле «Название шаблона» или нажмите кнопку  в поле «Тип импорта, выберите тип импорта из списка (в нашем примере – «Импорт расходного расписания из формата ФК», см. рисунок 13) и нажмите кнопку «Ok».

Рисунок                13. Выбор типа импорта для фильтра шаблонов

В результате в окне «Шаблоны импорта» отфильтруются соответствующие шаблоны (см. рисунок 14).

Рисунок            14. Список отфильтрованных шаблонов импорта

1. Выберите из списка шаблон, который требуется настроить (в нашем примере – шаблон «РУЧН. {от распорядителя средств органу ФК} импорт расходного расписания»). Для редактирования параметров шаблона импорта дважды щелкните мышью по выбранной записи или нажмите кнопку . Откроется форма «Шаблон импорта» (см. рисунок 15).

Рисунок    15. Форма «Шаблон импорта». Список «Параметры шаблона»

1. В форме «Шаблон импорта» выберите из списка «Параметры шаблона» параметр, подлежащий редактированию, и дважды щелкните по нему левой кнопкой мыши» или нажмите кнопку . Откроется форма редактирования значения выбранного параметра «Параметр импорта» (см. рисунок 16).

Рисунок    16. Редактирование параметра шаблона ручного импорта

u.  Для изменения значения параметра по умолчанию (поле «Значение по умолчанию») следует указать в поле «Администраторское значение» или в поле «Пользовательское значение» новое значение параметра и нажать кнопку  «Ok».

Примечание.   Поле «Администраторское значение» доступно для редактирования только на серверной части ППО «СЭД» пользователям, вошедшим в ППО под администраторским профилем. Остальным пользователям для изменения значения параметра по умолчанию доступно поле «Пользовательское значение».

В соответствии с описанным выше порядком пользователь при необходимости может настроить такие параметры как:

–      «Директория с импортируемыми файлами» – путь к директории, в которую помещаются файлы, предназначенные для импорта в ППО «СЭД». В случае использования нескольких директорий импорта следует перечислить пути к ним через точку с запятой (например: D:\SED\IMP1;D:\SED\IMP2).

–      «Архивная директория» – путь к директории, в которую будут помещаться файлы документов после успешного импортирования в ППО «СЭД».

–      «Архивная директория с ошибочными файлами» – путь к директории, в которую будут помещаться файлы документов в случае возникновения ошибок во время процедуры импорта (документы, не принятые ППО «СЭД»).

–      «Маска файлов» – маска для названий импортируем