Настроить Web.config

Продукты
Все продукты

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

  1. Скачайте powershell-скрипт. Скачать скрипт.
  2. Запустите powershell-терминал от имени администратора.
  3. В powershell-терминале укажите путь к корневой папке приложения и выполните команду. Пример запуска команды:

    .\UpdateMachineKey.ps1 "[Путь к корневой папке приложения Creatio]" 
    

В результате в файлах Web.config, которые находятся в корневой папке приложения и в папке Terrasoft.WebApp, будет сгенерировано уникальное значение ключа machineKey.

Дополнительная настройка Web.config для Oracle 

После настройки параметров соединения с базой данных в файле ConnectionStrings.config для базы данных Oracle необходимо настроить конфигурационный файл Web.config, в который вынесены некоторые параметры конфигурации приложения, необходимые для его работы.

Чтобы настроить Web.config:

  1. Настройте доступ сайта приложения к параметрам конфигурации, которые описаны в конфигурационном файле ConnectionStrings.config. Для этого откройте конфигурационный файл Web.config, который расположен в корневой папке приложения, и в параметре general секции db измените значение атрибута currentSchemaName на имя схемы, которая указана в конфигурационном файле ConnectionStrings.config.

    <configuration>
        ...
        <terrasoft>
            <db>
                <general ... currentSchemaName="SOME_SCHEMA_NAME_OF_ORACLE_DATABASE" />
            </db>
        </terrasoft>
        ...
    </configuration>
    

    где currentSchemaName — имя схемы базы данных Oracle.

  2. Сохраните изменения.

Настройка Creatio для работы на Oracle 19c 

Возможность настроить Creatio для работы на Oracle 19с доступна в Creatio версий 8.0 Atlas и выше. Начиная с версии 8.0.2 Atlas, Creatio по умолчанию настроен для работы на Oracle 19с.

В качестве СУБД приложения Creatio мы рекомендуем использовать Oracle 19c. Ознакомьтесь с возможностями Oracle 19c в официальной документации вендора (на английском языке). Вы можете использовать Oracle 19c благодаря библиотеке Managed ODAC 12.

На заметку. Предварительно мы рекомендуем выполнить настройку на предпромышленной среде. Подробнее: Понятие рабочей среды (документация для разработчика).

В общем случае настройка Creatio для работы на Oracle 19c состоит из следующих шагов:

  1. Подключить библиотеку Managed ODAC 12. Подробнее >>>
  2. Обновить СУБД Oracle до версии 19c. Подробнее >>>

Подключить библиотеку Managed ODAC 12 

Убедитесь, что вы используете Creatio версии 8.0 Atlas и выше. Если версия вашего приложения ниже, то обновите его. Для этого воспользуйтесь инструкцией по обновлению.

Чтобы подключить библиотеку Managed ODAC 12:

  1. Проверьте коннектор, через который выполняется подключение сайта к базе данных Oracle 19c.

    <configuration>
        ...
        <system.data>
            <DbProviderFactories>
                <add name="Oracle.ManagedDataAccess, Managed Driver" invariant="Oracle.ManagedDataAccess.Client" description="Oracle Data Provider for .NET, Managed Driver" type="Oracle.ManagedDataAccess.Client.OracleClientFactory, Oracle.ManagedDataAccess"/>
            </DbProviderFactories>
        </system.data>
        ...
    </configuration>
    
  2. Создайте резервную копию конфигурационного файла Web.config, который расположен в корневой папке приложения.
  3. Настройте взаимодействие сайта приложения с базой данных через библиотеку Managed ODAC 12. Для этого измените значение параметра executorType конфигурационного файла Web.config на Terrasoft.DB.Oracle.OracleManagedExecutor, Terrasoft.DB.Oracle:

    <configuration>
        ...
        <terrasoft>
            <db>
                <general ... executorType="Terrasoft.DB.Oracle.OracleManagedExecutor, Terrasoft.DB.Oracle" ... />
            </db>
        </terrasoft>
    </configuration>
    

    где executorType — библиотека для работы с базой данных Creatio.

  4. Настройте взаимодействие планировщика с таблицами в базе данных через библиотеку Managed ODAC 12. Для этого измените значение ключа quartz.dataSource.SchedulerDb.provider конфигурационного файла Web.config на OracleManagedProvider:

    <configuration>
        ...
        <quartzConfig defaultScheduler="BPMonlineQuartzScheduler">
            <quartz isActive="true">
                ...
                <add key="quartz.dataSource.SchedulerDb.provider" value="OracleManagedProvider" />
            </quartz>
        </quartzConfig>
    </configuration>
    

    где quartz.dataSource.SchedulerDb.provider — ключ, который позволяет планировщику взаимодействовать с таблицами в базе данных.

  5. Запустите приложение и проверьте работу функциональности. Если наблюдаются проблемы, то восстановите конфигурационный файл Web.config из резервной копии и повторите настройку.
  6. Повторите настройку на промышленной среде или перенесите изменения на промышленную среду. Подробнее: Понятие рабочей среды (документация для разработчика).

Обновить СУБД Oracle до версии 19c 

Чтобы обновить СУБД Oracle приложения Creatio до версии 19c, воспользуйтесь официальной документацией вендора (на английском языке).

В результате в качестве СУБД вашего приложения используется СУБД Oracle 19c.