DataGrid-Widget

Das DataGrid-Widget zeigt zur Laufzeit tabellarische Daten in einem Fenster eines InTouch-Fensters an. Die im Widget angezeigten Daten können vom Benutzer gefiltert werden.

Obwohl das Widget sowohl in InTouch HMI als auch in AVEVA OMI die gleichen Eigenschaften verwendet, verhalten sich das Laden von Daten und die Zeilenauswahl zur InTouch-Laufzeit unterschiedlich.

Das Widget umfasst auch eine Reihe visueller Eigenschaften, mit denen Sie das Erscheinungsbild des Widgets und seiner angezeigten tabellarischen Daten anpassen können.

Unterstützte Datenformate

Das DataGrid-Widget unterstützt die Datenformate JSON und CSV. Die Daten werden dem Widget als Zeichenfolge über die DataSource-Eigenschaft oder dynamisch zur Laufzeit zur Verfügung gestellt.

JSON-Beispiel

[

  {

    "Equipment Name": "Feed Pump P-101",

    "Equipment ID": "P-101",

    "Equipment Type": "Centrifugal Pump",

    "Area": "Tank Farm",

    "Status": "Running",

    "Last Maintenance Date": "2025-11-14",

    "Location City": "Houston",

    "State": "TX",

    "Zip": "77002"

  },

  {

    "Equipment Name": "Boiler B-201",

    "Equipment ID": "B-201",

    "Equipment Type": "Steam Boiler",

    "Area": "Utilities",

    "Status": "Online",

    "Last Maintenance Date": "2025-09-30",

    "Location City": "Baton Rouge",

    "State": "LA",

    "Zip": "70801"

  }

]

CSV-Beispiel

Equipment Name,Equipment ID,Equipment Type,Area,Status,Last Maintenance Date,Location City,State,Zip Feed Pump P-101,P-101,Centrifugal Pump,Tank Farm,Running,2025-11-14,Houston,TX,77002 Boiler B-201,B-201,Steam Boiler,Utilities,Online,2025-09-30,Baton Rouge,LA,70801

Daten zur Laufzeit filtern

Nach jeder Datenspalte, die im Raster angezeigt wird, kann gefiltert werden. Das Datenraster-Widget zeigt nur die Daten aus der Zeile an, deren Spaltenelement mit den Filterkriterien übereinstimmt, wenn der Filter angewendet wird.

Das folgende Beispiel zeigt tabellarische Daten vor und nach dem Anwenden eines Filters auf die Spalte Woche, um die Daten so zu filtern, dass nur Donnerstag angezeigt wird.

Wählen Sie das Filtersymbol  innerhalb jeder Spaltenüberschrift, um einen Dropdown-Bereich zur Angabe von Filterkriterien anzuzeigen.

Eigenschaften

Die folgende Tabelle enthält die Eigenschaften des DataGrid-Widgets. Alle Eigenschaften werden als dynamische Laufzeiteigenschaften verfügbar gemacht, in denen sie an einen Verweis auf einen ViewApp-Namensraum gebunden werden können, und zwar als:

• Attribut

• Objektattribute

• MyContent-Attribut

• Zusammengesetzter Ausdruck

  Datenraster-Widget-Eigenschaften	Beschreibung
  Typ	Legt das Format der Quelldaten-Zeichenfolgen fest. csv json
  AllowExport	Ermöglicht den Export der Daten in eine Datei. Der Standardwert lautet „True“.
  Datasource	Ruft die im Datenraster-Widget angezeigten JSON- oder CSV-Daten ab oder legt sie fest.
  ColumnDelimiter	Ruft das Trennzeichen für die separaten Feldwerte in der ausgewählten Rasterzeile ab oder legt es fest. Komma für CSV-Zeichenfolgen Vertikaler Pipe-Strich (|) für JSON-Zeichenfolgen
  SelectedRow	Legt fest, welche Zeichenfolge die Werte der ausgewählten Zeilenfelder enthalten.
  DateFieldFormat	Ruft das Datumsformat eines Datums ab oder legt es fest. Unterstützt alle Datumsformat-Zeichenfolgen.
  BackgroundColor	Hintergrundfarbe des Widgets.
  ExportFileName	Wenn AllowExport = True ist, wird hier der Name der exportierten Datei angezeigt.
  FilterMode	Ruft den Filtermodus des Rasters ab oder legt ihn fest, entweder Standard oder Checkliste.
  Farbe Vordergrund	Ruft die Textfarbe des Widgets ab oder legt sie fest.
  HeaderBackColor	Hintergrundfarbe des tabellarischen Headers, in dem die Spaltennamen erscheinen.
  HeaderForeColor	Textfarbe der Namen der Kopfspalten.
  SelectionBackColor	Hintergrundfarbe einer ausgewählten Zeile innerhalb des Rasters.
  SelectionForeColor	Textfarbe der ausgewählten Zeile innerhalb des Rasters.
  RowHoverBackColor	Hintergrundfarbe der Zeile im Raster, in der sich die Maus befindet.
  RowHoverForeColor	Textfarbe der Zeile im Raster, in der sich die Maus befindet.
  Schriftart	Name der Schriftfamilie, die vom Widget zur Anzeige von Text verwendet wird.
  Schriftgröße	Ruft die Schriftgröße in Pixel des im Datenraster-Widget angezeigten Textes ab oder legt diese fest.
  PageSize	Ruft die Anzahl der Datensätze ab, die gleichzeitig angezeigt werden, oder legt diese fest.

  Hinweis:
  Wenn Daten zur Laufzeit dynamisch geladen werden, kann die Auswahl einer Zeile im DataGrid-Widget dazu führen, dass das Raster auf die Daten aus der Entwurfsphase zurückgesetzt wird.
  Die Eigenschaft DateFieldFormat ist erforderlich, wird aber vom System nicht zur Laufzeit validiert.