Common.ProFile 1.1.5

🔗 Common.ProFile

A typed .NET client library for ProFile backend, providing secure access to version, part, and document data via a simple HTTP abstraction with DI support.

✅ Features

✔ Secure authentication using AES-encrypted credentials
✔ Fetch ProFile version information
✔ Query parts by article number or ID
✔ Recursively traverse Bill of Materials (BOM)
✔ Download files and documents
✔ Resolve latest document version by status
✔ Fully DI-compatible

📦 Installation

Install via your internal NuGet feed: Opton Media

dotnet add package Common.ProFile --version 1.0.x

✅ Usage in Code

1. Register the Client in Startup

services.AddCommonSecurity(); // From Common.Security
services.AddProFileClient(configuration); // Registers IProFileAccess

🧠 The configuration section ProFile should exist in your appsettings.json:

"ProFile": {
  "ServerName": "profile.OptonMedia.de",
  "Tenant": "OptonMediaTenant",
  "AuthorizationEncrypted": "<your encrypted bearer token>"
}

2. Inject and Use the Client

public class MyService
{
    private readonly IProFileAccess _profile;

    public MyService(IProFileAccess profile)
    {
        _profile = profile;
    }

    public async Task RunAsync()
    {
        var version = await _profile.GetVersionAsync();
        var part = await _profile.GetPartAsync("WD191-001");
    }
}

🖼️ Example WinForms Integration

Program.cs

var config = new ConfigurationBuilder()
    .SetBasePath(AppDomain.CurrentDomain.BaseDirectory)
    .AddJsonFile("appsettings.json")
    .Build();

var services = new ServiceCollection();
services.AddCommonSecurity();
services.AddProFileClient(config);

var provider = services.BuildServiceProvider();
var mainView = ActivatorUtilities.CreateInstance<MainView>(provider);
Application.Run(mainView);

MainView.cs

public partial class MainView : Form
{
    private readonly IProFileAccess _profileClient;

    public MainView(IProFileAccess profileClient)
    {
        _profileClient = profileClient;
        InitializeComponent();
        Load += MainView_LoadAsync;
    }

    private async void MainView_LoadAsync(object sender, EventArgs e)
    {
        var id = await _profileClient.GetLatestDocumentVersionIdAsync(470033, "Freigegeben PO");
        MessageBox.Show($"Latest approved version: {id}");
    }
}

🧠 Behavior

• Automatically sets BaseAddress and Authorization on HttpClient
• Decrypts AuthorizationEncrypted with Common.Security
• Uses Polly retry policies for robustness
• Parses JSON responses using Newtonsoft

🔧 API Overview

📂 Folder Structure

/Common.ProFile
    /IProFileAccess.cs
    /ProFileClient.cs
    /ProFileOptions.cs
    /ServiceCollectionExtensions.cs

✅ Future Features

• 📄 Model classes for documents
• 📊 Diagnostics for API calls
• 🗂️ Additional filter/query helpers