|
|
| (26 intermediate revisions by 9 users not shown) |
| Line 1: |
Line 1: |
| − | {{note|Scout Tutorial|This page belongs to the [[Scout/Tutorial/Minicrm Step-by-Step|Minicrm Step-by-Step Tutorial]]. It explains how setup a new Eclipse Scout project. You need to {{ScoutLink|Tutorial|Installation and Setup|install the Scout SDK}} in order to continue.}}
| + | The Scout documentation has been moved to https://eclipsescout.github.io/. |
| − | | + | |
| − | We need to create '''a new Scout Project''' and '''switch to the Scout Perspective'''. When we're done we can run the server, verify that it is running using a web browser, and we can run the client using either the Swing or the SWT user interface.
| + | |
| − | | + | |
| − | The client will not contain anything, but this will demonstrate that our infrastructure is working. | + | |
| − | | + | |
| − | {{tip|New Workspace|Make sure you start with a new workspace.}}
| + | |
| − | | + | |
| − | == Create a new Eclipse Scout project ==
| + | |
| − | | + | |
| − | If you haven't done so yet, '''change to the Scout Perspective'''.
| + | |
| − | | + | |
| − | Right-click on the folder ''Scout Projects'' and choose '''New Scout Project''' in order to create a new Scout project.
| + | |
| − | | + | |
| − | [[Image:NewProjectScout.jpg||The context menu to create a new Scout Project]]
| + | |
| − | | + | |
| − | Use ''eclipse.org.minicrm'' for the '''project name'''.
| + | |
| − | | + | |
| − | [[Image:ProjectWizard.jpg||The wizard to create a new Scout Project]]
| + | |
| − | | + | |
| − | {{note|Project Name, Project Alias|The project name will be used for all the '''plugins''' created. They'll get names like <tt>eclipse.org.minicrm.client</tt> and <tt>eclipse.org.minicrm.server</tt>. The project alias will be used for the '''servlet''' running on the server. Once you started the server you'll be able to contact it at <tt><nowiki>http://localhost:8080/minicrm</nowiki></tt>. Thus, the alias will be '''visible''' to the outside world.}}
| + | |
| − | | + | |
| − | If you expand the project tree it will have nodes for ''client'', ''shared'' and ''server'' as well as nodes for the two user interfaces, ''ui.swing'' and ''ui.swt''.
| + | |
| − | | + | |
| − | [[Image:Project.jpg]]
| + | |
| − | | + | |
| − | {{warning|Issues with Mac OS 10.6 and Swing Client|If you try to start the swing client in Mac OS 10.6, this might fail. To fix this go to the run configuration of the swing client. In the tab Arguments you have to remove <tt>-ws ${target.ws}</tt> from the program arguments and <tt>-Dorg.eclipse.swt.internal.carbon.smallFonts</tt> from the VM arguments.}}
| + | |
| − | | + | |
| − | == Start the Server ==
| + | |
| − | | + | |
| − | Click on the server node. This will show two products, a production product and a development product. '''Click the green arrow''' of the development product to start it.
| + | |
| − | | + | |
| − | [[Image:ServerProduct.jpg]]
| + | |
| − | | + | |
| − | {{note|Two Products|The two products allow you to specify two different config files. This allows you to set system properties determining which databases to connect to, which log levels to use, etc.}}
| + | |
| − | | + | |
| − | == Test the Server ==
| + | |
| − | To test if the server is running properly, go to http://localhost:8080/minicrm/process. To log in, use '''admin''' as username and '''manager''' as password.
| + | |
| − | | + | |
| − | You should see a page with information about the server. The login information is defined in the '''config.ini''' file of the server product. Have a look: click on the <u>open config.ini</u> link. Note the BasicSecurityFilter settings.
| + | |
| − | | + | |
| − | [[Image:ServerProductConfiguration.jpg]]
| + | |
| − | | + | |
| − | == Start the Client ==
| + | |
| − | Click on either the ''ui.swing'' or the ''ui.swt'' node and start the ''development'' client product by clicking on the green arrow.
| + | |
| − | | + | |
| − | When asked for a login, enter the same login information as before: username '''admin''' password '''manager'''. Or use any other username/password combination from the config.ini.
| + | |
| − | | + | |
| − | You should see an empty client application:
| + | |
| − | | + | |
| − | [[Image:Minicrm.jpg|Minicrm.jpg]]
| + | |
| − | | + | |
| − | {{note|A Different Language|If you want to run the client in a different language than your system's default, you might have to fiddle with the ''configuration''. From the ''Run'' menu, choose ''Debug Configurations...'' and switch to the ''Arguments'' tab. There, replace <tt>-nl ${target.nl}</tt> with <tt>-nl en_US</tt>. Click the ''Apply'' button and the ''Debug'' button. Eclipse will remember this setting as long as you keep reusing the Run and Debug menus (using the two green buttons in the tool-bar to run products). If you use the ''Scout Object Properties'' tab, this language setting will revert to the default.}}
| + | |
