Freigeben über

FieldRef-Element (ContentType)

  • Artikel

Gilt für: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online-| SharePoint Server 2013

Gibt eine Spalte an, auf die in diesem Inhaltstyp verwiesen werden soll.

Definition

<FieldRef
  Aggregation="sum" | "count" | "average" | "min" | "max" | "merge" | "plaintext" | "first" | "last"
  Customization="Text"
  DefaultValue="Text"
  Description="Text"
  DisplayName="Text"
  Format="Text"
  Filterable="TRUE" | "FALSE"
  FilterableNoRecurrence="TRUE" | "FALSE"
  FromBaseType="TRUE" | "FALSE"
  Hidden="TRUE" | "FALSE" | "orResource"
  ID="Text"
  Locked="TRUE" | "FALSE"
  Name="Text"
  Node="Text"
  NumLines="Integer"
  PIAttribute="Text"
  PITarget="Text"
  PrimaryPIAttribute="Text"
  PrimaryPITarge="Text"
  ReadOnly="TRUE" | "FALSE"
  ReadOnlyClient="TRUE" | "FALSE"
  Required="TRUE" | "FALSE"
  Sealed="TRUE" | "FALSE"
  ShowInDisplayForm="TRUE" | "FALSE"
  ShowInEditForm="TRUE" | "FALSE"
  ShowInFileDlg="TRUE" | "FALSE"
  ShowInListSettings="TRUE" | "FALSE"
  ShowInNewForm="TRUE" | "FALSE"
  Sortable="TRUE" | "FALSE">
</FieldRef>

Elemente und Attribute

In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.

Attribute

Attribut Beschreibung
Aggregation

Wenn Sie das Node-Attribut zum Angeben eines XPath-Ausdrucks verwenden, der eine Auslistung von Werten zurückgibt, können Sie auch ein Aggregation-Attribut einschließen, mit dem die Aktion angegeben wird, die für die zurückgegebene Gruppe von Werten ausgeführt werden soll.

Bei dieser Aktion kann es sich entweder um eine Aggregatfunktion oder um eine Indikation des bestimmten Elements innerhalb der Auflistung handeln.

Mögliche Werte:

  • Summe

  • count

  • Durchschnittliche

  • Min

  • Max

  • Zusammenführen

  • plaintext Konvertiert Knotentextinhalte in Nur-Text.

  • first Wendet Eigenschaftsheraufstufung und -herabstufung auf das erste Element in der Auflistung an.

  • first Wendet Eigenschaftsheraufstufung und -herabstufung auf das letzte Element in der Auflistung an.

Weitere Informationen dazu, wie die Attribute Node, PIAttribute, PITarget, PrimaryPIAttribute und PrimaryPITarget für die Herauf- und Herabstufung von Eigenschaften in XML-Dokumenten verwendet werden, finden Sie unter Verwenden von Inhaltstypen zum Angeben von XML-Dokumenteigenschaften.
Anpassung

Optionaler Text. Eine Zeichenfolge in CAML (Collaborative Application Markup Language), die benutzerdefinierte Feldeigenschaften definiert.
DefaultValue

Veraltet.
Beschreibung

Optionaler Text-Wert. Stellt die Beschreibung bereit, die im Bearbeitungsformular für eine Liste angezeigt wird, wenn eine Spaltenbeschreibung angegeben wird. Spalten in SharePoint Foundation enthalten standardmäßig keine Beschreibungen.
DisplayName

Erforderliches Text-Element. Der angezeigte Name der Spalte. Die maximale Länge beträgt 255 Zeichen.

Der Wert dieses Attributs wird als Spaltenüberschrift verwendet, wenn das Feld in einer Tabellenansicht angezeigt wird, und als Formularbeschriftung, wenn das Feld auf einem Formular angezeigt wird. Verwenden Sie das DisplayName-Attribut, um den Anzeigenamen in einen Wert zu ändern, der sich von dem im Feld selbst definierten Namen unterscheidet.
Format

