net.pricefx.server.dto.calculation

Class DashboardController

Object

DashboardController

All Implemented Interfaces:

Serializable, ComplexCalculationResult

public class DashboardController
extends Object
implements Serializable, ComplexCalculationResult

This class is used to generate the definition of a so called controller dashboard portlet (or wizard). It consitsts generally out of two elements: HTML snippets and buttons The buttons can trigger UI actions (e.g. opening a page) or backend actions (calling a backend URL)

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	DashboardController.ControllerItem
static class	DashboardController.ControllerItemType

Constructor Summary

Constructors

Constructor and Description
DashboardController()

Method Summary

Modifier and Type	Method and Description
void	addBackendCall(String label, String apiUrl) Performs a backend call in the user's context (i.e.
void	addBackendCall(String label, String apiUrl, String payload) Performs a backend call in the user's context (i.e.
void	addBackendCall(String label, String apiUrl, String payload, String successMessage, String failMessage) Performs a backend call in the user's context (i.e.
void	addButton(String label, String targetPage) Adds a button to the controller
void	addButton(String label, String targetPage, Object targetPageState) Adds a button to the controller
void	addButton(String label, String targetPage, Object targetPageState, Object componentId) Adds a button to the controller
void	addDownloadButton(String label, String url) Performs a backend call in the user's context in new window.
void	addDownloadButton(String label, String url, String payload) Performs a backend call in the user's context in new window.
void	addHTML(String html) Adds a HTML snippet into the controller
List<DashboardController.ControllerItem>	getItems()
String	getResultType()

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DashboardController

public DashboardController()

Method Detail

getResultType

public String getResultType()

Specified by:

getResultType in interface ComplexCalculationResult

getItems

public List<DashboardController.ControllerItem> getItems()

addButton

public void addButton(String label,
                      String targetPage)

Adds a button to the controller

Parameters:

label - The label of the button

targetPage - The name of the target page. Hint: This is also displayed in the URL after the hash symbol Sample code:

@code 
                def controller = api.newController()
                controller.addButton("1. STEP: Go to Live Price Grids","priceGridPage") 
 

addButton

public void addButton(String label,
                      String targetPage,
                      Object targetPageState)

Adds a button to the controller

Parameters:

label - The label of the button

targetPage - The name of the target page. Hint: This is also displayed in the URL after the hash symbol

targetPageState - A extra parameter that is used for deep links. E.g. a typed id to open a specific page Sample code:

@code 
                def controller = api.newController()
                controller.addButton("2. STEP: Go to LPG ABC","priceGridPage","45.PG")
 

addButton

public void addButton(String label,
                      String targetPage,
                      Object targetPageState,
                      Object componentId)

Adds a button to the controller

Parameters:

label - The label of the button

targetPage - The name of the target page. Hint: This is also displayed in the URL after the hash symbol

targetPageState - A extra parameter that is used for deep links. E.g. a typed id to open a specific page

componentId - Some UI actions require a parameter in this field (e.g. opening a specific dashboard) Sample code:

@code 
                def controller = api.newController()
                controller.addButton("Open Dashboard","dashboardPage",null,"FirstDash")
 

addBackendCall

public void addBackendCall(String label,
                           String apiUrl)

Performs a backend call in the user's context (i.e. from the browser)

Parameters:

label - The label of the button

apiUrl - The URL to call Sample code:

@code 
                def controller = api.newController()
                controller.addBackendCall("Calculate LPG","/pricegridmanager.calculate/45")
 

addBackendCall

public void addBackendCall(String label,
                           String apiUrl,
                           String payload)

Performs a backend call in the user's context (i.e. from the browser)

Parameters:

label - The label of the button

apiUrl - The URL to call

payload - The POST data to send along with the request

addBackendCall

public void addBackendCall(String label,
                           String apiUrl,
                           String payload,
                           String successMessage,
                           String failMessage)

Performs a backend call in the user's context (i.e. from the browser)

Parameters:

label - The label of the button

apiUrl - The URL to call

payload - The POST data to send along with the request

successMessage - A text that should be displayed in case of a successful response from the backend

failMessage - A text that should be displayed in case of a error response from the backend Sample code:

@code 
                def controller = api.newController()
                controller.addBackendCall("Calculate LPG","/pricegridmanager.calculate/45",null,"OK","Not OK")
 

addHTML

public void addHTML(String html)

Adds a HTML snippet into the controller

Parameters:

html - The html snippet Sample code:

@code 
                def controller = api.newController()
                controller.addHTML("
Welcome to Price f(x)
")
 

addDownloadButton

public void addDownloadButton(String label,
                              String url)

Performs a backend call in the user's context in new window. Useful for downloading Excel, PDF

Parameters:

label - The label of the button

url - The URL to call

addDownloadButton

public void addDownloadButton(String label,
                              String url,
                              String payload)

Performs a backend call in the user's context in new window. Useful for downloading Excel, PDF

Parameters:

label - The label of the button

url - The URL to call

payload - The POST data to send along with the request