November 19, 2009

Did You Know: Creating Custom Toolbox Activities

Custom Toolboxes Activities

The “Creating Toolbox Activities” tutorial discussed how to create a new toolbox activity. It is possible to create multiple toolbox activities simultaneously and to extend the existing toolboxes rather than creating new ones.

Creating Multiple Activities

To create multiple toolbox activities at once:

Open all the workflows that will be converted to activities.
Click the Toolbox Activity button on the Deploy tab.
All open workflows are automatically added.
Enter the desired Toolbox Name.
Make sure the “Install in Toolbox…” checkbox is checked
Click the Build button.

Extending Existing Toolboxes

To extend an existing toolbox with custom activities:

Open the workflow or workflows to be added.
On the Deploy tab, click the Toolbox Activity button
For the Toolbox Name, specify the EXACT toolbox name of an existing toolbox

2 years ago - link

Comments (View)

November 18, 2009

@ihunger

Tutorial: Creating Toolbox Activities

One of the unique features of PowerWF is the ability for users to extend it by adding their own toolbox activities. This tutorial will create a workflow that uses SAPI to speak whatever text is passed to it. This workflow will then be converted into a toolbox activity which can be dropped into other workflows

Topics Discussed

Naming Activities
Combining PowerShell and COM
Using Input Parameters
Creating Toolbox activities
Using custom toolbox activities
Using the ExecScript activity.
Using the FormatString activity.
Using the ForEach activity.
Using the GetProperty activity.

Procedure

Create a new workflow project called “speakToMe”
This workflow will utilize the Speech API (SAPI) by using the ExecScript activity from the PowerShell V2 toolbox. Drop an ExecScript activity onto the canvas and set the script to:
$sapi = new-object -com SAPI.SpVoice

This command creates the SAPI object for later use.
To make the workflow more readable, set the Name of ExecScript1 to “Create SAPI”
Drop a second ExecScript activity onto the canvas and set the script to:

$sapi.speak(“I hunger”);$sapi.waitUntilDone(10000);

The speak command tells the speech API to say, “I Hunger”. To work properly, the speech API requires that an option be set to wait until the Speak activity is done before proceeding, unless it takes longer than 10 seconds.
For readability, set the Name of ExecScript2 to “SayWords”
Although PowerWF scripts will run in their own run-space and clean up automatically on shutdown, one more ExecScript activity can be added to clean up the SAPI object. Drop another ExecScript activity on the canvas and set the script to:

$sapi = $null

Set the name of the ExecScript to “CleanupSAPI”