[2] How To Use akaBot Center

Version 277.1 by admin on 2022/11/01 10:20
Warning: For security reasons, the document is displayed in restricted mode as it is not the current version. There may be differences and errors due to this.

Introduction

The akaBot Center is a server-based application that lets you control and manage your Agents. It runs on a server and connects to all the Agents within the network and executes your repetitive workflow based on different requirements. It has a browser-based interface that enables the management of hundreds of Agents with just a few clicks.

The akaBot Center lets you manage the creation, monitoring, and deployment of resources in your environment, acting in the same way as an integration point with third-party applications.

This document aims to guide you on how to use the functionalities in the AkaBot Center.

Using akaBot Center

1. Center Overview

a. The User Interface

image-20220506152217-1.png

NoPanelDescription
1Feature menuShow all the main functionality of akaBot Center
2Main screenDisplay the details of each functionality
3Organization
Unit Selection
Menu
Change the active Organization Unit
4LanguageChange the display language of Akabot Center. Support English, Korean,
Japanese, Vietnamese and Taiwanese.
5User MenuAccess the following options and pages:
Settings: On this page, you can change the user details such as First Name, Last Name, Email and the display language.
Password: On this page, you can change the password that used to log in to Center.
Sign out: Click here to sign out.
6VersionShow the version of akaBot Center

b. akaBot Center – Navigation

In the Feature menu, you can see all the functionality that akaBot provided. 

image-20220506152226-2.png

NoTabDescription
1DashboardCharts and statistics for akaBot Center components
2Organization UnitOrganizational management and resource allocation
3Agent GroupGrouping of Agent for deployment purposes
4AgentSoftware agent that automates rule-based processes in the same
manner as humans do
5WorkflowRepresents the association between a package and an agent group.
Each time a package is linked to an agent group, it is automatically
distributed to all the Agent machines that belong to that Agent group.
6TaskExecution instances of processes assigned to Agent
7ScheduleTriggers for scheduled job execution
8Packages RepositoryBusiness process definition packages published by developers
9AssetShared variables or configurations that can be invoked in the design
processes by developers and used in your processes
10QueueWork queues are used to distribute work items to robot. Overview of
queues and transactions statuses, and SLA predictions
11LogExecution reports generated by Agent while executing automation
processes
12ReportActivity statistics of Agents and Workflow
13AdministrationUser Management
Role Management: Authorization based on access rights mapping
License: Activate, renew, remove, and allocate licenses and view historical licensing data.
Webhook: allow external systems to subscribe and listen to Akabot Center

c. Getting Started with akaBot Center

Before stating exploring all the main function of akaBot Center, please follow the instruction to install and Activate akaBot Center here

During the usage of akaBot Center, there are many instances where you need to input data to perform certain actions, such as Create/Edit or Filter for specific data. Below are different type of input data and method along with what they mean:

Type 
StringThis field accept text value
Int32This field only accept integers number. Int32 range is from - 2,147,483,648 to 2,147,483,647
BooleanThis field only accept 2 value: TRUE or FALSE
Date & TimeThis field only accept value reflected Date and Time. It could be manually input or select from a calendar.
Input searchingThis field allows user to search by inputting text value as well as select items from a list.
Drop down listA list in which the selected item is always visible, and the others are visible on demand by clicking a drop-down button.
Single ChoiceThis section have different choices but only users only allows to select one.
Multiple ChoiceThis section have different choices but users allows to select more than one options.

2. akaBot Operation Functions

a. Dashboard

image-20220506152237-3.png

akaBot's home page is a dashboard that enables you to see all the statistical charts of a single Organizational Unit containing useful information for all the following components:

  • Number of Agent (Available, Busy, Disconnected, Nonresponse)
  • Number of Task (Successful, Running, Stopped, Faulted)
  • Schedule (Calculated by Hour, Day, Week and Month basis)
  • Package (Active, Inactive)
  • Task Statistics (Daily, Weekly, Monthly, Yearly view available)
  • Upcoming Tasks
  • Recent Tasks

image-20220506152246-4.png

You can filter the data based on the Agent Group and Agent Name

NoColumn/LabelDescriptionTypeMaximumInput Requirement
1Select Agent GroupSelect the agent group of
which you want to see
statistics
Input searchingNo limit
(2,147,483,647 char)
 
2Select AgentSelect the agent of which you
want to see statistics
Input searchingNo limit 

You can also view the Task Statistics by selecting the corresponding tab: Daily, Weekly, Monthly, Yearly.

image-20220506152256-5.png

NoColumn /LabelDescriptionTypeMaximumIs Mandatory ?Input Requirement
 Daily /
Weekly /
Monthly /
Yearly
Select the type you want
to see task statistics
Tab Yes 
 Choose DaySelect the day you want
to see task statistics
Date & Time YesOnly available if you chose daily
 Choose WeekSelect the week you want
to see task statistics
Date & Time YesOnly available if you chose daily
 Choose MonthSelect the month you want to see task statisticsDate & Time YesOnly available if you chose daily
 Choose YearSelect the year you want
to see task statistics
Date & Time YesOnly available if you chose daily

b. Organization Unit

Organization Units (OU) provide the separation of Orchestrator components into tenants for designated users. The user's perspective of akaBot Center is determined by the organization unit in which they are placed, as well as the role(s) appointed to them. The following categories of entities make up an organization unit: 

  • Agent group
  • Agents
  • Workflows
  • Tasks
  • Schedules
  • Packages Repository
  • Assets
  • Queue
  • Logs
  • Report
    ! Statistics are produced for each organizational unit and shown on the Dashboard.

Notes:
A user with no assigned Organization Unit does not have access to any type of resources.
The same agent cannot be provisioned on two different Organization Units. Resources cannot be moved from one organization unit to another.
A drop-down list displays all of the units assigned to a user located at the header of the page, available at all times. User can also use this to switch between OU.

image-20220506152307-6.png

To access the OU page, click on the OU tab in the left menu. All previously created OU shall be in display there as below:

image-20220506152317-7.png

As an Admin, you may view the details of specific OU, create, update, or remove or filter the OU, as well as manage the users that are allocated to them.

  • View an OU

In order to view all the details of an OU, you can click on the name of the OU in the listing.

image-20220506152328-8.png

Once clicking, you will be redirected to the Details page.

image-20220506152337-9.png

NoColumn/LabelDescription
 NameThe name of the OU
 *DescriptionThe description of the OU
 UserThe list of all the Users assigned in this OU. This list included:
Username
Email
* Assigned roles
  • Filter OU

The filter option allows you to look for your OU a lot quicker. Click on the Filter option, available next to the Create new button.

image-20220506152346-10.png

Filter pop-up appeared. You can filter the OU by Name or Description

image-20220506152400-11.png

NoColumn /LabelDescriptionTypeMaximumInput Requirement
1NameEnter the name of the OU you want to searchString255 char 
2DescriptionEnter the description of the OU you want to searchString1000 char 
  • Create/edit an OU

To create a new organization unit, you click "Create New” button.

image-20220506152412-12.png

If you want to edit an OU, select the edit option from Action next to the corresponding OU Name.

image-20220506152423-13.png

After clicking, the system shows a pop-up form for you to fill the information:

image-20220506152433-14.png

NoColumn /LabelDescriptionTypeMaximumIs Mandatory ?Input Requirement
1NameEnter the custom name
of the OU you want to create/edit
String255 charYes 
2DescriptionEnter the description of
the OU you want to create/edit
String1000 charNo 
3UserSelect user you want to
add into the OU that you are creating/editing
Input searchingNo limitYesYou can add many users, but you can only add one by one

If you want to unassign a user from an organization unit, open the Edit windows and hit the bin icon in the action field. Once all the information is filled/edited, hit Save. Your OU is created

  • Remove an OU

Important!  Delete an Organization Unit will delete all resources within the unit. To remove an OU, click the corresponding Delete button next to the Organization Unit name on the Organization Unit page.

image-20220506152443-15.png

A confirmation pop-up will appear. Select Delete to finish the operation.

image-20220506152452-16.png

c. Agent Group

An Agent Group is a grouping of agents that is used to deploy processes. The Agent Group page displays all previously created groups and enables you to manage Agents within them. The Agent Group page allows you to search and filter agent groups by name and description. 

You can go to Agent Group page by clicking the Agent Group tab on the left of the interface. You will see a list of Agent groups created within the particular OU.

image-20220506152503-17.png

