Синхронный элемент

Базовый вид синхронного элемента:


using LTools.Common.Model;
using LTools.Common.UIElements;
using LTools.SDK;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
 
namespace Primo.SDKSample
{
    public class PrimoElementBack : PrimoComponentSimple<PrimoElement>
    {
        private const string CGroupName = "SDK Test";
 
        public override string GroupName 
        { 
            get => CGroupName; 
            protected set { }
        }
 
        public PrimoElementBack(IWFContainer container) : base(container)
        {
            InitClass(container);
        }
 
        public override ExecutionResult SimpleAction(ScriptingData sd)
        {
            return new ExecutionResult();
        }
    }
}

Рассмотрим детали данного класса подробнее:

Свойство GroupName отвечает за наименование группы, в которой будет содержаться ваш элемент в рамках палитры Элементы Primo Studio. Для создания вложенности ярусы дерева группы нужно разделять при помощи константы LTools.Common.UIElements. WFPublishedElementBase.TREE_SEPARATOR. Например, для формирования дерева:


Group1

---- Group2

-------- Element1

Нужно создать имя группы вида “Group1” + WFPublishedElementBase.TREE_SEPARATOR + “Group2”.

Метод InitClass в теле конструктора обязателен и производит сервисные действия при создании компонента. Данный метод должен вызываться в конце, но перед инициализацией кастомных свойств элемента.

Метод SimpleAction является основным и вызывается роботом в качестве логики элемента. Таким образом, данный метод должен содержать основную бизнес-логику.

Класс ExecutionResult служит для оповещения робота об успешном либо неуспешном выполнении элемента, а также для формирования записи журнала. Например:

new ExecutionResult() { IsSuccess = true, SuccessMessage = "Completed successfully" } – оповещает об успешном завершении работы элемента и пишет в лог сообщение “Completed successfully”.
new ExecutionResult() { IsSuccess = false, ErrorMessage = "Execution error" } – информирует робота об ошибке.