GridColumn / GridColumns

Standardmäßig MainGrid und SubGrid rendere die Spalteneinstellung, die die aktive Dataverse-Ansicht zurückgibt. Die Komponente GridColumn ermöglicht es Ihnen, explizite Kontrolle zu übernehmen: Wenn ein oder mehrere GridColumn Kinder deklariert werden, rendert das Raster nur diese Spalten in der deklarierten Reihenfolge, und die serverseitige Projektion wird neu geschrieben, um genau die deklarierte Menge abzurufen. Nutzen Sie das, um ein Raster auf die Spalten zu verkleinern, die für eine bestimmte Seite wichtig sind, sie neu zu ordnen, Breite / Ausrichtung anzupassen, vorzuweisen Vorlagen pro Zelle oder Oberflächenspalten, die nicht in der zugrundeliegenden Ansicht sind – ohne die Dataverse-Ansicht selbst zu bearbeiten.

Grundlegende Verwendung

Bauteile in einen GridColumns Wrapper unter das Gitter werfenGridColumn. Deklarierte Spaltennamen überschreiben die <attribute> Projektion des FetchXML – der Server ruft die deklarierten Spalten ab, selbst wenn sie nicht in der Spaltenauswahl der aktiven Ansicht sind. Der Parameter TableName ist im deklarierten Modus optional: Wenn er weggelassen wird, wird der eigene TableName Parameter verwendet (es muss nicht in jeder Spalte wiederholt werden).

Ersetzen, nicht additiv

Das Deklarieren eines Children GridColumn schaltet das Gitter in den Ersetzmodus: Deklarierte Spalten sind die gesamte gerenderte Spaltenmenge UND die gesamte geholfene Spaltenmenge. Ansichtsspalten, die hier nicht deklariert sind, werden sowohl aus dem Render als auch aus der Serverprojektion entfernt. Wenn du die meisten View-Spalten mit ein oder zwei Anpassungen möchtest, verzichte komplett auf den Wrapper oder baue eine benutzerdefinierte Ansicht über CustomViewDefinitions.

Erforderliche Parameter

Jede Erklärung GridColumn lautet:

• ColumnName — Pflicht. Logischer Name der Spalte, die projiziert werden soll. Unterstützt Dot-Notation für aliasierte verknüpfte Entitäten-Spalten (primarycontactid.emailaddress1); das Alias muss bereits als a <link-entity> in der aktiven Ansicht von FetchXML existieren.
• TableName — Optional. Logischer Name der Tabelle, deren Metadaten diese Spalte beschreiben. Wenn es weggelassen wird, greift es auf das Raster TableName zurück – praktisch, um den Verbraucheraufschlag auf Ein-Tisch-Gittern kurz zu halten.

Spaltenbreite

Verwenden Sie Width es, um die gespeicherte Breite der Ansicht zu überschreiben. Akzeptiert jede CSS-Länge – Pixel ("150px"), Prozentsätze ("20%") oder "auto". Ohne eine explizite Breite fällt das Raster auf den metadatenbasierten Standard und die natürliche Verteilung der Tabelle zurück.

Trasse

Benutze sie, Align um die horizontale Ausrichtung sowohl für den Header als auch für die Körperzelle zu überschreiben. Numerische und Geld-Spalten werden standardmäßig (rechts ausgerichtet) über das metadatenbasierte Rückfallback-System gesetzt Align.End ; boolesche Spalten standardmäßig auf Align.Center. Stelle sie explizit ein, wenn du eine nicht-standardmäßige Ausrichtung möchtest oder eine benutzerdefinierte Vorlagenzelle konsistent ausrichten möchtest.

Linked-Entity-Spalten

Aliased Linked-Entity-Spalten verwenden eine Dot-Notation, die der FetchXML-Aliasierung der Ansicht entspricht. Der Alias muss bereits in der aktiven Ansicht als a <link-entity> definiert sein. Setzen TableName Sie auf die Quelltabelle , auf die der Alias zeigt, sodass die Metadaten-Auflösung auf der richtigen Entität landet. Der Server gibt diese Spalten mit ihrem für die Elterntabelle qualifizierten lokalisierten Anzeigenamen zurück (z. B. "Email (Primary Contact)") – keine clientseitige Humanisierung erforderlich.

Pro-Zell-Vorlagen

Liefern ChildContent , um jede Zelle mit individuellem Markup zu rendern. Die Vorlage erhält GridRowContext – ihre PrimaryRecord Eigenschaft stellt die vollständige TableRecord Zeilenzahl offen (getippte Spaltenwerte, formatierte Werte, Berechtigungen, alles). Nützlich für bedingte Formatierung (roter Text über einem Schwellenwert), Symbole, Abzeichen, Links oder alles andere, was man aus dem Zeilendatensatz bauen kann.

