Datenraster

Dieses Tutorial enthält Schritt-für-Schritt-Anweisungen zum Erstellen und Verwenden einer Datenrasterkomponente. Sie erfahren, wie Sie Daten an das Datenraster übergeben, in Echtzeit aktualisieren und die Informationen extrahieren. In diesem Tutorial wird eine CSV-Datei für die Dateneingabe in das Datenraster verwendet.

Diese Automatisierung verwendet einen CSV-Datensatz der Kursteilnehmer und deren Prüfungsergebnisse und zeigt ihn in einem Formular an, in dem Sie die Prüfungsergebnisse und ihren entsprechenden Status („bestanden“ oder „fehlgeschlagen“) in Echtzeit aktualisieren können. Mit der Automatisierung können Sie außerdem die Extraktion des Datensatzes und die Ausgabe in der Konsole auslösen.

1. Erstellen Sie ein neues Formular. Nennen Sie es in diesem Beispiel DataGrid.

   1. Fügen Sie eine Datenrasterkomponente innerhalb des Formulars hinzu.

   2. Fügen Sie entsprechende Komponenten für jede Spalte in der CSV-Datei hinzu, die Sie in das Formular übergeben möchten.

      Fügen Sie in diesem Beispiel ein Textfeld (fullName), ein Kontrollkästchen (seniorYear) und eine Dropdownliste (examResults) hinzu.

      

      Hinweis:

      Beachten Sie, dass bei den Eigenschaftsnamen der Komponenten die Groß-/Kleinschreibung beachtet wird und dass sie genau mit den Spaltennamen in der CSV-Datei sowie mit den Spaltennamen der Datentabellen übereinstimmen sollten.

   3. Fügen Sie außerdem ein zusätzliches Textfeld innerhalb des Datenrasters mit dem Namen Status hinzu. Dieser wird für Formularaktualisierungen verwendet.

   4. Fügen Sie eine Schaltfläche außerhalb des Datenrasters hinzu. Diese Schaltfläche löst die Extraktion des Datenrasters aus .

      

2. Fügen Sie im Hauptworkflow die folgenden Aktivitäten hinzu und konfigurieren Sie sie:

   1. Read CSV – Gibt die CSV-Datei ein, die die Daten für das Datenraster enthält. Erstellen Sie eine Datentabellenvariable, um die CSV-Ausgabedatei zu speichern.

      Benennen Sie sie in diesem Beispiel dataGridDataTable.

   2. Gehen Sie zurück zu Ihrem Formular und legen Sie den Eigenschaftsnamen der Datenrasterkomponente als die Datentabellen-Variable fest, die Sie in Unterschritt a erstellt haben, in der Sie die CSV-Ausgabedatei speichern. Legen Sie in diesem Beispiel den Eigenschaftsnamen als dataGridDataTable fest.

   3. Formular anzeigen – Wählen Sie das Datenrasterformular aus und übergeben Sie die Daten aus der Datentabelle an das Datenraster.

   4. Fügen Sie im Argumentwörterbuch einen Eintrag für das dataGrid -Argument mit dem Typ System.Data.DataTable und der Richtung In hinzu und legen Sie den Wert auf dataGridDataTable fest.

      Schlüssel	Typ	Richtung	Wert
      dataGrid (der Eigenschaftsname des Datenrasters)	System.Data.DataTable	In	dataGridTable

   5. Lokale Trigger ausführen – Aktivieren Sie alle Trigger innerhalb des Projekts.

