DIRECTUM 4.9.1. Интеграция с внешней справочной системой

Одна из новых возможностей DIRECTUM 4.9.1 - интеграция с внешней (произвольной) справочной системой. Однако, несмотря на широкие возможности (для вызова справки пишется произвольный код на ISBL, а значит ограничений по форматам и системам нет никаких), реализация этой функциональности может показаться не вполне очевидной.

Рассмотрим по шагам, как это сделать:

1. Откроем компоненту "Установки системы" и найдем там запись с именем ExternalHelpSystemSettings:
   
   
   В поле "Значение" укажем: ExternalHelpReference#Наименование
   Остальные данные нам не понадобятся, поэтому их указывать  не будем.
2. В типах справочников создадим новый справочник "ExternalHelpReference". Визуальная форма не важна, лишь бы можно было корректно создавать записи и указывать их наименование.
3. В событиях типа справочника выберем "Запись - Открытие" и укажем такой текст:
   

   ShowMessage("Вызвана справка по " & Object.Наименование)

4. Разработка для вызова внешней справки готова
5. Далее необходимо наполнять справочник строками для конкретных статей справки. Строки необходимо писать в реквизит "Наименование" (именно его мы указали в Установках системы) в формате <Тип компоненты>#<Имя компоненты>[#<Код представления>]#<Код формы>. Значение для типа компоненты можно узнать из типа ComponentType.
6. Для примера сделаем строку с данными для справки по форме-списку любого представления в справочнике "Наши организации":
   
7. Все готово, можно проверять.
8. Открываем форму список справочника "Наши организации" и вызываем внешнюю справочную систему:
   
9. Получаем сообщение, которое мы указали в коде:
   
    

Для вызова реальной справочной системы меняем тестовый код на реальный (в зависимости от типа системы там может быть работа с COM или вызов внешнего приложения). 

Кроме того, есть еще одна особенность. Можно сделать запись с содержимым "DefaultContext" (без кавычек). Она будет использоваться тогда, когда не найдена запись справки для конкретной формы.