Anbindung der Archivierung an das ImageMaster Archiv

Übersicht

Die Anbindung der Service Archivierung an das ImageMaster-Archiv wird durch den imagemaster-archive-adapter Microservice realisiert.

Die Archivierung bei diesem Archiv erfolgt ohne Archivindex. Somit sind die Suche und die Anzeige der archivierten Nachrichten nicht über die B2B-Oberfläche möglich.

Imagemaster-Archive-Adapter

Der Microservice konsumiert die Nachrichten aus der Persistence Queue, konvertiert sie in das Zielformat und sendet sie an den REST-Endpunkt des ImageMaster.

ImageMaster Archivierung Workflow

Die Konfiguration des Microservices erfolgt über Umgebungsvariablen.

Releases

Der Service wird in den folgenden Versionen als Docker Container unter docker-nob-erp.next-level-apps.com/b2b/b2b-aaas-imagemaster-archive-adapter sowie arvatosystemsenergyportfolio.azurecr.io/aep/b2b-archive/b2b-aaas-imagemaster-archive-adapter bereitgestellt.

2026-11-12

Ticket Beschreibung
BTOB-14449 Anpassung der Mapping-Konfiguration - es ist nun möglich, die Werte für CC, PD und source pro Dokumententyp zu bestimmen. Mögliche Dokumententypen sind nun auch komplett frei wählbar.

2026-08-29

Ticket Beschreibung
BTOB-14513 Fehler in der Zertifikatsarchivierung behoben, der durch blockierende WebClient-Aufrufe im Scheduler auftreten konnte.
BTOB-14514 Puffergröße für WebClient-Antworten erhöht; Logging bei Fehlern verbessert.
BTOB-14570 EDIFACT-Dateinamen für Marktkommunikationsnachrichten werden nach BDEW-Konvention aus Nachrichtentyp, Anwendungsreferenz, Sender, Partner und UNB-Daten gebildet.

Das Release vom 2026-08-29 setzt das Crypto-Release 2026-KW40 voraus.

2026-01-27

Ticket Beschreibung
BTOB-13906 Anpassung des Mappings: documentType kann nun über individuelle Regeln anhand der Attribute der zu archivierenden Nachricht bestimmt werden. Ohne Regeln gilt „AS4_Unbestimmt“ als Fallback.

2026-01-21

Ticket Beschreibung
BTOB-13844 Anpassung des Content-Mappings: primary kann für ein konfigurierbares Attribut auf true gesetzt werden.

2026-01-20

Ticket Beschreibung
BTOB-13885 Aktualisierung von Spring Boot.

2026-01-16

Ticket Beschreibung
BTOB-13844 Korrektur der Dateiendungs-Konfiguration über Umgebungsvariablen, Korrektur von Attributnamen und Anpassung eines Standardwerts.

2026-01-07

Ticket Beschreibung
BTOB-13844 Dateiendungen der Anhänge werden in der ImageMaster-Zielstruktur gesetzt; Standardwerte können per Konfiguration überschrieben werden. Das Konfigurationsformat wurde umstrukturiert.

2025-12-19

Dieses Release sollte zusammen mit dem FSS-Release 2025-12-19 verwendet werden.

Ticket Beschreibung
BTOB-13764 Anpassung an die Korrektur der OpenAPI-Spezifikation des FSS; behebt einen Fehler beim Abruf der zu archivierenden Zertifikate.

2025-12-17

Ticket Beschreibung
BTOB-13764 Erweiterung der Archivierung um zusätzliche ImageMaster-Attribute und Bestimmung des documentType anhand der zu archivierenden Nachricht.

2025-11-28

Hinweis: Mit diesem Release wurde der Standard-Queue-Typ für die Consumer-Queue von default auf quorum geändert.

Ticket Beschreibung
BTOB-13670 Erweiterung um die Archivierung von Zertifikaten aus dem FSS.

2025-10-30

Ticket Beschreibung
BTOB-13471 Initiale Entwicklung.

Konfiguration

Für die Minimalkonfiguration müssen folgende Konfigurationsparameter gesetzt sein:

# Imagemaster Archive configuration
imagemaster:
  baseUrl: <ImageMaster API base URL>
  tenant: <tenant name>
  user: <username>
  password: <password>

spring:
  # RabbitMQ configuration
  rabbitmq:
    host: ${RABBITMQ_HOST}
    port: ${RABBITMQ_PORT}
    username: ${RABBITMQ_USER}
    password: ${RABBITMQ_PASSWORD}
  # Security configuration for accessing FSS via keycloak
  security:
    oauth2:
      client:
        registration:
          keycloak:
            authorization-grant-type: "client_credentials"
            scope: "openid"
            client-id: <clientId>
            client-secret: <clientSecret>
        provider:
          keycloak:
            issuer-uri: <keycloak token URI>

