EUCA

Eine light-weighted Version ohne Gentics CMS und Gentics Portal.

Diese Lösung beinhaltet die folgenden Komponente:

1. Gentics Mesh

Installationsanleitung: https://getmesh.io/docs/administration-guide/
Version: https://www.gentics.com/cmp/changelog/ - (ANDP 2.2 - Gentics CMP 8.0.0)

2. ADNP-Plugin

Hier ist der Link zum Download des Plugins: https://repo.gentics.com/repository/maven-releases/com/gentics/andp/mesh-acta-nova-plugin/<VERSION>/mesh-acta-nova-plugin-<VERSION>.jar (<VERSION> durch die gewünschte ANDP Version ersetzen, z.B. 2.2.1 Siehe Changelog)

Senden Sie eine Anfrage an "servicedesk@jira-gentics.atlassian.net", damit Sie das ANDP-Plugin (.jar File) herunterladen können. Dieses JAR File lagern Sie bitte in Ihrem Mesh direkt im Folder /mesh-plugins

3. Acta-Nova

Bitte stellen Sie sicher, dass bereits eine Acta-Nova-Instanz vorhanden ist und korrekt mit Mesh verbunden wurde. Dazu muss die Environment-Variable in Mesh MESH_PLUGIN_ACTA_NOVA_AN_BASE_URL entsprechend auf die URL Ihrer Acta-Nova-Instanz angepasst werden.

z.B. https://%domain%/.../webservices/api/v1/backoffice/

Integration

Proxy Konfiguration:

Bitte stellen Sie sicher, dass die Proxy-Konfiguration korrekt auf Mesh und Acta-Nova ausgerichtet ist. Ein konkretes Konfigurationsfile z.B für Apache Server kann folgendermaßen aussehen:

Konfigurationsfile für Apache Proxy: proxy.conf



<VirtualHost *:80>

    DocumentRoot /var/www/html

    SSLProxyEngine on

    ProxyPreserveHost Off

    

    # Actanova-Instanz

    ProxyPass /api/acta-nova <URL Ihrer Acta Nova-Instanz>

    ProxyPassReverse /api/acta-nova <URL Ihrer Acta Nova-Instanz>

    

    # Gebaute JS- und CSS-Dateien (in Mesh)

    ProxyPass /static/formgen/static <{Ihre Mesh-Instanz}/api/v2/andp/plugins/acta-nova/webroot/formgen/static>

    ProxyPassReverse /static/formgen/static <{Ihre Mesh-Instanz}/api/v2/andp/plugins/acta-nova/webroot/formgen/static>

    

    # Übersetzungen (Standard-URL ist die URL für Übersetzungen, ändern Sie die Quelle, falls Sie eine andere Quelle haben)

    ProxyPass /static/translations <Standard URL - {Ihre Mesh-Instanz}/api/v2/andp/plugins/acta-nova/webroot/formgen/static/translations>

    ProxyPassReverse /static/translations <Standard URL - {Ihre Mesh-Instanz}/api/v2/andp/plugins/acta-nova/webroot/formgen/static/translations>

</VirtualHost>

Bootstrap (css + js) einbinden:

Wir verwenden die Bootstrap Version 5.3

https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css
https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js

Es besteht die Möglichkeit, dass die aufgeführten URLs geändert wurden. Bitte überprüfen Sie dies zur Sicherheit erneut.

Einbinden von React-App

Binden Sie zuerst die CSS Ressourcen, die dann für die React App verwendet werden.

/static/formgen/static/css/index.css
/static/formgen/static/css/style.css

Proxy Konfigurationen werden diese zwei Request zu Mesh umleiten.

Fügen Sie die React-App (den folgenden HTML Snippet) auf die Stelle der Seite ein, wo das Formular gerendert werden soll.



<div id="root" tabindex="0" data-formID="<Formular-ID>" 

style="max-width: max-content;" data-culture="de" 

data-translation-url="/static/translations">

    <script type="module" src="/static/formgen/static/js/index.js"></script>

</div>

Erklärung zum HTML Snippet:

Bitte konfigurieren Sie manuell alle Parameter, die mit <> gekennzeichnet sind.

data-formID: Die ID des Formulars, welcher geladen werden soll.
data-translation-url : Die Übersetzungsquelle (Standard /static/translations (siehe Oben Proxy Konfiguration)

Übersetzungskonfiguration

Wenn Sie die Übersetzungsquelle ändern wollen, müssen Sie wie oben beschrieben, die Variable data-translation-url ändern. (Für Wordpress Integration ist die Änderung von dieser Variable bisschen anders: Übersetungskonfiguration Wordpress)

Wichtig: Es ist von großer Bedeutung sicherzustellen, dass die Struktur des Übersetzungsdateisystems wie folgt aufgebaut ist: Für jede Sprache existiert ein separater Ordner mit dem Namen der Sprache (de), in dem sich eine Datei namens "form.json" befindet. Diese Datei enthält die eigentlichen Übersetzungen wie z.B: "de/form.json"

Boxed Solution