microsoft / microsoft/OpenAPI.NET.OData
Add support for IsDelta in return types
Dieses Issue hat noch niemand übernommen.
- Vorherrschende Sprache
- C#
- Sterne
- 240
- Forks
- 70
- Ø Merge
- 7 Std. 59 Min.
- Gemergte PRs (30 T.)
- 13
Beschreibung
OASIS has added support for an IsDelta annotation that specifies that action or function parameters or return types may be represented as a delta (that is, they may contain deleted entities or nested changes). See https://github.com/oasis-tcs/odata-specs/blob/main/docs/odata-csdl-json/odata-csdl-json.md#annotation-coreisdelta) for a description of applying the annotation to a return type.
For example, the following "getChanges" function returns a collection of users, represented as a delta payload:
<Function Name="getChanges" IsBound="true">
<Parameter Name="bindingParameter" Type="microsoft.graph.savePoint" />
<ReturnType Type="Collection(microsoft.graph.user)">
<Annotation Term="Org.OData.Core.V1.IsDelta" Bool="true" />
</ReturnType>
</Function>
This Issue is to add support for this annotation to OpenAPI.NET.OData.
Beitragsleitfaden
Erste Schritte
- Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
- Forke das Repository und arbeite in einem Branch.
- Öffne einen Pull Request, der die Issue-Nummer nennt.
Rechercherichtung
Das Issue nennt keine Implementierungsdateien oder Tests. Beginne damit zu ermitteln, wie OpenAPI.NET.OData OData-Annotationen und Rückgabetypen verarbeitet, und verwende dann die gezeigte Funktion getChanges als Eingabefall; abgeschlossen ist die Aufgabe, wenn ihre IsDelta-Rückgabetypannotation im generierten OpenAPI-Dokument korrekt dargestellt wird.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- csharp, openapi
- Bereich
- api
- Issue-Typ
- Feature
- Schwierigkeit
- 3/5
- Geschätzter Aufwand
- 1-2 Tage
- Aktivitätsstatus
- Veraltet
- Klarheit
- Größtenteils klar
- Anfängerfreundlichkeit
- 45/100