Introduction to Skyway Builder Tutorial

Open the Project Editor by double-clicking on the PAM project icon. Switch to the Variables tab, which is located along the bottom of the editor, and add variables per the following table. As you add variables, the type picker will show you the Skyway Basic types plus any data types defined in any open Skyway projects.

Figure 2.4. Editor: Project Editor - Variables

Save the project using File-->Save.

Right click on PAM project, and select New-->Service

Figure 3.1. New --> Service

From the New Skyway Service Wizard, enter "AppraisalService" for the filename. This will be the name of the new service. The container for this service should be the project (PAM). If the project is not highlighted, then select the project.

Figure 3.2. Wizard: New Skyway Service

When done, click Finish.

Righ click on the AppraisalService service, and select New-->Data Type

Figure 3.3. New --> Data Type

From the New Data Type Wizard, enter "Appraisal" for the filename. This will be the name of the new data type. The container for this data type should be the service (AppraisalService). If the service not highlighted, then select the service.

Figure 3.4. Wizard: New Data Type

When done, click Finish. This will open the Data Type editor.

Figure 3.5. Editor: Data Type Editor - Overview

From the Overview tab of the Data Type editor, add the following fields.

Figure 3.6. Data Type: Appraisal Fields

Save the data type using File-->Save. You may also close the editor.

Right click on the AppraisalService service, and select New-->Data Store

From the New Data Store Wizard, enter "AppraisalDS" for the filename. This will be the name of the new data store. The container for this data type should be the service (AppraisalService). If the service not highlighted, then click on it before clicking Next to go to the next panel.

Figure 3.7. Wizard: New Data Store

From the Add Data Type panel, click the Add button, and select the "Appraisal" data type from the Data Types list.

Figure 3.8. Wizard: New Data Store - Add Data Types

Figure 3.9. Wizard: New Data Store - Managed Data Types

When done, click Finish. This will open the Data Store editor.

Figure 3.10. Editor: Data Store Editor - Overview

On the Database Configuration tab the database connection should be defaulted to the data connection you created when you performed the Sandbox setup prerequisites. Per the sandbox setup guide, the db connection is called SkywayDB. If you haven't created a connection yet, you can create a new connection from here.

Figure 3.11. Editor: Data Store Editor - Database Configuration

Save the data store using File-->Save.

Right click on the AppraisalService service, and select New-->Operation

Configure the Create Skyway Project Wizard as follows:

Figure 4.1. Wizard: New Operation - Name

Figure 4.2. Wizard: New Operation - Entry Point Action

When done, click Finish. This will open the Operation editor.

Figure 4.3. Editor: Operation Editor - Overview

From the Inputs/Outputs tab of the Operation Editor, add an input variable per the following table. Adding variables is very similar to adding variables to a project. As you add variables, the type picker will show you the Skyway Basic types plus the data types of any open Skyway projects.

Figure 4.4. Select Type

Figure 4.5. Editor: Operation Editor - Inputs/Outputs

Save the operation using File-->Save.

Open the Save action by double-clicking on the action in the Skyway Navigator. This will open the Action editor.

Figure 4.6. Open Action Editor

From here you will model the implementation of the operation. In this case the operation will be implemented with one step, so it can be modeled using only the entry-point action. However in other cases, as described earlier, you may choose to decompose the logic into multiple actions that are strung together by the entry-point action.

To implement the Action, open the step palette.

Figure 4.7. Step Palette

Implementing the Action consists of dropping the desired steps onto the canvas, configuring the steps (properties), and stringing the steps together into a flow. Click on the Modify Data Store step and then click on the canvas. Repeat this for all the steps listed in the following table.

Once the steps are added the canvas, you can configure the steps by double-clicking on the step to open the step properties. Configure the step properties using the following table as a reference.

Table 4.3. Action Implementation: Save Action

Step Name	Step Type	Configuration
Persist Appraisal	Modify Data Store	Properties-->Modify Tab Data Store: AppraisalDS Operation: Update Operation Input: inAppraisal
Stop	Stop
	Note	Optional Text: "This action persists the appraisal to the data source."

To connect the steps, click on the Connector in the palette, click on the first step (Persist Appraisal) and drag to the second step (Stop).

Save the action using File-->Save.

Figure 4.8. Operation Action: Save

Figure 4.9. Properties: Modify Data Store Step - Modify

Right click on WebContent folder, and select New-->JSP. This will open the New JavaServer Page Wizard.

Enter index.jsp as the filename, and click the Next button.

Figure 5.1. Wizard: New JavaServer Page - Name

Select Skyway JSP File (html) as the template, and click the Finish button.

Figure 5.2. Wizard: New JavaServer Page - Template

Create another JSP page called edit.jsp using Skyway JSP File (html) as the template.

Create another JSP page called confirm.jsp using Skyway JSP File (html) as the template.

Right click on PAM project, and select New-->Web Controller

From the New Web Controller Wizard, enter "PAMController" for the filename. This will be the name of the new web controller. The container for this web controller should be the project (PAM). If the project is not highlighted, then select the project.

Figure 5.4. Wizard: New Web Controller

