Описание процесса загрузки обосновывающей документации в 1С
- Консультант
Схема рабочего процесса
Более подробная схема работы скриптов по ссылке:
https://miro.com/app/board/uXjVKvMl0Kk=/
Подготовка каталогов для загрузки
Для загрузки файлов необходимо подготовить два расположения
Каталог-источник (временный) - пример \\gspr-fs1.gsp-r.ru\install\1c_exchange
Каталог-получатель (разобранный архив) - пример \\gspr-fs1.gsp-r.ru\install\1c_toir
Подготовка информационной базы
Для загрузки файлов в конкретный каталог-получатель необходимо задать путь к папке в программе EnSpace как константу (сам путь прописывается в справочнике в Справочнике Том хранения файлов)
В разделе Планирование в разделе Сервис необходимо открыть константу Том обосновывающей документации:
Далее создать или выбрать из справочника Том хранения файлов, если он был создан ранее
При заполнении элемента справочника укажите наименование и полный путь к общей папке - целевому каталогу-получателю, куда будет сохраняться разобранная по объектам документация:
Подготовка файлов для загрузки
Для загрузки файлов необходимо поместить архивы файлов в формате .zip в каталог-источник. Имя архива должно содержать рабочий год, код пункта плана и “.ОМ”.
Для подготовки каталогов необходимо подготовить реестр с указанием рабочего года обосновывающей документации, кодов пункта плана, вида обосновывающей документации, пути к файлам и их наименованиями.
Пример реестра:
После подготовки реестра необходимо воспользоваться обработкой для подготовки каталогов ГСПР к работе со скриптом (в разделе Подготовка производства - Сервис):
Обработка работает в двух режимах:
Дополнительная загрузка - режим по умолчанию, загрузка файлов в дополнение к ранее загруженным, предыдущие файлы не аннулируются
Загрузка полного комплекта - загрузка файлов взамен ранее загруженных, предыдущие файлы аннулируются и отмечаются знаком
Необходимо указать путь к файлу реестра и путь к каталогу-источнику, где архивы будут обрабатываться скриптом docs_processor.sbsl
Для удобства тестирования также предусмотрена автоматическая замена имени диска в реестре (если реестр создавался на одном ПК, а тестирование производится на другом ПК) и возможность включения тестового режима, когда создание архива по реестру с несколькими объектами ремонта ограничивается конкретным объектом
Разбор файлов и загрузка в 1С скриптом docs_processor.sbsl
Скрипт осуществляет разбор файлов в каталога-источнике, анализируя файлы в формате .zip с наименованием, содержащим год и код ПП, удаляя архивы из каталога-источника и помещая разобранные файлы в каталог-получатель.
При загрузке файлов в каталог-получатель программа формирует хэш ключевых значений по файлам и сверяет с таблицей хэша ранее полученных файлов.
Если найдены совпадения по хэшу, программа проверяет по двоичным данным соответствие старых и новых файлов:
если файлы не изменились, программа не загружает их;
если найдены изменения, программа добавляет файлы в каталог-получатель.
По итогу обработки файлов программа составит отчет (что добавилось, что нет).
Все файлы загружаются в 1С и создают записи в Справочнике Присоединенные файлы, а также Версии присоединенных файлов при наличии изменений в ранее существующих файлах.
Первая версия загруженного файла считается текущей, пока пользователем не произведено утверждение другой версии этого файла.
По итогу работы скрипта должны появиться следующие результаты:
каталог папок с файлами, разложенными в соответствии с рабочим годом, кодом пообъектного плана и датой загрузки;
хранилище путей к файлам в данном каталоге, с помощью которого пользователь сможет открывать любой файл из 1С на своем компьютере.
Ошибки. В случае, если содержимое файла не может быть передано серверу, файлы попадают в папку errors и формируется соответствующая запись в журнале. Если в дальнейшем в каталог-источник будет загружена новая версия файла, который лежит в папке errors, эта новая версия также будет помещена в данную папку. В дальнейшем для работы с папкой error используется другой скрипт, который периодически пытается отправить данные из этой папки на сервер.
Для настройки работы со скриптом разверните раздел ниже:
Необходимо установить 1С-Исполнитель. Скачать дистрибутив можно по ссылке (потребуется логин и пароль от сайта 1С):
При выборе версии главное выбирать с «_x_” в названии и для операционной системы, соответствующей Вашему компьютеру.
В скрипте docs_processor необходимо внести изменения. Откройте в любом текстовом редакторе, например, блокноте, и укажите путь к двум каталогам – источнику, откуда будут забираться файлы для разбора, в примере это gigr_files и каталогу, куда будут сохраняться файлы, разобранные по папкам, в примере это gspr_docs: 00 1
Также необходимо внести изменения в адресе сервиса, указав адрес рабочей базы 1С, к которой у Вас есть доступ
ВНИМАНИЕ! В базе должны быть подключены интернет-сервисы:
Также внесите данные по пользователю и паролю в данной базе 1С в кавычках:
В поиске компьютера находим Планировщик заданий
Выбрать Создать простую задачу, присвойте ей любое имя:
Далее устанавливаем периодичность запуска задачи:
Установите время начала выполнения задачи:
Далее устанавливаем вид действия:
Далее нужно указать путь к файлу Исполнителя 1С “executor.cmd”, выбрав его через Обзор:
а в аргументы вписать путь к скрипту «docs_processor.sbsl»:
Далее сохраните задачу и ждите времени выполнения или запустите кнопкой Выполнить.
При выполнении задачи откроется окно Исполнителя 1С
Теперь при загрузке новых файлов в каталог будет выполняться скрипт. В каталоге gspr_docs появятся папки с файлами:
В 1С в карточке аналитики плана через кнопку Еще можно перейти к присоединённым файлам:
При двойном клике по файлу его локальная копия открывается на компьютере пользователя:
Настройка работы со скриптом error_processor.sbsl
Для работы со скриптом error_processor.sbsl необходимо произвести аналогичные действия: указать каталоги, внести изменения в адрес сервиса, указать пользователя и пароль для входа, создать новую задачу в планировщике, в аргументы вписать путь к скрипту «error_processor.sbsl»/
Загрузка сметных файлов в хранилище скриптом smeta_processor.sbsl
После загрузки файлов сметной документации в 1С файлы формата ПК Гранд-смета автоматически распознаются системой и записываются в регистр Присоединённые файлы смет
Следующим шагом является запуск скрипта по обработке файлов в регистре Присоединённые файлы смет и загрузке файлов, тип которых определился как Локальная смета, в хранилище сметных файлов, где далее будут создаваться сметные расчеты - документы в 1С.
Для настройки работы со скриптом разверните раздел ниже:
Для проверки и обработки файлов с дальнейшей загрузкой в хранилище смет необходимо добаdить в планировщик задачу по запуске скрипта smeta_processor.sbsl. Необходимо произвести аналогичные действия: указать каталоги, внести изменения в адрес сервиса, указать пользователя и пароль для входа, создать новую задачу в планировщике, в аргументы вписать путь к скрипту «smeta_processor.sbsl.»
! Для обработки уже добавленных обосновывающих документов необходимо перед запуском в функциях для технического специалиста найти регистр сведений "Присоединенные файлы смет (ГСП)" и через "Еще" обновить список файлов.
Об успешном запуске будет свидетельствовать запись на экране монитора:
Далее на экране должны отобразиться обрабатываемые файлы.
На момент обработки файлы блокируются, в регистре видна пиктограмма блокировки
В случае успешного завершения обработки:
проставляется статус Обработан = Да
устанавливаются признаки Файл существует, Это XML, Это файл Гранд-сметы,
определяется тип сметы - Локальная или Объектная смета, Ценник, Калькуляция, Разделительная ведомость, Сводка затрат
В случае ошибки обработки:
в столбце ошибок проставляется галочка
Текст ошибки записывается в регистр:
Файлы с типом Локальная смета автоматически загружаются в хранилище сметных файлов, где запускается их дальнейшая обработка:
Загрузка файлов в ручном режиме
Для загрузки файлов объекта в ручном режиме, на вкладке Основное необходимо нажать на кнопку “Открыть список файлов”.
Далее открывается окно файлов объекта. Для удобного просмотра файлов есть возможность фильтровать их, выбирая необходимый Вид файла.
Файл может быть аннулирован, это показывает наличие отметки.
Новые файлы можно загрузить по кнопке “Загрузить файлы”.
В окне загрузки Организация, Подразделение, Объект и Рабочий Год заполняются автоматически.
Для добавления файлов необходимо нажать на гиперссылку “Добавить файлы из каталога” и выбрать необходимую папку с файлами. После загрузки файлы отобразятся в табличной части.
Вид файла можно выбрать из списка или создать новый и, нажав кнопку “Установить вид файла”, присвоить его загруженным документам.
Для каждого файла можно установить флажок (файл будет отмечен галочкой) для дальнейшего добавления выбранных файлов в архив.
Можно за раз установить или убрать флажки у всех файлов с помощью соответствующих кнопок.
Обязательна к заполнению папка для архивов. Это папка (том) в сетевом каталоге, куда во временное хранилище сохранится созданный из выбранных файлов архив и будет использован для дальнейшей загрузки файлов.
После создания архива с файлами, будет выдано сообщение: “Обработка файлов завершена!
Создан архив [название архива] в папке [полный путь (том+путь)]”.
Загрузка документов будет произведена скриптом в соответствии с расписанием. Информацию о расписании Вы можете уточнить у системного администратора.
Отчеты
См. разделы базы знаний:
Статистические отчеты по загрузке обосновывающей документации
https://en-space.atlassian.net/wiki/spaces/smeta2/pages/318242817