Программа лексема инструкция по применению

1

2

Инструкция пользователя

Lexema-RPA Client

3

СОДЕРЖАНИЕ Введение ………………………………………………………………………………………………………………… 4

Установка программы ……………………………………………………………………………………………… 4

Запуск и использование программы ………………………………………………………………………… 8

Конфигурирование программы ……………………………………………………………………………… 10

Автозапуск Lexema-RPA Client ………………………………………………………………………………. 12

4

Введение

Руководство предназначено для людей, которые уже знакомы с программой Lexema-

RPA Studio и хотят использовать все предоставленные ею возможности, а именно,

использование возможностей оркестратора роботов1 в студии.

Назначение программы

Программа Lexema-RPA Client предназначена для запуска составленных пользователем

задач в оркестраторе. Программа работает в фоновом режиме, ожидая начала новой задачи.

По наступлению необходимого времени, запускается задача-робот без открытия самой

Lexema-RPA Studio.

Установка программы

Скачать установщик программы можно по ссылке http://lexema.ru/solutions/lexema-rpa-

programmnye-roboty/lexema-rpa-studio/. После запуска установщика появится стандартное

окно установки программы. В первом окне установщика вам необходимо указать

актуальный путь до программы Lexema-RPA Studio, так как именно через неё будут

запускаться роботы. Изначально строка заполнена путем установки Lexema-RPA Studio по

умолчанию, если вы не выбирали специфичную папку при её установке, то здесь ничего

менять не нужно.

Рисунок 1. Путь до Lexema-RPA Studio

1 Оркестратор роботов — сервис запуска роботов по составленному расписанию и событиям.

5

По нажатию кнопки «Next» открывается следующее окно, предлагающее выбрать папку

для установки Lexema-RPA Client. По умолчанию установлена та же директория, которая

предлагается и для установки студии.

Рисунок 2. Директория установки Lexema-RPA Client

В следующем окне установки предлагается выбрать название для папки, которая будет

создана в меню «Пуск» с программой Lexema-RPA Client.

Рисунок 3. Название папки в меню «Пуск»

6

Далее предлагается добавить ярлык программы на рабочий стол.

Рисунок 4. Создание ярлыка на рабочем столе

После установки флажка в нужное положение, необходимо нажать кнопку «Next».

Затем, в следующем окне, нажмите «Install».

Рисунок 5. Подтверждение выборов в процессе установки

7

По завершению установки будет предложено открыть Lexema-RPA Client. Для выхода

из программы-установщика нажмите «Finish».

Рисунок 6. Открытие программы по завершению установки

Программа успешно установлена на ваш компьютер!

8

Запуск и использование программы

Для запуска программы необходимо открыть приложение Lexema-RPA Client.

Рисунок 7. Иконка программы на рабочем столе

После запуска программы в области уведомлений компьютера (в Windows — правая

нижняя часть окна, около времени и смены языка) появится иконка Lexema-RPA.

Рисунок 8. Область уведомлений компьютера – иконка Lexema-RPA Client

По нажатию по этой иконке правой кнопкой мыши появится список возможных

действий программы.

Рисунок 9. Контекстное меню программы Lexema-RPA Client

Первая строка контекстного меню показывает текущую версию Lexema-RPA Client,

вторая — логин текущего авторизованного пользователя. При первом входе в программу

проходит автоматическая авторизация пользователя, который запомнен в программе Lexema-

RPA Studio (если на этапе авторизации в студию установлен флажок «Запомнить меня»).

9

По нажатию кнопки меню «Старт» программа сменит состояние на «активное», а

именно просматривает все задачи, добавленные текущим пользователем в оркестратор, и

запускает их в назначенное им время. Программа выполняет задачи до тех пор, пока

пользователь не нажмет «Стоп» (не переведет программу в пассивное состояние) в этом же

меню (появляется на месте кнопки «Старт», если программа в активном состоянии),

«Выйти» или пока включен компьютер.

Кнопка меню «Запуск робота» позволяет запустить одного из опубликованных

пользователем роботов.

Для изменения текущего пользователя необходимо нажать «Сменить пользователя».

Рисунок 10. Окно смены пользователя

По кнопке «Войти» программа авторизуется через введенного пользователя и при

старте её работы будет выполнять задачи этого пользователя.

Кнопка «Выйти» закрывает программу и прекращает её работу, если она была в

активном режиме.

По кнопке «Оставить активную RDP сессию» можно оставлять работать роботов на

удалённом рабочем столе, не держа его при этом открытым, для этого необходимо запустить

Lexema-RPA Client на удалённом рабочем столе, нажать «Старт» и выйти с него не

