SherpaRPA
  • База знаний
  • Содержание
  • О платформе Sherpa RPA
    • Основные понятия
    • Диаграмма развертывания Sherpa RPA
      • Последовательность шагов процесса
      • Конфигурация сети
      • Системные требования
    • Установка Sherpa RPA
      • Установка Sherpa RPA на Windows
      • Установка Sherpa RPA на Linux
      • Установка Sherpa RPA на RedOS
    • Начало работы
      • Регистрация лицензии
      • Автономная активация
    • Внешний мониторинг и логирование
  • Sherpa Robot и Sherpa Assistant
    • Основные понятия
    • Установка Sherpa Robot и Sherpa Assistant
      • Установка Sherpa Robot и Sherpa Assistant на Windows
      • Установка Sherpa Unattended на ОС Astra Linux
      • Установка Sherpa Robot Unattended на RedOS
    • Работа в Sherpa Assistant
      • Главный интерфейс Sherpa Assistant
      • Действия с роботами в Sherpa Assistant
      • Контекстное меню Sherpa Assistant
        • Логи
        • Оркестратор
        • Настройки
          • Вкладка "Основное"
          • Вкладка "Регистрация"
          • Вкладка "Прокси"
            • Настройка прокси
          • Вкладка "Выполнение"
            • Настройка логирования работы роботов
          • Вкладка "Сервисы"
            • Настройка подключения к сервисам
          • Вкладка "Селекторы"
          • Вкладка "О программе"
        • Плагины
          • Установка плагинов
            • Работа с Citrix
        • Инструменты
        • Удаленная отладка
    • Подключение сторонних сервисов
    • Sherpa Assistant: ответы на часто задаваемые вопросы
  • Sherpa Designer
    • Основные понятия
    • Установка Sherpa Designer
    • Работа в Sherpa Designer
      • Начало работы в Sherpa Designer
        • Рекомендации по созданию коммерческих сценариев
        • Горячие клавиши
      • Основное меню
        • Панель "Разработка"
          • Меню "Файл"
          • Панель "Навигация"
          • Меню "Запись"
            • Запись действий пользователя
              • Пример записи действий при работе с Калькулятором
              • Особенности записи действий пользователя в браузерах
            • Использование OCR Яндекс
          • Меню "Отладка"
            • Удаленная отладка робота
          • Меню "Дополнительно"
            • Sherpa Explorer
            • Sherpa Regex
            • Редактор окон
          • Меню "Помощь"
        • Панель "Инструменты"
      • Главная панель
        • Блоки
          • Редактор блоков
        • Проект
        • Библиотека
      • Центральная рабочая область
      • Панели свойств и переменных и работа с ними
        • Панель свойств
          • Работа с выражениями
            • Функции в выражениях
            • Методы в выражениях
          • Настройка селекторов
        • Панель "Переменные"
          • Работа с переменными
        • Примеры использования переменной и работы с выражениями
          • Простое арифметическое действие
          • Сложение числа и строки
          • Сложение двух чисел
          • Умножение текста на число
      • Нижняя центральная панель
        • Работа с логом робота
      • Руководство по веб-селекторам
        • Ручной поиск CSS-селекторов в браузере
        • Ручной поиск CSS-селекторов с помощью Sherpa Explorer
        • Как понять, что селектор не оптимальный?
        • Нотация CSS-селекторов на примерах
        • Справочник по нотации CSS- и XPath-селекторов
      • Режим «Картинка в Картинке» (PiP)
      • Примеры автоматизации популярных приложений
        • Автоматизация калькулятора
        • Точная настройка селектора в Microsoft Word
        • Автоматизация выбора шрифта в Блокноте
        • Автоматизация поиска в Яндексе
        • Извлечения данных из таблиц в Word и Excel
    • REST Клиент
    • Как разместить проект на GitHub с помощью Sherpa Designer
    • Справочник блоков
      • Основные блоки (Main Blocks)
        • Старт (Start)
        • Конец (ReturnOrStop)
        • Процесс (ProcessContainer)
        • Комментарий (Comment)
        • ToDo (ToDoBlock)
        • Лог (Log)
        • Условие (IfCondition)
        • Switch/Case
        • Присвоить значение переменной (Assign)
        • Цикл Для каждого - Таблица Данных (ForeachRows)
        • Цикл Для каждого - Список (ForeachList)
        • Цикл Для каждого - Словарь (ForeachHashtable)
        • Цикл (For)
        • Цикл Пока (While)
        • Пауза (Delay)
        • Выполнить выражение PowerShell (InvokeExpression)
        • Выполнить код C# (InvokeCSharpCode)
        • Выполнить код Python (InvokePythonCode)
        • Выполнить код VB (InvokeVBCode)
        • Выполнить код Java (InvokeJavaCode)
        • Выполнить код JavaScript (InvokeJavaScriptCode)
        • Try/Catch (TryCatchContainer)
        • Контейнер (CollapseContainer)
        • Прервать (FullAbort)
        • Прервать контейнер (AbortContainer)
        • Параллельный выбор (ParallelSelect)
        • Запустить робота (StartBackgroundRobot)
        • Проверить завершение робота (CheckBackgroundRobot)
      • Автоматизация приложений (UI Automation)
        • Клик мышкой (MouseClick)
        • Удерживать курсор (MouseOver)
        • Скролл мышкой (MouseWheel)
        • Нажать клавиши (PressKeys)
        • Получить текст (GetUIText)
        • Задать текст (SetUIText)
        • Установить курсор (SetUICursor)
        • Получить атрибуты (GetAttributes)
        • Ожидать появление (WaitElementAppear)
        • Ожидать исчезновение (WaitElementDisappear)
        • Проверить наличие элемента (ElementExists)
        • Клик по тексту (ClickOnText)
        • Копировать в буфер обмена (CopyToClipboard)
        • Вставить из буфера обмена (PasteFromClipboard)
        • Извлечь данные (CollectData)
        • Выбрать значение из списка (SelectOption)
        • Перетащить элемент (DragAndDrop)
        • Подсветить элемент (HighlightElement)
        • Посчитать элементы (GetElementsCount)
        • Получить селекторы (GetElementsSelector)
        • Очистить кэш селекторов (ClearCache)
        • Параметры селекторов (ControlCache)
        • Контролировать элемент (AssertElement)
        • Получить данные с DataGrid (GetGridData)
      • Автоматизация браузеров (Browser Automation)
        • Запустить браузер (LaunchBrowser)
        • Присоединиться к браузеру (ConnectBrowser)
        • Закрыть вкладку браузера (CloseInternet)
        • Клик мышкой (MouseClickInternet)
        • Удерживать курсор (MouseOverInternet)
        • Скролл мышкой (MouseWheelInternet)
        • Нажать клавиши (PressKeysInternet)
        • Получить текст (GetUITextInternet)
        • Задать текст (SetUITextInternet)
        • Установить курсор (SetUICursorInternet)
        • Получить атрибуты (GetAttributesInternet)
        • Клик по тексту (ClickOnTextInternet)
        • Ожидать появление (WaitElementAppearInternet)
        • Ожидать исчезновение (WaitElementDisappearInternet)
        • Проверить наличие элемента (ElementExistsInternet)
        • Посчитать элементы (GetElementsCountInternet)
        • Получить селекторы (GetElementsSelectorInternet)
        • Запустить код JavaScript (RunJavaScript)
        • Обновить страницу (RefreshPageInternet)
        • Действие "Назад" (GoBackInternet)
        • Действие "Вперед" (GoForwardInternet)
        • Извлечь данные (CollectDataInternet)
        • Выбрать значение из списка (SelectOptionInternet)
        • Перетащить элемент (DragAndDropInternet)
        • Подсветить элемент (HighlightElementInternet)
        • Сохранить изображение (SaveImageInternet)
        • Копировать в буфер обмена (CopyToClipboardInternet)
        • Вставить из буфера обмена (PasteFromClipboardInternet)
        • Получить адрес и заголовок вкладки (GetUrlTabInternet)
        • Получить куки (GetCookies)
        • Задать куки (SetCookies)
        • Удалить куки (RemoveCookies)
        • Пролистать страницу (ScrollPageInternet)
        • Контролировать элемент (AssertElementInternet)
      • Невидимый браузер (HTTP)
      • Автоматизация OCR (OCR Automation)
        • Распознать по шаблону (RecognizeTemplates)
        • Клик по распознанному тексту (ClickOCRText)
        • Клик по распознанному тексту с элемента (ClickOCRTextControl)
        • Распознать текст с экрана (GetOCRText)
        • Распознать текст с элемента (GetOCRTextControl)
        • Распознать текст из изображения (OCRImage)
        • Yandex Vision OCR
        • Распознавание CAPTCHA (RecognizeCaptchaOCR)
        • Распознать паспорт (RecognizePassportRus)
        • Распознать ТОРГ-12 (RecognizeTORG12Rus)
        • Распознать УПД (RecognizeUPDRus)
        • Распознать Акт сверки (RecognizeActReconciliationRus)
        • Распознать Акт выполненных работ (RecognizeCertificateCompletionRus)
        • Распознать Счет-фактуру (RecognizeInvoiceRus)
        • Распознать Счет на оплату (RecognizeInvoicePaymentRus)
        • Распознать СНИЛС (RecognizeSNILSRus)
      • Оркестратор
      • SAP
      • Диалоговые окна
      • Word (Word Automation)
        • Создать документ (CreateWordDocument)
        • Открыть документ (OpenWordDocument)
        • Подключиться к документу (ConnectWordDocument)
        • Сохранить документ (SaveWordDocument)
        • Закрыть документ (CloseWordDocument)
        • Получить текст из документа (GetTextWordDocument)
        • Записать текст в документ (SetTextWordDocument)
        • Добавить параграф (AddParagraphWordDocument)
        • Заменить текст Word (ReplaceTextWordDocument)
        • Заменить все переменные в тексте Word (FullReplaceTextWordDocument)
        • Заменить текст Docx (ReplaceTextDocxDocument)
        • Заменить все переменные в тексте Docx (FullReplaceTextDocxDocument)
        • Распечатать документ (PrintWordDocument)
        • Считать таблицы (GetTablesWordDocument)
        • Записать таблицы (SetTablesWordDocument)
        • Считать одну таблицу (GetOneTableWordDocument)
        • Записать одну таблицу (SetOneTableWordDocument)
        • Вставить таблицу (InsertWordDataTable)
        • Вставить изображение в ячейку (InsertWordImageCell)
        • Вставить текст в ячейку (InsertWordTextCell)
        • Задать шрифт в ячейке (SetWordFontCell)
        • Поиск фрагментов (SearchRangesWordDocument)
        • Выбрать фрагмент (SelectRangeWordDocument)
        • Копировать таблицу (CopyTableWordDocument)
        • Вставить строку/колонку в таблице (InsertWordTableRange)
        • Удалить строку/колонку в таблице (DeleteWordTableRange)
        • Запустить макрос (RunWordMacro)
      • Excel (Excel Automation)
        • Создать документ (CreateExcelDocument)
        • Открыть документ (OpenExcelDocument)
        • Подключиться к документу (ConnectExcelDocument)
        • Сохранить документ (SaveExcelDocument)
        • Закрыть документ (CloseExcelDocument)
        • Получить значение ячейки (GetExcelCellValue)
        • Записать значение в ячейку (SetExcelCellValue)
        • Загрузить Таблицу Данных (LoadDataTable)
        • Сохранить Таблицу Данных (SaveDataTable)
        • Добавить лист (AddWorksheet)
        • Удалить лист (DeleteWorksheet)
        • Переименовать лист (RenameWorksheet)
        • Переключиться на лист (ActivateWorksheet)
        • Копировать ячейки (CopyCells)
        • Получить данные из диапазона (GetExcelRange)
        • Записать данные в диапазон (SetExcelRange)
        • Очистить диапазон (ClearExcelRange)
        • Вставить данные в диапазон (InsertExcelTable)
        • Поиск текста (FindTextExcel)
        • Количество и имена листов (CountExcelWorkbook)
        • Вставить строку/колонку/ячейку (InsertExcelRange)
        • Удалить строку/колонку/ячейку (DeleteExcelRange)
        • Получить количество строк и столбцов (GetExcelCountColRow)
        • Запустить макрос (RunExcelMacro)
        • Задать цвет/стиль шрифта (SetExcelRangeColor)
        • Задать границы ячеек (SetExcelRangeBorder)
        • Задать размеры ячеек (SetExcelRangeSize)
        • Получить цвет ячейки (GetExcelCellColor)
      • Outlook (Outlook Automation)
        • Получить письма (GetOutlookMailMessages)
        • Отправить письмо (SendOutlookMailMessage)
        • Переслать письмо (ReSendOutlookMailMessage)
        • Скачать вложение (SaveAttachmentsFromOutlookMessage)
        • Сохранить письмо (SaveMailFromOutlookMessage)
        • Получить список папок (GetOutlookFolders)
        • Переместить письмо в папку (MoveOutlookMessage)
        • Извлечь e-mail отправителя из письма (ExtractEmailFromOutlookMessage)
        • Загрузить файл msg (LoadMsgFile)
        • Ответить на письмо (ReplyOutlookMailMessage)
        • Изменить свойства письма (ChangePropertiesMailFromOutlookMessage)
      • Exchange (Exchange Automation)
        • Получить письма (GetExchangeMailMessages)
        • Отправить письмо (SendExchangeMailMessage)
        • Переслать письмо (ReSendExchangeMailMessage)
        • Скачать вложение (SaveAttachmentsFromExchangeMessage)
        • Сохранить письмо (SaveMailFromExchangeMessage)
        • Переместить письмо в папку (MoveExchangeMessage)
        • Ответить на письмо (ReplyExchangeMailMessage)
      • Файловая система (File System)
        • Считать файл (FileRead)
        • Считать строку из файла (FileLineRead)
        • Записать в файл (FileWrite)
        • Дописать в файл (FileAppend)
        • Получить размер файла (GetFileLength)
        • Получить список файлов/папок (GetItems)
        • Получить путь (GetPathFileName)
        • Создать файл (NewTextFile)
        • Создать папку (NewFolder)
          • Пример заполнения полей в Блоке “Создать папку”
        • Копировать файл/папку (CopyItem)
        • Переместить файл/папку (MoveItem)
        • Удалить файл/папку (RemoveItem)
        • Очистить папку (ClearFolder)
        • Проверить наличие файла/папки (DoesItemExist)
        • Переименовать файл/папку (RenameItem)
        • Разложить путь (ExpandPath)
        • Объединить путь (CombinePath)
        • Ожидать файл (WaitFile)
      • Буфер обмена
      • Списки и словари (Collections)
        • Добавить элемент в список (ListAddItem)
        • Вставить элемент в список (ListInsertItem)
        • Удалить элемент из списка по значению (ListRemoveItem)
        • Удалить элемент из списка по индексу (ListRemoveAtItem)
        • Очистить список (ListClear)
        • Сортировать список (ListSort)
        • Удалить дубликаты в списке (ListRemoveDuplicates)
        • Проверить наличие элемента в списке (ListContains)
        • Добавить элемент в словарь (HashtableAddItem)
        • Удалить элемент из словаря (HashtableRemoveItem)
        • Очистить словарь (HashtableClear)
        • Проверить наличие ключа в словаре (HashtableContainsKey)
        • Проверить наличие значения в словаре (HashtableContainsValue)
        • Загрузить список из файла (ListLoadFromFile)
        • Сохранить список в файл (ListSaveToFile)
        • Загрузить словарь из файла (HashtableLoadFromFile)
        • Сохранить словарь в файл (HashtableSaveToFile)
        • Словарь в список (HashtableToList)
        • Список в словарь (ListToHashtable)
      • Таблицы Данных (DataTable)
        • Получить значение ячейки (GetCellValue)
        • Записать в ячейку значение (SetCellValue)
        • Добавить столбец (AddColumn)
        • Добавить строку (AddRow)
        • Очистить строки (ClearRows)
        • Удалить строку (RemoveRow)
        • Удалить столбец (RemoveColumn)
        • Переименовать столбец (RenameColumn)
        • Изменить тип столбца (ChangeTypeColumn)
        • Сортировать (SortDataTable)
        • Обработка таблицы (DistinctDataTable)
        • Соединить Таблицы Данных (MergeDataTable)
        • Найти строки (SelectRows)
        • Проверить существование значения (ContainsValue)
        • Найти строку (FindRow)
        • Проверить существование колонки (ContainsColumn)
        • Удалить пустые строки/столбцы (RemoveEmptyRowColumn)
        • Извлечь диапазон (GetDataTableRange)
        • Вставить таблицу (InsertDataTable)
        • Транспонирование (TransposeDataTable)
        • Загрузить из CSV (LoadCSVDataTable)
        • Сохранить в CSV (SaveCSVDataTable)
        • Таблицу в текст (DataTableToText)
        • Таблицу в словарь (DataTableToHashtable)
        • Словарь в таблицу (HashtableToDataTable)
        • Таблицу в список (DataTableToList)
        • Список в таблицу (ListToDataTable)
      • Дата и время
      • Электронная почта (Mail)
        • Получить письма через POP3 (GetPOP3MailMessages)
        • Получить письма через IMAP (GetIMAPMailMessages)
        • Получить IMAP папки (GetIMAPFolders)
        • Переместить письмо через IMAP (MoveIMAPMailMessage)
        • Отправить письмо (SendMailMessage)
        • Переслать письмо (ReSendMailMessage)
        • Сохранить письмо (SaveMailMessage)
        • Скачать все вложения (SaveAttachment)
        • Скачать вложение (SaveAttachmentAs)
        • Ответить на письмо (ReplyMailMessage)
        • Сохранить в отправленных (SaveSentMailMessages)
      • PDF (PDF Automation)
        • Разделить документ на изображения (RenderToImages)
        • Собрать документ из изображений (GenerateFromImages)
        • Получить количество страниц (GetCountPages)
        • Отделить часть документа (SplitDocument)
        • Объединить документы (MergeDocument)
        • Извлечь изображения (ExtractImages)
        • Получить текст и ссылки со страницы (GetPageText)
        • Получить текст со страницы OCR (GetPageTextOCR)
        • Извлечь таблицу (PDFExtractTables)
        • Сохранить страницу как изображение (GetPageAsImage)
        • Добавить изображение на страницу (AddImageToPage)
        • Повернуть страницу (RotatePages)
        • Удалить изображения из документа (RemoveImagesFromPage)
        • Извлечь значения форм (ExtractFormValues)
        • Задать значения форм (SetFormValues)
        • Удалить водяные знаки (RemoveWatermark)
      • Текст (String Automation)
        • Замена подстроки (ReplaceString)
        • Найти подстроку в тексте (ContainsString)
        • Получить подстроку (GetSubString)
        • Получить длину строки (GetLengthString)
        • Разделить текст (SplitString)
        • Соединить текст (JoinString)
        • Триммировать строку (TrimString)
        • Получить список подстрок по регулярному выражению (GetListRegex)
        • Найти строку между двух подстрок (FindTextBetween)
        • Заменить все переменные в тексте (FullReplaceText)
        • Изменить регистр (ChangeCase)
        • Кодировать в формат HTML (HtmlEncode)
        • Декодировать из HTML (HtmlDecode)
        • Закодировать в Base64 (ToBase64)
        • Раскодировать из Base64 (FromBase64)
        • Кодировать строку URL-адреса (URLEncode)
        • Декодировать строку URL-адреса (URLDecode)
        • Если пустая строка (IsStringEmpty)
        • Сравнить похожесть (CompareSimilarity)
        • Преобразовать строку (TransformString)
        • Преобразовать объект в JSON (ToJson)
        • Преобразовать JSON в объект (FromJson)
        • Преобразовать объект в XML (ToXML)
        • Преобразовать XML в объект (FromXML)
        • Транслитерация строки (TransliterationString)
        • Цикл Для каждого Json (ForeachJson)
        • Проверка схемы Json (ValidateJsonSchema)
        • Сравнить Json (DifferJson)
      • FTP/SFTP
        • Получить список папок (ListFTPFolders)
        • Получить размер файла (GetFTPfilesize)
        • Скачать папку (DownloadFTPFolder)
        • Скачать файл (DownloadFTPFile)
        • Загрузить папку (UploadFTPFolder)
        • Загрузить файл (UploadFTPFile)
        • Создать папку (CreateFTPFolder)
        • Удалить папку (RemoveFtpFolder)
        • Удалить файл (RemoveFTPfile)
        • Переименовать файл/папку (RenameFTPitem)
      • Процессы/Службы/Окна
      • Терминалы (Terminal Automation)
        • Подключиться к сессии (TerminalConnectSession)
        • Закрыть сессию (TerminalCloseConnection)
        • Получить курсор (TerminalGetCursor)
        • Установить курсор (TerminalMoveCursor)
        • Получить текст с позиции (TerminalGetTextPosition)
        • Получить значение поля с позиции (TerminalGetFieldPosition)
        • Записать текст в позицию (TerminalSetTextPosition)
        • Записать значение поля в позицию (TerminalSetFieldPosition)
        • Получить значение поля (TerminalGetField)
        • Записать значение поля (TerminalSetField)
        • Получить область экрана (TerminalGetScreenArea)
        • Отправить клавиши (TerminalSendKeys)
        • Отправить функциональную клавишу (TerminalSendControlKey)
        • Ожидать текст с позиции (TerminalWaitTextPosition)
        • Ожидать значение поля с позиции (TerminalWaitFieldPosition)
        • Получить значение поля между текстом (TerminalGetFieldBetween)
        • Записать значение поля между текстом (TerminalSetFieldBetween)
      • Реестр
      • 1С (1C Automation)
        • Подключиться (1CCreateConnection)
        • Закрыть соединение (1CCloseConnection)
        • Выполнить запрос (1CExecuteQuery)
        • Выполнить код (1CExecuteCode)
        • Выполнить код (1CExecuteCode)
        • Извлечь данные (1CCollectData)
        • Клик мышкой по ячейке в таблице 1С (1CTableCellClick)
        • Управление CheckBox (1CCheckboxControl)
      • Базы данных
      • Google Sheets
        • Получить значение ячейки (GetGoogleSheetsCellValue)
        • Записать значение в ячейку (SetGoogleSheetsCellValue)
        • Получить значение диапазона (GetGoogleSheetsRange)
        • Записать значение в диапазон (SetGoogleSheetsRange)
      • Удаленный рабочий стол RDP/Citrix
        • Генерация подключения (RDPGenerateConnection)
        • Создание подключения (RDPCreateConnection)
        • Подключиться к сеансу (RDPConnectInstance)
        • Закрыть подключение (RDPCloseConnection)
        • Отключиться от RDP сессии (RDPDisconnectSession)
        • Работа с файлами (RDPOperationFile)
        • Выполнить сценарий (RDPRunScript)
      • Работа с архивами
      • Бизнес-функции
      • Изображения
      • Telegram
        • Бот. Создать подключение (TelegramBotCreate)
        • Бот. Закрыть подключение (TelegramBotClose)
        • Бот. Получить сообщение (TelegramBotReceived)
        • Бот. Список чатов (TelegramBotGetChats)
        • Бот. Отправить сообщение (TelegramBotSendText)
        • Бот. Отправить контакт (TelegramBotSendContact)
        • Бот. Отправить файл (TelegramBotSendFile)
        • Бот. Отправить фото (TelegramBotSendPhoto)
        • Бот. Отправить голосовое сообщение (TelegramBotSendVoice)
        • Бот. Редактировать сообщение (TelegramBotEditText)
        • Бот. Скачать файл (TelegramBotDownloadFile)
        • Клиент. Создать подключение (TelegramClientCreate)
        • Клиент. Закрыть подключение (TelegramClientClose)
        • Клиент. Получить сообщение (TelegramClientReceived)
        • Клиент. Список чатов (TelegramClientGetChats)
        • Клиент. Список контактов (TelegramClientGetContacts)
        • Клиент. Отправить сообщение (TelegramClientSendText)
        • Клиент. Отправить файл (TelegramClientSendFile)
        • Клиент. Отправить фото (TelegramClientSendPhoto)
        • Клиент. Отправить голосовое сообщение (TelegramClientSendVoice)
        • Клиент. Скачать файл (TelegramClientDownloadFile)
        • Клиент. Выгрузить сообщения (TelegramClientGetMessages)
        • Клиент. Получить идентификатор потока сообщений (TelegramGetMessageThreadId)
        • Клиент. Получить Id чата (TelegramClientGetChatId)
        • Клиент. Создать чат (TelegramClientCreateChat)
        • Клиент. Добавить пользователя в чат (TelegramClientAddUserToChat)
      • Учетные данные Windows и CyberArk (Windows Credentials)
        • Создать учетные данные (SetWindowsCredentials)
        • Получить учетные данные (GetWindowsCredentials)
        • Удалить учетные данные (DeleteWindowsCredentials)
        • Получить учетные данные CyberArk (GetCyberArkCredentials)
      • Машинное обучение
      • Анализ текстов NLP (Text analysis)
        • Лемматизация текста (LemmatizationText)
        • Извлечь части речи POS (ExtractPartsSpeech)
        • Извлечь сущности NER (ExtractEntities)
    • Примеры Роботов
      • 1С Приходная накладная
      • 1С Приходная накладная (COM)
      • Actions
        • Actions. Часть 1 - Распознавание приходной накладной
        • Actions. Часть 2 - Заведение приходной накладной
      • AI Chat With Own Document
        • Create Embeddings
        • Search Embeddings
      • Calc Example
      • Calculator Action Button with Dialog
      • Calculator Action Triggers
      • Cmd Example
      • Enroll Certificates
        • Complete Enrollment
        • Create Enrollment Order
      • Find Suppliers
      • Get Auto.ru
      • Install RDP
      • Print Certificates and Badges
      • Save HeadHunter Resumes
      • Save SuperJob Jobs
      • Telegram Bot
      • Telegram client
      • Telegram Multi-User Bot
      • Telegram Multi-User Client
      • Whatsapp
      • Крестики-нолики
    • Настройка запуска Робота через Планировщик Windows
    • Перенос роботов с Windows на Linux
    • Sherpa Designer: ответы на часто задаваемые вопросы
      • Настройка входных и выходных параметров в свойствах проекта
  • Шаблонизатор Sherpa RPA
    • Интерфейс Шаблонизатора
      • Основное меню Шаблонизатора
        • Меню "Файл"
        • Меню "Обработка"
        • Кнопка "Открыть исходный файл"
        • Кнопка "Обработать документ"
        • Кнопка "Проверить"
        • Кнопка "Добавить атрибут"
        • Кнопка "Выполнить полное сканирование"
          • Результат полного сканирования
        • Кнопка "Умный помощник"
        • Переключатель "Масштаб"
        • Меню "Отображать"
      • Центральная рабочая область Шаблонизатора
      • Панель настроек Шаблонизатора
        • Настройки
        • Якоря
        • Атрибуты
        • Таблицы
        • Чертежи таблиц
    • Действия в Sherpa Designer после создания шаблона
      • Значения переменных
      • Работа с многостраничными документами
    • Примеры
      • Создание шаблона на примере документа «Справка о стоимости выполненных работ»
        • Предобработка документа
        • Создание шаблона
        • Работа с таблицами
        • Якоря
        • Создание атрибутов
      • Создание шаблона c фиксированными атрибутами на примере документа «Счет на оплату»
  • Sherpa Orchestrator
    • Основные понятия
    • Рекомендации по размещению Оркестратора
    • Резервное копирование и восстановление
    • Развертывание платформы под управлением Оркестратора
      • Установка Sherpa RPA Coordinator
        • Установка Sherpa RPA Coordinator на Windows
        • Установка Sherpa Coordinator на ОС Astra Linux
        • Установка Sherpa Coordinator на RedOS
      • Установка Sherpa RPA Runtime
    • Установка Sherpa Orchestrator
      • Установка и настройка SSL сертификатов
    • Работа в Sherpa Orchestrator
      • Начало работы в Sherpa Orchestrator
        • Настройки Оркестратора
        • Создание новой Лицензии в Оркестраторе
        • Добавление Робота в Оркестраторе
        • Принципы Работы разных типов Роботов в Оркестраторе
        • Создание Очереди в Оркестраторе
        • Создание Задачи в Оркестраторе
          • Работа с Задачами в Sherpa Designer
        • Создание нового Процесса (сценария) в Оркестраторе
          • Создание новой версии Процесса в Sherpa Designer
        • Создание Работы с выбранными Роботом и Процессом
        • Создание и настройка Триггеров в Оркестраторе
      • Шифрование
      • Параметры Пользователя
      • Рабочая область Оркестратора
      • Экраны
        • Обзор
          • NUMBER
          • BAR CHART
          • PIE CHART
          • LINE CHART
          • TIME LINE
          • TABLE
        • Роботы
        • Процессы
        • Пакеты
        • Ресурсы
        • Хранилище
        • Работы
        • Очереди
        • Действия
          • Дизайнер Формы
            • HTML
            • Label
            • Number input
            • Text input
            • Email
            • Password
            • Date
            • Time
            • Checkbox Group
            • Radio Group
            • PDF
            • Data Table
            • Image
          • Пример создания действия и его настройки
        • Триггеры
        • Сообщения Роботов
        • Аккаунты
        • Пользователи
          • Авторизация Пользователей
        • Роли
        • Папки объектов
        • Аудит
        • Лицензии
        • API
    • API
      • Робот
        • /api/robot/create
        • /api/robot/read/{guid}
        • /api/robot/update
        • /api/robot/delete/{guid}
        • /api/robot/getStatus/{guid}
        • /api/robot/setStatus
      • Группы Роботов
        • /api/robotGroup/create
        • /api/robotGroup/read/{guid}
        • /api/robotGroup/update
        • /api/robotGroup/delete/{guid}
        • /api/robotGroup/addRobot
        • /api/robotGroup/delete/{guid}
      • Процесс
        • /api/process/create
        • /api/process/read/{guid}
        • /api/process/update
        • /api/process/delete/{guid}
      • Версия процесса
        • /api/processVersion/create
        • /api/processVersion/read/{guid}
        • /api/processVersion/update
        • /api/processVersion/delete/{guid}
      • Работа
        • /api/job/create
        • /api/job/read/{guid}
        • /api/job/update
        • /api/job/delete/{guid}
      • Очередь
        • /api/queue/create
        • /api/queue/read/{guid}
        • /api/queue/update
        • /api/queue/delete/{guid}
      • Задача
        • /api/task/create
        • /api/task/read
        • /api/task/filter/read/{guid}[/{filters}]
        • /api/task/filter/list/{guid}[/{filters}]
        • /api/task/update
        • /api/task/delete
        • /api/task/addTag
        • /api/task/removeTag
      • Триггер
        • /api/schedule/create
        • /api/schedule/read/{guid}
        • /api/schedule/update
        • /api/schedule/delete/{guid}
      • Ресурс
        • /api/asset/create
        • /api/asset/read/{guid}
        • /api/asset/update
        • /api/asset/delete/{guid}
      • Хранилище
        • /api/folders/create
        • /api/folders/read/{guid}
        • /api/folders/list
        • /api/folders/update
        • /api/folders/delete/{guid}
        • /api/files/create
        • /api/files/read/{guid}
        • /api/files/update
        • /api/files/delete/{guid}
      • Лог
        • /api/log/create
        • /api/log/read/{guid}
        • /api/log/list
        • /api/log/purge
      • Аккаунт
        • /api/account/create
        • /api/account/read/{guid}
        • /api/account/update
        • /api/account/delete/{guid}
      • Пример вызова API на языке Python
    • Sherpa Orchestrator: ответы на часто задаваемые вопросы
  • Sherpa AI Server
    • Установка Sherpa AI Server
    • Авторизация пользователя в Sherpa AI Server
    • Диаграмма развертывания Sherpa AI Server в связке с Роботами
    • Работа в Sherpa AI Server
      • Главный интерфейс Sherpa AI Server
      • Чат
      • История чатов
      • Ассистенты
      • Документы
        • Работа в связке с Sherpa Designer
      • Аккаунты
      • Пользователи
        • Авторизация пользователей
      • Роли
      • Аудит
      • Лицензии
      • API
  • Sherpa Process Discovery
    • Системные требования
    • Диаграмма развертывания
      • Последовательность шагов процесса
      • Конфигурация сети
      • Механизмы аутентификации
  • Обновления
    • Обновления Sherpa Designer
      • Версия 1.33
      • Версия 1.32
      • Версия 1.31
      • Версия 1.30
      • Версия 1.29
      • Версия 1.28
      • Версия 1.27
      • Версия 1.26
      • Архив обновлений
        • Версия 1.25
        • Версия 1.24
        • Версия 1.23
        • Версия 1.22
        • Версия 1.21
        • Версия 1.20
        • Версия 1.19
        • Версия 1.15
        • Версия 1.12b
        • Добавлена поддержка Telegram
    • Обновления Sherpa Orchestrator
      • Версия 141854
      • Версия 141853
      • Версия 141852
      • Версия 141851
      • Версия 141850
      • Версия 141849
      • Версия 141848
      • Версия 141847
      • Версия 141846
      • Версия 141845
      • Версия 141844
  • Лицензии
    • Отличия Attended и Attended Floating Лицензий
    • Активация Лицензий через Sherpa Assistant
    • Управление Лицензиями Sherpa RPA через Sherpa Orchestrator
    • Лицензии Sherpa AI Server
  • Безопасность
    • Схема работы платформы Sherpa RPA c Yandex Vision через VPN
  • Обучение по разработке на Платформе Sherpa RPA
    • Обучающий курс по разработке на Платформе Sherpa RPA
  • Ссылки на дистрибутивы
    • Дистрибутивы Sherpa RPA (Windows)
    • Дистрибутивы Sherpa RPA (Linux)
  • Контакты