NoColumn/LabelDescription
1ActionAvailable actions to manage the Agent Group. Included:
Edit : allows you to edit the details of each Agent Group
Delete: allows you to delete selected Agent Group
By selecting the Checkbox corresponding to each Agent, the delete option will appear beside the Filter option and allow you to delete the
Agent from Center

! Selecting the Checkbox next to Action will select all Agent Group in display and allow you to bulk delete selected them
2NameThe name of the Agent Group. You can click the name of the Agent Group the view its details
3DescriptionThe description of the Agent Group
4Created byYou can see the username that created the Agent Group

To view the details of the Agent Group, click on the name

image-20220506152512-18.png

You will be greeted with the Details of the Agent Group:

image-20220506152521-19.png

NoColumn/LabelDescription
1NameThe name of the Agent Group. You can click the name of the Agent Group the view its details
2DescriptionThe description of the Agent Group
3Created byYou can see the username that created the Agent Group
4AgentThis section will list all Agents that are assigned to this Agent Group.
Here, you can view details of each agent, including its version, status, machine name, machine username, type, description and the user who created it.
  • Create/Edit an Agent Group

To create a new agent group, you should click “Create New” button on the top right corner of the screen.

image-20220506152531-20.png

When you want to edit the Agent Group information, click the Edit button in the Action column.

image-20220506152540-21.png

When you click on Create New/Edit button, the system will show a form for you to fill in. Details are in the table below.

image-20220506152549-22.png

NoColumn /LabelDescriptionTypeMaximumIs Mandatory?Input Requirement
1NameEnter the name of the
agent group you want to create/edit
String100 charYes 
2DescriptionEnter the description of
the agent group you want to create/edit
String255 charNo 
3AgentSelect the agent you want
to add to the agent group
that you are
creating/editing.
You can click the bin icon
next to the Agent to
remove it if needed.
Input searchingNo limitYesYou can add many agents into agent group, but you can only add one by one

Once all information is filled, hit Save.

  • Filter Agent group

When you click on Filter button, the system will show a form for you to fill in. Details are in the table below.

image-20220506152559-23.png

NoColumn /LabelDescriptionTypeMaximumInput Requirement
1NameEnter the name of the agent group that you want to searchString100 char 
2DescriptionEnter the description of the agent group that you want to searchString255 char 

Hit OK and the filtered result will be displayed.

  • Remove Agent Group

To delete an agent group, you should click the Delete button of the agent group you want to remove from the Agent Group list.

image-20220506152609-24.png

Alternatively, you can hit the checkbox before each Agent and the Delete option will appear next to the Filter option at the top. Click the Checkbox next to Action will allow you to select all Agents for deletion.

image-20220506152619-25.png

After clicking, if the agent group has no Agent attached to, the system will allow you to delete and need your confirmation before deleting.

image-20220506152626-26.png

Otherwise, an error message will be shown up to let you know it’s forbidden to delete the selected agent group.

d. Agent

An Agent is an execution host that runs processes that are built in akaBot Studio.

The Agents page allows you to add Agents, edit them, and examine their status as well as the change runtime settings and the Agent Group to which they are assigned.

Note: When the status of an Agent is busy (executing a process), you cannot edit the Username, Machine, or Type. To access the Agent page, click “Agent” tab in the left menu. After clicking, the system shows the Agent page listing all existed Agents as below.

image-20220506152636-27.png

NoColumn/LabelDescription
1ActionAvailable actions to manage the Agent. Includes:
Edit: allows you to edit the details of each Agent
Delete: allows you to remove selected Agent from the Center
By selecting the Checkbox on each Agent, the delete option will appear beside the Filter option and allow you to delete the Agent from the Center
! Selecting the Checkbox next to Action will select all Agents in display and allow you to bulk delete selected them.
2NameThe name of the Agent. You can click the name of the Agent the view its details.
 VersionThe installed version of the akaBot Agent tool in the local machine
 StatusThe current status of the Agent.
AVAILABLE - the Agent is connected to the Center, not running any
process and is free to be used
BUSY - the Agent is running a process.
DISCONNECTED- the Agent and Center have not communicated in
the last 10 seconds.
 Agent GroupThe Agent Group to which the Agent belongs.
 Machine nameThe name of the machine the Agent is registered on.
 Machine UsernameThe username used to log in to the Agent machine
 TypeThe type of Agent. This can be only Development, Assistant, Staging, or Production. It is possible to filter the page according to the Agent type.
 DescriptionDescription of the Agent
 Created byThe user who created the Agent
  • View an Agent

You can view the details of the Agent by clicking the name of the Agent. Details can be viewed below:

image-20220506152645-28.png

NoColumn/LabelDescription
1Agent GroupThe Agent Group to which the Agent belongs.
2NameThe name of the Agent. You can click the name of the Agent the view its details.
3Machine nameThe name of the machine the Agent is registered on.
4Machine UsernameThe username used to log in to the Agent machine
5TypeThe type of Agent. This can be only Development, Assistant, Staging, Production. It is possible to filter the page according to the Agent type.
6StatusThe current status of the Agent.
AVAILABLE - the Agent is connected to Center, not running any process
and is free to be used
BUSY - the Agent is running a process.
DISCONNECTED - the Agent and Center have not communicated in the
last 10 seconds.
7DescriptionDescription of the Agent
8VersionThe installed version of the akaBot Agent tool in the local machine
9Created byThe user which created the Agent.

Besides details regarding the Agent, all the tasks, logs, and connection verification status of the Agent can also be found here.

  • View an Agent’s tasks

At the bottom of the Details page, you can see a list of all the tasks that are executed by this specific Agent

image-20220506152653-29.png

Details regarding Tasks shall be explained in the Task sections.
Here, you can filter the Task list by Start Time, Package Name, State, and Source of the tasks. Once you filled in the criteria, hit OK to view your result. Hit Clear to start over or Cancel to terminate the action.

image-20220506152701-30.png

  • View an Agent’s log

To view the Agent’s logs from the Agent Details page, click the Log tab next to the Task tab to switch the view.

image-20220506152710-31.png

You can also filter the log item by the Date of Executed, the Task ID, the Workflow Name, the Log Level, or filter string. Once you filled in the criteria, hit OK to view your result. Hit Clear to start over or Cancel to terminate the action.

image-20220506152718-32.png

You can also Export Log for further investigation by clicking the Export Log option next to the Filter button. You can export all Logs or specific filtered Log Items.

image-20220506152728-33.png

  • Verify the Agent Connection

To make sure the Center and Agent are correctly connected with a valid username and password, you can click on the Verify button next to the Edit button.

image-20220506152735-34.png

If the user clicks this button when the Agent is connected, an ID/Password authentication check will be performed to determine if the ID/Password is correct and can be logged in.

There are three possible verification task states:

  • PENDING: the verification task was created and waiting for verification from the agent
  • SUCCESSFUL: the agent was verified and the username password was correct
  • FAULTED: the agent was verified and the username password was incorrect

Verification tasks and verify button will be updated in real-time. When there is a pending verification task on the verification tab, verify button will be disabled.
When the user clicks on verify button, the verification tab will be opened automatically and there is also a "Verifying..." notification shown in the top right corner.

To view all the Verification requests created, go to the Agent tab > Select the Agent.

image-20220506152746-35.png

On the Agent Detail page > Select Verification tab.

image-20220506152755-36.png

  • Create/Update an Agent

The first step of connecting an Agent to the Center is to create an Agent in the Center.

Notes: You are unable to edit an Agent with status = BUSY (executing a task). To create a new Agent, you should click the “Create New” button on the top right corner of the screen

image-20220506152807-37.png

To edit an Agent, you should click the Edit button of one Agent in the list. Alternatively, you can click the Edit button on the Detail Page of the Agent.

image-20220506152817-38.png

After clicking, the system shows a popup allowing you to fill properties to create/edit a new Agent. You need to fill in all the necessary info in the form below.

image-20220506152825-39.png

Agent tab

NoColumn /LabelDescriptionTypeMaximumIs Mandatory?Input Requirement
1KeyThis is the identification of one agent. You will input this key into the Agent Key field in your local Agent.String50 charYesThis field is
auto-generated by the system
2NameEnter the name of the agent you want to create/editString50 charYes 
3Machine NameEnter the name of the computer on which the Agent is deployedString50 charYes 
4Machine UsernameEnter the username used to log in to the computer which is mentioned aboveString50 charNo 
5Machine PasswordEnter the password used to log in to the computer which is
mentioned above
String255 charNo 
6TypeSelect the type of the agent you want to create/edit. There are 4 different types you can
choose: DEVELOPMENT,
ASSISTANTSTAGING
and PRODUCTION.
Dropdown list, SingleChoice Yes 
7DescriptionEnter the description of
the agent you want to create/edit
String500 charNo 

