Bearbeitungsraster

Mit dem Bearbeitungsrastersteuerelement können Sie tabellarische Datensätze auflisten, bearbeiten, paginieren oder durchsuchen.

Demos

Bearbeitungsraster: Arbeiten mit Entitäten

Einleitung

Diese App zeigt, wie mit Entitäten über das Bearbeitungsrastersteuerelement gearbeitet wird.

Demo-App – selbst ausprobieren

Laden Sie die Demo-App von GitHub herunter

Vorschau der Demo-App in der Cloud

Demo-App – Verwendungsanweisungen

1. Laden Sie die ZIP-Datei mit der Demo-App herunter. Enthält:

   • Schema.json – Das Schema für die Entitäten, die die App verwendet

   • EditGridEntity_DemoApp.uiapp – Die UiPath^® Apps-Datei

2. Importieren Sie die Datei Schema.json in UiPath^® Data Service. Stellen Sie sicher, dass Sie sowohl Entitäten (Land und Mitarbeiter) als auch Auswahlsätze (Geschlecht und Fähigkeiten) importieren.
3. Füllen Sie Ihre Entitäten und Auswahlsätze mit Daten aus.
4. Erstellen Sie in UiPath^® Apps eine neue App und importieren Sie die heruntergeladene App.
5. Möglicherweise stellen Sie einige Fehler fest. Um sie zu beheben, ersetzen Sie die referenzierte Entität „Mitarbeiter“ durch diejenige, die Sie kürzlich in Schritt 2 importiert haben.
6. Zeigen Sie eine Vorschau der App an und interagieren Sie mit den Daten im Bearbeitungsraster.

Allgemein

• Datenquelle – Die Datenquelle, die Sie im Raster bearbeiten möchten. Sie müssen auf ein Objekt vom Typ AppsDataSource verweisen, z. B. eine Data Service-Entität oder einen Orchestrator-Prozess.

  Sobald Sie die Datenquelle abrufen, erkennt das Raster die Datenspalten automatisch. Wenn Sie auf das Symbol Mehr in jeder Spalte klicken, gelangen Sie zu den folgenden Eigenschaften:

  • Name – Der Anzeigename des Spalten-Headers.

  • Quelle – Das Feld der referenzierten Entität.

  • Ansicht im Bearbeitungsmodus – Legt fest, wie mit der Spalte interagiert wird:

    Ansichtsoption im Bearbeitungsmodus	Beschreibung
    Textfeld	Die Zellen in der Spalte verhalten sich wie ein Textfeldsteuerelement.
    Datumsauswahl	Die Zellen in der Spalte verhalten sich wie ein Datumsauswahlsteuerelement.
    Kontrollkästchen	Die Zellen in der Spalte verhalten sich wie ein Kontrollkästchensteuerelement.
    Dropdownmenü	Die Zellen in der Spalte verhalten sich wie ein Dropdown-Steuerelement.
    Mehrfachauswahl	Die Zellen in der Spalte verhalten sich wie ein Mehrfachauswahlsteuerelement.

  • Ausgeblendet – Bei „true“ wird die Spalte zur Laufzeit ausgeblendet.

  • Bearbeitbar – Bei „false“ wird der Inhalt der Spalte als schreibgeschützt markiert.

• Neue Spalte hinzufügen – Fügen Sie Ihren Daten neue Spalten hinzu, indem Sie auf das Plus-Symbol „+“ klicken.

• Ausgeblendet – Bei „true“ wird das Steuerelement zur Laufzeit ausgeblendet.

• Bearbeitbar – Bei „false“ wird das Steuerelement als schreibgeschützt markiert.

• Zeilen hinzufügen – Bei „true“ können App-Benutzer zur Runtime neue Zeilen hinzufügen. Bei „false“ können Benutzer keine neuen Zeilen hinzufügen.

• Zeilen löschen – Bei „true“ können App-Benutzer Zeilen löschen. Bei „false“ können Benutzer keine Zeilen löschen.

• Suchen – Bei „true“ wird eine integrierte Suchfunktion verfügbar gemacht.

Hinweis:

The Date Picker in the Edit Grid does not support editing column types which contain time values. Configure the column in your Data Service entity using the Exclude time option to avoid errors in your data.