Powered by GitBook
On this page
  • Окно "Редактировать селектор"
  • Настройка селектора
  1. Sherpa Designer
  2. Работа в Sherpa Designer
  3. Панели свойств и переменных и работа с ними
  4. Панель свойств

Настройка селекторов

PreviousМетоды в выраженияхNextПанель "Переменные"

Last updated 2 months ago

Программному роботу для имитации конкретных действий в интерфейсе пользователя (операционной системе, программах, веб-страницах) необходимо взаимодействовать с различными окнами, кнопками, раскрывающимися списками, гиперссылками и так далее. В действиях с экранными формами Sherpa RPA осуществляет поиск (перебор) положения элементов на экране. При этом выбор нужного элемента на экране – это сложная задача, перебор может осуществляться среди нескольких тысяч элементов, которые присутствуют на экране. Достаточно часто признаки элементов управления, по которым их можно найти на экране (названия, подписи, системные свойства и дескрипторы) подвержены динамическим изменениям, например, заголовок веб-страницы может измениться во время процесса автоматизации.

Для решения этой проблемы Дизайнер использует так называемые "Селекторы". Селекторы хранят атрибуты элемента графического интерфейса пользователя в виде набора инструкций в формате XML, которые подсказывают роботу, как найти тот или иной элемент управления на экране.

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

