192 docs tagged with "Bot Task"

Bot Tasks contain work to be done by WorkFusion's bots. In a Business Process (BP), the bots complete those steps that are more suited for automation than human labor. Bot Tasks can exist only as a Business Process step.

The Data Store module is a web interface for managing database (DB) tables in the Work.AI platform. A field scheme defines the Data Store table structure and column data format.

The Application action group provides possibilities to manage and switch active windows which Bot is interacting with (clicking, typing, scrolling, and so on).

Each of our clients uses Work.AI Developer for different goals, but the common thing that unites all of them is writing scripts with the help of Recorder. There are several recommendations that can help you to make your script not only functional but also clear for understanding and flexible to support.

With the introduction of the BEP execution platform:

With the introduction of the BEP execution platform:

A Worker is a single instance of a Worker application process started by BEP to process BEP Worker tasks.

By default, you can use bot plugins included in the original WebHarvest framework. To learn more, refer to Standard WebHarvest processors. To create WebHarvest XML configs, you can also use the plugins implemented additionally in the Java language by the WorkFusion team.

For more details, refer to the JavaDoc documentation.

Selectors (or Locators) are used to find and match the elements of a web page or desktop app that a robot needs to interact with. Using the right selector ensures the bots are faster, more reliable or has lower maintenance over releases. If you’re fortunate enough to be working with unique IDs and Classes, then you’re usually all set. It can be a real challenge to verify that you have the right selectors to accomplish what you want.

Inversion of Control and Dependency Injection

Object selectors are used for automating desktop applications only.

In Bot Configs, you have access to both WebHarvest and WorkFusion context variables. The Manual Task context is described in the Manage templates topic.

The image is used to change focus to the sign-in popup window.

Type|Method|Description

Apply selection methods

The example below shows how to run commands on a remote RPA Agent machine. Pay attention to how you can execute Groovy code remotely.

Some web applications have functionality allowing to drag web elements from one location and drop them on a defined area or even another web element.

Most of sites are dynamic and change the page content by JS scripts while a user interacts with a page.

A table is a kind of HTML data displayed with the help of the ` tag in conjunction with the and ` tags. Although there are other tags for creating tables, these are the basics for creating a table in HTML:

The most popular desktop application to be automated with the help of Recorder is Microsoft Excel. There is a specific actions group in Actions Library to work with Excel files. Here you can find some recommendations on how to work with them in your own scripts.

Launch applet and insert and extract data

A typical application looks like the one on the screenshot below:

To click an item of the drop-down menu, use the hover() method:

Automate file download

As Outlook is one of the most popular email clients used by many companies nowadays, you will find here some recommendations on how to automate it with Recorder.

Overview

Automate Calculator

The Automation Engineer certification in Automation Academy helps trainees obtain a key professional developer role that ensures the successful delivery of a complex automation project.

Introduction

AutoML plugins provide the capability to interact with AutoML services from Bot Tasks.

For Tutorial source code, see Source code access.

The guide illustrates the implementation of a schemaless Business Process (BP) for website rating from a Bot Task using the Work.AI Developer and Control Tower capabilities.

The article explains different solution approaches to building code and focuses on simplified RPA API.

Overview

We have put together some examples of custom scripts that you can use in your recordings.

Goal

If-Else

Bot Sources in BEP execution mode

The custom bot step configuration user interface is used to simplify the specification of configuration parameters for bot steps. The feature enables the creation of complex forms using frameworks like FormIO or React and is supported for Java Native Workers (JNWs), Triggers, Bot Config Bundles (BCBs), and WebHarvest tasks.

Custom attributes are user-defined data fields that extend or customize task and process data. These attributes rely on Field Schemes to determine how data is stored and interpreted.

The article describes the legacy bot step configuration flow. For the recommended approach, refer to Configure bot steps in UI.

Using the no-code Generic Connector, you can apply multiple configuration options to handle different connection scenarios and create custom connectors for the integration of external services into your automations.

