The documentation of jBPM can be found in:
jBPM Documentation 7.28.0.Final
jBPM JavaDocs 7.28.0.Final

You can install the jBPM plugins in Eclipse using the folowing URL: http://downloads.jboss.org/jbpm/release/latestFinal/updatesite/

Among the available plugins, you will use the Eclipse editor for creating BPMN2 processes.



Also you may be interested to create a jBPM project using the assistant plugin that can create an empty project, a sample project, or even download existing projects from jBPM online repository.

You can add the jBPM-test module to your maven project:

<dependency>
    <groupId>org.jbpm</groupId>
    <artifactId>jbpm-test</artifactId>
    <version>7.28.0.Final</version>
    <scope>test</scope>
</dependency>

Here's a sample unit test code, generated by the jBPM plugin:

public class ProcessTest extends JbpmJUnitBaseTestCase {
    @Test
    public void test() {
        final RuntimeManager runtimeManager = createRuntimeManager("sample.bpmn");
        final RuntimeEngine runtimeEngine = getRuntimeEngine(null);
        final KieSession kieSession = runtimeEngine.getKieSession();

        final ProcessInstance processInstance = kieSession.startProcess("com.sample.bpmn.hello");

        assertProcessInstanceCompleted(processInstance.getId(), kieSession);
        assertNodeTriggered(processInstance.getId(), "Hello");

        runtimeManager.disposeRuntimeEngine(runtimeEngine);
        runtimeManager.close();
    }
}

You can look at the jbpm-test source code (jbpm-test-7.28.0.Final-sources) where you will find some sample codes that will help you understand how jBPM works.
The main class you may be interested to look at is: org.jbpm.test.JbpmJUnitBaseTestCase

For example if you are interested to see an example of how to create an instance of the org.kie.api.runtime.manager.RuntimeEnvironmentBuilder:

RuntimeEnvironmentBuilder builder = RuntimeEnvironmentBuilder.Factory.get().newEmptyBuilder()
    .addConfiguration("drools.processSignalManagerFactory", DefaultSignalManagerFactory.class.getName())
    .addConfiguration("drools.processInstanceManagerFactory", DefaultProcessInstanceManagerFactory.class.getName())
    .registerableItemsFactory(new SimpleRegisterableItemsFactory() {
        @Override
        public Map<String, WorkItemHandler> getWorkItemHandlers(RuntimeEngine runtime) {
            Map<String, WorkItemHandler> handlers = new HashMap<String, WorkItemHandler>();
            handlers.putAll(super.getWorkItemHandlers(runtime));
            handlers.putAll(customHandlers);
            return handlers;
        }

        @Override
        public List<ProcessEventListener> getProcessEventListeners(RuntimeEngine runtime) {
            List<ProcessEventListener> listeners = super.getProcessEventListeners(runtime);
            listeners.addAll(customProcessListeners);
            return listeners;
        }

        @Override
        public List<AgendaEventListener> getAgendaEventListeners(RuntimeEngine runtime) {
            List<AgendaEventListener> listeners = super.getAgendaEventListeners(runtime);
            listeners.addAll(customAgendaListeners);
            return listeners;
        }

        @Override
        public List<TaskLifeCycleEventListener> getTaskListeners() {
            List<TaskLifeCycleEventListener> listeners = super.getTaskListeners();
            listeners.addAll(customTaskListeners);
            return listeners;
        }
    });

If you are interested to see an example of how to create an instance of the org.kie.api.runtime.manager.RuntimeManager:

protected RuntimeManager createRuntimeManager(Strategy strategy, Map<String, ResourceType> resources, RuntimeEnvironment environment, String identifier) {
    try {
        switch (strategy) {
        case SINGLETON:
            if (identifier == null) {
                manager = managerFactory.newSingletonRuntimeManager(environment);
            } else {
                manager = managerFactory.newSingletonRuntimeManager(environment, identifier);
            }
            break;
        case REQUEST:
            if (identifier == null) {
                manager = managerFactory.newPerRequestRuntimeManager(environment);
            } else {
                manager = managerFactory.newPerRequestRuntimeManager(environment, identifier);
            }
            break;
        case PROCESS_INSTANCE:
            if (identifier == null) {
                manager = managerFactory.newPerProcessInstanceRuntimeManager(environment);
            } else {
                manager = managerFactory.newPerProcessInstanceRuntimeManager(environment, identifier);
            }
            break;
        default:
            if (identifier == null) {
                manager = managerFactory.newSingletonRuntimeManager(environment);
            } else {
                manager = managerFactory.newSingletonRuntimeManager(environment, identifier);
            }
            break;
        }

        return manager;
    } catch (Exception e) {
        if (e instanceof BitronixSystemException || e instanceof ClosedChannelException) {
            TransactionManagerServices.getTransactionManager().shutdown();
        }
        throw new RuntimeException(e);
    }
}

You can also use the following methods to assert some conditions related to your unit testing:
- void assertProcessInstanceState(long processInstanceId, Integer expectedState, String message)
- void assertNodeActive(long processInstanceId, KieSession ksession, String... name)
- void assertNodeTriggered(long processInstanceId, String... nodeNames)
- ...

You can download the jBPM DDL scripts from github:
► https://github.com/droolsjbpm/jbpm/tree/master/jbpm-installer/src/main/resources/db/ddl-scripts

Here are the paths where you can find the jBPM DDL scripts for each supported database:

• db2
  
  
• derby
  
  
• h2
  
  
• hsqldb
  
  
• mysql5
  
  
• mysqlinnodb
  
  
• oracle
  
  
• postgresql
  
  
• sqlserver
  
  
• sqlserver2008
  
  
• sybase