Установка Integration API

Для установки Integration API требуется скопировать его файлы в целевую папку. Для этого нужно выполнить команду:

Copy-Item ".\TerraLink.xDEPro\Integration.REST" -Destination "$($env:ProgramFiles)\TerraLink.xDEPro\Integration\Integration.REST" -Recurse

Настройка подключения к базе данных

Теперь нужно настроить подключение Integration API к базе данных. Для этого требуется переименовать демонстрационный конфигурационный файл с шаблоном подключения к SQL Server в конфигурационный файл, который будет использоваться Integration API:

Rename-Item -Path "$($env:ProgramFiles)\TerraLink.xDEPro\Integration\Integration.REST\appsettings.SqlServer.json.demo" -NewName "appsettings.json"

Далее нужно открыть конфигурационный файл в текстовом редакторе:

notepad "$($env:ProgramFiles)\TerraLink.xDEPro\Integration\Integration.REST\appsettings.json"

найти поле ConnectionString, заменить имя экземпляра SQL Server и задать имя пользователя и пароль назначенной учетной записи:

{
    "ProviderName": "Microsoft.Data.SqlClient",
    "ConnectionString": "Server=.\\SQLEXPRESS;Database=DOCFLOW_DB;User Id=sa;Password=1234aA;MultipleActiveResultSets=true;Max Pool Size=500;TrustServerCertificate=True"
}

Затем нужно сохранить файл (Ctrl+S) и выйти из редактора.

Примечание

Если планируется использовать SQL Server, установленный на другой машине, то в строке подключения нужно указать имя хоста (либо IP-адрес) и порт установленного экземпляра SQL Server.

Настройка доступа к Integration API через IIS

Для настройки доступа к Integration API через IIS требуется открыть приложение IIS Manager.

Создание пула приложений

В IIS Manager выбрать элемент «Application Pools» и в его контекстном меню выбрать команду «Add Application Pool…»:

IIS-AddApplicationPool-Menu

Затем нужно задать параметры пула:

  • Name: xde-integration-api

  • .NET CLR Version: No Managed Code

Остальные параметры оставить без изменений и нажать кнопку OK:

InstallingApi-1

Теперь нужно задать учетную запись для работы пула приложений. Для этого выбрать пул в списке и справа на панели «Actions» выбрать действие «Advanced Settings…»:

InstallingApi-2

В окне «Advanced Settings» нужно найти настройку «Identity» и нажать кнопку ...:

IIS-ApplicationPool-Identity

В окне «Application Pool Identity» выбрать «Custom account» и нажать кнопку Set...:

IIS-ApplicationPool-Custom-Account

В окне «Set Credentials» задать имя пользователя, от имени которого ведется установка Продукта, его пароль, и подтвердить пароль. После этого нажать кнопку OK:

IIS-ApplicationPool-Custom-Account-Details

Затем нажать кнопку OK в окне «Application Pool Identity» и в окне «Advanced Settings».

Создание сайта

В IIS Manager выбрать элемент «Sites» и в его контекстном меню выбрать команду «Add Website…»:

IIS-Add-Site

Затем нужно задать параметры сайта:

  • Site name: xde-integration-api

  • Application pool: xde-integration-api

  • Physical path: C:Program FilesTerraLink.xDEProIntegrationIntegration.REST

  • Port: 6101

Остальные параметры оставить без изменений и нажать кнопку OK:

InstallingApi-3

Добавление правила в настройки Firewall

Для того чтобы Integration API был доступен снаружи, в настройки Firewall нужно добавить правило, открывающее порт созданного сайта. Для этого в строке поиска нужно набрать текст «advanced security» и в результатах поиска выбрать приложение «Windows Defender Firewall with Advanced Security»:

Firewall-Search

В окне приложения выбрать элемент «Inbound Rules» и в его контекстном меню выбрать команду «New Rule…»:

Firewall-New-Rule-Menu

Тип правила установить в значение Port и нажать кнопку Next:

Firewall-Rule-Type

Далее нужно указать значение порта для созданного сайта и нажать кнопку Next:

InstallingApi-4

Далее нужно разрешить подключение и нажать кнопку Next:

Firewall-Allow-Connection

Далее выбрать типы сетей, из которых разрешено подключение (по умолчанию подключение разрешено из всех), и нажать кнопку Next:

Firewall-Profiles

Далее нужно задать имя для правила и нажать кнопку Finish:

InstallingApi-5

Проверка доступности Integration API

Для проверки доступности Integration API нужно открыть браузер на машине, отличной от той, на которую производится установка. В адресной строке браузера указать имя или IP-адрес целевой машины и порт:

http://192.168.11.128:6101

В ответ в браузере должна открыться страница Swagger UI.