When you design a Business Process (BP), you can apply rules that affect what path to follow in the BP depending on various conditions. Thus, you can end your BP early if some issue is detected or the data is not enough.

There are some global parameters for Recorder to define component settings, their general behavior, and so on. The most widely used setup refers to the Recorder settings. Go to Window > Preferences > WorkFusion Recorder.

The ODF 2 provides the built-in ORM layer and comes with OrmLite as the default ORM framework used primarily to access Data Store data.

Example overview

Engine

The Craigslist Bot searches and returns the top results to a spreadsheet.

Problem statement

Before reading this topic, see the detailed Operation description.

Before getting into details, let's take a quick look at a simple Bot Task within the ODF 2 framework:

Explore adoption scenarios

To start exploring the ODF capabilities for creating automation projects, refer to the guides listed below.

Data Store plugins can be of two types:

ODF 2 doesn't add anything special to the existing ways of debugging Bot Tasks.

Remote Java debug for the WorkFusion platform v.10.2+ is available via communication between two instances of Developer of the same version:

After creating an ODF 2 project from the Simple Archetype, deploy it to a Control Tower instance.

The guide describes a project structure, covers different modules, and highlights essential project files.

General overview

The figure below illustrates the BEP Worker task distribution flow within BEP:

Introduction

Eclipse IDE is the development environment used to design Bot Configurations.

High-level description

The WorkFusion infrastructure requires periodic validation. There are various factors that can make certain WorkFusion components or target applications non-functional or non-automatable.

The Excel action group is intended for automating Excel spreadsheet manipulations, such as getting or setting cell values, switching between sheets, saving, and so on. These actions are NOT automatically recorded when you work in Excel during a recording process.

High-level description

The Exception Handling action is intended to ensure a safe execution of your automated workflow by providing the try-catch functionality. This action is a complex one and consists of two blocks:

Exclusive access concept

The feature allows executing GroovyScript on a Bot machine (Windows RPA Server), not in Control Tower. For more details, see the JavaDoc link.

JavaScript is the preferred language inside the browser to interact with an HTML document object model (DOM). It means that a Browser has a JavaScript implementation in it and understands the JavaScript commands. You can disable it using browser options in your browser. The web driver still uses JavaScript to perform some actions.

The Worker scaling strategy is a mechanism for calculating an optimal Worker quantity to satisfy, to the maximum possible extent, the multiple task execution requirements on a cluster with fixed limited resources (non-elastic cluster). The strategy is supposed to adapt when cluster resources are added or removed.

In the article, the standardized Data Store schema is understood as equivalent to the ODF 2 example project's Data Store schema. With few exceptions, it utilizes concepts from Transaction and Multi-process layers of the ODF 2 architecture. If you do not use the Multi-process layer, you can ignore some entities, and this won't impact the framework integrity. In extreme scenarios, when even the Transaction layer is not used, the Data Store schema should be designed from scratch.

The Work.AI platform brings together concepts, guides, and techniques to begin your development journey.

Data flow

The article dwells on the structure of a project created from the ODF 2 Simple Archetype. For more details on creating a new project, see Start Maven project.

What is Assembly?

Recorder is one of the main Work.AI Developer components that provides the ability for a Power User to automate web, desktop, and mainframe applications in a natural macro-like way without any coding or scripting.

The Files and Folders action group is intended for general manipulations with files and folders, for example, creating a folder under the path specified or a file with a specific content in a defined location, or copy/move a folder or a file to the location specified.

Eclipse IDE is a component of Work.AI Developer used to build automation solutions of any complexity.

IntelliJ IDEA IDE allows to execute WorkFusion Bot Task unit tests. Execution of unit tests does exactly the same as Bot Task execution. Additionally, the unit test approach allows accumulating unit tests for continuous integration practice.

As you probably know, if a Bot Task throws an exception, the platform stops the execution of the entire Business Process (BP). In most real-life scenarios, such behavior is unacceptable. Instead, you would usually react to the exception by retrying the attempt, asking a human operator to intervene, trying to proceed with other records, or using any combination of these strategies.