When done, click Finish.

Right click the on PAMController web controller, and select New-->Web Conversation

From the New Web Conversation Wizard, enter "PerformanceMgmt" for the filename. This will be the name of the new web conversation. The container for this web conversation should be the web controller (PAMController). If the web controller is not highlighted, then select the web controller.

Figure 5.6. Wizard: New Web Conversation

When done, click Finish. This will open the Web Conversation editor.

Figure 5.7. Editor: Web Conversation Editor

From the Variables tab of the Web Conversation Editor, add variables per the following table. As you add variables, the type picker will show you the Skyway Basic types plus any data types in Skyway projects.

Figure 5.8. Editor: Web Conversation Editor - Variables

Save the conversation using File-->Save.

Right click the on PerformanceMgmt web conversation, and select New-->Action

From the New Action Wizard, enter "InitConversation" for the filename. This will be the name of the new action. The container for this action should be the web conversation(PerformanceMgmt). If the web conversation is not highlighted, then select the web conversation.

Figure 5.10. Wizard: New Action - Name

Figure 5.11. Wizard: New Action - URL Action Mapping

When done, click Finish. This will open the Action editor.

From here you will model the implementation of the action. Implementing the Action consists of dropping steps onto the canvas, configuring the steps, and stringing the steps together into a flow. The following diagram shows the implementation of the InitConversation action.

Figure 5.12. Conversation Action: InitConversation

In this case there are only two steps. Once a step is added the canvas, you can configure the step by double-clicking on the step to open the step properties.

Table 5.2. Action Implementation: InitConversation Action

Step Name	Step Type	Configuration
Retrieve All Appraisal	Search Data Store	Properties-->Select Data Store Info Search Data Store: PAM.AppraisalService.AppraisalDS Target Variable: ${appraisals} Properties-->Search Criteria Criteria Type: All Records Properties-->Sort Fields None
Stop	Stop
	Note	Optional Text: "This action persists the appraisal to the data source."

Figure 5.13. Properties: Search Data Store - Select Data Store Info

Figure 5.14. Properties: Search Data Store - Search Criteria

A Note can be optionally added to an action to describe the functionality of the action.

Right click the on PerformanceMgmt web conversation, and select New-->Action

From the New Action Wizard, enter "InitNewAppraisal" for the filename. This will be the name of the new action. The container for this action should be the web conversation(PerformanceMgmt). If the web conversation is not highlighted, then select the web conversation.

When done, click Finish. This will open the Action editor.

From here you will model the implementation of the action. Implementing the Action consists of dropping steps onto the canvas, configuring the steps, and stringing the steps together into a flow. The following diagram shows the implementation of the InitConversation action.

In this case there are only two steps. Once a step is added the canvas, you can configure the step by double-clicking on the step to open the step properties.

Table 5.3. Action Implementation: InitNewAppraisal Action

Step Name	Step Type	Configuration
New Appraisal	Variable Editor	Properties-->Variable Editor Variable:currentAppraisal = RESET Insert the currentAppraisal variable using the Insert Variable button, and then press the Reset button. The Reset button will append the "= RESET" to the expression.
Stop	Stop
	Note	Optional Text: "This action persists the appraisal to the data source."

Figure 5.16. Conversation Action: InitNewAppraisal

A Note can be optionally added to an action to describe the functionality of the action.

Right click the on PerformanceMgmt web conversation, and select New-->Action

From the New Action Wizard, enter "ValidateAppraisal" for the filename. This will be the name of the new action. The container for this action should be the web conversation (PerformanceMgmt). If the web conversation is not highlighted, then select the web conversation.

When done, click Finish. This will open the Action editor.

From here you will model the implementation of the action. Implementing the Action consists of dropping steps onto the canvas, configuring the steps, and stringing the steps together into a flow. The following diagram shows the implementation of the InitConversation action.

Figure 5.18. Conversation Action: ValidateAppraisal

In this case there are only two steps. Once a step is added the canvas, you can configure the step by double-clicking on the step to open the step properties.

Table 5.4. Action Implementation: ValidateAppraisal Action

Step Name	Step Type	Configuration
Required Fields Specified?	Decision	Properties-->Decision Criteria Expression: currentAppraisal.employeeNo != null && currentAppraisal.employeeNo != ""
Proceed to Confirm Page	Variable Editor	Properties-->Variable Editor Variable:project.page = "/confirm"
Proceed to Edit Page	Variable Editor	Properties-->Variable Editor Variable:project.page = "/edit"
Stop	Stop
	Note	Optional Text: "This action persists the appraisal to the data source."

Figure 5.19. Properties: Decision Step - Decision Criteria

Figure 5.20. Properties: Variable Editor - Variable Editor

Figure 5.21. Properties: Variable Editor - Variable Editor

A Note can be optionally added to an action to describe the functionality of the action.

Right click the on PerformanceMgmt web conversation, and select New-->Action

From the New Action Wizard, enter "SaveAppraisal" for the filename. This will be the name of the new action. The container for this action should be the web conversation(PerformanceMgmt). If the web conversation is not highlighted, then select the web conversation.