If you need to include a column corresponding specifically to time, set the Edit mode view option of the column to the Textbox type.

Events

• Zeile ausgewählt – Konfigurieren Sie, was passieren soll, wenn eine Zeile ausgewählt wird.

• Zeile hinzugefügt – Konfigurieren Sie, was passiert, wenn eine Zeile hinzugefügt wird.

• Zeile geändert – Konfigurieren Sie, was passieren soll, wenn eine Zeile geändert wird.

• Zeile gelöscht – Konfigurieren Sie, was passiert, wenn eine Zeile gelöscht wird.

Hinweis:

Um auf die Fehler bei Aktualisierungs-, Hinzufügen- oder Bearbeitungsvorgängen zuzugreifen, verwenden Sie die folgende Syntax:

<PageName>.<ControlName>.<RuleName>.Error.Message

Beispiel: MainPage.EmployeeDetailsGrid.UpdateEntityRecord.Error.Message.

Hinweis:

Um ein In-/Out-Argument zum Bearbeiten des Bearbeitungsrasters zu verwenden, verwenden Sie die folgende Syntax:

Processes.ALLDATATYPES.out_datatable

Zum Beispiel:

• Um eine Zeile hinzuzufügen, verwenden Sie Processes.ALLDATATYPES.out_datatable.AddRow(MainPage.EditGrid.NewItem).
• Um eine Zeile zu löschen, verwenden Processes.ALLDATATYPES.out_datatable.DeleteRowAt(MainPage.EditGrid.RowIndex).
• Um eine Zeile zu aktualisieren, verwenden Processes.ALLDATATYPES.out_datatable.UpdateRowAt(MainPage.EditGrid.RowIndex, MainPage.EditGrid.SelectedItem).

Stil

• Ausrichtung von Steuerelementen – Erbt standardmäßig die übergeordnete Ausrichtung. Eine andere Ausrichtung als die übergeordnete kann festgelegt werden. Um die Standardausrichtung wiederherzustellen, heben Sie die Markierung der überschriebenen Optionen auf.

  Hinweis: Die Ausrichtung hängt vom Layout ab, das für das übergeordnete Element ausgewählt wurde (vertikal vs. horizontal).

• Hintergrundfarbe – Die Hintergrundfarbe für den Rasterheader und den Rastertext.

• Rahmen – Der Rahmen für das Steuerelement. Rahmenstärke, Farbe und Radius können konfiguriert werden.

• Schriftart – Die Schriftartattribute sowohl für den Spalten-Header als auch für den Spaltentext, z. B. Schriftfamilie, Größe, Farbe oder Stil (Fett, Kursiv und Unterstrichen). Standardmäßig erbt das Steuerelement die Schriftfamilie des unmittelbar übergeordneten Containers, der durch das Schlüsselwort „Geerbt“ angegeben wird.

• Seitenrand – Der Seitenrand des Steuerelements. Standardmäßig ist ein Seitenrand von 4px festgelegt. Die Randeigenschaften Oben/Unten und Links/Rechts werden kombiniert. Diese Eigenschaften können mit der Schaltfläche Link rechts neben dem Abschnitt Seitenrand getrennt werden.

• Größe – Die Breite und Höhe des Steuerelements. Standardmäßig ist die Größe auf auto festgelegt. Um Mindest- oder Höchstwerte festzulegen, klicken Sie auf das Drei-Punkte-Symbol (…). Wenn die Größe des Steuerelements kleiner ist als die Optionen, wird eine Bildlaufleiste angezeigt.

VB-Eigenschaften

