Снимок рабочего стола

Eng: Create screenshot

Элемент Снимок рабочего стола предназначен для создания скриншотов рабочего стола или фиксации текущего состояние экрана в процессе выполнения автоматизированных задач в Primo RPA Studio.

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

Свойства

Символ * в названии свойства указывает на обязательность заполнения. Описание общих свойств см. в разделе Свойства элемента.

Свойство	Тип	Описание
Вывод
Отправить в Оркестратор	bool	Если этот флажок установлен, скриншоты будут отправляться в Оркестратор. Важно отметить, что сообщения элемента Снимок рабочего стола с установленной галкой по задумке являются отладочными сообщениями (Debug) и будут видны только при включенном отображении сообщений уровня Debug в конфигурационном файле WebApi Оркестратора. Ниже описаны пошаговые действия.
Переменная	System.Drawing.Bitmap	Переменная для сохранения изображения
Рабочий стол
Заголовок	String	Заголовок подключаемого приложения
Имя процесса	String	Имя процесса
Область	System.Drawing.Rectangle	Область поиска компонента
Переменная	LTools.Desktop.DesktopInst	Переменная, содержащая ссылку на подключенный процесс

Отображения отладочных событий (Debug) робота

Для включения отображения сообщений уровня Debug выполните следующие шаги:

1. Откройте файл конфигурации агента:

   • Стандартное расположение: C:\Primo\Agent\appsettings.ProdWin.json.

2. Найдите секцию MinimumLevel.

3. Измените значение Warning на Debug для всех уровней, как показано ниже:

"MinimumLevel": {
    "Default": "Debug",
    "Override": {
        "System": "Debug",
        "Microsoft": "Debug",
        "Microsoft.EntityFrameworkCore": "Debug",
        "Microsoft.AspNetCore": "Debug"
    }
}

4. Сохраните изменения в файле конфигурации.

5. Перезапустите службу для применения изменений.

Как использовать

1. Перенесите элемент Снимок рабочего стола в процесс в Студии.

2. Настройте необходимые свойства, включая Имя процесса для указания процесса и Переменная для хранения результатов.

3. При необходимости активируйте опцию Отправить в Оркестратор, чтобы скриншоты отправлялись в Оркестратор.

Пример на Learning

Для изучения работы с элементом Снимок рабочего стола, вы можете скачать обучающий RPA-проект по следующей ссылке: Скачать архив Learning

1. Скачайте архив с обучающими материалами с указанной страницы.

2. Распакуйте архив и откройте проект StudioActivities в Студии.

3. Найдите процесс StudioActivities/Ru/Рабочий стол/Снимок рабочего стола.ltw для изучения работы элемента.

Только код

Пример использования элемента в процессе с типом Только код (Pure code)

C#

LTools.Desktop.DesktopApp app = LTools.Desktop.DesktopApp.Init(wf, null, "Test_*", 20000, true, LTools.Desktop.Model.DesktopTypes.UIAUTOMATION);
//Весь рабочий стол
System.Drawing.Bitmap bmp = LTools.Desktop.DesktopApp.CreateScreenshot(wf);
bmp.Save(@"C:\screen1.png");
//Приложение по заголовку
bmp = app.CreateScreenshot(null, "Test_*");
bmp.Save(@"C:\screen2.png");
//Текущее приложение
bmp = app.CreateScreenshot();
bmp.Save(@"C:\screen3.png");

Python

app = LTools.Desktop.DesktopApp.Init(wf, None, "Test_*", 20000, True, LTools.Desktop.Model.DesktopTypes.UIAUTOMATION)
#Весь рабочий стол
bmp = LTools.Desktop.DesktopApp.CreateScreenshot(wf);
bmp.Save("C:\\screen1.png");
#Приложение по заголовку
bmp = app.CreateScreenshot(None, "Test_*");
bmp.Save("C:\\screen2.png");
#Текущее приложение
bmp = app.CreateScreenshot();
bmp.Save("C:\\screen3.png");

JavaScript

var app = _lib.LTools.Desktop.DesktopApp.Init(wf, null, "Test_*", 20000, true, _lib.LTools.Desktop.Model.DesktopTypes.UIAUTOMATION);
//Весь рабочий стол
var bmp = _lib.LTools.Desktop.DesktopApp.CreateScreenshot(wf);
bmp.Save("C:\\screen1.png");
//Приложение по заголовку
bmp = app.CreateScreenshot(null, "Test_*");
bmp.Save("C:\\screen2.png");
//Текущее приложение
bmp = app.CreateScreenshot();
bmp.Save("C:\\screen3.png");