- Introdução
- Trabalhando com Coded Apps
- Criação e implantação de Apps codificados
- Exemplo de Apps codificados
- Perguntas frequentes
- Apps codificados no Studio Web
- Apps de ação codificados
Perguntas frequentes
Perguntas frequentes sobre Coded Apps, incluindo solução de problemas de erros de acesso ao compartilhar links de aplicativos implantados e alterações do escopo do OAuth que não entram em vigor.
Compartilhamento e acesso
Por que um usuário recebe um erro "Usuário não existe em nenhuma organização". erro ao fazer login em um link de aplicativo codificado?
Esse erro aparece quando o usuário com o qual você compartilhou o link do aplicativo codificado não é membro da organização na qual o aplicativo codificado foi implantado.
Para resolvê-lo:
- Como o criador do aplicativo codificado ou um administrador da organização, convide o usuário para a organização onde o aplicativo está implantado.
- Como usuário convidado, aceite o convite e faça login nessa organização.
Assim que o usuário fizer parte da organização, ele poderá fazer login no aplicativo codificado.
Por que a autenticação falha após a reimplantação do aplicativo codificado se o nome da organização contém _?
Para organizações cujo nome contém um sublinhado, o aplicativo codificado é acessível nas formas de sublinhado e hifen do URL. A forma de hifen é recomendada porque sublinhados não são válidos em nomes de host por RFC 952 e proxies de rede ou firewalls que listam permissões por nome do host podem rejeitar o URL do sublinhado.
Quando um aplicativo é reimplantado, sua metatag uipath:redirect-uri usa a forma de hífen do nome do host. Se o aplicativo foi originalmente implantado usando a URL de sublinhado, acessá-lo por meio da URL de sublinhado após a reimplantação falha na autenticação, porque o URI de redirecionamento na metatag não corresponde mais ao host do URL.
Para resolvê-lo, use uma das seguintes opções:
- Acesse o aplicativo por meio do URL do hífen após a reimplantação.
- Defina o URI de redirecionamento dinamicamente no código do aplicativo, para que siga o URL do qual o aplicativo é servido. Para o padrão recomendado, consulte Introdução ao Apps codificados na documentação do SDK.
Autenticação e permissões
Por que um novo escopo não entra em vigor após eu concede-lo ao Aplicativo Externo?
O Apps usa os escopos de quando foi implantado. Atualizar a página não é suficiente para que os novos escopos entrem em vigor.
Sempre que um escopo for adicionado ou excluído dos Aplicativos Externos:
- Implante o aplicativo novamente.
- Se seu aplicativo listar escopos específicos, adicione os novos escopos à base de código do seu aplicativo e, em seguida, reconstrua e reimplante.
- Force o aplicativo a selecionar os novos escopos usando um dos seguintes métodos:
- Saia do aplicativo e faça logon novamente.
- Feche a guia do navegador e reabra o aplicativo.
Por que os comandos uip codedapp falham no Automation Cloud Dedicado?
A CLI instalada é mais recente que a versão do Apps executada no ambiente de produção dedicado. Instale a CLI 1.202.0 com o seguinte comando:
npm install -g @uipath/cli@1.202.0
npm install -g @uipath/cli@1.202.0
Após o Ambiente de produção dedicado ser atualizado para a versão do Apps datada de 24 de setembro de 2026, você poderá atualizar para uma versão posterior da CLI.
Publicação e instalação
Por que a publicação de um aplicativo de ação codificada falha com "O esquema de ação usa o mesmo nome de propriedade mais de uma vez"?
O esquema de ação usa um nome de propriedade mais de uma vez. Um nome de propriedade raiz pode ser usado apenas uma vez em inputs, outputs, inOuts e outcomes, e os nomes de subpropriedades devem ser exclusivos sob o mesmo pai. O erro nomeia cada duplicata e onde ela se repete, por exemplo, 'status' in inputs and outputs.
O mesmo erro falha na primeira instalação de uma solução que contém o aplicativo. A publicação de uma nova versão de um aplicativo existente e a atualização de uma solução não são afetados.
Para resolvê-lo:
- No esquema de ação, localize cada propriedade nomeada no erro.
- Renomeie as duplicatas. Se uma propriedade for lida e gravada pela tarefa, defina-a uma vez em vez
inOuts. - Atualize o código do aplicativo que lê ou grava as propriedades renomeadas.
- Publique o aplicativo ou instale a solução novamente.
Para obter as regras completas, consulte Nomes de propriedades do esquema de ação.
- Compartilhamento e acesso
- Por que um usuário recebe um erro "Usuário não existe em nenhuma organização". erro ao fazer login em um link de aplicativo codificado?
- Por que a autenticação falha após a reimplantação do aplicativo codificado se o nome da organização contém
_? - Autenticação e permissões
- Por que um novo escopo não entra em vigor após eu concede-lo ao Aplicativo Externo?
- Por que os comandos
uip codedappfalham no Automation Cloud Dedicado? - Publicação e instalação
- Por que a publicação de um aplicativo de ação codificada falha com "O esquema de ação usa o mesmo nome de propriedade mais de uma vez"?