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 |
|---|---|
|
root folders ( |
|
published forms (schema, UI schema, key, online state) |
|
per-form configuration (for example FormGrid layout, translations) |
|
drafts: saved but not yet submitted form data, per user / form / business object |
|
files uploaded with a draft |
|
messages sent by Acta Nova |
|
task-related data |
|
requested expert-search reports and their result files |
|
payment transactions |
|
binaries pushed by Acta Nova |
|
per-user data such as registered push tokens |
|
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.
