ColumnDefinition-Ressource
JSON-Darstellung
Es folgt 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" },
"lookup": { "@odata.type": "microsoft.graph.lookupColumn" },
"number": { "@odata.type": "microsoft.graph.numberColumn" },
"personOrGroup": { "@odata.type": "microsoft.graph.personOrGroupColumn" },
"text": { "@odata.type": "microsoft.graph.textColumn" }
}
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.
| Eigenschaftenname | 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 | boolean | Wenn der Wert true ist, dürfen keine der Elemente für diese Spalte den gleichen Wert aufweisen. |
| hidden | boolean | Gibt an, ob die Spalte auf der Benutzeroberfläche angezeigt wird. |
| id | string | Die eindeutige ID für die Spalte. |
| indexed | boolean | 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 | bool | Gibt an, ob die Werte in den Spalten geändert werden können. |
| required | boolean | Gibt an, ob die Werte in den Spalten obligatorisch sind. |
| 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. |
| 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. |
Hinweis: Diese Eigenschaften entsprechen der SPFieldType-Enumeration von SharePoint. Obwohl die meisten gängigen Feldtypen vorstehend dargestellt sind, fehlen bei dieser Beta-API noch einige. In diesen Fällen werden keine der Spaltentyp-Facets aufgefüllt und die Spalte weist nur die grundlegenden Eigenschaften auf.
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 sie beim Anzeigen von Feldwerten in listItems anzuzeigen, schließen Sie die gewünschten Spalten anhand des Namens in Ihre $select Anweisung ein.