Зарегистрировать фоновую операцию

Средний

Пример. Создать бизнес-процесс, который регистрирует фоновую операцию. Фоновая операция выполняется около 30 секунд. По истечении этого времени в списочном представлении реестра раздела Активности (Activities) добавляется запись Activity created by background task.

1. Создать класс для объекта активности 

  1. Перейдите в раздел Конфигурация (Configuration) и выберите пользовательский пакет, в который будет добавлена схема.

  2. На панели инструментов реестра раздела нажмите Добавить —> Исходный код (Add —> Source code).

  3. В дизайнере схем заполните свойства схемы:

    • Код (Code) — "UsrActivityData".
    • Заголовок (Title) — "ActivityData".

    Для применения заданных свойств нажмите Применить (Apply).

  4. В дизайнере схем добавьте исходный код.

    UsrActivityData
    namespace Terrasoft.Configuration
{
    using System;
    using Terrasoft.Common;
    using Terrasoft.Core;
    using Terrasoft.Core.DB;
    public class UsrActivityData
    {
        public string Title { get; set; }
        public Guid TypeId { get; set; }
    }
}
  5. На панели инструментов дизайнера нажмите Сохранить (Save), а затем Опубликовать (Publish).

2. Создать класс для добавления активности 

  1. Перейдите в раздел Конфигурация (Configuration) и выберите пользовательский пакет, в который будет добавлена схема.

  2. На панели инструментов реестра раздела нажмите Добавить —> Исходный код (Add —> Source code).

  3. В дизайнере схем заполните свойства схемы:

    • Код (Code) — "UsrBackgroundActivityCreator".
    • Заголовок (Title) — "BackgroundActivityCreator".

    Для применения заданных свойств нажмите Применить (Apply).

  4. В дизайнере схем добавьте исходный код.

    UsrBackgroundActivityCreator
    namespace Terrasoft.Configuration
{
    using System;
    using Terrasoft.Common;
    using Terrasoft.Core;
    using Terrasoft.Core.DB;
    using Terrasoft.Core.Tasks;
    using System.Threading.Tasks;
        
    public class UsrBackgroundActivityCreator : IBackgroundTask<UsrActivityData>, IUserConnectionRequired
    {
        private UserConnection _userConnection;

        /* Implement the Run method of the IBackgroundTask interface. */
        public void Run(UsrActivityData data) {
            /* Forced 30-second delay. */
            System.Threading.Tasks.Task.Delay(TimeSpan.FromSeconds(30));
            /* Creating activity. */
            var activity = new Activity(_userConnection){
                UseAdminRights = false,
                Id = Guid.NewGuid(),
                TypeId = data.TypeId,
                Title = data.Title,

                /* Activity category is "To do". */
                ActivityCategoryId = new Guid("F51C4643-58E6-DF11-971B-001D60E938C6")
            };
            activity.SetDefColumnValues();
            activity.Save(false);
        }

        /* Implement the SetUserConnection method of the IUserConnectionRequired interface. */
        public void SetUserConnection(UserConnection userConnection) {
            _userConnection = userConnection;
        }
    }
}

    Класс UsrBackgroundActivityCreator реализует интерфейсы IBackgroundTask<UsrActivityData> и IUserConnectionRequired. В методе Run() после принудительной задержки в 30 секунд на основе предоставленного экземпляра UsrActivityData создается экземпляр объекта раздела Активности (Activities).

  5. На панели инструментов дизайнера нажмите Сохранить (Save), а затем Опубликовать (Publish).
  6.  

3. Создать бизнес-процесс для запуска фоновой операции 

  1. Перейдите в раздел Конфигурация (Configuration) и выберите пользовательский пакет, в который будет добавлена схема.

  2. На панели инструментов реестра раздела нажмите Добавить —> Бизнес процесс (Add —> Business process).

  3. В дизайнере процессов заполните свойства процесса:

    • На панели настройки элементов заполните свойство Заголовок (Title) — "Background Task Example Process".
    • На вкладке Настройки (Settings) панели настройки элементов заполните свойство Имя (Code) — "UsrBackgroundTaskExampleProcess".

  4. Реализуйте бизнес-процесс.

    1. В области элементов дизайнера нажмите Действия системы (System actions и разместите элемент Задание-сценарий (Script task) в рабочей области дизайнера процессов между начальным событием Простое (Simple) и завершающим событием Останов (Terminate).

    2. Элементу Задание-сценарий (Script task) добавьте имя "Создать фоновую операцию" ("Create background task").

    3. Добавьте код элемента Задание-сценарий (Script task).

      Код элемента Задание-сценарий (Script task)
      var data = new UsrActivityData {
    Title = "Activity created by background task",
    TypeId = ActivityConsts.TaskTypeUId
};
Terrasoft.Core.Tasks.Task.StartNewWithUserConnection<UsrBackgroundActivityCreator, UsrActivityData>(data);

return true;

    4. В дизайнере процессов на вкладке Методы (Methods) в блоке Usings нажмите кнопку и добавьте пространство имен Terrasoft.Configuration. Это необходимо для использования в бизнес-процессе реализации класса для объекта активности и класса для добавления активности.

  5. На панели инструментов дизайнера нажмите Сохранить (Save).
  6. Во всплывающем окне нажмите Опубликовать (Publish) для компиляции кода элемента Задание-сценарий (Script task).

Результат выполнения примера 

Чтобы запустить бизнес-процесс Background Task Example Process, на панели инструментов дизайнера процессов нажмите Запустить (Run).

В результате выполнения бизнес-процесса Background Task Example Process в списочном представлении реестра раздела Активности (Activities) добавляется запись Activity created by background task.

Ресурсы
Пакет с реализацией примера