Og.Nav.Client.Library 1.0.3

Nav Client Library

A lightweight .NET library providing generic OData V4 and SOAP client services for Microsoft Dynamics NAV / Business Central.

Features

• OData V4 Service: CRUD operations via INavODataService<T> against OData endpoints.
• SOAP Service: CRUD and codeunit invocation via INavSoapService<T> against SOAP web services.
• Factory-based DI integration for both service types.
• Built-in JSON and XML serialization with error handling and extensibility.

Installation

# Install from nuget.org
dotnet add package Og.Nav.Client.Library --version 1.0.3

Usage

// Program.cs
using Core.Interfaces;
using Infrastructure.Services;
using Microsoft.Extensions.Options;

var builder = WebApplication.CreateBuilder(args);

// Configure settings
builder.Services.Configure<NavSoapServiceConfig>(
    builder.Configuration.GetSection("NavSoapService"));
builder.Services.Configure<NavODataServiceConfig>(
    builder.Configuration.GetSection("NavODataService"));

// Register factories
builder.Services.AddSingleton<INavSoapServiceFactory, NavSoapServiceFactory>();
builder.Services.AddSingleton<INavODataServiceFactory, NavODataServiceFactory>();

// Register named HttpClients
builder.Services.AddHttpClient("NavSoapClient", /* ... */);
builder.Services.AddHttpClient("NavODataClient", /* ... */);

Then inject and use:

public class MyAppService
{
    private readonly INavODataService<Customer> _odata;
    private readonly INavSoapService<Order>   _soap;

    public MyAppService(
        INavODataServiceFactory odataFactory,
        INavSoapServiceFactory soapFactory)
    {
        _odata = odataFactory.Create<Customer>("Customers");
        _soap  = soapFactory.Create<Order>("SalesOrder");
    }

    public async Task Run()
    {
        var list   = await _odata.GetEntitiesAsync("Country eq 'US'");
        var single = await _soap.ReadAsync(new XElement("OrderId", "SO-1001"));
    }
}

Configuration

Add to appsettings.json:

"NavSoapService": { /* see docs for fields */ },
"NavODataService": { /* see docs for fields */ }

See Configuration & DI for details.

Contributing

1. Fork the repo
2. Create a feature branch
3. Submit a pull request

License

MIT © job gedions