Szenario: Prozesse für die Nachbearbeitung erstellen

Wie bereits erwähnt, wird beim Senden der Korrespondenz der Prozess für die Nachbearbeitung mit der Brief-PDF und der entsprechenden XML-Datei aufgerufen. Die XML-Datei, die für die Nachbearbeitung gesendet wird, verfügt außerdem über zusätzliche Metadaten, die mit dem gesendeten Brief verbunden sind, z. B. Briefname, gesendete Zeit (modificationDate) usw. Die Metadaten befindet sich im ICC Control Data-Bereich unter dem <icc:meta>-Knoten. Beispielsweise lautet die Struktur der XML-Daten, die an den Prozess gesendet wurden, wie folgt:

<DataRoot> 
    ... 
    ... 
    <!-- the usual XML data here --> 
    ... 
    <!-- ICC Control Data --> 
    <icc:icc> 
        ... 
        ... <!-- this section would contain data corresponding to the selected modules --> 
        ... 
        <!-- Metadata section --> 
        <icc:meta> 
            <!-- Any additional incoming metadata, that may have been sent from DC, and already present in the XML --> 
 
            <letter>[Letter name]</letter> 
            <modificationDate>[Letter submit date]</modificationDate> 
 
            <!-- Any other custom attributes/metada sent from DC via the "cm_" rule, will have entries in the XML here --> 
        </icc:meta> 
    </icc:icc> 
</DataRoot>

Wenn Sie die Anwendung erweitern möchten, um eine Umleitung an eine benutzerdefinierte Position (URL) zu ermöglichen, können Sie einen Prozess erstellen, der Vorgänge durchführt und die umgeleitete URL als Antwort zurückgibt. Wenn das Senden erfolgreich war, wird eine XML-Datei mit folgender Struktur als Antwort zurückgegeben:

<iccSubmitResponse> 
    <redirect>{url}</redirect> 
</iccSubmitResponse>

Gibt die Nachbearbeitung eine URL zurück, wird diese URL in der Antwort zurückgegeben (siehe oben). Andernfalls wird das <redirect>-Element entweder nicht angegeben oder es ist leer. Der Aufrufer ist für die Überprüfung der URL zu Sicherheitszwecken verantwortlich. Wird eine umgeleitete URL zurückgegeben, wird der Benutzer auf die benutzerdefinierte Position umgeleitet. Diese Position kann eine Signaturanwendung sein, mit der der Benutzer den abgeschlossenen Brief unterschreiben kann. Sie können ein Tag wie „requireSignature“ hinzufügen, das Sie aus der benutzerdefinierten Version des Briefdienstes eingeben. Um festzustellen, ob eine Umleitung notwendig ist, ermöglichen Sie es, eine Signatur sofort nach dem Senden eines ausgefüllten Briefs erfassen zu können.

Bei Bedarf können Sie die Benutzeroberfläche „Korrespondenz erstellen“ anpassen, um zusätzliche Metadaten an die Nachbearbeitung, die nach dem Senden des Briefs aufgerufen wird, zu senden. Wird das Servlet „Senden“ mit (Anforderungs-)Parametern aufgerufen, deren Namen mit „cm_“ beginnen, werden Attribute unter Knoten mit dem Namen, der der Zeichenfolge nach cm_ und dem Wert des Knotens als Wert des Parameters folgt, dem Bereich <icc:meta> hinzugefügt.

Wenn beispielsweise ein angeforderter Parameter cm_agent=Mark Robinson an das Servlet gesendet wird, hätte der <icc:meta>-Knoten einen untergeordneten Knoten <agent>Mark Robinson</agent>, wie in diesem Beispiel gezeigt wird:

Beispiel:

<DataRoot> 
    ... 
    ... 
    <!-- the usual XML data here --> 
    ... 
    <!-- ICC Control Data --> 
    <icc:icc> 
        ... 
        ... <!-- this section would contain data corresponding to the selected modules --> 
        ... 
        <!-- Metadata section --> 
        <icc:meta> 
            <!-- Any additional incoming metadata, that may have been sent from DC, and already present in the XML --> 
 
            <letter>SampleLetter</letter> 
            <modificationDate>2010-08-28T08:55:59</modificationDate> 
                <agent>Mark Robinson</agent> 
            <!-- Any other custom attributes/metada sent from DC via the "cm_" rule, will have entries in the XML here --> 
        </icc:meta> 
    </icc:icc> 
</DataRoot>