I decided to start with a post about the LC Workbench ES Component Development Tool, which makes the generation of a custom component an easier task. You can download the prerelease of the tool from Adobe Labs (http://labs.adobe.com/technologies/lcwcdtool). The Development Tool is essentially a plug-in for Eclipse that provides a new type of project with a component.xml file, pre-generated service classes and an Ant script to finally generate the custom component JAR.
The thing that I really like about the tool is that it allows you to configure your custom component without the need of manually editing the component.xml file.
Before installing the Development Tool you need to make sure you have the following Eclipse frameworks installed:
- Eclipse Modeling Framework Project (EMF)
- Eclipse Graphical Editing Framework (GEF)
- Web Tools Platform (WTP SDK)
After installing these 3 frameworks, you can download the Development Tool from Adobe Labs and install it on your Eclipse (http://labs.adobe.com/downloads/lcwcdtool.html).
Now, once installed, you will follow the following steps to create your custom component:
- Create your new Component Project. You will see that under the “New Project” wizard of Eclipse, there is now a new category called “Adobe LiveCycle” with a “Component Project” within it.
- On the first screen you will be prompted to enter the name of the new project, the package name where your service classes will be, and the unique ID of the component.
- This dialog also allows you to specify the services your custom component will provide.
- This “New Project” wizard will generate your project with the component.xml file already configured, and your service classes and Ant script generated. The project tree should look something like this:
- If you need to add additional configuration to the component.xml file, you can edit it with the component editor provided by the Development Tool. Just open the component.xml in Eclipse and you won’t get the plain XML file content, but the following edit dialog that should make the edition of the file much easier.
- The next step would be to implement the business logic of your service classes already pre-generated for you
- Once you finish coding your Java classes, you can run the provided Ant build.xml to finally generate the JAR file, and voila!… your custom component is ready to be imported in LC Workbench to get it installed on your LC server.