Ü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.

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