Селектор – подсказка, руководство к действию для робота, как ему найти на экране тот или иной элемент управления. Робот записывает эти селекторы автоматически при записи каких-либо действий.

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

Окно "Редактировать селектор"

Окно "Редактировать селектор" вызывается из правой панели свойств селектора (только для тех блоков, в которых есть селекторы) нажатием на кнопку с многоточием. Все блоки, связанные с графическими элементами, обладают этим свойством. Селектор доступен и в случае, когда Блоки добавляются в Проект с помощью инструмента "Запись", и в готовых блоках для операций с экранными формами (UI Automation) из палитры.

Окно "Редактировать селектор" позволяет просмотреть автоматически сгенерированный селектор и изменить сам селектор и его атрибуты. Вы можете включать или исключать определенные атрибуты или добавлять подстановочные знаки в динамически изменяющиеся значения.

При нажатии на кнопку с многоточием справа от поля "Селектор", появится окно редактирования селектора.

№ п/п

Элемент интерфейса

Описание

1.

кнопка “Конвертер селекторов UiPath…”

Позволяет открыть окно для ввода текста из поля Selector активности UIPath.

1.1.

Позволяет открыть перейти к возможности переключить режим работы UIPath.

3.

кнопка “Добавить новую строку”

Позволяет добавить новую строку.

