ECMJobRunner/ECMJobRunner.Domain/AGENTS.md

ECMJobRunner.Domain

Project Overview

ECMJobRunner.Domain is a domain entity library for the ECM Job Runner system. This project contains entity models that represent the database schema for job runner configuration and execution history.

Target Frameworks

• .NET Framework 4.8 (net480)
• .NET 8.0 (net8.0)

The project is multi-targeted to support both legacy .NET Framework applications and modern .NET 8 applications.

Technologies

Entity Framework

• For .NET Framework 4.8: Entity Framework 6.5.1
• For .NET 8.0: Entity Framework Core 8.0.11 with SQL Server provider

Project Structure

ECMJobRunner.Domain/
├── Entities/
│   ├── Profile.cs              # Job configuration profile entity
│   ├── ProfileSqlJob.cs        # SQL job configuration entity
│   └── ProfileHistory.cs       # Job execution history entity
├── ECMJobRunner.Domain.csproj
└── AGENTS.md                   # This file

Entities

Profile

Table: dbo.TBJR_CFG_PROFILE

Represents a job runner profile configuration.

Key Properties:

• Id (PK): Primary key, auto-generated
• Active: Enable/disable switch
• ProfileName: Name of the profile
• TypeId: Profile type (0=ADSync, 1=GraphQL, 2=SQL-Job, 3=SQL and REST-Job)
• Schedule: Cron format schedule
• Comment: Optional description

Relationships:

• One-to-Many with ProfileSqlJob (SQL jobs)
• One-to-Many with ProfileHistory (execution history)

ProfileSqlJob

Table: dbo.TBJR_CFG_PROFILE_SQLJOB

Represents individual SQL jobs within a profile.

Key Properties:

• Id (PK): Primary key, auto-generated
• ProfileId (FK): Foreign key to Profile
• Active: Enable/disable switch
• Sequence: Execution order within the profile
• Name: Optional job name
• SqlCheckQuery: SQL query for pre-check
• SqlMainQuery: Main SQL query
• ApiCommand: API command to execute

Relationships:

• Many-to-One with Profile

ProfileHistory

Table: dbo.TBJR_OUT_PROFILE_HISTORY

Stores execution history and results of job profiles.

Key Properties:

• Id (PK): Primary key, auto-generated
• ProfileId (FK): Foreign key to Profile
• ResultId: Result status (0=OK, 1=ERROR, 2=WARNING)
• ResultText: Result message/details

Relationships:

• Many-to-One with Profile

Database Schema Source

The entities are based on SQL Server tables located at:

M:\Datenbank\[DD_ECM]-Database\JobRunner\

The following SQL files define the schema:

• [TBJR_CFG_PROFILE].sql - Profile configuration table
• [TBJR_CFG_PROFILE_SQLJOB].sql - SQL job configuration table
• [TBJR_OUT_PROFILE_HISTORY].sql - Execution history table
• [VWJR_CFG_PROFILE].sql - Profile view (not implemented as entity)
• [VWJR_CFG_PROFILE_SQLJOB].sql - SQL job view (not implemented as entity)

Naming Conventions

• Entity Classes: Clean Pascal case (e.g., Profile instead of TBJR_CFG_PROFILE)
• Properties: Pascal case (e.g., ProfileName instead of PROFILE_NAME)
• Table Mapping: Uses [Table] attribute to map to actual database table names
• Column Mapping: Uses [Column] attribute to map to actual column names
• Entity names are simplified without technical prefixes (Jr/Cfg/Out)

Attributes Used

• [Table] - Specifies the database table name and schema
• [Column] - Specifies the database column name
• [Key] - Marks the primary key
• [Required] - Marks non-nullable properties
• [MaxLength] - Specifies maximum string length
• [ForeignKey] - Specifies foreign key relationships
• [DatabaseGenerated] - Specifies identity/auto-generated columns

Building the Project

To build the project:

dotnet build ECMJobRunner.Domain.csproj

To build for a specific framework:

dotnet build ECMJobRunner.Domain.csproj -f net8.0
dotnet build ECMJobRunner.Domain.csproj -f net480

Development Notes

• All entities include audit fields: AddedWho, AddedWhen, ChangedWho, ChangedWhen
• Navigation properties are marked as virtual to support lazy loading
• Nullable reference types are enabled for better null-safety
• XML documentation is generated for IntelliSense support
• Default values are set according to database constraints

Company Information

Author: Digital Data GmbH
Copyright: 2026
Repository: http://git.dd:3000/AppStd/ECMJobRunner.git