Component | Build | Status |
---|---|---|
Connected Service | Rolling |
This is the official OData Connected Service repository which allows users to generate proxy classes from the OData Metadata.
The OData Connected Service release can be found in the two following places.
In order to build the application Visual Studio 2019/2017 is the recommended development environment with the visx development tools installed.
The repository has 2 projects which are
- The main ODataConnectedService project
ODataConnectedService.sln
- The ODataConnectedServiceTests project
ODataConnectedService.Tests.sln
Open the ODataConnectedService.sln
in visual studio and install any suggested extensions that may be missing in your instance.
Build and run the project.
While developing if you encounter any issues do check the FAQ section below for frequently asked questions
The ODataConnectedService.Tests.sln
contains the unit tests for the OData connected service. The folder structure of the tests mirrors the folder structure
of the ODataConnectedService
project. The base namespace for tests is Microsoft.OData.ConnectedService.Tests
. Furthermore each test class has the same name
as the class it is testing, followed by the suffix Test
.
Example: for some class Microsoft.OData.ConnectedService.X.Y
located in src\X\Y.cs
,
the test class would be Microsoft.OData.Tests.ConnectedService.Tests.X.YTest
located in test\X\YTest.cs
The project can also be build using on the commandline by relying on the provided build.cmd
Question: The extension module is not loaded when debugging in the Visual Studio experimental instance, or it is not listed as part of the "Add Connected Service" options Workaround: Disable signing by going to the Project Properties > Signing and disabling both "Sign the assembly" and "Delay sign only" options.
Question: In Visual Studio 2017, upon configuring the service endpoint in the OData Connected Services extension and clicking "Finish", I get an error message that says "Value cannot be null.\r\nParameter name: path1".
Workaround: Download the Microsoft WCF ToolKit and install it. Then go to the registry and find the following key: [HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Microsoft WCF Data Services]
. Create a duplicate of "VS 2010 Tooling" (if this doesn't exist, use "5.6" instead) named "VS 2014 Tooling". Then try again. (Special thanks to mohsenno1 for pointing this out.)
Question: In Visual Studio 2017, upon configuring the service endpoint in the OData Connected Services extension and clicking "Finish", I get an error message that says "Cannot access".
Workaround: Most reported issues for this error are related to authentication-based endpoints. This extension does not currently support authentication. To work around, download the metadata as a text file from the endpoint and then point the OData Connected Services URI to the downloaded file.
There are many ways for you to contribute to OData Connected services. The easiest way is to participate in discussion of features and issues. You can also contribute by sending pull requests of features or bug fixes to us. Contribution to the documentations is also highly welcomed. Please refer to the CONTRIBUTING.md for more details.
- Issues: Report issues on Github issues.
- Questions: Ask questions on Stack Overflow.
- Feedback: Please send mails to odatafeedback@microsoft.com.
- Team blog: Please visit https://docs.microsoft.com/odata/ and http://www.odata.org/blog/.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.