Переменные задаются в секции Переменные (variables).

host_fqdn. Адрес сайта, по которому доступна система. По умолчанию заполняется полным доменным именем текущего компьютера. Для работы через Интернет необходимо указать внешнее зарегистрированное DNS-имя сайта, например rx.company.ru.

ВАЖНО. После установки системы изменять адрес сайта не рекомендуется.

home_path. Папка с данными. В указанной папке создаются подпапки для хранения содержимого документов, лог-файлов, файлов предпросмотра и других данных. Если часть данных нужно хранить в отдельных папках, после установки измените путь в соответствующей настройке конфигурационного файла.

protocol. Протокол для работы с системой. Возможные значения: https, http. Значение по умолчанию https. Для работы рекомендуется использовать защищенный протокол HTTPS. Протокол HTTP можно использовать только для установки среды разработки или ознакомления с системой, т.к. в этом случае данные между клиентом и сервером передаются в открытом виде.

http_port. Порт для работы с системой по протоколу HTTP. Значение по умолчанию 80.

https_port. Порт для работы с системой по протоколу HTTPS. Значение по умолчанию 443. Порт используется, если в переменной protocol указано значение https.

Настройки прокси-сервера задаются в секции HAProxy (SungeroHaproxy).

haproxy_config – путь к конфигурационному файлу HAProxy.

ssl_cert – путь к SSL-сертификату, который используется для работы по протоколу HTTPS.

Пример:

SungeroHaproxy:

    haproxy_config: '{{ home_path }}/haproxy/haproxy.cfg'
    ssl_cert: '{{ home_path }}/haproxy/rxcompany.pem'
    http_port: # auto
    https_port: # auto

Настройки задаются в секции Общие настройки (common_config).

DATABASE_ENGINE. Тип СУБД, которая используется для хранения данных системы Directum RX. Возможные значения: mssql – Microsoft SQL Server, postgres – PostgreSQL/Postgres Pro/Jatoba. При использовании Linux значение по умолчанию postgres, при использовании Microsoft Windows значение по умолчанию mssql.

CONNECTION_STRING. Строка подключения к базе данных в формате ADO.NET. Подробнее о технологии ADO.NET см. в документации Microsoft.

Параметры строки подключения к СУБД на основе PostgreSQL:

•Server – имя сервера с базой данных;

•Port – порт для подключения. По умолчанию используется порт 5432;

•Database – имя базы данных;

•User ID – имя пользователя сервера БД. Используется для взаимодействия системы с базой данных. Пользователю достаточно входить в роль с атрибутом login. В этом случае пользователю недоступны другие базы сервера БД.

Если для создания базы данных и для взаимодействия системы с базой данных используется один и тот же пользователь, то в параметре User ID укажите пользователя с правами администратора. В этом случае он должен входить в роль с атрибутом superuser на сервере БД;

•Password – имя и пароль пользователя сервера БД. Использование пустого пароля не допускается. Также пароль не должен содержать спецсимволы, которые не обрабатываются СУБД.

Пример:

CONNECTION_STRING: 'Server=DBServer;Port=5432;Database=DirectumRX;User Id=dbuser;Password=11111'

Параметры строки подключения к Microsoft SQL Server:

•Data Source – имя сервера базы данных. По умолчанию для подключения используется порт 1433. Если нужно задать другой порт, укажите его в параметре через запятую;

•Initial Catalog – имя базы данных;

•User ID – имя пользователя сервера БД. Используется для взаимодействия системы с базой данных. Пользователю достаточно входить в роль public. В этом случае пользователю недоступны другие базы сервера БД.

Если для создания базы данных и для взаимодействия системы с базой данных используется один и тот же пользователь, то в параметре User ID укажите пользователя с правами администратора. В этом случае он должен входить в роль sysadmin на сервере БД. Для повышения информационной безопасности не рекомендуется указывать стандартного пользователя sa;

•Password – пароль пользователя сервера БД. Использование пустого пароля не допускается.

Пример в config.yml:

CONNECTION_STRING: 'Data Source=DBServer,1430;Initial Catalog=DirectumRX;User ID=dbuser;Password=11111'

ПРИМЕЧАНИЕ. В строке подключения к Microsoft SQL Server и СУБД на основе PostgreSQL можно задать дополнительные параметры: Timeout – тайм-аут подключения в секундах, например 30, и Encoding – кодировка строки подключения, например UTF8.

Настройки задаются в секции Общие настройки (common_config).

QUEUE_CONNECTION_STRING. Строка подключения к RabbitMQ. В строке задаются:

