Table of Contents
Page 2 of 23
Table of Contents
1. Introduction .............................................................................................................. 3
1.1 Overview ........................................................................................................... 3 1.2 Common Use cases .......................................................................................... 4
2. Requirements & Prerequisites ................................................................................ 5
2.1 System Requirements ....................................................................................... 5 2.1.1 Control Room ............................................................................................. 5 2.1.2 Client .......................................................................................................... 5
2.1.3 Browser Selection ....................................................................................... 6
2.2 Prerequisites ..................................................................................................... 6
2.3 Security Measures ............................................................................................ 7
3. Getting Started ......................................................................................................... 8
3.1 Skill Matrix ........................................................................................................ 8
3.2 Installation Hierarchy ........................................................................................ 8 3.3 Quick Start ........................................................................................................ 9
3.3.1 Setup .......................................................................................................... 9 3.3.2 Configuration .............................................................................................. 9 3.3.3 Variable Breakdown ................................................................................. 12
4. Reports ................................................................................................................... 16
5. Logs ........................................................................................................................ 17
6. Troubleshooting & Support .................................................................................. 18
6.1 Support ........................................................................................................... 18
6.2 FAQs ............................................................................................................... 18
Appendix A: Record of Changes ............................................................................... 21
Appendix B: Acronyms ............................................................................................... 22
Appendix C: References ............................................................................................. 23
Appendix A: Record of Changes
Page 3 of 23
1. Introduction
This document contains all essential information for the user to make full use of this Enterprise 11.3.5 Bot. This manual includes a description of the functions and capabilities and step-by-step procedures for setup & configuration of the Bot.
• Functionality: Creates new (current) currency rate conversions based on validations identified in the document.
• Capabilities: This bot can be ran on a schedule or on demand based on business needs.
• Step by step procedures will be found throughout the document regarding bot configuration and process steps.
1.1 Overview The JDECurrencyExchange Bot can be used to update currency records in the JD Edwards ERP platform. The Bot will ensure that each record in the currency exchange table is updated to the current exchange rates.
• Log into JD Edwards
• Navigate to Currency Exchange page
• Create Excel file
• Format Excel header
• Loop through currency records o Check if record has proper requirements to be updated
▪ Requirements are:
• Conv Meth = Z
• Calc Meth = 1
• Effective Date not equal to today
• Currency codes do not contain MXP (expired currency code) o Get previous conversion rate o Launch conversion website and get new conversion rate o Close conversion website o Create new currency conversion rate record and enter new conversion rate o Put required information into excel file
▪ To Currency Code ▪ From Currency Code ▪ Previous Conversion Rate ▪ Current Conversion Rate
• Save Excel spreadsheet
• Close Excel and JD Edwards
Appendix A: Record of Changes
Page 4 of 23
• Send email with Excel file
1.2 Common Use cases The solution use case: Update aging currency conversion rates in JD Edwards application P0015A. The solution identifies with organizations that require transactions to occur utilizing more than one currency.
Appendix A: Record of Changes
Page 5 of 23
2. Requirements & Prerequisites
2.1 System Requirements
2.1.1 Control Room
Device Processor RAM Storage (Free
Space)
Network
Enterprise
Control Room
Servers
8 Core Intel
Xeon Processor
16 GB 500 GB 1 GbE
Enterprise
Control Room
on Amazon
Web Services
EC-2
8 Core Intel
Xeon Processor
16 GB 500 GB 1 GbE
Enterprise
Control Room
on Google
Cloud Platform
8 Core Intel
Xeon Processor
16 GB 500 GB 1 GbE
Enterprise
Control Room
on Microsoft
Azure
8 Core Intel
Xeon Processor
16 GB 500 GB 1 GbE
2.1.2 Client
Component Server Processor RAM Storage (Free
Disk Space)
Network
Enterprise client on
hardware machines
3.5 GHz plus
with 4 multi-
cores or higher
8 GB or more
per machine
8 GB 1 GbE
Enterprise client on
virtual machines
Virtual machine
options: • Citrix
XenDesktop1
• VMware Horizon Client version 4.8.0 or later
• Windows multi-user
4 virtual CPU
(vCPU) or
Logical
Processor with
1.2 to 1.5 GHz
speed per vCPU
8 GB or more
per machine
8 GB 1 GbE
Appendix A: Record of Changes
Page 6 of 23
terminal servers
Enterprise client on
cloud service.
Cloud provider
options: • Amazon Web
Services EC2
• Google Cloud Platform
• Microsoft Azure
U 4 CPU per
Automaton
Anywhere
Instance
8 GB per
Automation
Anywhere
Instance
8 GB
1GbE
Additional users on
a multi-user
system.
2 CPU per
additional user
4 GB per
additional user
No additional
storage needed
No additional
network
needed
Bot Creator and
Bot Runner
3.5 GHz plus
with 4 multi-
cores or higher
8 GB or more
per machine
Add 100
through 150
KB per
Automation
Anywhere
script
Add 40
through 50 GB
per long-term
MetaBot
Project
1 GbE
2.1.3 Browser Selection
2.2 Prerequisites Software:
• Microsoft Outlook installed on the bot runner machine o Email server is configured in Automation Anywhere Client
• JD Edwards Platform Access
• Microsoft Excel installed on the bot runner machine
• Internet Explorer browser is installed on bot runner machine Licenses:
• AA Enterprise 11.3.x.x license
• JD Edwards user license
• Microsoft Office suite
Browser Browser Version
Internet Explorer 10 or later
Appendix A: Record of Changes
Page 7 of 23
o Outlook o Excel
2.3 Security Measures • Connect to VPN that supports JD Edwards (if applicable)
• Anti-Virus software may need to be added for email configurations to enable outgoing email ports to function as desired
Appendix A: Record of Changes
Page 8 of 23
3. Getting Started
3.1 Skill Matrix MetaBots:
• Login.mbot – Logs into JD Edwards
• JDECurrencyExchange.mbot – Creates new currency conversion records
3.2 Installation Hierarchy • Download the bot from Bot Store
• Double click on <Bot Name>.msl and follow the installation instructions o For first time user, the “Bot Store” folder is created under <AA Directory>/My
Tasks (on your local disk). o Installer creates the following folder structure with content under the <AA
Directory> Folder Structure Description
<AA Application Path>
• My Tasks o Bot Store
▪ JDECurrencyExchange (folder)
• My Tasks o JDECurrencyBot.atmx
• Error Folder o Logs (Folder)
▪ Error Logs Moth-Day-Year.txt
o Snapshots (Folder) ▪ Error Snap
Month-Day-Year.png
• Input Folder o BlankExcel.xls o JDECurrencyBotInfo.xls o JDEBotLoginInfo.xls
• Output (Folder) o <file
name>ddmmyyyy.xls
• My Metabots o JDECurrencyExchange.mbot o Login.mbot
<AA Application Path> is the location where AA files are stored on your machine. My Tasks is the default directory where Bot files are stored. Bot Store contains the Bot Name Folder which the installer creates while installing your Bot. JDECurrencyExchange is a folder that is created by the installer and contains files and folders needed for the bot execution. My Tasks contains the JDECurrencyBot.atmx file which contains the compilation of bots used to perform the currency conversion and record updating. Error Folder is where logs and snapshots of screens will be placed if something goes wrong with the bot during execution. Input Folder is where the input files that the bot needs for execution of the use case is saved.
• BlankExcel.xls is where the bot copies a blank excel (.xls) file from.
• JDECurrencyBotInfo.xls is where the JDE Link, and to and from email addresses are held.
Appendix A: Record of Changes
Page 9 of 23
• JDEBotLoginInfo.xls is where the JDE Link is contained.
Output Folder • <file
name>ddmmyyyy.xls contains the output information
My Metabots folder contains the Developed Metabots needed for bot execution
3.3 Quick Start
3.3.1 Setup
To setup the bot to run, you need to designate the required items in the excel file and set up the credentials for JD Edwards login. Where these required edits are to be made is outlined in the configuration section; 3.3.2
3.3.2 Configuration
Create a locker named “JDE Login” with a user who has the role of locker_admin. Create two credentials in the credentials tab named “JDE Username” and “JDE Password” with the username and password for JD Edwards, respectively.
Locker Name Credentials Name
Attribute Name
Value
JDE Login JDE Username Username Username for JD Edwards
JDE Login JDE Password Password Password for JD Edwards
• INPUT VARIABLES: Input Variables to be mentioned in this Table are to be entered into
JDECurrencyBotInfo.xls for bot to run
Variable Name Type Required
Purpose Excel File Example Input
vFromEmailAddress String Yes Email address that will be sending the
Excel file
JDECurrencyBotInfo.xls
vToEmailAddress String Yes Email address that is sent
Excel file
JDECurrencyBotInfo.xls
vJDELink String Yes Link to JDE platform
JDEBotLoginInfo.xls
www.jde.com
Appendix A: Record of Changes
Page 10 of 23
vExcelFileName String Yes File name of Excel file that will contain
currency exchange
information. Will be
appended by the current
date in ddmmyyyy.
Example: <file name>ddmm
yyyy.xls
JDECurrencyBotInfo.xls
ExchangeRobotRun
Input Folder:
• BlankExcel.xls o copy blank excel document
• JDECurrencyBotInfo.xls o contains JDE Link, to and from email addresses, and the Excel File Name o Information must be in designated cells for bot to work properly o Example of JDECurrencyBotInfo.xls:
• JDEBotLoginInfo.xls
o Contains the JDE Link that the bot is to be run on o Will impact other bots that use the JDELogin.mbot o Example of JDEBotLoginInfo.xls:
OUTPUT VARIABLES: Output Variables in Excel and JDE Currency Exchange Records (P0015A)
Variable Name Type Required Purpose Example Output
vFromCurrencyCode String Yes Represents the currency you are converting from. Output in Excel
file.
AUD
vToCurrencyCode String Yes Represents the currency you are
USD
Appendix A: Record of Changes
Page 11 of 23
converting to. Output in Excel
file.
vCurrPrevRate Number Yes Represents the previous
conversion between the two
currencies. Output in Excel file.
0.8925
vCurrNewConversionRate Number Yes Represents the new conversion
rate between the two currencies. Output in Excel file and in new
record created in JDE.
0.9257
Output: <file name>ddmmyyyy.xls – excel of currency exchange information sent to designated address
• Example (content will vary with different exchange tables, but the structure remains):
Appendix A: Record of Changes
Page 12 of 23
3.3.3 Variable Breakdown
Variable Name Type Purpose Example Output
vConversionURL String Contains the modified URL that will path
directly to the conversion of the currency codes.
http://xe.com/currencyconverter/convert/?Amount=1&From=[FromCurren
cy]&To=[ToCurrency]
[FromCurrency] and [ToCurrency] are replaced by the respective currency
codes.
vCurrCalcMeth Number Contains the current records calculation
method. This is one of the requirements for
record creation.
1
Appendix A: Record of Changes
Page 13 of 23
Contained in the “Review Currency
Exchange Rates” table.
vCurrConvMeth Character Contains the current records conversion method. This is one of the requirements for record creation. Contained in the “Review Currency Exchange Rates” table.
Z
vCurrDate String Today’s current date 06/29/2020
vCurrDay String Today’s day 29
vCurrIteration Number Current iteration in the “Work with Currency Exchange Rates” table.
5
vCurrMonth String Today’s month 06
vCurrNewConversionRate
Number Current conversion rate. This is the rate the will be used to create the new record and was gotten from the conversion site.
0.8894
vCurrNumInRate Number Individual character in the new rate. The new rate is iterated through and each number is typed into a calculator on screen.
8
vCurrPrevRate Number Most recent rate for a currency. This will now be the old conversion rate.
0.7786
vCurrSubtableEffDate String Most recent records effective date. This is used to compare against the current date for record creation validation.
06/28/2020
vCurrSubtableIteration Number Current iteration in the “Review Currency
5
Appendix A: Record of Changes
Page 14 of 23
Exchange Rates” table
vCurrYear String Current Year 2020
vExcelFileDate String Date that will be put into the Excel file.
06/04/2020
vExcelFileName String Excel provided name of Excel file. Will be appended by the formatted date.
ExchangeRateRobotRun
vExcelPathDate String Current date formatted as ddmmyyyy and is appended to vExcelFileName to create the new file.
29062020
vExcelPathString String Path of the Excel file. Used for emailing Excel file.
$AAApplicationPath$\Automation Anywhere\My
Docs\JDECurrencyBotAssets\$vExcelFileName$$vExcelPathDate$.xls
vFromCurrencyCode String Currency code you are converting from
AUD
vFromEmailAddress String Email address you are emailing from
vNumIterations Number Total number of iterations in the “Work with Currency Exchange Rates” table
43
vNumSubtableIterations Number Total number of iterations for the current record in the “Review Currency Exchange Rates” table
10
vRateIterator Number Iterator that iterates through each character in the new conversion rate. This is used to type the rate into the on screen calculator.
4
vRateLength Number Length of the new conversion rate string
5
vRecordDay String Current record day 27
vRecordMonth String Current record month 05
vRecordYear String Current record year 2020
Appendix A: Record of Changes
Page 15 of 23
vTabIterator Number Number of times to tab down from the top of the table in “Work with Exchange Rates” table. Goes to the next desired record.
7
vToCurrencyCode String Currency code that is converted to
USD
vToEmailAddress String Email address of Excel recipient
vValidRecord String Boolean value that is set to false if the record date is the same as the current date. Creates a record if this equal “True.”
“True” or “False”
Appendix A: Record of Changes
Page 16 of 23
4. Reports
This bot will create an excel file that will hold all the information collected during the currency update process. There will be a file sent to a designated and all previous bot run excel files will be stored in the JDECurrencyBotAssets folder. Excel folder path: $AAApplicationPath$\Automation Anywhere\My Docs\JDECurrencyBotAssets\[Insert Provided Excel File Name]ddmmyyyy.xls
Appendix A: Record of Changes
Page 17 of 23
5. Logs
In case of Errors, Error Logs and Screenshots are generated within Error Folder. My Tasks
• Bot Store o Bot Name
▪ Error Folder
• Logs (Folder) o Error Logs Month-Day-Year.txt
• Snapshots (Folder) o Error Snap Month-Day-Year HourMinSec.png
Error Logs will contain the below information—
• Task Name
• Error Line Number
• Error Description
• Generated Timestamp Example of Log File:
• Example of Screenshot Generated Error File
Appendix A: Record of Changes
Page 18 of 23
6. Troubleshooting & Support
6.1 Support For support:
• Email Whitelight Group at [email protected]
• Ticket number will be emailed to you within 20 minutes
• Support hours: 8am – 5pm CST; Monday – Friday
• Subject line content: Automation Anywhere – Currency Conversion Rate Issue
6.2 FAQs
What currencies does the bot identify before updating? This bot will identify and update all currencies except for the old Mexican Peso (MXP). How often should I run this bot? It is suggested to run this bot daily. This bot cannot be run more than once a day as one of the requirements of the bot is that the most recent record was not created on the same day as the bot being run. This is to avoid duplicate record creation as there are inverse records created (one record for AUD to USD and another for USD to AUD). If records could be updated multiple times a day, then there would be duplicate records after each bot run. This is why you can only run the bot a maximum of 1 time per day. Is this an attended or unattended bot? This is an unattended bot, meaning there does not need to be an operator present when the bot runs. What changes do I have to make to the bot to ensure it will work on my JDE system? The table in Review Currency Exchange Rates must be set to “* Eff Date Descending.” This to ensure that the record at the top of the table is the most recently created record. What version of JDE do I have to be on for this bot to work in my environments? 9.1 What version do I have to have for AAE for it to work? 11.3 or higher Do I have to have another user license for JDE to login and run the bot? Yes, it is required to have a separate set of credentials in JDE for the bot to run. This is to ensure proper activity tracking of changes in the JDE platform.
What is the process of downloading and adding this bot to my Control Room? See 3.3.2 and 3.2.
Appendix A: Record of Changes
Page 19 of 23
How do I download and install a bot or Digital Worker from Bot Store? Browse Bot Store for products. Once you find a product that interests you, click on the “Get Bot” or “Start Free Trial” button to begin the download process. For Enterprise V11, complete steps are listed below:
1. Download the product, once download of .MSI is complete
2. Right-click on the .MSI file and execute as an Administrator.
3. On the “Welcome to Installation” wizard, click Next to continue.
4. Read and click “I agree to the terms” in the license agreement radio button to accept the
agreement.
5. Get/Copy the License key from Bot Store Downloads page or order confirmation email
into License Key, click Next to continue.
6. Click Install to begin the installation.
7. Click Finish to complete the installation.
How can I buy products on Bot Store? Many products have self checkout capabilities, look for the blue “Buy Now” button. For all other products, contact your Automation Anywhere Account Manager or you can email Automation Anywhere at: [email protected] I am interested in purchasing a product, what are the system requirements? For Enterprise V11 you will need to have version 11.3.3 at minimum to run paid bots and Digital Workers. Do paid listings have a free trial? Yes, paid listings come with a 30-Day Free Trial. Your free trial Access Code will expire 30 days after the download. What security verifications were completed for products listed on Bot Store? All products on Bot Store are verified at Level 1, malware scan. For details about the 4 progressive levels or security designation, please review our Bot Security Program. I can’t run the MSI installer for a bot or Digital Worker I downloaded, what can I do? For Enterprise V11 To run an Automation Anywhere Bot Store MSI installer, the Windows user must have Administrator privileges to execute the installer on the device. Please contact your company’s IT Support Desk or Center of Excellence to check the policy on executing installer files if you do not have the required permissions. Or you can email us at [email protected] and we can send a Zip file. I don’t see the files after successfully running the .MSI. What should I do? First, check if the user has Administrator privileges. Once confirmed, you may try again by:
1. Uninstall the bot by going to “Add/Remove Programs”
Appendix A: Record of Changes
Page 20 of 23
2. Go to Windows > type CMD
3. Right-click CMD and click on “Run as Administrator”
4. Navigate to the path where the .MSI is located and execute it
Now it should work and display all the files correctly. I see terms such as License Key and an Access Code, what is the difference? The License Key is used during the installation process with the MSI installer. The Access Code grants permission to run the product for a defined period of time. You will receive one Access Code for the 30-Day Free Trial and a separate Access Code with the purchase of an annual subscription. Both codes are available to you on your “My Downloads” page. How and where do I input the Access Code I received? For Enterprise V11 When you download a 30-Day Free Trial or make a purchase, you will need to input the Access Code into each of the Task Files that shipped with your bot or Digital Worker. For more detailed instructions, visit Inputting Your Access Code. How do I request ongoing support for my paid product? Please contact the vendor for support questions. The vendor contact details can be found on the product detail page or the vendor profile page in Bot Store. Vendor support is available with your purchase of your product.
Appendix A: Record of Changes
Page 21 of 23
Appendix A: Record of Changes
Instructions: Provide information on the version number, the date of the version, the author/owner of the version, and a brief description of the reason for creating the revised version.
No. Version Number Date of Change Author Notes
1 1 6/25/2020 Hayden Schultz Create first instance of Readme
Appendix B: Acronyms
Page 22 of 23
Appendix B: Acronyms
Instructions: Provide a list of acronyms and relative description used within the document. Sequence should be alphabetical
No. Acronym Description
1 JDE JD Edwards ERP Platform
2 GB Gigabit (1 billion bits)
3 GbE Gigabit Ethernet (1 gigabit per second or 1 billion bits per second)
4 CPU Central Processing Unit of computer
5 AAE Automation Anywhere Enterprise
Appendix C: References
Page 23 of 23
Appendix C: References
Instructions: Summarize the relationship of this document to other relevant references. Provide information for all documents/links used to arrive at and/or referenced within this document. Example:
No. Topic Reference Link
1 How to Create a Credential in Credential Vault?
Click here