Sobre as atividades do Integration Service

As atividades do Integration Service são projetadas para usar os conectores fornecidos pelo Integration Service para criar conexões com aplicativos de terceiros e facilitar a automatização deles. Isso permite uma integração mais rápida em plataformas de Software como um Serviço (SaaS).

Oferecemos suporte a uma ampla gama de aplicativos de terceiros e a lista continua crescendo. Esse guia contém todas as atividades criadas pela UiPath® para uso exclusivamente com o Integration Service. As atividades que usam conexões baseadas no Integration Service e em escopo são documentadas separadamente na guia de Atividades de produtividade (por exemplo, atividades do Microsoft OneDrive, Outlook ou Google) e na guia de Atividades de automação de TI (por exemplo, Amazon WebServices, Azure ou VMWare).

Trabalhando com atividades do Integration Service

Studio Web

No Studio Web, as atividades mais recentes estão disponíveis por padrão no navegador de atividades. Para obter mais informações, consulte Adicionando atividades a um projeto no guia do usuário do Studio Web.

Você também pode usar quaisquer gatilhos disponíveis para iniciar sua automação. Para obter detalhes, consulte Como iniciar uma automação.

Studio 2025.0.161

A partir do Studio 2025.0.161, Os conectores do Integration Service são listados diretamente na janela Gerenciar Pacotes . Isso facilita adicionar um conector e suas atividades a um projeto. Para obter detalhes, consulte Gerenciamento de conectores no guia do usuário do Studio.

Studio Desktop versão 2023.10 ou superior

A partir da versão 2023.10 do Studio Desktop, As atividades do Integration Service são entregues por meio do pacote UiPath.IntegrationService.Activities unificado.

Todas as atividades e gatilhos do Integration Service são listados no Studio, no painel Atividades, na seção Disponível.

Observação: certifique-se de habilitar o filtro Disponível no painel de Atividades.

Quando você adiciona qualquer atividade da lista disponível ao seu fluxo de trabalho, o pacote UiPath.IntegrationService.Activities é instalado automaticamente como uma dependência do projeto. Isso dá acesso a qualquer conector do Integration Service, incluindo seus conectores personalizados.

UiPath.IntegrationService.Activities é um pacote de atividades dinâmico, o que significa que você não tem que atualizá-lo manualmente. O pacote de atividades é atualizado automaticamente. Você sempre tem acesso aos conectores, gatilhos e atividades mais recentes, bem como à versão mais recente das atividades que já estiver usando.

Para saber mais, consulte Perguntas frequentes.

Dica:

Para acessar atividades de visualização, certifique-se de que os pacotes e atividades de visualização estejam habilitados. Se você estiver usando o Studio Web, consulte a seção Atividades e pacotes de visualização no Guia do usuário do Studio Web. Se você estiver usando o Studio Desktop, consulte a seção Gerenciamento de pacotes no Guia do usuário do Studio.

Versão do Studio 2023.4 ou inferior

Se você estiver usando o Studio 2023.4 ou inferior, use o Gerenciador de Pacotes para baixar pacotes de atividades individuais para conectores específicos. Para obter detalhes, consulte Gerenciamento de pacotes de atividades no guia do usuário do Studio Desktop.

Cada conector do Integration Service tem um pacote correspondente disponível UiPath.[ConnectorName].IntegrationService.Activities. Por exemplo, UiPath.Jira.IntegrationService.Activities.

Importante: para se beneficiar das atualizações mais recentes que trazemos para conectores e atividades do Integration Service, recomendamos que você atualize para o Studio 2023.10 ou superior.

Compatibilidade do projeto

Todas as atividades entregues por meio do pacote UiPath.IntegrationService.Activities unificado são compatíveis com Windows e multiplataforma.

	Windows - Legacy	Windows	Multiplataforma
UiPath.IntegrationService.Activities

As versões independentes dos pacotes de atividades do Integration Service também podem ser compatíveis com Windows – Legado. Verifique a documentação de pacote individual para ver a compatibilidade específica do projeto.

Limitações

Esta seção descreve limites no nível da plataforma e outras limitações que afetam todos os conectores e/ou atividades do Integration Service.

Limites de processamento de dados

O Integration Service tem um limite de plataforma para recuperar respostas. O limite máximo para o processamento de dados é de 8 MB. Isso significa que, para algumas chamadas de API, o número de respostas recuperadas pode exceder o limite de 8 MB e gerar a seguinte mensagem de erro: "Conteúdo da resposta muito grande".

Observação: o limite de 8 MB se aplica aos dados no formato JSON. Isso inclui casos em que os arquivos são enviados ou recebidos em um formato Base64 como parte dos dados JSON. Para arquivos tratados fora do JSON, o limite é de 1 GB.

