customFieldDefinition リソースの種類 (プランナー)

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

プランに定義されたカスタム フィールド。タスクに関する構造化されたプラン固有のデータをキャプチャするために使用されます。 単一選択肢フィールドと複数選択肢フィールドの選択オプションは choiceOptions の下に含まれています。値は customFieldValue を使用してタスクごとに設定します。

plannerDelta から継承します。

メソッド

メソッド 戻り値の種類 説明
List customFieldDefinition コレクション customFieldDefinition オブジェクトとそのプロパティの一覧を取得します。
Create customFieldDefinition 新しい customFieldDefinition オブジェクトを作成します。
Get customFieldDefinition customFieldDefinition オブジェクトのプロパティと関係を読み取ります。
Update customFieldDefinition customFieldDefinition オブジェクトのプロパティを更新します。
Delete なし customFieldDefinition オブジェクトを削除します。
List choiceOptions customChoiceOption コレクション customChoiceOption オブジェクトとそのプロパティのリストを取得します。
customChoiceOption の作成 customChoiceOption 新しい customChoiceOption オブジェクトを作成します。

プロパティ

プロパティ 型 説明
archivalInfo plannerArchivalInfo エンティティがアーカイブされているかどうか、アーカイブされた時期に関する情報。
createdBy identitySet エンティティを作成したユーザー (またはアプリケーション) の ID。 読み取り専用です。
createdDateTime DateTimeOffset エンティティが作成された日時。 値は ISO 8601 形式で表され、常に UTC 時刻になります。 読み取り専用です。
deletedBy identitySet カスタム フィールド定義を削除したユーザーの ID (削除された場合)。
deletedDateTime DateTimeOffset カスタム フィールド定義が削除された日付と時刻 (該当する場合)。
displayName 文字列 オプション
id 文字列 エンティティの一意識別子。 読み取り専用です。 エンティティから継承
lastModifiedBy identitySet エンティティを最後に変更したユーザー (またはアプリケーション) の ID。 読み取り専用です。
lastModifiedDateTime DateTimeOffset エンティティが最後に変更された日時。 値は ISO 8601 形式で表され、常に UTC 時刻になります。 読み取り専用です。
planId String カスタム フィールドが定義されているプランの ID。 必須であり、作成後は変更できません。
rollupType customFieldRollupType このカスタム フィールドの値がタスク間でロールアップされる方法。 使用可能な値: noRollup、max、min、sum、average、unknownFutureValue。
valueType customFieldValueType カスタム フィールドの値のデータ型。. 有効な値は、 text、 date、 utcDateTime、 number、 decimal、 flag、 singleChoiceText、 multipleChoiceText、 unknownFutureValue です。

リレーションシップ

リレーションシップ 型 説明
choiceOptions customChoiceOption コレクション 単一選択肢または複数選択肢のカスタム フィールドの選択可能な選択肢オプションのコレクション。 読み取り専用です。 Null 許容型。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

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