Agent Settings Tab

NoColumn /LabelDescriptionTypeMaximumIs Mandatory?Input Requirement
1Console / RDPakaBot executes workflow in an interactive Windows session. There are two types of Windows sessions the Robot can start:
Console Session
RDP Session
SingleChoice Yes 
2Login To ConsoleThis option allows the Agent connects to a
Console session Only
available if you chose
RDP
Checkbox No 
3Font SmoothingThis option enhances text recognition. Only available if you chose RDPCheckboxNo limitOptional 
4Resolution Width / Height / DepthThis option allows users to set a custom resolution if the
automation process is required. Only available if you
chose rdp
Int32
(Number)
 OptionalGreater than 0
5OthersOther specific parameter for this AgentStringNo limitOptional 

After filling the form, you click the Save button to record the Agent to the system.
Follow the instruction to connect the Agent to the Center using the Agent Key to complete the connection.

  • Filter for Agent

To filter for the Agents you need, click on the Filter option on the top of the page:

image-20220506152838-40.png

When you click on Filter button, the system will show a form for you to fill in. Details in the table below.

image-20220506152847-41.png

NoColumn /LabelDescriptionTypeMaximumInput Requirement
1NameEnter the name of the agent that you want to searchStringNo limit 
2Machine NameEnter the name of the machine on which the agent that you want to search is deployedStringNo limit 
3Agent GroupEnter the name of the agent group that the agent you want to search belongs toString  
 StatusSelect the status of the agent you want to search. Status included:
AVAILABLE
BUSY
DISCONNECTED
UNRESPONSIVE
SingleChoice  
 TypeSelect the type of the agent you want to searchDropdown
list, SingleChoice
  
 DescriptionEnter the description of the agent you want to search   

Once all the criteria are filled, hit the OK button to view your results.

  • Delete an Agent

To delete, you need to click the Delete button of one Agent in the Agent list.

image-20220506152905-42.png

Alternatively, you can select the checkbox before each Agent and the Delete button will show up next to the Filter button. Tick the Checkbox next to Action will allow users to select all displayed Agent for bulk delete.

image-20220506152913-43.png

After clicking, if the Agent is not in use, the system will allow you to delete and need your confirmation before deleting. If you want to delete Agent information in Agent Group, Tasks, Schedule, Queue, and Logs, select Delete related items? option

image-20220506152924-44.png

e. Workflow

Workflow represents the association between a Package and an Agent Group. Each time a package is linked to an Agent Group, it is automatically distributed to all the Agent machines that belong to that Agent Group.

The Workflows page enables you to deploy an uploaded package to Agent Groups, manage previously created associations and keep all your workflows up to date. This helps you distribute packages on the Agent machines and execute works faster from the Tasks page. To access the Workflows page, you click the Workflow tab at the left menu. After clicking, the system shows the Workflow page listing all existed Workflow as below:

image-20220506152938-45.png

NoColumn/LabelDescription
1ActionAvailable actions to manage the Log of said Workflow. Includes:
* VIEW: allows you to be redirected to the Task Detail page.
* EDIT: allows you to edit the details of each Workflow
* DELETE: allows you to remove selected Workflow from Center
By selecting the Checkbox corresponding to each Workflow, the delete option will appear beside the Filter option and allow you to delete the
Workflow
! Selecting the Checkbox next to Action will select all Workflow in display and allow you to bulk delete selected them
2Workflow NameThe name of the Workflow. For organization purposes, it is best to create Workflow Name with the format: Package Name_Agent Group Name.
3Package NameThe name of the Package that was published to akaBot Center
4Package VersionThe version of the package that was published to akaBot Center. The package version will be decided when you choose the publish option in akaBot Studio.
5Agent GroupAgent Group which the workflows will be deployed in
6DescriptionThe current version of Package’s published description
7Created byThe user who creates this Workflow.
  • View a Workflow

To view a workflow, you can click on the Workflow Name of the selected workflow in the workflow list.

image-20220506152952-46.png

The system shows the details of workflow as below:

image-20220506153002-47.png

Besides all the general information displayed on the Workflow Listing page, the Workflow Details page also included Parameters and Machine Environment information generated when creating/editing the Workflow.

Furthermore, you can see the update history as well as a list of Tasks executed by said Workflow. Details regarding Tasks shall be explained in the Tasks section.

Here, you can filter the Task list by Start Time, Agent, State, Source, and Schedule of the tasks. Once you filled in the criteria, hit OK to view your result. Hit Clear to start over or Cancel to terminate the action.

image-20220506153020-48.png

Users can also delete executed instances of this Workflow by selecting the Checkbox at the beginning of each Task. The Delete button will show up next to the Filter button.

image-20220506153032-49.png

Tick the Checkbox next to Action will allow the user to select all displayed Agent for bulk delete.

  • Filter Workflow

When you click on the Filter button, the system will show a form for you to fill in. Details are in the table below.

image-20220506153049-50.png

NoColumn /LabelDescriptionTypeMaximumInput Requirement
1Workflow NameEnter the name of the workflow you want to searchStringNo limit 
2Agent GroupSelect the agent group that the workflow you want to search is attached toInput
searching
No limit 
3DescriptionEnter the description of the workflow you want to searchStringNo limit 

Once all the criteria are filled, hit OK button to view your results.

  • Create/Edit a workflow

To create a workflow, you click the “Create New” button at the top of the page.

image-20220506153103-51.png

To edit a workflow, you click the Edit button of the selected workflow in the workflow list.

image-20220506153111-52.png

Alternatively, users can click the Workflow Name to go to Details Page and select the Edit button there.

image-20220506153135-54.png

After clicking, the system shows a form allowing you to create or edit the info of the workflow.

image-20220506153144-55.png

NoColumn /LabelDescriptionTypeMaximumIs Mandatory?Input Requirement
1Package NameSelect the package you want for the workflow you are creatingInput
searching
No limitYes 
2Package VersionDepends on the package that you chose above
Select the version of the package you chose
Dropdown
list
 Yes 
3Agent GroupDepends on the package version that you chose
Select the agent group that you want to attach the workflow that you are creating to
Input
searching
No limitYes 
4DescriptionEnter the description of the workflow you are creating/editingString255 charNo 

Once filled in all the General information, you can add further Parameters and Machine Environment variables to the Workflow. You can add multiple variables, but you can only add one by one.

image-20220506153154-56.png

NoColumn /LabelDescriptionTypeMaximumIs Mandatory ?Input Requirement
 Parameter
Name
Enter the name of the
parameter
String255 charYes 
 TypeSelect the type of the
parameter
Drop down
list
 Yes 
 ValueDepends on the type that
you chose
Enter/select the value of
the parameter
    
  If you chose stringString500 charYes 
  If you chose boolBoolean,
SingleChoice
 Yes 
  If you chose integerInt32500 charYes 

image-20220506153204-57.png

NoColumn /LabelDescriptionTypeMaximumIs Mandatory?Input Requirement
1Variable NameEnter the name of the variableString255 charYes 
2TypeSelect the type of the variableDropdown list Yes 
3ValueDepends on type that you
chose Enter/select the value of the variable
  Yes 
  If you chose stringString500 charYes 
  If you chose boolBoolean, SingleChoice Yes 
  If you chose integerInt32500 charYes 

For added variables, you can edit by selecting the pen icon in the Action column or delete them by selecting the bin icon

  • Delete a workflow

To delete, you need to click the Delete button of one workflow on the Workflow listing page.

image-20220506153215-58.png

Alternatively, you can select the checkbox before each Workflow and the Delete button will show up next to the Filter button. Tick the Checkbox next to Action will allow the user to select all displayed Agent for bulk delete.

image-20220506153225-59.png

After clicking, a system will show a confirmation message for you to confirm.

image-20220506153233-60.png

f. Tasks

A task is an execution instance of a process on one or multiple Agents. After creating a workflow (deploying a package to an agent group), the next step is to execute it with the assigned Agents. This can be done manually from the Tasks page or in a preplanned manner, from the Schedules page.

The Tasks page displays by default all the tasks that are running, and the ones placed in a pending state, regardless of whether they were started manually or through a schedule. On this page, you can also manually Create or Edit a task, Start or Stop a task, and display the logs generated by it with just a click of the button. More details can be shown in the Task Details window, to help you with troubleshooting faulted tasks. To access the Task page, you click the Task tab in the left menu. After clicking, the system shows the Task page listing all existed tasks as below:

