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

As default values, when creating the arguments. A short example can be found here. A default value provided for an argument in Studio can be overwritten in Orchestrator, both at process or job level.

Observação:

Os valores padrão fornecidos nos argumentos In no Studio não serão exibidos no Orchestrator, em nenhum nível.

Orchestrator

• At process level - in the Parameters tab of the View Process window, as explained here.

• At job level - in the Parameters tab of the Start Job window, as explained here.

• At trigger level - in the Parameters tab of the Add trigger window, as explained here.

  Observação:

  A value provided for an input parameter at process level in Orchestrator is kept when you update the package, as long as the new package version does not concern arguments' definition.

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

• At package level - to the /odata/Processes/UiPath.Server.Configuration.OData.SetArguments(key='key') endpoint;

• At process level - as a PATCH request to the /odata/Releases(Id) endpoint;

• At job level - as a POST request to the /odata/Jobs/UiPath.Server.Configuration.OData.StartJobs endpoint;

• At schedule level - as a POST request to the /odata/ProcessSchedules endpoint.

  Observação:

  For API calls, a maximum of 10,000 characters is accepted for the entire length of the JSON representation of input parameters, including argument names, all the escaped characters, spaces, brackets, and arguments values.

Exibindo Valores de Parâmetros

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

• No value - No value was provided for the parameter at process, job, schedule, or package level (in 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.

  

If input or output parameters values exist, they are displayed in the Job Details window. The input values are displayed in the aforementioned window in the following cases:

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

You can also view input and output parameters at package level, in the Package Versions window. For more information, see the Managing Packages.

Observação:

Os fluxos de trabalho que foram criados e publicados no Orchestrator antes da v2018.3 devem ser carregados novamente com um robô v2018.3 (ou posterior), para que os argumentos In e Out do arquivo Main.xaml possam ser exibidos.

Permissões

The following permissions are required in relation to input and output parameters in 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;
• at schedule level - Create and/or Edit on Schedules.