Справочники > Типовые маршруты > Прикладные блоки типовых маршрутов > Группа «Интеграция с файловой системой» >

Прикладной блок «Создание эл. документа из файла»

Предыдущий раздел В начало Следующий раздел

Назначение. Блок «Создание эл. документа из файла» предназначен для создания нового электронного документа в системе DIRECTUM из файла на диске.

Базовый блок - «Сценарий».

Свойства, унаследованные от базового блока:

Имя

Заголовок

Тип

Отличия от свойств базового блока

Name

Наименование

Строка (Константа)

По умолчанию имеет значение «Создание электронного документа из файла»

Link

Ссылка

Строка (Константа)

Доступное

Comment

Примечание

Строка (Константа)

Доступное

Script

Вычисление

Строка (Вычисление)

Скрытое

Дополнительные свойства:

Имя

Заголовок

Тип

Описание

FileName

Имя файла

Строка (Константа или параметр)

Полное имя импортируемого файла. Обязательное

Author

Автор

Пользователь (Константа или параметр)

Пользователь, который будет указан как автор создаваемого электронного документа.

EDocKind

Вид электронного документа

Запись справочника «Виды электронных документов» (Константа или параметр)

Вид электронного документа, с которым будет создан электронный документ.

Обязательное

CreatedEDoc

Созданный электронный документ

Строка (Константа)

Имя параметра типа «Электронный документ», в который будет записана информация о созданном электронном документе

Результаты выполнения. В результате выполнения блока возвращается одно из следующих значений:

Код

Наименование

Примечание

I

Успешно импортировано

Файлы успешно импортированы в новый электронный документы в системе DIRECTUM

E

Не задано приложение-редактор

Расширение импортируемого файла не ассоциировано ни с одним приложением-редактором в системе DIRECTUM

R

Обязательные реквизиты не заполнены

Обязательные реквизиты в карточке электронного документа не были заполнены

F

Файл не найден

Файл, указанный в свойстве FileName не найден

Описание:

· при выполнении блока «Создание электронного документа из файла» проверяется наличие файла, указанного в свойстве FileName. Если файл существует, то для него определяется его приложение редактор по расширению (если импортируется файл в формате ESD, то расширение берется из информации о файле). Если приложение-редактор определено, то происходит импорт документа в систему DIRECTUM. В случае удачного импорта блок завершается с результатом «Импортировано», иначе завершается с результатом, соответствующим произошедшей ошибке (см. Результаты выполнения);
· тип карточки создаваемого электронного документа определяется исходя из указанного вида. Если для выбранного вида электронного документа не задан тип карточки, то необходимо задать хотя бы один тип карточки, иначе данный вид электронных документов нельзя будет использовать в системе, и выполнение блока будет прерываться с генерацией соответствующего исключения. В том случае, если задано несколько типов карточки, то будет использоваться первый из списка в табличной части справочника «Виды электронных документов»;
· при использовании данного блока должны применяться типы карточек электронных документов, в которых нет дополнительных обязательных реквизитов, заполняемых вручную. В противном случае блок будет заканчиваться с результатом «Обязательные реквизиты не заполнены»;
· блок не контролирует размер импортируемых файлов. Поэтому его можно использовать для импорта больших документов в файловые хранилища, но необходимо следить за размером импортируемых документов на SQL-сервер. Необходимо помнить, что при выполнении импорта большого файла в рамках выполнения типового маршрута возможна приостановка выполнения всех остальных задач ввиду загруженности службы Workflow передачей большого объема данных. Поэтому не рекомендуется импортировать большие файлы с помощью данного блока. Если же вам все-таки необходимо импортировать  большие файлы, то может понадобиться увеличить время, отводимое службе Workflow на обработку одной задачи, так как иначе задача может прекратиться по причине истечения времени;
· при импорте файлов в формате ESD импортируются и значения реквизитов исходного файла (при использовании формата ESD передаются значения реквизитов Организация, Номер документа и Дата документа). Так же создаваемому документу присваивается наименование исходного документа;
· если для используемого типа карточки настроено правило формирования наименования, то для импортируемых документов будет так же применено это правило. Если необходимо, чтобы наименование формировалось из наименования файла, то нужно использовать тип карточки без автоматического формирования наименования;
· в используемых типах карточек электронных документов не должно быть вычислений, вызывающих интерактивных (требующих действий пользователя) диалогов или окон, так как они будут отображаться на компьютере, где установлена служба Workflow. Это может привести к остановке выполнения типового маршрута, где используется данный блок;
· если необходимо использовать созданный электронный документ на последующих этапах выполнения типового маршрута, то надо определить свойство Созданный электронный документ. В нем необходимо указать наименование параметра с типом «Электронный документ», в который будет сохранена информация о созданном документе;
· если электронный документ был создан, то в качестве его автора будет указан пользователь, заданный в свойстве Автор. Если это свойство не было определено, то автором будет указан пользователь IS-Builder System User (System). В истории документа всегда будет указан пользователь IS-Builder System User (System).