AEP B2B Flex UI Adapter

Einleitung

Die Flex-basierte Benutzeroberfläche (Adobe AIR Client) ist nicht mehr Bestandteil der Java-25-Version der AEP.B2B. Dies betrifft Installationen, die Flex-basierte Funktionen beispielsweise für das CCM-Monitoring verwenden.

Für den Weiterbetrieb stellt Arvato Systems den AEP B2B Flex UI Adapter als separaten Microservice einschließlich des Adobe AIR Clients bereit. Der Adapter wird zusätzlich zur AEP.B2B installiert und übernimmt die Kommunikation zwischen dem Adobe AIR Client und der Java-25-Version der AEP.B2B. Dadurch kann der Adobe AIR Client mit seinem bisherigen Funktionsumfang weiterverwendet werden.

Einsatzbereich

Der AEP B2B Flex UI Adapter ist nur erforderlich, wenn Flex-basierte Funktionen weiterhin verwendet werden. Nutzen Sie ausschließlich die Web-Oberflächen der AEP.B2B, sind keine zusätzlichen Maßnahmen erforderlich.

Installation

Voraussetzungen

Für den Betrieb des AEP B2B Flex UI Adapters benötigen Sie eine AEP.B2B-Installation auf Java 25. Der Adobe AIR Client wird mit dem Adapter bereitgestellt. Der Adapter wird als zusätzlicher Microservice in der bestehenden Docker-Compose-Umgebung betrieben.

Auf dem Docker-Host müssen Docker und Docker Compose installiert sein. Darüber hinaus benötigt der Docker-Host Zugriff auf die Container-Registry, damit das Docker-Image bezogen werden kann. Hinweise zur Einrichtung finden Sie unter Docker-Setup.

Bereitstellung

Das Setup wird über Ihre bestehende docker-compose.yml und die zugehörige .env-Datei ergänzt. Legen Sie die mit dem Adapter bereitgestellten Konfigurationsdateien in einem eigenen Verzeichnis innerhalb Ihrer Docker-Compose-Umgebung ab, zum Beispiel:

| base/
	|- flex-ui-adapter/
	|  |- <Konfigurationsdateien aus dem Bereitstellungspaket>
	|- docker-compose.yml
	|- .env

Ergänzen Sie anschließend einen Service für den Adapter in der docker-compose.yml. Verwenden Sie für Installationen ohne CAS-Anbindung das Standard-Image und für Installationen mit CAS-Anbindung das CAS-Image. Die für Ihr AEP.B2B-Release freigegebenen Image-Namen und Versionen finden Sie in den AEP.B2B Downloads.

Ergänzen Sie die im Bereitstellungspaket enthaltenen Volumes, Ports und weiteren Umgebungsvariablen beim Adapter-Service. Diese Angaben können je nach eingesetzter Variante und Release abweichen und sind entsprechend der jeweiligen Release-Dokumentation zu verwenden.

  b2b-flex-ui-adapter:
    image: ${AZURECR_AEP}/aep-b2b-flex-ui-adapter-standard:${VER_B2B_FLEX}
    #image: ${AZURECR_AEP}/aep-b2b-flex-ui-adapter-cas:${VER_B2B_FLEX}
    build:
      context: .
      dockerfile: Dockerfile
    hostname: b2b-flex-ui-adapter
    restart: always
    ports:
      - "8084:8080"
      - "18003:18003"
    environment:
      TZ: ${TIME_ZONE}
      # DB-Konfiguration (Werte aus .env)
      B2BBP_DRIVER_CLASS: ${B2BBP_DRIVER_CLASS}
      B2BBP_DBCONNECTION: ${B2BBP_DBCONNECTION}
      B2BBP_DBUSER: ${B2BBP_DBUSER}
      B2BBP_DBPWD: ${B2BBP_DBPWD}
      SPRING_PROFILES_ACTIVE: standard
      JAVA_TOOL_OPTIONS: >-
        -Dfile.encoding=ISO-8859-1
        -Djava.net.preferIPv4Stack=true
        -Duser.country=DE
        -Duser.language=de
        -Xmx2g -Xms512m
        -Xdebug -Xrunjdwp:transport=dt_socket,address=18003,server=y,suspend=n
    volumes:
          - ${TOMCAT_ALL:-.}/index:/opt/tomcat_all/index
          - ${TOMCAT_ALL:-.}/logs:/opt/tomcat_all/logs
    extra_hosts:
      - b2b-flex-ui-adapter:127.0.0.1

Start und Überprüfung

Starten Sie den Adapter gemeinsam mit der Docker-Compose-Umgebung. Prüfen Sie anschließend, ob der Container ausgeführt wird, und testen Sie die Verbindung sowie die Anmeldung mit dem bereitgestellten Adobe AIR Client. Kontrollieren Sie außerdem die verwendeten Monitoring- und Administrationsfunktionen, beispielsweise das CCM-Monitoring, sowie die Anwendungsprotokolle auf Kommunikationsfehler.

Weitere Hinweise zur Migration finden Sie im AEP.B2B Migration Guide.