How to: F&O OData client (net8)

Goal: a standalone integration client for F&O’s OData endpoints, living beside your X++ in the same window.

Template law: it builds clean with dotnet build on a machine with only the .NET SDK — proven in selftests and re-proven in CI.

Prerequisites

• The .NET 8 SDK.
• Your environment’s OData endpoint details (from the environment profile pointer in the template’s README).

Steps

1. Add the companion: Projects pane → Add C# Companion Project… → F&O OData client (net8). You get a console csproj, Simple.OData.Client-ready (commented), and the README pointer.
2. Uncomment and configure — the client package reference and your endpoint setup.
3. Write the integration — the full language server backs you: diagnostics, completion, hover, definition, references.
4. Build — explicit verdict line every time (succeeded / failed / up-to-date).

PROJECTS PANE · ODATA COMPANIONReal UI capture pendingcs-odata-template

No F&O DLL references — by design

OData clients talk to endpoints, not assemblies. You don’t need Add F&O Reference… for this template; that’s for the interop library.

Verify it worked

• dotnet build prints the explicit verdict; MSBuild diagnostics (if any) land in Problems with file:line navigation.
• The client runs against your endpoint from the terminal.

If it goes wrong

• Endpoint/auth failures at runtime — that’s configuration, not the companion: check the environment profile and your OData client’s setup.

Next: references & build · debugging (net8 companions are fully debuggable).