Solução alternativa

Você pode realizar as seguintes etapas para garantir que o limite de processamento de dados não seja excedido:

• Ajuste o campo Max Records no nível da atividade para um número menor.
• Adicione filtros às suas consultas. O fornecimento dos parâmetros de filtro pode limitar o número de respostas.

Tempos limite da atividade

Há um tempo limite em toda a plataforma de 90 segundos para todas as atividades baseadas em conectores do Integration Service. Isso significa que se uma resposta não for recebida da API em até 90 segundos, a atividade falhará com um erro de tempo limite.

Códigos de erro

Esta seção apresenta uma visão geral dos códigos de erro que você pode encontrar usando atividades do pacote unificado de atividades do Integration Service.

Os códigos de erro estão no intervalo [1000, 3999], divididos em três categorias:

• Tempo de execução (RT) – [1000, 1999]
• Período de design (DT) - [2000, 2999]
• Geral (pode ocorrer tanto no tempo de execução quanto no tempo de design) – [3000, 3999]

Em mensagens de erro, os códigos são exibidos com o prefixo de categoria incluído, por exemplo, o campo “IdDaConta” é obrigatório. DAP-RT-1003.

Consulte a tabela a seguir para obter descrições de códigos de erro comuns.

Código de Erro	Categoria	Mensagem	Description
1001	Runtime	ProvedorDoServiço é nulo.	Não foi possível iniciar a atividade porque um serviço solicitado não foi carregado. Reinicie o Studio ou entre em contato com o suporte se o problema persistir.
1002	Runtime	O ID da conexão está vazio.	ID de conexão não encontrado na atividade.
1003	Runtime	O campo "{fieldName}" é obrigatório.	Um argumento de atividade obrigatório não tem um valor definido.
1005	Runtime	O serviço respondeu com um objeto que não corresponde ao tipo de resultado da atividade.	A resposta de uma chamada de API não se encaixa no esquema de saída definido no tempo de design.
1051	Runtime	Falha na execução do gatilho.	Uma chamada de API de gatilho retornou um código de falha ou a resposta está vazia.
1052	Runtime	A atividade Trigger não encontrou nenhuma correspondência.	O gatilho não detectou nenhum evento correspondente. Verifique as configurações de filtro ou tente executar em um ambiente ao vivo em vez do modo de depuração.
1101	Runtime	Falha na solicitação com o erro: {0}. Código de status: {1}.	Falha em uma chamada de API no Integration Service ou no lado do fornecedor.
1103	Runtime	Nenhuma mensagem personalizada, a mensagem de exceção subjacente é exibida.	Falha em uma solicitação de API durante a execução. Revise a mensagem de erro detalhada e verifique suas credenciais de rede ou API.
2000	Período de design	A solicitação da API dos metadados falhou e gerou o erro "{0}". Código de status: {1}.	A atividade não pôde buscar o esquema ou a configuração do serviço. Verifique a conexão de rede e as permissões e tente novamente.
2002	Período de design	O objeto "{0}" não está mais acessível na conexão atual. Verifique suas permissões ou escolha um objeto válido nesta conexão ou selecione uma conexão que inclua este objeto.	O objeto referenciado foi removido ou está inacessível com as credenciais atuais. Ele pode ter sido excluído, ou suas permissões foram alteradas. Atualize ou selecione/configure um objeto válido.
2050	Período de design	Falha na solicitação da API de consulta com o erro "{0}". Código de status: {1}.	Uma chamada de API falhava ao buscar dados para uma lista suspensa ou outro controle semelhante. Possíveis causas: O caminho construído ao invocar o serviço do elemento está incorreto. O endpoint do fornecedor está inativo ( normalmente retornando um código 502). Escopo ausente para chamar a API corretamente. A solicitação procurava uma chave não existente (retornando um código 404). Cabeçalho ausente (retornando um código 400).
2151	Período de design	Nomes de campo duplicados "{0}"	Há dois objetos com um nome semelhante, por exemplo ID e Id.
3000	Geral	Falha ao recuperar a conexão. Use outra conexão.	Uma chamada para o componente ConnectionClient falhou. Pode ter várias causas, por exemplo, uma conexão que se tornou inválida.
3004	Geral	Falha ao obter token de acesso do recurso {0}.	Normalmente indica que o sistema não pode recuperar um token de segurança válido, na maioria das vezes porque um token existente expirou.
3005	Geral	A conexão está desabilitada. Habilite a conexão para continuar.	A conexão está desabilitada e deve ser habilitada.