4.

кнопка “Удалить строку”

Позволяет удалить выбранную строку.

5.

кнопка “Вставить из буфера обмена”

Позволяет вставить информацию из буфера обмена.

6.

кнопка “Открыть Sherpa Explorer”

Позволяет открыть .Sherpa Explorer

7.

кнопка “Вставить модификатор”

Позволяет вставить модификатор, который можно выбрать из выпадающего списка. Возможные варианты:

  • ? (один любой символ);

  • * (несколько любых символов);

  • xpath: (обработка XPath);

  • regex: (обработка Regex).

8.

кнопка “Вставить переменную”

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

9.

кнопка “Запись”

Позволяет запустить процедуру записи селектора.

10.

кнопка “Проверить”

Позволяет проверить заданное в селекторе позиционирование элемента.

11.

кнопка “Подсветить”

Позволяет “подсветить” (указать) элемент самый последний элемент селектора.

11.1.

Позволяет подсветить путь (т.е., каждую строку селектора). Данная кнопка позволяет увидеть, как именно происходит поиск селектора в интерфейсе окна.

12.

кнопка “Удалить селектор”

Позволяет удалить селектор.

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

Итак, селектор – это таблица, состоящая из колонок и срок, при этом каждая строка – некая команда, шаг, который робот должен выполнить. Команды читаются сверху вниз. Верхняя строка выполняется самой первой, нижняя самой последней. Робот идёт по шагам сверху вниз и выполняет каждую строку как команду. Он ищет на экране элемент, у которого все свойства одновременно равны тому, что указано в колонках строки селектора.

