Introduction
The renderer plug-in is pretty useful functionality provided by IBM Cúram and used by many modules. The main purpose of the renderer plug-in is to combine complicated UI element to a domain definition and hide the implementation from the end user.
The renderer plug-in helps to store and display a user interface without a lot of effort by the developer.
The best examples for the renderer plugin are given below –
ADDRESS_DATA: This domain definition helps to renderer the screen as given below.
ATTENDANCE_ROSTER_XML_DATA_SET: This domain definition helps to renderer the screen as given below.
DAILY_ATTENDANCE_XML_DATA_SET: This domain definition helps to renderer the screen as given below.
Custom Renderer Plug-in Development
This section helps a developer to develop a custom renderer. Please follow detailed steps as given below to develop a renderer plug-in –
There are various examples of the renderer plug-ins and few are explained here in this tutorial.
Display Field’s Value as Bold and Specific Color
This scenarios is very common and used by the various project. The best example is amount if the benefit amount is more than $1000 then display as Bold and Red Color as it is crossing the monthly Benefit Amount and display Bold and Green otherwise.
Steps to develop the above requirement:
- Launch the RSAD or RSA and Navigate to model.
- Open the custom or Project specific folder in the model and navigate to Domain Definition section.
- Create One Domain Definition as KW_DISPLAY_TEXT_BOLD_COLOR with stereo Type as String with 1000 character or unbounded string if the value of the field is unbounded.
- Once Domain Definition created then configure this Domain Definition in DomainsConfig.xml file in Client project location as given below –
- Now we have to create one class with the name KWBoldAndColorTextViewRenderer under kw.widget.render package.
This class will extend the AbstractViewRenderer class and will override render method to achieve the functionality.
- Use KW_DISPLAY_TEXT_BOLD_COLOR domain definition where ever you want to display text field as bold and colored.