Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Scout/Tutorial/3.7/HelloWorld

< Scout‎ | Tutorial‎ | 3.7
Revision as of 08:42, 21 March 2012 by Anna-nina.wille-simonetto.cardcenter.ch (Talk | contribs) (Client Side: Add a Message Field to the Desktop Form)

The Scout documentation has been moved to https://eclipsescout.github.io/.

The Scout "Hello World" Application

This page shows how to create your Hello World app using the The Scout documentation has been moved to https://eclipsescout.github.io/.. We assume that you already have The Scout documentation has been moved to https://eclipsescout.github.io/..

Create a new Scout Project


Newprojectmenu.png

Start your Eclipse and Use the New|Project ... menu


Newprojectdialog1.png

In the wizard choose Scout project and click Next


Newprojectdialog2.png

Enter org.eclipse.scout.helloworld as an application name. The last part of the name (after the last period) will automatically be used as the project alias. Then, click Next


Newprojectdialog3.png

Select Application with a single form as your app template, then click Finish


Switchperspective.png

The empty application is created by The Scout documentation has been moved to https://eclipsescout.github.io/. and if you are not already in the The Scout documentation has been moved to https://eclipsescout.github.io/. you are prompted to change there now, click on Yes


Automaticformdataupdate.png

Make sure you have switched on the automatic The Scout documentation has been moved to https://eclipsescout.github.io/. update in menu Scout|Update Formdata Automatically

Run the Empty Scout Application in the Scout SDK


Productlauncher.png

In the The Scout documentation has been moved to https://eclipsescout.github.io/. open the node Scout Projects, then click on org.eclipse.scout.helloworld. This will show the Scout Object Properties for the application where you click on the edit icon of the product launcher.

In the product launcher you then select the shortcuts to the launching boxes that you will need most during application development. Typically this contains:


Runningempty.png

After starting first the server and then the client from the launching boxes configured in the last step the empty client will appear.

Client Side: Add a Message Field to the Desktop Form


Addformfield.png

In the The Scout documentation has been moved to https://eclipsescout.github.io/. drill down to client, Forms, DesktopForm, MainBox

To the main box we will add a message The Scout documentation has been moved to https://eclipsescout.github.io/.. Click right on MainBox and choose the menu New Form Field.


Newstringfield1.png

Step 1: Select field type. Here we'll use a The Scout documentation has been moved to https://eclipsescout.github.io/.. Then click Next (you may directly click on it or use the search box as shown above)


Newstringfield2.png

Step 2: Add the field label, type "Message" that triggers the dropdown list. Choose New translated text... (or use an existing text)


Newstringfield3.png

Step 3: Fill in the default translation. Some other fields are automatically filled:

  • Key Name used to retrieve the translated text in the code
  • Deutsch German translation ...

Then click OK


Newstringfield4.png

Step 4: Verify details of the new string field:

  • Key Name used to retrieve the translated text in the code
  • Deutsch German translation ...

Confirm by clicking Finish


Newstringfield5.png

Navigate down from the MainBox to the newly created MessageField. Double click on the MessageField node to display the generated code (selected code in screenshot above) in the Java editor window.

Server Side: Implement the Data Loading

In the The Scout documentation has been moved to https://eclipsescout.github.io/. navigate to the server node, then Process Services, and DesktopFormService. The DesktopFormService is the server side service corresponding to the DesktopForm defined on the client side. This The Scout documentation has been moved to https://eclipsescout.github.io/. was created as part of the selected application template. The load(DesktopFormData) method is defined out of the box.

Serverloadmethod.png

Add a simple implentation for the load method:

  1. public DesktopFormData load(DesktopFormData formData) throws ProcessingException {
  2.   formData.getMessage().setValue("hello world");
  3.   return formData;
  4. }

On line 2 we access the message field of the The Scout documentation has been moved to https://eclipsescout.github.io/. and set it's value to "hello world". The updated form data is returned and eventually sent back to the client.

Run the "hello world" application

In the The Scout documentation has been moved to https://eclipsescout.github.io/. go back to top-level node Scout Projects, then click on org.eclipse.scout.helloworld to access the launch boxes in the Scout Object Properties.

  • Start the server in the server box
  • Start the client in the SWT box

And, "Ta Taa"


Finalapplication.png

Back to the top