Руководство по установке и настройке утилиты интеграции справочных систем
на компьютер под управлением ОС Windows
Общие сведения

Утилита интеграции справочных систем обеспечивает взаимодействие с системами: ИС «Кодекс: 6 поколение», ИС «Техэксперт: 6 поколение», ИС «Кодекс: 6 поколение» Интранет, ИС «Техэксперт: 6 поколение» Интранет следующих приложений:

Утилита обеспечивает следующие возможности:

Утилита интеграции справочных систем использует Sciter Engine ( http://sciter.com ), copyright Terra Informatica Software, Inc.

Утилита входит в состав служебного тома базы данных 7475.db6.

При работе в ИС «Кодекс: 6 поколение» (ИС «Техэксперт: 6 поколение») утилита будет установлена в папку %ProgramData%\kodeks\kassist и зарегистрирована на рабочем месте пользователя автоматически. Настройка утилиты не требуется.

Если в качестве клиентского приложения ИС «Кодекс: 6 поколение» Интранет (ИС «Техэксперт: 6 поколение» Интранет) будет использоваться «Кодекс-клиент» («Техэксперт-клиент»), то утилита будет установлена в папку %ProgramData%\kodeks\kassist и зарегистрирована на рабочем месте пользователя автоматически. Настройка утилиты не требуется.

Если в качестве клиентского приложения ИС «Кодекс: 6 поколение» Интранет (ИС «Техэксперт: 6 поколение» Интранет) будет использоваться любой из поддерживаемых браузеров, то регистрации утилиты выполняется с помощью программы setup.exe, либо с помощью установочного пакета kassist.msi.

Установка утилиты с помощью программы setup.exe

Для регистрации утилиты следует выполнить следующие действия:

  1. Открыть главную страницу серверной части ИС «Кодекс: 6 поколение» Интранет (ИС «Техэксперт: 6 поколение» Интранет), введя в адресной строке браузера ее адрес (например: http:⁄⁄172.16.0.16:8080).

    Внимание! В административном интерфейсе ИС «Кодекс: 6 поколение» Интранет (ИС «Техэксперт: 6 поколение» Интранет) должен быть установлен флажок «показывать ссылку для скачивания утилиты интеграции справочных систем».
  2. Нажатием по баннеру «Установить утилиту интеграции справочных систем» скачать архив kАssist.zip.
  3. Распаковать архив kАssist.zip, в котором содержатся файлы:
    • addins — каталог, содержащий каталоги и файлы динамически подключаемых библиотек. Эти библиотеки являются вспомогательными модулями, реализующими панель инструментов «Кодекс» или «Техэксперт» в приложениях офисных пакетов MS Office и LibreOffice, в пакете программ Adobe Acrobat, в приложениях систем КОМПАС-3D, nanoCAD, AutoCAD, Siemens NX, T-FLEX CAD, SOLIDWORKS, Autodesk Inventor;
    • sciter — каталог, содержащий 32- и 64-разрядную версию модуля построения интерфейса приложений;
    • setup.exe — программа регистрации и настройки утилиты;
    • readme.html — инструкция по регистрации и настройке утилиты;
    • link.exe — программа открывает универсальные ссылки на документы информационной системы;
    • core.dll, core64.dll — 32- и 64-разрядная версия модуля ядра интеграции;
    • kinterop.dll — модуль поддержки интеграции;
    • checklinks32.dll, checklinks64.dll — 32- и 64-разрядная версия модуля проверки ссылок;
    • comutils32.dll, comutils64.dll — 32- и 64-разрядная версия модуля COM-утилит интеграции.
  4. Выполнить программу setup.exe.

    Внимание! Для настройки интеграции с Adobe Acrobat Pro, T-FLEX CAD, Siemens NX, nanoCAD 5.1, nanoCAD Plus 6.0, SOLIDWORKS требуется установка утилиты в режиме "для всех пользователей". Для этого следует выполнить программу setup.exe от имени администратора. В окне «Утилита настройки интеграции справочных систем» режим установки "для текущего пользователя" изменить на режим установки "для всех пользователей".
  5. На вкладке «Справочная система» окна «Утилита настройки интеграции справочных систем» изменить, при необходимости, значения следующих параметров:
    • «Справочная система» — указать сетевой адрес и порт информационной системы. По умолчанию значение этого параметра автоматически определяется из конфигурационного файла client.ini.
    • «Приложение для просмотра» — выбрать клиентское приложение, в котором будет открываться информационная система.
    • поле настройки авторизации. Данное поле присутствует на вкладке только в режиме установки "для текущего пользователя". В данном поле может быть выбрано одно из следующих значений: "без авторизации"; "с авторизацией по ключу"; "с авторизацией по логину Windows" (подробнее см. в разделе «Настройка авторизации» настоящего документа).
  6. На вкладке «Приложения для интеграции» окна «Утилита настройки интеграции справочных систем» изменить, при необходимости, значение флажка «Включить интеграцию» (по умолчанию - установлен). Позволяет включить (флажок установлен) или выключить (флажок не установлен) интеграцию сторонних приложений с информационной системой. Если интеграция включена, то на вкладке «Приложения для интеграции» доступны флажки для включения (флажок установлен) или выключения (флажок не установлен) панели инструментов «Кодекс» («Техэксперт») для тех приложений, которые установлены в операционной системе.
  7. На вкладке «Прокси-сервер» окна «Утилита настройки интеграции справочных систем» установить переключатель в требуемый режим:
    • «системные настройки» — использовать настройки прокси в операционной системе.
    • «без прокси-сервера» — соединение не использует прокси-сервер (данный режим действует по умолчанию).
    • «ручные настройки прокси-сервера» — после выбора данного режима ввести сетевой адрес, порт прокси-сервера, а также параметры авторизации на прокси-сервере.
  8. Закрыть окно «Утилита настройки интеграции справочных систем».

Если установка утилиты выполнена в режиме "для текущего пользователя", то исполняемые файлы утилиты (setup.exe, link.exe), конфигурационный файл (.kassist) и динамически подключаемые библиотеки размещаются, в зависимости от операционной системы, в следующем каталоге:

%USERPROFILE%\AppData\Roaming\Kodeks\kassist\ — Windows (Vista, 7, 8, 10)
%USERPROFILE%\Application Data\Kodeks\kassist\ — Windows XP

Если установка утилиты выполнена в режиме "для всех пользователей", то исполняемые файлы утилиты (setup.exe, link.exe), конфигурационный файл (.kassist) и динамически подключаемые библиотеки размещаются в каталоге %ProgramData%\kodeks\kassist.

При необходимости, вы можете менять настройки утилиты c помощью окна «Утилита настройки интеграции справочных систем», которое открывается после выполнения программы setup.exe.

При необходимости, добавить утилиту в исключения политики безопасности операционной системы.

Обратите внимание! В случае обновления версии ИС «Кодекс: 6 поколение» Интранет (ИС «Техэксперт: 6 поколение» Интранет) следует выполнить регистрацию соответствующей ей версии утилиты на рабочем месте локальной сети. Скачайте ее с главной страницы серверной части ИС «Кодекс: 6 поколение» Интранет (ИС «Техэксперт: 6 поколение» Интранет).

Важно! Во время установки/обновления утилиты все приложения, с которыми возможна интеграция, должны быть закрыты.

Установка и настройка утилиты возможна не только посредством графического интерфейса, но и с помощью командной строки. Программа setup.exe поддерживает следующие параметры:

Команды выполняются в порядке их следования в командной строке, например:

D:\kassist\setup.exe /update /config "D:\client.ini" /enable autocad /shared /update /enable tflex

В примере setup.exe запускается в режиме установки/обновления, в качестве конфигурационного файла используется "D:\client.ini", для текущего пользователя включается интеграция с Autocad, для всех пользователей setup.exe также запускается в режиме установки/обновления, включается интеграция с T-FLEX CAD.

Чтобы включить/отключить интеграцию с несколькими приложениями, параметр /enable <addin>(/disable <addin>) следует использовать несколько раз, например:

D:\kassist\setup.exe /update /enable autocad /enable msoffice

Установка утилиты с помощью установочного пакета kassist.msi

Установка утилиты возможна с помощью установочного пакета kassist.msi. Обратите внимание, установочный пакет предоставляется по запросу.

Для установки необходимо:

  1. запустить файл kassist.msi;
  2. указать режим установки "для текущего пользователя"/"для всех пользователей";
  3. выбрать справочную систему, выбрать приложение для просмотра и указать настройки прокси (при необходимости). Если в одной папке с kassist.msi находится файл client.ini от настроенного программного комплекса, адрес справочной системы будет настроен автоматически;
  4. указать приложения, с которыми должна осуществляться интеграция;
  5. настроить ярлыки (при необходимости).

Если установка утилиты выполнена в режиме "для текущего пользователя", то исполняемые файлы утилиты (setup.exe, link.exe), конфигурационный файл (.kassist) и динамически подключаемые библиотеки размещаются, в зависимости от операционной системы, в следующем каталоге:

%USERPROFILE%\AppData\Roaming\Kodeks\kassist\ — Windows (Vista, 7, 8, 10)
%USERPROFILE%\Application Data\Kodeks\kassist\ — Windows XP

Если установка утилиты выполнена в режиме "для всех пользователей", то исполняемые файлы утилиты (setup.exe, link.exe), конфигурационный файл (.kassist) и динамически подключаемые библиотеки размещаются в каталоге %ProgramData%\kodeks\kassist.

На рабочем столе и в меню «Пуск» будут созданы ярлыки на утилиту setup.exe (если при установке были отмечены соответствующие пункты). С их помощью можно открыть интерфейс настроек утилиты и внести изменения в конфигурацию при необходимости.

Настройка авторизации

Если для доступа пользователя к документам ИС «Кодекс: 6 поколение» Интранет (ИС «Техэксперт: 6 поколение» Интранет) требуется авторизация, утилита также должна авторизоваться в ИС «Кодекс: 6 поколение» Интранет (ИС «Техэксперт: 6 поколение» Интранет). Настройка авторизации осуществляется на вкладке «Справочная система» окна «Утилита настройки интеграции справочных систем». Существует два способа авторизации — с помощью ключа доступа и по логину Windows.

Если на виртуальном каталоге серверной части ИС «Кодекс: 6 поколение» Интранет (ИС «Техэксперт: 6 поколение» Интранет), с которым работает пользователь, настроена авторизация "По базе пользователей", следует использовать режим "С авторизацией по ключу". Необходимо зайти в профиль пользователя на странице ИС «Кодекс: 6 поколение» Интранет (ИС «Техэксперт: 6 поколение» Интранет), от имени которого будет происходить авторизация, перейти на вкладку «Ключ доступа» и скопировать ключ. После этого перейти в окно «Утилита настройки интеграции справочных систем», выбрать значение "с авторизацией по ключу" и в появившееся поле вставить скопированный ключ.

Если на виртуальном каталоге серверной части ИС «Кодекс: 6 поколение» Интранет (ИС «Техэксперт: 6 поколение» Интранет), с которым работает пользователь, настроена авторизация "По домену", то на вкладке «Справочная система» окна «Утилита настройки интеграции справочных систем» выбрать режим "С авторизацией по логину Windows".

Удаление утилиты

Если утилита была установлена с помощью программы setup.exe, необходимо:

  1. запустить setup.exe;
  2. на вкладке «Приложения для интеграции» снять флажок «Включить интеграцию»;
  3. удалить каталог kassist.

Если утилита была установлена с помощью программы setup.exe, то удаление можно выполнить из командной строки:

  1. выполнить команду setup.exe /disable;
  2. удалить папку kassist.

Если утилита была установлена с помощью установочного пакета kassist.msi, необходимо:

  1. запустить файл kassist.msi;
  2. нажать кнопку «Удалить».

Также в этом случае утилиту интеграции можно удалить через «Удаление программ» в панели управления Windows.

Дата актуализации: 26.10.2020