[Contents] [Prev] [Next] [Index] [Report an Error] [No Frames]

Before You Begin

Before you assemble a workflow, you must prepare your files and projects:

Start Visual Age for Java (VAJ) and go to the Workbench.
Import the SDX workflow code into the tool's workspace.

In a default installation, the SDX workflow code is located in /opt/UMC/wkf/lib on the workflow host. Import all JAR files contained in that directory.

Create four different projects, one for each group of related classes that you import:

One for classes related to Java Mail (mail.jar, pop3.jar and activation.jar)
One for the Netscape LDAP SDK (ldapjdk.jar), which contains the classes to access the SDX directory via LDAP
One for the XML-related libraries (xalan.jar, xalanj1compat.jar, xerces.jar, dsml.jar)
One for the workflow-specific code (workflow.jar and wf_lib.jar)

Import all the classes, resources, and source files provided with wf_samples.jar into a project separate from the SDX workflow code.
Version each project.
Create another project to hold your new workflows.
In that project, create a package. Do not use the default package for workflows.
Open the Visual Composition Editor (VCE).
Add all of the beans described in Table 58 to the palette in the group of your preference. The VCE palette subsequently displays an icon for each bean, as shown in Figure 38.

Table 58: Work Item Beans

Work Item Name
Work Item Type
Description

AND

Synchronization

Synchronizes all its predecessors. If all the input tokens have a proceed result, it will have a proceed output; otherwise, it will have a not proceed output.

Directory Lookup

Regular

Retrieves an object from a directory given its DN and puts its attributes in the output token.

Directory Modify

Regular

Modifies the directory using entries from an XML document, specified by a configurable token parameter.

Directory Query

Regular

Performs an LDAP search in the directory and returns the result as an XML document that is output to a configurable token parameter.

Directory Update

Regular

Updates an object in a directory given its DN, using the attribute values from the input token.

End State

Final state of every workflow.

External Program

Regular

Creates an external program (process) and waits for its completion.

Filter/Pass

Token processor

Filters or lets pass a set of properties from the token.

HTTP

Regular

Performs an HTTP or HTTPS request. The specified URL can be static or dynamically composed by token parameters. The returned data (page) is put in the output token as a parameter.

Lazy Logger

Regular

Sample work item that performs the same task as the Logger work item but takes longer, to demonstrate the functioning of the persistence subsystem and other time-dependent features.

Logger

Regular

Sample work item that prints to the standard output the values of the Name and Address properties of the input token.

MIME Form Encoder

Token processor

Encodes a form in a token parameter using the MIME formats multipart/form-data or application/x-url-encoded.

Synchronization

Synchronizes all its predecessors. If at least one input token has a proceed result, it will have a proceed output; otherwise, it will have a not proceed output.

Receive E-mail

Regular

Receives an e-mail through the e-mail adapter. The adapter should point to a valid mailbox in a POP3 or IMAP server.

Script

Regular

Embeds scripts written in Python. Scripts can be both directly entered or referenced trough a filename.

Send E-mail

Regular

Sends an e-mail through an SMTP server.

Start State

Initial state of every workflow.

Status Logger

Regular

Logs a free-form message in the workflowStatus attribute of a transactional object. The message is appended to the current content together with a new line character that serves as a separator.

Token Logger

Token processor

Dumps the token to the console or a file. Useful for debugging.

Token Value Assigner

Token processor

Enables you to assign values to token parameters, whose names and values are specified in the indexed property Assignments. Values can be taken from a token parameter, statically configured, or both.

Token Value Checker

Token processor

Checks whether the specified token parameters have the given values.

XML Decoder

Regular

Interprets an XML document and put the information in the output token.

XML Encoder

Regular

Creates an XML document and puts it in the output token. The document is generated by substituting parameters from the incoming token in special tags in a template XML document.

Work Item Name	Work Item Type	Description
AND	Synchronization	Synchronizes all its predecessors. If all the input tokens have a proceed result, it will have a proceed output; otherwise, it will have a not proceed output.
Directory Lookup	Regular	Retrieves an object from a directory given its DN and puts its attributes in the output token.
Directory Modify	Regular	Modifies the directory using entries from an XML document, specified by a configurable token parameter.
Directory Query	Regular	Performs an LDAP search in the directory and returns the result as an XML document that is output to a configurable token parameter.
Directory Update	Regular	Updates an object in a directory given its DN, using the attribute values from the input token.
End State	End State	Final state of every workflow.
External Program	Regular	Creates an external program (process) and waits for its completion.
Filter/Pass	Token processor	Filters or lets pass a set of properties from the token.
HTTP	Regular	Performs an HTTP or HTTPS request. The specified URL can be static or dynamically composed by token parameters. The returned data (page) is put in the output token as a parameter.
Lazy Logger	Regular	Sample work item that performs the same task as the Logger work item but takes longer, to demonstrate the functioning of the persistence subsystem and other time-dependent features.
Logger	Regular	Sample work item that prints to the standard output the values of the Name and Address properties of the input token.
MIME Form Encoder	Token processor	Encodes a form in a token parameter using the MIME formats multipart/form-data or application/x-url-encoded.
OR	Synchronization	Synchronizes all its predecessors. If at least one input token has a proceed result, it will have a proceed output; otherwise, it will have a not proceed output.
Receive E-mail	Regular	Receives an e-mail through the e-mail adapter. The adapter should point to a valid mailbox in a POP3 or IMAP server.
Script	Regular	Embeds scripts written in Python. Scripts can be both directly entered or referenced trough a filename.
Send E-mail	Regular	Sends an e-mail through an SMTP server.
Start State	Start State	Initial state of every workflow.
Status Logger	Regular	Logs a free-form message in the workflowStatus attribute of a transactional object. The message is appended to the current content together with a new line character that serves as a separator.
Token Logger	Token processor	Dumps the token to the console or a file. Useful for debugging.
Token Value Assigner	Token processor	Enables you to assign values to token parameters, whose names and values are specified in the indexed property Assignments. Values can be taken from a token parameter, statically configured, or both.
Token Value Checker	Token processor	Checks whether the specified token parameters have the given values.
XML Decoder	Regular	Interprets an XML document and put the information in the output token.
XML Encoder	Regular	Creates an XML document and puts it in the output token. The document is generated by substituting parameters from the incoming token in special tags in a template XML document.

Figure 38: Sample Work Item Palette (from the VCE After Adding the Work Items to the Workflow Group)

[Contents] [Prev] [Next] [Index] [Report an Error] [No Frames]