Die Komponente INTRACON:Create Contact Writer dient zur Erstellung eines KontaktCenter-Eintrags (KC-Eintrag) im System intracon:kv.

Hierzu adressiert die Komponente die KontaktCenter-API des intracon:kv-Systems und überträgt die erforderlichen Prozessdaten aus dem intracon:bk-Prozesskontext an den entsprechenden REST-Endpunkt.

Die Kommunikation mit dem Zielsystem erfolgt über einen HTTPS-basierten REST-Endpunkt.
Wird im Prozesskontext eine Datei übergeben, erfolgt die Übertragung als multipart/form-data-Request, um sowohl Metadaten als auch Dateiinhalte an die API zu übermitteln.

Konfigurationsparameter

Feld	Beschreibung
Service-URL	Vollständige URL des REST-Endpunkts der KontaktCenter-API, z. B. https://FQDN:Port/api/hcv/kontakteintrag/multipart. FQDN und Port sind systemspezifisch anzupassen und müssen auf den jeweiligen API-Endpunkt des intracon:kv-Systems verweisen.
Service-ApiToken	API-Token zur Authentifizierung am REST-Endpunkt. Die Authentifizierung erfolgt über Bearer-Token im HTTP-Header. Der Token wird durch den Betreiber des intracon:kv-Systems bereitgestellt und muss über die erforderlichen Berechtigungen zum Erstellen von KC-Einträgen verfügen.
Daten-Quelle	Definiert die Datenquelle im Prozesskontext, aus der die fachlichen Informationen für den KC-Eintrag gelesen werden. Die Quelle verweist auf ein Objekt innerhalb der Prozessdatenstruktur.
Datei-Quelle	Optional. Definiert ein Dateiobjekt aus dem Prozesskontext, das dem KC-Eintrag als Dokumentanhang übergeben wird. Wird eine Datei übergeben, erfolgt die API-Kommunikation automatisch als multipart-Request.
Archiv-MimeType	Definiert den Content-Type der übergebenen Datei (z. B. application/pdf). Der Wert wird im Request verwendet, um den Dateityp korrekt an die KontaktCenter-API zu übermitteln.

Fachliche Informationen im Prozesskontext

Für die korrekte Verarbeitung durch die KontaktCenter-API müssen im Prozesskontext bestimmte Felder mit gültigen Werten befüllt sein.
Diese Felder werden während der Prozessverarbeitung durch intracon:bk erzeugt oder aus Vorlagen- bzw. Prozesskonfigurationen übernommen.

Feld	Beschreibung
kc-create	Steuerfeld mit den Werten true oder false. true → Es wird ein KC-Eintrag erzeugt. false → Es erfolgt keine Erstellung eines KC-Eintrags. Die Pflege dieses Parameters erfolgt über Documents → Vorlageneigenschaften im Bereich Kontakthistorie-Eintrag.
kc-summary	Optionales Feld für Zusatzinformationen, z. B. Inhalte aus dem <Summary>-Tag. Der Wert wird als ergänzende Bemerkung in den KC-Eintrag übernommen.
kc-text	Haupttext bzw. Bemerkung des KC-Eintrags. Der Inhalt wird über die Vorlageneigenschaften Kontakthistorie-Eintrag oder manuell im Dokumentenstarter (Bereich OMS / KH-Eintrag) gesetzt.
identifierValue	Enthält den Ordnungsbegriff der Person oder Organisation, für die der KC-Eintrag erstellt wird. Der Wert wird über das Identifier-Mapping aus den Vorlageneigenschaften ermittelt.
identifierType	Enthält den Typ des Ordnungsbegriffs gemäß dem im System definierten Identifier-Mapping.
kc-date	Datum, zu dem der KC-Eintrag im KontaktCenter erzeugt werden soll.
title	Titel des KC-Eintrags. Standardmäßig wird der Titel der verwendeten Dokumentvorlage übernommen.
kc-type	Typ des KC-Eintrags im KontaktCenter. Standardmäßig wird der Typ Dokumentenausgang verwendet.
userId	Benutzer-ID des Anwenders, der als Ersteller des KC-Eintrags gesetzt wird.
kc-kat	Kategorie des KC-Eintrags. Die Pflege erfolgt über die Vorlageneigenschaften.
kc-grp	Gruppenzuordnung des KC-Eintrags. Die Pflege erfolgt über die Vorlageneigenschaften.