image-20220506153242-61.png

NoColumnDescription
1Actions/ViewDepending on the status of the task, the system will allow you to perform
some actions to manage the tasks:
VIEW: to view the properties of a task and task log.
STOP: Stop a running task.
DELETE: Remove the task
CLONE: Create an identical task from the existing task
By selecting the Checkbox corresponding to each Task, the delete option will appear beside the Filter option and allow you to delete the Task from the Center.
! Selecting the Checkbox next to Action will select all Tasks in display and allow you to bulk delete selected them
2WorkflowThe name of the workflow which will be used to run the task
3VersionThe version of the Package that was published to akaBot Center.
4AgentThe Agent who the task will be executed.
5Agent GroupGrouping of Agent for deployment purposes where the Agent is located.
6StateCurrent status of the tasks. Available statuses are:
FAULTED: the tasks have encountered an error and have been stopped abruptly.
RUNNING: the task is running. You can stop or kill the task.
PENDING: the task has not been run. You can start to run it.
STOPPED: the task has been stopped.
* SUCCESSFUL: the task has been completed successfully. You can see the log to see the result.

Terminating: the task has been aborted and terminated.
7Start TimeIf a task has been started, the system will show up the start time for you to see.
8End TimeIf a task has been started and ended, the system will show up the end time for you to see.
9SourceTo indicate the source of the tasks.
Manual - the task has been created and configured from the Tasks/Schedule
pages, using the Create New/Clone button.
Agent - the task has been started in attended mode from the akaBot Agent.
Schedule –The task was initiated as a result of a trigger, which is utilized for
preplanned task execution.
10CommandThere are 4 commands user can send:
PENDING: When the task is scheduled to run but not yet run.
START: when the task is being initiated.
STOP: When the task is being stopped.
NONE: When the tasks have finished running
11ScheduleThe name of the Schedule which the task is being scheduled from. If the task is created manually, the Schedule field is empty.
12Task IDUnique ID of the execution instance of the mentioned workflow.
  • View a task

There are a few ways to view the details of the task:
From the Task page: This allows you to view all the created tasks. Click the View button on the left, next to the Task name.

image-20220506153305-63.png

From the Workflow Details page: This allows you to view all the created tasks of a specific Workflow. Click the Workflow tab > Select the Workflow > Select the Task tab and select the task item.

image-20220506153313-64.png

From the Agent Details page: This allows you to view all the created tasks of a specific Agent. Click the Agent tab > Select the Agent > Select the Task tab at the bottom and select the task item.

image-20220506153325-65.png

From the Schedule Detail page: This allows you to view all the created tasks of a specific Schedule. Click the Schedule tab > Select the Schedule > Select the Task tab at the bottom and select the task item.

image-20220506153341-66.png

Once clicking, you will be redirected to the Detail page. Details can be viewed below:

image-20220506153349-67.png

Besides the General information which can also be found on the Listing page, the Task Details page also included special Parameters and Log Details of each task.

image-20220506153359-68.png

NoColumnDescription
1ActionAvailable actions to manage the Log of said Task. Included:
View: allows you to be redirected to the Log Detail page.
Delete: by selecting the Checkbox on each Log Item, the delete option will appear beside the Filter option and allow you to delete the Log Item.
! Selecting the Checkbox next to Action will select all Logs in display and allow you to bulk delete selected log items.
 TimestampThe exact time the action was executed at
 LevelThe severity level at which the message was logged. The following options are available: OFF, FATAL, ERROR WARNING, INFORMATION, DEBUG AND VERBOSE.
 MessageThe logged message. This can also be a message logged through the Log Message activity in Studio.

Furthermore, users can also filter the logs of this task using the Log Level and Message of the log.

image-20220506153407-69.png

  • Filter a task

akaBot Center allows you to filter the task list by Date, Agent Group, Package Name, Agent Name, Source, State, and the Schedule of Tasks. Click the “Filter” button on the top right corner of the screen, and the filter wizard will dropdown.

image-20220506153417-70.png

NoColumn /LabelDescriptionTypeMaximumInput Requirement
1Start TimeSelect the start time of the task you want to searchDate & Time  
2Agent GroupSelect the agent group that is attached to the workflow of the task you want to searchInput searchingNo limit 
3Package NameSelect the package that is attached to the workflow of the task you want to searchInput searchingNo limit 
4AgentSelect the agent which is assigned to run the task you want to searchInput searchingNo limit 
5StateSelect the state of the task you want to searchInput searchingNo limit 
6SourceSelect the source of the task you want to search
If the task you want to search is created manually, choose manual
If the task you want to search is scheduled, choose scheduled
Input searchingNo limit 
7SchedulesSelect the schedules of the task you want to searchInput searchingNo limit 

Then, select the criteria to filter your tasks list and hit OK.

  • Create/Edit a task

There are three ways tasks can be created:

- When you create a Schedule on the Schedule page or executed an Agent locally, tasks will be created automatically.

- You can also manually create a task on the Tasks page.

- Clone an existing task.

To manually create a task:
Click Create New button on the top right of the page. The System will display the form for you to create the task.

image-20220506153429-71.pngimage-20220506153438-72.png

NoColumn/LabelColumn/LabelTypeMaximumIs Mandatory?Input Requirement
 WorkflowSelect the workflow for the task you want to createInput
searching
No limitYes 
 SearchEnter the name of the agent you want to searchStringNo limitNo 
 AgentDepends on the workflow that you chose, select agents you want to run the task you are creating.CheckBox,
MultipleChoice
No limitYes 
 ParametersOther parameters  No 

Alternatively, you can click the Action button and select Clone option to create an identical task. This feature allows you to rapidly perform a task from the tasks list without having to go through the whole configuration process.

This process assumes you previously initiated a task that has already attained a final state. First, select Clone after clicking the corresponding Action button at the beginning of each task.

image-20220506153448-73.png

Once you click the option, the CLONE A TASK window appears, with the task's default parameters.

image-20220506153456-74.png

Feel free to make the necessary modifications and then Save your work by clicking the Save button. The CLONE A TASK window closes, and the execution begins.

Notes: After creating or cloning, the task is automatically deployed to the Agent and runs immediately. On the Tasks page, the status of each task is presented in real-time.

  • Stop a task

To stop a running task, click on the Action button on the left of each task, then select Stop. The automation process is forcefully stopped immediately; the task is marked as Stopped.

  • Delete a task

To delete a task, you click the Delete button of one task in the list.

image-20220506153507-75.png

Alternatively, you can select the checkbox before each Task and the Delete button will show up next to the Filter button. Tick the Checkbox next to Action will allow users to select all displayed Tasks for bulk delete.

image-20220506153520-76.png

The System will show a message to get your confirmation. Hit Confirm to remove the task.

image-20220506153530-77.png

Notes: If you delete a Running task, the Task will still be executed in Agent. To Stop a Task from being executed, select the Stop option.

g. Schedule

Scheduling allows us to perform tasks in a preplanned way. You can execute tasks by commanding Agents to perform different schedules and times according to your needs. The Schedule page enables us to create new schedules. It also displays all previously created schedules, which can be further edited, enabled, or disabled. To access the Schedule page, click the Schedule tab in the left menu. After clicking, the system opens the Schedule Listing page that included all schedules we have created previously.

image-20220506153539-78.png

NoColumnDescription
1ActionOptions off all actions that can be performed on the schedule. This includes:
Start now: Start the Robot immediately
Disabled: Disable the current schedule
* Delete: Delete the schedule.
By selecting the Checkbox corresponding to each Schedule, the delete option will appear beside the Filter option and allow you to delete the
Schedule.

! Selecting the Checkbox next to Action will select all Schedule in display and
allow you to bulk delete them.
 NameThe name of the schedule.
 Agent GroupGrouping of Agent for deployment purposes.
 WorkflowThe workflow that is going to be scheduled to execute.
 VersionThe version of the Package Repository that is published to akaBot Center shall be executed by the Schedule. For more details, visit the Package
Repository section.
 StatusStatus of the schedule. There are 3 common statuses:
SCHEDULED – When the schedule is set up but not yet executed.
DISABLED – When the schedule is being disabled
* COMPLETED – When the schedule has been executed successfully
 Start timeThe first time the schedule is executed.
 End timeThe final run time of the schedule.
 Next run timeThe next run time of the schedule.
 Last run timeThe last run time of the schedule.
 Trigger DetailsThe details of the recurrent time which the schedule will execute.
 Created byThe user who created the schedule.
  • View a schedule

image-20220506153550-79.png