стандартными методами, а по этой кнопке в клиенте. Удалённый рабочий стол закроется, но

работа роботов не прекратится.

10

Конфигурирование программы

Lexema-RPA Client имеет ряд настроек, которые установлены по умолчанию, но в

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

установленной программой в файле «Lexema-RPA Client wpf.exe.config», который можно

открыть с помощью Блокнота.

Настройки, которые там содержатся – сервер оркестратора, логин и пароль

пользователя, которые можно изменить как из самой программы, так и задать в конфиге, и

путь до Lexema-RPA Studio. То есть, если вы, например, перенесли основную программу

(студию) в другую папку, то нет необходимости переустанавливать клиента для установки

нового пути до студии, достаточно изменить путь в файле конфигурации.

Все настройки находятся в блоке appSettings:

Рисунок 11. Файл конфигурации программы

Описание полей, доступных для редактирования:

1) server – адрес сервера оркестратора, необходимо менять который только на

предприятиях со своим сервером;

2) useNoClicker – флаг, отвечающий за одновременную работу нескольких роботов –

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

их параллельный запуск, то этот флаг устанавливается в значение «true», иначе –

11

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

«true», программа всё равно не позволит выполнить роботов параллельно.

3) studioPath – путь до установленной Lexema-RPA Studio, через которую будут

работать роботы.

12

Автозапуск Lexema-RPA Client

Добавить программу в автозапуск или в планировщик задач не составит труда

уверенному пользователю компьютера, однако недостаточно одного запуска программы, так

как работать Lexema-RPA Client начинает только после нажатия пункта контекстного меню

«Старт». Для запуска программы сразу в активном режиме необходимо вызывать её с

аргументом «-start». Далее рассмотрим несколько способов применения этой возможности.

1. Изменение ярлыка программы для её запуска в активном состоянии

Для того, чтобы запускать программу по ярлыку сразу в активном состоянии,

необходимо изменить этот ярлык.

Откройте «Свойства» ярлыка (2), которые доступны при нажатии правой кнопкой

мыши по ярлыку (1) – выберите вкладку «Ярлык» (3) и в поле «Объект» добавьте текст «-

start» (4).

Рисунок 12. Изменение свойств ярлыка для запуска программы с нажатой кнопкой «Старт»

Теперь при нажатии по этому ярлыку программа сразу будет запускаться с нажатой

кнопкой «Старт». Этот ярлык можно использовать для автозагрузки приложения при

включении компьютера (добавлением этого ярлыка в папку «Автозагрузка»).

13

2. Добавление задачи в «Планировщик заданий» для запуска программы при

включении компьютера в активном состоянии

Для того, чтобы Lexema-RPA Client запускалась вместе с включением компьютера и

начинала выполнять задачи, можно воспользоваться «Планировщиком заданий» Windows.

Для этого необходимо открыть сам планировщик заданий (найти его можно в поиске

приложений) и нажать «Создать простую задачу» в правой части приложения.

Рисунок 13. Планировщик заданий – Создать простую задачу

После нажатия на «Создать простую задачу» появится окно с настройками задачи. Для

начала необходимо заполнить название задачи и, по желанию, её описание.

Рисунок 14. Название и описание задания

14

По кнопке «Далее» откроется следующий пункт настроек – «Триггер». Здесь

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

случае рассматриваем событие «При входе в Windows». После выбора нажимаем «Далее».

Рисунок 15. Выбор триггера задачи

Следующая настройка – выбор действия для задачи. В нашем случае это запуск

программы Lexema-RPA Client, поэтому выбираем «Запустить программу».

Рисунок 16. Выбор действия

15

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

аргументы для её запуска. В поле «Программа или сценарий» вводим (или выбираем по

кнопке «Обзор») путь до Lexema-RPA Client, а в поле «Добавить аргументы» вводим «-start».

Рисунок 17. Выбор программы для запуска

По кнопке «Далее» откроется заключительная настройка задания – проверка введенных

данных. Для завершения настройки задачи необходимо добавить еще один флажок, который

можно найти в свойствах задачи, поэтому во время заключительного шага создания задачи

можно сразу установить галочку «Открыть свойства задачи». По нажатию кнопки «Готово»

задание добавится в список заданий Windows.

16

Рисунок 18. Заключительный этап создания задачи, открытие свойств

В открытых свойствах задачи необходимо установить флажок «Выполнить с

наивысшими правами». На этом настройка автозапуска программы завершена, по кнопке

«Ок» окно свойств закроется и изменения применятся.

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

активных задач.

17

