columnDefinition-Ressourcentyp
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 contentType 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 in listItems anzuzeigen, schließen Sie die gewünschten Spalten anhand des Namens 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 (boolean, calculated, choice, currency, dateTime, lookup, number, personOrGroup, text) schließen sich gegenseitig aus. Für eine Spalte kann nur eine davon angegeben werden.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| columnGroup | string | Für Websitespalten der Name der Gruppe, zu der dieser Spalte gehört. Dadurch können dazugehörige Spalten einfacher organisiert werden. |
| description | string | Für den Benutzer sichtbare Beschreibung der Spalte. |
| displayName | string | Für den Benutzer sichtbarer Name der Spalte. |
| enforceUniqueValues | Boolesch | Gibt truean, dass keine zwei Listenelemente denselben Wert für diese Spalte aufweisen dürfen. |
| hidden | Boolesch | Gibt an, ob die Spalte auf der Benutzeroberfläche angezeigt wird. |
| id | string | Die eindeutige ID für die Spalte. |
| indexed | Boolesch | Gibt an, ob die Spaltenwerte für das Sortieren und Suchen verwendet werden können. |
| 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. |
| readOnly | Boolesch | Gibt an, ob die Werte in den Spalten geändert werden können. |
| required | Boolesch | Gibt an, ob der Spaltenwert nicht optional ist. |
| boolean | booleanColumn | In dieser Spalte werden boolesche Werte gespeichert. |
| calculated | calculatedColumn | Die Daten in dieser Spalte werden anhand von anderen Spalten berechnet. |
| choice | choiceColumn | In dieser Spalte werden Daten aus einer Auswahlliste gespeichert. |
| currency | 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. |
| Geolocation | geolocationColumn | In dieser Spalte wird eine Geolocation gespeichert. |
| lookup | lookupColumn | Die Daten in dieser Spalte werden aus einer anderen Quelle dieser Website abgerufen. |
| number | numberColumn | In dieser Spalte werden Zahlenwerte gespeichert. |
| personOrGroup | personOrGroupColumn | In dieser Spalte werden Personen- oder Gruppenwerte gespeichert. |
| text | textColumn | In dieser Spalte werden Textwerte gespeichert. |
| isDeletable | Boolesch | Gibt an, ob diese Spalte gelöscht werden kann. |
| propagateChanges | Boolesch | Gibt truean, werden Änderungen an dieser Spalte an Listen weitergegeben, die die Spalte implementieren. |
| isReorderable | Boolesch | Gibt an, ob Werte in der Spalte neu angeordnet werden können. Schreibgeschützt. |
| isSealed | Boolesch | Gibt an, ob die Spalte geändert werden kann. |
| Validierung | columnValidation | In dieser Spalte werden die Validierungsformel und die Meldung für die Spalte gespeichert. |
| hyperlinkOrPicture | hyperlinkOrPictureColumn | In dieser Spalte werden Hyperlink- oder Bildwerte gespeichert. |
| Ausdruck | termColumn | In dieser Spalte werden Taxonomiebegriffe gespeichert. |
| sourceContentType | contentTypeInfo | ContentType, von dem diese Spalte geerbt wird. Wird nur zum Abrufen von contentTypes-Spalten verwendet. |
| thumbnail | thumbnailColumn | In dieser Spalte werden Miniaturansichtswerte gespeichert. |
| type | columnTypes | Bei Websitespalten der Spaltentyp. Schreibgeschützt. |
| contentApprovalStatus | contentApprovalStatusColumn | In dieser Spalte wird der Inhaltsgenehmigungsstatus gespeichert. |
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| sourceColumn | columnDefinition | Die Quellspalte für die Inhaltstypspalte. |
Anmerkung: Diese Eigenschaften entsprechen der SharePoint SPFieldType-Enumeration . Beachten Sie, dass die am häufigsten verwendeten Feldtypen in der vorherigen Tabelle dargestellt werden. 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 zeigt 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",
"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"}
}