Getting started

Now that your environment is set up, we will see together how to run a robot in Robocorp Cloud, then how to change it locally and upload it back to the cloud using Robocorp Lab.

Our robot has already been set up for you in Robocorp Cloud: it's a robot that searches Google Images for cute cat pictures! 😺

1. Run the example process in Robocorp Cloud

In Robocorp Cloud, you will orchestrate your robots, monitor their execution and status, view their output artifacts, and more. Let's begin by logging into Robocorp Cloud and executing the example process to familiarize ourselves with the environment.

A process is a chain of steps that are executed in order. With processes, you can create multi-step workflows.

Once logged into Robocorp Cloud, select the workspace that has been automatically created for you: Robocorp Cloud select example workspace

Once you have selected the example workspace, execute the Robocorp Cloud Example Process by clicking the Start button on the right: Robocorp Cloud start example process

The process will execute in a virtual container in Robocorp Cloud, so you do not need to install anything at this point. The robot executes a Google image search, using cute cat picture as the search term, and stores the first image found.

Note that the browser will execute in a headless mode. You will not see a graphical user interface while the browser is running. You can click on the process while it is running to see how the run is progressing.

You can view the process outputs, such as the log, by clicking on Google Image Search after you've executed it in the Process run > Robot runs section.

Robocorp Cloud run example process

2. Download and Open the Google image search example robot in Robocorp Lab

Example robots are a great way to get started with creating software robots. You can execute them with minimal setup. The robots use the recommended file structure.

You can download the example robots directly from Robocorp Lab and start hacking away! The example robots also contain the robot that you just ran in Robocorp Cloud, so let's download them to see what it contains and how we can change it.

Robocorp Lab launcher

Click on the Download Example Robots button in the Robocorp Lab welcome screen.

Select a directory on your system where you want to store the example robots. In our case, we selected the Documents directory. Robocorp Lab Examples directory will be automatically created inside the selected directory when you click on Download examples button:

Robocorp Lab launcher - Download examples screen

Click on Download examples. After a loading screen, you will be taken back to the welcome screen. On the right, you will see a list of example robots. Click on the google-image-search example robot on to open it:

Robocorp Lab launcher - Open a robot

3. Execute the example robot in Robocorp Lab

A step is a reusable part of a process that can be executed separately from other steps.

The example robot will use a real browser to complete the example task. You will need Chrome installed on your system to be able to execute the example robot successfully.

The file structure of the example robot is presented on the left side of the Robocorp Lab screen.

Double-click the google-image-search.robot file to open it.

Click on the >> button in the toolbar and click Restart to run the software robot in Robocorp Lab.

You can also find the run command from the menu on the top of Robocorp Lab screen, by selecting Run -> Restart Kernel and Run All Cells....

You might see a firewall warning regarding python.exe when running the robot on Windows 10. It is safe to close the warning.

After a successful run, you should see a cat picture in the Notebook view in the editor. You can also view other robot outputs, such as the log file. You can find the log link at the bottom of the Notebook after running the robot.

Running the example robot in Robocorp Lab

4. Update the robot to search for "cute dog picture"

*** Variables ***
${GOOGLE_URL}     https://google.com/?hl=en
${SEARCH_TERM}    cute cat picture

In the .robot file, change the ${SEARCH_TERM} variable value cute cat picture to cute dog picture. Save the Notebook by pressing Ctrl+S (Windows) or Command-S (macOS). Press Ctrl+Shift+Enter (Windows) or Shift-Command-Enter (macOS) and click Restart to run your updated software robot.

The updated robot should now store a picture of a dog instead of a cat.

Robocorp Lab getting dog picture

5. Upload the updated robot to Robocorp Cloud

For this step to work, your Robocorp Lab installation should be linked to your Robocorp Cloud account, as described in the Environment Setup chapter of this guide.

Click on the Publish to Robocorp Cloud button on the top right corner:

Push to Robocorp Cloud button

A new window opens. Select the My Example Workspace workspace, then the Google Image Search robot, and click the Publish to Robocorp Cloud button. You will see a notification message once the upload is complete.

Push to Robocorp Cloud screen

6. Execute the updated robot in Robocorp Cloud

In Robocorp Cloud, navigate to your example workspace and select Processes from the top menu. Execute the Robocorp Cloud Example Process by clicking the Start button. The resulting image should have changed from a cat to a dog.

Conclusion

Congratulations, you completed the quickstart for new users!

There's a lot more to discover and learn:

  • To learn about developing software robots follow our Beginners' course, where we create a fully working robot from scratch.
  • Take a look at the examples section. The Simple robot is a good starting point if you are a beginner. The Web store order robot might interest you, if you already know the basics.
  • Join our developer Slack environment to keep in touch, discuss, and collaborate with other users! To receive your invitation just click on the Join our developer Slack link under the help menu in Robocorp Cloud:

Robocorp Cloud join slack button in Robocorp Cloud help menu

Good luck on your journey!