|
|
(37 intermediate revisions by the same user not shown) |
Line 1: |
Line 1: |
− | {{ScoutPage|cat=Tutorial}}
| + | The Scout documentation has been moved to https://eclipsescout.github.io/. |
− | | + | |
− | This little tutorial will show you how to create your first little application.
| + | |
− | It uses a very small sample database provided for download.
| + | |
− | The data is selected from the database and shown on the client, allowing users | + | |
− | to browse it, search it and edit it.
| + | |
− | | + | |
− | == Installation / Set Up ==
| + | |
− | | + | |
− | You need to get the '''Scout SDK''' and a '''demo database''' to work through this tutorial. {{ScoutLink|Tutorial|Installation and Setup|Learn more}}
| + | |
− | | + | |
− | == Setup a New Eclipse Scout Project ==
| + | |
− | | + | |
− | Switch to the Scout Perspective and '''create a new Scout Project'''. {{ScoutLink|Tutorial|Setup a New Eclipse Scout Project|Learn More}}
| + | |
− | | + | |
− | == Setup a SQL Service ==
| + | |
− | | + | |
− | We'll use [http://db.apache.org/derby/ Apache Derby] for this tutorial. We need to tell the framework how to contact it. {{ScoutLink|Tutorial|Setup a SQL Service|Learn More}}
| + | |
− | | + | |
− | == Write The First Page ==
| + | |
− | | + | |
− | A standard Eclipse Scout application consists of '''pages''' in a tree structure. A page typically shows data in some sort of table. If you write an application, you need to start with a page. {{ScoutLink|Tutorial|Write The First Page|Learn more}}
| + | |
− | | + | |
− | You should have a tiny Eclipse Scout application running at the end of this step!
| + | |
− | | + | |
− | == Add a search form to the table page ==
| + | |
− | | + | |
− | We created a page with a table listing all the companies in the database. Add a search form that allows users to limit the number of rows returned. {{ScoutLink|Tutorial|Add a search form|Learn more}}
| + | |
− | | + | |
− | == Add a form to edit the data ==
| + | |
− | | + | |
− | In order to edit the data in our page, we need to create a context menu to call a form, create the form and the process service it needs to actually select, insert, update (and possibly delete) the data. {{ScoutLink|Tutorial|Add a form|Learn more}}
| + | |
− | | + | |
− | All the examples in the tutorial were based on the company table. You should be able to do the same for the person table, now.
| + | |
− | | + | |
− | == Write the second page ==
| + | |
− | | + | |
− | We wrote the company table page, now let's write a top-level person table page. Once we have that, we want to '''reuse the table page''' by also using it as a child page for a company. {{ScoutLink|Tutorial|Write The Second Page|Learn more}}
| + | |
− | | + | |
− | You will end up with the following tree structure for your application:
| + | |
− | | + | |
− | Standard Outline
| + | |
− | │
| + | |
− | ├─Company Table Page
| + | |
− | │ │
| + | |
− | │ └─Person Table Page
| + | |
− | │
| + | |
− | └─Person Table Page
| + | |
− | | + | |
− | == Reorganize the tree and add a webservice ==
| + | |
− | | + | |
− | We want to add a web service (in this case we're going to use Bing because it offers a standard interface where as Google no longer does). We'll add it under the ''companies table page'', which will require us to add a '''page with nodes''' and reorganize the tree a bit. {{ScoutLink|Tutorial|Reorganize the tree|Learn more}}
| + | |
− | | + | |
− | When we're done, the result should look as follows:
| + | |
− | | + | |
− | Standard Outline
| + | |
− | │
| + | |
− | ├─Company Table Page
| + | |
− | │ │
| + | |
− | │ └─Company Details Node Page ← new
| + | |
− | │ │
| + | |
− | │ └─Person Table Page
| + | |
− | │
| + | |
− | └─Person Table Page
| + | |
− | | + | |
− | == Use a webservice ==
| + | |
− | | + | |
− | We want to add a web service (in this case we're going to use Bing because it offers a standard interface where as Google no longer does). We'll add it under the ''companies details node page''. {{ScoutLink|Tutorial|Use a webservice|Learn more}}
| + | |
− | | + | |
− | When we're done, the result should look as follows:
| + | |
− | | + | |
− | Standard Outline
| + | |
− | │
| + | |
− | ├─Company Table Page
| + | |
− | │ │
| + | |
− | │ └─Company Details Node Page
| + | |
− | │ │
| + | |
− | │ ├─Person Table Page
| + | |
− | │ │
| + | |
− | │ └─Bing Table Page ← new
| + | |
− | │
| + | |
− | └─Person Table Page
| + | |