WS-PGRADE + ASM Basic hands-on Zoltán Farkas, MTA SZTAKI

Outline What we will do Development environment Modification steps Deployment of the new ASM portlet Try it out!

Topic of the hands-on I. Modify an existing, simple ASM portlet: –Remove some features, –Present some features in a different way –Add some error handling Necessary modifications in: –Java, JSP and XML files Application of the ASM portlet: –Add two integers –One coming through a file –One coming through command line

Topic of the hands-on II.

Development Environment Ubuntu VM in VirtualBox: –2G RAM –NAT network gUSE automatically started NetBeans contains the starting project: –ASM_Sample

Modification Step 1 – Copy the application Really simple! In NetBeans: –Right-click on the ASM_Sample project –Select “Copy” –Enter a new project name, e.g. MyASM_Sample –Click “Copy”

Modification Step 1 – Copy the application Really simple! In NetBeans: –Right-click on the ASM_Sample project –Select “Copy” –Enter a new project name, e.g. MyASM_Sample –Click “Copy”

Modification Step 2 – Rename files and classes Expand “Source packages” Expand “hu.sztaki.lpds...” Right-click on “ASM_SamplePortlet.java” Select “Refactor”/“Rename” Enter a new class name, e.g. “MyASM_SamplePortlet” (You can apply rename of comments, if you like) Click “Refactor”

Modification Step 2 – Rename files and classes Expand “Source packages” Expand “hu.sztaki.lpds...” Right-click on “ASM_SamplePortlet.java” Select “Refactor”/“Rename” Enter a new class name, e.g. “MyASM_SamplePortlet” (You can apply rename of comments, if you like) Click “Refactor”

Modification Step 3 – Modify portlet layout I. Expand “Web Pages” Expand “jsp” Expand “asm_sample” Open “asm_sample.jsp”

Modification Step 3 – Modify portlet layout I. Expand “Web Pages” Expand “jsp” Expand “asm_sample” Open “asm_sample.jsp”

Modification Step 3 – Modify portlet layout II. Remove “Get Input”: –Search for the “div_getinput” div –Remove it (along with its parent )!

Modification Step 3 – Modify portlet layout II. Remove “Get Inputs” Search for the “div_getinputs” div Remove it (along with its parent )!

Modification Step 3 – Modify portlet layout III. Modify “Set Input” to “Set Inputs”: –Search for the “doSetInput” hidden input action

Modification Step 3 – Modify portlet layout III. Modify “Set Input” to “Set Inputs”: –Update as follows:

Modification Step 3 – Modify portlet layout IV. Remove “Upload”: –Search for the “Upload” button –Remove it (along with its parent )!

Modification Step 3 – Modify portlet layout V. Add an error message: –Append the following to the end of the JSP file:

Modification Step 4 – Modify portlet class I. Necessary modifications: –Read additional input and update workflow's input file with it –Report error message if inputs are not integers Open “MyASM_SamplePortlet.java” Check out the “doSetInput” method

Modification Step 4 – Modify portlet class II. Original version

Modification Step 4 – Modify portlet class III. Updated version Define input file's port number Get input file's content Input validation Update Input Port

Modification Step 5 – Modify XML files Expand “Configuration Files” Open “web.xml” Select the “XML” view Modify any occurences of “ASM_Sample” to the name of your new project (e.g. “MyASM_Sample”)

Modification Step 5 – Modify XML files Expand “Configuration Files” Open “web.xml” Select the “XML” view Modify any occurences of “ASM_Sample” to the name of your new project (e.g. “MyASM_Sample”)

Modification Step 5 – Modify XML files Expand “Configuration Files” Open “portlet.xml” Select the “XML” view Change the “portlet-class” tag to the name of the class you renamed “ASM_SamplePortlet” to You are welcome to change any of the “portlet-info” sub-tags

Modification Step 5 – Modify XML files Expand “Configuration Files” Open “portlet.xml” Select the “XML” view Change the “portlet-class” tag to the name of the class you renamed “ASM_SamplePortlet” to You are welcome to change any of the “portlet-info” sub-tags

Deploy it to Liferay-based gUSE Sign in as a user with admin roles (default username is : password is : test )

Deploy it to Liferay-based gUSE Navigate to Plugin Installer panel by clicking Manage -> Control Panel, and by selecting Plugins Installation from the menu in the left hand-side, finally clicking install More Portlets button and upload File link.

Adjusting it as a new component (just once) As admin, please go to Settings menu and select Internal Services

Adjusting it as a new component (just once) Click to New button and set the followings: Type of Component: portal Service group: gUSE URL of Component: URL to initialize Component: Public URL of Component: State: active Then click to Save button!

Adjusting it as a new component (just once) Click to copy component Properties tab Set as Source component and as Destination one, then click to copy

Adjusting it as a new component Finally initialize the whole portal again by calling (in some cases portal restart required.)

Creating new menuitem for it (just once)

Adding the portlet under this menu (just once) Click to „Add” and select „more” The newly developed portlet should be available under undefined group. Finally click to „add” in the row of the portlet