https://github.com/maxinexiong/ip-address-to-location-converter-bot-rpa
An automation solution designed to tackle the challenge of creating a bot that converts IP addresses in an Excel spreadsheet into their corresponding physical locations, including Country, Region, and City.
https://github.com/maxinexiong/ip-address-to-location-converter-bot-rpa
excel-operations ip-lookup robotic-process-automation rpa uipath uipath-studio
Last synced: 2 months ago
JSON representation
An automation solution designed to tackle the challenge of creating a bot that converts IP addresses in an Excel spreadsheet into their corresponding physical locations, including Country, Region, and City.
- Host: GitHub
- URL: https://github.com/maxinexiong/ip-address-to-location-converter-bot-rpa
- Owner: MaxineXiong
- License: mit
- Created: 2024-03-31T05:44:52.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-03-31T10:30:45.000Z (about 1 year ago)
- Last Synced: 2024-04-01T09:25:39.795Z (about 1 year ago)
- Topics: excel-operations, ip-lookup, robotic-process-automation, rpa, uipath, uipath-studio
- Homepage: https://whatismyipaddress.com/
- Size: 324 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
### UiPath RPA Challenge
# IP Address to Location Converter Bot
[](https://github.com/MaxineXiong)
[](https://opensource.org/licenses/MIT)
[](https://www.uipath.com)
This repository hosts an automation solution designed to address the challenge outlined in the requirements below.
### **Objective**
Build a bot which **converts IP Addresses in an Excel spreadsheet to their respective physical locations including Country, Region and City**. Use the site [whatismyipaddress.com](https://whatismyipaddress.com/) to convert the IPs. See the attached resources of this lecture to download the "IPs.xlsx" spreadsheet.
### **Instructions**
- Navigate to the IP Lookup page on the [whatismyipaddress.com](https://whatismyipaddress.com/) website.
- Read the data from IPs.xlsx into a DataTable variable using a workbook *Read Range* activity.
- Loop through each row using a *For Each Row* activity.
- Add a *Try Catch* activity into the body of the *For Each Row* to catch any errors that occur in the loop.
- Set the catch to a System.Exception and use a *Log Message* activity to log the exception message at the error level.
- Within the Try, use a *Navigate To* activity to navigate to the URL with the predefined IP address. Hint: Your URL will look something like this: `"https://whatismyipaddress.com/ip/" + YourIPAddressExpression`
- Add a 3 second delay snippet after this activity.
- Scrape the text of the Country, Region and City and store them in String variables. Use the *Anchor Base*, *Find Element* and *Get text* activities.
- Write the results to the Spreadsheet in the relevant columns using a *Write Cell* activity.
_You can check out the **automation demo video for the solution** below_:
https://github.com/MaxineXiong/IP-Address-to-Location-Converter-Bot-RPA/assets/55864839/b592bed2-0693-49b0-9077-341dd070a549
## **Installation**
Before installing **UiPath Softwares**, please make sure your system meets the hardware and software requirements outlined in the **[UiPath documentation](https://docs.uipath.com/studio/standalone/2022.10/user-guide/hardware-and-software-requirements)**.
The **Uipath Platform** includes the following tools:
- **UiPath Studio**
- **UiPath Assistant**
- **UiPath Automation Cloud, including UiPath Orchestrator**
To run this project successfully, please follow these steps to install UiPath Studio:
***
Step 1 : Visit [uipath.com](https://www.uipath.com/) and click **Try UiPath Free** button.
Step 2: **Sign up** for a personal account.
Step 3: **Verify** your account in email.
Step 4: **Log into** the **UiPath Automation Cloud** using your account, and click the **Download Uipath Studio** button.
Step 5: Click **Sign in**.
Step 6: Select **UiPath Studio Pro**.
Step 7: Follow the system instructions to complete the installation of **UiPath Studio Pro**.
Please also follow these steps below to connect your local machine to the UiPath Automation Cloud for deploying this workflow (if desired):
***
Step 1: Sign up and log into [UiPath Automation Cloud](https://cloud.uipath.com/).
Step 2: Add a **Tenant**.
Step 3: **Edit** the user and assign the **Automation Users** role to grant them permission to execute processes.
Step 4: Go to the **Orchestrator** interface and click on **Tenant** in the left pane.
Choose **Folders** and then click the **+** icon to create a new folder.
Step 5: Navigate back to **Tenant** interface and follow the steps below to start adding an Automation User for Unattended Robot in **Manage Access**.
a) Scroll down to locate the target user, then assign the **Automation User** role to grant them the necessary permissions. Click **Next** button to move on to the next page.
b) In the *Personal automations setup* page, select the options to **Enable user to run automations** and **Create a personal workspace for this user and enable optimal Studio Web experience**, then click on the **Next** button.
c) On the *Unattended setup* page, check the option to **Enable this user to run unattended automations**, choose **Specific Windows credentials** for local machine connection to Orchestrator, provide **Domain\Username** of your user account on local machine (which can be found by executing `whoami` in Command Prompt), and enter the **Password** for accessing your local machine. Finally, click on the **Update** button.
Step 6: Now, go to the **Machines** page where you should see the workspace machine for the target user already created. Click the ellipsis to select **Edit Machine**.
Enter **1** for both the *Production (Unattended)* and *Testing* fields, then click the **Update** button.
Step 7: Now return to the newly created folder, choose the **Machines** menu, and click **Manage Machines in Folder** button to assign the machine you just configured to the folder.
You should now have both the **User** and **Machine** assigned to the new folder.
Step 8: Open **UiPath Assistant** and click **Sign In**. If you see the **green circle** in the top right corner, you’ve successfully connected your local *UiPath Studio* to the *UiPath Automation Cloud*.
You can confirm the connection by opening UiPath Studio and checking for a green circle at the bottom.
***
To **publish a process** from UiPath Studio to Orchestrator, **switch to the new folder** you just created in the Orchestrator, and then click to **Publish the process** as a package.
To learn more about other best practices on Orchestrator, please refer to the [Orchestrator User Guide](https://docs.uipath.com/orchestrator/standalone/2023.4/user-guide/introduction).
## **Usage**
To run the RPA workflow on your local machine, follow these steps:
1. Either **download** this repository to your local machine or **clone** it directly within your UiPath Studio.
2. Open the **UiPath Studio** software on your machine.
3. Locate and **open** the **Main.xaml** file from the downloaded repository in **UiPath Studio**.
4. **Run** the **Main.xaml** file to start the RPA process.
## **Acknowledgement**
I would like to express my gratitude to the **[UiPath community](https://community.uipath.com/)** for providing resources, tutorials, and a platform for automation enthusiasts to learn and collaborate.
## **License**
This project is licensed under the [MIT License](https://choosealicense.com/licenses/mit/), which means you're free to modify, distribute, and use the code in your own projects.