Besides the General information above, the Details page also shows the Parameters of said Schedule. From here, you can also see a list of Agents and Tasks associated with this Schedule. Details about Agents and Tasks shall be explained in their respective sections.

  • Filter Schedule

To filter for the Schedule you need, click on the Filter option at the top of the page:

image-20220506153602-80.png

NoColumn /LabelDescriptionTypeMaximumInput Requirement
1NameEnter the name of the schedule you want to searchStringNo limit 
2Agent GroupSelect the agent group that is attached to the schedule you want to searchInput searchingNo limit 
3Package NameSelect the package that is attached to the schedule you want to searchInput searchingNo limit 
4StatusSelect the status of the schedule you want to searchDropdown list,
SingleChoice
  
5AgentSelect the agent that is assigned to run the schedule you want to searchInput searchingNo limit 
6TriggerSelect the trigger of the schedule you want to searchDropdown list,
Multiple choice
  

Once you filled in the criteria, hit OK to view your result. Hit Clear to start over or Cancel to terminate the action.

  • Create/Edit a Schedule

To create a schedule, you click Create New button. The system will display the form for you to create a schedule.

image-20220506153613-81.png

When you want to edit the Schedule information, click the Edit button in the Action column.

image-20220506153622-82.png

Alternatively, you can access the Details page of said schedule and select the Edit button.

image-20220506153631-83.png

NoColumn /LabelDescriptionTypeMaximumIs Mandatory?Input Requirement
1NameEnter the name of the schedule you want to create/editString50 charYes 
2WorkflowSelect the workflow you want for the schedule you
are creating/editing
StringNo limitNo 
3Time ZoneSelect the time zone for the schedule.Dropdown
list
 No 
 Trigger     
6Start TimeSelect the time at which the schedule will startDate & Time Yes 
7End TimeSelect the time at which the schedule will endDate & Time No 
8Minutes
Hourly
Daily
Weekly
Monthly
Advance
Select the cycle for the scheduleSingleChoice Yes 
If you chose Minutes      
8EverySelect the exact cycle for the schedule by minutesSingleChoice No 
If you chose Hourly      
9TimesSelect the exact cycle for the schedule by hours and minutes.Int3223 hours, 59 minutesNoGreater than 0
If you chose Daily      
10TimesSelect the exact cycle for the schedule by hours and minutes.Int3223 hours, 59 minutesNoGreater than 0
If you chose Weekly      
11TimesSelect the exact cycle for the schedule by hours,
minutes and days.
Int3223 hours, 59 minutesNoGreater than 0
 Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday
Select the exact cycle for the schedule by hours,
minutes and days.
SingleChoice No 
If you chose Monthly      
12TimesSelect the exact cycle for the schedule by hours,
minutes and days.
Int3223 hours, 59 minutesOptionalGreater than 0
13EverySelect the exact cycle for the schedule by hours,
minutes and days
Int3212OptionalGreater than 0
14Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday
Select the exact cycle for the schedule by hours,
minutes and days
SingleChoice No 
If you chose Advance      
15Cron ExpressionA string comprised of 6 or 7 fields separated by white space allows users to create a CronTrigger to trigger a
schedule that recurs based on calendar.
StringNo limitNoValid syntax of cron expression
Execution Target      
17SearchAllow you to search for a specific Agent to assign the Schedule to.StringNo limitNo 
18Execution TargetDepends on the workflow that you chose, all the Robots
that are related to the selected process are displayed by default.
If you search for a specific Agent, the result will be displayed.
MultipleChoice No 
19Parameters   No 

After filling the form, click the Save button to save it, and the schedule is created. You can also cancel the creation of the schedule by clicking the Cancel button.

  • Start/Stop a Schedule

To Force Start/ Stop a Schedule, the user can click the Action button and select the Start Now button or Stop button if the Schedule is running.

image-20220506153722-84.png

Once selected, the Schedule will be run immediately and the Status will change to Running.

  • Disable/Enable a Schedule

To disable a schedule, click corresponding Action button and then select Disable.

image-20220506153732-85.png

After clicking, the system will ask for your confirmation to switch status:

image-20220506153738-86.png

When the schedule is disabled, the status of said schedule changes to Disable.

Similarly, to enable a schedule, click the corresponding Action button and then select Enable.

image-20220506153747-87.png

  • Delete a Schedule

To delete, you need to click The Action button of the corresponding Schedule and select the Delete button.

image-20220506153803-88.png

Alternatively, you can hit the checkbox before each Schedule and the Delete option will appear next to the
Filter option at the top. Click the Checkbox next to Action will allow you to select all displayed Schedule
for delete.

image-20220506153813-89.png

After clicking, the system will allow you to delete and need your confirmation before deleting.

image-20220506153822-90.png

Hit Delete to complete the operation.

h. Package Repository

Packages Repository page displays all the projects published from akaBot Studio, as well as the ones that were manually uploaded. A project becomes a package when it is published to akaBot Center.

To access the Packages page, you click the Packages Repository tab in the left menu. After clicking, the system opens the Package Listing page that includes all Packages we have published to the Center.

image-20220506153831-91.png

NoColumnDescription
 NameThe name of the package that published to akaBot Center
 VersionThe latest version of the package that published to akaBot Center.
Package version will be decided when you choose the publish option in akaBot Studio.
 Tool versionThe version of the installed Studio from which the Package published
 Created DateThe date when the project is published
 StatusThe status of the newest version of the mentioned project. A package
version can have the following statuses:
ACTIVE - it is currently deployed to a process;
INACTIVE - it is not currently deployed to a process (only these can be deleted).
 DescriptionThe description that you created for your project.
 Release NoteThe note was added in the Studio for the respective Package version.
 Created byThe User/Agent who created the Package on Center
  • View a Package

To view the detail of a Package, the user can click on the Package Name. On the detail page, you will see a list containing all versions of the selected package which were uploaded/published to the Center.

image-20220506153841-92.png

NoColumnDescription
 NameThe name of the package that published to akaBot Center
 StatusThe status of the package version. A package version can have the following
statuses:
Active - it is currently deployed to a process;
Inactive - it is not currently deployed to a process (only these can be deleted).
 Created DateThe date when the version is published
 VersionThe version of the package that was published to akaBot Center.
 Tool versionThe version of the installed Studio from which the Package published
 DescriptionThe description that you created for your project.
 Release NoteThe note added in Studio for the respective Package version when it is
published
 Created byThe User/Agent who created the Package on Center
  • Filter Package

This option allows you to filter the packages by Agent Group, Agents deploy the package, and the status of the packages. To filter your packages, you can:
On the Packages Repository page, click the Filter option.

image-20220506153851-93.png

When you click on the Filter button, the system will show a form for you to fill in. Details in the table below.

image-20220506153900-94.png

NoColumn /LabelDescriptionTypeMaximumInput Requirement
1NameEnter the name of the package you want to searchStringNo limit 
2DescriptionEnter the description of the package you want to searchStringNo limit 
3Release NoteEnter the release note of the package you want to searchStringNo limit 
4Agent GroupSelect the agent group that is attached to the package you
want to search
Input searchingNo limit 
5AgentSelect the agent that is attached to the package you want to searchInput
searching
No limit 
6StatusSelect the status of the package you want to searchDropdown
list
No limit 

Once you filled in the criteria, hit OK to view your result. Hit Clear to start over or Cancel to terminate the action.

  • Upload a Package

Typically, when you publish a workflow to the Center, a package will be uploaded to the Center automatically. However, you can also Manually upload a package to Center using the Create New button located at the top right of the Listing page.

image-20220506153911-95.png

The system will display the window for you to upload the Packages.

image-20220506153920-96.png

Click Choose File and select the packages (with the .nupkg extension) and hit Open.

Once you select the Package to upload from your local machine, hit Save to finish the upload, Cancel to terminate the operation.

  • Delete a Package

On the Packages Repository page, click on the Name of the package. The Package information and a list of all versions will be displayed.

image-20220506153931-97.png

Select Delete action corresponding with the version of the package you want to delete. A confirming popup will display. Hit Delete to complete the operation.

image-20220506153940-98.png

The selected package version is removed. If Delete related items? is selected, any Tasks, Log, Schedules and Workflow linked to this package shall also be removed.

i. Assets

Assets usually represent shared variables or credentials that can be used in different automation projects. They allow you to store specific information so that the Robots can easily have access to it.

Additionally, an extra level of security is provided, as all credentials stored here are encrypted with the AES 256 algorithm. They can be invoked by RPA developers when designing a process, but their values can be hidden from them. The Assets page enables you to create new assets. It also displays all previously created assets, which can
be edited or deleted.

