You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

To be able to view the UI with the web browser, the service as well as the UI components need to be deployed and running on the E2E Bridge. The next steps will introduce how the UI components will be added to the component diagram and how the UI can be viewed within the E2E Bridge and web browser.

The E2E UI service can be deployed without any functionality implemented. This could be the case in e.g. early UI development stages where the different screens need to be reviewed. To be able to deploy the service you at least need to have a E2E SOAP Port Type defined.

Draw the component diagram by the help of the E2E Components Wizard (). For detailed help on how to use the Components Wizard refer to the Builder User's Guide.

Define a composite and, in addition to the SOAP service, add a UIRepository to it.

A dialog pops up where you can adjust some settings of the UI repository.

Just click OK.

Clicking Next several times will bring you to the point that the wizard complains about a missing UI service class.

Add the UI Service class HelloWorldUI to the UI Services list by selecting it from the left classes list and clicking on  > .

Within this window, some tagged values can be amended which may influence the appearance of the user interface itself. See the table below for a detailed description of all tagged values.

 

Tagged ValueDescriptionAllowed Values
supportBrowserHistoryIf true, each UI state is mapped to an anchor. That is, if the browser's back button is pressed, the UI goes back in time.
However, if the UI is embedded in another framework (CMS, SharePoint, ...), it is recommended to set this flag to false.
trueenable browser history
false (default)disable browser history
Localization
defaultTheme

Themes are sets of style sheets to define a look and feel of the Ajay application. Choose here one of the visual themes of the selection that can apply to the E2E UI.

Details about the theming concept can be found at http://jqueryui.com/themeroller.

Noneno theme applied
a value from the list of themes
defaultLanguageThe language used in the UI templates should be the same as used to configure the UI widgets (tables, calendars, ...) By default, the Bridge takes the operation system language as UI language.
However, this default language can be overridden using this tagged value.
Noneuse system language
a language of the list of languages
defaultRegionThe region is used in the UI to format numbers and dates. By default, the Bridge takes the operation system region as UI region.
However, this default region can be overridden using this tagged value.
Noneuse system region
a region of the list of regions
Mobile
platform None 
default 
mobile 
Presentation
titleSpecify here the title of the UI, e.g. HTML page title  
defaultLayoutSpecify here in which way the template elements should be organized.floatingall template elements are floating
gridall template elements get a tabled grid layout
isConsoleUI

A UI application can be used within the Bridge as an application to e.g. configure a service. If this flag is set, the E2E Bridge will embed this user interface.

Only one Bridge UI per xUML service is allowed.

trueembed this UI in the E2E Bridge

false (default)

 

do not embed this UI
consoleUINameIf isConsoleUI is set to true, this name is taken as tab name of the Bridge tab the UI is embedded to.  
errorPlacement

If referring to a JavaScript operation, errorPlacement overrides the default error placement when validating forms.

The operation has to parameters:

  • error: The jQuery error element to be rendered.
  • element: The jQuery form element causing the error.

The default operation looks like:

var left = element.position().left;
var top = element.position().top + element.height() + 5;
error.css( {
	"position": "absolute",
	"left": left + "px",
	"top": top + "px"});
error.insertAfter(element);
  

You don't need any aliases for this tutorial service.

Click Cancel and then Next.

Click Finish to finish the setup of the Component Diagram and let the component diagram be drawn.

 

Deploying the UI using E2E Builder Version 5.1

  • Deprecated since Builder 6.0

Start the component wizard by clicking the appropriate icon within the toolbar.

Click Next.

Click New to create a new Composite Artifact. The New Composite Artifact Window will open.

Within the Name field the default Composite name HelloWorldUI is defined by the Wizard. It can be renamed or in this case be left as it is.
Click OK to close the window and add the Artifact to the Composite.

The HelloWorldUI Composite is now created.

The next step is adding the actual user interface artifact to the previously created Composite. Select the UIRepositoryArtifact from the Service/ JVM Components list and use the > button to add it to the Services.

Next to the UIRepository, the actual Service that was created before needs to be added to the Service Components.
Click New to add the SOAP Service.

Select the <<E2ESOAPService>> stereotype from the list within the Service Stereotypes window and click OK.

If needed, amend any of the parameters (Name, Port, Authentication Method, etc.) within the New SOAP Service Artifact window and click OK to close the window.

The basic SOAP Service is now added to the services components.
Click Next to proceed.

Add the UI Service class HelloWorldUI to the UI Service Artifacts list by selecting it from the left classes list and clicking on  > .

Within this window, the following can be amended which may influence the appearance of the user interface itself.

Default Theme: This is a selection of visual themes that can apply to the E2E UI. For an overview of all supported themes refer to http://jqueryui.com/themeroller.
isConsoleUI: A UI application can be used within the Bridge as an application to e.g. configure a service. If this option is checked, the UI will be used within the E2E Bridge only.
Mobile Theme: This is a selection of visual themes that can be applied to the E2E UI which will present on mobile devices.
Supported mobile devices: iPhone™
Application Icon: The Application Icon is only relevant for iPhone™ user interfaces. It is the icon you can lay on the iPhones™  home screen. The reference to the icon image is relative to the UIRepository's htdocs directory e.g. imgs/E2E-touch-icon.png
Startup Screen: The Startup Screen is only relevant for iPhone™ user interfaces. The image is shown while the application is loading. The reference to the image is the same as for the Application Icon.

For the Application Icon and Startup Screen the common web image formats are allowed (JPG, GIF) but PNG is recommended.


The basic setup for the xUML service to run including the user interface is done now.
Click Skip.

Select the option Finish and click the OK button to finish the setup of the Component Diagram.

The resulting Component Diagram shows how the <<UIRepository>> with its settings is embedded.

Figure: E2E UI Component Diagram

To finalize this cycle, create a deployment diagram.

Figure: E2E UI Deployment Diagram

  • No labels