Missing paths for OpenAPI generation
Mantenedores costumam responder em até 2 dias
Ninguém assumiu esta issue ainda.
Avaliação
- Dificuldade
- 4/5
- Tempo estimado
- 3-5 dias
- Facilidade para iniciantes
- 35/100
Direção de pesquisa
Comece inspecionando os caminhos gerados em openapi/beta/openapi.yaml e compare-os com as definições da entidade place e as rotas esperadas listadas na issue. Revise a issue 720 relacionada do OpenAPI.NET.OData e o pull request 850 de metadados para consultar a investigação anterior. Considera-se concluído quando for determinado se as anotações ou o comportamento do gerador são responsáveis e os caminhos ausentes forem documentados ou implementados.
Escrita pelo modelo de indexação a partir do texto da issue.
Descrição
Describe the bug
This is potentially related to the issue described above.
When generating the OpenAPI description for Microsoft Graph Beta the building, desk, floor, room, roomlist, section, workspace routes are not generated for those entitytypes. All are derived type of the abstract place type.
<EntitySet Name="places" EntityType="microsoft.graph.place" />
<EntityType Name="place" BaseType="graph.entity" Abstract="true">
....
<NavigationProperty Name="checkIns" Type="Collection(graph.checkInClaim)" ContainsTarget="true" />
</EntityType>
<EntityType Name="building" BaseType="graph.place">
...
<NavigationProperty Name="map" Type="graph.buildingMap" ContainsTarget="true" />
</EntityType>
<EntityType Name="room" BaseType="graph.place">
...
</EntityType>
<EntityType Name="roomList" BaseType="graph.place">
...
<NavigationProperty Name="rooms" Type="Collection(graph.room)" ContainsTarget="true" />
<NavigationProperty Name="workspaces" Type="Collection(graph.workspace)" ContainsTarget="true" />
</EntityType>
<Function Name="descendants" IsBound="true" IsComposable="true">
<Parameter Name="bindingParameter" Type="graph.place" />
<ReturnType Type="Collection(graph.place)" Nullable="false" />
</Function>
Sample of places paths currently supported in our OpenAPI:
/places/{place-id}
/places/{place-id}/checkIns
/places/{place-id}/checkIns/$count
/places/{place-id}/descendants()
/places/{place-id}/graph.room
/places/{place-id}/graph.room/checkIns
/places/{place-id}/graph.room/checkIns/$count
/places/{place-id}/graph.roomList
/places/{place-id}/graph.roomList/checkIns
/places/{place-id}/graph.roomList/rooms
Either we don't currently support this behavior or there are missing annotations used to specify this behavior. This requires investigation.
Expected behavior
Paths that we expect to be in our OpenAPI but are not (same as the list of affected EntityTypes above):
/places/microsoft.graph.building
/places/microsoft.graph.floor
/places/microsoft.graph.desk
/places/room
/places/roomlist
/places/section
/places/workspace
Additional context
https://github.com/microsoftgraph/msgraph-metadata/blob/master/openapi/beta/openapi.yaml to see missing paths.
https://learn.microsoft.com/en-us/graph/api/place-list?view=graph-rest-beta&tabs=http
https://github.com/microsoft/OpenAPI.NET.OData/issues/720
https://github.com/microsoftgraph/msgraph-metadata/pull/850
- Linguagem predominante
- XSLT
- Estrelas
- 171
- Forks
- 56
- Merge médio
- 1d 11h
- PRs com merge (30d)
- 9
Preparar o ambiente
Este projeto não oferece contêiner de desenvolvimento, Dockerfile nem guia de contribuição, então a configuração fica por sua conta: comece pelo README e veja nosso guia da primeira contribuição para os passos gerais.
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Mais de microsoftgraph/msgraph-metadata
-
ToTriage
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 86/100
microsoftgraph/msgraph-metadata#1217 ·
Mantenedores costumam responder em até 2 dias
-
ToTriage
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 68/100
microsoftgraph/msgraph-metadata#1192 ·
Mantenedores costumam responder em até 2 dias
-
ToTriage
Dificuldade 3/5 1-2 dias Facilidade para iniciantes 57/100
microsoftgraph/msgraph-metadata#1233 ·
Mantenedores costumam responder em até 2 dias
-
`microsoft.graph.managedDevice` is missing a filter restrictions annotation.Talvez já em andamento @esidorenko-sl assumiu há 86 dias. AbertaToTriage
Dificuldade 3/5 1-2 dias Facilidade para iniciantes 72/100
microsoftgraph/msgraph-metadata#1193 · 2 comentários ·
Mantenedores costumam responder em até 2 dias
-
ToTriage
Dificuldade 4/5 3-5 dias Facilidade para iniciantes 45/100
microsoftgraph/msgraph-metadata#1169 · 1 reação ·
Mantenedores costumam responder em até 2 dias
Todas as issues de microsoftgraph/msgraph-metadata
Issues semelhantes
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 65/100
matomo-org/plugin-CustomAlerts#310 ·
Mantenedores costumam responder em até 1 dia
-
bug level:trivial
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 72/100
exoego/keycloak-fuhito#666 ·
Mantenedores costumam responder em até 1 dia
-
bug size:small
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 88/100
Mantenedores costumam responder em até 1 dia
-
bug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 66/100
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 78/100
fb55/htmlparser2#2579 ·
Mantenedores costumam responder em até 1 dia