Рисунок 19. Задача «Автозапуск Lexema-RPA Client» в активных задачах

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

чего откроется «Библиотека планировщика заданий». В правой части приложения появятся

возможные действия над заданием. Выбираем «Удалить». Если необходимо временное

отключение, то задачу можно просто отключить нажатием одноименной кнопки. Для

открытия свойств необходимо нажать «Свойства» в правой части экрана.

Рисунок 20. Удаление и свойства существующей задачи

Любая система
учета, в первую очередь, является рабочим местом людей и должна
содержать в себе достаточно функциональные
интерфейсные элементы управления. При этом оптимальным считается
отделение логики бизнес-объектов от их пользовательского представления.Lexema 7.0 решает задачу разделения интерфейса
путем определения бизнес-объекта как набора
данных для элементов управления. Под набором данных понимается некое
структурированное реляционное хранилище,
состоящее из таблиц и колонок, к данным которых можно осуществлять
привязку, т.е. организовывать канал «Элемент управления
<-> Данные». При таком подходе задачей
элемента управления в простейшем случае является осуществление ввода
значения в набор данных. В более сложных случаях
элементы управления выступают в роли предварительных обработчиков
данных. Как бы то ни было, все что касается предварительной обработки
или предоставления данных не является
бизнес-логикой, потому как начальной точкой бизнес-события, как мы уже
определили, является момент изменения данных, а
за изменение данных всегда отвечает непосредственно сам
бизнес-объект. Даже если событие изменение снаружи происходит через
элемент управления, фактически изменение
происходит на уровне бизнес-объекта.

Элементы управления для создания пользовательского интерфейса
содержатся в сборке
Lexema.Business.WinForms.dll. Сборка пользовательских интерфейсов в
свою очередь использует некоторые объекты из
сборки Lexema.Business.Design.dll. Как правило, основная организация
пользовательского интерфейса базируется на тандеме двух этих библиотек.

Необходимо
отметить тот факт, что способность к запрету на закрытие реализуется
непосредственно классом LxCustomContent. Именно
он использует значение свойства CanClose для определения
реакции при собственном закрытии.Потомки класса LxCustomContent являются полноценно
встраиваемыми в главное окно, однако их базовой
функциональности недостаточно, для того чтобы представлять интерфейсы
бизнес-объектов. Прямые потомки LxCustomContent
являются лишь функциональными окнами,
обеспечивающими интерфейсные особенности приложения. У функциональных
окон отсутствуют способности на реакции системы
к запросам сохранения, обновления, печати и так далее, что
необходимо при работе с окнами, связанными с данными бизнес-объектов.

