# Transferência de robôs do Windows para Linux

### Pontos-chave da transferência <a href="#docs-internal-guid-09d8e427-7fff-f1da-07db-e8df11993dcb" id="docs-internal-guid-09d8e427-7fff-f1da-07db-e8df11993dcb"></a>

Ao transferir um robô do Sherpa Designer no ambiente Windows para Linux, é necessário considerar alguns aspectos importantes. Se um bloco estiver presente no Sherpa Designer tanto para Windows quanto para Linux, ações adicionais para sua transferência não são necessárias. Os blocos funcionam no PowerShell, que opera da mesma forma em ambas as plataformas. Todas as classes e funcionalidades implementadas no robô para Windows são transferidas para o ambiente Linux sem alterações.

No entanto, é importante notar que objetos COM do Word e Excel não funcionarão em sistemas semelhantes ao Linux. Durante a transferência, é necessário verificar o "Painel de Propriedades" de todos os blocos relacionados ao Word e Excel e desmarcar a caixa de seleção: ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXdupCiNwd8eGStBBPAjzRQdwQtN3a523jwg63Jj2z4GMOtIQqBNPVc9mr5fB6XEmc31LPd09GyUwJgahmOGNi3DpVeLyLdh4H9MWUtWVipb6xSWAFq3o4YjYcfJrmEpDzILq_vaCg?key=TtSn8mN6zt9mZeisLOBH_ibs). Após o usuário desmarcar as caixas de seleção "Usar COM", os blocos do Word e Excel no ambiente Linux funcionarão corretamente.

### Diferenças nos caminhos dos arquivos

Ao trabalhar com Linux, é necessário considerar que os caminhos dos arquivos têm um formato diferente, utilizando a barra normal.

Exemplos de notações de separadores em caminhos de arquivos:

* Em sistemas semelhantes ao Linux, utiliza-se a barra normal: /home/user/documents/file.txt
* No Windows, utiliza-se a barra invertida: C:\Users\User\Documents\file.txt