Handle IFrames with Robotics WebDriver

An alert is a pop-up window that comes up on the screen. There are many user actions that can result in alerts. For example, a user clicks a button that displays a message, and a web page asks for some extra information.

The topic is a brief introduction to XPath to present a quick overview of the main techniques you can use in your recordings to handle elements on a web page, for example, to click a link or an object, get or set value from/to fields or menus. The tutorial explains the basics of XPath with suitable examples.

ORMLite is a framework that provides lightweight Object Relational Mapping between Java classes and SQL databases. There are certainly more mature ORMs that provide this functionality, including **Hibernate** and **iBatis**. However, ORMLite is a simple yet powerful wrapper around the JDBC functions.

Sample PageObject implementation walkthrough

Previously, it took a long time to transfer a Business Process with all dependencies. It required multiple operations and manual steps, in-depth model knowledge, Nexus, and s3 credentials.

The article details how to import database and S3 data management configurations as part of an Asset Bundle.

Inspector is a tool to explore properties and values of objects in native Windows or multiple frameworks, Java, and SAP applications, which you automate with your recording, providing functionality for quick element selector search.

Download sample project

Example overview

The Keyboard action group is intended for entering text and typing key combinations using the keyboard. The Enter Keystrokes action is automatically recorded when you type something during the recording process.

Design concepts

There are two types of Java examples:

Web applications do not always confine themselves to working entirely on the web. Sometimes they need to interact with the desktop to do things like downloads and uploads. Automating these sorts of workflow is tricky in using WebDriver. WebDriver is confined to automating browsers, so desktop windows are out of scope.

Loops are used:

With the Low-Code Developer certification, trainees learn how to use the Work.AI platform to automate day-to-day operations.

The Answer Types tab allows creating and managing Answer Types in Control Tower. These Answer Types are used for the following actions:

Records and transactions

With ODF 2, we encourage you to use Data Stores as a universal and effective way to have different steps of Business Processes within your AI Agent exchange data. The section provides a reference on how to organize your Data Model through AI Agent automation.

Work.AI offers the approach allowing smooth and flexible incorporation of user-defined Java libraries into BEP Workers. The approach enables the isolation of BCB classes from the application ones. If BCB classes use a library packaged together with the BCB, the BCB class loader loads the library classes from the BCB even if the Worker app contains the library as well.

Templates allow you to reuse objects. Almost every object in the Work.AI platform, including Manual Tasks and Business Processes, is based on templates.

You don't need to migrate existing BPs from ODF to ODF2 if you haven't faced any ODF limitations impacting BP quality. The Product supports the execution of BPs created on both versions of ODF.

You can create a package with a Business Process (BP) or a task and import it from one WorkFusion environment to another, for example, from DEV to UAT or PROD. Let’s assume the source is a DEV environment and the destination is a UAT environment.

Model training

The Mouse action group is intended to interact with user interface using mouse.

High-level description

Cache concept

Overview

High-level description

The article dwells on the obsolete approach of OCR usage in the scope of the ODF 2 framework.

The ocr plugin works in the synchronous mode, and therefore, becomes a performance bottleneck if used within a BP where the OCR page volume is high, or documents contain more than 20 pages. The recommendation is to use the prepared BP artifacts where the OCR logic is asynchronous.

Major technical concerns of AI Agent delivery

Before you continue with ODF archetypes, see Software development life cycle in the Work.AI platform.

The Orchestration section guides you through the steps to deliver and orchestrate automations, including the involvement of a human worker in the loop. The figure below illustrates the actions available for the purpose via the Control Tower (CT) and WorkSpace (WS) user interfaces.

Code review benefits

Stateless execution definition

Plugin execution logging helps to record the execution time of specific plugins, thus enabling you to gather Bot Task processing analytics. Currently, the following plugin data is recorded:

There are some useful prepackaged task types not associated with any APIs. You can use them in the standard cross-process flow.

In ORMLite, the lazy loading of mapped collections is implemented in a non-standard way. Instead of loading the content once during the first access, it loads it every time the collection is accessed.

Developer approach to publishing

Introduction

Example overview

Example overview

The article describes the legacy bot step configuration flow. For the recommended approach, refer to Configure bot steps in UI.

General information

The ODF 2 example project is created to demonstrate key features of the framework. It contains four simple Business Processes that operate on a mock data model. While functional, these processes do not perform anything practically useful.

Robotics plugins make it possible to click through desktop or web applications using commands in WebHarvest scripts. The location for executing the script is configured on the RPA Windows server side.

Advantages of WorkFusion Bot Config Bundle approach

The guide covers different solution approaches to building code and focuses on simplified RPA API.

- Estimation

RPA development (using both code and code-less approaches) assumes mimicking with bot task of SME's interaction with multiple organization systems. During it bot typically drags sort of "transaction" from initial phase down to final phase in terms of use-case scope. Problem is that development requires valid data in initial phase each time developer tries to test his bot task. Now, imagine that 20 developers in team every day launch tests up to 100 times. Obviously, certain amount of valid test data must be re-generated and available every day during design, development, and UAT phases. These requires to establish solid Test Data Management even before any development begins.

The tutorial below helps to learn how to debug RPA (actually any Bot Task in your Maven project) in IDEA with the help of Work.AI Developer:

Spoke is a tool for end-to-end Business Process testing. It provides fluent APIs for a developer to achieve typical testing goals. The framework is built on the JUnit 5 + AssertJ ecosystem, but the core module does not depend on it and can be used as a pure Java library.

Spoke is a tool for end-to-end Business Process testing. It provides fluent APIs for a developer to achieve typical testing goals. The framework is built on the JUnit 5 + AssertJ ecosystem, but the core module does not depend on it and can be used as a pure Java library.

The article describes what WebElement is and which actions you can perform on various WebElements.

Download the Scheduler package.

The Script action allows to create any custom action using the following APIs:

ODF 2 provides SecretsVaultService to isolate operations with Secrets Vault.

Sequences are intended for combining several actions into one logical part of the whole automation workflow, such as Login to application, Creating Invoice, Working with Excel file, and so on, and provide the following benefits:

Occasionally, a Bot Task may get stuck due to a problem in logic, leading to Business Process execution issues. To enable detection of such situations, the following mechanisms were implemented:

The article describes examples and techniques on how to pass data between Business Process (BP) steps, both Manual and Bot ones.

To design RPA in Bot Tasks or test a Business Process on your local workstation, we require you to run Windows OS and install the Work.AI Developer environment as it provides RPA local execution, local Control Tower and all required components. However, IDEA works under Mac and Linux. In this case, you can skip installing Developer. But note that you won't have local Control Tower and WorkSpace and won't test RPA Bot Tasks on the local workstation.

To design RPA in Bot Tasks or test a Business Process on your local workstation, we require you to run Windows OS and install the Work.AI Developer environment as it provides RPA local execution, local Control Tower and all required components. However, Eclipse IDE works under Mac and Linux. In this case, you can skip installing Work.AI Developer. But note that you won't have local Control Tower and WorkSpace and won't test RPA Bot Tasks on the local workstation.

High-level description

Selenium keys enum

Software development life cycle (SDLC) is a process for planning, creating, testing, and deploying an information system. The instruction focuses on a recommended SDLC approach for the Work.AI automation solution implementation.

Recorder variables are used to store initial or runtime values that a bot can:

ODF 2 allows splitting a Transaction into multiple sub-transactions and joining them back. This is usually done to process some data from the original Transaction in parallel.

The information in the article relates to the low-code approach of creating AI Agents using Work.AI Developer.

Below, there is the description of standard WebHarvest processors together with their attributes, syntax, and code samples you can use to design Bot Tasks.

