Группа «SAP»¶
Порядок получения элемента с помощью SapSpy¶
Получение XPath элемента¶
Для заполнения действий с параметром элемент необходимо создать элемент SAP. Для этого необходимо открыть SapSpy.
Нажать на троеточие около поля «Элемент».
Далее, на кнопку
В появившемся окне нажать на кнопку SapSpy
Будет открыто окно:
Создать новое подключение (ввести данные учетной записи, далее нажать «Подключиться»)
Либо подключиться к открытой учетной записи SAP (выбрать учетную запись, нажать «Подключиться»).
Для получения id элемента применяется кнопка «Захватить», затем CTRL+ левый клик мышью.
После получения элемента нажимаем кнопку «Остановить».
Для проверки правильности захвата нажимаем кнопку «Найти» – SPY обводит найденный элемент красной рамочкой.
В качестве xpath необходимо получить session+id – /app/con[0]/ses[0]/wnd[0]/usr/tblSAPMP50ATC_MENU_EVENT
Если в работе используется несколько окон SAP, xpath элемента изменяется соответственно:
первое открытое окно - /app/con[0]/ses[0]/wnd[0]/usr/tblSAPMP50ATC_MENU_EVENT
второе открытое окно - /app/con[0]/ses[1]/wnd[0]/usr/tblSAPMP50ATC_MENU_EVENT
и т.д.
Получение Xpath таблицы¶
Для работы с действиями «Клик по ячейке таблицы», «Получить таблицу», «Ввести текст в ячейку таблицы» и «Получить ячейку таблицы» используется один и тот же xpath таблицы.
- В случае, если таблица имеет вид tbl:
Для этого выбирается необходимая ячейка в таблице, либо сама таблица, далее полученный xpath
/app/con[0]/ses[0]/wnd[0]/usr/tblSAPMP50ATC_MENU_EVENT/txtT529T-MNTXT[0,12]
![]()
сокращается до xpath таблицы:
/app/con[0]/ses[0]/wnd[0]/usr/tblSAPMP50ATC_MENU_EVENT
Далее полученный xpath используется для создания элемента, применяемого и для таблиц, и для ячеек таблиц:
А в адрес ячейки в таблице ([0,12]) вносятся в сами параметры действия:
- В случае, если таблица имеет вид shell:
Полученный xpath не сокращается, а адрес ячейки в таблице ([0,12]) также вносятся в сами параметры действия.
Действия¶
Получить таблицу/ Get table¶
Задача: необходимо получить таблицу из SAP и сохранить ее в формате CSV.
Решение: воспользоваться действиями «Подключиться к сессии», «Получить таблицу», «Сохранить таблицу в CSV».
Реализация:
Собрать схему робота состоящую из действий:
Настроить параметр действия «Подключиться к сессии».
Настроить параметры действия «Получить таблицу». Параметр «Элемент» необходимо получить через SAP Spy.
Настроить параметры действия «Сохранить таблицу в CSV».
Запустить робота, нажав на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно.
Таблица сохранена в формате CSV.
** Особые условия использования **
Авторизация / Authorization¶
Задача: авторизоваться в SAP.
Решение: воспользоваться действием «Авторизация».
Реализация:
Перенести действие на рабочую область и настроить его параметры. В параметры действия вносятся данные учетной записи SAP.
Нажать на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно.
Произведена авторизация в SAP.
Ввести текст / Enter text¶
Задача: подключиться к открытой сессии SAP и ввести текст в поле.
Решение: воспользоваться действием «Подключиться к сессии», «Ввести текст».
Реализация:
Собрать схему робота, состоящую из действий:
Настроить параметры для действия «Подключиться к сессии».
В поле «Сессия» указывается порядковый номер открытой сессии одного пользователя (0 – первый подключённый пользователь, 1- второй и т.д.), к которой необходимо подключиться. Нумерация начинается с 0 и зависит от времени входа в учетную запись
Настроить параметры для действия «Ввести текст». Порядок получения элемента указан в разделе Порядок получения элемента с помощью SapSpy
Нажать на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно.
Текст введен в поле.
Ввести текст в ячейку таблицы/ Enter text in a table cell¶
Задача: подключиться к открытой сессии SAP и ввести текст WF_Veryfy041 в ячейку таблицы.
Решение: воспользоваться действием «Подключиться к сессии», «Ввести текст в ячейку таблицы».
Реализация:
Собрать схему робота, состоящую из действий:
Настроить параметры для действия «Подключиться к сессии».
В поле «Сессия» указывается порядковый номер открытой сессии одного пользователя (0 – первый подключённый пользователь, 1- второй и т.д.), к которой необходимо подключиться. Нумерация начинается с 0 и зависит от времени входа в учетную запись
Настроить параметры для действия «Ввести текст в ячейку таблицы». Порядок получения элемента (таблицы) указан в разделе Порядок получения элемента с помощью SapSpy
Нажать на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно.
Значение добавлено в ячейку.
Выбрать из выпадающего списка / Select from drop down list¶
Задача: подключиться к открытой сессии SAP и выбрать из выпадающего списка значение «Должность».
Решение: воспользоваться действием «Подключиться к сессии», «Выбрать из выпадающего списка».
Реализация:
Собрать схему робота, состоящую из действий:
Настроить параметры для действия «Подключиться к сессии».
В поле «Сессия» указывается порядковый номер открытой сессии одного пользователя (0 – первый подключённый пользователь, 1- второй и т.д.), к которой необходимо подключиться. Нумерация начинается с 0 и зависит от времени входа в учетную запись
Настроить параметры для действия «Выбрать из выпадающего списка». Порядок получения элемента указан в разделе Порядок получения элемента с помощью SapSpy
Нажать на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно.
Требуемое значение выбрано из выпадающего списка.
Выделить на экране элементы / Select elements on the screen¶
Задача: подключиться к открытой сессии SAP и выделить на экране элемент.
Решение: воспользоваться действием «Подключиться к сессии», «Выделить на экране элементы».
Реализация:
Собрать схему робота, состоящую из действий:
Настроить параметры для действия «Подключиться к сессии».
В поле «Сессия» указывается порядковый номер открытой сессии одного пользователя (0 – первый подключённый пользователь, 1- второй и т.д.), к которой необходимо подключиться. Нумерация начинается с 0 и зависит от времени входа в учетную запись
Настроить параметры для действия «Выделить на экране элементы». Порядок получения элемента указан в разделе Порядок получения элемента с помощью SapSpy
Нажать на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно.
Элемент выделен на экране.
Закрыть SAP / Сlose SAP¶
Задача: подключиться к открытой сессии SAP и получить название ячейки таблицы, закрыть приложение SAP.
Решение: воспользоваться действием «Подключиться к сессии», «Получить ячейку таблицы», «Закрыть SAP»
Реализация:
Собрать схему робота, состоящую из действий:
Настроить параметры для действия «Подключиться к сессии».
В поле «Сессия» указывается порядковый номер открытой сессии одного пользователя (0 – первый подключённый пользователь, 1- второй и т.д.), к которой необходимо подключиться. Нумерация начинается с 0 и зависит от времени входа в учетную запись
Настроить параметры для действия «Получить ячейку таблицы». Порядок получения элемента указан в разделе Порядок получения элемента с помощью SapSpy
Настроить параметры для действия «Закрыть SAP».
Нажать на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно. Данные из ячейки таблицы получены. Приложение SAP закрыто.
Клик / Сlick¶
Задача: подключиться к открытой сессии SAP и кликнуть по элементу.
Решение: воспользоваться действием «Подключиться к сессии», «Клик».
Реализация:
Собрать схему робота, состоящую из действий:
Настроить параметры для действия «Подключиться к сессии».
В поле «Сессия» указывается порядковый номер открытой сессии одного пользователя (0 – первый подключённый пользователь, 1- второй и т.д.), к которой необходимо подключиться. Нумерация начинается с 0 и зависит от времени входа в учетную запись
Настроить параметры для действия «Клик». Порядок получения элемента указан в разделе Порядок получения элемента с помощью SapSpy
Нажать на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно.
Клик по ячейке таблицы / Click on a table cell¶
Задача: подключиться к открытой сессии SAP и произвести клик по ячейке таблицы.
Решение: воспользоваться действием «Подключиться к сессии», «Клик по ячейке таблицы».
Реализация:
Собрать схему робота, состоящую из действий:
Настроить параметры для действия «Подключиться к сессии».
В поле «Сессия» указывается порядковый номер открытой сессии одного пользователя (0 – первый подключённый пользователь, 1- второй и т.д.), к которой необходимо подключиться. Нумерация начинается с 0 и зависит от времени входа в учетную запись
Настроить параметры для действия «Клик по ячейке таблицы». Порядок получения элемента указан в разделе Порядок получения элемента с помощью SapSpy
Нажать на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно.
Произведен клик по требуемой ячейке.
Ожидать появление элемента / Wait for an element to appear¶
Задача: подключиться к открытой сессии SAP и ожидать появления элемента, а затем кликнуть по нему.
Решение: воспользоваться действием «Подключиться к сессии», «Ожидать появления элемента», «Клик»
Реализация:
Собрать схему робота, состоящую из действий:
Настроить параметры для действия «Подключиться к сессии».
В поле «Сессия» указывается порядковый номер открытой сессии одного пользователя (0 – первый подключённый пользователь, 1- второй и т.д.), к которой необходимо подключиться. Нумерация начинается с 0 и зависит от времени входа в учетную запись
Настроить параметры для действия «Ожидать появления элемента». Порядок получения элемента указан в разделе Порядок получения элемента с помощью SapSpy
Настроить параметры для действия «Клик». Порядок получения элемента указан в разделе Порядок получения элемента с помощью SapSpy
Нажать на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно.
Отправить горячие клавиши / Send hotkeys¶
Задача: подключиться к открытой сессии SAP, нажать клавишу Enter выбранном на элементе.
Решение: воспользоваться действием «Подключиться к сессии», «Отправить горячие клавиши».
Реализация:
Собрать схему робота, состоящую из действий:
Настроить параметры для действия «Подключиться к сессии».
В поле «Сессия» указывается порядковый номер открытой сессии одного пользователя (0 – первый подключённый пользователь, 1- второй и т.д.), к которой необходимо подключиться. Нумерация начинается с 0 и зависит от времени входа в учетную запись
Настроить параметры для действия «Отправить горячие клавиши». Порядок получения элемента указан в разделе Порядок получения элемента с помощью SapSpy
Нажать на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно.
При нажатии Enter на элементе открылось новое окно.
Очистить поле / Clear field¶
Задача: подключиться к открытой сессии SAP и очистить поле.
Решение: воспользоваться действием «Подключиться к сессии», «Очистить поле».
Реализация:
Собрать схему робота, состоящую из действий:
Настроить параметры для действия «Подключиться к сессии».
В поле «Сессия» указывается порядковый номер открытой сессии одного пользователя (0 – первый подключённый пользователь, 1- второй и т.д.), к которой необходимо подключиться. Нумерация начинается с 0 и зависит от времени входа в учетную запись
Настроить параметры для действия «Очистить поле». Порядок получения элемента указан в разделе Порядок получения элемента с помощью SapSpy
Нажать на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно.
Поле очищено.
Подключиться к сессии / Connect to a session¶
Задача: подключиться к авторизованной системе SAP.
Решение: воспользоваться действием «Подключиться к сессии».
Реализация:
Перенести действие на рабочую область и настроить его параметр.
В поле «Сессия» указывается порядковый номер открытой сессии одного пользователя (0 – первый подключённый пользователь, 1- второй и т.д.), к которой необходимо подключиться. Нумерация начинается с 0 и зависит от времени входа в учетную запись.
- Нажать на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно.
Произвелено подключение к сессии SAP.
Получить значение списка / Get list value¶
Задача: подключиться к открытой сессии SAP и получить значение списка.
Решение: воспользоваться действием «Подключиться к сессии», «Получить значение списка».
Реализация:
Собрать схему робота, состоящую из действий:
Настроить параметры для действия «Подключиться к сессии».
В поле «Сессия» указывается порядковый номер открытой сессии одного пользователя (0 – первый подключённый пользователь, 1- второй и т.д.), к которой необходимо подключиться. Нумерация начинается с 0 и зависит от времени входа в учетную запись
Настроить параметры для действия «Получить значение списка». Порядок получения элемента указан в разделе Порядок получения элемента с помощью SapSpy
Нажать на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно.
Получить координаты центра элемента / Get the coordinates of the center of an element¶
Задача: подключиться к открытой сессии SAP и получить координаты центра элемента.
Решение: воспользоваться действием «Подключиться к сессии», «Получить координаты центра элемента».
Реализация:
Собрать схему робота, состоящую из действий:
Настроить параметры для действия «Подключиться к сессии».
В поле «Сессия» указывается порядковый номер открытой сессии одного пользователя (0 – первый подключённый пользователь, 1- второй и т.д.), к которой необходимо подключиться. Нумерация начинается с 0 и зависит от времени входа в учетную запись
Настроить параметры для действия «Получить координаты центра элемента». Порядок получения элемента указан в разделе Порядок получения элемента с помощью SapSpy
Нажать на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно.
Получить текст / Get text¶
Задача: подключиться к открытой сессии SAP и получить текст кнопки.
Решение: воспользоваться действием «Подключиться к сессии», «Получить текст».
Реализация:
Собрать схему робота, состоящую из действий:
Настроить параметры для действия «Подключиться к сессии».
В поле «Сессия» указывается порядковый номер открытой сессии одного пользователя (0 – первый подключённый пользователь, 1- второй и т.д.), к которой необходимо подключиться. Нумерация начинается с 0 и зависит от времени входа в учетную запись
Настроить параметры для действия «Получить текст». Порядок получения элемента указан в разделе Порядок получения элемента с помощью SapSpy
Нажать на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно. Текст кнопки получен.
Получить элементы выпадающего списка / Get dropdown list items¶
Задача: подключиться к открытой сессии SAP и получить элементы выпадающего списка.
Решение: воспользоваться действием «Подключиться к сессии», «Получить элементы выпадающего списка».
Реализация:
Собрать схему робота, состоящую из действий:
Настроить параметры для действия «Подключиться к сессии».
В поле «Сессия» указывается порядковый номер открытой сессии одного пользователя (0 – первый подключённый пользователь, 1- второй и т.д.), к которой необходимо подключиться. Нумерация начинается с 0 и зависит от времени входа в учетную запись
Настроить параметры для действия «Получить элементы выпадающего списка». Порядок получения элемента указан в разделе Порядок получения элемента с помощью SapSpy
Нажать на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно. Элементы записаны в переменную типа «Коллекция» (3 элемента).
Получить ячейку таблицы / Get table cell¶
Задача: подключиться к открытой сессии SAP и получить название ячейки таблицы.
Решение: воспользоваться действием «Подключиться к сессии», «Получить ячейку таблицы».
Реализация:
Собрать схему робота, состоящую из действий:
Настроить параметры для действия «Подключиться к сессии».
В поле «Сессия» указывается порядковый номер открытой сессии одного пользователя (0 – первый подключённый пользователь, 1- второй и т.д.), к которой необходимо подключиться. Нумерация начинается с 0 и зависит от времени входа в учетную запись
Настроить параметры для действия «Получить ячейку таблицы». Порядок получения элемента указан в разделе Порядок получения элемента с помощью SapSpy
Результат:
Программный робот отработал успешно. Данные из ячейки таблицы получены.
Проверить существование элемента / Check for the existence of an element¶
Задача: подключиться к открытой сессии SAP и проверить существование элемента
Решение: воспользоваться действием «Подключиться к сессии», «Проверить существование элемента».
Реализация:
Собрать схему робота, состоящую из действий:
Настроить параметры для действия «Подключиться к сессии».
В поле «Сессия» указывается порядковый номер открытой сессии одного пользователя (0 – первый подключённый пользователь, 1- второй и т.д.), к которой необходимо подключиться. Нумерация начинается с 0 и зависит от времени входа в учетную запись
Настроить параметры для действия «Проверить существование элемента». Порядок получения элемента указан в разделе Порядок получения элемента с помощью SapSpy
Нажать на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно. Элемент найден.
Получить строку таблицы / Get table row¶
Особые условия использования
Робот вернет ошибку, если:
- указан элемент не табличного типа.
- элемент не найден.
- указан номер строки за пределами таблицы. (<1, >количества строк).
- SAP не отвечает.
Задача: необходимо получить первую строку из таблицы SAP.
Решение: воспользоваться действиями «Подключиться к сессии», «Получить строку таблицы».
Реализация:
Собрать схему робота состоящую из действий:
Настроить параметр действия «Подключиться к сессии».
Настроить параметры действия «Получить строку таблицы».
Запустить робота, нажав на кнопку «Старт» в верхней панели.
Результат:
Программный робот отработал успешно. Получена коллекция значений выбранной строки.