The Acta Nova Dialog Portal is documented by both partners. This page tells you which document to open for which question.

Front office (Gentics)

Document Covers

ANDP guides (this documentation)
https://www.gentics.com/guides/latest/andp/

Product overview (this section); configuration of forms, portal and Mesh plugin; customising FormGen, MicroApps and styling; the MicroAppSDK; how-tos. English, versioned with ANDP.

ANDP information pages in the Infoportal
https://www.gentics.com/cmp8/manual/gentics-cmp-manual (section Acta Nova Dialog Portal)

Feature descriptions, business partner services, messages, native apps, out-of-the-box design, the case worker cockpit, lifecycle and roadmap, dependency report.

ANDP changelog
https://www.gentics.com/andp/changelog/

All changes per release including required manual changes when updating a project.

Gentics CMP documentation
https://www.gentics.com/Content.Node/cmp8/guides/

The platform ANDP runs on: Gentics CMS (including the Forms feature and FormGen), Gentics Mesh, operations (Docker, Kubernetes).

Gentics Portal | java guides
https://www.gentics.com/guides/latest/portal-java/

The portal framework: templates, helpers, authentication, Mesh plugins, caching, API endpoints.

Keycloak plugin guide
https://www.gentics.com/guides/latest/plugins/keycloak-plugin/

The Mesh plugin that maps Keycloak users to Mesh users and roles.

ANDP reference project (andp-project, Gentics GitLab; available to project teams)

Setting up and updating a customer project: Docker Compose / Helm, templates, packages, update guide.

Open API specifications
https://www.gentics.com/guides/latest/api-docs/

Generated API references of the CMP components. An ANDP specification is planned.

Back office (RUBICON)

RUBICON delivers its manuals as PDF with each Acta Nova release; they are numbered by the Acta Nova release ("Acta Nova Dialog Portal 13.0 – …​"). They are written in German and are available to customers and partners from RUBICON.

Document Covers

Handbuch fΓΌr Installation und Betrieb

Installing and operating Acta Nova with the Dialog Portal plug-in: system requirements, server roles, deployment (including Windows containers), IIS, database, background services, logging, updates, tenant transfer, health check, and the complete list of configuration parameters – including the DialogPortal_* parameters for the connection to the front office (base URL, JWT authentication, certificates).

Administratorhandbuch

Administering Acta Nova: master data, catalogs, Fachdaten, permissions, templates, workflows – and the chapter Frontoffice: form object types, Fachdaten properties for front-office forms, creating and publishing a form, form properties, dispatch templates for communicating with front-office users, the standard Dialog Portal workflow activities.

Benutzerhandbuch

Using Acta Nova as a case worker, including sending messages through the Dialog Portal and working with front-office users and business partners.

Customizinghandbuch

Configuration modules and dynamic modules, including the Dialog Portal-specific modules: JWT authentication modules, autocomplete, Excel export, CSV processing, front-office buttons, async actions, feature toggles, validation and transformation of Fachdaten, endpoints, external links, user metadata.

Richtlinien und Empfehlungen fΓΌr den Einsatz von Konfigurationselementen

Guidelines for Dialog Portal projects: overall architecture, users and organisations, single versus multi-tenant installations, standard use cases (business partner services, the typical dialog, search forms, special forms, messages, tasks, business cases, dynamic roles), form configuration, workflow extensions, technical extension points, naming and sharing rules.

Reading paths

If you are…​ Read, in this order

New to ANDP (any role)

What is the Acta Nova Dialog Portal? β†’ Architecture β†’ Concepts and glossary β†’ Lifecycle of a dialog

Setting up or operating the front office

Architecture β†’ Integration (authentication section) β†’ Mesh plugin configuration β†’ Configuration β†’ the ANDP reference project’s setup guide β†’ Gentics CMP operations guides. On the back-office side: RUBICON Installation und Betrieb, chapters on the Dialog Portal parameters.

Designing services and forms

Concepts β†’ Lifecycle β†’ RUBICON Richtlinien (chapters 3–5) β†’ RUBICON Administratorhandbuch (chapter Frontoffice) β†’ Configuration for forms β†’ Gentics CMS Forms documentation.

An editor

What is ANDP? β†’ Services β†’ Gentics CMS manual (Forms feature, placing forms) β†’ Translations.

Customising the user interface

Front-office components β†’ Customizing β†’ MicroAppSDK β†’ Gentics FormGen documentation.

Extending the integration

Integration β†’ acta-nova-plugin-custom readme (in the ANDP repository) β†’ RUBICON Customizinghandbuch and Richtlinien (chapters 6–7).