•hostName – IP-адрес сервера, на котором установлен RabbitMQ;

ВАЖНО. Если RabbitMQ установлен на том же сервере, что и Directum RX, в качестве адреса нельзя использовать значение 127.0.01. Вместо этого укажите внешний IP-адрес сервера.

•port – порт, по которому RabbitMQ взаимодействует с веб-сервером. По умолчанию 5672;

•virtualhost – имя виртуального хоста RabbitMQ. По умолчанию «/»;

•userName, password – имя и пароль пользователя для подключения к RabbitMQ. Пользователь создается на этапе установки RabbitMQ;

•exchange – имя точки обмена, к которой привязываются очереди сообщений веб-сервера. Также используется для наименования очередей сообщений.

ВАЖНО. Для значений параметров RabbitMQ учитывается регистр символов.

Пример в config.yml:

QUEUE_CONNECTION_STRING: 'hostName=192.168.3.18;port=5672;virtualhost=rxhost;userName=admin;password=123456;exchange=RxExchange'

Если RabbitMQ разворачивается в кластере, то задаются другие настройки.

Дополнительно можно задать настройки панели управления RabbitMQ.

Настройки задаются в секции Общие настройки (common_config).

MONGODB_CONNECTION_STRING. Строка подключения к MongoDB. В строке задаются:

•имя и пароль пользователя;

•IP-адрес сервера, на котором установлена MongoDB;

•порт, по которому MongoDB взаимодействует с сервисами Directum RX. Значение по умолчанию 27017.

ВАЖНО. Для значений параметров MongoDB учитывается регистр символов.

Пример в config.yml:

MONGODB_CONNECTION_STRING: 'mongodb://admin:11111@192.168.23.58:27017'

ПРИМЕЧАНИЕ. После обновления системы с версии 4.1 в конце строки подключения остаются дополнительные параметры: …/Sungero_PreviewStorage?authSource=admin. С версии 4.2 их указывать не нужно.

Настройки задаются в секции Общий сервис (GenericService). Если сервис виджетов развернут отдельно, то настройки задаются в секции Сервис виджетов (SungeroWidgets).

WIDGETS_ORLEANS_SILO_MONGO_CLUSTERING_DATABASE_NAME. Имя базы данных MongoDB, где хранится информация о кластере сервиса виджетов. Значение по умолчанию sungero_widgets_clustering.

WIDGETS_ORLEANS_SILO_MONGO_GRAIN_STORAGE_DATABASE_NAME. Имя базы данных MongoDB, где хранятся данные виджетов. Значение по умолчанию sungero_widgets.

Пример настройки в config.yml:

WIDGETS_ORLEANS_SILO_MONGO_CLUSTERING_DATABASE_NAME: 'sungero_widgets_clustering'

WIDGETS_ORLEANS_SILO_MONGO_GRAIN_STORAGE_DATABASE_NAME: 'sungero_widgets'

Настройка задается в секции Общие настройки (common_config).

AUTHENTICATION_USERNAME. Имя служебного пользователя Directum RX. Значение по умолчанию Service User.

AUTHENTICATION_PASSWORD. Пароль служебного пользователя.

При необходимости можно указать пользователя с Windows-аутентификацией. Подробнее см. в разделе с общими настройками.

В параметре UTC_OFFSET укажите смещение часового пояса относительно UTC для веб-сервера. Значение по умолчанию такое же, как в настройках часового пояса операционной системы. Параметр обязательный для заполнения.

Пример:

UTC_OFFSET: '4'

Настройки задаются в секции Общие настройки (common_config).

PRIMARY_TENANT. Код системы. Используется в работе сервисов Directum RX и в штрихкодах документов. Параметр должен быть уникальным для каждой новой установленной системы Directum RX. Для продуктивной системы запросите код в службе поддержки Directum RX.

LANGUAGE. Язык системы. Возможные значения: ru-ru, en-us. Значение по умолчанию ru-ru. На выбранном языке будут отображаться данные, которые создаются:

•при установке системы, например наименования видов документов, шаблонов;

•автоматически, например тексты задач и заданий, указанные по умолчанию.

При этом язык интерфейса веб-клиента Directum RX по умолчанию будет таким же, как язык операционной системы. Пользователи могут изменить язык интерфейса в проводнике системы.

Примечание. Администратор может отключить неиспользуемые языки.

Данные в системе отображаются на том языке, на котором их занесли в систему. Их можно заносить на любом языке и любыми символами, независимо от основного языка системы. Все данные хранятся в кодировке Unicode.