VB-Eigenschaft	Datentyp	Beschreibung
SelectedItem	Apps.Controls.TabularInitClass	Verweist auf das aktuell ausgewählte Element im Steuerelement.
DataSource	Apps.Controls.ListSource(Of Apps.Controls.TabularInitClass)	Verweist auf die Datenquelle für die Werte innerhalb des Tabellensteuerelements.
NewItem	Apps.Controls.TabularInitClass	Verweist auf das Element, das mit der Option Zeile hinzufügen erstellt wird. Das Ereignis Zeile hinzugefügt verweist auf diese Eigenschaft.
Editable	Boolescher	Bestimmt, ob das Bearbeitungsraster bearbeitet werden kann.
AddRows	Boolescher	Bestimmt, ob dem Bearbeitungsraster Zeilen hinzugefügt werden können.
DeleteRows	Boolescher	Bestimmt, ob Zeilen aus dem Bearbeitungsraster gelöscht werden können.
RowIndex	Integer	Verweist auf den Index der Zeile für Aktualisierungs- und Löschvorgänge. Sollte für die Prozessintegration verwendet werden, bei der sich das gesamte Dataset im Arbeitsspeicher befindet.
Search	Boolescher	Aktiviert oder deaktiviert die Suchfunktion. Bei „true“ ist die Suche aktiviert.
Value	Apps.Controls.TabularInitClass	Der aktuell ausgewählte Wert des Steuerelements.
Hidden	Boolescher	Bei „true“ wird das Steuerelement zur Laufzeit ausgeblendet.
Disabled	Boolescher	Bei „true“ wird das Steuerelement zur Laufzeit deaktiviert.

Konvertieren komplexer Daten in AppsDataSource

So konvertieren Sie eine Datentabelle oder einen komplexen Datentyp in eine AppsDataSource: Speichern Sie die Datentabelle in einer Variablen und verwenden Sie dann die Methode .ToListSource, die Daten aus einer Datentabelle in eine AppsDataSource konvertiert.

1. Speichern Sie die Daten in einer Variablen vom Typ „Datentabelle“. Benennen Sie die Variable beispielsweise „dt“.
2. Verwenden Sie im Feld Datenquelle von Tabellensteuerelementen den folgenden Ausdruck:

   dt.ToListSource()

Im Allgemeinen können komplexe Objekte in AppsDataSource konvertiert werden, indem die Syntax verwendet wird:

Processes.ALLDATATYPES.out_datatable.ToListSource()

Verwenden von DataTable in Bearbeitungsrastersteuerelementen

Stellen Sie sicher, dass Sie bereits über ein Datentabellenobjekt in Ihrer App verfügen.

DataTables-Objekte können als Eingabe-, Ausgabe- oder Eingabe-/Ausgabeargumente eines Prozesses definiert werden. Um diese DataTable-Objekte zu verwenden, müssen Sie auf den Prozess verweisen, in dem sie als Argumente verwendet werden.

Hinweis:

Eine Datentabelle unterstützt nur Elementarwerte in einer Spalte. Komplexe Typargumente in einer Spalte funktionieren nicht in einer Datentabelle.

Angenommen, Sie haben einen Prozess mit dem Namen „Process_A“, der die DataTable-Objekte als Argumente hat:

Eingabeargumente	in_dt1
Ausgabeargumente	out_dt1
Ein-/Ausgabeargumente	inout_dt

Bearbeitungsraster

1. Navigieren Sie zur Registerkarte Allgemein Ihres Bearbeitungsrastersteuerelements .

2. Öffnen Sie im Feld Datenquelle des Steuerelements den Ausdrucks-Editor und schreiben Sie den folgenden Ausdruck:

   Processes.<process_name>.<datatable_output_argument>.ToListSource

   Zum Beispiel:

   Processes.Process_A.out_dt1.ToListSource

