Development Tools

TheEssentials setup application provides a number of development tools that can speed up or even automate some common tasks when developing a Bloomreach Experience Manager project:

• Selections for configuring Selection widgets in document types.
• Gallery Manager for configuring custom image set types.
• Beanwriter for auto-generating content bean classes.
• REST Services Setup for setting up RESTful services.
• Template Query Generator for generating template queries for custom document types.

They can be found on theTools tab:

Selections

The Selections tool provides a configuration UI to add value list-based Selection fields to existing document types.

Gallery Manager

The Gallery Manager allows you to configurecustom image sets by entering the dimensions, labels and configuration properties for the different size variants through a form-based UI.

After creating or modifying an image set using the Gallery Manager, make sure to (re-)generate the correspondingcontent bean using the Beanwriter (see next section).

Beanwriter

The Beanwriter generatescontent bean classes for all yourcontent types. If the project contains multiple image set types, you can choose which one to use for the bean generation, and whether existing beans should be updated to use that image set type too:

After running the Beanwriter, all generated classes and methods will be listed in the setup application's feedback panel:

You should now rebuild and redeploy your project in order to make the updated beans available.

REST Services Setup

The REST Services Setup tool provides an easy way to create basicRESTful services usingBloomreach Experience Manager's JAX-RS support.

Content REST API

The genericContent RESP API can be enabled by checkingEnable generic REST resources and specifying the URL at which the REST services will be available.

Custom Plain JAX-RS Services

The setup tool can also bootstrap youcustom JAX-RS resources. CheckEnable manual REST resources, specify the URL at which the REST services will be available, and select thedocument types in the project for which a service should be generated:

The tool will generate the required HST configuration, Java classes and Spring configuration. The content bean classes in your project will be enriched so they can be used as JAXB models as well.

Although the generated services will work right away, they are meant as a starting point for further development and will most likely need to be customized and/or extended to meet your project requirements.

Template Query Generator

The Template Query Generator provides an easy way to createtemplate queries for your custom document types. Template queries are used tocontrol which document types can be used in which folder. For each document type, you have the option to generate a document template query and a folder template query.