plannerExternalPlanSource resource type

Namespace: microsoft.graph

Contains information about the relationship of a plannerPlan to a user experience outside of Planner. The information allows surfacing or syncing plans in Planner with other experiences to track work in the context of that experience.

You can display data in a plannerExternalPlanSource in a user interface to sync information for an external service, or to point to where a plan was created in the external service.

The combination of the contextScenarioId and externalObjectId properties is unique within a tenant. If creation is called with existing contextScenarioId and externalObjectId values, the existing object is returned with no modifications.

This type is derived from plannerPlanCreation.

Properties

Property Type Description
creationSourceKind plannerCreationSourceKind Specifies what kind of creation source the plan is created with. The possible values are: external, publication and unknownFutureValue. The value of this property will be external. Inherited from plannerPlanCreation.
contextScenarioId String Nullable. An identifier for the scenario associated with this external source. This should be in reverse DNS format. For example, Contoso company owned application for customer support would have a value like "com.constoso.customerSupport".
externalObjectId String Nullable. The ID of the entity that an external service associates with a plan.
externalContextId String Nullable. The ID of the external entity's containing entity or context.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.plannerExternalPlanSource",
  "creationSourceKind": "String-value",
  "externalObjectId": "String-value",
  "externalContextId": "String-value",
  "contextScenarioId": "String-value",
}