.. _configuring-type-rfc: Настройка интеграции с ИМ посредством RFC ----------------------------------------- .. important:: Интеграция с системой SAP по RFC доступна для использования только для ОС Windows. Для обеспечения передачи данных между модулем xDE для SAP и ИМ через RFC-соединение необходимо выполнить :ref:`установку и настройку сервиса SAP RFC`, :ref:`настроить RFC в Dashboard`, а также выполнить в системе SAP следующие настройки: * :ref:`указать тип взаимодействия с ИМ – RFC`; * :ref:`создать сервисного пользователя – XDERFCUSER`; * :ref:`создать RFC-адрес назначения – TERRALINK_XDE`. .. _sap-rfc-service: Установка и настройка сервиса SAP RFC ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Установка сервиса SAP RFC """""""""""""""""""""""""""""""" Для установки сервиса SAP RFC необходимо выполнить следующие действия. #. Создайте папку ``C:\Program Files (x86)\TerraLink xDE SAP RFC``. #. Скопируйте файлы из поставки Продукта (содержимое папки ``SapRfc Windows Service``) в созданную папку. #. Выполните команду ``Install.ps1`` (рекомендуется запустить Windows Power Shell с правами администратора), при этом можно задать системное имя сервиса (параметр ``ServiceName``) и название сервиса для отображения (параметр ``ServiceDisplayName``). Без указания данных параметров сервис будет установлен под названием **TerraLink.xDE.Api.SapRfc**. .. code:: doscon Install -ServiceName 'Имя сервиса при установке' -ServiceDisplayName 'Наименование сервиса для отображения' #. После завершения работы команды перейдите в оснастку ``Services (Службы)`` и убедитесь, что в списке сервисов присутствует созданный сервис. #. Откройте свойства сервиса, перейдите на вкладку ``Log On (Вход в систему)`` и установите переключатель в значение ``This Account (С учетной записью)``. Введите логин и пароль пользователя, от имени которого будет запускаться приложение. .. important:: Сервис SAP RFC может работать под локальной учетной записью, либо от имени пользователя, имеющего права локального администратора на сервере. В случае если для доступа к базе данных используется режим проверки подлинности Windows, пользователь, от имени которого запускается приложение, должен иметь доступ к базе данных. Удаление сервиса SAP RFC """"""""""""""""""""""""""""""""""" Чтобы удалить сервис SAP RFC, выполните команду ``Uninstall.ps1`` (рекомендуется запустить Windows Power Shell с правами администратора), указав в качестве параметра ``ServiceName`` название сервиса, который необходимо удалить (если параметр не указан, то будет удален сервис с названием **TerraLink.xDE.Api.SapRfc**). .. code:: doscon Uninstall -ServiceName 'Имя сервиса при установке' Настройка конфигурационных файлов """""""""""""""""""""""""""""""""""""" Для корректной работы сервиса SAP RFC необходимо настроить конфигурационные файлы в папке компонента. .. important:: Примеры настраиваемых конфигурационных файлов из поставки, скопированные в папку компонента, необходимо переименовать, убрав ``.demo`` из имени файла, например: ``NLog.config.demo`` => ``NLog.config``. Настройка подключения к Integration API ```````````````````````````````````````` Перед запуском сервиса SAP RFC необходимо задать настройки подключения к Integration API в конфигурационном файлe ``appsettings.json``, указав (изменив) параметры: * ApiConnectAddress – адрес Integration API Продукта; * Login – имя пользователя Продукта; * Password – пароль пользователя Продукта. Пример конфигурационного файла: .. code:: json { "ApiConnectAddress": "http://localhost:6001/api/", "Login": "admin@domain.com", "Password": "1234aA" } Настройка логирования ``````````````````````````` Для настройки логирования используется конфигурационный файл ``NLog.config``. Путь к директории, в которой будут храниться логи, настраивается с помощью атрибута ``fileName`` элемента ``target``. По умолчанию используется путь ``%%PROGRAMDATA%\TerraLink.xDE\Logs\SapRfc``. .. note:: Подробную информацию о настройке конфигурационного файла можно получить на сайте с документацией NLog по ссылке https://github.com/nlog/nlog/wiki. Настройка служб соединения """""""""""""""""""""""""""""""""""""""" На сервере, где установлен сервис SAP RFC , в ``C:\Windows\System32\drivers\etc\services``, должны быть прописаны следующие службы соединения для взаимодействия с SAP. .. list-table:: Список служб соединения :widths: 10 10 40 * - sapmsXXX - 3601/tcp - # SAP System Message Server Port * - sapdp00 - 3200/tcp - # SAP System Dispatcher Port * - sapgw00 - 3300/tcp - # SAP System Gateway Port * - sapdp00s - 4700/tcp - # SAP System Dispatcher Security Port * - sapgw00s - 4800/tcp - # SAP System Gateway Security Port Запуск и остановка сервиса SAP RFC """"""""""""""""""""""""""""""""""""""""""""""" Для запуска сервиса SAP RFC необходимо открыть оснастку ``Services (Сервисы)``, выделить в списке соотвествующий сервис, вызвать контекстное меню и выполнить команду ``Start (Запустить)``. Для остановки работы сервиса необходимо выполнить команду ``Stop (Остановить)``. Для перезапуска сервиса необходимо выполнить команду ``Restart (Перезапустить)``. .. _dashboard-rfc: Настройка RFC в Dashboard ~~~~~~~~~~~~~~~~~~~~~~~~~ Для работы сервиса SAP RFC необходимо выполнить настройку RFC в Dashboard Продукта. Для просмотра и редактирования настроек RFC необходимо на странице с настройками выбрать пункт меню ``RFC`` или перейти по адресу: ``{адрес:порт}/settings/saprfc``. Откроется страница, на которой находится форма с настройками RFC. На форме находятся 2 вкладки: * Подключение; * Ящики. На вкладке ``Подключение`` находятся поля для ввода настроек подключения RFC, таких как: интервалы получения/отправки документов, IP-адреса SAP и прочие. .. note:: Описание параметров RFC см. `Параметры RFC`_. .. image:: dashboard-1.png :scale: 100 % :align: center :alt: Настройки RFC На вкладке ``Ящики`` содержится список ящиков, которые использует SAP. .. image:: dashboard-2.png :scale: 70 % :align: center :alt: Ящики, которые использует SAP Для изменения настроек RFC заполните необходимые поля. Для сохранения введенных параметров нажмите кнопку ``Сохранить``. В случае успешного сохранения появится соответствующие сообщение. .. image:: Dashboard_DataSavedSuccessfully.png :scale: 100 % :align: center :alt: Сообщение об успешном сохранении данных Параметры RFC """""""""""""" Описание параметров RFC приведено в таблице ниже. .. list-table:: Параметры RFC :widths: 40 40 20 :header-rows: 1 * - Название параметра - Описание - Обязательность * - Использовать SAP RFC - Включение или выключение работы ИМ по RFC - Да * - Интервал получения исходящих документов из SAP - Интервал получения исходящих документов из SAP - Да * - Интервал отправки входящих документов в SAP - Интервал отправки входящих документов в SAP - Да * - Имя хоста SAP Gateway - Имя хоста SAP Gateway - Да * - Порт SAP Gateway - Порт SAP Gateway - Да * - Номер инстанции - Номер инстанции - Да * - Имя пользователя SAP - Имя пользователя SAP - Да * - Пароль пользователя SAP - Пароль пользователя SAP - Да * - Мандант SAP - Мандант SAP - Да * - Язык подключения к SAP - Язык подключения к SAP - Да * - Размер пула - Размер пула - Да * - Максимальное количество соединений - Максимальное количество соединений - Да * - Идентификатор приложения - Идентификатор приложения - Да * - Количество подключений, которые RFC-сервер первоначально регистрирует - Количество подключений, которые RFC-сервер первоначально регистрирует - Да .. _sap-rfc-user: Создание сервисного пользователя XDERFCUSER ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ В системе SAP должен быть создан сервисный пользователь **XDERFCUSER** с постоянно действующим паролем. Для создания сервисного пользователя необходимо выполнить следующие действия. #. Запустите транзакцию ``SU01``. .. image:: ris45.png :scale: 74 :align: center :alt: Запуск транзакции SU01 #. Откроется страница **Ведение пользователей: первый экран**. Введите техническое имя пользователя и нажмите |new| (Создать). .. image:: ris46.png :scale: 89 :align: center :alt: Переход к созданию пользователя #. В открывшемся окне ``Ведение пользователей`` на закладке ``Адрес`` заполните соответствующие поля данными о пользователе, указанными в таблице ниже. .. image:: ris47.png :scale: 53 :align: center :alt: Ведение сервисного пользователя XDERFCUSER (Адрес) #. Перейдите на закладку ``Данные входа`` и заполните соответствующие поля данными, указанными в таблице ниже. .. image:: ris48.png :scale: 53 :align: center :alt: Ведение сервисного пользователя XDERFCUSER (Данные входа) #. Перейдите на закладку ``Роли`` и присвойте пользователю роль ``/TRL/XDE_SERVICEUSER``. Нажмите |save|. .. image:: ris49.png :scale: 53 :align: center :alt: Ведение сервисного пользователя XDERFCUSER (Роли) .. table:: Данные о сервисном пользователе XDERFCUSER :align: center :widths: 8 8 +-------------------------------+---------------------------------------------+ | Имя поля | Значение | +===============================+=============================================+ | Закладка ``Адрес`` | +-------------------------------+---------------------------------------------+ | Фамилия | TerraLink xDE | +-------------------------------+---------------------------------------------+ | Полное имя | TerraLink xDE (заполняется автоматически) | +-------------------------------+---------------------------------------------+ | Язык | Русский | +-------------------------------+---------------------------------------------+ | Функция | Сервисный пользователь | +-------------------------------+---------------------------------------------+ | Закладка ``Данные входа`` | +-------------------------------+---------------------------------------------+ | ТипПользов | Сервис | +-------------------------------+---------------------------------------------+ | Пароль | <произвольный> | +-------------------------------+---------------------------------------------+ | Закладка ``Роли`` | +-------------------------------+---------------------------------------------+ | Роль | ``/TRL/XDE_SERVICEUSER`` | +-------------------------------+---------------------------------------------+ .. _sap-rfc-adress: Создание RFC-адреса назначения TERRALINK_XDE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Для осуществления двухстороннего взаимодействия с ИМ необходимо создать RFC-адрес назначения *TERRALINK_XDE*. .. important:: Сервис ИМ должен быть запущен до создания RFC-адреса назначения. Для создания RFC- адреса назначения необходимо выполнить следующие действия. #. Запустите транзакцию **SM59**. .. image:: ris50.png :scale: 67 :align: center :alt: Запуск транзакции ``SM59`` #. Откроется страница **Конфигурация RFC-соединений**. Нажмите кнопку |new| (Создание). .. image:: ris51.png :scale: 68 :align: center :alt: Переход к созданию RFC-адреса назначения #. В открывшемся окне **RFC-адрес назначения** заполните соответствующие поля данными, указанными в таблице ниже, и нажмите |save|. .. list-table:: Данные RFC-адреса :align: center :widths: 10 10 :header-rows: 1 * - Имя поля - Значение * - RFC-адрес - TERRALINK_XDE * - Тип соединения - T (TCP/IP-соединение) * - Описание 1 - Terralink xDE Обработка документов ЭП .. image:: ris52.png :scale: 67 :align: center :alt: Заполнение полей для RFC-адреса назначения #. После сохранения введите следующие данные на закладке **Тех. параметры настройки**: - Вид активации – Флаг: Зарегистрированная ПрСервера; - Ид.прогр. – TerraLink_xDE. Затем снова нажмите |save|. .. image:: ris53.png :scale: 66 :align: center :alt: Ведение данных на закладке «Тех. параметры настройки» Внизу экрана появится сообщение |message1| Проверка RFC-соединения ~~~~~~~~~~~~~~~~~~~~~~~ Для проверки корректности работы созданного соединения запустите его тестирование. Нажмите кнопку ``Тест соединения``. .. image:: ris54.png :scale: 71 :align: center :alt: Запуск теста RFC-соединения Успешное завершение теста свидетельствует об успешно установленном RFC-соединении. .. image:: ris55.png :scale: 62 :align: center :alt: Результаты теста успешного RFC-соединения При отсутствии соединения страница с результатами теста показывает ошибку. .. image:: ris56.png :scale: 77 :align: center :alt: Результаты теста при ошибке RFC-соединения Одной из причин ошибки могут быть настройки безопасности шлюза SAP для RFC-соединения. Чтобы проверить настройки шлюза, выполните следующие действия. #. Запустите транзакцию ``SMGW``. .. image:: ris57.png :scale: 72 :align: center :alt: Запуск транзакции SMGW #. Для просмотра настроек безопасности шлюза для запускаемых программ в меню в верхней части экрана выберите ``Перейти к`` -> ``"Экспертные" функции`` -> ``Внешняя безопасность`` -> ``Просмотр (secinfo)``. .. image:: ris58.png :scale: 65 :align: center :alt: Переход к просмотру настроек шлюза SAP (безопасность для запускаемых/зарегистрированных программ) Параметры в записи **secinfo** должны принимать следующие значения: **P TP=\* USER=\* HOST=\*.**. .. image:: ris59.png :scale: 70 :align: center :alt: Необходимые значения параметров в записи secinfo #. Для просмотра настроек безопасности зарегистрированных программ выберите ``Перейти к`` -> ``“Экспертные” функции`` -> ``Внешняя безопасность`` -> ``Просмотреть (reginfo)``. Параметры в записи **reginfo** должны принимать следующие значения: **P TP=\***. .. image:: ris60.png :scale: 70 :align: center :alt: Необходимые значения параметров в записи reginfo .. |search2| image:: search2.png :width: 42 :height: 36 .. |save| image:: save.png :width: 29 :height: 27 .. |new| image:: new.png :width: 28 :height: 28 .. |message1| image:: message1.png :width: 278 :height: 58 .. |run| image:: run.png :width: 27 :height: 28 .. |back| image:: back.png :width: 24 :height: 33