FluentAAS 0.6.0

What's Changed

🚀 Features

• Add TechnicalDataBuilder with ECLASS/IEC-61360 validation and Template Integration by @Freezor in #25

📦 Other Direct Commits

• Enhance release changelog generation and categorization in NuGet release workflow (#24) by @Freezor (a4197973e011ec3dea049250d2b9d286bce33a58)
• Add TechnicalDataBuilder with ECLASS/IEC-61360 validation and Template Integration (#25) by @Freezor (9cb54b98aee70cd49b87e55e97766b604fccbaa5)

Full Changelog: v0.5.0...v0.6.0

FluentAAS 0.5.0

📦 Uncategorized

• Pin NuGet release build to tested commit SHA
  • PR: #18
• Add staged submodel composition and validation (fragments) with tests…
  • PR: #20

FluentAAS 0.4.0

📦 Uncategorized

• Add structured ContactInformation builder, semantics, identifiers and tests
  • PR: #13
• Upgrade to .NET 10, enable analyzers, and run tests in CI
  • PR: #14
• Update NuGet package metadata across projects and add NuGet info to README
  • PR: #16
• Add blocking unit-test gates for PRs and NuGet releases
  • PR: #17

FluentAAS 0.3.0

📦 Uncategorized

• feature/2-method-complexity
  • PR: #3
• #1 implement handover documentation template
  • PR: #4
• Update README with digital nameplate and documentation status
  • PR: #5
• 6 switch nuget versioning to tag driven releases
  • PR: #7

FluentAAS v0.2.0.12

New Feature: IDTA 02004-2-0 Handover Documentation Submodel Template

We're excited to announce first-class support for the IDTA Handover Documentation submodel template (IDTA 02004-2-0) in FluentAAS! This brings us significantly closer to complete IDTA template coverage and enables industrial-grade asset lifecycle documentation workflows.

What's New

Strongly Typed Submodel Builder

• Fluent Builder API: Build Handover Documentation submodels with type safety and validation
• Semantic Compliance: Automatic semantic ID assignment following IDTA 02004-2-0 specification
• Structured Documents: Support for complex document hierarchies with versions, classifications, and digital files

Key Features

• Document Management: Add multiple documents with IDs, classifications, and versions
• Multi-language Support: Built-in support for multi-language titles, descriptions, and keywords
• File Attachments: Add digital files with MIME type validation and preview files
• Lifecycle Integration: Support for document status tracking and organizational metadata
• VDI 2770 Classification: Integrated document classification system support

Usage Example

var environment = AasBuilder.Create()
    .AddShell("urn:aas:example:my-shell", "MyShell")
    .WithGlobalAssetId("urn:asset:example:my-asset")
    .AddHandoverDocumentation("urn:submodel:example:handover-documentation:V2_0")
    .WithDescription("en", "Complete handover documentation for the asset")
    .WithDescription("de", "Vollständige Übergabedokumentation für das Asset")
    .AddDocument(doc => doc
        .AddDocumentId("URI", "DOC-001")
        .WithDocumentClassification("01-01", "Installation Manual")
        .AddDocumentVersion(ver => ver
            .WithLanguage("en")
            .WithLanguage("de")
            .WithVersion("1.0")
            .WithTitle("Installation Manual Document")
            .WithDescription("A comprehensive installation manual document")
            .WithSubtitle("Quick Start Guide")
            .AddKeyword("installation")
            .AddKeyword("manual")
            .WithStatus("Released", DateTime.UtcNow)
            .WithOrganization("CRM", "Customer Relations Management")
            .AddDigitalFile("installation_manual.pdf", "application/pdf")
            .WithPreviewFile("preview.pdf", "application/pdf")
        )
    )
    .BuildHandoverDocumentation()
    .CompleteShellConfiguration()
    .Build();

Technical Details

• Package: FluentAAS.Templates
• Target Framework: .NET 9.0
• C# Version: 13.0
• AAS Core: 3.0 (AasCore.Aas3_0 v1.0.5)

Quality Assurance

• Comprehensive Test Coverage: 100+ test assertions covering all builder functionality
• Validation: Built-in validation for required fields and IDTA compliance
• Integration Tests: End-to-end tests including JSON/AASX serialization round-trips
• Error Handling: Clear error messages for missing required fields

Use Cases

This template is perfect for:

• Asset Commissioning: Structured handover documentation during asset deployment
• Technical Documentation: Comprehensive documentation bundles for industrial machinery
• Manufacturer-Operator Handover: Standardized documentation transfer workflows
• Maintenance Documentation: Lifecycle-aware documentation management
• Digital Twin Integration: Complete documentation support for digital twin implementations

Breaking Changes

None - this is a pure feature addition that maintains full backward compatibility.

Documentation

• Full API documentation included in XML docs
• Integration examples in the test suite
• Follows established FluentAAS architectural patterns

Acknowledgments

This implementation follows the official IDTA 02004-2-0 specification and maintains consistency with the existing FluentAAS template architecture.

FluentAAS v0.2.0.11

• no changes