This page lists the Gentics-side building blocks of ANDP, what each one contains, how it is delivered, and where it is documented. For the picture of how they fit together see Architecture.

Acta Nova Mesh plugin (acta-nova-plugin)

A Gentics Mesh plugin (Java, Vert.x, Dagger). It is the integration hub between front office and back office – see Back-office / front-office integration for the interactions.

Delivered as: Maven artifact com.gentics.andp:acta-nova-plugin, contained in the ANDP Mesh image.

Configuration: config.yml (connection to Acta Nova, CMS REST API, mail, keys, payment, app) and features.yml (feature switches), both overridable with environment variables (MESH_PLUGIN_ACTA_NOVA_*, ACTA_NOVA_PLUGIN_FEATURE_*). The complete, generated reference is in Configuration and settings of the Acta Nova Mesh plugin.

Data model: the plugin creates these schemas in the ANDP Mesh project on start-up:

Schema Holds

acta_nova_folder

root folders (/actanova/forms, /actanova/notifications, /actanova/tasks, /actanova/reports, …​)

acta_nova_form

published forms (schema, UI schema, key, online state)

acta_nova_form_config

per-form configuration (for example FormGrid layout, translations)

acta_nova_form_data

drafts: saved but not yet submitted form data, per user / form / business object

acta_nova_binary

files uploaded with a draft

acta_nova_notification

messages sent by Acta Nova

acta_nova_task

task-related data

acta_nova_report

requested expert-search reports and their result files

acta_nova_transaction

payment transactions

acta_nova_published_content

binaries pushed by Acta Nova

acta_nova_userref

per-user data such as registered push tokens

acta_nova_cleanup_task

state of the clean-up tasks

Also contains: the clean-up tasks and endpoints (Clean-up handler), the ANDP translations backend (Translations), e-mail sending (Email configuration), push notifications via Firebase Cloud Messaging, the PostFinance payment integration, and the static files of the CMS custom tools.

Extension: the acta-nova-plugin-custom module is a template for a project-specific plugin that extends the Acta Nova plugin (new handlers, overridden services, hooks).

Portal module (mesh-portal-andp)

An extension module for Gentics Portal \| java. It adds to the generic portal:

  • the ANDP portal applications: service catalog and favourites (user dashboard), forms, onboarding form, messages, tasks, business cases, maintenance mode, page redirects;

  • the proxy for the Acta Nova Mesh plugin (/api/acta-nova/*), which adds the user token and user context;

  • the portal API under /api/andp/…​: services (/services/:lang), business cases and details, documents, favourites, translations (/translate/:lang), user information, notifications read state, terms of use and wizard (/acceptTermsOfUse, /wizardDone), app configuration (/appconfig), message deep links;

  • the first-login flow (terms of use → onboarding → wizard), the maintenance mode for forms, auto-logout, logout redirect, role initialisation and user-specific caching;

  • Handlebars helpers for the templates (rendering a form, language switcher, translations, role checks);

  • the configuration class ANDPConfig (ANDP_* environment variables), documented in Configuration for portal.

Delivered as: Maven artifact com.gentics.andp:mesh-portal-andp, contained in the ANDP portal image.

The portal is documented in the Gentics Portal \| java guides. Projects that run Gentics Portal \| php use the PHP package gentics/andp with the equivalent functionality.

FormGen and the MicroApps

FormGen is Gentics' form renderer for the CMS Forms feature, built with React Native / Expo and compiled for web and native. ANDP uses FormGen with the andp form type and three further MicroApps:

  • Messages – list and detail of messages, mark as read, delete, open linked forms and documents;

  • Business Cases – list of records with documents and messages;

  • Tasks – pending activities with links to the communication forms.

Together with the portal’s navigation, login menu, footer and service catalog they make up the user interface. The MicroApps are styled independently of the portal’s own stylesheets (see Custom styling), can be customised per project by overriding element renderers and block elements (FormGrid and custom elements), and – in the native app – use the MicroAppSDK to interact with the host app.

Delivered as: web builds served by the portal as static files (ANDP_FORMGEN_STATIC_*, ANDP_CPA_STATIC_*); sources are part of the ANDP reference project (the cross-platform app workspace) and of the FormGen sources matching the CMS version.

Native app

Since ANDP 8.4 the MicroApps can be packaged as a native Android / iOS app. The app

  • authenticates against Keycloak directly (OIDC with react-native-app-auth), optionally with biometric login through a dedicated Keycloak client;

  • loads its configuration from the portal (/api/andp/appconfig);

  • contains the service overview, messages, business cases, tasks, forms, settings and profile;

  • receives push notifications through Firebase Cloud Messaging when a message arrives (feature feature_app_fcm; device tokens are registered through the plugin).

Branding and store publishing are per project. See Native apps and App biometric and Keycloak configuration.

Gentics CMS: packages, form type and custom tools

The ANDP reference project ships CMS packages with the tag types, templates, object properties and settings the portal templates expect – for example the ANDP settings template (onboarding form URL, terms-of-use pages, languages) and the andp_roles construct for role-based visibility. The andp form type in conf/forms.yml defines the controls, block elements and form flows available in the form editor (Configuration for forms).

Two custom tools appear in the CMS editor UI and are served by the Acta Nova Mesh plugin:

  • ANDP translations – edit the portal’s translation keys per language (Translations);

  • Terms-of-use reset – invalidate all users' acceptance after the terms changed.

Form-specific translations are handled by the CMS Forms feature itself (separate custom tool).

Mesh Keycloak plugin (andp-keycloak-plugin)

The Gentics Mesh Keycloak plugin, configured for ANDP: maps Keycloak users and token claims to Mesh users, roles and groups, and – when dynamic roles are enabled – calls the Acta Nova plugin’s user metadata endpoint on login (actaNovaUserMetadataEndpoint, with a timeout) to add the user’s Acta Nova roles. See the Keycloak plugin guide and Dynamic roles.

Keycloak

Standard Keycloak with an ANDP realm: the portal client for the web portal, a biometrics client for the app, identity-provider brokering (ID Austria, AGOV, …​), and the roles described in Concepts. Keycloak is operated as part of the ANDP installation but is not a Gentics product.

Reference project and delivery

The ANDP reference project (andp-project) is the template for every customer installation: Docker Compose and Helm charts for CMS, Mesh, portal(s), Keycloak and proxy; the portal templates, queries and configuration; CMS packages; the FormGen / MicroApp workspace; Keycloak realm export; and an update guide for moving a project to a new ANDP version. Every ANDP release updates the reference project and publishes:

  • Docker images under docker.gentics.com/andp/…​ (portal, Mesh with plugins, CMS packages),

  • Maven artifacts (acta-nova-plugin, mesh-portal-andp, andp-guides),

  • the PHP package gentics/andp,

  • the changelog and the dependency report (SBOM).

The case worker cockpit (Sachbearbeiter Cockpit), available since ANDP 8.6, adds a case-worker-facing UI on the Gentics side; see Sachbearbeiter Cockpit. It replaces the earlier case worker portal, which is deprecated.