A2019 Excel Data Lookup Bot

Readme

Version 1.0
03/01/2020
 Table of Contents
1. Introduction .............................................................................................................. 3
1.1 Overview ........................................................................................................... 3
1.2 Use Cases ........................................................................................................ 3

2. Requirements & Prerequisites ................................................................................ 4

2.1 System Requirements....................................................................................... 4
2.2 Prerequisites ..................................................................................................... 5

3. Getting Started ......................................................................................................... 6

3.1 Quick Start ........................................................................................................ 6
3.1.1 Setup .......................................................................................................... 6
3.1.2 Configuration .............................................................................................. 6

4. Support & FAQs ....................................................................................................... 9

4.1 Support ............................................................................................................. 9
4.2 FAQs................................................................................................................. 9

Appendix A: Record of Changes ............................................................................... 10

Appendix B: References ............................................................................................. 11

Page 2 of 11
1. Introduction
This document contains all essential information for the user to make full use of this A2019 Bot.
It includes a description of the functions and capabilities and step-by-step procedures for setup
& configuration of the Bot.

1.1 Overview
The Excel Data Lookup Bot can be called from any A2019 bot and looks up the cell value
corresponding to the column and row specified based on a specific Excel file. You can specify columns
by title, label or number, and specify row by title or row number. This bot includes a sample code bot
that executes all the various combinations of data lookup.

1.2 Use cases

The key use case for this bot includes extracting data from Excel spreadsheets to use in your business
and operational processes. It performs the following functions:
• Reads an Excel value based on column and row number.
• Reads an Excel value from a spreadsheet with a header row based on header title and
row number.
• Reads an Excel value from a spreadsheet with a header column based on column title,
number or label and row title.
• Shows how to run the Excel Data Lookup Bot via the included sample bot.

Page 3 of 11
2. Requirements & Prerequisites

2.1 System Requirements

Below are the minimum system requirements for running bots as an Enterprise
A2019 (Cloud deployed) or Community Edition user on your local machine.

Hardware Requirements

Device Processor RAM Storage (Free Space) Network

Machine Intel Core i5 2.6 4 GB minimum 32 GB 1 GbE

GHz
8 GB recommended

Bot No additions to No additions to the Add 100 through 150 KB No additions

Creator a the machine machine requirements per Automation to the
nd Bot requirements Anywhere script machine
Runner requirements
Add 40 through 50 GB per
long-term project

Browser Requirements
The user interface for Automation Anywhere Enterprise is through a browser. Login to your
device then login to Enterprise Control Room through a browser.

Browser Browser Automation Anywhere Supported bot functions by Bot

Version plug-in version2 agent version

Google Chrome1 57 or later 11 or 12 2.0.2 1.0.2 1.0.1

Microsoft Internet 11 N/A None Debugger All except

Explorer only Credential
Vault

(1) Google Chrome re-verification

CAUTION: Google Chrome requires re-verification of permissions when the Automation Anywhere Google Chrome extension (Version 11.3.3 or
later) is updated. If prompted, click Enable this item in the Google Chrome message. Alternatively, re-enable the extension through chrome web
store. Similarly, if you are deploying your Bot Runners from a master image, accept the permission from within that image.

(2) Google Chrome plug-in versions

A2019 supports Chrome plug-in version 11. If you have other versions installed, you might not be able to record tasks using the Record feature
or Capture action. To resolve this issue, do the following:
1. Rename the automation.chrome.agent registry key to automation.chrome.agent.old. The registry key is available
at: Computer\HKEY_CURRENT_USER\Software\Google\Chrome\NativeMessagingHosts
2. Disable all other Google Chrome plug-in versions you have installed, except for version 11.

Page 4 of 11
2.2 Prerequisites
This bot uses A2019 and the Microsoft Excel application via the Advanced Excel commands.
Your Excel file may be stored in your Control Room (as is shown in the sample bot) or in the File
System. Please refer to the sample bot for examples.

Page 5 of 11
3. Getting Started
3.1 Quick Start
3.1.1 Setup
3.1.1.1 Excel
You will need Microsoft Excel installed on your Bot Runner machine and the ability to get your
Excel file in the file system of that machine or in the Control Room in order to execute this bot.

3.1.2 Configuration

Review and setup the variables happen in the calling bot. The sample calling bot included is
called “A2019 Excel Data Lookup Sample Bot”. It contains examples of the various ways to
invoke the Excel Data Lookup Bot. There are 3 required and two optional input values, and 2
output value.
When calling a subtask, the return value is always of type dictionary, and the value(s) returned
from the subtask can be access through their specific variable names as a key within the
dictionary.

INPUT VARIABLES: Input Variables to be mentioned in this Table

Variable Name Type Mandatory Purpose Example Input
in_ExcelFile File Yes Specifies source File variable: $vExcelFile$
Excel file for or
lookup Desktop file page:
C:\Documents\Excel_file.xlsx
in_ColumnId String Yes Column “Column title” when using
Identifier for title Column Lookup type
lookup “A” when using label
Column Lookup type
“7” when using number
Column Lookup type
in_RowId String Yes Row Identifier “Row title” when using title
for lookup Rpw Lookup type
“5” when using number
Row Lookup type
in_ColumnLookupType Yes No The type of Options:
column lookup title | label | number
you want to label is default if excluded
perform
in_RowLookupType Yes No The type of row Options:

Page 6 of 11
 lookup you title | number
want to title is default if excluded
perform.

Page 7 of 11
 OUTPUT VARIABLES: Output Variables to be mentioned in this Table.
Variable Name Type Mandatory Purpose Example Output
out_CellFound String - The location Access via:
where the value $vResponseDict$(“outCellFound”)
was found Example: C24
out_Value Dictionary The value in the Access via:
cell referenced $vResponseDict$(“outValue”)
Example: 56.55

Page 8 of 11
4. Support & FAQs

4.1 Support
Free bots are not officially supported. You can get access to Community Support through the following
channels:
• You can get access to Community Support, connecting with other Automation Anywhere
customers and developers on APeople – the Bot Building Forum, the Bot Store Support Forum,
or the Developers Everywhere Group.
• Automation Anywhere also provides a Product Documentation portal which can be accessed for
more information about our products and guidance on Enterprise A2019.

4.2 FAQs
Q: Can I make changes to this bot?
A: Absolutely. Free bots are for you to make use of, customize, and/or include in your builds as
you see fit.

Q: Can I upgrade the packages for this bot?

A: Yes – but know that the bot was created/tested on a specific package version. Any
modifications to that may result in unexpected outcomes – so make sure to test the bot/subtask
after making any package version modifications.

Q: How can I change the output format of the bot?

A: When calling a subtask, the return value is always of type dictionary, and the value(s)
returned from the subtask can be access through their specific variable names as a key within
the dictionary.

For questions relating to Enterprise A2019: See the Enterprise A2019 FAQs.

Page 9 of 11
 Appendix A: Record of Changes

No. Version Number Date of Change Author Notes

1 1.0.0.0 3/1/2020 Max Mancini Initial release of Bot

Page 10 of 11
 Appendix B: References

No. Topic Reference Link

1 Overview of Enterprise A2019 Click here

2 Guidance: Building basic A2019 bots Click here

3 Guidance: Building A2019 action packages Click here

4 APeople Community Forum Click here

5 Automation Anywhere University Click here

Page 11 of 11