# Security server (FSS) configuration
securityServer:
  baseUrl: <FSS API base URL>
  cronSchedule: <Cron String>

Für die Konfiguration der Placeholder siehe Installation.

Weitere optionale Konfigurationen erlauben die Anpassung der Attributnamen für das Zielsystem, die Anpassung der Consumer- und Producer-Queues und ggf. weitere spezifische Konnektivität-Settings wie Connection-Timeouts. Die Spring-Konfigurationen sollten dabei nur mit größter Sorgfals geändert werden, da dies die Verarbeitung eingehender Nachrichten stören kann.

Mögliche Konfigurationsparameter und ihre default-Werte sind wie folgt:

imagemaster:
  mapping:
    messageAttributes:
      messageId: messageId
      referenceId: referenceId
      direction: direction
      started: started
      finished: finished
      formatIn: formatIn
      formatOut: formatOut
      vdewType: vdewType
      vdewVersion: vdewVersion
      state: state
      acknowledgement: acknowledgment
      partner: partner
      sender: sender
      alternativeId: alternativeId
      channelId: channelId
      clearingCode: clearingCode
    certificateAttributes:
      id: id
      serialNumber: serialNumber
      hashId: hashId
      subjectDN: subjectDN
      subjectAlternativeName: subjectAlternativeName
      issuerDN: issuerDN
      signatureAlgorithm: signatureAlgorithm
      signature: signature
      ski: ski
      aki: aki
      validFrom: validFrom
      validTo: validTo
      rsaKeyLength: rsaKeyLength
      usageSignature: usageSignature
      usageEncryption: usageEncryption
      usageCertificateSigning: usageCertificateSigning
      crlUris: crlUris
      createTime: createTime
      sha1Fingerprint: sha1Fingerprint
      md5Fingerprint: md5Fingerprint
      alias: alias
      clientName: clientName
    content:
      fileExtensions:
        AS4_MESSAGE: "bin"
        AS4_MESSAGE_META: "txt"
        AS4_RECEIPT: "xml"
        AS4_RECEIPT_META: "txt"
        API_REQUEST: "json"
        API_REQUEST_META: "txt"
        B3P_BASE_MESSAGE: "edi"
        CERTIFICATE: "pem"
      primary: "B3P_BASE_MESSAGE"
  connectTimeoutSeconds: 10
  readTimeoutSeconds: 5

spring:
  cloud:
    function:
      definition: consumePersistenceQueueArchiveMessage
    stream:
      bindings:
        consumePersistenceQueueArchiveMessage-in-0:
          destination: b2b.archiving.persistence_queue
          group: default
          consumer:
            maxAttempts: 1
            concurrency: 20
        produceSuccessMessage-out-0:
          destination: b2b.archiving.success_queue
          group: default
        produceErrorMessage-out-0:
          destination: b2b.archiving.error_queue
          group: default
      rabbit:
        bindings:
          consumePersistenceQueueArchiveMessage-in-0:
            consumer:
              requeueRejected: true
              republishToDlq: false
              quorum:
                enabled: true
          produceSuccessMessage-out-0:
            producer:
              exchange-type: topic
              quorum:
                enabled: true
          produceErrorMessage-out-0:
            producer:
              exchange-type: topic
              quorum:
                enabled: true

Optionale Mapping-Regeln für den documentType:

imagemaster:
  mapping:
    messageAttributeDocTypes:
      - value: # beliebiger Dokumententyp, z.B. Fahrplan_BKV, Fahrplan_UENB, Marktkommunikation, API_Maloid, API_Unbestimmt
        partner: # Komma-separierte Liste von ILNs
        sender: # Komma-separierte Liste von ILNs
        direction: # inbound oder outbound
        types: # Komma-separierte Liste von VDEW Types (z.B. UTILMD, SCHEDULE)
        formatIn: # Wert des Eingangsformats, z.B. xml
        channel: # B2B Channel
    fallbackDocType: # Dokumententyp, der verwendet werden soll, wenn keine Regel passt, z.B. AS4_Unbestimmt
    certificateDocType: # Dokumententyp für zu archivierende Zertifikate
    docTypeClassifications:
        - docType: # Dokumententyp, für den die Klassifikationen festgelegt werden
          confidentialityClass: # Wert für CC, mögliche Werte C1 bis C4
          personalData: # Wert für PD, mögliche Werte true oder false
          source: # Wert für das Quellsystem, beliebiger String
    defaultConfidentialityClass: # zu verwendender Wert für CC, falls nicht gesondert pro Dokumententyp konfiguriert
    defaultPersonalData: # zu verwendender Wert für PD (true/false), falls nicht gesondert pro Dokumententyp konfiguriert
    defaultSource: # zu verwendender Wert für source, falls nicht gesondert pro Dokumententyp konfiguriert
View Me   Edit Me