If you have several Business Processes (BP) where one BP produces data for another, you can apply the event-based communication mechanism and easily configure data transfer between them. To do it, you can start a sub-process from another BP based on a specific event or initiate transaction processing from another transaction within a different BP.

To start a Business Process (BP) based on external events or scheduled polling of a source system, you can apply a special no-code Trigger start element when designing your BP.

Why it is important

Window selectors

Example overview

Screenshot of browser: getScreenshotAs()

The Taxonomy Answer Type can be used for classification of products, businesses, and articles. In WorkFusion, you can use this answer type along with Data Stores.

The Text actions are intended to refine the texts acquired during other actions, for example, from web-elements, remove unnecessary blank spaces, check, if the text matches the defined content, and combine several texts together.

The new class-loading approach enables the isolation between BCB classes and application ones. If BCB classes use a library packaged together with the BCB, the BCB class loader loads the library classes from the BCB even if the Worker app contains the library as well. For ODF, a new Archetype is introduced with the -PF4J postfix in its name. Now, ODF provides two Archetypes: for the old class-loading approach and the new one.

High-level description

Example overview

The guide is intended for IT Operations Support Engineers who own the Work.AI platform environment. Those engineers are expected to have access permissions to configure servers for the Open Development Framework (ODF).

The instruction contains the best practices of the Apache HttpClient usage in the ODF 2 framework scope.

Download sample project

API

Download sample project

To facilitate the interaction with a Control Tower instance, a set of Maven plugins support the ODF 2 framework. The page describes working with these plugins.

WorkFusion uses Nexus Repository OSS to enable centralized artifacts management for each Work.AI environment. Nexus is the industry leader in repository management, providing:

The article is an example of the OCR Bridge step usage in the scope of the ODF 2 framework. The Bot Tasks used in the example are a part of Processing Business Process from the example project.

The Open Development Framework provides several prepackaged components that are ready for drag-n-drop usage.

How to handle Ajax call using WebDriver

XPath in JavaScript: introduction

Work with File Storage

Using Variables from Actions Library, you can assign the following values to recorder variables:

Problem context

Welcome to Examples Library

BEP Worker framework

The WorkFusion Work.AI automation enables usage of some standard Maven build technics.

The purpose of quickstart tutorial samples is to explain how the Control Tower business process data flow is connected to the ODF architecture.

Work.AI Developer (previously Intelligent Automation Cloud Developer or IA Cloud Developer) is a part of the Work.AI platform and provides a unique automation environment to evaluate, learn, design, create, and support automation projects.

Wait actions are intended for pausing bot execution for a defined period of time and for searching images on user screen. These actions are not recorded automatically. You need to drag them from Actions Library to Actions Flow while editing a recording.

A commonly encountered task in ODF 2 is waiting for the completion of all transactions in a given Business Process. There is no out-of-the-box solution that fits all use cases. For example, a Monitor Task often serves as the source of transactions, making it impossible to know when new ones appear. However, once all requirements are known, such a feature is quite easy to implement.

The Web action group is intended for automating browser actions, such as open website in browser, get value, and set value of a web element (text input, dropdown, and so on). These actions are NOT automatically recorded when you work in a browser during the recording process.

Example overview

The fleet mechanism is designed to send tasks for processing by a dedicated Worker pool, or fleet.

To illustrate how user Transactions are created and processed, let's simulate a simple scenario for a Business Process (BP) consisting of two Bot Tasks:

Bot Task JUnit is a JUnit 5 API for running and testing Bot Tasks. You can use it for running Tasks locally from an IDE of choice during development and/or for executing tests in a CI/CD pipeline.

Bot Task JUnit is a JUnit 5 API for running and testing Bot Tasks. You can use it for running Tasks locally from an IDE of choice during development and/or for executing tests in a CI/CD pipeline.

To develop Java unit tests, ODF provides JUnit 5 (Jupiter) and Mockito libraries.

High-level description