Например, рассмотрим первую строку селектора, где:

  • Тип – процесс. Т.е. эта строка ищет необходимое приложение для запуска.

  • Имя процесса здесь – Calculator, оно записано так, как фигурирует в диспетчере задач.

Итак, на первом этапе робот найдет процесс с названием Calculator среди запущенных процессов в памяти компьютера.

Следующая строка обозначается как UIElement, это уже окно или какой-то конкретный элемент управления этого селектора. Для того, чтобы найти нужный элемент управления, робот одновременно будет искать элемент с именем Калькулятор, указанным именем класса и элементом управления Window, отсюда понятно, что речь идёт об окне. Данная строка позволяет найти конкретное окно калькулятора.

Спускаемся на строку ниже. Теперь в найденном окне необходимо найти последовательно все контейнеры, которые приведут к нужной кнопке. Таких контейнеров здесь три. Данные контейнеры могут визуально не отображаться в приложении, т.к. они были созданы для разработчиков. Однако по названию “Числовая панель” можно догадаться, что это контейнер, содержащий все кнопки калькулятора. И далее видим, что самый последний элемент – та самая цифра 6, на которую кликал пользователь.

Кнопка "Проверить" проверяет заданное в селекторе позиционирование элемента, то есть в результате Проверки может выдаваться два состояния:

  • Ошибка при проверке

  • Проверка прошла успешно, элемент с заданным в Селекторе положением найден на экране.

