MauroAccess.Core 1.0.0.891

MauroAccess.Core

Core library for accessing Mauro Data Mapper APIs. This library provides essential models, abstractions, and services for interacting with Mauro Data Mapper endpoints.

Overview

MauroAccess.Core is a foundational .NET library that provides the core data models and services needed to work with Mauro Data Mapper, an open-source platform for managing complex health and care data models.

Features

• Core Data Models: Comprehensive models for Mauro catalogue items including:

  • Data Models
  • Data Classes
  • Data Elements
  • Data Types
  • Terminologies
  • Metadata

• Service Abstractions: Interfaces and base implementations for:

  • Model validation (ModelApiValidator)
  • Model upload orchestration (ModelUploadOrchestrator)
  • Endpoint management
  • Model collection management

• Extensions: Useful extension methods for working with Mauro data structures

• Logging: Integrated logging support using Microsoft.Extensions.Logging

Installation

Install via NuGet Package Manager:

dotnet add package MauroAccess.Core

Or via Package Manager Console in Visual Studio:

Install-Package MauroAccess.Core

Quick Start

using MauroDataMapper;
using Microsoft.Extensions.Logging;

// Create a logger factory
using var loggerFactory = LoggerFactory.Create(builder =>
{
    builder.AddConsole();
});

// Initialise the Mauro logger
MauroLogger.SetLogger(loggerFactory.CreateLogger("MauroAccess"));

// Work with catalogue items
var dataModel = new DataModel
{
    label = "My Health Data Model",
    description = "A comprehensive health data model"
};

// Add data classes, elements, etc.
var dataClass = new DataClass
{
    label = "Patient",
    description = "Patient demographic information"
};

dataModel.childDataClasses.Add(dataClass);

Core Concepts

Catalogue Items

All Mauro entities derive from the base catalogueItem class, which provides:

• Unique identifier (id)
• Label (label)
• Description (description)
• Domain type (domainType)
• Metadata collection

Domain Types

The library defines standard domain types:

• DataModel
• DataClass
• DataElement
• PrimitiveType
• EnumerationType
• ReferenceType
• Terminology
• Term
• Folder

Metadata Management

All catalogue items support extensible metadata through key-value pairs, organised by namespace.

Requirements

• .NET 9.0 or later
• Microsoft.Extensions.Logging 9.0.9 or later

Documentation

For more information about Mauro Data Mapper:

• Official Documentation
• Getting Started Guide
• GitHub Repository

Related Packages

• MauroAccess: Higher-level API client built on top of MauroAccess.Core
• MauroImportExport: Import/export functionality for various formats (DITA, JSON Schema, etc.)

Licence

This project is licensed under the Apache-2.0 Licence.

Support

For issues, questions, or contributions:

• Visit the GitHub repository
• Consult the Mauro Data Mapper documentation

Contributing

Contributions are welcome! Please see the contributing guidelines for more information.