Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Stellt eine Spalte in einer Website, Liste oder einem Inhaltstyp dar.
Standardmäßig werden columnDefinitions und Feldwerte für hidden Spalten nicht angezeigt. Um diese bei der Auflistung von ColumnDefinitions anzuzeigen, fügen Sie hidden in Ihre $select-Anweisung ein. Um sie beim Anzeigen von Feldwerten auf listItems zu sehen, fügen Sie die gewünschten Spalten nach Namen in Ihre $select Anweisung ein.
Methoden
Eigenschaften
Spalten können verschiedene Datentypen enthalten. Die folgenden Eigenschaften geben an, welche Arten von Daten in einer Spalte gespeichert werden sowie weitere Einstellungen für die Daten. Die typbezogenen Eigenschaften (boolesch, berechnet, choice, currency, dateTime, lookup, number, personOrGroup, text) schließen sich gegenseitig aus – in einer Spalte kann nur eine von ihnen angegeben werden.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| Boolescher Wert | booleanColumn | In dieser Spalte werden boolesche Werte gespeichert. |
| Berechnete Felder | calculatedColumn | Die Daten in dieser Spalte werden anhand von anderen Spalten berechnet. |
| Wahl | choiceColumn | In dieser Spalte werden Daten aus einer Auswahlliste gespeichert. |
| columnGroup | string | Für Websitespalten der Name der Gruppe, zu der dieser Spalte gehört. Dadurch können dazugehörige Spalten einfacher organisiert werden. |
| contentApprovalStatus | contentApprovalStatusColumn | In dieser Spalte wird der Status der Inhaltsgenehmigung gespeichert. |
| Währung | currencyColumn | In dieser Spalte sind die Währungswerte gespeichert. |
| dateTime | dateTimeColumn | In dieser Spalte sind die DateTime-Werte gespeichert. |
| defaultValue | defaultColumnValue | Der Standardwert für diese Spalte. |
| description | string | Für den Benutzer sichtbare Beschreibung der Spalte. |
| displayName | string | Für den Benutzer sichtbarer Name der Spalte. |
| enforceUniqueValues | Boolean | Wenn true, dürfen keine zwei Listenelemente den gleichen Wert für diese Spalte haben. |
| Geolocation | geolocationColumn | In dieser Spalte wird eine Geolocation gespeichert. |
| hidden | Boolean | Gibt an, ob die Spalte auf der Benutzeroberfläche angezeigt wird. |
| hyperlinkOrPicture | hyperlinkOrPictureColumn | In dieser Spalte werden Link- oder Bildwerte gespeichert. |
| id | string | Die eindeutige ID für die Spalte. |
| indexed | Boolean | Gibt an, ob die Spaltenwerte zum Sortieren und Suchen verwendet werden können. |
| isDeletable | Boolean | Gibt an, ob diese Spalte gelöscht werden kann. |
| isReorderable | Boolean | Gibt an, ob Werte in der Spalte neu sortiert werden können. Schreibgeschützt. |
| isSearchable | Boolean | Gibt an, ob die Spaltenwerte für die Suche verwendet werden können. Derzeit nur für Spalten in einem fileStorageContainer unterstützt. |
| isSealed | Boolean | Gibt an, ob die Spalte geändert werden kann. |
| Nachschlagen | lookupColumn | Die Daten in dieser Spalte werden aus einer anderen Quelle dieser Website abgerufen. |
| name | string | Der in der API sichtbare Name der Spalte, wie er in den Feldern eines ListItem angezeigt wird. Weitere Informationen zum für den Benutzer sichtbaren Namen finden Sie unter displayName. |
| number | numberColumn | In dieser Spalte werden Zahlenwerte gespeichert. |
| personOrGroup | personOrGroupColumn | In dieser Spalte werden Personen- oder Gruppenwerte gespeichert. |
| propagateChanges | Boolean | If truewerden Änderungen an dieser Spalte an Listen weitergegeben, die die Spalte implementieren. |
| readOnly | Boolean | Gibt an, ob die Werte in den Spalten geändert werden können. |
| erforderlich | Boolean | Gibt an, ob der Spaltenwert nicht optional ist. |
| sourceContentType | contentTypeInfo | ContentType, von dem diese Spalte geerbt wird. Wird nur zum Abrufen von contentTypes-Spalten verwendet. |
| term | termColumn | In dieser Spalte werden Taxonomiebegriffe gespeichert. |
| text | textColumn | In dieser Spalte werden Textwerte gespeichert. |
| Miniaturansicht | thumbnailColumn | In dieser Spalte werden Miniaturansichtswerte gespeichert. |
| type | columnTypes | Für Websitespalten der Spaltentyp. Schreibgeschützt. |
| Validierung | columnValidation | In dieser Spalte werden die Gültigkeitsprüfungsformel und die Meldung für die Spalte gespeichert. |
Hinweis
Die Eigenschaften isSearchable und indexed sind verwandt, aber unabhängig. Wenn isSearchable nicht explizit angegeben ist, wird der Wert von indiziert verwendet. Nachdem Sie isSearchable festgelegt haben, wird es unabhängig von indexed. Wenn nur isSearchable angegeben ist, wird der durchsuchbare Status der Spalte aktualisiert, ohne den indizierten Status zu ändern. Die isSearchable-Eigenschaft wird derzeit nur für Spalten in einem fileStorageContainer unterstützt.
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| sourceColumn | columnDefinition | Die Quellspalte für die Inhaltstypspalte. |
Hinweis: Diese Eigenschaften entsprechen der SharePoint SPFieldType-Enumeration . Beachten Sie, dass die am häufigsten verwendeten Feldtypen in der vorherigen Tabelle dargestellt sind. In dieser Beta-API fehlen jedoch noch einige. In diesen Fällen werden keine der Spaltentyp-Facets aufgefüllt und die Spalte weist nur die grundlegenden Eigenschaften auf.
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"boolean": {"@odata.type": "microsoft.graph.booleanColumn"},
"calculated": {"@odata.type": "microsoft.graph.calculatedColumn"},
"choice": {"@odata.type": "microsoft.graph.choiceColumn"},
"columnGroup": "String",
"contentApprovalStatus": {"@odata.type": "microsoft.graph.contentApprovalStatusColumn"},
"currency": {"@odata.type": "microsoft.graph.currencyColumn"},
"dateTime": {"@odata.type": "microsoft.graph.dateTimeColumn"},
"defaultValue": {"@odata.type": "microsoft.graph.defaultColumnValue"},
"description": "String",
"displayName": "String",
"enforceUniqueValues": "Boolean",
"geolocation": {"@odata.type": "microsoft.graph.geolocationColumn"},
"hidden": "Boolean",
"hyperlinkOrPicture": {"@odata.type": "microsoft.graph.hyperlinkOrPictureColumn"},
"id": "String (identifier)",
"indexed": "Boolean",
"isSearchable": "Boolean",
"isDeletable": "Boolean",
"isReorderable": "Boolean",
"isSealed": "Boolean",
"lookup": {"@odata.type": "microsoft.graph.lookupColumn"},
"name": "staticNameForApi",
"number": {"@odata.type": "microsoft.graph.numberColumn"},
"personOrGroup": {"@odata.type": "microsoft.graph.personOrGroupColumn"},
"propagateChanges": "Boolean",
"readOnly": "Boolean",
"required": "Boolean",
"sourceContentType": {"@odata.type": "microsoft.graph.contentTypeInfo"},
"term": {"@odata.type": "microsoft.graph.termColumn"},
"text": {"@odata.type": "microsoft.graph.textColumn"},
"thumbnail": {"@odata.type": "microsoft.graph.thumbnailColumn"},
"type": {"@odata.type": "microsoft.graph.columnTypes"},
"validation": {"@odata.type": "microsoft.graph.columnValidation"}
}