Кнопка "Подсветить" — указывает на элемент пользовательского интерфейса, подсвечивает сам элемент и элементы верхнего уровня на пути к нему красными рамками. Выделение пропадает автоматически через несколько секунд.

Кнопка "Запись" – запускает процедуру записи Селектора путем клика на нужном элементе управления на экране.

Зайдите в Selector и нажмите "Запись". Окно SherpaDesigner (с открытым окном "Редактировать селектор") сворачивается. В верхней части экрана появится подсказка для работы в режиме Записи. Выбирайте нужное действие для вашего бизнес-процесса, то есть нужный элемент на экране и кликайте на него. Обратите внимание, элементы перед кликом должны подсветиться (то есть должна появиться красная рамка).

Если подсветка не появляется автоматически или пропадает, то для подсветки нужного элемента, необходимо нажать клавишу Shift на клавиатуре. Подсветка нужна, чтобы точно выбрать элемент под мышкой.

Варианты записи клика:

  • кликнуть левой кнопкой мыши;

  • нажать левый Ctrl, что эмулирует нажатие клика левой кнопкой мыши;

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

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

Примечание: из окна “Редактировать селектор” записывается только одно действие (клик, вставка, зависание над кнопкой и т.д.), в отличие от использования инструмента записи через основное меню, когда вы можете записать несколько действий сразу. То есть, после совершения действия (клика) пользователь автоматически возвращается в окно “Редактировать селектор”.

