Ressource ColumnDefinition

Représentation JSON

Voici une représentation JSON d’une ressource ColumnDefinition.

{
  "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" }
}

Propriétés

Les colonnes peuvent contenir des données de divers types. Les propriétés suivantes indiquent le type de données contenues dans une colonne, ainsi que les paramètres supplémentaires pour ces données. Les propriétés liées au type (booléen, calculé, choice, currency, dateTime, lookup, number, personOrGroup, text) s’excluent mutuellement : une colonne ne peut avoir qu’une seule d’entre elles spécifiée.

Nom de la propriété	Type	Description
columnGroup	string	Pour les colonnes de site, nom du groupe auquel cette colonne appartient. Permet d’organiser les colonnes associées.
description	string	Description de la colonne visible par les utilisateurs.
displayName	string	Nom de la colonne visible par les utilisateurs.
enforceUniqueValues	booléen	Si la valeur est True, deux éléments de liste ne peuvent avoir la même valeur pour cette colonne.
hidden	booléen	Indique si la colonne est affichée dans l’interface utilisateur.
id	string	Identificateur unique de la colonne.
indexed	booléen	Indique si les valeurs de la colonne peuvent être utilisées pour le tri et la recherche.
name	string	Nom de la colonne dans l’API tel qu’il apparaît dans la ressource fields sur un objet listItem. Pour le nom visible par les utilisateurs, reportez-vous à la propriété displayName.
readOnly	bool	Indique si les valeurs de la colonne peuvent être modifiées.
required	booléen	Indique si la valeur de la colonne n’est pas facultative.
boolean	booleanColumn	Cette colonne contient des valeurs booléennes.
calculated	calculatedColumn	Les données de cette colonne sont calculées en fonction des autres colonnes.
choice	choiceColumn	Cette colonne contient des données provenant d’une liste de choix.
currency	currencyColumn	Cette colonne contient des valeurs monétaires.
dateTime	dateTimeColumn	Cette colonne contient des valeurs DateTime.
defaultValue	defaultColumnValue	Valeur par défaut de cette colonne.
lookup	lookupColumn	Les données de cette colonne sont recherchées dans une autre source dans le site.
number	numberColumn	Cette colonne contient des valeurs numériques.
personOrGroup	personOrGroupColumn	Cette colonne contient des valeurs de personne ou de groupe.
text	textColumn	Cette colonne contient des valeurs textuelles.

Remarque : ces propriétés correspondent à l’énumération SPFieldType de SharePoint. Même si les types de champs les plus courants sont représentés ci-dessus, certains n’apparaissent pas encore dans cette version bêta de l’API. Dans ce cas, aucune des facettes du type de colonne n’est remplie et la colonne aura seulement ses propriétés de base.

Remarques

Les valeurs ColumnDefinitions et field pour les colonnes hidden ne sont pas affichées par défaut. Pour les afficher lors de l’énumération des ressources columnDefinitions, incluez hidden dans votre instruction $select. Pour les afficher lors de l’affichage des valeurs de champ sur listItems, incluez les colonnes souhaitées par nom dans votre $select instruction.