Прикладной блок «Создание документа из файла»
Contents
Блок является устаревшим и оставлен для совместимости с предыдущими версиями системы.
Назначение. Блок «Создание документа из файла» предназначен для создания нового документа в системе 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). |
Подробнее см. раздел «Пример использования блока «Создание документа из файла».
| © Компания DIRECTUM, 2018 | Сообщество пользователей DIRECTUM |