CIB JView technischer Leitfaden

Einführung: Anbindung an Korrespondenzsystem - jView&coSys

Allgemein
Interface AuthenticationCallback mit Callback-Methode für die Authentifizierung
Interface WorkflowListener mit Callback-Methoden für den Workflow

---

Allgemein

In CIB jView sind auch Funktionen zur Anbindung an das Korrespondenzsystems CIB webdesk 2.0 integriert. Diese JView-Erweiterung wird als JView&coSys bezeichnet.

Dazu sind verschiedene Interfaces definiert, die in den folgenden Abschnitten beschrieben werden.

Interface AuthenticationCallback mit Callback-Methode für die Authentifizierung

Zur Authentifizierung bei CIB webdesk bzw. darkdesk wird ein Interface AuthenticationCallback mit einer CallBack-Methode getStarterTicket() eingeführt, die das aktuelle Starterticket zurückliefert. Der Aufrufer muss sich dazu bei der JView-Instanz als Listener anmelden.

Das Interface AuthenticationCallback ist im CIB jView (package de.cib.view.correspondence) definiert.

package de.cib.view.correspondence;
 
/**
 * Interface AuthenticationCallback
 *
 * This interface is used to listen to authentication events.
 * 
 */
public interface AuthenticationCallback {
 
      /**
       * Call back for getting a starter ticket.
       * @return a starter ticket
       */
      public String getStarterTicket();
 }

 

Code-Beispiel zum Setzen eines AuthenticationCallback Listeners bei der jView-Instanz:

       // Definition eines AuthenticationCallback Listeners
      static String clientID = null;
 
      static class AuthenticationCallbackTester 
                  implements AuthenticationCallback
{
 
            public String getStarterTicket() {
                  // For test with mock service
                  String starterTicket = null;
                  if (clientID != null)
                        starterTicket = "start" + clientID;
                  return starterTicket;
            }
      }
 
      // Beim Start von jView
 t_CibView.setAuthenticationCallback(
            new AuthenticationCallbackTester());
      ...
 
      // Beim Beenden von JView
 t_CibView.setAuthenticationCallback(null);

Interface ApprovalCallback mit Callback-Methoden für die Freigabe

Für Freigabe von Korrespondenz-Dokumenten im CIB webdesk bzw. darkdesk wird ein Interface ApprovalCallback mit den CallBack-Methoden workflowApprovalCommitted() und workflowApprovalDenied() eingeführt, die den Listener darüber informieren, ab die Freigabe erfolgreich durchgeführt oder abgebrochen wurde. Der Aufrufer muss sich dazu bei der JView-Instanz als Listener anmelden.

Das Interface ApprovalCallback ist im CIB jView (package de.cib.view.correspondence) definiert.

package de.cib.view.correspondence;
 
/**
 * Used to allow JView callbacks to the instantiating application
 * in case of workflow approvals. 
 * 
*/
public interface ApprovalCallback {
      
      /**
       * This method is called when a user approves the current
       * viewed document.<br>
       * Override this method to implement specific handling of
       * this callback.
       */
      void workflowApprovalCommitted();
      
      /**
       * This method is called when a user denies approval of the current
       * viewed document.<br>
       * Override this method to implement specific handling of
       * this callback.
       */
      void workflowApprovalDenied();
}

 Code-Beispiel zum Setzen eines ApprovalCallback Listeners bei der jView-Instanz:

       // Definition eines ApprovalCallback Listeners
      static String clientID = null;
 
      static class ApprovalCallbackTester implements ApprovalCallback {
            public void workflowApprovalCommitted() {
                  JCibTrace.info("CALLBACK - workflowApprovalCommitted()");
            }
      
            public void workflowApprovalDenied() {
                  JCibTrace.info("CALLBACK - workflowApprovalDenied()");
            }
      }
 
      // Beim Start von JView
  t_CibView.setApprovalCallback(new ApprovalCallbackTester());
      ...
 
      // Beim Beenden von JView
 t_CibView.setApprovalCallback(null);

Interface WorkflowListener mit Callback-Methoden für den Workflow

Für den Workflow von Korrespondenz-Dokumenten im CIB webdesk bzw. darkdesk wird ein Interface WorkflowListener mit verschiedenen CallBack-Methoden eingeführt, die den Listener darüber informieren, welche Benutzereingaben im Workflow für das aktuelle Korrespondenz­dokument erfolgt sind. Der Aufrufer muss sich dazu bei der JView-Instanz als Listener anmelden.

Das Interface WorkflowListener ist im CIB jView (package de.cib.view.correspondence) definiert.

package de.cib.view.correspondence;
 
/**
 * Interface WorkflowListener
 *
 * This interface is used to listen to workflow events.
 * 
 */
public interface WorkflowListener {
 
      /**
       * Call back for accept.
       * @param 
       */
      void onAccept();
 
      /**
       * Call back for reject.
       * @param 
       */
      void onReject();
 
      /**
       * Call back for accept and approve.
       * @param 
       */
      void onAcceptAndApprove();
 
      /**
       * Call back for restart workflow.
       * @param 
       */
      void onRestartWorkflow();
 }

 

Code-Beispiel zum Setzen eines Workflow Listeners bei der jView-Instanz:

 

      // Definition eines Workflow Listeners
      static class WorkflowCallbackTester implements WorkflowListener {
                  public void onAccept() {
                  System.out.println("Called workflowOnAccept()");
            }
      
            public void onReject() {
                  System.out.println("Called workflowOnReject()");
            }
      
            public void onAcceptAndApprove() {
                  System.out.println("Called workflowOnAcceptAndApprove()");
            }
      
            public void onRestartWorkflow() {
                  System.out.println("Called workflowOnRestartWorkflow()");
            }
      }
 
      // Beim Start von jView
      final WorkflowCallbackTester workflowListener = 
                  new WorkflowCallbackTester();
t_CibView.addWorkflowListener(workflowListener);
      ...
 
      // Beim Beenden von jView
t_CibView.removeWorkflowListener(workflowListener);