3. Erstellen Sie einen Trigger-Workflow mit dem Namen fieldChangedTrigger, der dafür verantwortlich ist, den Status eines Studenten entsprechend seinem Prüfungsergebnis als nicht bestanden oder bestanden festzulegen.

   1. Fügen Sie eine Aktivität Form Trigger hinzu und legen Sie das Ereignis fest, wenn sich das examResults -Feld ändert.

   2. Fügen Sie eine Aktivität Build Data Table hinzu, um eine DataTable zu erstellen, in der die DataGrid-Werte gespeichert werden, wenn der Trigger ausgelöst wird.

      Benennen Sie die Ausgabevariable als editedDataTable.

   3. Fügen Sie eine Get Form Values- Aktivität hinzu, um das Datenraster in der DataTable abzurufen, die Sie in Teilschritt b (editedDataTable) erstellt haben.

   4. Fügen Sie eine Aktivität For Each Row hinzu, um jedes Prüfungsergebnis zu durchlaufen und das Feld Status entsprechend festzulegen. Geben Sie die Datentabelle ein, die Sie in Unterschritt b (editedDataTable) erstellt haben, in das Feld Datentabelle .

   5. Fügen Sie im Textkörper der Aktivität For Each Row eine If- Aktivität hinzu und legen Sie die Bedingung als CurrentRow("examResults").ToString="f" fest.

      Beachten Sie, dass bei Werten die Groß-/Kleinschreibung beachtet wird. Dies ist der Grund, warum wir innerhalb der Bedingung einen Kleinbuchstaben „f“ anstatt einen Großbuchstaben „F“ verwendet haben.

      

   6. Fügen Sie im Then- Textkörper eine Assign- Aktivität hinzu, um den Status des Studenten als „fehlgeschlagen“ zuzuweisen, wenn sein Prüfungsergebnis F ist.

      Speichern unter	Zu speichernder Wert
      CurrentRow("status")	"failed"

   7. Fügen Sie im Else- Textkörper erneut eine Assign- Aktivität hinzu, diesmal für den Fall, dass der Status eines Studenten „bestanden“ ist, weil sein Prüfungsergebnis nicht F ist.

      Speichern unter	Zu speichernder Wert
      CurrentRow("status")	"passed"

   8. Fügen Sie außerhalb der Aktivität For Each Row eine Aktivität Set Form Values hinzu, um das aktualisierte Datenraster wieder an das Formular zu übergeben. Verwenden Sie im Feld Taste dataGrid mit dem Typ System.Data.DataTable und legen Sie den Wert auf editedDataTable fest.

      Schlüssel	Typ	Wert
      dataGrid	System.Data.DataTable	editedDataTable

4. Erstellen Sie einen Trigger-Workflow mit dem Namen angeklickt extrahieren, der für das Extrahieren des DataGrid und die Ausgabe als String im CSV-Format verantwortlich ist.

   1. Fügen Sie eine Aktivität Form Trigger hinzu und legen Sie das Ereignis fest, wenn auf die Schaltfläche extract geklickt wird.

   2. Fügen Sie eine Aktivität Get Form Values hinzu, um das Datenraster in eine Datentabelle zu extrahieren. Fügen Sie einen Eintrag im Argumentwörterbuch für dataGrid mit dem Typ System.Data.DataTable hinzu und legen Sie den Wert als output fest.

      dataGrid	System.Data.DataTable	output

   3. Fügen Sie eine Aktivität Output Data Table hinzu, um das extrahierte Datenraster als String im CSV-Format auszugeben. Geben Sie im Feld Datentabelle die Variable ein, die Sie zum Extrahieren des Datenrasters in Unterschritt b verwendet haben (output). Geben Sie eine String-Variable ein, die Sie in der Ausgabekonsole im Feld Text protokollieren werden

   4. Fügen Sie eine Log Message- Aktivität hinzu, um das extrahierte Datenraster auszugeben.

   5. Fügen Sie eine Aktivität Stop Local Triggers hinzu, um das Formular zu schließen und die Ausführung zu beenden, vorausgesetzt, Sie möchten nach dem Extrahieren nicht mit dem Formular interagieren.

   Die Abbildung unten zeigt das Ergebnis der Aktualisierung von Daten, während das Formular noch angezeigt wird.

   

Workflow-Beispiel

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