Запись проекта
Суть работы ZennoPoster заключается в выполнении проектов - набора команд, таких как переход на указанный URL, установка текста в поле login на web странице, сохранение в файл текста из переменной и т.д.
Создание проекта начинается в ProjectMaker, вкладка «Запись действий». После того, как Вы нажмете красную кнопку «Начать запись» все Ваши действия будут записываться. Сбоку, в панели «Проект», можно посмотреть какие действия уже записались, удалить лишние и т.д. В ZennoPoster MP запись действий можно производить двумя способами: классическим, как в предыдущей версии ZennoPoster, или с помощью IntelliSearch. Также есть возможность выполнять некоторые действия на web странице с помощью фичи «поиск по скриншоту» или эмулировать набор текста с клавиатуры и клики мыши.
IntelliSerch - это система поиска важных полей на web странице и их классификация. Мы рекомендуем пользоваться в основном им для записи проектов. IntelliSerch позволяет записывать проект очень быстро, просто нажимая кнопку «да», если IntelliSerch определил поле правильно или указывая правильный тип поля, если он ошибся. IntelliSerch более устойчив к изменениям на web странице чем классический поиск, но иногда не находит все поля, которые нужны. IntelliSerch помогает работать не только с полями, но и со ссылками. Более подробно читайте об этой системе в основной статье.
Классический рекордер действий просто записывает то, что Вы делаете на web странице - установка значений полям, клики по ссылкам и т.д. Мы рекомендуем пользоваться этим способом только в случае проблем с IntelliSerch. Ещё этот способ может пригодиться когда нужно написать проект для одного конкретного web ресурса, и этот проект должен быть экономным в плане ресурсов компьютера (актуально только для Pro версии ZennoPoster).
При классической записи проектов Вы можете воспользоваться конструктором действий. С помощью него можно более тонко настраивать поиск элементов web страницы, обрабатывать какие-то необычные случаи.
Также, во время записи, можно менять опции браузера (одноименная кнопка). Изменения опций браузера тоже запишутся в проект. Например, можно отключить картинки, флеш и т.д., тогда проект будет выполняться быстрее и расходовать при выполнении меньше ресурсов памяти, процессора и интернет трафика.
Записывать проект можно через прокси, установив их перед загрузкой страницы. Это может понадобиться, например, если Вы работаете с сайтом от какой-либо одной страны. Подробнее читайте в соответствующем разделе.
Если Вы создаёте парсер, то Вам потребуется использовать текст страницы, увидеть его можно, нажав одноименную кнопку меню. В открывшемся окне Вы можете выбрать тип текста, и перейти к составлению регулярного выражения для парсинга. Также нужно знать, что текстов web страницы бывает несколько:
Исходный текст - это изначальный текст, загруженный с сервера, Вы его видите в любом браузере, когда нажимаете кнопку «показать исходный текст страницы». Отличительная черта этого текста в том, что в нем не выполнены никакие JavaScript и не загружены фреймы.
DOM текст - это текст, который получился после выполнения всех JavaScript на странице, он соответствует полному дереву HTML документа, в нем выполнены все JavaScript и включены DOM тексты всех фреймов.
Текст страницы - это текст, который видит пользователь. Он содержит выполненные JavaScript и тексты фреймов.
Если Вы создаёте регистратор, то Вам потребуется заполнять поля различными данными (имя, логин, пол, возраст, город, и т.д.). Вам не нужно придумывать их самим или загружать из файлов ни при записи проекта, ни при выполнении. При использовании IntelliSerch эти данные устанавливаются автоматически из профиля. Профиль создан для удобства генерации данных человека, с правильным статистическим распределением имён и фамилий, а также с учётом географии. Используя классическую запись действий, просто выбирайте нужные варианты в меню как показано на скриншоте:
Также Вы столкнетесь с требованием распознать каптчу. Создать действие, отправляющее каптчу на сервис распознавания (или для ручного ввода), очень легко: IntelliSearch, скорее всего, сам найдет каптчу, Вам нужно будет только подтвердить его выбор и ввести значение каптчи в открывшемся окне (см. подробнее).
Если Вы пользуетесь классическим вводом - просто отметьте картинку как каптчу. Для этого выберите соответствующий пункт из контекстного меню, в проект запишется действие распознавания каптчи. Также откроется окно для ввода символов, которые Вы видите на каптче. После того, как отметите саму каптчу и введете символы, в этом меню появится ещё один пункт - поле для ввода текста каптчи, отметьте его тоже.
После завершения регистрации можно создать проверку, успешно ли она прошла. Для этого нужно найти на странице какой-либо текст, подтверждающий, что регистрация успешно пройдена (например, «Спасибо за регистрацию на нашем сервисе»). Выделите такой текст и нажмите правую кнопку мыши. В открывшемся меню выберите вариант «создать проверку наличия выделенного текста». В проект запишутся сразу два действия: первое берёт текст страницы, и ищет в нём выбранную фразу, второе сверяет найденный текст с пустой строкой. Исходя из результата проверки можно направить проект на те или иные действия. Например, в случае успешной регистрации, сохранить данные. Для сохранения данных используются переменные, читайте подробнее.
Очень часто при регистрации на каком-либо ресурсе требуется подтвердить регистрацию по e-mail. В ZennoPoster для этого существует специальная система подтверждения e-mail. Суть её заключается в том, что программа логинится на указанный сервер и ищет письмо, соответствующее текущей регистрации, если письмо найдено, то из него парсится текст (или несколько текстов). Подробнее можете прочитать в соответствующем разделе.
Отладка
Когда запишете необходимые действия на странице, нажмите кнопку «Стоп», Ваш проект будет скопирован в редактор, где Вы сможете внести коррективы - добавить или удалить действия, проверить выполнение.
Для проверки проекта существует встроенный отладчик, чтобы его запустить, нажмите в редакторе проектов кнопку «Запуск отладки». Откроется окно инстанса, и станут активными дополнительные кнопки рядом с кнопкой запуска отладки. Кнопкой «След. действие» Вы проходите по всем действиям Вашего проекта. При одном нажатии на кнопку происходит выполнение одного действия, тем самым Вы можете просмотреть детальное, пошаговое выполнение проекта и найти ошибки, если они есть. Текущее обрабатываемое действие выделено синей рамкой. Чтобы ввести каптчу вручную, нужно нажать кнопку «Ввод каптч вручную» и в открывшемся окне ввести каптчу. Во время отладки проект редактировать нельзя, но можно посмотреть результаты работы в логе, где записываются подробности по выполнению каждого действия. Также отображается список переменных с текущими значениями.
Кликните на экшен правой кнопкой и поставьте точку останова. После этого можно выполнить проект не пошагово, а пока выполнение придет в это действие.
Также Вам потребуется работать с файлами и текстом, для этого существует несколько действий. Для взятия и обработки текста в проекте удобнее всего использовать таблицы и списки, также возможно сохранение целого списка или таблицы в файл. Если нужно сохранить какие-то отдельные данные, содержащиеся в переменных, то можно использовать действия «Файлы» - записать в файл, из категории «Данные».
Не забывайте сохранять сам проект во время редактирования, иначе при форс-мажорных обстоятельствах можете потерять всю работу!