Frequently Asked Questions¶

This type of problem is more common in cases where there are blockages in the company's environment where the tools are being used. Here are some of the behaviors observed:

• Installation through the Wizard is stuck at 0%.
• Failed to log in to BotCity Studio.
• Authentication error when starting BotCity Runner.

The ideal solution in this case would be to ask the company's IT team for some access permissions. See more details about the URLs that require access in the section: Problems with blocking environments.

This problem usually occurs when the dependencies installation step is not done correctly. When running the code, a message is displayed regarding the installation of the packages: ModuleNotFoundError: No module named 'botcity’.

The first step is to ensure the same Python interpreter is used to install the dependencies and run the code. Something common is that the IDE creates a virtual environment for the project; if this virtual environment is used to install the dependencies but when running the system's "global" Python is being used, then this error will probably be thrown.

After ensuring the environment configuration is correct, use the same Python interpreter to install the dependencies: pip install --upgrade -r requirements.txt and run the code later.

A new account that is created on Maestro has full access to the platform's functionalities (trial) for a period of 30 days. After this period of 30 days, access to the platform continues in the same way; the only difference is some limitations and access to some specific resources.

After the trial period, it is no longer possible to use the following features:

• Credentials
• Audit
• Schedules
• BotCity Documents

Additionally, the workspace will also have some limitations on other features:

• Tasks - maximum of 10 tasks created per day
• Automations - maximum of 1 automation process on the platform
• Runners - maximum of 1 Desktop Runner on the platform

See more details about the difference between the plans and available resources by accessing this link.

A great alternative to have a first contact with the tools is to access the courses available on BotCity Academy.

Additionally, you can also access the tutorials available on the documentation portal:

• Developing your first Desktop bot
• Developing your first Web bot
• Orchestrating your automation processes

In sporadic situations, the Runner may seem stuck after pulling a new task for execution. In this situation, the execution is not started, and the Runner status remains as Executing task ... until the Runner is restarted.

Overall, what can cause this type of problem is the resources used by the previous execution, which have not been correctly finalized. Thus, when there is an attempt in the code to reaccess these resources, a conflict occurs because the operating system considers these resources already "in use".

A classic example is the use of web drivers in web automation. Without proper finishing, the web driver may continue to run even after the process is completed, causing this to affect the following executions.

A possible solution to this type of problem is to include treatments in the code to ensure that all resources allocated and used by the robot are finished correctly at the end of execution, even in cases where exceptions occur.

Following this good practice, every time the Runner performs this process, the environment will be "clean"; therefore, there will be no problems using specific resources.