To access the Asset page, you click Assets tab in the left menu. After clicking, the system opens an Asset Listing where all the Assets are located.

image-20220506153949-99.png

NoColumnDescription
1ActionAvailable actions to manage the Assets. Includes:
Edit: allows you to edit the details of each Assets
Delete: allows you to delete selected Asset
By selecting the Checkbox corresponding to each Asset, the delete option
will appear beside the Filter option and allow you to delete the Asset from the Center

! Selecting the Checkbox next to Action will select all Assets in display and allow you to bulk delete selected them
2NameThe name of the assets
3TypeMandatory. The following options are available:
Text - assets that can store string values. This is the default option.
Bool - assets that can store a true or false value. If you select this
option, the Value field displays two radio buttons (True, False).
Integer - assets that can store integers.
Credential - assets that can store credentials. If you select this option the Value field is replaced by two others: Username and Password.
4ValueThe value assigned to an asset:
Common Value - the default value received by every agent, unless a
specific value is assigned to an agent.

Value Per Agent - a value received only by the specified agent.
If Common Value is disabled, at least one agent value must be provided
5Created byThe user who created the Assets.
  • View an Asset

To view an Asset, you click Asset Name of the selected Asset in the list.

image-20220506154000-100.png

The system shows the details of workflow as below:

image-20220506154010-101.png

  • Filter Asset

This option allows you to filter the Assets based on Asset Name, Type, Kind of Value, and Value.

To filter your Assets, you can click the Filter button on the top of the Asset Listing page

image-20220506154022-102.png

When you click on the Filter button, the system will show a form for you to fill in. Details are in the table below.

image-20220506154031-103.png

NoColumn /LabelDescriptionTypeMaximumInput Requirement
1NameEnter the name of the asset you want to searchString255 char 
2TypeSelect the type of the asset you want to searchDropdown list  
3KindSelect the kind of the asset you want to searchDropdown list  
4ValueEnter the value of the asset you want to searchString  

When you click on the Filter button, the system will show a form for you to fill in. Details are in the table below.

  • Create/edit an Asset

In order to create an Asset, on the Assets page, click Create new.

image-20220506154044-104.png

When you want to edit an existing Asset, click the Edit button in the Action column.

image-20220506154053-105.png

Alternatively, you can access the Details page of said Asset and select the Edit button.

image-20220506154102-106.png

The system will display the form for you to create an Asset:

image-20220506154112-107.png

NoColumn/ LabelDescriptionTypeMaximumIs Mandatory?Input Requirement
1NameEnter the name of the asset you want to create/editString255 charYes 
2TypeSelect the type of the asset you want to create/editDropdown list Yes 
3Common ValueThis means every agent can access the asset you are creating/editing    
4ValueDepending on the type you chose Enter/select the value of the assetString500 charYes 
   Bool YesBy default, True is selected.
   Int32500 charYes 
   Credentials YesBoth User and Password needed to be filled
5Value Per AgentThis means only agents that are chosen by you can access the asset you are creating/editing   You can add multiple choices, but you can only add one by
one
6AgentSelect the agent you want to give rights to access the asset you are creating/editingInput searchingNo limitYes 
7ValueDepends on the type you chose Enter/select the value of the asset you are creating/editingString500 charYes 
   Bool, SingleChoice Yes 
   Int32500 charYes 
   Credentials YesBoth User and Password needed to be filled
  • Delete an Asset

To delete a task, you click the Delete button of the corresponding Asset.

image-20220506154122-108.png

Alternatively, you can select the checkbox before each Asset and the Delete button will show up next to the Filter button. Tick the Checkbox next to Action will allow users to select all displayed Assets for bulk delete.

image-20220506154132-109.png

A confirming pop-up will display. Hit Delete to complete the operation.

image-20220506154144-110.png

The selected Asset will be deleted.

j. Queue

Queue in simple terms is a container that holds a set of items that you want to be processed by akaBot Agents. Queue items can store different types of data, such as customer details. This information can be processed in other systems - SAP or Salesforce, for instance.

Queues enable you to create large automation projects underlined by complex logic. New queues created in akaBot Center are empty by default. To populate queues with items, to change their status and process them, you have to use Studio activities. As soon as queue items are processed, they become transactions. To access the Queue page, you click Queue tab in the left menu. After clicking, the system opens Queue Listing Page where all the Queues are located.

image-20220506154155-111.png

NoColumnDescription
1ActionAvailable actions to manage the Queue. Includes:
Edit: allows you to edit the details of each Queue
Delete: allows you to remove selected Queue from Center.
By selecting the Checkbox corresponding to each Queue, the delete option will appear beside the Filter option and allow you to delete the Queue.

! Selecting the Checkbox next to Action will select all Queue in display
and allow you to bulk delete selected ones.
2NameMandatory. The name of the queue.
3DescriptionMandatory. The description of the queue.
4In progressThe item was processed with the Get Transaction Item or the Add Transaction Item activity; when an item has this status, your custom
progress status is also displayed, in the Progress column.
5RemainingThe number of queue items that have not been processed yet, and have a New status.
6Average timeThe average time that was required to process the queue items, was expressed in seconds.
7SuccessfulThe total number of transactions that were processed successfully.
8App ExceptionsThe total number of transactions that failed with an application exception.
9Biz ExceptionThe total number of transactions that failed with a business exception.
  • View a Queue

To view a Queue, you click Queue Name of the selected queue in the list.

image-20220506154205-112.png

The system shows the details of the queue as below:

image-20220506154214-113.png

NoColumnDescription
1NameThe name of the queue.
2DescriptionThe description of the queue.
3In progressThe item was processed with the Get Transaction Item or the Add Transaction Item activity; when an item has this status, your custom
progress status is also displayed, in the Progress column.
4RemainingThe number of queue items that have not been processed and have a New status.
5Average timeThe average time that was required to process the queue items, was expressed in seconds.
6SuccessfulThe total number of transactions that were processed successfully.
7App ExceptionsThe total number of transactions that failed with an application exception.
8Biz ExceptionThe total number of transactions that failed with a business exception.
  • Transaction

Once a Queue item was in proceed, it becomes a transaction. You can check the details of the processing
queue items in the details of the queue.

NoFieldDescription
1ActionAvailable actions to manage the Queue. Includes:
View: allows you to view information of each Transaction.
Edit: allows you to edit the details of each Transaction.
Clone: allow users to create an identical Transaction.
Delete: allows you to delete selected Transaction.
By selecting the Checkbox corresponding to each Queue, the delete option will appear beside the Filter option and allow you to delete the Queue from the Center.

! Selecting the Checkbox next to Action will select all Queue in display and allow you to bulk delete selected them
2StatusThese statuses let you know if an item has been processed or not, and the
stage of the process at a particular time. Queues items can have these
statuses:
NEW
IN PROGRESS
FAILED
SUCCESSFUL
ABANDONED
RETRIED
* DELETED
3ReferenceA custom identifier for a transaction or a group of transactions.

It supports all special characters, except double-quoted. This is set for the automation project, using the Add Queue Item or Add Transaction Item activity.
The reference can be unique, depending on what you chose in the Unique Reference field when you created the queue.
4RevisionThis allows you to know the status of the revision of those queue items that have been abandoned or have failed with an application or business
exception.
5PriorityThe processing priority level of the transaction item. This field is populated according to the priority level set in the Add Queue Item activity (Low, Normal, High), in Studio.
6DeadlineThe latest time at which the queue item should be processed. This field is populated according to how you configured the Deadline property of the Postpone Transaction Item activity, in Studio.
7PostponeThe earliest time at which the queue item is available for processing. This field is populated according to how you configured the Postpone property of the Postpone Transaction Item activity, in Studio.
8StartedThe amount of time that passed since the processing started.
9EndedThe amount of time that passed since the processing stopped.
10AgentThe name of the Agent that has processed a transaction.
11ExceptionThe type of exception that caused an item to fail. This is populated according to the error type selected in the Set Transaction Status activity in Studio.
12Specific dataJSON Schema data.

Users can filter Transaction based on different criteria.

image-20220506154227-114.png

NoColumn/ LabelDescriptionTypeMaximumInput Requirement
1StatusThe Status of the TransactionDropdown listNo limit 
2ReferenceA custom identifier for a transaction or a group of transactions.String128 char 
3RevisionThe status of the revision of those queue itemsDropdown listNo limit 
4PriorityThe processing priority level of the transaction item.Dropdown listNo limit 
5StatedThe date range user wants to look for transactionsDate & Time  
6AgentThe name of the Agent that has processed a transaction.Input searchingNo limit 
7ExceptionThe type of exception that caused an item to failDropdown listNo limit 
8Specific
Data
JSON Schema dataString  
  • Filter Queue

