Tipps für das Implementieren des JS Grid-Steuerelements
Letzte Änderung: Freitag, 24. Juni 2011
Gilt für: SharePoint Foundation 2010
Inhalt dieses Artikels
Controller
Filtern
Persistenz
Ausdrucken des Rasters
Anfügen an Ereignisse
Debugversionen von "JsGrid.js" und "JsGrid.Gantt.js"
Controller
Der Controller im JS Grid-Steuerelement weist an, wie Inhalt im Raster gerendert werden soll (d. h. welche Bereiche oder Spalten angezeigt werden sollen). Der Controller aktiviert die Datenquelle. Der Controller kann beziehungslose Zeilen behandeln, wobei Bearbeitungen zulässig sind, ohne dass alle Daten lokal verfügbar sind.
Sie können auch Formate im Controller definieren. Im folgenden Code wird das Format "TextRightAlign" von RegisterCellStyle definiert, durch das Spalten rechts ausgerichtet werden können.
<SharePoint:JSGrid ID="_grid" runat="server" />
<script type="text/javascript">
Type.registerNamespace("GridManager");
this.control;
GridManager = function () {
this.Init = function (jsGridControl, initialData, props) {
control = jsGridControl;
var dataSource = new SP.JsGrid.StaticDataSource(initialData);
var jsGridParams = dataSource.InitJsGridParams();
jsGridParams.styleManager.RegisterCellStyle('TextRightAlign', SP.JsGrid.Style.CreateStyle(SP.JsGrid.Style.Type.Cell, { textAlign: 'right' }));
jsGridControl.Init(jsGridParams);
}
};
</script>
Ein vollständiges Beispiel hierzu finden Sie unter Vorgehensweise: Erstellen eines einfachen JS-Rasters.
Filtern
Es folgt eine Liste mit Einstellungen, die zum Filtern von Inhalt hilfreich sein können:
Status ausgeblendeter/sichtbarer Spalten
Spaltenreihenfolge
Spaltenbreiten
Komplexer Filter
Gruppierung
Sortieren
Position der Teilerleiste
Persistenz
Der Begriff Persistenz bezieht sich auf das Beibehalten von Filter-, Gruppen-, Sortieren- und Ansichtsauswahleinstellungen in Benutzersitzungen. Persistenz ist ein Feature jedes Controllers.
Zu den Einstellungen, die nicht in mehreren Sitzungen beibehalten werden sollten, zählen Folgende:
AutoFilter: Persistente AutoFilter-Einstellungen können Benutzer verwirren, da sie möglicherweise nicht verstehen, warum ihre Ansichten keine Daten enthalten. Falls manuell konfiguriert, sind clientseitige Filter persistent.
Hierarchie: Das Dataset wird spontan erstellt, daher ist es schwierig, es persistent zu speichern. Die Einstellung Gliederungsebene anzeigen ist jedoch persistent. Mit dieser Einstellung wird das zuvor genannte Dataset in der Ansicht erstellt.
Die ausgewählte Zeile oder Spalte
.gif "Hinweis") Hinweis |
|---|
In Microsoft Office Project Server 2007 waren die meisten Einstellungen in Sitzungen persistent. Project Server 2010 lässt immer noch eine Auswahl von Persistenz pro Seite zu. Das Standardverhalten sollte sein, dass Einstellungen innerhalb der Benutzereinstellungen beibehalten werden, wenn nicht ein starker Grund dafür spricht, die Einstellungen nur in der Sitzung beizubehalten. |
Ausdrucken des Rasters
Beim Drucken lädt der Controller die Rasterdaten schreibgeschützt. Dies kann bei einem ausgelagerten Dataset sehr lange dauern. Am besten wird ein neues Browserfenster geöffnet. Das Drucken erfolgt dann über den Browser. Falls die Seite nicht die Benutzererwartungen erfüllt, kann der Benutzer das Druckfenster schließen, Spalten hinzufügen oder entfernen, zoomen und erneut auf Drucken klicken.
Anfügen an Ereignisse
In diesem Beispiel wird das Anfügen von benutzerdefiniertem Code an das OnCellEditComplete-Ereignis gezeigt.
<script type="text/javascript">
Type.registerNamespace("GridManager");
GridManager = function () {
this.Init = function (jsGridControl, initialData, props) {
control = jsGridControl;
var dataSource = new SP.JsGrid.StaticDataSource(initialData);
var jsGridParams = dataSource.InitJsGridParams();
// This event is triggered after the standard grid error checking.
jsGridControl.AttachEvent(SP.JsGrid.EventType.OnCellEditCompleted, GotHere);
jsGridControl.Init(jsGridParams);
}
};
function GotHere(obj) {
alert('Got Here, ' + obj.fieldKey);
}
</script>
Debugversionen von "JsGrid.js" und "JsGrid.Gantt.js"
Debugversionen von JsGrid.js und JsGrid.Gantt.js werden mit dem Produkt in der Regel in %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS installiert. Diese Dateien stellen wertvolle Informationen zum JS Grid-Steuerelement zur Verfügung.
Siehe auch
Aufgaben
Vorgehensweise: Erstellen eines einfachen JS-Rasters