Image Alt

fofx Academy

  /  Robotic Process Automation   /  How to Connect your PC to your Robots on UiPath Cloud Platform

How to Connect your PC to your Robots on UiPath Cloud Platform

There are three main tools you use when automating robotic processes using UiPath RPA (robotic process automation) technology – UiPath Studio, UiPath Robot, and UiPath Orchestrator; the first two are desktop applications while the third is web-based. Now UiPath, the global leader in RPA technology, offers two main classes of license for users to choose from – Community and Enterprise; the former is free while the latter which has a couple of flavors is a paid offer.

UiPath offers the Community edition free so that developers and small teams can begin their automation journey. As such, the Community package allows you to have access to both UiPath Studio and UiPath Robot which are installed on your PC, but your access to UiPath Orchestrator has to be via your cloud/platform account.

The purpose of this tutorial, therefore, is to help you get through the steps you need to take to get the service functionality of the UiPath Robot application (installed on your PC when you install any version of the UiPath Studio application) to be able to communicate with the Robots you have existing on (or added to) any UiPath Orchestrator instance connected with your account on the UiPath cloud platform.

In addition, if you are yet to install Studio on your PC, we shall walk you through that as well. Shall we begin?

Step 1

Open the UiPath Platform Trial page on your browser (preferably Google Chrome or Mozilla Firefox).

Step 2

Click on the Choose Community option/button.
It is ALWAYS free and if you so choose, you can upgrade it to the Enterprise edition (which is paid) at any time.

Step 3

Choose an Account Registration option.
There are four (4) options to choose from. If you already have a Gmail account, it is advisable you take the “Sign up with Google” option. The same applies if you have a Microsoft or LinkedIn account. For the purpose of this guide, we shall be taking the last alternative, which is “Sign up with Email”.

Step 4

Create your account on the UiPath cloud platform.
Fill the registration form. Two things to take note of: first, filling the “company” field is optional; second, your password should have a least 8 characters which MUST include at least one each of an uppercase letter, a lowercase character, a number, and a special character. Next is to check the “I agree to Privacy Policy and Terms of Use” checkbox. Then click on the Signup button.

Step 5

Email verification.
Those who choose to register using their Google, Microsoft or LinkedIn account will not use this step. So if like me, you decided to register using the “Sign up with Email” then you should see the screen depicted by the image below.

The implication is that you need to check the Inbox or Spam/Junk folder of the email you used for the registration. You should see an email titled “SPAM-LOW: Verify your email” from “UiPath Platform v” or something. Open the mail and then click on the “Verify Email” button (see Image below).

A new browser tab opens (see image below) so you can sign-in using your email address and password you supplied during the account registration process. NOTE that the green-colored “Email verified successfully, login now” message disappears after a few seconds; so don’t panic when you do not see it on your own screen, so long you see a login form, you are fine. Let us proceed.

Step 6

If you see a modal window displaying a ‘Congratulations’ message, do endeavor to watch the 3-minute Welcome “Meet the UiPath Cloud Platform” video. When you are done, close the modal window.

Step 7

Take a careful look at the browser window before you. You should see the Menu area on the left pane of your screen. Notice the numbers in the ‘Distributed Licenses’ area of your dashboard? The community edition of UiPath gives you access to 2 attended robots (named user), 1 unattended robot (runtime), and 2 studio [or development] robots (named user). I shall talk on this just before this I end this tutorial post. If you already have UiPath Studio installed on your PC, kindly skip to Step 10.

Step 8

It is time to download the UiPath Studio installer. Go to the Menu area and click on RESOURCE CENTER (see the image below) to open the ‘Resource Center’ page, locate the Community Edition option and click on the STABLE tab, then click on the ‘Download (Stable)’ button to download the installer.

Step 9

When the installer is done downloading, locate it, then right-click on it and from the context menu that pops up, select “Run as administrator”. If User Account Control on your Windows machine prompts you with “Do you want to allow this app to make changes to your device?” message, click on the ‘Yes’ button. Wait a bit for the installation process to complete.

When you see the screen depicted in the above image, click on the “Activate Community Edition” option to end the process. Hurray! You now have UiPath Studio and the UiPath Robot service on your PC. You can close UiPath Studio at this point if you so choose. At this point, let us go back to the browser tab displaying our account (if you are confused, refer to the image below). In the event that you are logged out, kindly log in again. If you, for one reason or the other, closed your browser before this step, kindly access the page using this URL platform.uipath.com (you may want to bookmark it for future use) and log in again.

