Dieses Kapitel ist vor allem dann relevant, wenn CIB doXisign direkt und nicht z.B. über CIB doXiview integriert werden soll. Wird eine Integration über CIB doXiview genutzt, sei hier auf die Schnellstart-Dokumentation von CIB doXiview verwiesen.

Clientseitig wird CIB doXisign in einem IFrame integriert. Die Aufruf-URL ist das Ergebnis des REST Aufrufs „prepare“. 

Damit eine Integration über IFrame-Grenzen hinweg möglich ist, wird das Postmessage Framework CIB iwc (CIB inter window communication) genutzt. Dieses muss der Aufrufer bei sich integrieren und beim Öffnen der URL nutzen. 

Die folgenden Abhängigkeiten müssen vom Integrator (der einbettenden Seite von CIB doXisign) geladen werden:

<script type="text/javascript" src="./js/cib.iwc.1.0.0.min.js"></script>
<script type="text/javascript" src="./js/iwc-interfaces-min.js"></script>

Anschließend kann CIB doXisign wie folgt geöffnet werden:

// url taken from response of REST call prepare
function openDoxisign(url)
{
        // initialize IWC framework
        var master = {};
        master.iwc = new window.CibGetMasterController().createMaster();
        master.signPad = new window.CibSignPadMasterFunctions(master.iwc);
 master.signPad.registerOnFinishSignProcessCallback(function(params) {
                console.log(">>> " + params.referenceId);
                // will be called after successful signing      
        });
 master.signPad.registerOnCancelSignProcessCallback(function(params) {
                // will be called after canceled signing 
        });
        // open doxisign which will trigger the start parameter callback
        master.iwc.openURLInFrame("#doxisign-frame", url);
}

Sobald ein Signaturvorgang erfolgreich abgeschlossen wurde, wird der Integrator über den folgenden Callback darüber informiert:

master.signPad.registerOnFinishSignProcessCallback(function(params) {
                console.log(">>> " + params.referenceId);
                // will be called after successful signing      
        });

Über die Refrenz-ID des Prozesses können nun weitere Aktivitäten ausgeführt werden. Dafür sei auf die Schnittstellen-Beschreibung der REST-Services in diesem Dokument verwiesen.

Wenn ein Signaturvorgang abgebrochen wurde, wird der Integrator über folgenden Callback informiert:

master.signPad.registerOnCancelSignProcessCallback(function(params) {
                // will be called after canceled signing 
        });