Die Zelle kennen: CellTemplate

ChildContentErhält die Zeile, die jede Zelle teilt, sodass sie nicht erkennen kann, welche Spalte sie rendert – oder welche Rastersuche darin übereinstimmt. Wenn die Zelle wissen muss, liefert stattdessen ein. CellTemplate Sie erhält : GridColumnCellContext, Rowdie Zelle ColumnNameMetadata , und mit Value, dann DisplayValue würde die eingebaute Zelle zeigen, und Highlight(text), was markiert, was die Suche genau wie die eingebauten Zellen entspricht – den Suchbegriff im Text, Such- und Auswahlspalten sowie den gesamten Wert einer Zahlen- oder Datumsspalte, deren Vergleich gilt. Sie hat Vorrang, ChildContent wenn beide gesetzt sind. In React erhält a bereits die valueZelle metadata , und searchText: für Text übergeben <Highlighter> searchText, und für eine Zahl oder Geldspalte prüfen Sie sie mit parseNumericSearch und matchesNumericSearch, und für eine Datumsspalte mit parseDateSearch und matchesDateSearch – die den formatierten Text der Zelle statt ihres Werts nimmt, da der Tag, an dem ein Datum liegt, von der Zeitzone abhängt, in der es angezeigt wird, und vom Ort aus useLocale() – wobei der Wert mit markiert wird<HighlightFull>, wenn sie übereinstimmen.cellRenderer

Elterndatensatz in SubGrids

Wenn das Gitter als ein SubGridmontiert wird, GridRowContext.ParentRecord wird der umgebende RecordContextDatensatz (der Elternteil des SubGrid) freigegeben. Greifen Sie in einer ChildContent Vorlage heran, wenn die bedingte Formatierung die Spalte einer Zeile mit der der Elternseite vergleichen muss – z. B. Kontakte markieren, deren industrycode nicht mit dem des Elternkontos übereinstimmt, oder Zeilen beschriften, die dem Eigentümer des Elternkontos gehören. null Auf einem eigenständigen MainGrid Konto, bei dem es keinen Elterndatensatz gibt.

Reaktionsparität

Die React-Seite bedeckt dieselbe Fläche wie cellRenderer's parentRecord Prop (CellRendererProps.parentRecord).

GridTemplateColumn

Verwenden GridTemplateColumn Sie, wenn eine Spalte nicht auf eine einzelne Dataverse-Spalte abgebildet ist – kombinieren Sie mehrere Rohwerte in einer Zelle, stellen Sie ein Statusabzeichen auf mehrere Felder dar oder geben Sie eine reine Dekorationsaktionszelle ohne jegliche Datenabhängigkeit aus. Im Gegensatz zu GridColumn, hat eine Template-Spalte kein ColumnName: deklariert die Spalten, über die der Renderer liest DependsOn , und das Framework fügt sie in die FetchXML-Projektion ein, sodass die Daten beim Ausführen Ihrer Vorlage landen ctx.Row.PrimaryRecord . Der erhält ChildContent ein GridTemplateColumnContext (verwende das Attribut Context="ctx" zur Bezeichnung), das die Zeile, den optionalen SubGrid-Elternteil und eine vorgefertigte DependsOnMetadata Abfrage enthält, die mit den von dir deklarierten Spaltennamen verbunden ist.

Eine Vorlagenspalte ist nicht Teil der Suche des Rasters, es sei denn, man sagt an, nach welcher Methode man suchen soll. SearchBy (searchBy in React) nennt die Spalten: Sie werden automatisch abgerufen, mit den üblichen Regeln des Rasters für ihren Typ abgeglichen (Text beginnt mit der Suche oder enthält sie nach einem Einführung *; eine Zahlen- oder Datumsspalte wird verglichen) und im Suchfeld unter dem Titel der Vorlagenspalte aufgeführt. Die Spalten in DependsOn werden nur abgerufen, nie durchsucht – ein Statuscode hinter einem Abzeichen sollte nicht mit dem übereinstimmen, was jemand eingibt. Um zu markieren, was die Suche so wie die eingebauten Zellen, sollte man den Text der Zelle in Blazor darstellen ctx.Highlight(text) oder den Renderer searchText in <Highlighter> React weitergeben; beides ist für eine Spalte ohne SearchByleer .

Template column vs. GridColumn ChildContent