Optionaler Text-Wert. Gibt die Formatierung an, die für numerische Werte verwendet werden soll.

Für Datums-/Uhrzeitspalten sind folgende Werte möglich:

  • DateOnly Zeigt nur den Datumsteil an (und lässt Bearbeitungen zu) (der Zeitteil ist auf 12:00 Uhr festgelegt. für alle bearbeiteten Werte).

  • DateTime Das Datum und die Uhrzeit werden angezeigt und können bearbeitet werden (Standard).

  • ISO8601   Datum und Uhrzeit im ISO 8601-Zeitformat anzeigen, konvertiert nach UTC: JJJJ-MM-TTThh:mm:ssZ.

    Dies ist das Format, das für Dokumenteigenschaften im Microsoft Office-System sowie für das Standardaustauschformat verwendet wird, das in Microsoft SharePoint Foundation zwischen neuen und Bearbeiten-Formularen und dem Server verwendet wird.

  • ISO8601Basic   Verkürzte Form von 8601-Datums-/Uhrzeitformaten verwenden: TTTTMMTTThhmmssZ.

    Dieses Format wird für vCard/iCal verwendet.

Für Auswahlfelder kann dieses Attribut auf Dropdown (Standard) festgelegt werden, das Bearbeitungsoptionen über eine Dropdownauswahl bereitstellt, oder auf RadioButtons, das Optionen über eine Gruppe von Optionsfeldern bereitstellt.

Für URL-Felder kann dieses Attribut auf "Hyperlink " (Standard) festgelegt werden, wodurch die URL als normales <A> Tag angezeigt wird, oder auf "Image", wodurch die URL als <IMG SRC="URL" ALT="Description">angezeigt wird.
Filterbar

Optionaler Boolean-Wert. TRUE zum Definieren von Spalten als filterbar.
FilterableNoRecurrence

Optionaler Boolean-Wert. TRUE zum Definieren von Spalten als filterbar ohne wiederkehrende Werte.
FromBaseType

Optionaler Boolean-Wert. Dieses Attribut kann zugunsten des Sealed-Attributs als veraltet ausgesondert werden.
Hidden

Optionaler Boolean-Wert. Mit TRUE ist das Feld in der Benutzeroberfläche vollständig ausgeblendet. Wenn Sie "ReadOnly " auf TRUE festlegen, wird das Feld nicht in formularen "Neu " oder "Bearbeiten" angezeigt, kann aber trotzdem in Ansichten eingeschlossen werden.

Wenn Sie dieses Attribut nicht einschließen, behandelt SharePoint Foundation die Spalte so, als wäre das Attribut auf FALSE festgelegt.
ID

Erforderliches Text-Element. Gibt die Feld-ID der Spalte an, auf die dieses FieldRef-Element verweist. Die Feld-ID ist die Zeichenfolgendarstellung einer GUID einschließlich der geschweiften Klammern. Bei dem Wert wird Groß- und Kleinschreibung unterschieden.

Sie finden die IDs für integrierte Felder in der Datei fieldswss.xml im folgenden Pfad:
%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\FEATURES\fields
Locked Veraltet.
Name

Erforderliches Text-Element. Der Name einer Spalte. Dies ist der interne Name einer Spalte, der während der gesamten Lebensdauer der Felddefinition garantiert nicht geändert wird. Er muss für die Felder in einer Liste eindeutig sein.

Knoten

Optionaler Text-Wert. Gibt den XML-Knoten im Dokument an, der den Spaltenwert enthält. Wird für die Eigenschaftenherauf- und -herabstufung in XML-Dokumenten verwendet.

Weitere Informationen zur Verwendung der Attribute Node, PIAttribute, PITarget, Primary PIAttribute und PrimaryPITarget für die Eigenschaftenherauf- und -herabstufung in XML-Dokumenten finden Sie unter Using Content Types to Specify XML Document Properties.
NumLines

