Алгоритм загрузки документов через внешнюю обработку

Статья описывает алгоритм работы внешней обработки СБИС после нажатия кнопки "Загрузить в 1С" в одном из реестров раздела Полученные. Заголовки разделов содержат название формы и название функции. Уровень вложенности раздела говорит о том, что текущая функция вызывается из функции, расположенной на уровень выше.

ФормаГлавноеОкно: ЗагрузитьВ1С

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

Документ_Шаблон: ЗагрузитьДокументыВ1С

1. Перебирает список отмеченных записей
2. Для каждой записи вызывает функцию ПодготовитьСтруктуруДокумента из формы текущего раздела и получает полную структуру пакета документов.
3. Для каждого вложения из структуры пакета проверяет возможность загрузки (функция ЗаполнитьДанныеДляЗагрузкиПоУмолчанию)
4. Если вложение можно загрузить, то рассчитывает вес вложения (по весу определяется порядок загрузки вложений)
5. Формирует упорядоченный состав пакета, в котором вложения лежат в том порядке, в котором должны загружаться
6. Для каждого вложения из упорядоченного пакета определяет форму для создания документа по типу документа 1С, в который будет загружаться вложение
7. Передает вложение в дальнейшую обработку (функция СоздатьДокумент)

Раздел_[Название раздела]_Шаблон: ПодготовитьСтруктуруДокумента

1. В зависимости от раздела вызывает метод формирующий структуру пакета:
   1. ПодготовитьСтруктуруДокумента1С - на основании документов 1С
   2. ПодготовитьСтруктуруДокументаСБИС - на основании XML файлов (при загрузке вызывается данная функция)
2. Передает в дальнейшую обработку запись из списка

РаботаСДокументами1С: ПодготовитьСтруктуруДокументаСБИС

1. Для каждого вложения пакета получает xml, добавляет его в структуру вложения.
2. При наличии xslt по типу и версии вложения применяет его к полученному xml-файлу.
3. Получает структуру файла, добавляет ее в структуру вложения.
4. Ищет связанные документы 1С по идентификатору пакета и вложения, добавляет их в структуру вложения.

РаботаСДокументами1С: ЗаполнитьДанныеДляЗагрузкиПоУмолчанию

1. Проверяет наличие файла настроек для загрузки вложения.
2. Определяет тип документа 1С, в который будет загружаться вложение.
3. Ищет организацию из вложения в справочнике организаций.
4. Ищет контрагента из вложения в справочнике контрагентов.
5. Проверяет, вся ли номенклатура сопоставлена.

Документ_[Тип загружаемого документа 1С]: СоздатьДокумент

1. Если никакой специфики загрузки для данного типа документа 1С нет, то передает обработку в форму Документ_Шаблон.

Данную форму и функцию можно переопределить в обработке "ВнешниеФункции_Клиент.epf" для реализации своего алгоритма загрузки определенного типа документа.

Документ_Шаблон: СоздатьДокумент

1. Вызывает функцию заполнения данных документа (ЗаполнитьДанныеДокумента1С).
2. Записывает статус и идентификаторы пакета и вложения для созданного документа.

Документ_Шаблон: ЗаполнитьДанныеДокумента1С

1. Вызывает функцию формирования структуры данных документа (ЗаполнитьДаннымиСтруктурыФайлаСтруктуруДокумента).
2. Вызывает функцию создания документа 1С по структуре данных (СоздатьДокументИзСтруктуры).
3. Ищет пользовательскую форму для данного типа документа (Документ_[Тип загружаемого документа 1С]) с функцией "ДопРасчетыПриЗагрузке" и при наличии вызывает ее. В данной функции обычно производятся какие-то расчеты, не связанные с загрузкой данных из файла, а связанные непосредственно с самим документом 1С. Например, при заведении документа в 1С вручную при выборе номенклатуры заполняются сразу несколько полей в строке табличной части (например, % скидки, производитель и т.д.). В функции ДопРасчетыПриЗагрузке можно перебрать строки загруженного документа и для каждой строки вызвать тот же обработчик, что вызывается при ручном вводе номенклатуры, таким образом заполнятся все данные, которые не были загружены из файла, но должны быть заполнены в документе.

Документ_Шаблон: ЗаполнитьДаннымиСтруктурыФайлаСтруктуруДокумента

1. Перебирает узлы файла настроек для загрузки документа и заполняет данные в структуре.

Документ_Шаблон: СоздатьДокументИзСтруктуры

1. Перебирает поля структуры и записывает значения в одноименные реквизиты документа 1С.