Библиотека интеграции с 1С:Документооборотом
3.1. Перенос объектов из файла поставки в конфигурацию
3.2. Настройка перенесенных объектов
3.2.1 Определяемый тип «ИнтеграцияС1СДокументооборотВсеСсылкиПереопределяемый»
3.2.2 Команда «ИнтеграцияС1Сдокументооборот»
3.2.3 Команда «ИнтеграцияС1СдокументооборотСоздатьБизнесПроцесс»
3.2.4 Команда «ИнтеграцияС1СдокументооборотСоздатьПроцессСогласования»
3.2.5 Команда «ИнтеграцияС1СДокументооборотСоздатьПисьмо»
3.2.6 Команда «ИнтеграцияС1СДокументооборотПрисоединенныеФайлы»
3.2.7 Определяемый тип «ИнтеграцияС1СДокументооборотДокументыОбъектыПереопределяемый»
3.2.8 Определяемый тип «ИнтеграцияС1СДокументооборотСправочникиОбъектыПереопределяемый»
3.2.9 Подписка «ИнтеграцияС1СДокументооборотОбработкаЗаполненияСправочники»
3.2.10 Подписка «ИнтеграцияС1СДокументооборотОбработкаЗаполненияДокументы»
3.2.11 Подписка «ИнтеграцияС1СДокументооборотПередЗаписьюДокумента»
3.2.12 Подписка «ИнтеграцияС1СДокументооборотПередЗаписьюСправочника»
3.2.13 План обмена «ИнтеграцияС1СДокументооборотомПереопределяемый»
3.2.14 Формы интегрируемых объектов
3.2.15 Работа регламентного задания в модели сервиса
3.2.16 Общий модуль «ОбщегоНазначенияПереопределяемый»
3.2.17 Общий модуль «ОбщегоНазначенияКлиентПереопределяемый»
3.2.18 Общий модуль «ПодсистемыКонфигурацииПереопределяемый»
3.2.19 Общий модуль «РегламентныеЗаданияПереопределяемый».
3.2.20 Общий модуль «УправлениеПечатьюПереопределяемый»
3.2.22 Регистр сведений НастройкиАвторизацииВ1Сдокументообороте
3.2.23 Подключение к «1С:Документообороту» при начале работы системы
3.2.24 Взаимодействие с подсистемой БСП «Присоединенные файлы»
4. Настройка и использование подсистемы при разработке конфигурации..
4.1. Настройка интерфейса пользователя
4.2 Настройка присоединения печатных форм
4.4. Настройка регламентных заданий
5. Обновление версии библиотеки
6. Пользовательская документация
Предисловие для технического писателя
Интеграция с конфигурацией «1С:Документооборот 8»
Публикация веб-сервиса «1С:Документооборота»
Настройки авторизации в «1С:Документообороте»
Правила интеграции с «1С:Документооборотом»
Использование средств бесшовной интеграции
Работа с процессами и задачами «1С:Документооборота»
Хранение файлов в «1С:Документообороте»
Работа со связанными документами
Получение навигационных ссылок на объекты «1С:Документооборота»
1. Введение
«Библиотека интеграции с 1С:Документооборотом» (далее – БИД) предоставляет возможность бесшовной интеграции прикладных решений на платформе «1С:Предприятие 8» с программой «1С:Документооборот 8». Использование БИД позволяет, в частности:
■ Работать с данными «1С:Документооборота» из интерфейса прикладного решения;
■ Использовать возможности «1С:Документооборота» по организации бизнес-процессов;
■ Использовать почтовый клиент «1С:Документооборота» и вести переписку по объектам прикладного решения;
■ Использовать «1С:Документооборот» как файловое хранилище;
■ Вести учет трудозатрат из интерфейса прикладного решения.
Демонстрационная конфигурация «Библиотека интеграции с 1С:Документооборотом» не является законченным с предметной точки зрения прикладным решением и предназначена лишь для ознакомления с возможностями и способами использования библиотеки.
Для взаимодействия с «1С:Документооборотом» из среды прикладного решения БИД использует веб-сервис «1С:Документооборота» DMService.
2. Состав библиотеки
Библиотека создана на основе «Библиотеки стандартных подсистем» (БСП) версии 3 и использует функционал подсистем БСП:
■ Базовая функциональность,
■ Дополнительные отчеты и обработки,
■ Дополнительные реквизиты и сведения,
■ Печать,
■ Регламентные задания,
■ Файловые функции,
■ Электронная подпись.
При наличии в составе прикладного решения подсистемы БСП «Присоединенные файлы» ее можно интегрировать с собственными механизмами БИД, но отсутствие этой подсистемы на работоспособность БИД не влияет.
Библиотека содержит также собственную подсистему «Интеграция с 1С:Документооборотом», объекты которой в ходе внедрения переносятся в прикладное решение.
При обновлении БИД, как правило, достаточно обновить объекты подсистемы «Интеграция с 1С:Документооборотом». Повторное внесение изменений в объекты интегрируемой конфигурации не требуется. Случаи, когда это все-таки необходимо, описываются в файле UpdateDMIL.htm, входящем в состав поставки.
3. Внедрение библиотеки
Внедрить библиотеку можно в любую конфигурацию на технологической платформе «1С:Предприятие 8.3». Версия платформы должна быть не ниже 8.3.14, режим совместимости – отключен. Для внедрения в конфигурации, предназначенные для работы в режиме совместимости с ранними версиями платформы, следует использовать Библиотеку предыдущих версий.
Сложность внедрения зависит от того, разработано ли прикладное решение на основе БСП и является ли версия БСП, лежащая в основе прикладного решения, актуальной. Внедрение библиотеки в прикладные решения на основе БСП устаревших редакций связано с некоторыми сложностями. Описание дополнительных изменений для таких конфигураций приведено в Приложении 1.
Если в прикладном решении отсутствуют перечисленные выше подсистемы БСП (см. выше «Состав библиотеки»), то перед внедрением БИД их следует включить в прикладное решение согласно инструкции по внедрению БСП.
Внедрение библиотеки состоит из двух шагов:
1. Перенос объектов библиотеки из файла поставки в конфигурацию.
2. Настройка перенесенных объектов.
3.1. Перенос объектов из файла поставки в конфигурацию
Для переноса объектов библиотеки в интегрируемую конфигурацию выполните следующие действия:
1. В режиме Конфигуратор выполните команду Конфигурация – Сравнить, объединить с конфигурацией из файла...
2. В открывшемся окне выберите файл поставки библиотеки и согласитесь с предложением о постановке на поддержку.
3. В окне сравнения и объединения конфигураций снимите все флажки и отметьте переносимые объекты с помощью команды Действия – Отметить по подсистемам файла.
4. В дереве подсистем выберите подсистему «Интеграция с 1С:Документооборотом» и нажмите Установить.
5. Отметьте флажком эту же подсистему в окне сравнения и объединения конфигураций.
6. Выберите режим объединения Взять из файла и нажмите Выполнить.
7. В окне со списком зависимых объектов нажмите Продолжить (объекты демонстрационной конфигурации, связанные с переносимыми объектами БИД, переносить не нужно).
После этого объекты метаданных библиотеки перенесены в конфигурацию, но еще не настроены. Второй шаг внедрения – настройка перенесенных объектов.
3.2. Настройка перенесенных объектов
Перед настройкой перенесенных объектов библиотеки следует принять такие решения:
■ Какие объекты метаданных интегрируемой конфигурации требуют бесшовной интеграции с объектами «1С:Документооборота»;
■ На основании каких объектов нужно будет создавать исходящие письма и запускать бизнес-процессы;
■ Какие объекты интегрируемой конфигурации будут создаваться и заполняться на основании объектов «1С:Документооборота»;
■ Для каких объектов интегрируемой конфигурации присоединенные файлы будут храниться в «1С:Документообороте»;
■ В формах каких объектов понадобятся команды хронометража.
В общем случае изменения следует вносить только в объекты метаданных с префиксом «Переопределяемый» в конце названия.
3.2.1 Определяемый тип «ИнтеграцияС1СДокументооборотВсеСсылкиПереопределяемый»
Тип параметра этой команды определяет, какие объекты интегрируемой конфигурации учувствуют в бесшовной интеграции.
Добавьте ссылки на нужные объекты метаданных в состав определяемого типа, и на панели навигации в формах этих объектов появится команда Документооборот, в подменю Создать на основании появятся команды Документооборот: процесс… и Документооборот: письмо…
3.2.2 Команда «ИнтеграцияС1Сдокументооборот»
Тип параметра этой команды определяет, какие объекты интегрируемой конфигурации получат средства бесшовной интеграции, вынесенные на отдельную форму, доступную в виде команды Документооборот в панели навигации:
По умолчанию в состав типов параметра команды включен определяемый тип ИнтеграцияС1СДокументооборотВсеСсылкиПереопределяемый.
3.2.3 Команда «ИнтеграцияС1СдокументооборотСоздатьБизнесПроцесс»
Тип параметра этой команды определяет, какие объекты интегрируемой конфигурации могут стать предметами запускаемых бизнес-процессов.
По умолчанию в состав типов параметра команды включен определяемый тип ИнтеграцияС1СДокументооборотВсеСсылкиПереопределяемый.
3.2.4 Команда «ИнтеграцияС1СдокументооборотСоздатьПроцессСогласования»
Тип параметра этой команды определяет, какие объекты интегрируемой конфигурации могут стать предметами автоматически запускаемых процессов согласования. Отличие этой команды от предыдущей в том, что выбор типа процесса невозможен, и что при наличии единственного подходящего шаблона согласования процесс автоматически запускается по этому шаблону. Кроме этого, выполняется проверка на наличие ранее созданных виз согласования, чтобы избежать их потери при случайном повторном запуске согласования.
3.2.5 Команда «ИнтеграцияС1СДокументооборотСоздатьПисьмо»
Тип параметра этой команды определяет, какие объекты интегрируемой конфигурации могут стать предметами писем, создаваемых пользователями.
По умолчанию в состав типов параметра команды включен определяемый тип ИнтеграцияС1СДокументооборотВсеСсылкиПереопределяемый.
3.2.6 Команда «ИнтеграцияС1СДокументооборотПрисоединенныеФайлы»
Тип параметра этой команды определяет, для каких объектов интегрируемой конфигурации будет доступен список присоединенных файлов, хранящихся в «1С:Документообороте». Добавьте нужные объекты метаданных в состав типов параметра команды, и в их панели навигации появится команда Файлы.
Для бесшовной подмены списка присоединенных файлов подсистемы «Присоединенные файлы» БСП следует вносить изменения в код модуля соответствующей команды БСП, открывая форму БСП или форму БИД в зависимости от настроек интеграции. Пример такой доработки см. в демонстрационной конфигурации.
3.2.7 Определяемый тип «ИнтеграцияС1СДокументооборотДокументыОбъектыПереопределяемый»
В данный определяемый тип необходимо включить все документы объекты, участвующие в бесшовной интеграции. Данные документы будут добавлены в подписки на событие «ИнтеграцияС1СДокументооборотОбработкаЗаполненияДокументы» и «ИнтеграцияС1СДокументооборотПередЗаписьюДокумента». Описание подписок ниже.
3.2.8 Определяемый тип «ИнтеграцияС1СДокументооборотСправочникиОбъектыПереопределяемый»
В данный определяемый тип необходимо включить все справочники объекты, участвующие в бесшовной интеграции. Данные документы будут добавлены в подписки на событие «ИнтеграцияС1СДокументооборотОбработкаЗаполненияСправочники» и «ИнтеграцияС1СДокументооборотПередЗаписьюСправочника». Описание подписок ниже.
3.2.9 Подписка «ИнтеграцияС1СДокументооборотОбработкаЗаполненияСправочники»
Тип источника этого события определяет, какие типы справочников интегрируемой конфигурации могут заполняться на основании объектов «1С:Документооборота». По умолчанию в состав типов источника этой команды включен определяемый тип ИнтеграцияС1СДокументооборотСправочникиОбъектыПереопределяемый. Если в рамках внедрения БИД нет необходимости в таком заполнении, эту подписку переносить не нужно.
3.2.10 Подписка «ИнтеграцияС1СДокументооборотОбработкаЗаполненияДокументы»
Тип источника этого события определяет, какие типы документов интегрируемой конфигурации могут заполняться на основании объектов «1С:Документооборота». По умолчанию в состав типов источника этой команды включен определяемый тип ИнтеграцияС1СДокументооборотДокументыОбъектыПереопределяемый. Если в рамках внедрения БИД нет необходимости в таком заполнении, эту подписку тоже не следует переносить.
3.2.11 Подписка «ИнтеграцияС1СДокументооборотПередЗаписьюДокумента»
Тип источника этого события определяет, какие типы документов интегрируемой конфигурации будут получать идентификатор объекта «1С:Документооборота» при их создании на основании для последующей синхронизации с помощью планов обмена. По умолчанию в состав типов источника этой команды включен определяемый тип ИнтеграцияС1СДокументооборотДокументыОбъектыПереопределяемый. Если в рамках внедрения не предусматривается синхронизация документов с «1С:Документооборотом», то эту подписку не следует переносить.
3.2.12 Подписка «ИнтеграцияС1СДокументооборотПередЗаписьюСправочника»
Тип источника этого события определяет, какие типы справочников интегрируемой конфигурации будут получать идентификатор объекта «1С:Документооборота» при создании на основании для последующей синхронизации с помощью планов обмена. По умолчанию в состав типов источника этой команды включен определяемый тип ИнтеграцияС1СДокументооборотСправочникиОбъектыПереопределяемый. Если в рамках внедрения не предусматривается синхронизация справочников с «1С:Документооборотом», то эту подписку не следует переносить.
3.2.13 План обмена «ИнтеграцияС1СДокументооборотомПереопределяемый»
Добавьте в состав плана обмена те объекты, изменения которых следует автоматически передавать в «1С:Документооборот» при использовании интеграции с редакциями КОРП и ДГУ. Регистрация изменений – автоматическая.
3.2.14 Формы интегрируемых объектов
В формы интегрируемых объектов и в формы их списков добавьте вызовы процедур ИнтеграцияС1СДокументооборот.ПриСозданииНаСервере и ИнтеграцияС1СДокументооборотКлиент.ВыполнитьПодключаемуюКомандуИнтеграции. После этого в командной панели формы появятся команды хронометража и ввода трудозатрат.
Если в форме нет стандартной командной панели, место размещения команд можно указать в параметре МестоРазмещенияКоманд. В комплект поставки БИД входит обработка для автоматической расстановки вызовов процедур в модули форм объектов (РасстановкаДобавленияИВызоваКомандИнтеграции.epf).
Для объектов, которые участвуют в синхронизации по планам обмена, добавьте вызов процедуры ИнтеграцияС1СДокументооборот.ПередЗаписьюНаСервере, чтобы объекты, создаваемые интерактивно на основании объектов «1С:Документооборота», получали идентификаторы объектов-оснований.
3.2.15 Работа регламентного задания в модели сервиса
При встраивании в конфигурации, предназначенные для работы в модели сервиса, регламентное задание ИнтеграцияС1СдокументооборотВыполнитьОбменДанными рекомендуется сделать неразделяемым. Чтобы обеспечить выполнение задания во всех областях данных в конфигурациях на основе БСП, его следует включить в список шаблонов заданий, добавив код
ШаблоныЗаданий.Добавить("ИнтеграцияС1СдокументооборотВыполнитьОбменДанными ");
в процедуру ПриПолученииСпискаШаблонов общего модуля ОчередьЗаданийПереопределяемый.
3.2.16 Общий модуль «ОбщегоНазначенияПереопределяемый»
Добавьте в процедуру ПриДобавленииОбработчиковУстановкиПараметровСеанса код, подключающий обработчики заполнения параметров сеанса Библиотеки:
// ИнтеграцияС1СДокументооборотом
ИнтеграцияС1СДокументооборот.
ПриДобавленииОбработчиковУстановкиПараметровСеанса(Обработчики);
// Конец ИнтеграцияС1СДокументооборотом
3.2.17 Общий модуль «ОбщегоНазначенияКлиентПереопределяемый»
Добавьте в процедуру ПослеНачалаРаботыСистемы код, выполняющий асинхронное подключение к Документообороту:
// ИнтеграцияС1СДокументооборотом
ИнтеграцияС1СДокументооборотКлиент.ПослеНачалаРаботыСистемы();
// Конец ИнтеграцияС1СДокументооборотом
3.2.18 Общий модуль «ПодсистемыКонфигурацииПереопределяемый»
Добавьте в процедуру ПриДобавленииПодсистем код, подключающий общий модуль с обработчиками обновления данных Библиотеки:
// ИнтеграцияС1СДокументооборотом
МодулиПодсистем.Добавить("ОбновлениеИнформационнойБазыБИД");
// Конец ИнтеграцияС1СДокументооборотом
3.2.19 Общий модуль «РегламентныеЗаданияПереопределяемый»
Добавьте в процедуру ПриОпределенииНастроекРегламентныхЗаданий код, вызывающий процедуру, определяющую настройки регламентного задания БИД:
// ИнтеграцияС1СДокументооборотом
ИнтеграцияС1СДокументооборот.ПриОпределенииНастроекРегламентныхЗаданий(Настройки);
// Конец ИнтеграцияС1СДокументооборотом
3.2.20 Общий модуль «УправлениеПечатьюПереопределяемый»
Добавьте в процедуру ПередДобавлениемКомандПечати код, предназначеный для дополнения команд печати листом согласования:
// ИнтеграцияС1СДокументооборотом
ИнтеграцияС1СДокументооборотПереопределяемый.ПередДобавлениемКомандПечати(ИмяФормы, КомандыПечати, СтандартнаяОбработка);
// Конец ИнтеграцияС1СДокументооборотом
3.2.21 Общие модули «ИнтеграцияС1СДокументооборотПереопределяемый», «ИнтеграцияС1СДокументооборотКлиентПереопределяемый» и «ИнтеграцияС1СДокументооборотВызовСервераПереопределяемый»
Для настройки переопределяемых общих модулей рекомендуется придерживаться общего подхода:
■ При первой настройке переопределяемого общего модуля ознакомьтесь с документацией к его экспортным процедурам и функциям (приведена в комментариях к ним) и, при необходимости, впишите реализацию в экспортные процедуры и функции модуля.
■ Переопределяемые модули могут поставляться по умолчанию уже настроенными для работы с другими объектами БИД. В этом случае необходимо оставить в них блоки кода, которые относятся к функционалу подсистемы.
■ При каждом последующем обновлении переопределяемого общего модуля требуется перенести новые экспортные процедуры и функции, удалить устаревшие и убедиться, что комментарии, количество и имена параметров у всех функций совпадают с их библиотечными эквивалентами. При необходимости впишите реализацию в новые экспортные процедуры и функции модуля и актуализируйте реализацию уже существующих функций, если в новой версии «Библиотеки» было изменено их назначение или состав параметров.
Особого внимания требуют следующие процедуры и функции:
■ ЗаполнитьРеквизитыИзПотребителя – содержит код, заполняющий вторичные ссылочные объекты на основании объектов интегрируемой конфигурации. По умолчанию заполняется только наименование и идентификатор. Для справочников, соответствующих справочникам Контрагенты и Организации, рекомендуется реализовать заполнение свойств inn и kpp, чтобы обеспечить поиск соответствия по этим реквизитам.
■ ПодходящийТип – содержит код, определяющий наиболее подходящий для объекта «1С:Документооборота» тип из списка типов реквизита составного типа интегрируемой конфигурации.
■ ШтрихкодДокумента – содержит код, определяющий штрихкод документа интегрируемой конфигурации для помещения в «1С:Документооборот».
■ ПользователюРазрешеноИспользованиеИнтеграции – содержит код, определяющий право пользователя использовать интеграцию с «1С:Документооборотом». Нуждается в переопределении, если при внедрении «Библиотеки» решено не использовать поставляемую роль БазовыеПраваБИД или уточнить права пользователей на использование интеграции по сравнению с типовым набором прав.
■ ПользователюРазрешенЗапускСогласования – содержит код, определяющий право пользователя запускать процесс согласования с помощью «1С:Документооборота».
■ ПользователюРазрешеноПрерываниеСогласования – содержит код, определяющий право пользователя прерывать процесс согласования с помощью «1С:Документооборота».
■ ПриИзмененииСостоянияСогласования – вызывается при изменении состояния согласования на стороне «1С:Документооборота» или на стороне интегрируемой конфигурации. Предназначена для синхронного изменения состояния согласуемого объекта, если оно хранится на стороне интегрируемой конфигурации, а настраиваемых правил интеграции для его изменения недостаточно (например, если состояния согласования хранятся в отдельном регистре сведений).
■ ПередДобавлениемКомандПечати – в конфигурациях на основе БСП вызывается из одноименной процедуры общего модуля УправлениеПечатьюПереопределяемый и предназначена для дополнения команд печати листом согласования. Вызов этой процедуры следует встроить в модуль УправлениеПечатьюПереопределяемый.
■ ОтборПриВыбореСвязанногоОбъекта – содержит код, накладывающий отбор на объекты «1С:Документооборота» при интерактивном выборе соответствия из формы объекта интегрируемой конфигурации.
■ ДополнительнаяОбработкаФормыДокумента, ДополнительнаяОбработкаФормыБизнесПроцесса, ДополнительнаяОбработкаФормыЗадачи – вызываются при создании на сервере соответствующих форм и предназначены для их программной модификации, например, для добавления собственных команд и элементов управления или скрытия типовых.
■ ВыполнитьПрограммноДобавленнуюКоманду – содержит обработчик команд, добавленных программно способом, описанным выше. Вызывается из процедур Подключаемый_ВыполнитьПрограммноДобавленнуюКоманду соответствующих форм.
■ ПриОпределенииТаймаутаСервиса – в большинстве случаев достаточно таймаута по умолчанию (15 секунд), поскольку большие задержки делают работу бесшовной интеграции неудобной для пользователя. В некоторых случаях, однако, может понадобиться вынести настройку таймаута в интерфейс администратора. В таких случаях получение этой настройки следует вписать в код процедуры.
■ ПриОпределенииСокращенногоНаименованияКонфигурации – в формах Библиотеки длинное словосочетание «Интегрируемая конфигурация» может быть заменено на краткое и точное название интегрируемой конфигурации.
■ ПриПроверкеСоответствияПравилаФункциональнымОпциям – правила интеграции могут соответствовать типам объектов ИС или видам их операций, которые отключены в ИС функциональными опциями. В этом случае следует переопределить процедуру, отказываясь от использования правил, связанных с отключенными объектами, чтобы пользователь не видел их, например, в момент создания связанного объекта при неоднозначности правила, когда требуется выбор пользователя.
■ ПриОпределенииОбновляемыхРеквизитовПроведенногоДокумента – вызывается при фоновом обновлении реквизитов проведенного документа ИС. Предназначена для определения реквизитов, которые можно обновлять в проведенном документе. По умолчанию реквизиты проведенного документа не обновляются.
■ ПриЗаполненииФормыОбъектаДОПоОбъектуИС – вызывается при заполнении формы документа или корреспондента 1С:Документооборота при создании на основании объекта интегрируемой конфигурации. Позволяет дозаполнить форму объекта 1С:Документооборота способом, не предусмотренным правилами интеграции.
■ ПриОпределенииПодходящихОбъектовДляДобавленияСвязи – вызывается при интерактивном или автоматическом добавлении связи. Позволяет расширить список подходящих объектов теми, которые не удается определить автоматически по реквизитам текущего документа, например, если ссылки на них хранятся в регистрах сведений.
■ ПриОпределенииЗначенияРеквизитаПоОбъектуXDTO – вызывается при заполнении объектов ИС по данным ДО и позволяет переопределить стандартный способ определения значения реквизита, например, реализовав более сложный алгоритм поиска соответствий, чем реализованное по умолчанию поведение.
3.2.22 Регистр сведений НастройкиАвторизацииВ1Сдокументообороте
Если в интегрируемой конфигурации используется RLS, настройте ограничения доступа так, чтобы право на чтение и изменение записей этого регистра имел только сам пользователь. Несмотря на то, что «Библиотека» использует разделенное хранение паролей «1С:Документооборота», и данные этого регистра сами по себе недостаточны для получения паролей злоумышленником, по ним можно установить длину пароля и тот факт, что пользователь входит в «1С:Документооборот» без пароля.
3.2.23 Подключение к «1С:Документообороту» при начале работы системы
В большинстве случаев не нужно предпринимать специальных усилий по подключению к веб-сервису 1С:Документооборота при начале работы интегрируемого прикладного решения, поскольку формы и команды Библиотеки начинают подключение самостоятельно. В некоторых случаях, однако, на стороне сервера необходимо заранее знать о доступности сервиса «1С:Документооборота» и о его версии. В этом случае следует вызвать функцию НачатьПодключение общего модуля ИнтеграцияС1СДокументооборотКлиент при начале работы системы. Подключение будет начато асинхронно, а обнаруженная версия сервиса будет сохранена в параметрах сеанса. Впоследствии ее можно получить вызовом функции ВерсияСервиса общего модуля ИнтеграцияС1СДокументооборотВызовСервера.
3.2.24 Взаимодействие с подсистемой БСП «Присоединенные файлы»
Форма ПрисоединенныеФайлы, входящая в состав Библиотеки, может подменять аналогичную формы подсистемы ПрисоединенныеФайлы БСП. При этом поддерживается гибкая подмена: форма БИД будет открыта лишь для тех объектов интегрируемой конфигурации, для которых настроена интеграция (существуют подходящие правила интеграции), и лишь тогда, когда включена функциональная опция ИспользоватьПрисоединенныеФайлы1СДокументооборота.
При наличии файлов, присоединенных к объекту интегрируемой конфигурации до настройки интеграции, будет открыта форма БСП. Миграция старых файлов в «1С:Документооборот» в текущих версиях Библиотеки не поддерживается.
Для подмены формы БСП следует доработать модуль общей команды ПрисоединенныеФайлы. Образец доработки приведен в демонстрационной конфигурации.
Общую команду ИнтеграцияС1СдокументооборотПрисоединенныеФайлы следует использовать во внедрениях, не содержащих подсистему ПрисоединенныеФайлы БСП, а также во внедрениях, не требующих описанной выше гибкой подмены.
4. Настройка и использование подсистемы при разработке конфигурации
4.1. Настройка интерфейса пользователя
Подсистема Интеграция с 1С:Документооборотом содержит формы, которые следует разместить в пользовательском интерфейсе:
■ Форма ЗадачиМне обработки ИнтеграцияС1СДокументооборот отображает список текущих задач пользователя «1С:Документооборота» и предназначена для размещения на рабочем столе интегрируемой конфигурации. Для настройки форм рабочего стола используется свойство Рабочая область рабочего стола объекта Конфигурация или команда Открыть рабочую область рабочего стола контекстного меню корневого объекта дерева конфигурации. Видимость формы определяется состоянием функциональной опции ИспользоватьПроцессыИЗадачи1СДокументооборота.
■ Команда АвторизацияВ1СДокументооборот (из обработки Интеграция с 1С:Документооборотом) открывает настройки авторизации текущего пользователя в «1С:Документообороте». Команду можно разместить в форме персональных настроек пользователя. В случае проблем с авторизацией ссылка, открывающая эту форму, отображается в форме Документооборот: Мои задачи, в форме правила интеграции и в форме Присоединенные файлы.
■ Форма Документооборот (из обработки Панель администрирования интеграции с 1С:Документооборотом) служит для установки значений констант, необходимых для работы библиотеки, и определения состава необходимого пользователям функционала.
При необходимости нижеперечисленные константы могут быть добавлены в собственную форму настройки прикладного решения:
■ константа ИспользоватьИнтеграциюС1СДокументооборот регулирует доступность подсистемы Интеграция с 1С:Документооборотом;
■ константа АдресВебСервиса1СДокументооборот определяет расположение веб-сервиса;
■ константа ИспользоватьФайловоеХранилище1СДокументооборота определяет возможность использования «1С:Документооборота» в качестве файлового хранилища в режиме, когда файлы находятся в отдельной общей папке;
■ константа ИспользоватьПрисоединенныеФайлы1СДокументооборота определяет возможность использования «1С:Документооборота» в качестве файлового хранилища в режиме, когда файлы привязаны к документам-владельцам, создаваемым в «1С:Документообороте» автоматически согласно настройкам в справочнике Правила интеграции;
■ константа НаименованиеКорневойПапкиФайлов1СДокументооборот хранит пользовательское представление папки файлов, хранимых в «1С:Документообороте»;
■ константа ИдентификаторКорневойПапкиФайлов1СДокументооборот хранит УИД папки файлов, хранимых в «1С:Документообороте»;
■ константа МаксимальныйРазмерФайлаДляПередачиВ1СДокументооборот определяет максимальный размер файла, который можно передать в «1С:Документооборот»;
■ константа ИспользоватьЕжедневныеОтчеты определяет доступность функционала для работы с ежедневными отчетами «1С:Документооборота»;
■ константа ИспользоватьПроцессыИЗадачи1СДокументооборота определяет доступность функционала для работы с задачами и бизнес-процессами;
■ константа ИспользоватьСвязанныеДокументы1СДокументооборота определяет доступность просмотра и добавления связей между документами «1С:Документооборота»;
■ константа ИспользоватьЭлектроннуюПочту1СДокументооборота определяет доступность функционала для работы с электронной почтой «1С:Документооборота» (имеет смысл только для редакций КОРП и ДГУ);
Все объекты библиотеки используют управляемые формы. Для их корректного отображения в режиме обычного приложения установите флажок Использовать управляемые формы в обычном приложении в свойствах конфигурации.
Для размещения команд библиотеки в обычных формах следует либо вручную добавить в них соответствующие элементы управления, либо внести доработки в процедуру ПриОткрытии с тем, чтобы нужные элементы создавались программно.
4.2 Настройка присоединения печатных форм
Библиотека содержит код, достаточный для работы механизма присоединения печатных форм в конфигурациях, разработанных на основании актуальной версии БСП. При иной реализации подсистемы печати потребуется внести изменения в общий модуль ИнтеграцияС1СДокументооборотПереопределяемый.
■ Процедура ЗаполнитьТаблицуМенеджеровПечатиОбъекта этого модуля отвечает за построение списка печатных форм, предъявляемого пользователю.
■ Процедура ЗаполнитьПечатныеФормы отвечает за получение печатных форм по команде, выбранной пользователем.
4.3 Настройка прав и ролей
Разработчики прикладного решения могут самостоятельно проектировать систему ролей, а могут воспользоваться готовыми ролями.
|
№ |
Роли и их назначение |
|
1. |
ПолныеПрава Позволяет выполнять любые действия с объектами подсистемы «Интеграция с 1С:Документооборотом», за исключением запрещенных стандартами разработки. |
|
2. |
БазовыеПраваБИД Предоставляет права на все объекты подсистемы «Интеграция с 1С:Документооборотом». |
|
3. |
ИспользованиеИнтеграцииС1СДокументооборотом Устарела, оставлена для совместимости. |
При отказе от использования поставляемой роли следует внести изменения в переопределяемый общий модуль ИнтеграцияС1СДокументооборотПереопределяемый. Особого внимания требует настройка доступа к регистру сведений, хранящему настройки авторизации в «1С:Документообороте».
При использовании автоматического обновления измененных объектов следует предоставить доступ на чтение плана обмена ИнтеграцияС1Сдокументооборот всем пользователям, которые могут записывать объекты, входящие в его состав.
4.4. Настройка регламентных заданий
Для синхронизации связанных объектов используется регламентное задание ИнтеграцияС1СДокументооборотомВыполнитьОбменДанными.
Расписание этого регламентного задания задает частоту обновления связанных объектов. Задание выполняет как выгрузку изменений из интегрируемой конфигурации в «1С:Документооборот», так и получение изменений из «1С:Документооборота».
В части получения изменений работа данного задания зависит от результатов работы задания ИнтегрированныеСистемыФормированиеСообщений, которое выполняется на стороне «1С:Документооборота» и готовит сообщения согласно изменениям, зарегистрированным в плане обмена.
Расписание этого задания должно соответствовать расписанию задания ИнтеграцияС1СдокументооборотомВыполнитьОбменДанными: к моменту, когда задание на стороне интегрируемой конфигурации попытается получить данные из «1С:Документооборота», они должны быть готовы к отправке.
Для авторизации в «1С:Документообороте» регламентное задание на стороне интегрируемой конфигурации использует значения констант ИнтеграцияС1СДокументооборот ИмяПользователяДляОбмена и ИнтеграцияС1Сдокументооборот ПарольДляОбмена.
5. Обновление версии библиотеки
Особенности обновления каждой версии БИД описаны в файле UpdateDMIL.htm, входящем в комплект поставки.
Для обновления библиотеки выполните следующее:
1. Выполните команду Конфигурация – Поддержка – Обновить конфигурацию из файла.
2. В открывшемся окне укажите файл поставки библиотеки и подтвердите запрос об обновлении версии конфигурации поставщика.
3. В окне сравнения и объединения конфигураций снимите все флажки и отметьте переносимые объекты с помощью команды Действия – Отметить по подсистемам новой конфигурации поставщика.
4. Выберите подсистему «Интеграция с 1С:Документооборотом» и нажмите Установить.
5. Выберите режим объединения Взять из файла и нажите Выполнить.
6. В окне со списком зависимых объектов нажмите Продолжить.
После этого внесите необходимые изменения в состав переопределяемых общих модулей и других объектов конфигурации согласно разделу «Настройка перенесенных объектов», а также согласно описанному в разделе «Особенности обновления» файла UpdateDMIL.htm.
6. Пользовательская документация
Предисловие для технического писателя
В этой главе приведены фрагменты пользовательской документации по функционалу «Библиотеки интеграции с 1С:Документооборотом». Их можно использовать при подготовке документации к прикладному решению, в которое встраивается библиотека.
Большинство текстов этой главы можно переносить в документацию без изменений, однако отдельные ее фрагменты, а также большинство примеров и снимков экрана следует адаптировать под конкретные проектные решения, принятые при внедрении в конкретную конфигурацию. При формировании руководства пользователя прикладного решения следует:
■ выделить фрагменты текста, теряющие актуальность при конкретном внедрении, и переписать их, заменив текстом, подходящим для прикладного решения;
■ снимки демонстрационной конфигурации заменить снимками пользовательских интерфейсов прикладного решения.
Интеграция с конфигурацией «1С:Документооборот 8»
При работе с программой «1С:Документооборот 8» пользователь может:
■ создавать документы в «1С:Документообороте» на основании данных интегрируемого прикладного решения;
■ заполнять документы и справочники интегрируемого прикладного решения на основании данных «1С:Документооборота»;
■ устанавливать связи между документами для дальнейшей обработки пакета документов в «1С:Документообороте»;
■ запускать бизнес-процессы по документам и справочникам интегрируемого прикладного решения, например, отправлять документы на согласование, утверждение, в обработку, на исполнение;
■ использовать «1С:Документооборот» как единое файловое хранилище;
■ создавать письма по данным интегрируемого прикладного решения (только с редакциями КОРП и ДГУ);
■ вести хронометраж и учет трудозатрат.
Подробную информацию о работе с внутренними, входящими и исходящими документами, создании связей между документами, запуске бизнес-процессов, использовании почты и об учете трудозатрат можно получить в документации к программе «1С:Документооборот 8».
Использование средств интеграции требует предварительной настройки администратором. Настройка начинается с публикации веб-сервиса «1С:Документооборота».
Публикация веб-сервиса «1С:Документооборота»
Обязательным требованием публикации является наличие установленного и работающего веб-сервера (Microsoft Internet Information Services или Apache), обращение к которому возможно с сервера, на котором работает интегрируемое прикладное решение.
Для публикации веб-сервиса следует:
1. Запустить программу «1С:Предприятие 8» от имени администратора операционной системы.
2. Открыть конфигурацию «1С:Документооборот 8» в режиме Конфигуратор под пользователем с полными правами.
3. Выполнить команду Администрирование – Публикация на веб-сервере…
В окне публикации на веб-сервере нужно:
■ указать имя публикации (впоследствии оно станет частью URL, который нужно будет указать в форме настроек на стороне интегрируемого прикладного решения),
■ выбрать веб-сервер (Internet Information Services или Apache),
■ выбрать каталог публикациии (желательно дать ему говорящее имя),
■ установить флажок Публиковать Web-сервисы,
■ установить флажок для сервиса DMService,
■ Нажать кнопку Опубликовать.
Публикация веб-клиента и других сервисов не обязательна для интеграции.
Если публикация выполняется на версии платформы, еще не зарегистрированной на веб-сервере, будет предложено выполнить перезапуск веб-сервера. После принятия изменений веб-сервер «1С:Документооборота» будет опубликован.
ВНИМАНИЕ! При публикации веб-сервиса на веб-сервере Internet Information Services следует включить анонимную проверку подлинности и отключить все остальные способы проверки подлинности. При необходимости использовать другие способы, например, авторизацию Windows для веб-клиента, следует выполнить две публикации в разные каталоги, настроив параметры проверки подлинности для каждой публикации отдельно.
Настройка интеграции
Перед использованием возможностей «1С:Документооборота» в интегрируемом прикладном решении следует установить настройки в окне Интеграция с 1С:Документооборотом (команда Интеграция с 1С:Документооборотом в подразделе Сервис раздела Настройки).
Для использования любых возможностей интеграции необходимо установить флажок Интеграция с 1С:Документооборотом.
Далее следует заполнить следующие поля:
■ URL – указывается адрес для соединения с информационной базой программы «1С:Документооборот 8». Адрес должен соответствовать адресу публикации «Веб-сервиса 1С:Документооборота»;
■ Процессы и задачи – настройка позволит работать с процессами и задачами «1С:Документооборота».
■ Связанные документы – настройка позволит просматривать и устанавливать связи между документами «1С:Документооборота».
■ Ежедневные отчеты – натройка позволит работать с хронометражом и ежедневными отчетами «1С:Документооборота».
■ Электронная почта – натройка позволит работать со встроенной почтой «1С:Документооборота» (только для редакций КОРП и ДГУ).
■ Хранение присоединенных файлов – настройка позволит использовать «1С:Документооборот» в качестве внешнего файлового хранилища. При этом возможны два варианта:
1. Файлы прикреплены к документам – файлы, присоединяемые к документам и справочникам интегрированного прикладного решения, присоединяются к связанным документам «1С:Документооборота», создаваемых автоматически на основании документов и справочников интегрированного прикладного решения по правилам интеграции. Это требует настройки правил интеграции для всех объектов, файлы которых планируется хранить в «1С:Документообороте».
2. Файлы в отдельных папках – файлы, присоединяемые из интерфейса интегрируемого прикладного решениях, хранятся в выделенной для этого папке «1С:Документооборота», а не привязаны к документам «1С:Документооборота». Это усложняет доступ к ним для пользователей, работающих только в интерфейсе «1С:Документооборота», и сильно затрудняет разграничение доступа к ним.
■ Корневая папка для хранения файлов – папка в «1С:Документообороте» (из справочника Папки файлов), в которой хранятся файлы, добавленные из интегрируемой конфигурации; имеет смысл только для варианта Файлы в отдельных папках.
■ Максимальный размер передаваемого файла – максимальный размер файла, который можно поместить в «1С:Документооборот». Значение по умолчанию – 10 Мб, при изменении следует учитывать ограничения Internet Information Services на размер запроса (30 Мб), а также мощность доступного канала связи;
■ Обновлять связанные объекты – флажок управляет регламентным заданием, обновляющим реквизиты связанных объектов при их изменении на стороне интегрируемого прикладного решения или в «1С:Документообороте». Это возможность доступна только при интеграции с редакциями КОРП и ДГУ. Здесь же можно изменить расписание регламентного задания, а также задать имя пользователя и пароль, с использованием которых будет выполняться обновление. В целях безопасности рекомендуется использовать служебную учетную запись с полными правами, которой запрещен интерактивный вход.
■ Объекты, интегрируемые 1С:Документооборотом – команда открывает список объектов прикладного решения, поддерживающих интеграцию, откуда можно начать настройку интеграции для этих объектов.
■ Правила интеграции с 1С:Документооборотом – команда открывает справочник, задающий соответствия между типами объектов интегрируемого прикладного решения и видами документов «1С:Документооборота». Справочник описывает правила создания документов «1С:Документооборота» на основании документов и элементов справочников интегрируемого прикладного решения и наоборот, а также правила автоматической синхронизации связанных объектов. Правила можно также открыть с помощью команды в панели навигации Правила интеграции с 1С:Документооборотом раздела Настройки. Подробнее о настройке правил см. раздел «Правила интеграции с 1С:Документооборотом».
Если файлы, хранящиеся в «1С:Документообороте», заверены электронной подписью, необходимо выполнить настройку ЭП. Подробнее см. в документации к программе «1С:Документооборот 8».
Настройки авторизации в «1С:Документообороте»
Для работы с данными «1С:Документооборота» на стороне интегрируемой конфигурации нужно ввести имя пользователя «1С:Документооборота» и пароль. Окно настроек можно открыть командой Авторизация в 1С:Документообороте раздела Органайзер.
При использовании тонкого клиента «1С:Предприятия» имя пользователя и пароль сохраняются автоматически. При смене рабочего компьютера, а также при работе с программой через браузер пароль нужно будет вводить вручную.
При использовании платформы «1С:Предприятие» версии 8.3.7 и выше возможна также авторизация средствами операционной системы. В этом случае для пользователя ИБ на стороне «1С:Документооборота» должна быть указана учетная запись в домене Windows. Пользователь, вошедший в Windows под этой учетной записью, сможет использовать функционал «1С:Документооборота», не вводя имя пользователя и пароль. При наличии сохраненных настроек авторизации, однако, все равно будет использоваться авторизация «1С:Предприятия».
ВНИМАНИЕ! При работе интегрируемого прикладного решения в клиент-серверном варианте для Windows-авторизации будут использоваться данные той учетной записи, под которой работает служба сервера 1С:Предприятия.
Правила интеграции с «1С:Документооборотом»
Интеграция с «1С:Документооборотом» позволяет создавать документы и элементы справочников интегрируемой конфигурации на основании документов «1С:Документооборота». Запуск бизнес-процессов и создание писем на основании документов и элементов справочников интегрируемой конфигурации требуют предварительного создания связанных документов «1С:Документооборота», которые и станут предметами создаваемых бизнес-процессов и писем.
Средства бесшовной интеграции доступны для следующих справочников и документов:
■ «Демо: Контрагенты»,
■ «Демо: Договоры контрагентов»,
■ «Демо: Счета на оплату покупателям»,
■ «Демо: Заказ покупателя»,
■ «Демо: Заявка на оплату»,
■ «Демо: Реализации товаров».
Для каждого типа объектов интегрируемой конфигурации можно задать правило интеграции, указывающее тип объекта «1С:Документооборота», способ заполнения реквизитов при создании на основании, необходимость автоматического обновления реквизитов и присоединяемые печатные формы. Например, для элементов справочника Демо: Договоры контрагентов вида С покупателем можно указать, что реквизит Корреспондент внутреннего документа «1С:Документооборота» заполняется из реквизита Владелец договора, реквизит Вид документа заполняется фиксированным значением Договор с покупателем и так далее.
В каждом правиле интеграции указывается вид документа «1С:Документооборота», соответствующий типу документа или справочнику интегрируемой конфигурации. Если одному типу документа или справочнику соответствует несколько разных видов документов «1С:Документооборота», то для каждого соответствия создается свое правило интеграции. В этом случае следует определить ключевой реквизит документа или справочника интегрируемой конфигурации, значения которого соответствуют видам документов «1С:Документооборота», поставив флажок Ключевой в правиле заполнения этого реквизита (см. ниже). Например, настраивая интеграцию для справочника Демо: Договоры контрагентов, можно выбрать в качестве ключевого реквизит Вид документа, создав три правила интеграции: договорам вида С покупателем будут соответствовать внутренние документы «1С:Документооборота» вида Договор с покупателем, договорам вида С поставщиком – документы вида Договор с поставщиком, договорам вида Прочее – Прочие договоры.
В сложных случаях, когда вид документа «1С:Документооборота» нельзя однозначно определить по сочетаниям ключевых реквизитов объектов интегрируемой конфигурации, задаются условия применимости правила выражением на встроенном языке «1С:Предприятия».
Правила интеграции можно открыть соответствующей командой на панели навигации. Добавить новое правило можно, нажав кнопку Создать:
В поле Объект БИД (демо) указывается, для какого объекта (см. список выше) выполняется настройка. В поле Объект 1С:Документооборота указывается вид документа (входящий, внутренний или исходящий), соответствующий выбранному объекту интегрируемого прикладного решения. После этого можно перейти к настройкам правил заполнения:
■ Объекта «1С:Документооборота» на основании объекта интегрируемого прикладного решения (закладке «Передача в 1С:Документооборот»);
■ Объекта интегрируемого прикладного решения на основании объекта «1С:Документооборота» (закладка «Получение из 1С:Документооборота»).
Правила заполнения реквизитов настраиваются по умолчанию при выборе типов связываемых объектов. К настройкам по умолчанию можно вернуться по команде Заполнить по умолчанию подменю Еще.
При наличии подходящего шаблона документа в «1С:Документообороте» можно выбрать его в качестве источника для заполнения реквизитов и настроить заполнение лишь для тех реквизитов, которых нет в шаблоне.
Правило заполнения для каждого реквизита настраивается в отдельном окне, открыть которое можно по двойным щелчком или командой Изменить:
Реквизит может заполняться:
■ Из реквизита этой конфигурации – например, реквизит Организация внутреннего документа «1С:Документооброота» может заполняться по значению одноименного реквизита документа интегрируемой конфигурации, реквизит Корреспондент – согласно значению реквизита Контрагент и так далее. Требуется выбрать реквизит-источник. Флажок Обновлять управляет автоматическим обновлением значения реквизита в «1С:Документообороте» при его изменении на стороне интегрируемой конфигурации (только редакции КОРП и ДГУ).
■ Из указанного значения – реквизит всегда заполняется одним и тем же значением, выбранным в момент настройки. Например, значение реквизита Папка внутреннего документа всегда будет заполняться значением Договоры с поставщиками, то есть создаваемые документы будут помещаться в папку Договоры с поставщиками.
■ Из выражения на встроенном языке – реквизит заполняется по результату выражения на встроенном языке «1С:Предприятия». Выражение должно присваивать значение свойству Результат переменной-структуры с именем Параметры. Свойство Источник той же структуры Параметры в контексте выполнения выражения содержит ссылку на объект-источник, через которую можно обращаться к его реквизитам. Более подробно о встроенном языке «1С:Предприятия» см. книгу «1С:Предприятие 8.3. Руководство разработчика».
■ Из шаблона – реквизит заполняется значением, указанным в шаблоне документа «1С:Документооборота».
Флажок Ключевой указывает, что правило интеграции будет применяться только для объектов с указанным значением реквизита, что позволяет определить несколько правил для одного типа объекта (вида документа), разделив их по значениям ключевых реквизитов. Ключевые реквизиты могут заполняться только из явно указанного значения. Вид документа всегда является ключевым.
Для очистки правила заполнения реквизита следует выделить нужную строку и выбрать в контекстном меню команду Очистить или нажать клавишу Del.
Поскольку изменение реквизитов проведенных документов не всегда допустимо, для правил заполнения реквизитов документов интегрируемой конфигурации предусмотрена дополнительная настройка:
Для реквизитов вроде комментария, от которых не зависят движения документа, можно выбрать вариант «Разрешено без перепроведения». Для реквизитах, участвующих в формировании движений, следует выбрать варианты «Запрещено» или «Разрешено с перепроведением».
Табличные части могут заполняться:
■ Из таблицы – например, таблица «Товары» этой конфигурации будет заполняться данными таблицы «Товары и услуги» документа «1С:Документооброота». Для реквизитов этой таблицы нужно будет задать свои правила заполнения, причем в качестве источника можно будет выбрать только реквизиты выбранной здесь таблицы.
■ Из выражения на встроенном языке – таблица заполняется по результату выражения на встроенном языке «1С:Предприятия». Выражение должно присваивать свойству Результат переменной-структуры с именем Параметры значение типа ТаблицаЗначений. Имена ее колонок должны совпадать с именами заполняемых реквизитов таблицы.
■ По правилам для отдельных реквизитов – общего правила для таблицы нет, правила настраиваются отдельно для каждого ее реквизита.
Если данных в составе реквизитов недостаточно, на закладке Добавление печатных форм можно отметить печатные формы, которые будут присоединены к документу «1С:Документооборота» при его автоматическом создании на основании документа интегрируемой конфигурации. Печатные формы сохраняются в виде приложенных к документу файлов в одном из трех форматов на выбор:
При снятии флажка «Обновляется автоматически» 
(установлен по умолчанию) печатные
формы не будут обновляться в «1С:Документообороте» при изменении объекта в
интегрированной конфигурации.
Использование средств бесшовной интеграции
Работа с документами, бизнес-процессами, присоединенными файлами и электронной почтой поддерживается в следующих документах и справочниках:
■ «Демо: Контрагенты»,
■ «Демо: Договоры контрагентов»,
■ «Демо: Счета на оплату покупателям»,
■ «Демо: Заказ покупателя»,
■ «Демо: Реализации товаров».
На основании документов и элементов справочников можно создавать бизнес-процессы и письма.
При создании нового бизнес-процесса можно выбрать шаблон запускаемого процесса или тип процесса, создаваемого без шаблона:
При создании письма на основании документа, предмет письма заполняется автоматически и (если настроено автоматическое добавление печатных форм) к письму прикладываются печатные формы в формате, выбранном при настройке:
Если на момент создания бизнес-процесса или письма исходный документ не был связан с документом «1С:Документооборота», то:
■ если тип объекта описан в справочнике Настройки заполнения объектов 1С:Документооборота, то на основании объекта будет создан, автоматически заполнен и записан новый документ «1С:Документооборота»;
■ если тип объекта не описан в справочнике Настройки заполнения объектов 1С:Документооборота, то будет предложено создать и вручную заполнить новый документ, либо связать документ с уже существующим документом «1С:Документооборота»;
Для работы с объектами «1С:Документооборота» необходимо воспользоваться командой Документооборот панели навигации объекта интегрируемой конфигурации:
Если объект интегрируемой конфигурации уже связан с документом «1С:Документооборота», то в верхней части окна находится ссылка на связанный документ:
Справа от ссылки на связанный документ расположена команда Очистить, которой можно удалить ошибочно созданную связь и, при желании, настроить связь заново.
Если связь не установлена, то с помощью команды Создать можно создать новый связанный документ, а с помощью команды Выбрать… – выбрать один из существующих:
При создании документа открывается его карточка, в которой часть полей заполнены согласно правилам интеграции, а часть, возможно, требует заполнения вручную. Если у документа-основания есть печатные формы, а их автоматическое добавление по каким-то причинам нежелательно, в этот момент их можно добавить в виде приложенных файлов, выбрав команду Добавить форму подменю Еще списка файлов:
По кнопке Записать и закрыть документ записывается в «1С:Документообороте» и связывается с документом-основанием. Более подробно о работе с документами «1С:Документооборота» см. документацию к программе «1С:Документооборот 8».
На основании документов могут быть созданы бизнес-процессы и исходящие письма. Письма можно увидеть по команде История переписки в панели навигации или на закладке История переписки. Бизнес-процессы, как выполняющиеся, так и завершенные, а также созданные в их рамках задачи можно увидеть на закладке Процессы и задачи.
На основании объектов «1С:Документооборота» можно создавать объекты интегрируемой конфигурации.
Если объект «1С:Документооброта» не связан ни с одним объектом интегрируемой конфигурации, то можно либо связать его с уже существующим объектом, либо, при наличии соответствующего правила интеграции, создать новый документ или элемент справочника, реквизиты которого будут заполнены по данным «1С:Документооборота» согласно правилу:
Если связь установлена, то ссылка на связанный объект будет показана в верхней части окна. По команде Очистить в правой части окна можно убрать ошибочно установленную связь.
Работа с процессами и задачами «1С:Документооборота»
Перейдя на закладку Процессы и задачи в окне Документооборот, можно увидеть дерево процессов, запущенных по объекту, с задачами, созданными в ходе этих процессов:
Во второй колонке выводятся значки, иконка которых соответствует результату выполнения задачи:
■
без цвета 
– задача выполнена (например, нажата кнопка Выполнено);
■
красный 
–
задача выполнена с отрицательным результатом (например, не согласована);
■
зеленый 
–
задача выполнена с положительным результатом (утверждена, согласована);
■
желтый 
–
задача выполнена и согласована с замечаниями.
■
остановлен 
– бизнес-процесс, по которому запущена задача,
приостановлен временно (выполнение задачи может быть продолжено).
■
прерван 
–
бизнес-процесс, по которому запущена задача, прерван (выполнение задачи нельзя
возобновить).
■
ожидает выполнения 
– задача находится в очереди для выполнения.
■
выполнение отменено 
– фоновое задание не смогло завершить
выполнение задачи (можно попробовать выполнить задачу вручную).
По команде Создать можно запустить новый бизнес-процесс.
По команде Открыть можно открыть карточку процесса или задачи. Карточка процесса открывается только для просмотра, остановки или прерывания. Редактировать запущенный процесс можно только из интерфейса «1С:Документооборота». Задачу можно выполнить из ее карточки.
По умолчанию завершенные процессы и выполненные задачи скрыты. Увидеть их можно, установив флажок Показывать выполненные в нижней части формы.
На основании задач бизнес-процессов можно создавать подчиненные бизнес-процессы и исходящие письма. Более подробно о работе с бизнес-процессами см. в документации к программе «1С:Документооборот 8».
Хранение файлов в «1С:Документообороте»
При использовании варианта хранения Файлы прикреплены к документам присоединенные файлы доступны по команде Присоединенные файлы:
Для основных графических форматов возможен предпросмотр (панель предпросмотра можно убрать командой Предпросмотр подменю Еще).
Двойной щелчок на файле открывает файл для просмотра. Из контекстного меню и из подменю Еще доступно редактирование файлов. При этом редактирование файла, начатое из интегрируемого прикладного решения, можно закончить в «1С:Документообороте» при условии, что все действия выполняются на одном и том же компьютере.
Редактирование файлов, как и при использовании «1С:Документооборота», блокирует файл от изменения другими пользователями до завершения редактирования.
По команде Отправить файл отправляется через встроенную почту «1С:Документооборота», если ее использование включено в настройках интеграции, в противном случае – через почту, встроенную в интегрируемое прикладное решение.
При использовании варианта хранения Файлы в отдельных папках список файлов, связанных с объектом интегрируемой конфигурации и хранящихся в «1С:Документообороте», доступен на закладке Файлы:
В этом списке можно выполнить следующие действия:
■ по команде Создать – прикрепить к объекту файл, хранящийся на диске, загрузив его в «1С:Документооборот», либо прикрепить к объекту файл, уже хранящийся в «1С:Документообороте»;
■ Открыть – открыть файл для просмотра подходящим внешним приложением;
■ по командам группы ЭП в подменю Еще можно подписать файл с помощью электронной подписи, добавить ЭП, сохранить файл на диск вместе с ЭП. Более подробно о работе с ЭП см. документацию к программе «1С:Документооборот 8»;
■ Изменить – открыть карточку файла и изменить название или иные реквизиты, обновить из файла на диске и т.д;
■ Удалить – пометить файл на удаление. Удаленные файлы не отображаются в интегрированной системе и доступны только из интерфейса «1С:Документооборота».
Изменить файл можно такой последовательностью действий:
■ По команде Сохранить как файл сохраняется на диск;
■ Файл редактируется с помощью подходящего приложения;
■ По команде Обновить из файла измененный файл загружается в 1С:Документооборот.
Указанные команды находятся в командной панели карточки файла и подменю Все действия списка файлов.
На основании файлов можно создавать бизнес-процессы и исходящие письма. Увидеть список писем можно, нажав на ссылку История переписки в панели навигации карточки файла. Бизнес-процессы можно увидеть по ссылке Процессы в той же панели навигации.
Работа со связанными документами
На закладке Связи отображаются документы «1С:Документооборота», которые связаны с основным документом одним из типов связи, определенных при настройке программы «1С:Документооборот 8»:
Более подробно о связанных документах см. документацию к программе «1С:Документооборот 8».
При наличии настроенных правил интеграции программа сама добавляет связи документа с другими документами, ссылки на которые есть в исходном документе. Например, при создании заказа клиента в «1С:Документообороте» на основании заказа интегрированного прикладного решения, в котором указан договор продажи, будет автоматически создана связь между заказом и договором. При наличии в «1С:Документообороте» однозначно настроенного типа связи будет использован этот тип связи, в отсутствие – будет использован предопределенный тип связи Содержит ссылку на.
С помощью команды Добавить можно связать с основным документом другой, уже существующий в «1С:Документообороте» документ.
По команде Удалить можно разорвать существующую связь между документами. Сами документы при этом не удаляются и не помечаются на удаление.
Работа с письмами
Для работы с электронными письмами нужно перейти на закладку История переписки:
По команде Создать можно создать исходящее письмо, предметом которого станет документ «1С:Документооборота». Отправку письма возьмет на себя «1С:Документооборот». По команде Открыть можно ознакомиться с содержанием входящих и исходящих писем, составляющих историю переписки.
На входящие письма можно отвечать.
Входящие и исходящие письма можно пересылать.
На основании писем можно создавать бизнес-процессы.
Просмотр трудозатрат
На закладке Трудозатраты можно увидеть все работы, выполненные по объекту, с указанием общего времени и содержания работ:
Учитываются все трудозатраты, как введенные явно командой Указать трудозатраты, так и накопленные при использовании хронометража.
Работа с задачами
Форма Документооборот: мои задачи предназначена для работы с задачами, адресованными пользователю напрямую, с помощью ролей или делегирования. Форма выведена на начальную страницу. Ее можно убрать через пункт меню Вид – Настройка начальной страницы.
Можно выполнить такие действия:
■ Выполнить задачу прямо из списка, вписав комментарий, если необходимо;
■ Открыть карточку задачи и выполнить задачу из карточки;
■ Открыть бизнес-процесс, предмет задачи или прикрепленные к нему файлы;
■ Сгруппировать список задач по автору, предмету, точке маршрута или важности;
■ Перенаправить задачу другому исполнителю;
■ Задать вопрос по задаче автору бизнес-процесса;
■ Принять задачу к исполнению (при использовании ролевой адресации задач она уйдет из списка задач других исполнителей роли);
■ Ввести трудозатраты по задаче или начать хронометраж времени, потраченного на ее исполнение;
■ Создать новый бизнес-процесс на основании задачи, например, перепоручив часть работ по задаче другому исполнителю;
■ Создать исходящее письмо.
Эти же действия можно выполнить и из карточки задачи. Работать с длинными комментариями, резолюциями, а также редактировать приложенные файлы удобнее из карточки задачи.
Более подробно о работе с задачами «1С:Документооборота» см. документацию к программе «1С:Документооборот 8».
Работа с ежедневными отчетами
При работе с документами интегрируемой конфигурации
пользователи могут фиксировать свои трудозатраты. Для этого в формах документов
и их списках есть кнопка 
. При нажатии на нее открывается окно ввода
записи о трудозатратах, где можно описать характер и длительность работ:
В зависимости от настроек «1С:Документооборота» форма открывается либо с возможностью указания времени начала и окончания работы, либо с возможностью ввода длительности работы.
Кроме непосредственного ввода записи о трудозатратах, для их
учета можно использовать хронометраж. В формах документов и задач для этого
предусмотрена кнопка хронометража 
. Однократное нажатие запускает хронометраж, повторное
– завершает. Если работа длилась более минуты, автоматически открывается окно
ввода записи о трудозатратах с автоматической подстановкой затраченного времени.
Список Мои ежедневные отчеты можно открыть соответствующей командой в разделе Органайзер. В этом списке можно добавлять, удалять и редактировать свои ежедневные отчеты.
Получение навигационных ссылок на объекты «1С:Документооборота»
Из окон объектов «1С:Документооборота» можно получать внешние
навигационные ссылки на них. Доля этого служит кнопка Получить ссылку 
в заголовке:
Созданная ссылка содержит имя базы «1С:Документооборота», ссылку на объект ней и имеет вид http-ссылки. Ее можно передать другому пользователю с возможностью в дальнейшем перейти по ней, работая в интерфейсе программы «1С:Документооборот 8».
Приложение 1
Встраивание «Библиотеки» в конфигурации, использующие более ранние версии БСП, выполняется так же, как и при встраивании в конфигурации с БСП версии 2.3. После встраивания нужно исправить вызовы процедур общих модулей, перенесенных в редакции БСП 2.3 в другие модули.
В общем модуле ИнтеграцияС1СДокументооборотКлиентПереопределяемый изменить вызовы общих функций и процедур в функциях и процедурах модуля:
■ функция РазложитьСтрокуПоТочкамИСлэшам,
■ функция РазделительПути (бывшая ПолучитьСлэш),
■ процедура ХранилищеОбщихНастроекСохранитьМассив.
В общем модуле ИнтеграцияС1СДокументооборотПереопределяемый:
■ при использовании общей картинки ПиктограммыЭлементов, отличной от аналогичной в БИД, нужно изменить возвращаемое значение индекса картинки элемента на нужное значение индекса в процедуре ИндексКартинкиЭлемента.
■ ПолучитьПараметрыПрисоединяемойПечатнойФормы – возвращает структуру параметров печатной формы.
■ ЗаполнитьТаблицуМенеджеровПечатиОбъекта – заполняет таблицу менеджеров печати объекта.
■ ЗаполнитьПечатныеФормы – заполняет коллекцию печатных форм объекта по имени менеджера печати и команде менеджера печати
■ ЗаполнитьКомандыПечати – устанавливает кнопки печати на форме объекта по доступным командам печати.
■ ПередДобавлениемКомандПечати, ВыполнитьКомандуПечатиЛистаСогласования – предназначены для добавления и вызова команды печати листа согласования. Требуюет переопределения для конфигураций, не содержащих подсистему УправлениеПечатью БСП, или содержащих ее ранние версии.
В конфигурациях, не содержащих подсистему УправлениеПечатью БСП, рекомендуется выполнять помещение файлов из окна предварительного просмотра печатных форм.