После возврата в окно редактирования Селектора рекомендуем использовать кнопки «Подсветить» или «Проверить», чтобы проверить правильно ли выбран элемент. Если элемент выбран неправильно, то можно повторить попытку, нажав кнопку Запись, или найти и исправить ошибку в строках Селектора вручную.

Настройка селектора

Каждая строка селектора имеет один или несколько атрибутов, помогающих правильно идентифицировать точное местоположение выбранного участка экрана. Атрибуты отображают, в какой программе идет запись, в каком окне и элементе, а также конкретный уровень выбранного элемента с помощью таких атрибутов как Type, Name, ClassName, ControlType, Index, Id, Text. Каждый атрибут может имеет присвоенное значение, по которому будет осуществляться поиск. Важно выбрать атрибуты с постоянным значением. Если значение атрибута изменяется при каждом запуске приложения, то селектор не сможет правильно идентифицировать элемент. В этом случае рекомендуем отказаться от использования данного атрибута (оставить его значение пустым).

№ п/п

Атрибут

Описание атрибута

1.

Type

Тип элемента.

2.

Name

Имя элемента.

3.

ClassName

Имя класса элемента.

4.

ControlType

Тип элемента управления (например, кнопка, текстовое поле и т. д.).

5.

Id

Идентификатор элемента (обычно уникальный для каждого элемента).

6.

Index

Индекс элемента в списке подходящих элементов.

7.

Text

Текст внутри элемента.

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

  • Звездочка (*) заменяет любое количество символов в значении атрибута;

  • Знак вопроса (?) заменяет один символ в значении атрибута;

  • $ИмяПеременной – использование имени переменной, начинающегося на символ $, позволяет вставить значение этой переменной вместо значения атрибута или его части.

Видео с демонстрацией работы с селекторами:

кнопка

кнопка

Полноценное руководство по работе с веб-селекторами находится .

Запись селекторов: перекрывающихся или невидимых элементов на примере окна авторизации Chrome
Работа с селекторами окна "Загрузки" Chrome
Запись селекторов всплывающего окна в Internet Explorer
Конвертация селекторов UIPath > Sherpa RPA в окне "Редактировать селектор"
Работа функции "Подсветить путь" в окне "Редактировать селектор"
Работа с браузером Firefox
здесь