Configure o conector Python

Escreva e valide scripts Python personalizados e execute-os como parte de sua automação usando o conector Python em Design studio de RPA para desktop.

Antes de Iniciar

Certifique-se de ter instalado o plug-in Scripting no Design studio de RPA para desktop. Para instalar, consulte Gerencie plug-ins no Design studio de RPA para desktop.

Certifique-se de que uma versão Python esteja instalada em sua máquina, que faz parte das variáveis de ambiente. Para obter mais informações sobre variáveis de ambiente, consulte Definindo variáveis de ambiente .

Familiarize-se com as limitações do script Python. Para obter mais informações, consulte Limitações do script Python no conector Python.

Função necessária: nenhuma

Procedimento

1. No painel Caixa de ferramentas, navegue até Conectores > Python
2. Arraste o componente Python para os Objetos globais no painel Explorador de projetos.
3. Clique com o botão direito do mouse no conector Python.
4. Clique em Configurar.
   A janela Editor de scripts é exibida.

   Se o Python não estiver instalado em sua máquina, você encontrará uma mensagem de erro. Instale o Python e recarregue o projeto novamente.

5. Em Versão do Python selecione uma versão instalada ou disponível na máquina do usuário final, que possa executar a automação e que seja igual ou superior à versão de tempo de execução.
   Nota:

   Você exibe uma lista de versões do Python instaladas em sua máquina na lista Versão do Python.

   Python versões 2,7 e superior são compatíveis. Se o script não estiver validando ou executando, verifique se você está usando a versão 2,7 ou uma versão superior.

   Por padrão, a versão mais alta instalada do Python é selecionada.

   Se você selecionar a versão 2.x e tiver o Python 3.x instalado em sua máquina, a automação será executada, mas o script Python pode não ser executado. O script só será executado se for compatível com Python 3.x; caso contrário, você poderá encontrar um erro.

   Durante a execução da automação, se você selecionar uma versão específica, como 3.15.3, e tiver o Python 3.11.3 instalado em sua máquina, a automação não será executada e você encontrará um erro. Para prosseguir, selecione a mesma versão, 3.15.3 ou uma versão superior do Python.

   Você pode exibir a versão do Python que é usada para execução nos logs do Studio, que é criada no seu perfil de usuário em sua máquina.

   Figura 1. Painel de script e Versão Python no Editor de scripts

   

6. Insira o script personalizado no painel Script.
   Script de exemplo para conversão de temperatura e conselhos meteorológicos.

   
   def celsius_to_fahrenheit(temp_c: float) -> float:
       """
       Convert a temperature from Celsius to Fahrenheit.    
       Args:
           temp_c (float): Temperature in Celsius.
       Returns:
           float: Temperature in Fahrenheit.
       """
       return (temp_c * 9/5) + 32
   
   
   class WeatherAdvisor:
       """
       A simple class that provides weather advice based on temperature and conditions.
       """
   
       def give_advice(self, city: str, temperature_c: float, is_raining: bool, wind_speed: int) -> str:
           """
           Provide advice based on weather conditions.
           Args:
               city (str): The name of the city.
               temperature_c (float): Current temperature in Celsius.
               is_raining (bool): Whether it is raining.
               wind_speed (int): Wind speed in km/h.
           Returns:
               str: Weather advice message.
           """
           temp_f = celsius_to_fahrenheit(temperature_c)
   
           advice = f"In {city}, it is {temperature_c:.1f}°C ({temp_f:.1f}°F). "
   
           if is_raining:
               advice += "Take an umbrella. "
           else:
               advice += "No rain today. "
   
           if wind_speed > 30:
               advice += "It’s quite windy, be cautious!"
           else:
               advice += "Winds are calm."
   
           return advice
   
   
   # Example usage
   if __name__ == "__main__":
       advisor = WeatherAdvisor()
   
       message = advisor.give_advice(
           city="London",
           temperature_c=18.5,
           is_raining=True,
           wind_speed=25
       )
   
       print(message)
    

7. Selecione Validar .
   Se o script personalizado tiver erros, ele será exibido no painel Erros. Resolva os erros e selecione Validar para verificar se há erros novamente.
8. Clique em OK.
   Se você quiser salvar as mudanças, selecione Sim . O código é validado. Se você quiser descartar as mudanças, selecione Não .
9. Clique duas vezes no conector Python para expor os métodos no painel Explorador de objetos.
10. Arraste os métodos para a superfície de design.
    Para obter mais informações sobre métodos de conector Python, consulte Métodos do conector Python.

Conversão de temperatura e conselhos meteorológicos

Execute as etapas a seguir para executar a automação para conversão de temperatura e conselhos meteorológicos.

1. No painel Caixa de ferramentas, navegue até Geral > Variável.
2. Arraste Componente Variável para a superfície de design.
3. Clique duas vezes no componente Variável e defina esses parâmetros conforme mostrado na imagem.

   Figura 2. Parâmetros para Contêiner de variáveis

   

4. Clique duas vezes no conector Python nos Objetos globais.
5. Arraste o Método Executar do Explorador de objetos para projetar a superfície.
6. Selecione o componente e clique no ícone de configurações de método ( ou clique duas vezes na barra principal do componente.
7. Selecione Mostrar funções e selecione celsius_a_farenheit Função da lista Funções.
8. Selecione OK.
9. Arraste o Método Executar novamente do Explorador de objetos para projetar a superfície.
10. Selecione Mostrar funções e selecione celsius_a_farenheit Função da lista Funções.
11. Selecione WeatherAdvisor Opção da lista Classes.
12. Selecione give_advice Opção da lista Métodos.
13. Selecione OK.
14. Ligue as portas dos componentes conforme mostrado na imagem a seguir.

    Figura 3. Conexão de portas para Componente de variável e Métodos de execução

    

15. Para testar o componente, clique com o botão direito do mouse no componente Variável e selecione Executar a partir daqui .

    Figura 4. Exemplo de resultado para temperatura

    

    Figura 5. Exemplo de resultado para aconselhamento climático