diff --git a/website/docs/getting_started/rpa.md b/website/docs/getting_started/rpa.md index c1ea9c37..b6422564 100644 --- a/website/docs/getting_started/rpa.md +++ b/website/docs/getting_started/rpa.md @@ -7,107 +7,56 @@ description: Use rcc to create a new RPA project import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; -:rocket: **Welcome!**
-You can find more explanations and guidance down below, but first, let's get you running a bot :runner: +## About Robotic Process Automation (RPA) -## Run your first robot -The scripts below enable you to get a robot setup and running from a selection of templates using a CLI tool called [RCC](https://github.com/robocorp/rcc#readme) +Robotic Process Automation (RPA) is similar to test automation on the technical level, but the mentality is different on the business and results side. In RPA, it is pretty standard that you are not running on a machine you control entirely, so your robot needs to be "self-sufficient" and isolated. Also, instead of finding and documenting places where robot execution fails or succeeds, the aim is always to succeed and get the result of the process. - - - -``` -curl -o rcc.exe https://downloads.robocorp.com/rcc/releases/latest/windows64/rcc.exe -rcc create example -cd example -..\rcc run -``` - - - -``` -brew install robocorp/tools/rcc -rcc create example -cd example -../rcc run -``` - - - -``` -curl -o rcc https://downloads.robocorp.com/rcc/releases/latest/linux64/rcc -chmod a+x rcc -rcc create example -cd example -../rcc run -``` - - +Isolation and repeatability are the other vital points in RPA. The bot needs to execute with minimal setup by IT people, and where governance is a thing, locking down your dependencies is a must-have feature. +With RCC environment caching and wrapping features, you can lock down your dependencies to the actual unique files. In RPA, you do not want loose dependency handling breaking your production bots. -The first run sets up the environment, so it takes a bit longer, but if you do the `rcc run` a second time, you'll see the power of RCC. +> Remember `pip install numpy` does **not** mean you will get the latest version;
+it means you are OK with getting whatever version you get :wink: -:rocket: With your bot running, you can now look deeper into what you just did and then jump on to editors to get cracking. +All this validates a separate getting started brief and a difference in tooling. The actual logic of calling out APIs and interacting with browsers and applications is still the same as in test automation. -## What is this RCC? +:rocket: So by this point, you should have run your first bot, have an editor / IDE up-n-and running, and have an idea of the slight differences between RPA and test automation using Robot Framework. +You are raring to go, so go ahead and check out the resources and libraries -part. -[RCC](https://github.com/robocorp/rcc#readme) is an open-source tool that handles everything essential around an RPA robot run on Windows, macOS, and Linux. With RCC, the machine running the robot does not even need Python installed. +## RPA resources to get started -So, if you look back into [the first robot you ran](/docs/getting_started/rpa#run-your-first-robot), you will see the following: -1. The environment your bot needs is defined in: [conda.yaml](https://github.com/robocorp/rcc/blob/master/docs/recipes.md#what-is-in-condayaml) -1. How your robot is executed is defined in: [robot.yaml](https://github.com/robocorp/rcc/blob/master/docs/recipes.md#what-is-in-robotyaml) -1. The logic of your bot is in Robot Framework (`.robot`) or Python (`.py`) -files... or both. +For the resources and libraries part you can check out the following pages: +* [RPA libraries](/docs/different_libraries/rpa) +* [How to find the right library](/docs/different_libraries/how_to_find_library) -With the above files [RCC](https://github.com/robocorp/rcc#readme) can set up an isolated environment and ensure your bot runs the same way every time.
-:point_right: Get rid of: "Works on my machine". +The main point to remember is that with Robot Framework and Python, there are just about no limits to what you can do. There are a ton of libraries out there, but you can also make your own. -> RCC has a lot of cool tricks, so once you've gotten started, it is worth [check out some more](https://github.com/robocorp/rcc/tree/master/docs#readme) +We always recommend giving back to the open-source community, as you usually get more back than you put in. -:rocket: So now you have your bot running and have a slight idea how you got there; what next?
-You need to see and edit your bot code to get it doing what you need, so head-on to the [Editor and IDEs](/docs/getting_started/rpa#editors-and-ides) +For example: +It is quite rare that the business value of an RPA process is in the library that interacts with an application or an API, so why not publish the connectivity part as open-source and get others to chip in on the maintenance and improvements? This way, you can focus more on the actual RPA problem. +* [Releasing your own library](/docs/extending_robot_framework/custom-libraries/releasing_your_own_libraries) +* [Help out with this documentation](/docs/about/contribute) +* Create example bots into the public repository and ping in the forums and Slacks ## Editors and IDEs There is no shortage of editors for Robot Framework and Python, but for RPA work, we limit the list to get you started. In the end, what you create is just Robot Framework and Python code, so you are not limited to the tools mentioned here. -### Automation Studio -If you are unfamiliar with coding and tools like VS Code, we'd recommend starting with a tool like [Automation Studio](https://robocorp.com/automation-studio). - -![](studio.gif) - -This kind of IDE enables you to start without worrying about syntax, environments, etc., right from the bat. You can still get quite far, and the tool allows you to see and edit on the code level. Automation Studio is also creating a robot just like the first RCC bot, so you can jump to other tools if you feel limited. - -> For the test automation people:
-Note that there is very little RPA specific about Automation Studio as it is just generating Robot Framework code.
-Even hard-boiled coders like to do things easy once in a while :wink: - ### Visual Studio Code If you are using [VS Code](https://code.visualstudio.com) or are looking for the complete feature set of developer tools, then the extensions are for you. :point_right: [Get VS Code here](https://code.visualstudio.com) -To get going with RPA development, you need two extensions: The extension for LSP and the RCC extension. - -### RCC extension for VS Code -This extension brings in the RCC functionality with command palette commands and a nice sidebar. - -:point_right: [Get Robocorp Code here](https://marketplace.visualstudio.com/items?itemName=robocorp.robocorp-code) - -![](vscode-code.gif) +To get going with RPA development, you need an extension that's call a language server protocl. Essentially it is a plug-in or extension that provides helpers within the IDE environment that assist you in writing your RPA scripts. ### Robot Framework LSP extensions for VS Code Language Server Protocol extensions bring in code completion, documentation, highlighting, etc., for your Robot Framework code. -There are options here, but **remember only to install one** as multiple LSP handlers will cause problems: +There are a few options here but we recommend Robot Code. It is important to **remember only to install one** as multiple extensions will cause problems: - - -:point_right: [Get Robot Framework LSP here](https://marketplace.visualstudio.com/items?itemName=robocorp.robotframework-lsp) - -![](vscode-lsp.gif) - - + :point_right: [Get Robot Code here](https://marketplace.visualstudio.com/items?itemName=d-biehl.robotcode) @@ -115,39 +64,3 @@ There are options here, but **remember only to install one** as multiple LSP han - -## About Robotic Process Automation (RPA) - -Robotic Process Automation (RPA) is similar to test automation on the technical level, but the mentality is different on the business and results side. In RPA, it is pretty standard that you are not running on a machine you control entirely, so your robot needs to be "self-sufficient" and isolated. Also, instead of finding and documenting places where robot execution fails or succeeds, the aim is always to succeed and get the result of the process. - -Isolation and repeatability are the other vital points in RPA. The bot needs to execute with minimal setup by IT people, and where governance is a thing, locking down your dependencies is a must-have feature. -With RCC environment caching and wrapping features, you can lock down your dependencies to the actual unique files. In RPA, you do not want loose dependency handling breaking your production bots. - -> Remember `pip install numpy` does **not** mean you will get the latest version;
-it means you are OK with getting whatever version you get :wink: - -All this validates a separate getting started brief and a difference in tooling. The actual logic of calling out APIs and interacting with browsers and applications is still the same as in test automation. - -:rocket: So by this point, you should have run your first bot, have an editor / IDE up-n-and running, and have an idea of the slight differences between RPA and test automation using Robot Framework. -You are raring to go, so go ahead and check out the resources and libraries -part. - -## RPA resources to get started - -For the resources and libraries part you can check out the following pages: -* [RPA libraries](/docs/different_libraries/rpa) -* [How to find the right library](/docs/different_libraries/how_to_find_library) -* Sources for RPA example in Robot Framework: - * [Robocorp Portal](https://robocorp.com/portal/) - -The main point to remember is that with Robot Framework and Python, there are just about no limits to what you can do. There are a ton of libraries out there, but you can also make your own. - -We always recommend giving back to the open-source community, as you usually get more back than you put in. - -For example: -It is quite rare that the business value of an RPA process is in the library that interacts with an application or an API, so why not publish the connectivity part as open-source and get others to chip in on the maintenance and improvements? This way, you can focus more on the actual RPA problem. -* [Releasing your own library](/docs/extending_robot_framework/custom-libraries/releasing_your_own_libraries) -* [Help out with this documentation](/docs/about/contribute) -* Create example bots into the public repository and ping in the forums and Slacks - - -