OnViewCreated([код_объекта]
– метод позволяет передать созданному экземпляру контента код
представляемого им бизнес-объекта. Так как для редактирования записей
одного типа объекта в большинстве случаев
используется один и тот же интерфейс, ему необходимо указать, какой
именно экземпляр объекта он призван
редактировать. Метод вызывается во всех без исключения случаях
после создания экземпляра бизнес-контента.

Сохранение

Данные соответствующего контенту бизнес-объекта должны
каким-то образом сохраняться. Для этого
бизнес-контент обязан предоставлять механизмы управления. Однако
достаточно часто, бизнес-контент может выступать
в роли визуального представления не редактируемых данных. Для
определения таких случаев служит свойство CanSave.

Задача свойства CanSave
проинформировать управляющие службы, возможно ли вызвать метод
сохранения для контента. Опираясь на данное свойство регулируется
доступность кнопок сохранения главного окна
приложения.Save –
метод вызывается при событии главного окна, требующего сохранения
данных контента. Генерация события с требованием
сохранения для активного контента возможна только в том случае,
если для этого контента свойство CanSave определено как true. Задача
контента, в реализации метода сохранения
взаимодействовать с собственными сохраняемыми бизнес-объектами.IsDirty
– признак, определяющий наличие не сохраненных изменений
данных бизнес-объектов, соответствующих
активному контенту. Признак используется при закрытии контента и
определяет необходимые для управляющих служб
действия.

Управление порождаемыми элементами

Данная функциональность полезна для контентов типа «реестр
объектов», различных коллекционных представлений
наборов данных. Для взаимодействия с такими контентами используется
группа специальных методов

CanCreateChilds
– определяет возможность создания контента, соответствующего
элементу собственной коллекции бизнес-объектов.
CreateChildContent
— Вызывается при срабатывании события «Создать новый элемент».
EditChildPosition
– вызывается при срабатывании события «Редактировать».
DeleteChildPosition
– вызывается при срабатывании события «Удалить»
Возможность событий данной группы всегда однозначно
определяет свойство CanCreateChilds.

Работа
с периодом

CanChangePeriod
– определяет возможность возникновения события с требованием
вызова диалога смены текущего активного периода
для бизнес-контента, представляющего данные.

По умолчанию для смены периода используется стандартный интерфейсный
диалог с возможность задать период в нескольких
видах. Однако данный диалог может быть переопределен. Управляющая
служба, перед вызовом диалога пытается получить альтернативное окно
выбора периода. Если альтернативы нет вызывается
стандартный диалог, в противном случае вызывается диалог,
определенный контентом. Однако диалог в этом случае должен
реализовывать интерфейс ILxChangePeriodDialog
(!). 

Положительное завершение работы диалога провоцирует завершающий в
цепочке смены периода метод ApplyNewPeriod.
Задача метода перезагрузить коллекцию объектов контента в соответствии с
установленными значениями периода.

Контекстый поиск

Для каждого контента существует возможность определения
диалога контекстного поиска. Наличие такой
возможности для контента сигнализируется свойством SupportContextSearch.
При срабатывании события контекстного поиска
вызывается метод GetContextSeracher,
возвращающий поисковый механизм.

В завершении рассмотрим схему взаимодействия элементов интерфейса
главного окна с

определенными нами в группы
методами бизнес-контента (Рисунок 2)


Рисунок 2

Доступность кнопок определяет соответствующее группе сигнальное
свойство.

Разработка интерфейса

Реализация членов интерфейса ILxBusinessContent задача
достаточно трудоемкая, поэтому в пространстве
имен Lexema.Business.WinForms есть два базовых класса бизнес-контентов:

– LxExtendedBusinessContent (ранее
использовался LxBusinessContent)
– реализует контент для редактирования единичного экземпляра
объекта
– LxBusinessCollectionContent
– реализует контент для опрерирования плоским списком бизнес-объектов

Прежде чем приступать к рассмотрению каждого из контентов не лишним
будет взглянуть на иерархическую схему описанных
классов (Рисунок 3)
Рисунок 3

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

Главное окно оперирует двумя коллекциями окно – физической и
виртуальной. Физическая коллекция содержит в
себе все окна, приведенные к типу ILxCustomContent. Виртуальная
коллекция содержит фильтрованный по типу
ILxBusinessContent набор окон. В конечном счете, вся функциональность
рабочего интерфейса расчитана на виртуальную коллекцию бизнес-контентов.

Основные публичные свойства LxBusinessWorkbnech (главная форма)
– Постоянный глобальный указатель на экземпляр
главного окна Instance
– ActiveContent
– текущий активный бизнес-контент
– accessibleObjectsManager
– указатель на менеджер дерева навигации по объектам
приложения
– AttachedContents
– перечисление всех присоединенных дочерних окон
– AttachedBusinessContents
– перечисление присоединенных бизнес-контентов

Наиболее важным из приведенных свойств является свойство Instance,
доступное через синтаксис обращения к классу
LxBusinessWorkbench.Instace. Обращаться к свойству можно из любого
участка кода. Свойство всегда содержит в себе
указатель на экземпляр главного окна приложения текущей
сессии.Еще одним важным свойством является свойство accessibleObjectsManager.
Мы вернемся к нему когда будем рассматривать
построение навигационных деревьев по объектам приложения.

Перечисленные публичные свойства в купе с глобальным указателем на
экземпляр главного окна

позволяют динамически
манипулировать интерфейсом окон из любого участка кода.

Основные публичные метода LxBusinessWorkbench
– AttachContent(ILxCustomContent)
– присоединение экземпляра функционального
контента
– AttachContent(ILxBusinessContent)
– присоединение экземпляра бизнес-контента. По сути, метод
является сокращением от метода с передачей кода соответствующего
контенту бизнес-объекта. Кодом объекта является
-1, что, согласно описанию бизнес-объекта, является аналогичным
вызову New().
– AttachContent(ILxBusinessContent,
int rootCode) – присоединение экземпляра
бизнес-контента с передачей кода
соответсвтующего присоединяемому контенту бизнес-объекта
– AttachContent(Type)
– присоединение контента указанного типаНаличие четырех одноименных методов призваны
стандартизировать процесс присоединения
дочернего окна, делая его синтаксис одинаковым.

Настало время рассмотреть процесс создания собственных окон,
наследующихся от базовых реализаций интерфейса
ILxBusinessContent. Как уже было отмечено, существуют две
взаимосвязанные реализации – LxExtendedBusinessContent и
LxBusinessCollectionContent. Сборка
Lexema.Business.WinForms.dll поставляет с собой шаблоны наследования от
каждого из этих классов. Однако, прежде чем
принять решение, от которого из них необходимо отнаследоваться следует
разобраться в функциональных особенностях каждого из них.

LxExtendedBusinessContent

LxExtendedBusinessContent – реализация
бизнес-контента для редактирования единичного экземпляра бизнес-объекта.
Представлен шаблоном «Бизнес-контент с прокси».

Класс содержит одно наиболее важное свойство, позволяющее
минимизировать код взаимодействия с
бизнес-объектом — RootBusinessObject. Устанавливая в качестве значения
соответствующий контенту объект, находящийся на
форме контента, нет необходимости реализовывать методы
сохранения, обновления и восстановления данных.

Таблица реализации интерфейса ILxCustomContent для
LxExtendedBusinessContent

По своей сути, наследники LxExtendedBusinessContent
являются пустой формой. Задача построения
интерфейса пользователя заключается в добавлении на форму компонента
бизнес-объекта и необходимого количество
элементов управления с дальнейшей установкой их взаимоотношений с
бизнес-объектом.

Для наглядности принято переносить в заголовок окна некоторую
информацию, идентифицирующую контент в списке.
Например, заголовок окна редактирования объекта единиц измерения было бы
разумно сформировать как «Единица измерения – Штука».
Формирование заголовка в потомках происходит в
методе OnViewCreated, после вызова базовой реализации метода

Вызов base.OnViewCreated(rootCode) выполняет необходимые
действия над объектом RootBusinessObject. В
дальнейшем, анализируя значение переданного кода (rootCode) можно
сформировать заголовок. Код формирования заголовка записан в одну
строку. Синтаксис такой записи заключается в
определении одного из двух значений в зависимости от результата
сравнения.
Если сравнение (в нашем случае rootCode > 0) истинно, то берется
первое из двух значений, в противном случае
второе. Касательно примера, если значение кода больше 0, заголовок
контента будет «Имя контента», иначе «Имя
контента – новый».

Формирование заголовка является достаточно важным моментом в оконной
системе Lexema Business WinForms. Дело в том,
что заголовок является одним из идентификаторов окна в визуальном
представлении. Система попросту не даст присоединить
контент с уже существующим в коллекции заголовком.

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

LxBusinessCollectionContent

LxBusinessCollectionContent – реализация контента
для представления плоского списка бизнес-объектов
с возможностью перехода на контенты редактирования представленных
элементов. Представлен шаблоном «Реестр
объектов».

В отличии от LxExtendedBusinessContent,
являющегося пустой формой, класс LxBusinessCollectionContent
содержит внутри себя один элемент управления — таблица для
представления коллекции бизнес-объектов.
Внутренняя реализация формы позволяет организовать плоский список
заполнением необходимых свойств.

Класс LxBusinessCollectionContent имеет одно
наиболее важное свойство –
BusinessObjectType. Значение свойства определяет тип объекта для
представления в виде плоского списка. В качестве
значения выступает имя ранее созданного класса бизнес-объекта.
Установка значения для свойства является отправной точкой в настройке
формы.Основные свойства LxBusinessCollectionContent
– ChildContentType
– имя класса, реализующего контент для редактирования
единичного экземпляра бизнес-объекта указанного
в BusinessObjectType типа.
– UseCalendar
– свойство, определяющее необходимость использования фильтра
по дате для реестра при открытии.
– DateFilterProperty
– свойство, устанавливающее, по какому из свойств типа дата
бизнес-объекта списка производить фильтрацию.
Данное свойство используется только при значении свойства
UserCalendar true.

После установки значения для свойства BusinessObjectType возможна
настройка колонок таблицы, отображающей список
объектов.Таблица реализации интерфейса ILxCustomContent для
LxBusinessCollectionContent

Не лишним будет заметить, что в реализации LxExtendedBusinessContent.CreateChildContent
происходит подписка на событие закрытия
созданной формы для последующего вызова метода RefreshContent.

Установленное в true значение свойства UseCalendar спровоцирует вызов
диалога выбора периода

при присоединении
контента реестра к главной форме.

Для большей наглядности обратимся к схеме (Рисунок 4), иллюстрирующей
часть механизмов внутреннего взаимодействия
методов контента между собой
Рисунок 4Любой из методов, за исключением
CreateChildContent может быть переопределен в потомке. Это
утверждение справедливо как для LxExtendedBusinessContent,
так и для LxBusinessCollectionContent.

• Описание
• Параметры
• Возможности
• Отзывы
• Совместимость
• Зарубежные аналоги
• Сравнения