Mapa de Dados

Este tutorial demonstra como criar e trabalhar com um componente de Mapa de Dados. Você aprenderá a passar dados para ele, atualizá-lo dinamicamente enquanto o formulário é exibido e extrair os dados. Neste exemplo, vamos nos concentrar nas taxas de moeda, usando um dicionário com pares de chave-valor representando diferentes moedas e seus valores equivalentes em USD. Ao interagir com os botões, você pode extrair e modificar as taxas de moeda em tempo real enquanto o formulário permanece visível.

1. Crie um novo formulário e adicione os seguintes componentes:

   1. Adicione um componente de Mapa de dados . Lembre-se do Nome da Propriedade que você atribui a ele, porque você o usará para extrair e atualizar dinamicamente os dados no componente.

      Neste exemplo, use dataMap como o Nome da Propriedade.

   2. Adicione um componente Botão para extrair os dados no componente. Defina a Ação do botão como Evento.

      Nomeie o botão Extract data.

   3. Adicione outro componente Botão para alterar os dados no componente. Defina a Ação do botão como Evento.

      Nomeie o botão Update value.

2. No fluxo de trabalho Principal , crie uma variável dicionário e adicione pares de chave-valor a ela.

   Neste exemplo, use os pares de chave-valor mostrados na imagem abaixo.

   

3. Adicione uma atividade Exibir formulário com a execução do fluxo de trabalho Continuar habilitada. Isso permite que o formulário seja exibido enquanto outros fluxos de trabalho de gatilho são executados simultaneamente.

   1. Na coleção Argumentos , passe a variável dicionário criada anteriormente para o componente Mapa de dados em seu formulário.

4. Adicione uma atividade Run Local Triggers para habilitar todos os gatilhos em seu projeto.

5. Criar um fluxo de trabalho de gatilho para atualizar os valores no Mapa de dados no runtime. Nomeie o fluxo de trabalho do gatilho fieldChangedTrigger.

   1. Adicione uma atividade de disparo de formulário e defina o Evento como o botão usado para atualizar os valores do Mapa de dados.

      Neste exemplo, defina o Evento como Update value clicked.

   2. Adicione uma atividade Get Form Values para extrair os valores atuais do Mapa de dados para uma variável de dicionário.

      Neste exemplo, salve os valores atuais em uma variável chamada dataMap2.

   3. Use uma atividade For Each para iterar por cada par chave-valor e atualizá-los com um valor específico.

   4. Dentro da atividade For Each , adicione uma atividade Assign para inicializar um novo par chave-valor com o qual você deseja atualizar o Mapa de dados.

      • Salve o par em uma variável chamada newItem usando o campo Salvar em .
      • Especifique o novo par chave-valor usando o campo Valor a salvar : New KeyValuePair(Of String, String)(currentKeyValuePairOfTextAndText.Key, currentKeyValuePairOfTextAndText.Value).

   5. Dentro da atividade For Each , adicione uma atividade If para modificar condicionalmente o par EUR . Configure a condição usando o objeto usado para iterar pelo Mapa de dados.

      Neste exemplo, configure a seguinte condição: currentKeyValuePairOfTextAndText.Key = "EUR"

   6. Dentro do corpo Then da atividade If , adicione uma atividade Assign para atualizar o valor newItem com o novo valor desejado.

      • Use o campo Salvar em para atribuir a variável newItem .
      • Use o campo Valor a ser salvo para fornecer o novo valor do par: CType(New KeyValuePair(Of String, String)("EUR", "1.19 USD"), KeyValuePair(Of String, String)).

   7. Adicione outra atividade Assign para mapear o novo valor de volta ao dicionário.

      • Use o campo Salvar em para atualizar o par chave-valor correspondente na variável dataMap2 .
      • Use o campo Valor a salvar para atribuir newItem.Value a dataMap2(newItem.Key).

      

   8. No final do fluxo de trabalho, adicione uma atividade Set Form Values para atualizar o Mapa de dados dentro do formulário com os valores modificados.

6. Criar um fluxo de trabalho de gatilho para extrair valores do Mapa de dados no runtime. Nomeie o fluxo de trabalho do gatilho extractDataTrigger.

   1. Adicione uma atividade Form trigger e defina o Evento como o botão usado para extração de dados.

      Neste exemplo, defina o evento como Extract data clicked.

   2. Adicione uma atividade Get Form Values para extrair os valores atuais do Mapa de dados no runtime. Salve o Mapa de dados em uma variável dicionário.

   3. Use uma atividade For Each para iterar por cada par chave-valor no Mapa de dados e enviá-los para o console.

      

   Na imagem animação abaixo, teste padrão para a atualização dinâmica dos valores no Mapa de Dados conforme você clica no botão Update value .

   

Exemplo de fluxo de trabalho

Para seguir as etapas e experimentar o tutorial você mesmo, consulte o projeto de exemplo aqui.