Обновление версии экземпляра ПО с 3.5 на 4.2

Использование выражения CONST(" ") и пустых значений в сценариях

Проблема

Решение

В сценариях в действии «Изменить значение атрибутов» в версии 3.5 для установки в атрибуте пустого значения в него записывалось пустое значение или использовалось выражение CONST(" ").

Чтобы установить в атрибуте пустое значение, укажите операцию со значением «Удалить».

Выделение памяти для OpenSearch (Elasticsearch)

Проблема

Решение

Сервис OpenSearch (Elasticsearch) работает некорректно или не работает. В информационной панели экземпляра ПО отображаются сообщения об ошибках Elasticsearch.

Проверьте конфигурацию сервера Elasticsearch: выделите достаточный объем памяти и необходимое количество шардов в соответствии с объемом исторических данных.

Перекомпиляция скриптов на C

Проблема

Решение

Не все скрипты на C# из версии 3.5 могут без изменений работать в версии 4.2.

Например, в функции Api.Process.ProcessObjectService.CreateWithObjectId() было четыре параметра, а в версии 4.2 а стало три.

В некоторых случаях после обновления с версии 3.5 на версию 4.2 может отображаться сообщение об ошибке «Could not find a part of the path».

1. Перекомпилируйте скрипты, нажав кнопку «Перекомпилировать библиотеки скриптов» на странице «Администрирование» — «Глобальная конфигурация».

2. Ознакомьтесь с журналом компиляции скриптов.

3. Исправьте выявленные ошибки в скриптах.

Преобразование глобальных функций

Проблема

Решение

Глобальные функции из версии 3.5 не поддерживаются в версии 4.2.

Вместо глобальных функций следует создать аналогичные сценарии или скрипты на C#.

Использование специальных символов в имени пользователя

Проблема

Решение

В версии 3.5 в имени пользователя можно было указать специальные символы.

В версии 4.2 в имени пользователя разрешено использовать только буквы латинского алфавита (строчные и прописные), цифры, символ подчеркивания, точку и дефис: a-z A-Z 0-9 _ . -

Все остальные символы недопустимы.

1. Исправьте имена пользователей, содержащие недопустимые символы, на странице «Администрирование» — «Аккаунты».

2. Исправьте выражения и скрипты на C#, в которых могут присваиваться имена пользователей с недопустимыми символами.

Преобразование повторно используемых подпроцессов

Проблема

Решение

Элемент диаграммы процесса «Повторно используемый подпроцесс» из версии 3.5 в версии 4.2 переименован в «Вызов под процесса». В версии 4.2 вызов процесса настраивается и может работать несколько иначе, чем в версии 3.5.

Проверьте конфигурацию и работоспособность элементов «Вызов под процесса» на всех диаграммах процессов. Исправьте конфигурацию при необходимости.

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

Проблема

Решение

Правила для данных на входе и выходе промежуточных событий из версии 3.5 при обновлении до версии 4.2 преобразуются в сценарии на выходе. В результирующем сценарии на выходе из промежуточного события все действия выстраиваются последовательно — сначала идут действия из правил на входе, затем — из правил на выходе.

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

   • Создайте дополнительное промежуточное событие перед имеющимся.

   • Перенесите на его выход действия из правил на входе исходного события.

2. Проверьте сценарии на выходе из промежуточных событий на всех диаграммах процессов на предмет корректной работы. Исправьте сценарии при необходимости.

Преобразование формул

Проблема

Решение

В версии 3.5 в формулах можно было не выполнять проверку на пустое значение атрибутов. В версии 4.2 такая проверка необходима во избежание деления на 0 и других неполадок, в противном случае будет возникать ошибка.

В формулах необходимо проверять наличие значений у атрибутов с помощью функции NOT(EMPTY()) либо обеспечивать ненулевое значение с помощью функции VALUE().

Настройка разрешений для шаблонов процессов

Проблема

Решение

В версии 3.5 не требовалось разрешение на создание экземпляра процесса. В версии 4.2 для создания экземпляра процесса у аккаунта должно быть разрешение.

В свойствах ролей добавьте разрешение «Создание» для соответствующих шаблонов процессов.

Настройка кнопок и разрешений для таблиц на формах

Проблема

Решение

В версии 3.5 для коллекции (таблицы) на форме кнопки операций с записями создавались автоматически в соответствии с разрешениями на соответствующие операции, заданными в свойствах коллекции (таблицы) на форме.

В версии 4.2 кнопки операций с записями в таблице на форме требуется выносить на область кнопок таблицы. При этом вынесенные кнопки определяют разрешения на соответствующие операции с записями в таблице.

Если у таблицы на форме не отображаются или не работают должным образом кнопки операций с записями в таблице, например «Редактировать», «Создать», «Сохранить», «Удалить»:

• в конструкторе формы выберите область кнопок таблицы;

• перетащите на область кнопок требуемые кнопки, при этом будут разрешены соответствующие операции с записями в таблице;

• проверьте и настройте свойства таблицы на форме.

Публикация диаграмм процессов

Проблема

Решение

При обновлении с версии 3.5 на версию 4.2 некоторые процессы могут перестать выполняться.

Откройте диаграмму процесса, который не выполняется должным образом или выдаёт ошибку. Опубликуйте её заново, выбрав способ «Создать новую версию».