Step 10

Now click on SERVICES on your Menu area to open the Services page. If you entered a company name when registering your account, you will see a service bearing that name in the list of services displayed, else you will see a service bearing your firstname. A service represents an orchestrator instance under your account, and the robots your license gives you access to can be used across the services you have. For example, an organization can have a service to represent each of its branches or departments thereby allowing each branch or department respectively to have its own orchestrator instance which can be configured distinctly from the others.

Under the Action column, you should see four buttons: ‘Manage Users’, ‘View Usage’, ‘Edit Service’ and ‘Menu’. The last, represented by an ellipsis, offers you the option to disable or delete; please note that making changes affects existing connections. Notice that the name of my service is displayed as fofxAcademy, it is because I edited the name from fofxAcademyLimitedDefault (Eyeeww! what a clumsy name!).

Clicking on the name of my service, ‘fofxAcademy’ link, opens the orchestrator instance for the service in a new browser tab (see the image of the next step below).

Step 11

Your browser tab should look like the image below. Again, take note of the Menu area which is the left pane on the screen; we shall be accessing the menu items on this menu as we go along.

Step 12

Under the Management section of the menu area, click on MACHINES to open the Machines page. There is no data to show because no machine has been added to this service (orchestrator instance) yet. So you need to add your Windows PC to this instance, but to go about it we first need to know the name of your PC. How? Simply click on the Windows or Start button on your Taskbar (the taskbar is the bar at the bottom of your screen stretching from left to right, and it is usually of a black color; it houses your Windows or Start button on the left, and your date, system clock and other icons on the system tray on the right) and type “name” on your keyboard. You should see the “View your PC name” option on the list that shows, click on it.

On the window that opens, look for “Device Name” you should find it under the ‘Device Specifications’ section; select it and copy it (use Ctrl+C) into the clipboard memory and close the window.

Now back to the Machines page, click on the Add button, it is a blue circle having a white plus sign in it; two more blue circular buttons appear. Move your mouse pointer on each of them so a tooltip that displays their name. The one we want is “Standard Machine” which should be the middle button; click on it.

In the modal window that appears, paste your machine name you copied into memory and then click on the PROVISION button. If you have done everything right your machine name should now be visible on the machines list.

Step 13

Add a Robot.
Still under the Management section of the menu area, click on ROBOTS to open the Robots page. There is also no data to show because no robot has been added to your service (i.e. orchestrator instance) yet. Notice that this page has two tabs (see the image below), one for Robots (which is currently the active tab) and one for Environments. Notice also, that the Robots page also has Add and Refresh buttons.

Before we can add a robot, we need to know the “Domain\Username” of our account on our Windows PC. So click on the Start/Windows button and type cmd on your keyboard; you should see “Command Prompt” on the list that appears, click on it. In the Command Prompt window, type this command whoami (standing for “who am i”) and press the Enter key. Select and copy the response returned by the command and then return to the Robots page on your browser.

Click on the Add button and two buttons appear, move your mouse pointer on each one to locate the Standard Robot button, then click on it to open a modal window which has two tabs: Description and Settings. Under the Description tab, click on the Machine dropdown and from the list, select the machine name you added in the previous step. Then…

  • Enter in a name for your robot in the Name field.
  • In the Type field, you can select between five options: ‘StudioX’, ‘Studio’, ‘Attended’, ‘Unattended’ or ‘NonProduction’. Recall from Step 7, we mentioned that the community license gives you access to 2 studio (development), 2 attended and 1 unattended robot. For the purpose of this tutorial, let us go with the ‘Studio’ option (Select ‘StudioX’ if your UiPath Studio is set to StudioX mode).
  • Add a Description but this piece of information is optional.
  • Paste what you copied from Command Prompt in the Domain\Username field.
  • Lastly, enter in the password you can use to log into your Windows PC (you can leave it empty if you do not use a password to login to Windows); click on the ‘eye’ icon on the right of the Password field to make your password visible so you can be sure youtyped it correctly.

