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

Пример в config.yml:

GIT_ROOT_DIRECTORY: 'C:\EE'

        REPOSITORIES:
            repository:
            -   '@folderName': 'Work'
                '@solutionType': 'work'
                '@url': 'http://localhost:3000/DirectumRX/work.git'
            -   '@folderName': 'base'
                '@solutionType': 'Base'
                '@url': 'http://localhost:3000/DirectumRX/base.git'

При первом запуске среды разработки из удаленного репозитория по адресу, указанному в атрибуте url, в репозиторий Work копируются исходные коды разрабатываемых решений, а в Base – исходные коды базовых решений. На основании исходных кодов из рабочей папки в среде разработки формируется дерево решений. Если нужно подключиться к другому удаленному репозиторию:

1.Создайте новую рабочую папку и укажите путь до нее в параметре GIT_ROOT_DIRECTORY.

2.В секции REPOSITORIES у локальных репозиториев Work и Base измените путь до удаленного репозитория.

В перекрытых модулях и типах сущностей к именам свойств, действий и другим настройкам дописывается постфикс с кодом компании. В среде разработки постфикс недоступен для изменения и удаления. При обновлении Directum RX на новую версию он помогает избежать конфликтов между одинаковыми именами в базовом решении и вашем.

Чтобы изменить код компании, используйте параметр COMPANY_CODE. Если планируется распространять разработанные решения, то код компании необходимо запросить в службе поддержки Directum RX.

Для среды разработки можно исключить использование уникальных имен при перекрытии. Для этого используйте параметр UNIQUE_NAMES_IN_OVERRIDES:

•установите флажок (true) – при добавлении свойств, действий и других элементов разработки в перекрытых модулях и типах сущностей к их именам добавляется код компании, указанный в параметре COMPANY_CODE;

•снимите флажок (false) – к именам перекрытых элементов разработки код компании не добавляется.

Используйте параметр LANGUAGE, чтобы изменить язык отладочного веб-сервера вне контекста обработки запроса. При обработке запроса используется язык клиентского приложения, отправившего запрос. Возможные значения: RU-ru – русский, EN-us – английский. По умолчанию RU-ru.

Отладочный веб-сервер работает с помощью агента управления сервисами (ServiceRunner). Для этого в конфигурационном файле заданы параметры:

•SERVICE_RUNNER_CONFIG_PATH – полный путь до конфигурационного файла агента управления сервисами;

•WEB_SERVER_SERVICE_NAME – имя, под которым веб-сервер указан в конфигурационном файле агента управления сервисами.

Если параметр SERVICE_RUNNER_CONFIG_PATH указан, то для корректной работы:

•проверьте, что в секции агента управления сервисами (ServiceRunner) есть параметры для веб-сервера;

•в среде разработки в главном меню выберите пункты Инструменты, Параметры... и проверьте, что в группе «Настройки клиента» в выпадающем списке Тип клиента выбран Веб-клиент. Если выбран Десктоп-клиент, возникнет ошибка.

Если для тестирования разработки нужно изменить адреса до отладочных сервисов используйте параметры:

•LOCAL_SERVER_RELATIVE_PATH – адрес отладочного локального веб-сервера (без указания имени хоста, так как подразумевается localhost);

•LOCAL_WORKFLOW_PATH – адрес отладочного локального сервиса Workflow (без указания имени хоста, так как подразумевается localhost);

•LOCAL_WORKER_PATH – адрес сервиса асинхронных событий Worker (без указания имени хоста, так как подразумевается localhost). Адрес используется для остановки сервиса при публикации разработки. После публикации агент управления сервисами ServiceRunner автоматически перезапускает сервис Worker;

•LOCAL_WEB_RELATIVE_PATH – адрес отладочного веб-клиента;

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

Если RabbitMQ для тестирования разработки переустановили на другой сервер, настройте подключение к нему. Для этого в параметре QUEUE_CONNECTION_STRING измените настройки:

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

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

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

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

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

ВАЖНО. Если компоненты RabbitMQ не установлены, то после обновления веб-сервер не запустится.

В среде разработки для входа на отладочный веб-сервер можно использовать Windows-аутентификацию. Настройка задается в параметре IS_WINDOWS_AUTHENTICATION_ACCEPTED. Возможные значения:

•true – Windows-аутентификация разрешена. При запуске среды разработки происходит попытка входа на веб-сервер под учетной записью текущего пользователя. Если аутентификация не проходит, то появляется окно для ввода имени пользователя или пароля;

•false – Windows-аутентификация не используется. При запуске среды разработки необходимо вводить данные учетной записи.

Чтобы корректно применять настройки бизнес-процессов по умолчанию, на компьютере со средой разработки должен быть настроен локальный веб-сервер. Если при применении настроек возникает ошибка «Используется не локальный веб-сервер», то в конфигураторе Directum Launcher во встроенном редакторе YAML в секции devstand_config заполните параметры:

•SAVE_NOCODE_SETTINGS_TO_SOURCES – признак того, что настройки сохраняются вместе с исходными кодами и используется локальный веб-сервер. Укажите значение true;

•DEV_STUDIO_CONFIG_PATH – путь к XML-файлу с настройками среды разработки.

Пример настройки:

SAVE_NOCODE_SETTINGS_TO_SOURCES: 'true'

DEV_STUDIO_CONFIG_PATH: 'D:\Projects\Sungero\SDS\bin\bin\_ConfigSettings.xml'

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