Sobre argumentos de entrada e saída

Apresentamos os argumentos In e Out, aos quais você já está acostumado no Studio, como uma maneira de integrar perfeitamente as ferramentas que você usa, tais como várias DCMs ou BPMs. Isso significa que qualquer processo que você criar agora pode receber parâmetros de entrada por meio da API ou interface do Orchestrator, bem como retornar uma saída para todos os mencionados acima.Por último, mas não menos importante, este é um ponto de partida para a vinculação de processos. Essa capacidade de extensão ajuda você a integrar melhor a UiPath ao ecossistema da sua empresa.

Observação:

Apenas os argumentos In, Out e In/Out do .xaml marcado como Principal no Studio serão expostos a outros aplicativos.

Os argumentos são salvos em project.json de um projeto.

Em tempo de design, no Studio, a forma como você configura seu projeto para aceitar argumentos In ou Out, com ou sem valores padrão, permite que você os utilize em outros apps de terceiros ou no Orchestrator. Você só pode usar os parâmetros de entrada e saída no Orchestrator e em outros aplicativos de terceiros se tiver adicionado os argumentos correspondentes em seu projeto do Studio com antecedência. Caso nenhum argumento tenha sido adicionado no Studio, a seguinte mensagem será exibida: "Os parâmetros de entrada não estão definidos para esta versão.".

Os Argumentos In, Out, In/Out de um projeto se tornam parâmetros de entrada e saída quando publicados para o Orchestrator. Observe que, para os argumentos In/Out, dois parâmetros diferentes são criados e exibidos no Orchestrator, um de entrada e um de saída, com o mesmo nome.

Fornecendo Valores de Parâmetros

Os valores podem ser fornecidos para parâmetros de entrada, usando o Studio, o Orchestrator ou a Orchestrator API, como se segue:

Studio

Como valores padrão, ao criar os argumentos. Um breve exemplo pode ser encontrado aqui. Um valor padrão fornecido para um argumento no Studio pode ser substituído no Orchestrator, tanto no nível do processo quanto no nível do trabalho.

Observação: os valores-padrão fornecidos para argumentos In Studio não são exibidos no Orchestrator em qualquer nível.

Orchestrator

• No nível de processo: na guia Parâmetros da janela Visualizar Processo, como explicado aqui.
• No nível de trabalho: na guia Parâmetros da janela Iniciar Trabalho, como explicado aqui.

• No nível do agendamento: na guia Parâmetros da janela Adicionar Agendamento, como explicado aqui.

  Observação: um valor fornecido para um parâmetro de entrada no nível de processo no Orchestrator é mantido quando você atualiza o pacote, desde que a nova versão do pacote não esteja relacionada à definição dos argumentos.

Se você fornecer valores para os parâmetros de entrada no Orchestrator, observe que eles precisam ser fornecidos em um formato JSON. Alguns exemplos de como você pode fazer isso:

• String - O valor deve ser fornecido sem aspas, como string;
• Int32 - Forneça o valor como faria para qualquer inteiro, 11;
• Boolean – Dois botões de opção serão exibidos para ajudar você a selecionar true ou false;
• Double – Forneça o valor como um valor de ponto flutuante, como 3.5;
• DateTime - Forneça o valor como um JSON válido, como "2012-04-23T18:25:43.511Z";
• Array – Forneça valores como JSON válido, como [1, 1, 2, 3, 5, 8] ou ["firstString", "secondString"].
  Observação: todos os tipos de argumentos In podem ser usados, mas lembre-se de que apenas os primitivos serão validados pelo Orchestrator.

API do Orchestrator

• No nível do pacote - para o endpoint /odata/Processes/UiPath.Server.Configuration.OData.SetArguments(key='key');
• No nível do processo - como uma solicitação PATCH para o endpoint /odata/Releases(Id);
• No nível do trabalho - como uma solicitação POST para o endpoint /odata/Jobs/UiPath.Server.Configuration.OData.StartJobs;

• No nível do agendamento - como uma solicitação POST para o endpoint /odata/ProcessSchedules.

  Observação: para as chamadas de API, um máximo de 10.000 caracteres é aceito para o tamanho todo da representação JSON de parâmetros de entrada, incluindo nomes de argumentos, todos os caracteres escapados, espaços, parênteses e os valores de argumentos.

Exibindo Valores de Parâmetros

O valor de um parâmetro de entrada é marcado da seguinte forma:

• Sem valor: sem valor foi fornecido para o parâmetro no nível de processo, trabalho, agendamento ou pacote (no Studio).
• Herdado do pacote – Se o valor tiver sido fornecido por padrão no Studio. Esta mensagem será exibida na janela Argumentos de um pacote específico, além das janelas Visualizar Processo, Iniciar Trabalho e Adicionar Agendamento.

• Herdado do processo - Se o valor tiver sido fornecido no nível de processo (na janela Exibir processo). Essa mensagem é exibida na janela Iniciar trabalho e Adicionar agendamento. Na janela Exibir processo, o valor será exibido.

  
  

  

  
  

Se os valores dos parâmetros de entrada ou saída existem, eles são exibidos na janela Detalhes do Trabalho. Os valores de entrada são exibidos na janela mencionada acima nos seguintes casos:

• eles foram adicionados no nível de processo;
• eles foram adicionados no nível de trabalho.

Você também pode visualizar os parâmetros de entrada e saída no nível de pacote, na janela Versões do Pacote. Para obter mais informações, consulte o Gerenciamento de pacotes.

Observação: fluxos de trabalho criados e publicados para o Orchestrator antes de v2018.3 devem ser recarregados com um robô v2018.3 v2018.3 (ou posterior), para que os argumentos In e Out do arquivo Main.xaml possam ser exibidos.

Permissões

As seguintes permissões são necessárias em relação aos parâmetros de entrada e saída no Orchestrator:

• no nível do pacote - Exibir em Pacotes;
• no nível do processo - Exibir e Editar em Processos;
• no nível do trabalho - Criar em Trabalhos;
• no nível de agendamento: Criar e/ou Editar em Agendamentos.