Type de ressource columnDefinition
Espace de noms: microsoft.graph
Représente une colonne dans un site, une liste ou un contentType.
Par défaut, les valeurs columnDefinitions et les valeurs de champ pour hidden les colonnes ne sont pas affichées. Pour répertorier les columnDefinitions masquées, incluez hidden dans votre $select instruction . Pour répertorier les valeurs de champ masquées sur listItems, incluez les colonnes souhaitées par nom dans votre $select instruction.
Méthodes
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 (boolean, calculated, choice, currency, dateTime, lookup, number, personOrGroup, text, term, hyperlinkOrPicture, thumbnail et contentApprovalStatus) s’excluent mutuellement ; une colonne ne peut avoir qu’une seule d’entre elles spécifiée.
| Nom de la propriété | Type | Description |
|---|---|---|
| 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. |
| columnGroup | string | Pour les colonnes de site, nom du groupe auquel cette colonne appartient. Permet d’organiser les colonnes associées. |
| contentApprovalStatus | contentApprovalStatusColumn | Cette colonne stocke l’état d’approbation du contenu. |
| 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. |
| description | string | Description de la colonne visible par les utilisateurs. |
| displayName | string | Nom de la colonne visible par les utilisateurs. |
| enforceUniqueValues | Valeur booléenne | Si truela valeur est , deux éléments de liste peuvent avoir la même valeur pour cette colonne. |
| géolocalisation | geolocationColumn | Cette colonne stocke une géolocalisation. |
| hidden | Valeur booléenne | Indique si la colonne est affichée dans l’interface utilisateur. |
| hyperlinkOrPicture | hyperlinkOrPictureColumn | Cette colonne stocke les valeurs de lien hypertexte ou d’image. |
| isDeletable | Valeur booléenne | Indique si cette colonne peut être supprimée. |
| isReorderable | Valeur booléenne | Indique si les valeurs de la colonne peuvent être réorganisées. En lecture seule. |
| id | string | Identificateur unique de la colonne. |
| indexed | Valeur booléenne | Spécifie si les valeurs de colonne peuvent être utilisées pour le tri et la recherche. |
| isSealed | Valeur booléenne | Spécifie si la colonne peut être modifiée. |
| lookup | lookupColumn | Les données de cette colonne sont recherchées dans une autre source dans le site. |
| 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. |
| number | numberColumn | Cette colonne contient des valeurs numériques. |
| personOrGroup | personOrGroupColumn | Cette colonne contient des valeurs de personne ou de groupe. |
| propagateChanges | Valeur booléenne | Si la valeur est « true », les modifications apportées à cette colonne sont propagées aux listes qui implémentent la colonne. |
| readOnly | Valeur booléenne | Indique si les valeurs de la colonne peuvent être modifiées. |
| required | Valeur booléenne | Spécifie si la valeur de colonne n’est pas facultative. |
| sourceContentType | contentTypeInfo | ContentType dont cette colonne est héritée. Présente uniquement dans la réponse des colonnes contentTypes. En lecture seule. |
| terme | termColumn | Cette colonne stocke les termes de taxonomie. |
| text | textColumn | Cette colonne contient des valeurs textuelles. |
| thumbnail | thumbnailColumn | Cette colonne stocke les valeurs de miniatures. |
| type | columnTypes | Pour les colonnes de site, type de colonne. En lecture seule. |
| validation | columnValidation | Cette colonne stocke la formule de validation et le message pour la colonne. |
Relations
| Nom de la propriété | Type | Description |
|---|---|---|
| sourceColumn | columnDefinition | Colonne source pour la colonne de type de contenu. |
Note: Ces propriétés correspondent à l’énumération SPFieldType SharePoint. Notez que les types de champs les plus courants sont représentés dans le tableau précédent. Toutefois, cette API en manque encore. Dans ce cas, aucune des facettes du type de colonne n’est remplie et la colonne aura seulement ses propriétés de base. La réponse sites et colonnes de liste ne contient pas les propriétés isDeletable, propagateChanges, isReorderable, isSealed, validation, hyperlinkOrPicture, term, sourceContentType, thumbnail, type, contentApprovalStatus et sourceColumn .
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"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" }
}