Trabalhar com Origem de dados e Vinculação de valor

Informações em segundo plano

Os campos Origem de dados e Vinculação de valor de um controle são de dois sentidos, o que significa que ambos podem atualizar os dados raiz que estão ligados àquele controle.

Para entender isso melhor, podemos usar um exemplo simples. Você pode tentar adicionar um rótulo e uma caixa de texto a um aplicativo e criar uma variável do aplicativo. Atribua a propriedade Vinculação de valor do controle da caixa de texto e a propriedade Texto do controle do rótulo à variável. Ao visualizar o aplicativo, observe que quando você altera o valor da sua caixa de texto, a variável do aplicativo também é atualizada. Por outro lado, a propriedade Texto é um campo de um só sentido, exibindo apenas dados que não podem ser atualizados.

Exemplo

Neste exemplo, vamos construir um aplicativo em que o usuário pode selecionar vários itens de uma lista personalizada que vem de um processo,

Para este exemplo, vamos construir o seguinte:

• Um processo de automação
• Um aplicativo usando UiPath^® Apps

Criação do fluxo de trabalho

A primeira etapa deste exemplo é criar o fluxo de trabalho no ^UiPath® Studio. Este é um fluxo de trabalho simples, que consiste em alguns argumentos.

1. Abra Studio e crie um novo Processo.

2. Crie os seguintes argumentos:

   Argument name	Direction	Tipo de argumento	Valor padrão
   out_DataTable	Out	TabelaDeDados	-
   in_SelectedItems	Em	TabelaDeDados	novo DataDable
   filtered_SelectedItems	Out	TabelaDeDados	-

3. Arraste uma Sequência para o Designer de fluxo de trabalho.

4. Adicione uma atividade Construir tabela de dados dentro do contêiner Sequência.

   • Adicione o argumento out_DataTable no campo DataTable.
   • Adicione uma coluna chamada Selecionada.

   • Configure a tabela como na figura abaixo:

     
     

     

     
     

5. Adicione uma atividade If abaixo da atividade Construir tabela de dados e siga as etapas abaixo para configurá-la.

   • Adicione in_SelectedItems.Rows.Count > 0 no campo Condição.

   • Configure Then e Else conforme exibido abaixo.

     Then

     1. Arraste uma Sequência para dentro do contêiner Then.

     2. Adicione uma atividade Assign dentro do contêiner Sequence.

     - Adicionar filtrados_SelectedItems no campo Para .

     - Adicionar (de r In_SelectedItems.Select() Onde r("Selecionado").Equals(true) Selecione r).CopyToDataTable no campo Valor .

     3. Adicione uma atividade Log Message abaixo da atividade Assign.
     - Defina LogLevel como Info.
     - Adicione filtered_SelectedItems.ToString no campo Mensagem .

     Else

     1. Arraste uma Sequence para dentro do contêiner Else.

     2. Adicione uma atividade Log Message abaixo da atividade Assign.

     - Defina LogLevel como Info.
     - Adicione "First run or empty" no campo Mensagem .

Resultado

No final, o fluxo de trabalho deve estar como o da figura abaixo.

Importante:

Se seu processo estiver usando um objeto *.NET complexo em sua entrada ou saída (p.ex., DataTable), o App Studio não saberá quais os campos daquele objeto são usados por padrão. Você consegue especificar isso de duas maneiras:

• Execute o processo, antes de adicioná-lo ao aplicativo. Se um processo usar um objeto, o Apps verificará o Histórico de trabalhos do objeto, a fim de detectar automaticamente o esquema/campos desse objeto.
• Especifique os campos do objeto manualmente para a entrada/saída do processo. Se o processo não tiver histórico de trabalho, então, depois de ter sido adicionado ao aplicativo, você deve especificar os campos manualmente, a fim de usá-los no aplicativo.

Os parâmetros adicionados manualmente a um processo, serão removidos se o processo for atualizado.

Criação do aplicativo

Após publicar o fluxo de trabalho durante o procedimento Criar o fluxo de trabalho no seu Orchestrator, é hora de construir o próprio aplicativo.

1. Crie um aplicativo novo.
2. Faça referência ao processo construído acima.
3. Adicione um controle Lista personalizada e um controle Tabela ao seu aplicativo, um ao lado do outro.
4. No campo Origem de dados da tabela, adicione Out: out_DataTable a partir do processo.
   
   

   

   
   
5. Adicione um controle Caixa de verificação e um controle Caixa de texto à lista personalizada e configure-os da seguinte maneira:
   • Adicione o item Out: Item da seção Out: out_DataTable do processo no campo Rótulo do controle da caixa de seleção.
   • Adicione o item Out: Selected da seção Out: out_DataTable do processo no campo Associação de valor do controle da caixa de seleção.
   • Adicione o item Out: Quantity da seção Out: out_DataTable do processo no campo Associação de valor do controle da caixa de texto.
6. Adicione um controle Botão e lhe atribua o nome Run. Configure a regra Clicando em da seguinte maneira:
   • Adicione uma regra Iniciar processo.
   • Adicione um nome no campo nome do trabalho e marque como Assistido.
   • Adicione in_SelectedItems e Out.out_DataTable no campo Substituição de entrada.
     
     

     

     
     
7. Adicione um recipiente abaixo do botão.
8. Adicione dois controles de Rótulo, um ao lado do outro.
   • Adicione o item filtered_SelectedItems.Item da seção Out: filtered_SelectedItems do processo no campo Texto do primeiro rótulo.
     • Adicione o item filtered_SelectedItems.Quantity da seção Out: filtered_SelectedItems do processo no campo Texto do primeiro rótulo.

Conclusão

Ao visualizar o aplicativo, você será conseguirá selecionar itens em uma lista personalizada que vem de um processo.

A chave deste exemplo é entender melhor a diferença entre Origem de dados, Vinculação de valor, e entrada:

• Origem de dados e Vinculação de valor têm dois sentidos. Isso significa que ambos podem atualizar os dados raiz que estão vinculados a um controle.
• A Substituição de entrada permite passar objetos de outras origens, como uma tabela de dados de um processo ou uma entidade do Data Service.