jd edward currency exchange - amazon web services

JD Edward Currency Exchange

Readme

Version 1.0 26/06/2020

Table of Contents

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

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


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.


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


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


of 23

terminal servers


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


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


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.


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

[email protected]

vToEmailAddress String Yes Email address that is sent

Excel file


[email protected]

vJDELink String Yes Link to JDE platform

JDEBotLoginInfo.xls

www.jde.com


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


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


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):


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


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


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

[email protected]

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

mailto:[email protected]


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

[email protected]

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”



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


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


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.



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”


https://botstore.automationanywhere.com/bot-security/



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.

https://botstore.automationanywhere.com/my-account/downloads/

https://botstore.automationanywhere.com/inputting-your-access-code/


of 23


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

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

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

https://docs.automationanywhere.com/bundle/enterprise-v11.3/page/enterprise/topics/control-room/bots/credentials/create-a-credential.html

jd edward currency exchange - amazon web services

Documents