Still, in the modal window, click on the Settings tab and do the following…

  • Set the Logging Level ON and select Verbose from the dropdown.
  • If you so desire, you can set the Allow Development Logging slidder to ON too.
  • Finally, click on the CREATE button.

Observe that the newly created robot appears on the Robots list however, the Status column says our robot is disconnected, and a small black circle with an ‘x’ is displayed close to its name. Also, no value is given for it under the Environments columns. Time to add the robot to an environment of our choice.

Step 14

Add New Robot to Environment.
An environment can represent the departments or job/project categories in an organization. Click on the Environments tab to open the Environments page. Notice that there is one environment on the list, this “Demo Environment” comes with every new instance of Orchestrator along with a demo process. We shall let the demo environment be for now, but if at any other time you choose to remove it, simply click on the More Actions button, select “Remove” from the menu that appears; but first, you must detach every robot assigned to the environment, to do this, click on the More Actions button, take “Manage” from the menu that appears, then uncheck every robot assigned to the environment and click on the Update button.

To add a new environment, click on the blue and circular Add button to open the ‘Create Environment’ modal window. Type in a name for the environment, and if you so choose, add a description; then click on the CREATE button.

Another modal, “Manage Environment” modal window opens, it displays all the robots in your orchestrator instance so you can check the checkboxes of the robots you wish to select and when you are done, click on the UPDATE button. You should see the new environment on the list.

Step 15

Now that we have placed our robot in an environment (Note that a robot can belong to multiple environments), let us connect the robot to the Robot service on our PC. The first thing to do to copy the machine key of the machine we created earlier on.

So go to the Machines page, click on the More Actions button (a vertical ellipsis showing on the far right of the machine name) and from the menu that appears, select View to open the ‘View Machine’ modal window and then click on the Copy button to copy the machine key to clipboard memory. Close the modal and then open a text editor like Notepad and paste the machine key there.

Next, click on the Start/Windows button and type the word uipath. You should see UiPath Robot on the list that appears; click on it to launch UiPath Robot application on the system tray of your PC. Go to your system tray and click the Show Hidden Icons (^) button; you should see an icon having a white square with blue-colored Ui letters on it… right-click on the icon and from the menu that appears, select the ‘Orchestrator Settings’ option.

On the “Orchestrator Settings” dialog, if the Machine Name field is empty, type in the exact name of the machine you added on your Orchestrator instance. Also, type or paste the following as the case may be.

  • Orchestrator URL field: get this from the address bar of the browser tab displaying your Service page; it is usually in the form… https://platform.uipath.com/{default-service-name}/{service-name}/  You can see that mine is https://platform.uipath.com/fofxacademylimi/fofxAcademy/
  • Machine Key field: paste what you copied in the some few moments ago.
  • Robot Logging Level: choose ‘Verbose’ from the dropdown.
  • Finally, click on the Connect button

If you have followed these instructions carefully, the status of your device will change from Offline to Connected, Licensed.

Close the Orchestrator Settings window and return to the Orchestrator display on your browser. Open the Robots page by clicking on ROBOTS on the Menu area. Notice now that the Status of the robot reads Available while there is a small green circle close to the Username and the black circle that was close to the robot’s name some moments back, is now green too but with a white check inside it.

At Last...

In the course of this tutorial, you registered an account on UiPath’s platform and this gave you access to Orchestrator. You also installed UiPath Studio on your Windows PC. On your orchestrator instance, you registered your Windows machine name and then added a robot, assigning that robot to an environment before connecting orchestrator on your cloud account to your machine and the robot service in it. Henceforth, whenever you desire to log in to your orchestrator instance, simply go to https://platform.uipath.com on your browser.
Congratulations!!!

Next Steps...

  1. Register a UiPath Academy account and enroll for the Level 1 – Foundation Training – 2018.3 course
  2. Register and join UiPath Forum a platform for RPA enthusiasts and developers to ask questions, interact, and share knowledge.
  3. Sign up for free on UiPath Connect! an open network of passionate people and companies accelerating an automated world.
  4. Sign up for free too on UiPath Go! an RPA marketplace for Automation First era, and a one-stop shop for UiPath RPA components.

Afe Araromi is an Analyst at DipoleDIAMOND Ltd. He is also a web developer and a top-to-bottom business automation enthusiast with a focus on BPM (Business Process Management) and RPA (Robotic Process Automation) projects.