Skip to content

Commit ebe862f

Browse files
authored
Merge pull request #336 from microsoft/graph
New Graph patterns: change tracking, evolvable enums, and namespace
2 parents 3c7416c + d569024 commit ebe862f

File tree

6 files changed

+753
-233
lines changed

6 files changed

+753
-233
lines changed

graph/GuidelinesGraph.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -414,8 +414,11 @@ Recommended API Design patterns:
414414
| Type Hierarchy | The ability to model is-a relationships using subtypes. | [Subtypes](./patterns/Modelling%20with%20Subtypes%20Pattern.md) |
415415
| Facets | The ability to model parent-child relationships using Facet pattern. | [Facets](./patterns/Modelling%20with%20Subtypes%20Pattern.md) |
416416
| Dictionary | The ability for clients to provide an unknown quantity of data elements of the same type. | [Dictionary](./patterns/dictionary.md) |
417+
| Evolvable Enums | The ability to extend enumerated types without breaking changes. | [Evolvable Enums](./patterns/evolvable-enums.md) |
418+
| Change Tracking | The ability to keep API consumers in sync with changes without polling. | [Change Tracking](./patterns/change-tracking.md) |
419+
| Namespace | The ability to organize resource definitions into a logical set. | [Namespace](./patterns/namespace.md) |
417420

418-
|
421+
|
419422

420423

421424
## References

graph/SummaryOfGraphDeltas.md

Lines changed: 0 additions & 216 deletions
This file was deleted.

graph/deprecation.md

Lines changed: 15 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -16,22 +16,21 @@ to annotate any usages of that type.
1616

1717
**Example of property annotation:**
1818

19-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20-
<EntityType Name="outlookTask" BaseType="Microsoft.OutlookServices.outlookItem" ags:IsMaster="true" ags:WorkloadName="Task" ags:EnabledForPassthrough="true">
21-
<Annotation Term="Org.OData.Core.V1.Revisions">
22-
<Collection>
23-
<Record>
24-
<PropertyValue Property = "Date" Date="2022-03-30"/>
25-
<PropertyValue Property = "Version" String="2022-03/Tasks_And_Plans"/>
26-
<PropertyValue Property = "Kind" EnumMember="Org.OData.Core.V1.RevisionKind/Deprecated"/>
27-
<PropertyValue Property = "Description" String="The Outlook tasks API is deprecated and will stop returning data on June 30, 2024. Please use the new To Do API."/>
28-
<PropertyValue Property = "RemovalDate" Date="2024-06-30"/>
29-
</Record>
30-
</Collection>
31-
</Annotation>
32-
...
33-
</EntityType>
34-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
19+
```xml
20+
<EntityType Name="outlookTask" BaseType="Microsoft.OutlookServices.outlookItem" ags:IsMaster="true" ags:WorkloadName="Task" ags:EnabledForPassthrough="true">
21+
<Annotation Term="Org.OData.Core.V1.Revisions">
22+
<Collection>
23+
<Record>
24+
<PropertyValue Property = "Date" Date="2022-03-30"/>
25+
<PropertyValue Property = "Version" String="2022-03/Tasks_And_Plans"/>
26+
<PropertyValue Property = "Kind" EnumMember="Org.OData.Core.V1.RevisionKind/Deprecated"/>
27+
<PropertyValue Property = "Description" String="The Outlook tasks API is deprecated and will stop returning data on June 30, 2024. Please use the new To Do API."/>
28+
<PropertyValue Property = "RemovalDate" Date="2024-06-30"/>
29+
</Record>
30+
</Collection>
31+
</Annotation>
32+
</EntityType>
33+
```
3534

3635
When the request URL contains a reference to a deprecated model element, the gateway will add a [Deprecation
3736
header](https://tools.ietf.org/html/draft-dalal-deprecation-header-02) (with the

0 commit comments

Comments
 (0)