3. So führen Sie Vorgänge für die Zeilen der Datentabelle aus, z. B. Hinzufügen, Bearbeiten oder Löschen:

   1. Stellen Sie sicher, dass die Eigenschaften Bearbeitbar, Zeilen hinzufügen und Zeilen löschen auf true festgelegt sind.

      

   2. Wechseln Sie zur Registerkarte Ereignisse des Bearbeitungsrastersteuerelements und konfigurieren Sie dann die entsprechenden Regeln:

      1. Um Zeilen hinzuzufügen, klicken Sie auf Regel erstellen für Zeile hinzugefügt und verwenden Sie dann die Regel Wert festlegen:

         Festzulegendes Element	Processes.<process_name>.<datatable_output_parameter> Zum Beispiel: Processes.Process_A.out_dt1
         Wert	Processes.<process_name>.<datatable_output_parameter>.AddRow(MainPage.EditGrid.NewItem) Zum Beispiel: Processes.Process_A.out_dt1.AddRow(MainPage.EditGrid.NewItem)

      2. Um Zeilen zu löschen, klicken Sie auf Regel erstellen für Zeile gelöscht und verwenden Sie dann die Regel Wert festlegen:

         Festzulegendes Element	Processes.<process_name>.<datatable_output_parameter> Zum Beispiel: Processes.Process_A.out_dt1
         Wert	Processes.<process_name>.<datatable_output_parameter>.DeleteRowAt(MainPage.EditGrid.RowIndex) Zum Beispiel: Processes.Process_A.out_dt1.DeleteRowAt(MainPage.EditGrid.RowIndex)

      3. Um Zeilen zu ändern, klicken Sie auf Regel erstellen für geänderte Zeile und verwenden Sie dann die Regel Wert festlegen:

         Festzulegendes Element	Processes.<process_name>.<datatable_output_parameter> Zum Beispiel: Processes.Process_A.out_dt1
         Wert	Processes.<process_name>.<datatable_output_parameter>.UpdateRowAt(MainPage.EditGrid.RowIndex, MainPage.EditGrid.SelectedItem) Zum Beispiel: Processes.Process_A.out_dt1.UpdateRowAt(MainPage.EditGrid.RowIndex, MainPage.EditGrid.SelectedItem)

Verwendung von Entitäten mit Steuerelementen des Bearbeitungsrasters

Das folgende Beispiel zeigt, wie eine Entität an ein Bearbeitungsrastersteuerelement gebunden wird und dann CRUD-Vorgänge mithilfe des Steuerelements und der entitätsspezifischen Regeln ausgeführt wird.

Die verwendete Entität heißt „Mitarbeiter“ und verfügt über die folgenden Felder:

• Name

• Alter

• Geburtsdatum

• Geschlecht

• Team

• Beitrittsdatum

• IstVollzeit

• Fähigkeiten

Anzeigen von Entitätsdatensätzen

1. Erstellen Sie eine neue VB-App und fügen Sie dann die Entität „Mitarbeiter“ zur App hinzu.
2. Fügen Sie das Bearbeitungsrastersteuerelement zur App hinzu.
3. Verwenden Sie im Feld Datenquelle des Bearbeitungsrastersteuerelements den Abfragegenerator und wählen Sie die Entität „Mitarbeiter“ aus. Die Spalten des Steuerelements werden automatisch mit den Feldern der Entität aufgefüllt.
4. Stellen Sie für jede Spalte sicher, dass die Dropdownliste Ansicht des Bearbeitungsmodus auf den richtigen Datentyp wie folgt festgelegt ist:

   Option	Beschreibung
   Geburtsdatum	Datumsauswahl
   Alter	Textfeld
   Name	Textbox
   Geschlecht	Dropdownmenü
   Team	Dropdownmenü
   Beitrittsdatum	Datumsauswahl
   IstVollzeit	Kontrollkästchen
   Fähigkeiten	Mehrfachauswahl

   Geschlecht und Team sind Entitätsauswahlsätze. Wenn Sie in der Ansicht des Bearbeitungsmodus für diese Spalten Dropdownmenü auswählen, werden zwei neue Eigenschaften angezeigt: Listenquelle und Spalte.
5. So rufen Sie die Optionen in einem Auswahlsatz ab:
   1. Verwenden Sie im Feld Listenquelle die folgende Syntax

      GetChoiceSet("Choiceset Name")

      Beispielsweise sollte das Feld Listenquelle für die Spalten „Geschlecht“ und „Team“ Folgendes enthalten:

      • Geschlecht – GetChoiceSet("Gender")
      • Team – GetChoiceSet("Team")
   2. Geben Sie in das Feld Spalte "Name" ein.
      

   Fähigkeiten ist eine Auswahlmenge, die eine Mehrfachauswahl ermöglicht. Wenn Sie in der Ansicht des Bearbeitungsmodus für diese Spalten Mehrfachauswahl wählen, werden zwei neue Eigenschaften angezeigt: Listenquelle und Spalte.

