Прикладной блок «Импорт файла в документ»
Contents
Блок является устаревшим и оставлен для совместимости с предыдущими версиями системы.
Назначение. Блок «Импорт файла в документ» предназначен для импорта содержимого файлов на диске в существующие или новые версии документов системы DIRECTUM. При выполнении блок может импортировать содержимое только одного файла в одну версию существующего документа. Чтобы импортировать содержимое нескольких файлов, блок необходимо использовать несколько раз. Чтобы создать новый документ из файла на диске, следует использовать другие блоки типового маршрута.
Базовый блок – «Сценарий».
Свойства, унаследованные от базового блока:
Имя |
Заголовок |
Тип |
Отличия от свойств базового блока |
Name |
Наименование |
Строка (Константа) |
По умолчанию имеет значение Импорт файла в существующий эл. документ |
Link |
Ссылка |
Строка (Константа) |
Доступное |
Comment |
Примечание |
Строка (Константа) |
Доступное |
Script |
Вычисление |
Строка (Вычисление) |
Скрытое |
Дополнительные свойства:
Имя |
Заголовок |
Тип |
Описание |
FileName |
Имя файла |
Строка (Константа или параметр) |
Полное имя импортируемого файла. Обязательное |
EDocument |
Документ |
Документ (Константа или параметр) |
Документ, в который будет импортироваться файл FileName. Обязательное |
VersionNumber |
Номер версии |
Целое число (Константа или параметр) |
Номер версии документа EDocument, в которую будет импортироваться файл FileName. Если не указано или указано значение 0, то файл импортируется в новую версию документа |
Note |
Примечание |
Строка (Константа или параметр) |
Примечание к изменяемой или создаваемой версии документа EDocument. Если не указано, то примечание останется без изменений для существующей версии или будет подобрано автоматически для новой версии документа. |
Результаты выполнения: в результате выполнения блока возвращается одно из значений:
Код |
Наименование |
Примечание |
I |
Успешно импортировано |
Файл FileName успешно импортирован в документ EDocument |
F |
Файл не найден |
Файл, указанный в свойстве FileName, не найден |
D |
Документ не определен |
Документ, указанный в свойстве EDocument, не найден (не задано свойство или документ был удален) |
B |
Документ экспортирован с блокировкой |
Документ EDocument был экспортирован с блокировкой и импорт невозможен |
V |
Некорректный номер версии |
Версия документа, указанная в свойстве VersionNumber, не найдена |
A |
Документ зашифрован |
Документ зашифрован, и служба Workflow не может изменять документ |
S |
Версия подписана |
Версия документа, в которую была попытка импортировать содержимое файла, уже подписана и её нельзя изменить. |
Описание. При выполнении блока «Импорт файла в документ» последовательно проверяются условия:
| • | наличие импортируемого файла FileName и документа EDocument; |
| • | отсутствие шифрования документа; |
| • | отсутствие экспорта документа с блокировкой; |
| • | существование версии VersionNumber, в которую будет производиться импорт файла, если импорт производится в существующую версию; |
| • | отсутствие ЭП на версии, в которую будет производиться импорт файла. |
В качестве имени импортируемого файла может передаваться как сетевое имя (в этом случае пользователь, от имени которого запущена служба Workflow, должен обладать правами на чтение из сетевого ресурса), так и локальное (при указании локального имени будет происходить обращение к локальным ресурсам сервера, на котором запущена служба Workflow).
Если документ нельзя изменять, так как он сейчас редактируется, то содержимое файла импортируется в документ после его освобождения. Служба Workflow будет пытаться выполнить импорт при каждой итерации обработки блока до тех пор, пока документ не освободится.
Блок не проверяет формат импортируемых файлов (отсутствуют проверки на допустимые расширения файлов). Это расширяет возможности использования блока, но требует дополнительного контроля над соответствием форматов файла и документа при его использовании.
Блок не контролирует размер импортируемых файлов. Поэтому его можно использовать для импорта больших документов в файловые хранилища, но необходимо следить за размером импортируемых документов на SQL-сервер.
Если все условия выполнены, то содержимое файла импортируется в указанный документ. В случае возникновения исключительных ситуаций (ошибок) во время выполнения блока, он завершится с соответствующим результатом (см. Результаты выполнения) и содержимое файла не импортируется.
Если примечание для версии не указано и файл импортируется в существующую версию документа, то примечание остается неизменным. Если примечание не указано и файл импортируется в новую версию, то автоматически формируется примечание вида «Версия N», где N – номер созданной версии.
В случае успешного импорта документа в систему DIRECTUM, автором новой версии и автором изменений при просмотре истории будет указан пользователь IS-Builder System User (System) – пользователь, от имени которого производятся изменения в системе при работе службы Workflow.
Подробнее см. раздел «Пример использования блока «Импорт файла в документ».
| © Компания DIRECTUM, 2018 | Сообщество пользователей DIRECTUM |