1. Create WID_NAME.wid in META-INF. For example, $PROJECT_HOME/src/main/resources/META-INF/WID_NAME.wid.

   This file is identical to a work item definition file created in Business Central.

2. Copy all the icons you want to use into $PROJECT_HOME/src/main/resources/icons.

1. Log into Business Central.
2. Click Authoring → Project Authoring.
3. Choose the organizational unit and repository of your project to view the assets in your project.

4. Click WORK ITEM DEFINITIONS → WorkDefinitions.

   The WorkDefinitions asset is created by default and contains a number of pre-set work item definitions.

5. The Work Item Definitions editor opens. Add your WID at the end, for example:

   [
   "name" : "Google Calendar",
   "description" : "Create a meeting in Google Calendar",
   "version" : "1.0",
   "parameters" : [
   	"FilePath" : new StringDataType(),
   	"User" : new StringDataType(),
   	"Password" : new StringDataType(),
   	"Body" : new StringDataType()
   ],
   "displayName" : "Google Calendar",
   "icon" : "calendar.gif",
   ]

   Add the imports required by your WID. For example:

   import org.drools.core.process.core.datatype.impl.type.StringDataType;
   import org.drools.core.process.core.datatype.impl.type.ObjectDataType;

   Note

   You have to separate the previous definition with a comma ",". Otherwise, the validation will fail.

6. Click Validate to make sure your definition is correct.
7. Click Save.

1. Click New Item → Uploaded file.
2. In the Create new Uploaded file dialogue box, define the resource name, including file extension.
3. Click Choose File and upload the file (png or gif, 16x16 pixels).
4. Click Ok.

1. Information about the task is extracted from the WorkItem instance.
2. The work item business logic is performed.

3. The Process instance is informed that the work item execution finished (as completed or aborted) using the respective method of the WorkItemManager:

   public class GoogleCalendarHandler implements WorkItemHandler {
   
   	@Override
   	public void executeWorkItem(WorkItem workItem, WorkItemManager manager) {
   
   	Map<String, Object> results = new HashMap<String, Object>();
   	// obtain parameters
   	String filePath = (String) workItem.getParameter("FilePath");
   	String user = (String) workItem.getParameter("User");
   
   	// execute the custom logic here
   
   	// pass results to next processing, for example
   
   	Object result;
   	results.put("Result", result);
   	manager.completeWorkItem(workItem.getId(), results)
   	}
   
   	@Override
   	public void abortWorkItem(WorkItem workItem, WorkItemManager manager) {
   
   			manager.abortWorkItem(workItem.getId());
   	}
   
   }

   If you use the work item in a maven project, you need to declare the following dependency:

   <dependency>
   	<groupId>org.jbpm</groupId>
   	<artifactId>jbpm-workitems</artifactId>
   	<version>6.4.0.Final-redhat-3</version>
   </dependency>

Procedure: Uploading JAR File

1. Log into Business Central.
2. Click Authoring → Artifact repository.
3. Click Upload and select the JAR file of your work item handler.
4. Click Upload.

Procedure: Adding Dependencies

1. Click Authoring → Project Authoring.
2. Click Open Project Editor.
3. Click Project Settings: Project General Settings and select Dependencies list from the menu.
4. Click Add from repository and select the file you have uploaded.

Procedure: Registering Work Item Handler

1. Click Authoring → Project Authoring.
2. Click Open Project Editor.
3. Click Project Settings: Project General Settings and select Deployment descriptor from the menu.
4. Navigate to Work Item handlers and click Add.
5. Enter the name of your custom work item definition into the first Value field with no white spaces. For example, GoogleCalendar.
6. Instantiate your work item handler in the second field. For example, if your work item is in the com.sample package, new com.sample.GoogleCalendarHandler().
7. Click Save.