Users can filter Queue using Queue Name.

image-20220506154237-115.png

Once you filled in the criteria, hit OK to view your result. Hit Clear to start over or Cancel to terminate the
action.

d. Create/Edit a Queue

In order to create a Queue, on the Queue Listing page, click Create new

image-20220506154246-116.png

To edit an existing Queue, select the Edit button corresponding to the Queue you want to edit:

image-20220506154255-117.png

Alternatively, you can access the Details page of said Queue and select the Edit button

image-20220506154303-118.png

The system will display the form for you to create/edit a Queue

image-20220506154311-119.png

NoColumn /LabelDescriptionTypeMaximumIs Mandatory?Input Requirement
1NameEnter the name of the queue you want to searchInput searching255 charYes 
2Unique ReferenceCheck the checkbox if you want to enforce unique references in all the transactions that are to be added to the queue.  NoThis option cannot be edited and displays if the current queue enforces unique references or not.
3Auto RetryIndicates if the Center should retry to process items in the queue when an Application Exception is encountered.  No 
4Maximum of retriesOnly appear if the Auto Retry option is selected.Int3250 charNoGreater than 0
5JSON SchemaWhen creating or editing a queue, you can upload a custom JSON.    
6Specific DataJSON schema for the specific data of all transactions in the queue. File size limited to 256kb by
default.
No 
7Output DataJSON schema for the output data of all transactions in the queue. File size limited to 256kb by
default.
No 
8Analytics DataJSON schema for the output data of all transactions in the queue. File size limited to 256kb by
default.
No 

After filling the form, click the Save button to save it, and the Queue is created. You can also cancel the creation of the queue by clicking the Cancel button.

  • Delete Queue

To delete a queue, you click the Delete button of the corresponding Queue.

image-20220506154325-120.png

Alternatively, you can select the checkbox before each Queue and the Delete button will show up next to the Filter button. Tick the Checkbox next to Action will allow users to select all displayed Queue for bulk delete.

image-20220506154334-121.png

A confirming pop-up will display. Hit Delete to complete the operation.

image-20220506154345-122.png

k. Logs

Logs provides details about each task that has been run previously. The Logs page displays logs generated by different Agents for different Workflow.

If akaBot Center is unavailable, logs are stored in a local database, within the available disk space, until the connection is restored. When the connection is restored, the logs are sent in batches in the order they had been generated.

The status of a task is stored in the memory of the akaBot Agent service. When the Center becomes available, the information regarding the task status is synced between the two. However, if the Center is not available and you restart the Agent service, the information is lost. This means that whenever Center becomes available the task is executed again.

To access the Log page, you click the Log tab in the left menu. After clicking, the system opens a Log Listing page:

image-20220506154356-123.png

NoColumnDescription
1ActionAvailable actions to manage the Logs. Includes:
View: allows users to view the details of the logs.
Delete: allows users to delete selected Log item
By selecting the Checkbox Corresponding to each Log item, the delete option will appear beside the Filter option and allow you to delete the Log from the Center


! Selecting the Checkbox next to Action will select all Log items in display and allow you to bulk delete selected them.
2TimestampThe exact time the action was executed at.
3LevelThe severity level at which the message was logged. The following options are available: OFF, FATAL, ERROR WARNING, INFORMATION, DEBUG AND VERBOSE
4Agent nameThe name of the Agent that generated a given message log.
5Workflow nameThe name of the workflow that generated a given log message.
6VersionThe version of the workflow currently being used.
7Task IDThe ID of the execution instance of the mentioned workflow.
8MessageThe logged message. This can also be a message logged through the Log Message activity in Studio.
  • View a Log item

To view a Log Details, you click on the View button on the Action column of the corresponding Log.

image-20220506154407-124.png

Alternatively, you can view Logs of a task. Go to Task tab > Select a task > Select Log Details tab and select View.

image-20220506154419-125.png

You can also view Logs of an Agent: Go to Agent tab > Select an Agent > Select the Log tab.

image-20220506154429-126.png

The system shows the details of the log as below:

image-20220506154438-127.png

NoColumnDescription
1TimestampThe exact time the action was executed at.
2LevelThe severity level at which the message was logged. The following options are available: OFF, FATAL, ERROR WARNING, INFORMATION, DEBUG AND
VERBOSE
3Agent NameThe name of the Agent that generated a given message log.
4Workflow NameThe name of the workflow that generated a given log message.
5VersionThe version of the workflow currently being used.
6Task IDThe ID of the execution instance of the mentioned workflow.
7MessageThe logged message. This can also be a message logged through the Log Message activity in Studio.
8Raw MessageThe raw logged message.
  • Filter Log item

This filter enables you to filter all the logs based on your desired criteria. Click the “Filter” button on the top right corner of the screen.

image-20220506154448-128.png

The system will show you a Filter window:

image-20220506154502-129.png

NoColumn /LabelDescriptionTypeMaximumInput Requirement
1DateSelect the date of the log you want to search.
You can filter based on a specific date range or custom range of timeframe
Date & Time  
2Task IDEnter the task id of the log you want to searchString  
3AgentSelect the agent involved in the log you want to searchInput searchingNo limit 
4Workflow NameSelect the workflow involved in the
log you want to search
Input searchingNo limit 
5LevelSelect the level of the log you want to searchDropdown list,
MultipleChoice
  
6FilterThe message of the logStringNo limit 

Once you filled in the criteria, hit OK to view your result. Hit Clear to start over or Cancel to terminate theaction.

  • Export Logs

All logs can be exported to a .xls file, by clicking the Export button. The filters applied to this page are taken into account when this file is generated. For example, if you set to view logs only from the last 30 days with an Info severity level, only the entries that meet these criteria are downloaded.

image-20220506154512-130.png

You can export the filtered log list to an excel file. Click “Export log”.

image-20220506154521-131.png

After the export, a .xlsx file will be downloaded to your computer and shall be open:

image-20220506154537-132.png

  • Delete the Logs

You can select the checkbox before each Log item and the Delete button will show up next to the Filter button. Tick the Checkbox next to Action will allow users to select all displayed Queue for bulk delete.

image-20220506154605-133.png

A confirming pop-up will display. Hit Delete to complete the operation.

image-20220506154613-134.png

l. Report

Report provides activity statistic information about the Agents & Workflows which are currently being connected to Center. Here, you can get information such as the number of successful tasks, a number of tasks that are running, stopped, or faulted. You can also check the total number of task that was run by the selected Agent or Workflows

You can get your reports by Agent and Workflow. To access the Report page, click on the Report tab in the left menu.

  • Report for Agent

Users can view Agent Report by going to Report tab > Select Agent tab.

image-20220506154624-135.png

NoColumnDescription
1Agent NameThe name of the Agent which activities is reported
2Workflow NameThe name of the Workflow which activities is reported
3Task SuccessfulThe total number of tasks that are successfully executed.
4Task RunningThe total number of tasks that are currently executing
5Task StoppedThe total number of tasks that have been stopped
6Task FaultedThe total number of tasks that experienced errors during execution
7TotalThe total number of tasks that are initiated until now.

To get the report, you can use the filter at the top of the page.

image-20220506154634-136.png

NoColumn /LabelDescriptionTypeMaximumInput Requirement
1Start TimeFrom which date you want to get the agent’s activity statistics.Date & Time  
2End TimeTo which date you want to get the agent’s activity statistics.Date & Time  
3Select Agent
Group
Select the agent group in which you want to see activity statistics.Input searchingNo limit 
4Select AgentSelect the agent of which you want to see activity statisticsInput searchingNo limit 

After that, click View for the report to be generated. If you wish to download the report, click on the Export button.

image-20220506154644-137.png

The Report will be downloaded to your local machine and shall be open:

image-20220506154654-138.png

  • Report for Workflow

Similarly, you can view the Activity Report for each Workflow too. Go to Report tab > Select the Workflow tab.

image-20220506154706-139.png

NoColumnDescription
1Workflow NameThe name of the Workflow in which activities are reported.
2Workflow VersionThe version of the workflow in which activities are reported.
3Total AgentNumber of Agents that executed this workflow.
4Task SuccessfulThe total number of tasks that are successfully executed.
5Task RunningThe total number of tasks that are currently executing.
6Task StoppedThe total number of tasks that have been stopped.
7Task FaultedThe total number of tasks that experienced errors during execution.
8TotalThe total number of tasks that are initiated until now.

