コード例 #1
0
  /*
   * (non-Javadoc)
   *
   * @see com.htm.TaskParentInterface#exit(java.lang.String)
   */
  public void exit(String tiid) throws HumanTaskManagerException {
    try {
      /* Start transaction for creating a task instance */
      dataAccessProvider.beginTx();
      log.debug("Exit task instance - Trying to exit task instance '" + tiid + "'");
      this.authorizationManager.authorizeTaskParentAction(getCurrentUser(), tiid, EActions.EXIT);
      ITaskInstance taskInstance = dataAccessProvider.getTaskInstance(tiid);
      String oldState = taskInstance.getStatus().toString();

      // TODO for skipped, completed, faulted task instances an individual
      // error message should
      // be created. Currently only an invalidarguemntexception is thrown
      if (taskInstance.isExpired()) {
        String errorMsg =
            "The task instance '"
                + taskInstance.getId()
                + "' can not be exited "
                + "because it expired on "
                + Utilities.formatTimestamp(taskInstance.getExpirationTime());
        log.error(errorMsg);
        throw new InvalidOperationException(errorMsg);
      }

      taskInstance.setStatus(ETaskInstanceState.EXITED);

      // Audit
      if (Configuration.isLoggingEnabled()) {
        IAuditLogger auditLogger = AuditFactory.newInstance();
        TaskInstanceView taskInstanceView = new TaskInstanceView(taskInstance);
        AuditAction action =
            new AuditAction(
                EActions.EXIT.toString(),
                taskInstanceView,
                taskInstanceView.getStatus(),
                oldState,
                SessionUtils.getCurrentUser());
        auditLogger.logAction(action);
      }
      dataAccessProvider.commitTx();
    } catch (HumanTaskManagerException e) {
      dataAccessProvider.rollbackTx();
      throw e;

    } finally {
      dataAccessProvider.close();
    }
  }
コード例 #2
0
  /*
   * (non-Javadoc)
   *
   * @see com.htm.TaskParentInterface#createTaskInstance(java.lang.String,
   * java.lang.String, java.lang.Object, java.util.Set, java.lang.String,
   * java.sql.Timestamp)
   */
  public String createTaskInstance(
      String taskParentId,
      Set<ICorrelationProperty> correlationProperties,
      String taskModelName,
      String taskInstanceName,
      Object inputData,
      Set<IAttachment> attachments,
      Timestamp expirationTime)
      throws HumanTaskManagerException {

    try {

      // TODO contextId
      String initiatorUserId = getCurrentUser();

      if (StringUtils.isEmpty(initiatorUserId)) {
        String errorMsg = "The username of the task initiator could not be determined.";
        log.error(errorMsg);
        throw new HumanTaskManagerException(errorMsg);
      }

      /* Start transaction for creating a task instance */
      dataAccessProvider.beginTx();
      this.authorizationManager.authorizeTaskParentAction(
          initiatorUserId, null, EActions.CREATE_TASK_INSTANCE);

      /* Create the task instance model */
      TaskInstanceFactory taskFac = this.taskInstanceFactory;
      ITaskInstance taskInstance =
          taskFac.createTaskInstance(
              taskModelName,
              taskInstanceName,
              inputData,
              taskParentId,
              correlationProperties,
              expirationTime);

      /* Store the task instance instance */
      dataAccessProvider.persistHumanTaskInstance(taskInstance);

      // Audit
      // if (Configuration.isLoggingEnabled()) {
      // IAuditLogger auditLogger = AuditFactory.newInstance();
      // TaskInstanceView taskInstanceView = new
      // TaskInstanceView(taskInstance);
      // AuditAction action = new
      // AuditAction(EActions.CREATE_TASK_INSTANCE.toString(),
      // taskInstanceView, taskInstanceView.getStatus(), null,
      // initiatorUserId);
      // auditLogger.logAction(action);
      // }

      /* Activate the task instance expiration timer. */
      TaskInstanceTimers.activateExpirationTimer(taskInstance);

      /*
       * Create Work Items and add attachments
       */
      List<IWorkItem> workItems = new ArrayList<IWorkItem>();

      WorkItemFactory workItemFac = this.workItemFactory;
      /*
       * A single work item for the task initiator has to be created
       * because she is not defined in the task model by a people query.
       * This should be done before the other work items are created since
       * the people queries in the task model could refer on the task
       * initiator.
       */
      workItems.add(
          workItemFac.createNewWorkItem(initiatorUserId, EHumanRoles.TASK_INITIATOR, taskInstance));
      /*
       * The attachments should also be added before the other work items
       * are created then the people queries can refer on the attachments.
       */
      taskInstance.setAttachments(
          this.taskInstanceFactory.createAssignedUser(initiatorUserId), attachments);

      /*
       * Create work items for roles that are defined via people queries
       * within the task model i.e. for roles business administrators,
       * task stakeholder, potential owners
       */
      workItems.addAll(workItemFac.createWorkItemsForTaskInstance(taskInstance));

      // TODO: evaluate QueryProperties
      taskFac.evaluateQueryProperties(taskInstance.getId(), taskModelName);

      /*
       * If the task instance has one or more potential owners it
       * transitions to ready state i.e. it is activated
       */
      boolean hasPotentialOwner = taskInstance.hasPotentialOwners();

      log.debug("Create task instance - Task instance has potential owners : " + hasPotentialOwner);
      /*
       * The task instance can only set to the READY state if it has
       * potential owners and if the task instance is not already expired.
       */
      String oldState = taskInstance.getStatus().toString();
      if (taskInstance.hasPotentialOwners() && !taskInstance.isExpired()) {
        taskInstance.setStatus(ETaskInstanceState.READY);
        taskInstance.setActivationTime(new Timestamp(Calendar.getInstance().getTimeInMillis()));
        // TODO only one potential owner -> immediately go to reserved
        // state
      }

      if (!hasPotentialOwner) {
        log.info(
            "Create task instance - "
                + "Can't transition to '"
                + ETaskInstanceState.READY
                + "' state because no potential owner(s) were found.");
      }
      if (taskInstance.isExpired()) {
        log.info(
            "Create task instance - "
                + "The task instance is "
                + ETaskInstanceState.OBSOLETE
                + " created because it has already expired at '"
                + Utilities.formatTimestamp(expirationTime)
                + "'.");
      }

      dataAccessProvider.persistWorkItems(workItems);
      /* Inform event subscriber about the new work items */
      publishNewWorkItemEvent(workItems);

      // Audit
      if (Configuration.isLoggingEnabled()) {
        IAuditLogger auditLogger = AuditFactory.newInstance();
        TaskInstanceView taskInstanceView = new TaskInstanceView(taskInstance);
        AuditAction action =
            new AuditAction(
                EActions.CREATE_TASK_INSTANCE.toString(),
                taskInstanceView,
                taskInstanceView.getStatus(),
                oldState,
                initiatorUserId);
        auditLogger.logAction(action);
      }

      dataAccessProvider.commitTx();
      return taskInstance.getId();
    } catch (HumanTaskManagerException e) {
      dataAccessProvider.rollbackTx();
      throw e;
    } finally {
      dataAccessProvider.close();
    }
  }