6. Konfigurieren Sie die Spalte „Fähigkeiten“ wie bei „Geschlecht“ und „Team“.
7. Wechseln Sie zur Registerkarte Ereignis des Bearbeitungsrastersteuerelements.
8. Erstellen Sie für das Ereignis Zeile hinzugefügt die folgende Regel:
   1. Fügen Sie die Regel Entitätsdatensatz erstellen hinzu.
   2. Wählen Sie im Fenster In welcher Entität soll der Datensatz erstellt werden? die Entität „Mitarbeiter“ aus.
   3. Aktualisieren Sie im Feld Festzulegende Werte Folgendes:
      • Eigenschaft Name – MainPage.EditGrid.NewItem.Name
      • Eigenschaft Beitrittsdatum – MainPage.EditGrid.NewItem.Dateofjoining
      • Eigenschaft Alter – MainPage.EditGrid.NewItem.Age
      • Eigenschaft Geschlecht – MainPage.EditGrid.NewItem.Gender
      • Eigenschaft Team – MainPage.EditGrid.NewItem.Team
      • Eigenschaft IstVollzeit – MainPage.EditGrid.NewItem.Isfulltime
      • Eigenschaft Fähigkeit – MainPage.EditGrid.NewItem.Skills
9. Erstellen Sie für das Ereignis Zeile geändert die folgende Regel:
   1. Fügen Sie die Regel Erstellen des Entitätsdatensatzes hinzu.
   2. Wählen Sie im Fenster Der Datensatz welcher Entität soll aktualisiert werden? die Entität „Mitarbeiter“ aus.
   3. Schreiben Sie in die ID des Entitätsdatensatzes den folgenden Ausdruck:

      MainPage.EditGrid.SelectedItem.Id

   4. Aktualisieren Sie im Feld Festzulegende Werte Folgendes:
      • Eigenschaft Name – MainPage.EditGrid.SelectedItem.Name
      • Eigenschaft Beitrittsdatum – MainPage.EditGrid.SelectedItem.Dateofjoining
      • Eigenschaft Alter – MainPage.EditGrid.SelectedItem.Age
      • Eigenschaft Geschlecht – MainPage.EditGrid.SelectedItem.Gender
      • Eigenschaft Team – MainPage.EditGrid.SelectedItem.Team
      • Eigenschaft IstVollzeit – MainPage.EditGrid.SelectedItem.Isfulltime
      • Eigenschaft Fähigkeit – MainPage.EditGrid.SelectedItem.Skills
10. Erstellen Sie für das Ereignis Zeile gelöscht die folgende Regel:
    1. Fügen Sie die Regel Entitätsdatensatz löschen hinzu.
    2. Wählen Sie im Fenster Welcher Entitätsdatensatz soll gelöscht werden? die Entität „Mitarbeiter“ aus.
    3. Schreiben Sie in die ID des Entitätsdatensatzes den folgenden Ausdruck:

       MainPage.EditGrid.SelectedItem.Id

11. Zeigen Sie eine Vorschau Ihrer App an und interagieren Sie mit den verschiedenen Funktionen des Bearbeitungsrasters, z. B. Paginierung, Suche, Neue Zeile hinzufügen, Zeile aktualisieren oder Zeilen löschen.

Verwenden von Beziehungen in Bearbeitungsrastersteuerelementen

So verwenden Sie Entitätsfelder vom Typ „Beziehung“ in einem Steuerelement des Bearbeitungsrasters:

1. Legen Sie im Feld Ansicht im Bearbeitungsmodus die Beziehungsfelder als Dropdownmenü fest.
2. Verwenden Sie in der nachfolgenden Eigenschaft Listenquelle den folgenden Ausdruck:

   Fetch(of <entity_name>)(Nothing, Nothing, Nothing, Nothing, New ExpansionFieldOption(){addExpansionFieldOption("CreatedBy", New String(){"Id","Name"}), addExpansionFieldOption("UpdatedBy", New String(){"Id","Name"})})

3. Schreiben Sie "Name" in die nachfolgende Spalteneigenschaft.
4. Übergeben Sie in entitätsbezogenen Regeln, z. B. Create, Update oder Delete Entity Records die ID des Beziehungsfelds wie folgt:

   MainPage.EditGrid.SelectedItem.<entity_name>.Id