Datenzuordnung

In diesem Tutorial wird veranschaulicht, wie Sie eine Data-Map-Komponente erstellen und damit arbeiten. Sie erfahren, wie Sie Daten übergeben, sie dynamisch aktualisieren, während das Formular angezeigt wird, und die Daten extrahieren. In diesem Beispiel konzentrieren wir uns auf Währungskurse und verwenden ein Wörterbuch mit Schlüssel-Wert-Paaren, die verschiedene Währungen darstellen, und deren Gegenwert in USD. Durch die Interaktion mit Schaltflächen können Sie die Währungskurse in Echtzeit extrahieren und ändern, während das Formular sichtbar bleibt.

1. Erstellen Sie ein neues Formular und fügen Sie die folgenden Komponenten hinzu:

   1. Fügen Sie eine Datenzuordnungskomponente hinzu. Merken Sie sich den Eigenschaftsnamen , den Sie ihm zuweisen, da Sie ihn verwenden, um die Daten in der Komponente zu extrahieren und dynamisch zu aktualisieren.

      Verwenden Sie in diesem Beispiel dataMap als Eigenschaftsnamen.

   2. Fügen Sie eine Schaltflächenkomponente hinzu, um die Daten in der Komponente zu extrahieren. Legen Sie die Aktion der Schaltfläche als Ereignis fest.

      Benennen Sie die Schaltfläche Extract data.

   3. Fügen Sie eine weitere Schaltflächenkomponente hinzu, um die Daten in der Komponente zu ändern. Legen Sie die Aktion der Schaltfläche als Ereignis fest.

      Benennen Sie die Schaltfläche Update value.

2. Erstellen Sie im Hauptworkflow eine Wörterbuchvariable und fügen Sie ihr Schlüssel-Wert-Paare hinzu.

   Verwenden Sie in diesem Beispiel die in der Abbildung unten gezeigten Schlüssel-Wert-Paare.

   

3. Fügen Sie eine Aktivität Show Form mit der Option Workflowausführung fortsetzen aktiviert hinzu. Dadurch kann das Formular angezeigt werden, während andere Trigger-Workflows gleichzeitig ausgeführt werden.

   1. Übergeben Sie in der Argumentsammlung die zuvor erstellte Wörterbuchvariable an die Datenzuordnungskomponente in Ihrem Formular.

4. Fügen Sie eine Aktivität Run Local Triggers hinzu, um alle Trigger in Ihrem Projekt zu aktivieren.

5. Erstellen Sie einen Trigger-Workflow zum Aktualisieren von Werten in der Datenzuordnung zur Laufzeit. Nennen Sie den Trigger-Workflow fieldChangedTrigger.

   1. Fügen Sie eine Form Trigger-Aktivität hinzu und legen Sie das Ereignis als Schaltfläche fest, die zum Aktualisieren der Datenzuordnungswerte verwendet wird.

      Legen Sie in diesem Beispiel das Ereignis auf Update value clicked fest.

   2. Fügen Sie eine Get Form Values- Aktivität hinzu, um die aktuellen Werte der Datenzuordnung in eine Wörterbuchvariable zu extrahieren.

      Speichern Sie in diesem Beispiel die aktuellen Werte in einer Variablen mit dem Namen dataMap2.

   3. Verwenden Sie eine For Each- Aktivität, um jedes Schlüssel-Wert-Paar zu durchlaufen und mit einem bestimmten Wert zu aktualisieren.

   4. Fügen Sie in der Aktivität „For Each“ eine Assign- Aktivität hinzu, um ein neues Schlüssel-Wert-Paar zu initialisieren, mit dem Sie die Datenzuordnung aktualisieren möchten.

      • Speichern Sie das Paar mit dem Feld Speichern in in einer Variablen namens newItem .
      • Geben Sie das neue Schlüssel-Wert-Paar mithilfe des Felds Zu speichernder Wert an : New KeyValuePair(Of String, String)(currentKeyValuePairOfTextAndText.Key, currentKeyValuePairOfTextAndText.Value).

   5. Fügen Sie in der Aktivität „For Each“ eine Aktivität If hinzu, um das Paar EUR bedingt zu ändern. Konfigurieren Sie die Bedingung mithilfe des Objekts, das zum Durchlaufen der Datenzuordnung verwendet wird.

      Konfigurieren Sie in diesem Beispiel die folgende Bedingung: currentKeyValuePairOfTextAndText.Key = "EUR"

   6. Fügen Sie im Then- Text der If- Aktivität eine Assign- Aktivität hinzu, um den newItem -Wert mit dem gewünschten neuen Wert zu aktualisieren.

      • Verwenden Sie das Feld Speichern unter , um die Variable newItem zuzuweisen.
      • Verwenden Sie das Feld Zu speichernder Wert , um den neuen Wert des Paars anzugeben: CType(New KeyValuePair(Of String, String)("EUR", "1.19 USD"), KeyValuePair(Of String, String)).

   7. Fügen Sie eine weitere Assign- Aktivität hinzu, um den neuen Wert wieder dem Wörterbuch zuzuordnen.

      • Verwenden Sie das Feld Speichern unter , um das entsprechende Schlüssel-Wert-Paar in der Variablen dataMap2 zu aktualisieren.
      • Verwenden Sie das Feld Zu speichernder Wert , um newItem.Value zu dataMap2(newItem.Key) zuzuweisen.

      

   8. Fügen Sie am Ende des Workflows eine Aktivität Set Form Values hinzu, um die Datenzuordnung innerhalb des Formulars mit den geänderten Werten zu aktualisieren.

6. Erstellen Sie einen Trigger-Workflow, um Werte aus der Datenzuordnung zur Laufzeit zu extrahieren. Nennen Sie den Trigger-Workflow extractDataTrigger.

   1. Fügen Sie eine Aktivität Form Trigger hinzu und legen Sie das Ereignis als Schaltfläche für die Datenextraktion fest.

      Legen Sie in diesem Beispiel das Ereignis auf Extract data clicked fest.

   2. Fügen Sie eine Aktivität Get Form Values hinzu, um die aktuellen Werte der Datenzuordnung zur Laufzeit zu extrahieren. Speichern Sie die Datenzuordnung in einer Wörterbuchvariablen.

   3. Verwenden Sie eine For Each- Aktivität, um jedes Schlüssel-Wert-Paar in der Datenzuordnung zu durchlaufen und in der Konsole auszugeben.

      

   Im animierten Bild unten sehen Sie die dynamische Aktualisierung von Werten innerhalb der Datenzuordnung, während Sie auf die Schaltfläche Update value klicken.

   

Workflow-Beispiel

Um die Schritte auszuführen und das Tutorial selbst auszuprobieren, sehen Sie sich das Beispielprojekt hier an .