GridColumn ChildContent passt weiterhin eine gebundene Spalte an – Sorting, Edit Dispatch und die Spaltenkopfzeile sind alle von ihrem einzigen ColumnName. Greifen Sie nur GridTemplateColumn , wenn es keine einzelne zugrundeliegende Spalte gibt, an die man binden kann (zusammengesetzte Zellen, dekorative Aktionszellen, Statusabzeichen, die mehrere Felder kombinieren). Die beiden zu mischen ist in Ordnung – sie verweben sich in deklarierter Reihenfolge über das Spaltenset des Gitters.

Dekorative Säulen (keine Datenabhängigkeit)

Überspringe DependsOn komplett, wenn die Zelle reine Dekorationsinhalte wie Inline-Buttons oder Icons rendert. Das Gerüst montiert die Spalte weiterhin an der richtigen Position in der gerenderten Tabelle; Für diese Spalte wird nichts zur Serverprojektion hinzugefügt.

Inline-Edit-Vorlagen

Kombinieren Sie den GridTemplateColumnLesemodus ChildContent eines mit an EditChildContent , um die Spalte bearbeitbar zu machen, wenn der Editierbar-Schalter des Rasters aktiviert ist. Die Bearbeitungsvorlage erhält einen GridTemplateColumnEditContext — denselben Zeilenkontext wie die Lesevorlage (editCtx.Row.PrimaryRecord, der optionale editCtx.Row.ParentRecord in einem SubGrid, die editCtx.DependsOnMetadata Nachschlage) sowie einen imperativen editCtx.SetValue(columnName, value) Helfer.

EditChildContent ausgelöst wird, wenn das Raster bearbeitbar ist (AllowEdit="true" auf dem Raster plus der Benutzer hat im Zahnradmenü der Werkzeugleiste den Wechselschalter umgelegt), die Zeile nicht auf 'Pending-Delete' festgelegt ist und die Spalte selbst eine Bearbeitungsvorlage deklariert. Dekorative Template-Spalten, die das weglassen EditChildContent , bleiben auch im Bearbeitungsmodus lesegeschützt – nützlich für Aktionsspalten, die immer dieselben Buttons darstellen sollten.

Muster 1 — Standard-Editoren für Drop-in

Der häufigste Fall: Die Zelle besteht aus mehreren gebundenen Spalten, und du möchtest dem Benutzer erlauben, jede einzelne zu bearbeiten. Fügen Sie die Matching <TextEdit> / <NumberEdit> / Editoren <ColumnEdit> hinein EditChildContent – das Framework kaskadierend den primären Datensatz und das Matching EditContextValidator der Zeile in diesen Scope, sodass sich die Editoren für Dirty Tracking und Validierung genau so registrieren, wie sie es unter einer Schranke <GridColumn>von ChildContent. Keine zusätzliche Verkabelung erforderlich.

Muster 2 — Benutzerdefiniertes Widget mit SetValue

Wenn die Editor-Oberfläche nicht 1:1 einer Dataverse-Spalte zugeordnet ist – also einem einzigen "First Last"-Textfeld, das in zwei Spalten geteilt wird, einem Schieberegler, der an mehrere Prozentfelder gebunden ist, einem benutzerdefinierten Date-Range-Picker, der Start + Ende schreibt – rendere du für jede betroffene Spalte deine eigene Eingabe und den Aufruf editCtx.SetValue(columnName, value) . Das Framework routet den Schreib an die richtige AliasedTableRecord (mit Punktnotation Link-Entitäten-Spaltennamen) und löst das ValueChanged Ereignis des Datensatzes aus, sodass Dirty-Tracking und die Warteschlange für ausstehende Aktualisierungen der Zeile die Änderung aufnehmen.

Validierung auf dem imperativen Weg

Standard-Editoren wurden automatisch in EditChildContent die Register der Zeilen EditContextValidator eingefügt und nehmen am Validate-before-Save-Gate des Frameworks teil. Der Pfad editCtx.SetValue umgeht diese Pipeline – das Framework kann keine Werte validieren, die nicht von einem registrierten Editor stammen. Wenn dein benutzerdefiniertes Widget Constraints erzwingen muss, führe sie im ValueChanged Callback aus, bevor du aufrufst SetValue, oder greife wenn möglich auf das Drop-in-Editor-Muster zurück.

In einem SubGrid

Alles, was auf MainGrid gilt, funktioniert auf identisch auf SubGrid. Kombinieren Sie deklarierte Spalten mit Symbolleisten-Buttons im Buttons Renderfragment für ein fokussiertes Inline-Editing-Erlebnis, das auf die zugehörige Sammlung des übergeordneten Datensatzes zugeschnitten ist – und kombinieren Sie sie mit @@context.ParentRecord In-Cell-Vorlagen für bedingte Formatierung, die auf dem übergeordneten SubGrid basiert.

Parameterreferenz

GridTemplateColumn-Parameter