columnDefinition-Ressourcentyp
Namespace: microsoft.graph
Wichtig
APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .
Stellt eine Spalte in einer [Website][], [liste][] oder contentType dar.
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 – eine Spalte kann nur eine davon angeben.
| 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 | Boolescher Wert | Wenn true, haben keine zwei Listenelemente den gleichen Wert für diese Spalte. |
| hidden | Boolean | Gibt an, ob die Spalte auf der Benutzeroberfläche angezeigt wird. |
| id | string | Die eindeutige ID für die Spalte. |
| indexed | Boolescher Wert | 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 | Boolescher Wert | Gibt an, ob die Werte in den Spalten geändert werden können. |
| required | Boolescher Wert | 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 ein 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 | Boolescher Wert | Gibt an, ob diese Spalte gelöscht werden kann. |
| propagateChanges | Boolescher Wert | Wenn true, werden Änderungen an dieser Spalte an Listen weitergegeben, die die Spalte implementieren. |
| isReorderable | Boolescher Wert | Gibt an, ob Werte in der Spalte neu angeordnet werden können. Schreibgeschützt. |
| Issealed | Boolescher Wert | 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. |
| Begriff | 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 Status der Inhaltsgenehmigung gespeichert. |
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| Sourcecolumn | columnDefinition | Die Quellspalte für die Inhaltstypspalte. |
Hinweis: Diese Eigenschaften entsprechen der SharePoint [SPFieldType-Enumeration][]. Beachten Sie, dass die gängigsten Feldtypen in der vorherigen Tabelle dargestellt werden. Diese Beta-API fehlt jedoch noch. In diesen Fällen werden keine der Spaltentyp-Facets aufgefüllt und die Spalte weist nur die grundlegenden Eigenschaften auf.
JSON-Darstellung
Hier sehen Sie eine JSON-Darstellung einer columnDefinition-Ressource.
{
"columnGroup": "string",
"description": "description",
"displayName": "friendly name",
"enforceUniqueValues": true,
"hidden": false,
"id": "string",
"indexed": true,
"name": "staticNameForApi",
"readOnly": false,
"required": false,
"boolean": { "@odata.type": "microsoft.graph.booleanColumn" },
"calculated": { "@odata.type": "microsoft.graph.calculatedColumn" },
"choice": { "@odata.type": "microsoft.graph.choiceColumn" },
"currency": { "@odata.type": "microsoft.graph.currencyColumn" },
"dateTime": { "@odata.type": "microsoft.graph.dateTimeColumn" },
"defaultValue": { "@odata.type": "microsoft.graph.defaultColumnValue" },
"geolocation": { "@odata.type": "microsoft.graph.geolocationColumn" },
"lookup": { "@odata.type": "microsoft.graph.lookupColumn" },
"number": { "@odata.type": "microsoft.graph.numberColumn" },
"personOrGroup": { "@odata.type": "microsoft.graph.personOrGroupColumn" },
"text": { "@odata.type": "microsoft.graph.textColumn" },
"isDeletable" : false,
"propagateChanges": false,
"isReorderable": false,
"isSealed": false,
"validation": { "@odata.type": "microsoft.graph.columnValidation" },
"hyperlinkOrPicture": { "@odata.type": "microsoft.graph.hyperlinkOrPictureColumn" },
"term": { "@odata.type": "microsoft.graph.termColumn" },
"sourceContentType": { "@odata.type": "microsoft.graph.contentTypeInfo" },
"thumbnail": { "@odata.type": "microsoft.graph.thumbnailColumn" },
"type": { "@odata.type": "microsoft.graph.columnTypes" },
"contentApprovalStatus": { "@odata.type": "microsoft.graph.contentApprovalStatusColumn" }
}
Bemerkungen
ColumnDefinitions und Feldwerte für hidden-Spalten werden standardmäßig nicht angezeigt.
Um diese bei der Auflistung von ColumnDefinitions anzuzeigen, fügen Sie hidden in Ihre $select-Anweisung ein.
Um diese beim Anzeigen von field-Werten mit listItems anzuzeigen, fügen Sie die gewünschten Spalten ein, indem Sie $select in Ihre Anweisung aufnehmen.
Feedback
Feedback senden und anzeigen für