No entanto, caminhos absolutos (como C: ou D:) não funcionarão. Utilize métodos padrão para determinar o diretório de trabalho atual, como \`\[Environment]::CurrentDirectory\`. Isso permitirá que você identifique com precisão onde seu código está localizado e ajudará a formar corretamente os caminhos relativos. Um caminho relativo indica a localização do arquivo em relação ao diretório de trabalho atual. Por exemplo, se o diretório atual for:\
/home/user, para acessar o arquivo file.txt no diretório documents, você pode usar: documents/file.txt.

### Gravação de seletores em navegadores e aplicativos

No que diz respeito à gravação de seletores, no Yandex Browser/Chromium no ambiente Linux, utiliza-se o mesmo plugin que no Windows. Basta instalar o plugin seguindo as instruções na seção [Instalação do plugin no Yandex Browser](https://docs.sherparpa.ru/o-platforme-sherpa-rpa/ustanovka-sherpa-rpa/ustanovka-sherpa-rpa-na-astra-linux#ustanovka-plagina-v-yandex-browser).

Se o aplicativo suportar a tecnologia at-spi (Assistive Technology Service Provider Interface), o robô funcionará com ele diretamente através de seletores, assim como no ambiente Windows.

### Funcionalidade dos robôs

Existem algumas limitações relacionadas aos Blocos do Sherpa Designer disponíveis no ambiente Linux:

| Categoria de Blocos    | Blocos não disponíveis no Linux                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Automação de UI        | <p>ClickOnText</p><p>CopyToClipboard</p><p>PasteFromClipboard</p><p>CollectData</p><p>SelectOption</p><p>DragAndDrop</p><p>HighlightElement</p><p>ClearCache</p><p>ControlCache</p><p>GetGridData</p>                                                                                                                                                                                                                                                                                                                                                               |
| Automação de Navegador | <p>CopyToClipboardInternet</p><p>PasteFromClipboardInternet</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| HTTP                   | <p>InternalBrowserRequest</p><p>GetYandexLinks</p><p>GetGoogleLinks</p><p>InternalAsyncBrowserGet</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Automação SAP          | <p>SAPCreateConnection</p><p>SAPCloseConnection</p><p>SAPConnectConnection</p><p>SAPSelectWindow</p><p>SAPClick</p><p>SAPPressEnter</p><p>SAPDoubleClick</p><p>SAPSelect</p><p>SAPUnSelect</p><p>SAPState</p><p>SAPCollapse</p><p>SAPExpand</p><p>SAPGetText</p><p>SAPSetText</p><p>SAPColumnCount</p><p>SAPRowCount</p><p>SAPCount</p><p>SAPSapEvent</p><p>SAPExportTable</p><p>SAPImportTable</p><p>SAPGetCellValue</p><p>SAPSetCellValue</p><p>SAPCurrentDate</p><p>SAPSelectRange</p><p>SAPElementExists</p><p>SAPPressF4</p><p>SAPHScroll</p><p>SAPVScroll</p> |
| Diálogos               | <p>ManLoop</p><p>MediaPlayer</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Automação do Excel     | FindTextExcel                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Automação do Outlook   | <p>GetOutlookMailMessages</p><p>SendOutlookMailMessage</p><p>ReSendOutlookMailMessage</p><p>SaveAttachmentsFromOutlookMessage</p><p>SaveMailFromOutlookMessage</p><p>GetOutlookFolders</p><p>MoveOutlookMessage</p><p>ExtractEmailFromOutlookMessage</p><p>LoadMsgFile</p><p>ReplyOutlookMailMessage</p><p>ChangePropertiesMailFromOutlookMessage</p>                                                                                                                                                                                                               |
| Área de Transferência  | <p>GetClipboard</p><p>SetClipboard</p><p>SetFilesClipboard</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Processo/Serviço       | <p>ListServices</p><p>StartService</p><p>StopService</p><p>SetServiceStartupType</p><p>GetWindowState</p><p>SetWindowState</p><p>SetWindowLanguage</p><p>SetWindowPosition</p><p>AttachApplication</p>                                                                                                                                                                                                                                                                                                                                                              |
| Automação de Terminal  | <p>TerminalConnectSession</p><p>TerminalCloseConnection</p><p>TerminalGetCursor</p><p>TerminalMoveCursor</p><p>TerminalGetTextPosition</p><p>TerminalGetFieldPosition</p><p>TerminalSetTextPosition</p><p>TerminalSetFieldPosition</p><p>TerminalGetField</p><p>TerminalSetField</p><p>TerminalGetScreenArea</p><p>TerminalSendKeys</p><p>TerminalSendControlKey</p><p>TerminalWaitTextPosition</p><p>TerminalWaitFieldPosition</p><p>TerminalGetFieldBetween</p><p>TerminalSetFieldBetween</p>                                                                     |
| Registro               | <p>ReadValueFromRegistry</p><p>WriteValueToRegistry</p><p>ListitemsFromRegistry</p><p>CreatePropertyInRegistry</p><p>RemovePropertyInRegistry</p><p>CreateHiveInRegistry</p><p>RemoveHiveInRegistry</p>                                                                                                                                                                                                                                                                                                                                                             |
| Automação 1C           | <p>1CCreateConnection</p><p>1CCloseConnection</p><p>1CExecuteQuery</p><p>1CExecuteCode</p><p>1CCollectData</p><p>1CTableCellClick</p><p>1CCheckboxControl</p>                                                                                                                                                                                                                                                                                                                                                                                                       |
| RDP                    | <p>RDPGenerateConnection</p><p>RDPCreateConnection</p><p>RDPConnectInstance</p><p>RDPCloseConnection</p><p>RDPDisconnectSession</p><p>RDPOperationFile</p><p>RDPRunScript</p>                                                                                                                                                                                                                                                                                                                                                                                       |
| Credenciais do Windows | <p>SetWindowsCredentials</p><p>GetWindowsCredentials</p><p>DeleteWindowsCredentials</p><p>GetCyberArkCredentials</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Aprendizado de Máquina | <p>RegressionTrain</p><p>RegressionPredict</p><p>ClassificationTrain</p><p>ClassificationPredict</p><p>ClusterTrain</p><p>ClusterPredict</p><p>AnomalydetectionTrain</p><p>AnomalydetectionPredict</p><p>AssistantGenerator</p>                                                                                                                                                                                                                                                                                                                                     |

Algumas funções, como o modo PiP (imagem em imagem), que permite aos usuários assistir a vídeos ou outros materiais visuais em uma pequena janela que permanece sobre outros aplicativos ou janelas, não estão disponíveis no Linux, pois é uma tecnologia da Microsoft.

### Template Engine no Linux

Em sistemas Linux, o bloco Template Engine funciona completamente. No entanto, se for necessário alterar o arquivo de template, isso só pode ser feito em um ambiente Windows. Isso se deve ao fato de que o Template Engine para Linux ainda está em desenvolvimento. No momento, alguns editores, como Word e ferramentas especializadas para designers, utilizam funções de edição que estão temporariamente indisponíveis no Linux. Após fazer alterações no arquivo de template em um ambiente Windows, será necessário criar ou atualizar um arquivo JSON para refletir essas alterações no Template Engine para Linux. Depois disso, o arquivo JSON é carregado no sistema usando comandos ou APIs específicas para o seu ambiente.

### Elementos da Página da Web

Ao transferir robôs, podem surgir problemas com a execução de seletores em imagens, pois o robô não encontrará as imagens.

No Sherpa Designer, são utilizados quatro métodos de reconhecimento de imagem (campo "Tipo de Comparação"):

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdHJVheyJgrSg2EIVsAmN-H_HZTpZ_y4JATYmdRvN_SjMlKUGJUELJi1oIMWwZhV33x8aHdCFD-mBBob-iuuso63cpuX_HBIdlVX8MEsqtF25UAUBBibibGa7755uTr6-UWUminww?key=TtSn8mN6zt9mZeisLOBH_ibs" alt=""><figcaption></figcaption></figure>

* SQDIFF (Diferença Quadrática) - o método calcula a diferença quadrática entre os pixels de duas imagens. Quanto menor o valor, maior a semelhança entre as imagens;
* CCORR (Correlação) - o método utiliza correlação para avaliar a semelhança entre as imagens. Produz os melhores resultados quando as imagens têm a mesma iluminação e contraste;
* CCOEFF (Coeficiente de Correlação) - o método baseado no coeficiente de correlação mede o grau em que duas imagens podem ser comparadas, normalizando os resultados por suas médias;
* NATIVE (padrão) - o método é pré-configurado e utilizado para comparações rápidas usando algoritmos integrados, baseados nas características da plataforma.

Se o método NATIVE não funcionar, recomenda-se usar SQDIFF, pois em sistemas semelhantes ao Linux não há um bitmap da imagem da janela disponível no Windows.

Também é importante que o local de gravação dos elementos de controle corresponda à resolução da tela e à profundidade de cores, caso contrário, as imagens podem ser escalonadas, e o robô não conseguirá encontrá-las.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sherparpa.ru/pt/sherpa-rpa/sherpa-designer/perenos-robotov-s-windows-na-linux.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.