1. Установка плагина в ручную

Важно: в случае создания БД CRM конвертацией из БД ПДС, необходима частичная ручная настройка отчетов, в частности выполнить шаги из п.2 и п.5.

1.1. Состав пакета ПО

Плагин интерактивных отчетов поставляется в виде архива CRM_IR_reports_ver.zip. Загрузить архив можно по адресу: ftp://ftp.ucs.ru/R-Keeper.CRM/versions/.

Архив содержит следующие основные папки:

папка \PluginsFS с feature server и его конфигурационным файлом;
папка \Bin\plugins с библиотекой плагина интерактивных отчетов и ее конфигурационными файлами;
папка \IAReport_views со скриптами для обновления БД SQL.

После распаковки архива нужно:

Скопировать 3 папки (PluginsFS, Bin, IAReport_views) в папку с установленным R-Keeper CRM c заменой *.dll;
установить (если нет) и запустить Common server;
обновить БД R-Keeper CRM, используя 3 скрипта;
настроить ini файл feature server и запустить feature server;
настроить ini файлы библиотеки плагина интерактивных отчетов.

1.2. Подготовка БД

Подготавливаем БД, создав необходимые для работы плагина интерактивных отчетов представления. Представления создаются скриптами из архива IAReport_views.7z, они находятся в корневой папке IAReport_views данного дистрибутива. Необходимо выполнить для БД CRM все 4 скрипта, в произвольном порядке.

1.3. Настройка и запуск Feature server (IRReportsFSPrj.exe)

Следует настроить ini-файл feature server. Для этого нужно в папке X:\CRM\PluginsFS\ переименовать файл example_IRReportsFSPrj.ini в IRReportsFSPrj.ini и отредактировать его, задав:

- адрес и порт CommonServer в секции [CS_CONNECTION],
- UDL строку для подключения к БД CRM в секции [FS_TYPE],
- имя экземпляра в секции [FS_TYPE],
- а так же адрес и порт самого feature server (IP адрес локального ПК, порт можно оставить указанный по-умолчанию) в секции [FS_CONNECTION].

Пример ниже, описанные изменения выделены красным шрифтом:

[FS_CONNECTION]

url=http://192.168.101.189:8888/soap/IStructuresInfo

start_port=8888

DB_Connect_Count=10

ConnectTimeout = 9000000

ReceiveTimeout = 9000000

SendTimeout = 9000000

CommandTimeOut = 900000000

[CS_CONNECTION]

url=http://192.168.101.189:7007/soap/UCSCommonWS

[FS_TYPE]

i_Guid={5A3EF192-4FD6-43DD-98FE-71E953CCF6E5}

// если i_Guid в ини-файле отсутствует, то прописать указанныей выше (выделено желтым цветом)

instance_name=уникальное_в_системе_имя_экземпляра

MasterServer=1

connection_string = Provider=SQLOLEDB.1;Password=somesecretpwd;Persist Security Info=True;User ID=sa;Initial Catalog=CARD_SYSTEM;Data Source=localhost

MainLang=FeatureServPrj.rus

loglevel=4

Sleep=-1

[FS_MAILING]

///**** если настроена E-Mail рассылка отчетов, то необходимо указать Mailing=1 *****///

Mailing=0

Далее нужно запустить FeatureServPrj.exe с ключом /install для установки службы, и запустить службу FS_имя_экземпляра. После запуска службы нужно вновь открыть IRReportsFSPrj.ini и скопировать значение параметра i_Guid из секции [FS_TYPE] (выделено синим цветом). Это значение нужно будет указать при настройке параметров библиотеки плагина интерактивных отчетов. На этом настройка feature server закончена.

1.4. Настройка плагина

Параметры библиотеки плагина интерактивных отчетов настраиваются в файле X:\CRMBin\plugins\SchRepPluginClient\SchRepPluginClient.ini. Он создается переименованием уже существующего в этой папке файла example_SchRepPluginClient.ini в SchRepPluginClient.ini. В секции [CS_CONNECTION] нужно в параметре fs_guid указать скопированное в п.1.2 значение параметра i_Guid, а также настроить такие же, как на при настройки feature server, адрес и порт CommonServer. Пример ниже:

[CS_CONNECTION]

ConnectTimeout = 9000000

ReceiveTimeout = 9000000

SendTimeout = 9000000

url=http://192.168.101.189:7007/soap/UCSCommonWS

fs_guid = {5A3EF192-4FD6-43DD-98FE-71E953CCF6E5}

[CL_TYPE]

i_Guid={3CCB6AB2-7F47-4254-9BAF-20562E3D6239}

1.5. Настройка загрузчика отчетов

Необходимо отредактировать файл настроек загрузчика отчетов ManagmentSettings.ini, предварительно переименовав его из example_ManagmentSettings.ini (X:\CRM\Bin\plugins\SchRepPluginClient\). (в папке \CRM\Bin\plugins\SchRepPluginClient\).

В файле нужно указать GUID и пароль любого существующего в БД CRM пользователя.

Пример запроса для получения нужных данных пользователя из БД CRM:

select top 1 guidstring, passdata from employees

GUID указывается в параметре user_guid, хэш пароля — в параметре hash_pass. Примеры в секции [rk7EditorPluginConfig] файла ManagmentSettings.ini ниже, описываемые параметры выделены красным шрифтом:

[langauge]

langFile="D:\CRM\Bin\PLuginsLoader.rus"

langName=русский

[rk7EditorPluginConfig]

user_name=Admin

asMDI=1

user_id=1

user_guid={EE42AA86-DDDD-426A-A614-9D16AB332AE2}

// Наличие здесь фигурных скобок обязательно(выделено желтым выше)

role_guid=CD8F407F-CF5C-4B1F-A7F3-069190F5D98A

curlocation_guid=4322407F-CF5C-4B1F-A7F3-069192343242

hash_pass=C4CA4238A0B923820DCC509A6F75849B

[rk7EditorPluginConfInfo]

username={AE1415FB-0A08-41E8-860A-CE5A3CF609C6}

password={38FCB03E-B95A-484A-A3D0-A049D23C79E7}

Помимо этого, в файле ManagmentSettings.ini нужно указать полный путь к русификатору загрузчика в параметре langFile. На этом настройку можно считать законченной.

1.6. Запуск загрузчика отчетов

Рекомендуется создать на рабочем столе пользователя ярлык для запуска загрузчика отчетов. Загрузчик запускается файлом X:\..\CRM_IR_reports\Bin\reports.cmd, в нем уже указаны все необходимые параметры запуска загрузчика.

Запуск следует делать от имени Администратора!

Импорт предустановленных отчетов происходит автоматически при первом запуске feature server.

Если все настройки верны, откроется окно загрузчика отчетов (рис.1)

Рис.1 Главное окно Загрузчика отчетов

Импорт ИА отчетов вручную

ИА Отчеты так же можно импортировать вручную с помощью кнопки "Импортировать из XML" в справочнике "Меню -> ИА Отчеты".

Рис.2. Импорт ИА Отчетов вручную