Invocando funções

Após implantada como um processo, uma função é executada como um trabalho do Orchestrator. Você pode invocá-lo a partir de várias superfícies. Uma função JavaScript que declara uma rota tem mais uma: ela também pode ser chamada diretamente sobre HTTP.

De uma tarefa de serviço do Maestro

Em um processo do Maestro, adicione uma Tarefa de serviço e associe-a à função implantada:

1. Selecione o pacote e o ponto de entrada.
2. Mapeie variáveis de processo para os campos Input da função.
3. Mapeie os campos Output da função de volta para as variáveis de processo.

Os esquemas de entrada e saída exportados de seus modelos Input/Output direcionam a interface gráfica da associação, então os campos digitados aparecem diretamente no painel de mapeamento.

De uma atividade Run Job no Studio

No Studio ou Studio Web, adicione a atividade Run Job e aponte-a para a função implantada. O mesmo esquema de entrada/saída exportado direciona o mapeamento de argumentos, de modo que os campos digitados aparecem diretamente nos painéis de entrada/saída da atividade.

A partir da API do Orchestrator

Inicie a função como um trabalho:

POST /orchestrator_/odata/Jobs/UiPath.Server.Configuration.OData.StartJobs

Passe o pacote ( release) e os argumentos de entrada no corpo da solicitação. O trabalho executa a função e retorna sua saída por meio do resultado do trabalho padrão.

De um gatilho de trabalho

Como uma função implantada é um processo do Orchestrator, ela pode ser iniciada por qualquer gatilho de trabalho — agendado, baseado em fila ou baseado em evento/webhook.

Por HTTP

Uma função JavaScript que declara um method e um path também é exposta como um gatilho HTTP do Orchestrator. Os chamadores o alcançam no URL do gatilho com um token de portador, e a plataforma passa a identidade do chamador para a função — que é o que permite que um aplicativo codificado use uma função como seu back-end sem nunca manter uma credencial no navegador.

A solicitação e a resposta são limitadas a essa superfície: cerca de 10.000 caracteres de entrada e cerca de 512 kB de saída. Um trabalho não tem esse limite, porque carrega grandes cargas como anexos — portanto, uma função que lida com bytes deve ser invocada como um trabalho mesmo quando também tem uma rota.

Essa superfície é específica para funções do JavaScript; uma função do Python é sempre invocada como um trabalho. Consulte Gatilhos HTTP e roteamento.

Observabilidade

Cada invocação é executada como um trabalho e é registrada no histórico de trabalhos do Orchestrator com identidade do chamador e carimbos de data/hora. Quando invocada a partir do Maestro, a execução também emite intervalos de trace — consulte Rastreamento e observabilidade.

Próximas Etapas

• Sobre funções — revise onde as funções se encaixam na plataforma.