columnDefinition-Ressourcentyp
Namespace: microsoft.graph
Stellt eine Spalte in einer Website, liste oder contentType dar.
Standardmäßig werden columnDefinitions - und Feldwerte für hidden Spalten nicht angezeigt. Um ausgeblendete columnDefinitions aufzulisten, fügen Sie in Ihre $select -Anweisung einhidden. Um ausgeblendete Feldwerte in listItems aufzulisten, 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, term, hyperlinkOrPicture, thumbnail und contentApprovalStatus) schließen sich gegenseitig aus; In einer Spalte kann nur eine davon angegeben werden.
| Eigenschaftenname | Typ | Beschreibung |
|---|---|---|
| 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. |
| 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 status für die Inhaltsgenehmigung 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. |
| 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. |
| Geolocation | geolocationColumn | In dieser Spalte wird eine Geolocation gespeichert. |
| hidden | Boolesch | Gibt an, ob die Spalte auf der Benutzeroberfläche angezeigt wird. |
| hyperlinkOrPicture | hyperlinkOrPictureColumn | In dieser Spalte werden Hyperlink- oder Bildwerte gespeichert. |
| isDeletable | Boolesch | Gibt an, ob diese Spalte gelöscht werden kann. |
| isReorderable | Boolesch | Gibt an, ob Werte in der Spalte neu angeordnet werden können. Schreibgeschützt. |
| id | string | Die eindeutige ID für die Spalte. |
| indexed | Boolesch | Gibt an, ob die Spaltenwerte zum Sortieren und Suchen verwendet werden können. |
| isSealed | Boolesch | Gibt an, ob die Spalte geändert werden kann. |
| lookup | 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 | Boolesch | Bei "true" werden Änderungen an dieser Spalte an Listen weitergegeben, die die Spalte implementieren. |
| 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. |
| sourceContentType | contentTypeInfo | ContentType, von dem diese Spalte geerbt wird. Nur in contentTypes-Spaltenantwort vorhanden. Schreibgeschützt. |
| Ausdruck | termColumn | In dieser Spalte werden Taxonomiebegriffe gespeichert. |
| text | textColumn | In dieser Spalte werden Textwerte gespeichert. |
| thumbnail | thumbnailColumn | In dieser Spalte werden Miniaturansichtswerte gespeichert. |
| type | columnTypes | Bei Websitespalten der Spaltentyp. Schreibgeschützt. |
| Validierung | columnValidation | In dieser Spalte werden die Validierungsformel und die Meldung für die Spalte gespeichert. |
Beziehungen
| Eigenschaftsname | 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 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. Die Antwort auf Websites und Listenspalten enthält keine eigenschaften isDeletable, propagateChanges, isReorderable, isSealed, validation, hyperlinkOrPicture, term, sourceContentType, thumbnail, type, contentApprovalStatus und sourceColumn .
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",
"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" },
"readOnly": "Boolean",
"required": "Boolean",
"propagateChanges": "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" }
}