Professional Documents
Culture Documents
Workshop
EXERCISES
Table of Contents
Exercise 1 – Start the Integration Server................................................................................ 3
Exercise 2 – Packages, Folders, & Services.......................................................................... 5
Exercise 3 – Input/Output & Document Types..................................................................... 10
Exercise 4a – Building Flow Services: BRANCH................................................................. 14
Exercise 4b – Building Flow Services: LOOP....................................................................... 18
Exercise 4c – Building Flow Services: SEQUENCE............................................................. 22
Exercise 5 – Mapping Services ............................................................................................. 27
Exercise 6 – Local Publish..................................................................................................... 31
Exercise 7 – Subscribing to Documents............................................................................... 33
Exercise 8a – Adapters (Connection Alias).......................................................................... 37
Exercise 8b – Adapters (Adapter Services).......................................................................... 39
Exercise 9 – Notification........................................................................................................ 41
Exercise 10 – Web Services................................................................................................... 43
Exercise 11 – Trading Networks Profiles.............................................................................. 48
Exercise 12 – Trading Networks Document Types.............................................................. 50
Exercise 13 – Monitoring Services........................................................................................ 54
Exercise 14 – Configure Logical Servers.............................................................................. 56
Start the Integration Server, create a user account, and grant privileges to it
10 minutes
Ta s k
1. Start the Integration server from the command line. Use a debug level of 6 and write
the log to the server window instead of the file system.
R e qui r e d Da ta
This section contains data required to complete this exercise. Refer to this data sheet as
necessary while performing the exercise.
Data Value
Debug Level 6
R e s our ce s
• IS Administrators Guide Chapter 4: Starting and Stopping the Server
Ti ps & Tr i ck s
• Command line switches are entered with the “-“ character, as in “-log
none”.
! Note: The Integration Server uses the Java Run-time Engine to execute the different
services. When you start the server, your system will start an instance of Java (either
java.exe or jre.exe, depending on your JDK). You can view this running process in
Windows by using the Task Manager.
15 minutes
Ta s k
To begin development, we need a package and folder organization.
Create a Service to write a hard-coded message to the Server log. Place the
Service in the namespace as indicated below.
Run the service and confirm successful execution in the server log.
R e qui r e d Da ta
This section contains data required to complete this exercise. Refer to this data sheet as
necessary while performing the exercise.
Data Value
Package D106Exercises
Namespace D106Exercises.exercise2
R e s our ce s
! Note: Outside of a training environment, each user should have a separate account with
appropriate security privileges. Change the Administrator and Developer account
passwords as quickly as possible and do not use Administrator other than to create
your own administration account.
• Select the appropriate parent folder before creating a new folder to ensure
proper nesting.
• To write a message to the log file, you need to browse in the package
WmPublic and find the service pub.flow:debugLog.
15 minutes
Ta s k
1. Create the exercise folders as indicated below.
Run the Service. Test the constraint by using Strings vs. Numeric
values for SerialNumber. Did you see an error message when using Strings?
Use a text editor to view the indicated XML file (location listed
below).
R e qui r e d Da ta
This section contains data required to complete this exercise. Refer to this data sheet as
necessary while performing the exercise.
Data Value
D106Exercises.exercise3.docs
xmlInput
Document type
PersonnelEntry
SerialNumber integer
field Constraint
xmlNodeToDocument pub.xml:xmlNodeToDocument
R e s our ce s
• Developer On-line help: Creating a Document type and Declaring Input and
Output Parameters for a Service.
Ti ps & Tr i ck s
• Use Copy and Paste to simplify document type creation and copying
services.
20 minutes
Ta s k
1. Write Branch code to implement the following design. Test using the Step
feature.
Field = testValue input
Field1 = account
inputs
Field2 = promoCode
e.g. PRE5AAA
account = starts with PRE0 thu PRE9 promoCode=“123FREE”
default
R e qui r e d Da ta
Data Value
branch2
R e s our ce s
• Developer On-line help: Flow Editor and Building a Branch Step, Building a
Loop Step, etc.
Ti ps & Tr i ck s
• Make sure your steps are indented properly.
• The $null child is only used in the second BRANCH because $null only
works with branching on a switch value.
• When you run the services, try the various test values (true, false,
123FREE, PRE0AAA, ABC, etc.) in the input dialog and examine the Results
screen and the console output. Use Step and Step Into commands to
debug your services and watch the execution.
• Worked examples:
20 minutes
Ta s k
1. Write a LOOP service to count the number of employees in the
department.xml file. Display the result in the System Log
2. Test by running it and providing the input manually
3. (Optional) Test using the “Send XML File” feature.
R e qui r e d Da ta
Data Value
(reference exercise3\docs\Department)
xmlNodeToDocument pub.xml:xmlNodeToDocument
R e s our ce s
• Developer On-line help: Flow Editor and Building a Branch Step, Building a
Loop Step, etc.
Ti ps & Tr i ck s
• Make sure your steps are indented properly.
• Insert Map steps to look at the Pipeline when designing your Flow.
• Note that only objects that are mapped or set will persist in the Pipeline,
and that objects specified in the service output will only appear in the last Flow
step of the service.
Optional!
20 minutes
Ta s k
R e qui r e d Da ta
Data Value
pub.flow:getLastError
R e s our ce s
• Developer On-line help: Flow Editor and Building a Branch Step, Building a
Loop Step, etc.
Ti ps & Tr i ck s
• Make sure your steps are indented properly.
sequence_test service
doStuff service:
20 minutes
Ta s k
1. Create this Map Service:
R e qui r e d Da ta
This section contains data required to complete this exercise. Refer to this data sheet as
necessary while performing the exercise.
Data Value
D106Exercises\maps
D106Exercises\docs
R e s our ce s
Ti ps & Tr i ck s
• Create a document type Course_BookOrder from XML file input
• Copy BookOrderTicket from the D106Support package (docs folder).
• Create a service to map from one document type to another (mapBookOrder).
• Use references to Course_BookOrder as input and BookOrderTicket as output.
• Use a MAP statement to map input fields to their output equivalent.
• Double-click on the course_id map link to create a condition, using “!= “D106”
as the condition. Use Pipeline Editor Copy/Paste to get the full path for the field.
• The mapping and Document types will be used in more than one
exercise, so we are creating their folders outside the exercise5 folder in
D106Exercises\maps.
• Worked Example:
Service mapBookOrder:
Conditional Map:
15 minutes
Ta s k
1. Publish (local) the document type BookOrder.
2. The Server log should return a Trigger warning (no trigger available). It has not
been configured yet!
R e qui r e d Da ta
This section contains data required to complete this exercise. Refer to this data sheet as
necessary while performing the exercise.
Data Value
R e s our ce s
• Participant Guide: Publish & Subscribe (Local within IS)
Ti ps & Tr i ck s
• Be sure to use the full, case-sensitive, namespace address when specifying
documentTypeName in the publish invoke (in the Service In).
1. Make your document type Course_BookOrder publishable.
2. Add and configure a publish service call to your service. Set local = true.
3. Use the Run command on the publishable document and publish it locally.
15 minutes
Ta s k
1. Create a Service that subscribes to Course_BookOrder. Write the
course_title field to the Server Log. Test by running the Publishing Service from
exercise 6.
R e qui r e d Da ta
This section contains data required to complete this exercise. Refer to this data sheet as
necessary while performing the exercise.
Data Value
R e s our ce s
Ti ps & Tr i ck s
• Make sure that you have used the fully qualified, case-sensitive
namespace address for your trigger service input document, e.g.
D106Exercises.docs:Course_BookOrder.
• Worked Example:
15 minutes
Ta s k
Create a connection alias for the JDBC Adapter.
R e qui r e d Da ta
This section contains data required to complete this exercise. Refer to this data sheet as
necessary while performing the exercise.
Data Value
R e s our ce s
Ti ps & Tr i ck s
• If all of your data entry for the Connection Alias is correct, the alias
will automatically be enabled for connection when you finish.
• Example:
15 minutes
Ta s k
1. Create an Adapter Service for inserting Book Order data into a database.
2. Test the Adapter service. Use a convenient Database tool to check for
your record insertions.
R e qui r e d Da ta
This section contains data required to complete this exercise. Refer to this data sheet as
necessary while performing the exercise.
Data Value
Table Structure
R e s our ce s
Ti ps & Tr i ck s
• Select all the fields of the table for your Insert services.
• Example:
Exercise 9 – Notification
Key Skills
Create a notification for the Book Order database insert
15 minutes
Ta s k
1. Create a new INSERT notification service, using the
BOOK_ORDER table.
R e qui r e d Da ta
This section contains data required to complete this exercise. Refer to this data sheet as
necessary while performing the exercise.
Data Value
R e s our ce s
Ti ps & Tr i ck s
• Make sure that you select the appropriate columns for inclusion in your
notification document.
• Worked Example:
15 minutes
Ta s k
If you have no Internet access, you will have to skip the external WSDL access portion of
this exercise.
2. Create another Web Service connector, using either the URL to the
BabelFish Web Service, or the saved BabelFish WSD file. Test (if you have
Internet access).
R e qui r e d Da ta
This section contains data required to complete this exercise. Refer to this data sheet as
necessary while performing the exercise.
Data Value
R e s our ce s
Ti ps & Tr i ck s
• Files saved to the pub directory of a package are automatically hosted on
the built-in IS web server with a URL of
http://server:port/PackageName/filename. <case-sensitive>
2. Create another Web Service connector, using either the URL to the
BabelFish Web Service, or the saved BabelFish WSD file. Save it also in the
exercise folder. Test this Web Service as well.
• For legal values for translation code, there are many language codes such
as en_fr and fr_en, en_it and it_en, en_es and es_en, for two way French-
English, Italian-English, and Spanish-English (try a variety if you know a few
languages). For general information on using the service, see the usage notes on
the BabelFish page on xmethods.net.
• Examples:
20 minutes
Ta s k
The ACME business case uses Trading Networks to manage XML communication with
trading partners. In this exercise, you will:
Use the Profile Assistant to create your own TN local profile (Acme)
Enable your profile
Use the New Partner Profile option to create a partner profile (Acme
Customer)
Enable your partner profile
Since configuring a Trading Networks profile uniquely and permanently identifies it, we
will use the same profile both here and in the business case activities.
R e qui r e d Da ta
This section contains data required to complete this exercise. Refer to this data sheet as
necessary while performing the exercise.
Data Value
R e s our ce s
• Participant Guide: Trading Networks
Ti ps & Tr i ck s
• You must use the Profile Assistant (Tools…Profile Assistant) to create
your own profile.
• Be sure that your External ID type (Corporate tab) has the DUNS type
selected.
• Be sure to use the DUNS numbers listed in the Required Data section for
the profiles
20 minutes
Ta s k
Trading Networks must be configured properly to receive and route order requests from
partners. This configuration is accomplished through TN document types.
R e qui r e d Da ta
This section contains data required to complete this exercise. Refer to this data sheet as
necessary while performing the exercise.
Data Value
ReceiverID: /Test_Order[0]/POHeader[0]/Receiver[0]
ConversationID: /Test_Order[0]/POHeader[0]/@transaction
D106Support.docs:Test_Order
R e s our ce s
• Participant Guide: Trading Networks
Ti ps & Tr i ck s
• Refresh the Transaction Analysis screen in TN Console to find
recently submitted documents.
• Use the Query in the left hand pane to automatically generate XML
queries from your document source
• Example:
Document Type
15 minutes
Ta s k
Enable Audit Logging for exercise3:docInput.
R e qui r e d Da ta
This section contains data required to complete this exercise.
Data Value
R e s our ce s
Ti ps & Tr i ck s
• Remember to create an alias. Use the hostname shown in the
Administrator header.
• Worked Example:
20 minutes
Ta s k
The ACME business process will be deployed to one IS server.
Create a single logical server AND physical server for use in webMethods Modeler.
R e qui r e d Da ta
This section contains data required to complete this exercise.
Data Value
R e s our ce s
Ti ps & Tr i ck s
• Be sure to check the add boxes when adding registered servers to a
resource folder.
Launch Modeler using the Start Menu shortcut and confirm server data
using the View…Server Connections menu