When done, click Finish. This will open the Action editor.

From here you will model the implementation of the action. Implementing the Action consists of dropping steps onto the canvas, configuring the steps, and stringing the steps together into a flow. The following diagram shows the implementation of the InitConversation action.

Figure 5.23. Conversation Action: SaveAppraisal

In this case there are only two steps. Once a step is added the canvas, you can configure the step by double-clicking on the step to open the step properties.

Table 5.5. Action Implementation: SaveAppraisal Action

Step Name	Step Type	Configuration
Invoke Save Appraisal Operation	Invoke Operation	Properties-->Operation Operation: PAM.AppraisalService.SaveAppraisal Properties-->Inputs Input Variable: inAppraisal - Expression: currentAppraisal Properties-->Outputs None
Invoke InitConversation Action	Invoke Action	Properties-->Operation Action: PAM.PAMController.PerformanceMgmt.InitConversation
Stop	Stop
	Note	Optional Text: "This action persists the appraisal to the data source."

A Note can be optionally added to an action to describe the functionality of the action.

The pages are comprised of a combination of html and Skyway web controls. Using the Web Control palette, build the page according to the following listing. Following the listing there is a description of key web controls and their configuration.

<%@taglib uri="http://www.skywaysoftware.com/taglibs/core"
	prefix="skyway"%><%@ page language="java" contentType="text/html; charset=ISO-8859-1"
    pageEncoding="ISO-8859-1"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Insert title here</title>
</head>
<body>
<skyway:form action="/PAM/PAMController/PerformanceMgmt/InitNewAppraisal">
  <skyway:button label="New" type ="submit"></skyway:button>
</skyway:form>

<table>
  <tr>
	<td>Employee No</td>
	<td>Last Name</td>
	<td>First Name</td>
	<td>Design</td>
	<td>Program</td>
	<td>Test</td>
	<td>Comments</td>
  </tr>
<skyway:iterator items="${PAMController.PerformanceMgmt.appraisals }" var="current">
  <tr>
	 <td><skyway:label value="${current.employeeNo}"></skyway:label></td>
	 <td><skyway:label value="${current.lastName}"></skyway:label></td>
	 <td><skyway:label value="${current.firstName}"></skyway:label></td>
	 <td><skyway:label value="${current.ratingDesign}"></skyway:label></td>
	 <td><skyway:label value="${current.ratingProgramming}"></skyway:label></td>
	 <td><skyway:label value="${current.ratingTesting}"></skyway:label></td>
	 <td><skyway:label value="${current.comments}"></skyway:label></td>
  </tr>
</skyway:iterator>
</table>
</body>
</html>

Using the Web Control palette, build the page according to the following listing. Following the listing there is a description of key web controls and their configuration.

<%@taglib uri="http://www.skywaysoftware.com/taglibs/core" prefix="skyway"%>
<%@ page language="java" contentType="text/html; charset=ISO-8859-1"
    pageEncoding="ISO-8859-1"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Insert title here</title>
</head>
<body>
<skyway:form action="/PAM/PAMController/PerformanceMgmt/ValidateAppraisal">
  Employee No
    <skyway:input path="PAMController.PerformanceMgmt.currentAppraisal.employeeNo"></skyway:input>
  <br>
  Last Name
    <skyway:input path="PAMController.PerformanceMgmt.currentAppraisal.lastName"></skyway:input>
  <br>
  First Name
  <skyway:input  path="PAMController.PerformanceMgmt.currentAppraisal.firstName"></skyway:input>
  <h2>Ratings:</h2>     
  Design
  <skyway:dropdown path="PAMController.PerformanceMgmt.currentAppraisal.ratingDesign">
    <skyway:option label="Exceeds Expectations" value="1"></skyway:option>
    <skyway:option label="Meets Expectations" value="2"></skyway:option>
    <skyway:option label="Does Not Meet Expectations" value="3"></skyway:option>
  </skyway:dropdown><br>
  Programming
  <skyway:dropdown  path="PAMController.PerformanceMgmt.currentAppraisal.ratingProgramming">
    <skyway:option label="Exceeds Expectations" value="1"></skyway:option>
    <skyway:option label="Meets Expectations" value="2"></skyway:option>
    <skyway:option label="Does Not Meet Expectations" value="3"></skyway:option>
  </skyway:dropdown><br>
  Testing
  <skyway:dropdown  path="PAMController.PerformanceMgmt.currentAppraisal.ratingTesting">
    <skyway:option label="Exceeds Expectations" value="1"></skyway:option>
    <skyway:option label="Meets Expectations" value="2"></skyway:option>
    <skyway:option label="Does Not Meet Expectations" value="3"></skyway:option>
  </skyway:dropdown>
  <br>
  Comments:
  <skyway:textarea  path="PAMController.PerformanceMgmt.currentAppraisal.comments"></skyway:textarea>
  <br>
  <skyway:button type="submit" label="Next" ></skyway:button>   
</skyway:form>
</body>
</html>

Using the Web Control palette, build the page according to the following listing. Following the listing there is a description of key web controls and their configuration.