Tutorial: Building a Worklist Application
Step 1. Set Up Your Environment
In this step, you set up the actors in the tutorial, that is, the users and groups required to complete the tasks you design in the tutorial business process. Specifically, if you have not already done so, you create an integration domain for your worklist application. Next, you use the WebLogic Integration Administration Console to configure users and groups. Lastly, you create a business calendar for your SoftCo enterprise.
Complete the following tasks in Step 1:
Before You Begin
Before you begin the Worklist tutorial you must have WebLogic Platform 8.1 installed on your system. For more information, see Installing WebLogic Platform.
Create a New WebLogic Integration Domain
The Worklist tutorial requires a WebLogic Integration domain. If you have not already created a WebLogic Integration domain, use the WebLogic Platform Configuration Wizard to create one. If you have already created an integration domain and you want to use it for the tutorial application, you can skip the procedure to create a new domain and instead start WebLogic Server in the existing domain.
Note: The domain name used in this tutorial is worktutorial
, but you can use any valid domain name.
To Create a New WebLogic Integration Domain
- Start the Configuration Wizard:
- Windows: From the Start menu, choose Programs—>BEA WebLogic Platform 8.1—>Configuration Wizard.
- UNIX: Open a command shell, change to the
/common/bin
subdirectory of the product installation directory (such as /bea/weblogic81/common/bin
), and enter the following command: sh config.sh
.
The Configuration Wizard starts and displays the Create or Extend a Configuration screen.
- Select Create a new WebLogic configuration (default), and click Next.
- In the Configuration Wizard, make the following selections in each screen. After each selection, click Next to continue.
Table 2-1 Selections in the Configuration Wizard
Screen Name
|
Recommended Selection
|
Select a Configuration Template
|
Basic WebLogic Integration Domain (from the list of templates).
|
Choose Express or Custom Configuration
|
Express (default)
|
Configure Administrative Username and Password
|
Specify the administrator password (required) and change defaults as needed.
|
Configure Server Start Mode and Java SDK
|
Development Mode (from WebLogic Configuration Startup Mode)
Sun SDK (from BEA Supplied SDKs)
|
Create WebLogic Configuration
|
In the Configuration Name field (lower-right corner), specify worktutorial or another name that you want to use for this domain. Go to the next step.
|
By default, the Configuration Wizard creates the new domain in the following location: BEA_HOME
\user_projects\domains\
domainName
, where:
BEA_HOME
is the directory in which you installed WebLogic platform, such as d:\bea
.
domainName
is the name of the domain you created (worktutorial
, in this case).
- On the Creating Configuration screen, select Start Admin Server.
Configure the Users and Groups
You use the WebLogic Integration Administration Console to configure the following groups in your SoftCo enterprise: Quality Engineers, Release Managers, Development Engineers.
- After the WebLogic Server is running, start the WebLogic Integration Administration Console by doing either of the following:
- From the Start menu, choose Programs—>BEA WebLogic Platform 8.1—>Examples—>WebLogic Integration—>Integration Admin Console.
- In a Web browser, enter the following URL:
http://localhost:7001/wliconsole
.
- When prompted, enter the username and password that you specified for your domain.
The WebLogic Integration Administration Console displays the home page.
- Select the User Management module:
The User Management screen is displayed:
- In the left panel, click Groups. The View and Edit Groups screen is displayed, which allows you to create new groups.
- In the left panel, click Create New to create a new group:
- In the Group Name field, enter
QualityEngineers
.
- (Optional) In the Description field, enter a description for the group, such as
Softco QA Engineers
.
- In the Group Membership field, select IntegrationUsers from the list of Available Groups and use the arrow to move the IntegrationUsers group into the Current Groups list.
- Repeat Step 5 two more times to create two more groups—name the groups ReleaseManagers, and DevelopmentEngineers.
- The groups you create are added to the list of groups on the View and Edit Groups screen:
- In the left panel, click Users. The View and Edit Users screen is displayed.
- Click Create New. The Add New User screen is displayed.
- Create users, as described in the following table:
User Name
|
Email
|
Password
|
Group Membership
|
QualityEngineerA
|
For simplicity, specify the same email address for each user, one that will work for your testing purposes.
|
For simplicity, specify the same password for each user.
|
IntegrationUsers
QualityEngineers
|
QualityEngineerB
|
IntegrationUsers
QualityEngineers
|
ReleaseManagerA
|
IntegrationUsers
ReleaseManagers
|
ReleaseManagerB
|
IntegrationUsers
ReleaseManagers
|
DevEngineerA
|
DevelopmentEngineers
IntegrationUsers
|
DevEngineerB
|
DevelopmentEngineers
IntegrationUsers
|
Your screen should resemble the following:
Create a Business Calendar
You must create a Business Calendar for use by the SoftCo enterprise during the tutorial scenario. A Business Calendar specifies the dates and times that an enterprise is open for business.
- Navigate to the Business Calendar Configuration module in the WebLogic Integration Administration Console.
- Click Create New. The Create Business Calendar screen is displayed.
- In the Business Calendar Name field, enter
SoftwareTeamCalendar
.
- Click Create. The calendar is created and listed on the Business Calendar Management screen.
- In the calendar list, click SoftwareTeamCalendar. The View Business Calendar Details screen is displayed, which allows you to specify the time period rules.
The default rules in the business calendar specify that business hours for employees at SoftCo include Monday to Friday, 9AM to 5PM. You must change the default rules to create the appropriate calendar for the SoftCo enterprise. You can change the business rules for the calendar by editing the Time Period Rules table. To do so:
- For each of the days listed in the default calendar, click the Time Period to open an update page.
- Change the Start Hour and End Hour to 10 and 20, respectively.
Recall that SoftCo engineers work Monday through Friday 10AM to 8PM and Saturdays from 10AM to 2PM.
- Click Submit. The business hours for Monday to Friday are updated in the Time Period Rules table.
- To add a rule for Saturday business hours, click Add a New Rule. A page is displayed in which you can specify the time period rules for Saturday. Select the following specifications in the appropriate fields:
Time Period Type: Day of Week
Day of Week: Sat
Start Hour and Minute: 10 00
End Hour and Minute: 14 00
Free or Busy: Free
Click Submit. The business hours for Saturday are updated in the Time Period Rules table, as shown in the following figure:
This completes creating the Business Calendar for the tutorial. To begin creating a WebLogic Workshop application that orchestrates the resolution of a bug in the SoftCo bug tracking system, proceed to Step 2. Create Your Application.
Note: To learn more about Business Calendars and defining the time-period rules, see Business Calendar Configuration in Managing WebLogic Integration Solutions.