org.camunda.bpm.engine.runtime.Incident Maven / Gradle / Ivy
/* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.camunda.bpm.engine.runtime;
import java.util.Date;
/**
* An {@link Incident} represents a failure in the execution of
* a process instance.
*
*
*
* A possible failure could be for example a failed {@link Job}
* during the execution, so that the job retry is equal zero
* (job.retries == 0). In that case an incident
* will be created an the incidentType will be set
* to failedJobs.
*
*
*
* Furthermore, it is possible to create custom incidents with
* an individually incidentType to indicate a failure
* in the execution.
*
*
* @author roman.smirnov
*
*/
public interface Incident {
/**
* Returns the unique identifier for this incident.
*/
public String getId();
/**
* Time when the incident happened.
*/
public Date getIncidentTimestamp();
/**
* Returns the type of this incident to identify the
* kind of incident.
*
*
*
* For example: failedJobs will be returned
* in the case of an incident, which identify failed job
* during the execution of a process instance.
*/
public String getIncidentType();
/**
* Returns the incident message.
*/
public String getIncidentMessage();
/**
* Returns the specific execution on which this
* incident has happened.
*/
public String getExecutionId();
/**
* Returns the id of the activity of the process instance
* on which this incident has happened.
*/
public String getActivityId();
/**
* Returns the specific process instance on which this
* incident has happened.
*/
public String getProcessInstanceId();
/**
* Returns the id of the process definition of this
* process instance on which the incident has happened.
*/
public String getProcessDefinitionId();
/**
* Returns the id of the incident on which this incident
* has been triggered.
*/
public String getCauseIncidentId();
/**
* Returns the id of the root incident on which
* this transitive incident has been triggered.
*/
public String getRootCauseIncidentId();
/**
* Returns the payload of this incident.
*/
public String getConfiguration();
}