type de ressource customFieldDefinition (Planificateur)

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Champ personnalisé défini sur un plan, utilisé pour capturer des données structurées spécifiques au plan sur les tâches. Les options de choix pour les champs à choix unique et à choix multiples sont contenues sous choiceOptions; les valeurs sont définies par tâche via customFieldValue.

Hérite de plannerDelta.

Méthodes

Méthode Type de retour Description
List collection customFieldDefinition Obtenir une liste des objets customFieldDefinition et de leurs propriétés.
Create customFieldDefinition Créez un objet customFieldDefinition.
Obtenir customFieldDefinition Lire les propriétés et les relations de l’objet customFieldDefinition .
Mettre à jour customFieldDefinition Mettre à jour les propriétés d’un objet customFieldDefinition.
Supprimer Aucun Supprimez un objet customFieldDefinition.
Options de choix de liste collection customChoiceOption Obtenez une liste des objets customChoiceOption et de leurs propriétés.
Create customChoiceOption customChoiceOption Créez un objet customChoiceOption.

Propriétés

Propriété Type Description
archivalInfo plannerArchivalInfo Informations indiquant si l’entité est archivée et quand elle l’a été.
createdBy identitySet Identité de l’utilisateur (ou de l’application) qui a créé l’entité. En lecture seule.
createdDateTime DateTimeOffset Date et heure de création de l’entité. La valeur est représentée au format ISO 8601 et se trouve toujours en heure UTC. En lecture seule.
deletedBy identitySet Identité de l’utilisateur ayant supprimé la définition de champ personnalisé, si elle a été supprimée.
deletedDateTime DateTimeOffset Date et heure auxquelles la définition de champ personnalisé a été supprimée, le cas échéant.
displayName String Nom du champ personnalisé.
id String Identificateur unique de l’entité. En lecture seule. Hérité de l’entité
lastModifiedBy identitySet Identité de l’utilisateur (ou de l’application) qui a modifié l’entité en dernier. En lecture seule.
lastModifiedDateTime DateTimeOffset Date et heure de la dernière modification de l’entité. La valeur est représentée au format ISO 8601 et se trouve toujours en heure UTC. En lecture seule.
planId Chaîne ID du plan sur lequel le champ personnalisé est défini. Obligatoire et immuable après la création.
rollupType customFieldRollupType Comment les valeurs de ce champ personnalisé sont cumulées entre les tâches. Les valeurs possibles sont noRollup, max, min, sum, average, unknownFutureValue.
valueType customFieldValueType Type de données des valeurs du champ personnalisé. Les valeurs possibles sont : text, , utcDateTimedate, , decimalnumber, flag, singleChoiceTextmultipleChoiceTextunknownFutureValue.

Relations

Relation Type Description
choiceOptions collection customChoiceOption Collection d’options à choix sélectionnables pour un champ personnalisé à choix unique ou à choix multiples. En lecture seule. Pouvant accepter la valeur Null.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "@odata.type": "#microsoft.graph.customFieldDefinition",
  "id": "String (identifier)",
  "planId": "String",
  "displayName": "String",
  "valueType": "String",
  "rollupType": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "createdDateTime": "String (timestamp)",
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "deletedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "deletedDateTime": "String (timestamp)",
  "archivalInfo": {
    "@odata.type": "microsoft.graph.plannerArchivalInfo"
  }
}