You can also filter the Report using a date range, Agent group, or Workflow Name

NoColumn /LabelDescriptionTypeMaximumInput Requirement
 Start TimeFrom which date you want to get the agent’s activity statistics.Date & Time  
 End TimeTo which date you want to get the agent’s activity statistics.Date & Time  
 Select Agent GroupSelect the agent group in which you want to see activity statistics.Input searchingNo limit 
 Select WorkflowSelect the workflow in which you want to see activity statistics.Input searchingNo limit 

After that, click View for the report to be generated. If you wish to download the report, click on the Export button.

image-20220506154717-140.png

m. Administrator

m.1. User Management

A user is an entity with access-dependent capabilities whose perspective and control of akaBot Center are contingent on the roles they have been designated. Users can be created in the Center.

This page displays all available users and allows admin to add or delete, as well as update users’ information.

After selecting the User management tab, the system displays the following page:

image-20220506154725-141.png

NoColumnDescription
1ActionAvailable actions to manage the User. Includes:
Edit: allows users to view the details of the User.
Delete: allows users to delete selected User.
2LoginThe username credentials that will be used to sign in.
3EmailThe email address of the user. Can be used to log in to akaBot Center.
4StatusThe status of the user. Can be Activated or Deactivated.
5LanguageThe display language of akaBot Center for user.
6ProfilesThe role(s) assigned to the user. There are 3 default roles:
ROLE_ADMIN
ROLE_USER
* ROLE_ROBOT
A user can have more than one role. Details about permission for each role will be explained in Role Management.
7Created dateThe date when the user is created
8Modified byThe last person who modified the user’s information
9Modified dateThe last date on which the user’s information was modified
  • View a User

To view a user’s details, click on the Username (Login Column) in the list.

image-20220506154735-142.pngimage-20220506154744-143.png

NoColumnDescription
 LoginThe username credentials that will be used to sign in.
 StatusThe status of the user. Can be Activated or Deactivated.
 First nameThe first name of the user.
 Last nameThe last name of the user.
 EmailThe email address of the user. Can be used to log in to akaBot Center.
 LanguageThe display language of akaBot Center for each user.
 Created byThe user who created this user.
 Created dateThe date when the user is created.
 Modified byThe last person who modified the user’s information.
 Modified dateThe last date on which the user’s information was modified
 ProfilesThe role(s) assigned to the user. There are 3 default roles:
ROLE_ADMIN
ROLE_USER
* ROLE_ROBOT
A user can have more than one role. Details about permission for each role will be explained in the Role Management section.
  • Create/Edit a User

To create a new user, click the Create new at the top of the User page.

image-20220506154754-144.pngimage-20220506154802-145.png

When you click on Create New/Edit button, the system will show a form for you to fill in. Details in the table below.

image-20220506154812-146.png

NoColumn /LabelDescriptionTypeMaximumIs Mandatory?Input Requirement
1LoginEnter the username used to log in to the system of the user you
are creating/editing
String50Yes 
2First NameEnter the first name of the userString50Yes 
3Last NameEnter the last name of the userString50Yes 
4EmailEnter the email of the userString100Yes 
5PasswordOnly available in create new
Enter the password of the user
String50Yes 
6Confirm PasswordOnly available in create new
Reenter the password of the
user
String50Yes 
7ActivatedSelect this if you want this user to be activated upon creationCheck
Box
 No 
8LanguageSelect the language of the userDropdown list,
SingleChoice
 Yes 
9ProfilesSelect roles for the userMultipleChoice Yes 

After filling the form, click the Save button to save it, and the User is created. You can also cancel the creation of the queue by clicking the Cancel button.

  • Delete a User

To delete a User, you click the Delete button of the corresponding User.

image-20220506154837-147.png

A confirming pop-up will display. Hit Delete to complete the operation.

image-20220506154846-148.png

m.2. Role Management

akaBot incorporates a role and permission-based access-control framework. Roles are sets of permission, which means that the permissions required to access and control specific Center resources are assigned to roles. In other words, Users were not given permission to certain resources but will get the permit through a role. Depending on their roles, users have access to the resources listed below:

NoResource
1ADMIN RESOURCE
2ENVIRONMENT RESOURCE
3ROBOT RESOURCE
4PACKAGE RESOURCE
5WORKFLOW RESOURCE
6JOB RESOURCE
7SCHEDULE RESOURCE
8ORGANIZATION UNIT RESOURCE
9ASSET RESOURCE
10QUEUE RESOURCE
11LOG RESOURCE
PermissionsCategory
NoneUsers won’t see the resource in the Center interface.
ViewUsers can see the resources but can’t interact with it.
EditUsers can see and edit the resources.
CreateUsers can see and create new resources.
DeleteUsers can delete the resources.

This Role Management page displays all available roles and allows admin to add or delete, as well as update roles’ information. After selecting the Role Management tab, the system displays the following page:

image-20220506154858-149.png

NoColumnDescription
1ActionAvailable actions to manage the User. Includes:
Edit: allows users to view the details of the Roles.
Delete: allows users to delete selected role
2NameThe title of the role
  • Default Roles

In akaBot Center, there are 3 default roles:

- ROLE_ADMIN

- ROLE_USER

- ROLE_ROBOT

ROLE_ADMIN
By default, the role has all the rights to all resources and this cannot be changed.

ROLE_USER
By default, the role has the following rights, but they can be edited.

image-20220506154907-150.png

ROLE_ROBOT
By default, the role has the following rights, but they can be edited:

image-20220506154916-151.png

  • Create/edit a Role

To create a new Role for your Center, click the Create New button at the top of the page:

image-20220506154927-152.png

To edit an existing Role, click the Edit button corresponding to the Role in the Action column.

image-20220506154937-153.png

When you click on Create New/Edit button, the system will show a form for you to fill in. Details in the table below

image-20220506154945-154.png

NoColumn /LabelDescriptionTypeMaximumIs Mandatory?Input Requirement
1NameEnter the role nameString100 charYes 
2ResourcesYou can only choose one
option for each row
Select the rights for the role
SingleChoice Yes 
  • Delete a role

To delete a role, you click the Delete button of the corresponding role.

image-20220506154955-155.png

A confirming pop-up will display. Hit Delete to complete the operation.

image-20220506155008-156.png

m.3. License Management

Agent/Studio license is accessible on Organization Unit based on the License page in the Center. This allows you to accelerate deployment and manage activation from a single place. With the press of a button, you may activate, renew, or cancel licenses. You may also track license usage throughout the year.

After selecting the License Management tab, the system displays the following page:

image-20220506155015-157.png

  • Add license

https://docs.akabot.com/docs/network-activation

  • b. Renew license

https://docs.akabot.com/docs/akabot-center-renew

  • Deactivate

https://docs.akabot.com/docs/network-activation

m.4. Webhook

Webhooks allow you to integrate your akaBot Platform with your whole application ecosystem more effectively. You may subscribe to Center events and forward them to any external DCM, BPM, or CRM solution to notify various users, such as when a new queue item is ready for processing, a trigger fails, or a process is changed.

Notes: Your application must be web-hooked and compatible with akaBot.

After selecting the Webhook tab, the system displays the following page.

NoColumnDescription
1ActionAvailable actions to manage the Webhook. Includes:
Edit: allows users to edit a particular webhook.
Delete: allows users to delete selected webhook
2URLThe URL of your application
3Subscribed EventThe events will be forwarded to your application.
4EnableThe status of the webhook. There are two possible statuses: Enabled or
Disabled

Create/edit a Webhook

To create a webhook

image-20220506155026-158.png

NoColumn /LabelDescriptionTypeMaximumIs Mandatory?Input Requirement
1URLEnter the url of the system that you want to give rights to subscribe and listen to akabot
center
String1000 charYes 
2EnabledTick this box if you want
for this Webhook to work
Check Box No 
3Choose All Events / Choose EventsAllow you to choose between send all events to your application or only send selected Events.SingleChoice Yes 
4FilterSelect the Events you
want to forward to your
application.
You can choose multiple
events from the list.
MultipleChoice YesOnly available if you select Choose Events option

Failed to execute the [velocity] macro. Cause: [The execution of the [velocity] script macro is not allowed in [xwiki:akaBot Center.Getting Started.[2] How To Use AkaBot Center.WebHome]. Check the rights of its last author or the parameters if it's rendered from another script.]. Click on this message for details.

  
Navigation