Server Konfiguration
Im Bereich Server-Konfiguration werden systemweite Einstellungen und globale Konfigurationsparameter für intracon:bk definiert.
Die hier hinterlegten Parameter wirken zentral auf die Backend-Komponenten des Systems und steuern insbesondere:
- die Dokumentkonvertierung (z. B. Word-Analyse, Template-Interpretation, Bausteinerkennung)
- die Rendering-Engine zur Generierung von Ausgabedokumenten
- die Annahme und Verarbeitung von Dialog- und Batchaufträgen
- die Parallelisierung und Thread-Steuerung systeminterner Prozesse
- die Kommunikation mit externen Quellsystemen (z. B. 21c|ng-Schnittstellen)
- die Weiterleitung von Aufträgen an externe Systeme
- die PDF-Erzeugung inklusive Compliance- und Font-Embedding-Konfiguration
- die serverseitige Drucksteuerung und Druckjob-Verarbeitung
Änderungen in diesem Bereich haben unmittelbare Auswirkungen auf das Systemverhalten aller Mandanten und Benutzer, da die Server-Konfiguration als zentrale technische Steuerungsschicht für sämtliche dokumentenbezogenen Prozesse innerhalb von intracon:bk fungiert.
Template-Erkennung und Word-Konvertierung
| Parameter | Vollständige Beschreibung |
|---|---|
| Bausteinmuster (Regex) | Über den Parameter Bausteinmuster (Regex) werden die Bausteinmuster für die Erkennung der Bausteinfunktion von WinBK-Briefen für die Konvertierung der Dokumente definiert. Standardwert: .ME[\s]?([\w\\-]*) |
| Word Version | Über den Parameter Word Version wird der in kleineren Word-Versionen notwendige Kompatibilitätsmodus definiert. Damit kann das System die Syntax bei der Konvertierung und beim Rendering der Dokumente festlegen. Die Einstellung endet mit der Version 2013. Die Einstellung 2013 gilt für alle Versionen größer/gleich 2013. |
| Template-Analyzer Modell | Über den Parameter Template-Analyzer Modell wird die Version des Konverters festgelegt. Modell 1 ist für WinBK-Briefe und normale Word-Dokumente. Modell 2 ist für erweiterte Word-Dokumente mit Makrofunktionen und externer Steuerung. |
| Bookmark zu Baustein | Über den Parameter Bookmark zu Baustein wird die Übernahme von Bookmarks zu Baustein-Funktionen gesteuert. Dieser Parameter steht im direkten Zusammenhang mit Template-Analyzer Modell – Modell 2. |
| Ungenutzte Formate rausfiltern | Über den Parameter Ungenutzte Formate rausfiltern wird konfiguriert, ob das System ungenutzte Formate im Word-Dokument beim Konvertieren löscht oder übernimmt. |
| Template-Name Property | Der Name der Dokument-Eigenschaft, aus dem der Name für das Template gelesen wird, wenn ein Word-File bei der Konvertierung analysiert wird. |
21c|ng Schnittstellen und Auftragsannahme
| Parameter | Vollständige Beschreibung |
|---|---|
| CRM-Dienst 21c Adresse | Über den Parameter CRM-Dienst 21c Adresse wird die 21c|ng-CRMWebDienst-Schnittstelle konfiguriert. Die Service-URL beschreibt, wo der Web-Service des 21c|ng-Systems zu erreichen ist (21c|ng-Schnittstelle 0067): https://FQDN:Port/crm_webservices/CrmDienstWS. IP und Port sind gegen die Werte des jeweiligen 21c|ng-Systems zu tauschen (IP vom Dialog-Kern und der passende HTTPS-Port). Es ist zu prüfen, ob ein Loadbalancer vor dem Dialog-Kern geschaltet ist. |
| Document Server Adresse | Über den Parameter Document Server Adresse wird die Server-URL konfiguriert, über die das System die Auftragsannahme aus 21c|ng steuert. Dieser Parameter ist obsolet und wurde durch Managed Document Server Adresse ersetzt. |
| Managed Document Server Adresse | Über den Parameter Managed Document Server Adresse wird die Server-URL konfiguriert, über die das System die Auftragsannahme aus 21c|ng gesteuert abwickelt. |
| Document Server Authorization User | Über den Parameter Document Server Authorization User wird eine Benutzer definiert, der für die Authentifizierung des 21c|ng-Systems zur Auftragsübergabe an intracon:bk genutzt wird. Der Benutzer ist im Vorfeld unter Communication → Ressourcen → Benutzer zu hinterlegen. |
| Document Server Authorization ApiKey | Über den Parameter Document Server Authorization ApiKey wird ein ApiKey definiert, der für die Authentifizierung des 21c|ng-Systems zur Auftragsübergabe an intracon:bk genutzt wird. |
Weiterleitung von Aufträgen und Auftragsketten
| Parameter | Vollständige Beschreibung |
|---|---|
| Alle Aufträge an Server weiterleiten | Über den Parameter Alle Aufträge an Server weiterleiten kann gesteuert werden, dass 21c|ng-Aufträge zu Vorlagen, die nicht vorhanden oder freigegeben sind, an ein externes System weitergeleitet werden. Die Konfiguration der Service-URL des externen Systems ist in der Konfigurationsdatei intracon.datacenter.config des Services Documents zu tätigen. Bitte kontaktieren Sie dazu Ihr Rechenzentrum. |
| Auftragsketten immer weiterleiten | Über den Parameter Auftragsketten immer weiterleiten kann gesteuert werden, dass 21c|ng-Auftragsketten zur Brieferstellung an ein externes System weitergeleitet werden. |
| 21c Weiterleitung aktivieren | Über den Parameter 21c Weiterleitung aktivieren wird gesteuert, ob 21c|ng-Aufträge zu Vorlagen, die nicht im System vorhanden oder nicht im System freigegeben sind, an ein externes System weitergeleitet werden. Dieser Parameter muss aktiviert sein, um die Parameter Alle Aufträge an Server weiterleiten und Auftragsketten immer weiterleiten nutzen zu können. |
Mandanten- und Datenannahmefilter
| Parameter | Vollständige Beschreibung |
|---|---|
| MandatorId | Über den Parameter MandatorId wird konfiguriert, welche Auftragsdaten über die 21c|ng-Schnittstelle in das System fließen dürfen. Die MandatorId muss mit der in den vom 21c|ng-System übertragenen Daten enthaltenen MandatorId übereinstimmen. Stimmen die Daten nicht überein, wird der Auftrag abgelehnt. |
intracon:kv Fallbacks und Variablenübernahmen
| Parameter | Vollständige Beschreibung |
|---|---|
| Mitglied als Fami- Fallback aktivieren | Für die Nutzung ist intracon:kv Voraussetzung. Über den Parameter Mitglied als Fami- Fallback aktivieren wird konfiguriert, ob der Variablenstamm famiseleteted.* als Fallback bei nicht vorhandener Fami das Mitglied enthalten soll. |
| Address-Variablen in RecipientVariablen übernehmen | Für die Nutzung ist intracon:kv Voraussetzung. Über den Parameter Address-Variablen in RecipientVariablen übernehmen wird konfiguriert, ob die adress.*-Variablen in den Variablenstamm recipient.* übernommen werden. |
Betreuersteuerung und Alternate-Variablen
| Parameter | Vollständige Beschreibung |
|---|---|
| Betreuer leeren | Über den Parameter Betreuer leeren wird konfiguriert, worauf die Betreuersteuerung reagieren soll. Dieser Parameter steht im direkten Zusammenhang mit Betreuer-Vorhanden Variable. |
| Betreuer-Vorhanden Variable | Über den Parameter Betreuer-Vorhanden Variable wird die Art und Weise konfiguriert, wie das System die Alternate-Variablen verwaltet. Dieser Parameter steht im direkten Zusammenhang mit Betreuer leeren. Mögliche Ausprägungen: Leer/Niemals – Betreuerdaten werden nicht gelöscht (alternate.* bleibt erhalten). Wenn gleich – Betreuerdaten werden mit Empfängerdaten verglichen; bei Gleichheit werden Betreuerdaten gelöscht (alternate.* wird gelöscht). Wenn Variable falsch – zusätzliches Feld zur Angabe einer Variable (Beispiel: source.e_hatbetreuer); steht in der Variable Ja, werden Betreuerdaten nicht gelöscht; steht Nein, werden Betreuerdaten gelöscht. |
Adressvalidierung und Dunkelverarbeitung
| Parameter | Vollständige Beschreibung |
|---|---|
| Address-Validierung bei Dunkelverarbeitung | Über den Parameter Address-Validierung bei Dunkelverarbeitung wird konfiguriert, ob die Anschrift in den gemappten adress.*-Variablen mindestens in folgenden Feldern einen Inhalt aufweist: Name, PLZ, Ort. Bei der Postleitzahl wird darüber hinaus geprüft, ob die PLZ fünfstellig ist, sobald das Länderkennzeichen ein D enthält. Hinweis: Bei Nutzung des Parameters muss zwingend auch der Parameter Adressvalidierung aktivieren in der Starter-Konfiguration genutzt werden. |
Dokumentenstarter und Diagnoseausgaben
| Parameter | Vollständige Beschreibung |
|---|---|
| Starter immer öffnen | Über den Parameter Starter immer öffnen wird konfiguriert, ob sich jeder Dialog-Auftrag im Dokumentenstarter zwingend öffnet. |
| Variablennamen testweise ausgeben | Über den Parameter Variablennamen testweise ausgeben wird konfiguriert, ob Dokumente ohne Datensatz in einer Vorschau oder im gerenderten Dokument die Variablennamen als Platzhalter anzeigen. |
Batchverarbeitung und Parallelisierung
| Parameter | Vollständige Beschreibung |
|---|---|
| Batche direkt abschließen | Über den Parameter Batche direkt abschließen wird konfiguriert, wie das System grundsätzlich mit Massenverarbeitungen nach der Erstellung der Briefe umgeht. Ist der Parameter aktiviert, werden die Aufträge einer Auftragsgruppe grundsätzlich sofort weiterverarbeitet/abgeschlossen. Die Grundeinstellung kann in den Vorlageneigenschaften übersteuert werden. Die Einstellungen in den jeweiligen Vorlageneigenschaften sind führend. Ist der Parameter aktiviert, kann in den Vorlageneigenschaften das direkte Abschließen verboten werden. Ist der Parameter deaktiviert, kann in den Vorlageneigenschaften das direkte Abschließen erlaubt werden. |
| # Threads Batchverarbeitung | Über den Parameter # Threads Batchverarbeitung wird konfiguriert, wie viele Verarbeitungs-Threads parallel genutzt werden können. Die Threads beziehen sich auf Dokument-Render-Prozesse und weitere systemseitige Verarbeitungen (z. B. Prozesse). Die optimale Anzahl ist infrastrukturspezifisch. Startwert kann die maximale Anzahl der Prozessor-Kerne sein. Anschließend kann schrittweise erhöht werden, bis eine Performance-Verschlechterung festgestellt wird. |
| # Threads Batchannahme | Über den Parameter # Threads Batchannahme wird konfiguriert, wie viele Batchannahme-Threads parallel genutzt werden können. Diese Threads übernehmen Batch-Aufträge in die Datenbank zur strukturierten Abarbeitung. Bei Massendatenbereitstellung > 50.000 Datensätze kann die Konfiguration während der Annahmephase schrittweise erhöht werden (mehr als 4–5 sollte nicht notwendig sein). Im Anschluss kann die Konfiguration wieder auf 1 gesetzt werden. Eine Einstellung auf 0 veranlasst, dass keine Auftragsdaten mehr in die Datenbank übernommen werden. |
| # Threads Dialogannahme | Über den Parameter # Threads Dialogannahme wird konfiguriert, wie viele Dialogannahme-Threads parallel genutzt werden können. Diese Threads übernehmen Dialog-Aufträge in die Datenbank zur strukturierten Abarbeitung. Bei Massendaten im Dialog > 10.000 Datensätze pro Tag kann die Konfiguration erhöht werden (mehr als 3–4 sollte nicht notwendig sein). Eine Einstellung auf 0 veranlasst, dass keine Auftragsdaten mehr in die Datenbank übernommen werden. |
| Startzeit Batchverarbeitung | Über den Parameter Startzeit Batchverarbeitung wird konfiguriert, in welcher Zeitspanne die Batchverarbeitung läuft. Hier wird konkret der Startzeitpunkt der Batchverarbeitung definiert. Außerhalb des definierten Zeitraums wird keine Batchverarbeitung durchgeführt. |
| Endzeit Batchverarbeitung | Über den Parameter Endzeit Batchverarbeitung wird konfiguriert, in welcher Zeitspanne die Batchverarbeitung läuft. Hier wird konkret der Endzeitpunkt der Batchverarbeitung definiert. Außerhalb des definierten Zeitraums wird keine Batchverarbeitung durchgeführt. |
| Minimale Rückmeldezeit(s) | Obsolet. |
Summary- und Inhaltsübergabe
| Parameter | Vollständige Beschreibung |
|---|---|
| Summary-Format | Über den Parameter Summary-Format wird konfiguriert, welches Format der Summary-Text hat. Zur Auswahl stehen: Leer – keine Einstellung; HTML – Text aus dem <Summary>-Tag wird als HTML übergeben (empfohlen); Text – Text aus dem <Summary>-Tag wird als reiner Text übergeben; Rtf – Text aus dem <Summary>-Tag wird als RTF-Text übergeben. |
Kopf-/Fußzeilensteuerung
| Parameter | Vollständige Beschreibung |
|---|---|
| Default Header/Footer benutzen | Über den Parameter Default Header/Footer benutzen wird konfiguriert, wie Kopf- und Fußzeilen gesteuert werden. Ist der Parameter aktiviert, muss jede Kopf-/Fußzeile explizit gesetzt werden. Ist der Parameter deaktiviert, werden Kopf-/Fußzeilen vererbt und es muss aktiv eine leere Kopf-/Fußzeile gesetzt werden. Hinweis: Der Parameter wird hier nur angezeigt; die eigentliche Einstellung wird in intracon.Datacenter.config des Documents-Service vorgenommen. |
PDF-Ausgabe und Schrifteinbettung
| Parameter | Vollständige Beschreibung |
|---|---|
| PDF Compliance | Über den Parameter PDF Compliance wird konfiguriert, welche PDF-Version für die Ausgabe genutzt werden soll. Folgende Einstellungen stehen zur Verfügung: Leer (Basis Pdf17), Pdf17, Pdf20, PdfA1a (Basis Pdf17), PdfA1b (Basis Pdf17), PdfA2a (Basis Pdf17), PdfA2u (Basis Pdf17), PdfA4 (Basis Pdf20), PdfAUa1 (Basis Pdf17). Bei Bedarf kann die PDF-Compliance getauscht werden. Standardmäßig wird Leer bzw. Pdf17 verwendet. Hinweis: Die jeweilige PDF-Compliance beeinflusst den Speicherbedarf eines PDF-Dokuments. |
| PDF Fontembedding-Mode | Über den Parameter PDF Fontembedding-Mode wird konfiguriert, wie Schriftarten in das PDF eingebunden werden. Einstellungen: Leer, EmbedNone – keine Einbettung, nur Verweise; Darstellung abhängig von vorhandenen Fonts, andernfalls Font Substitution. EmbedNonstandard – nur nicht standardisierte Fonts werden eingebettet, Standardfonts (z. B. Helvetica, Times, Courier) nicht. EmbedAll – alle verwendeten Schriftarten werden vollständig eingebettet; PDF ist selbstständig, resultiert aber in größeren PDF-Dateien. |
| PDF embed full Fonts | Über den Parameter PDF embed full Fonts wird konfiguriert, ob die komplette Schriftdatei (alle Glyphen und Tabellen) in das PDF eingebettet wird und nicht nur die tatsächlich verwendeten Zeichen. Dies führt zu deutlich größeren PDF-Dateien. Hinweis: Abhängig von der Fontlizenz (nicht jeder Font darf vollständig eingebettet werden). |
| PDF-Beilagen nach DIN A4 skalieren | Über den Parameter PDF-Beilagen nach DIN A4 skalieren wird konfiguriert, ob Beilagen nach DIN A4 skaliert werden. Hinweis: Diese Operation ist sehr rechenintensiv und sollte nicht standardmäßig aktiviert sein. Empfehlung: Nutzen Sie stattdessen die vorlagenbezogene Konfiguration. |
Drucksteuerung und Druckjob-Parameter
| Parameter | Vollständige Beschreibung |
|---|---|
| Direktdruck unterstützen | Über den Parameter Direktdruck unterstützen wird konfiguriert, ob das System den sofortigen Druck eines Dokumentes unterstützt. |
| Druckauflösung (DPI) | Über den Parameter Druckauflösung (DPI) wird konfiguriert, wie hoch die Druckauflösung ist. Dieser Parameter wird nicht mehr verwendet. |
| Druckjobname-Muster | Über den Parameter Druckjobname-Muster wird konfiguriert, welchen Namen der Druckjob in der Windows-Drucker-Queue haben soll. Der Name kann aus konstanten Werten sowie Auftragsinformationen bestehen. Auftragsinformationen werden über Felder in { } referenziert. Beispiel: Auftrag_{pageCount}_{general.template-name}_{general.constantid} |
| Maximale Anzahl an Seiten pro Druckauftrag | Über den Parameter Maximale Anzahl an Seiten pro Druckauftrag wird konfiguriert, wie viele Seiten ein Druckauftrag zur Übergabe an die Windows-Drucker-Queue enthalten darf. Sind mehr Seiten als konfiguriert, wird das Dokument in mehrere Teile aufgeteilt, um die Windows-Drucker-Queue nicht zu überlasten. |
| Druckskalierung deaktivieren | Über den Parameter Druckskalierung deaktivieren wird konfiguriert, ob das System eine 5%ige Druckskalierung im serverseitigen Druck vornimmt. Ist der Parameter nicht aktiv, wird das Druckergebnis im serverseitigen Druck um 5% verkleinert. |
| Druckdienst - Große PDF Dokumente drucken | Über den Parameter Druckdienst - Große PDF Dokumente drucken wird ein Performance-Hinweis für die Druck-Bibliothek gesetzt. |
Beilagen, Dokumentstruktur und Bildlayer
| Parameter | Vollständige Beschreibung |
|---|---|
| Dokument-Struktur nach PDF konvertieren | Über den Parameter Dokument-Struktur nach PDF konvertieren wird konfiguriert, ob die interne Dokument-Struktur mit Ankern und Kapiteln in das PDF konvertiert wird. |
| Beilagen in Word einbetten | Über den Parameter Beilagen in Word einbetten wird konfiguriert, ob PDF-Teile einer Auftragskette (Listenanteile) konvertiert werden und Teil des Dokuments werden, welches in der Auftragskette die Position vor dem PDF-Teil hat. Hinweis: Diese Funktion ist statisch und kann nicht beeinflusst werden. Das Ergebnis ist technisch determiniert. Empfehlung: Für die Übernahme von PDF-Teilen sollte die Funktion genutzt werden, die Auftragsdaten bereits als Briefauftrag in Richtung intracon:bk sendet. Sprechen Sie zu den nötigen 21c|ng-Einstellungen Ihr Rechenzentrum an. |
| Bildlayer skalieren | Über den Parameter Bildlayer skalieren wird konfiguriert, ob Bildlayer bei erster Benutzung skaliert und im Cache gehalten werden und somit schneller im System verfügbar sind. |
| Bildlayer im Pdf einfügen | Über den Parameter Bildlayer im Pdf einfügen wird konfiguriert, ob Bildlayer erst im fertigen PDF eingebunden werden. |
Benutzer- und Domänenlogik
| Parameter | Vollständige Beschreibung |
|---|---|
| Domäne für Konten ignorieren | Über den Parameter Domäne für Konten ignorieren wird konfiguriert, ob bei einer z. B. Novel-User/Netz-Verwaltung die Domäne für die User-Identifizierung unberücksichtigt bleibt. |
Templates, Deckblätter und Adapter
| Parameter | Vollständige Beschreibung |
|---|---|
| Default-Deckblatt Templatename | Über den Parameter Default-Deckblatt Templatename wird konfiguriert, welches Template bei der Nutzung der Funktion Abschrift an den Versicherten bei vorhandenem Betreuer als Deckblatt für die Anschrift an den Betreuer genutzt werden soll. |
| Alten WinbkAdapter nutzen | Über den Parameter Alten WinbkAdapter nutzen wird konfiguriert, wie das System die Auftragsdaten aus 21c|ng aufbereitet. Dieser Parameter ist zwingend zu setzen. |
Namensgeneratoren und Prozesskennungen
| Parameter | Vollständige Beschreibung |
|---|---|
| Generator Dokumentnummer | Über den Parameter Generator Dokumentnummer wird konfiguriert, ob und wenn welcher Namensgenerator genutzt werden soll, um eine gut lesbare Auftragsnummer (quellenübergreifend: 21c|ng, Prozessadapter, etc.) zu generieren. Die Auftragsnummer kann parallel zu den Original-Auftragsnummern des Quellsystems zur Auftragsidentifizierung genutzt werden. Hinweis: Der Namensgenerator muss im Vorfeld unter Communication → Namensgenerator erfasst worden sein. |
| [Preview] Generator Freigabeprozessnummer | Über den Parameter [Preview] Generator Freigabeprozessnummer wird über einen zu hinterlegenden Namensgenerator eine eindeutige Freigabe-Prozess-Nummer generiert und für die Nutzung jedes Freigabeprozesses bereitgestellt. Hinweis: Der Namensgenerator muss im Vorfeld unter Communication → Namensgenerator erfasst worden sein. |
Auftragskettensteuerung und Beilagenfreigaben
| Parameter | Vollständige Beschreibung |
|---|---|
| JobChain Timeout (s) | Über den Parameter JobChain Timeout (s) wird konfiguriert, wie lange das System in Sekunden auf die Vervollständigung einer Auftragskette aus dem Quellsystem warten soll, bevor es die Verarbeitung fortsetzt. |
| Manuelle Beilagen erlauben | Über den Parameter Manuelle Beilagen erlauben wird konfiguriert, ob das System grundsätzlich die vorlagenbezogene Konfiguration von manuellen Beilagen zulassen soll. |
SOAP-Debug und Dateiablage
| Parameter | Vollständige Beschreibung |
|---|---|
| Soap-Debug aktivieren | Über den Parameter Soap-Debug aktivieren wird konfiguriert, ob ein 21c|ng-Auftrag im Originalformat nur auf Datei-Ebene abgelegt, aber nicht ins System übernommen wird. |
| Soap-Multipart zerlegen | Über den Parameter Soap-Multipart zerlegen wird konfiguriert, ob ein 21c|ng-Auftrag im Originalformat nur auf Datei-Ebene abgelegt, aber nicht ins System übernommen wird. Dabei wird zusätzlich der potentielle Multipart-Auftrag zerlegt und in einzelnen Dateien abgelegt. |
Zuletzt aktualisiert am