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
• An app using UiPath^® Apps

Criação do fluxo de trabalho

The first step of this example is building the workflow in UiPath^® Studio. This is a simple workflow, consisting of a few arguments.

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	new 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 and Else as displayed below.

     Then

     1. Drag a Sequence inside the Then container.

     2. Adicione uma atividade Atribuir dentro do contêiner da Sequência.

     • Add filtered_SelectedItems in the To field.

     • Add (from r In in_SelectedItems.Select() Where r("Selected").Equals(true) Select r).CopyToDataTable in the Value field.

     3. Adicione uma atividade Mensagem de log abaixo da atividade Atribuir.

     • Set LogLevel to Info.

     • Add filtered_SelectedItems.ToString in the Message field.

     Else

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

     2. Adicione uma atividade Mensagem de log abaixo da atividade Atribuir.

     • Set LogLevel to Info.

     • Add "First run or empty" in the Message field.

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:

• Run your process before adding it to your app. If a process uses an object, Apps will check its Job History to automatically detect the schema/fields of that object.
• 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

After publishing the workflow build during the Building the workflow procedure to your Orchestrator, it's time to build the app itself.

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.