Unchase.Odata.Connectedservice

:scroll: A Visual Studio extension for connecting to OData services with generating client-side C# proxy-classes

Programming language: C#

License: Apache License 2.0

Tags: Visual Studio Plugins    

Latest version: v1.5.1

README

Unchase OData Connected Service is a Visual Studio extension to generate C# or VB client code for OData web service.

Starting from Visual Studio Community 2019 v16.1.3 extensions based on Microsoft Connected Services now work fine.

Getting Started

Read How-To on medium.com

Install from Tools -> Extensions and Updates menu inside Visual Studio (including 2019) or download as VSIX package from VSGallery or download as VSIX package from Visual Studio Marketplace:

[Adding Unchase OData Connected Service in Visual Studio](img/Unchase-OData-Connected-Service.gif)

The project is developed and maintained by Nikolay Chebotov (Unchase).

Builds status

Status	Value
Build
Buid History
GitHub Release
GitHub Release Date
GitHub Release Downloads
VS Marketplace
VS Marketplace Downloads
VS Marketplace Installs

Features

• Generate C# and VB clients/proxies (client code) from OData specifications for OData protocol versions 1.0-4.0
• Support for emitting dynamic properties on open types for OData protocol version 4.0
• Support selection OperationImports (Actions and FunctionImports) that will be generated for OData protocol versions 1.0-4.0
• Support loading client code generation parameters from json files (including Connected Service .json from OData Connected Service by Microsoft)
• Generate C# proxy-class extension methods for OData protocol versions 1.0-3.0
• Generate functions to call service methods from OData protocol versions 1.0-3.0 FunctionImports or from OData protocol version 4.0 OperationImports
  • You can select the necessary methods that will be added after generation for OData protocol versions 1.0-4.0
• Add required dependencies for the C# client (before generating):
  • Libraries for OData v3 Client:
    1. Microsoft.Data.Services.Client (NuGet)
    2. Microsoft.Data.OData (NuGet)
    3. Microsoft.Data.Edm (NuGet)
    4. System.Spatial (NuGet)
    5. In additional: System.ValueTuple (NuGet)
  • Libraries for OData v4 Client:
    1. Microsoft.OData.Client (NuGet)
    2. Microsoft.OData.Core (NuGet)
    3. Microsoft.OData.Edm (NuGet)
    4. Microsoft.Spatial (NuGet)
• Storage of the last 10 endpoints (json-specification path)

Features are supported since v1.0.0

Generation VB client code for OData protocol versions 1.0-4.0

[Unchase OData Connected Service VisualBasic](img/Unchase-OData-Connected-Service-VisualBasic.png)

Features are supported since v1.2.0

Selection FunctionImports that will be generated for OData protocol versions 1.0-4.0

[Unchase OData Connected Service FunctionImports](img/Unchase-OData-Connected-Service-FunctionImports.png)

Features are supported since v1.3.0

Loading client code generation parameters from json files (including Connected Service .json from OData Connected Service by Microsoft)

[Unchase OData Connected Service Load Parameters](img/Unchase-OData-Connected-Service-LoadJson.png)

HowTos

• [ ] Add HowTos in a future
• [ ] ... request for HowTo you need

Troubleshooting

Installation completes but I can't see the Service in the list of connected services (Visual Studio 2019)

• Relevant bug report. Connected Services restored in the v16.1.3 update to Visual Studio 2019.

Roadmap

See the [changelog](CHANGELOG.md) for the further development plans and version history.

Feedback

Please feel free to add your review, request a feature, ask a question or report a bug including in connected service:

[Unchase OData Connected Service Report a Bug](img/Unchase-OData-Connected-Service-ReportBug.png)

Thank you in advance!

Thank me!

If you like what I am doing and you would like to thank me, please consider:

[Buy me a coffe!](img/buymeacoffe.png)

Thank you for your support!

---

Copyright © 2019 Nikolay Chebotov (Unchase) - Provided under the [Apache License 2.0](LICENSE.md).