Optionaler Integer-Wert. Empfiehlt, wie viele Linien (Zeilen) während der Bearbeitung in einem TEXTAREA-Block angezeigt werden sollen. Dies ist lediglich ein Hinweis für die Clientbenutzeroberfläche; die Zahl der Textzeilen, die bearbeitet werden kann, ist nicht begrenzt.
PIAttribute Optionaler Text-Wert. Gibt das Attribut in der Dokumentverarbeitungsanweisung an (durch das PITarget-Attribut angegeben), das als Spaltenwert verwendet werden soll. Wird für die Eigenschaftenherauf- und -herabstufung in XML-Dokumenten verwendet.

Wenn Sie das PIAttribute-Attribut angeben, müssen Sie auch das PITarget-Attribut angeben.

Weitere Informationen zum Verwenden der Attribute Node, PIAttribute, PITarget, Primary PIAttribute und PrimaryPITarget für das Herauf- und Herabstufen von Eigenschaften in XML-Dokumenten finden Sie unter Using Content Types to Specify XML Document Properties.
PITarget

Optionaler Text-Wert. Gibt die Dokumentverarbeitungsanweisung an, in der der Spaltenwert bei Dokumenten dieses Inhaltstyps gespeichert wird. Wird für die Eigenschaftenherauf- und -herabstufung in XML-Dokumenten verwendet.

Wenn Sie das PIAttribute-Attribut angeben, müssen Sie auch das PITarget-Attribut angeben.

Weitere Informationen zum Verwenden der Attribute Node, PIAttribute, PITarget, Primary PIAttribute und PrimaryPITarget für das Herauf- und Herabstufen von Eigenschaften in XML-Dokumenten finden Sie unter Using Content Types to Specify XML Document Properties.
PrimaryPIAttribute

Optionaler Text. Gibt ein alternatives Attribut in der Dokumentverarbeitungsanweisung an (mithilfe des PrimaryPITarget-Attributs), das als Spaltenwert verwendet werden soll.

Wenn Sie das PrimaryPIAttribute-Attribut angeben, müssen Sie auch das PrimaryPITarget-Attribut angeben. Wenn angegeben, verwendet SharePoint Foundation diese Werte vor den werten, die in den PiTarget - und PIAttribute-Attributen angegeben sind.

Dieses Attribut wird für die Eigenschaftenheraufstufung und -herunterstufung in XML-Dokumenten verwendet.

Weitere Informationen zur Verwendung der Attribute Node, PIAttribute, PITarget, Primary PIAttribute und PrimaryPITarget für die Eigenschaftenherauf- und -herabstufung in XML-Dokumenten finden Sie unter Using Content Types to Specify XML Document Properties.
PrimaryPITarget

Optionaler Text-Wert. Gibt eine alternative Dokumentverarbeitungsanweisung an, in der der Spaltenwert für Dokumente dieses Inhaltstyps gespeichert wird.

Wenn Sie das PrimaryPIAttribute-Attribut angeben, müssen Sie auch das PrimaryPITarget-Attribut angeben. Wenn angegeben, verwendet SharePoint Foundation diese Werte vor den werten, die in den PiTarget - und PIAttribute-Attributen angegeben sind.

Weitere Informationen zum Verwenden der Attribute Node, PIAttribute, PITarget, Primary PIAttribute und PrimaryPITarget für das Herauf- und Herabstufen von Eigenschaften in XML-Dokumenten finden Sie unter Using Content Types to Specify XML Document Properties.
ReadOnly

Optionaler Boolean-Wert. Wenn TRUE, wird das Feld in New- oder Edit-Formularen nicht angezeigt, kann aber in Ansichten eingebunden werden. Durch Festlegen des Hidden-Attributs auf TRUE wird das Feld auf der Benutzeroberfläche vollständig verborgen.

