Chapter 63. Registering custom tasks

Procedure

1. In Business Central, go to Menu Design Projects and select the project name.
2. In the project pane, select Settings Deployments Work Item Handlers.
3. Click Add Work Item Handler.
4. In the Name field, enter the display name for the custom task.
5. From the Resolver list, select MVEL, Reflection or Spring.

6. In the Value field, enter the value based on the resolver type:

   Note

   The value fields may be filled automatically.

   • For MVEL, use the format new <full Java package>.<Java work item handler class name>()

     Example: new com.redhat.MyWorkItemWorkItemHandler()

   • For Reflection, use the format <full Java package>.<Java work item handler class name>

     Example: com.redhat.MyWorkItemWorkItemHandler

   • For Spring, use the format <Spring bean identifier>

     Example: workItemSpringBean

7. Click Save to save your changes

Procedure

1. In your Git project directory, open the file src/main/resources/META-INF/kie-deployment-descriptor.xml.

2. Add the following content based on the resolver type under <work-item-handlers>:

   • For MVEL, add the following:

     <work-item-handler>
       <resolver>mvel</resolver>
       <identifier>new com.redhat.MyWorkItemWorkItemHandler()</identifier>
       <parameters/>
       <name>MyWorkItem</name>
     </work-item-handler>

     Copy to Clipboard Toggle word wrap

   • For Reflections, add the following:

     <work-item-handler>
       <resolver>reflection</resolver>
       <identifier>com.redhat.MyWorkItemWorkItemHandler</identifier>
       <parameters/>
       <name>MyWorkItem</name>
     </work-item-handler>

     Copy to Clipboard Toggle word wrap

   • For Spring, add the following and ensure the identifier is the identifier of a Spring bean:

     <work-item-handler>
       <resolver>spring</resolver>
       <identifier>beanIdentifier</identifier>
       <parameters/>
       <name>MyWorkItem</name>
     </work-item-handler>

     Copy to Clipboard Toggle word wrap
     Note

     If you are using Spring to discover and configure Spring beans, it is possible to use an annotation of the org.springframework.stereotype.Component class to automatically register work item handlers.

     Within a work item handler, add the annotation @Component("<Name>") before the declaration of the work item handler class. For example: @Component("MyWorkItem") public class MyWorkItemWorkItemHandler extends AbstractLogOrThrowWorkItemHandler {