Elemente zur Definition von Daten
Gilt für: SharePoint 2016-| SharePoint Foundation 2013 | SharePoint Online-| SharePoint Server 2013
CAML (Collaborative Application Markup Language) weist zwei Hauptelementtypen auf: einen Typ für das Rendern von Seiten und einen Typ für das Rendern von Feldern und die Schemadefinition. Die CAML-Elemente zum Rendern von Feldern dienen zum Rendern einzelner Feldwerte. Diese können in Feldtypdefinitionen oder, allgemeiner, in FldTypes.xml unter \\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATES\XMLangezeigt werden.
Feldrendering und Schemadefinition
Ein Feld ist eine Spalte oder ein Attribut mit Informationen, die ein Benutzer einer Liste hinzufügen kann. Jede Liste auf einer Website, die auf Microsoft SharePoint Foundation basiert, enthält Metadaten, die in der Datenbank gespeichert sind. Das Format des Schemas ist eine XML-Struktur wie die folgende:
<Fields>
<Field Type="Counter" Name="ID"/>
...other field definitions...
</Fields>
Um die Implementierung der verschiedenen Feldtypen zu vereinfachen und ein höheres Maß an Flexibilität beim Rendern der verschiedenen Felder zu ermöglichen, enthält FldTypes.xml Informationen zum Rendern und Verhalten der einzelnen Feldtypen. Das Field-Element rendert je nach Datentyp des betreffenden Felds unterschiedliche HTML-Code und FldTypes.xml definiert die Datentypen und Renderingmuster für jede Art von Feld. In der folgenden Tabelle ist das in dieser Datei verwendete Schema dargestellt.
| Name | Datentyp | Beschreibung |
|---|---|---|
| Column2Suffix |
Text |
Enthält Text zum Anfügen an den Basisspaltennamen, um ColumnName2 von ColumnName abzuleiten (für zweispaltige Felder wie URL). |
| DisplayPattern |
Hinweis |
Enthält die HTML-Vorlage zum Rendern des Felds im Anzeigemodus einer Ansicht oder eines Formulars. |
| EditPattern |
Hinweis |
Enthält die HTML-Vorlage zum Generieren des Formularsteuerelements Bearbeiten zum Bearbeiten des Felds. |
| HeaderPattern |
Hinweis |
Enthält die HTML-Vorlage zum Anzeigen der Überschrift einer Tabellenansichtsspalte. |
| InternalType |
Text |
Bestimmt sowohl das Verhalten des Column-Elements beim Rendern von Daten aus der SharePoint Foundation-Datenbank als auch die Art und Weise, wie Daten in die Datenbank zurückgesetzt werden. Kann einen der folgenden Werte haben: Text, Note, Number, Currency, Integer, Boolean, DateTime, Threading, Lookup, Choice, URL, Counter oder DisplayOnly. Beachten Sie, dass es für den Feldtyp DisplayOnly keine eigene Speichermöglichkeit gibt. |
| Name |
Text |
Enthält den Namen des internen Datentyps, auf den in einem Type-Attribut des Field-Elements verwiesen wird: <Field Type="Name"/>. Beispiele sind Text, Notiz, Zahl usw. |
| NewPattern |
Hinweis |
Enthält die HTML-Vorlage zum Generieren des Formulars Neu zum Bearbeiten des Ausgangswerts eines Felds. |
| PreviewDisplayPattern |
Hinweis |
Gibt an, wie Felder gerendert werden, wenn ein Anzeigeformular in Microsoft SharePoint Designer bearbeitet wird. |
| PreviewEditPattern |
Hinweis |
Gibt an, wie Felder gerendert werden, wenn ein Bearbeitungsformular in Microsoft SharePoint Designer bearbeitet wird. |
| PreviewNewPattern |
Hinweis |
Gibt an, wie Felder gerendert werden, wenn ein neues Formular in Microsoft SharePoint Designer bearbeitet wird. |
| Sortierbar |
Text |
Gibt an, ob ein Feld sortiert werden kann. Kann TRUE oder FALSE sein. |
| TypeName |
Text |
Gibt einen Namen in der Definition eines Feldtyps an. |
| SQLType |
Text |
Bestimmt den zugrunde liegenden SQL-Datentyp für ein bestimmtes Feld. Beispiele sind nvarchar(255), Memo, Integer und Float. Dient zum Generieren des entsprechenden SQL-Codes (CREATE TABLE) zum Erstellen eines Felds dieses Typs. |
| SQLType2 |
Text |
Gibt, falls nicht leer, den Typ einer sekundären Spalte an, die für das aktuelle Feld erstellt werden soll (ein Beispiel finden Sie unter dem Feldtyp URL). |
Anzeigemodi und Anzeigemuster
Jeder Anzeigemodus (Anzeige, Bearbeitung und Neu) enthält eine Definition, wie die einzelnen Felddatentypen gerendert werden, die von SharePoint Foundation unterstützt werden.
Für jeden Anzeigemodus gibt es ein Anzeigemuster bzw. einen CAML-Renderausdruck. Einige CAML-Elemente werden spezifisch in Anzeigemustern verwendet. Andere können in beiden Kontexten, d. h. für das Rendern von Seiten oder von Feldern, verwendet werden. Sie werden aber hauptsächlich zum Rendern von Feldern genutzt. Die folgenden spezifischen CAML-Renderelemente dienen zum Erstellen von Vorlagen, die sowohl statische HTML als auch Daten sowie Metadaten des zu rendernden Felds enthalten können.
| Element | Beschreibung |
|---|---|
| Column |
Gibt den Rohdatenwert eines bestimmten Felds zurück. |
| Spalte 2 |
Dient zum Rendern eines Feldtyps vom Typ Link. |
| Flucht |
Dient als Escapezeichen für bestimmte Zeichen in Zeichenfolgen. |
| FieldFilterOptions |
Wird in HeaderPattern-Abschnitten von FldTypes.xml zum Anzeigen von Dropdownmenüs für Filter angezeigt. |
| FieldPrefix |
Gibt den Microsoft Office-Namespace zurück. urn:schemas-microsoft-com:office:office# |
| Fieldref |
Wird in berechneten Feldern zum Verweisen auf die einzelnen Felder und in Ansichten zum Bestimmen verwendet, welche Felder vorhanden sind. |
| FieldSortImageURL |
Gibt die URL der Bilddatei zurück, die zum Angeben der Sortierung einer Spalte verwendet wird. |
| FieldSortParams |
Gibt die Sortierrichtung für eine Liste, wobei Asc oder Desc basierend darauf, ob das Feld sortiert wurde, gerendert wird, und die aktuelle Standardsortierrichtung des Felds zurück. |
| IfEqual |
Lässt bedingtes Rendern basierend auf dem Vergleich zweier CAML-Ausdrücke zu. |
| IfNew |
Gibt TRUE zurück, wenn das Element als neu eingestuft wird. |
| ImagesPath |
Gibt den HTTP-Pfad zu den Bilderverzeichnissen des Projekts zurück. |
| Grenzwert |
Schneidet Text auf eine angegebene Größe ab. |
| LocaleInfo |
Überträgt Gebietsschemainformationen des Servers an den Client, damit Datumsangaben und Zahlen ordnungsgemäß angezeigt und bearbeitet werden können. |
| PageUrl |
Wird an beliebiger Stelle verwendet, um die absolute, codierte URL der aktuellen Seite zurückzugeben. |
| Eigenschaft |
Gibt die Eigenschaft aus dem aktuellen ForEach-Kontext zurück. |
| ScriptQuote |
Dient zum Rendern von Text vom Server, der als Zeichenfolge in Anführungszeichen interpretiert werden muss. |
| TodayISO |
Rendert das aktuelle Datum samt Uhrzeit im ISO-Format. |