Wenn Sie dieses Attribut nicht einschließen, behandelt SharePoint Foundation die Spalte so, als wäre das Attribut auf FALSE festgelegt.
Required

Erforderlicher Boolean-Wert. Wenn TRUE, muss dem Feld erst ein Wert zugewiesen werden, bevor ein mit diesem Inhaltstyp erstelltes Element gespeichert werden kann.

Wenn in einem Formularbeitrag ein leerer Feldwert angegeben wird, wird entweder der standard erforderliche Feldtext oder eine explizit angegebene Meldung (d. h. über <ErrorText> Tags) im Fehlerformular angezeigt. Diese Validierung wird nur vom Client verarbeitet (die Datenbank lässt NULL für alle benutzerdefinierten Felder grundsätzlich zu).
Versiegelt

Optionaler Boolean-Wert. TRUE zum Definieren von Spalten als versiegelt. Versiegelte Spalten können nicht über die SharePoint Foundation-Benutzeroberfläche oder das Objektmodell bearbeitet werden. Wenn Sie dieses Attribut nicht einschließen, behandelt SharePoint Foundation die Spalte so, als wäre das Attribut auf FALSE festgelegt.
ShowInDisplayForm

Optionaler Boolean-Wert. TRUE, um die Spalte für Elemente dieses Inhaltstyps auf dem Anzeigeformular anzuzeigen.
ShowInEditForm

Optionaler Boolean-Wert. TRUE, um das Feld auf der Seite zum Bearbeiten eines Eintrags anzuzeigen.
ShowinFileDlg

Optionaler Boolean-Wert. TRUE , um die Spalte im Dateidialogfeld für Elemente dieses Inhaltstyps anzuzeigen.
ShowInListSettings

Optionaler Boolean-Wert. Wenn FALSE, erscheint das Feld im Anzeigemodus New nicht in einer Fields-Enumeration. Felder mit dieser Einstellung sind auf der Standardseite für neue Einträge für eine Liste nicht sichtbar.
ShowInNewForm

Optionaler Boolean-Wert. TRUE , um die Spalte im Formular "Neu" für Elemente dieses Inhaltstyps anzuzeigen.
Sortierbar

Optionaler Boolean-Wert. Ergibt TRUE, wenn die Werte im Feld sortiert werden können.

Untergeordnete Elemente

Keines

Übergeordnete Elemente

Vorkommen

  • Minimum: 0
  • Maximum: Unbegrenzt

Hinweise

Das FieldRef-Element ist ein Verweis auf eine anderswo auf der Website- oder Listenebene definierte Spalte. Im Feldverweis können Sie eine Teilmenge der Spalteneigenschaften überschreiben, wie z. B. die folgenden Eigenschaften:

  • Anzeigename
  • XML-Heraufstufungs- und XML-Herabstufungsattribute
  • Ob das Feld schreibgeschützt, erforderlich oder ausgeblendet ist

Wenn Sie diese Eigenschaften im Feldverweis ändern, werden sie nur für den entsprechenden Inhaltstyp geändert, der den Feldverweis enthält.

Wichtig

Die Attribute ID, Name, DisplayName und Required sind immer erforderlich, selbst wenn das FieldRef-Element auf ein Feld verweist, das im selben Elementmanifest definiert ist.

Beispiel

Im folgenden Beispiel sind zwei FieldRef-Elemente zu sehen, die Spalten zur Einbindung in einen Inhaltstyp angeben.

<FieldRefs>
  <!--  Built-in Title field -->
  <FieldRef ID="{fa564e0f-0c70-4ab9-b863-0177e6ddd247}" Name="Title" DisplayName="Item" Required="TRUE" Sealed="TRUE"/>
  <!--  Custom CostCenter field -->
  <FieldRef ID="{943E7530-5E2B-4C02-8259-CCD93A9ECB18}" Name="CostCenter" DisplayName="Department" Required="TRUE"/>
</FieldRefs>

Siehe auch