workflow::fsm::new_from_spec (public)

 workflow::fsm::new_from_spec [ -package_key package_key ] \
    [ -object_id object_id ] -spec spec [ -array array ] \
    [ -workflow_handler workflow_handler ] [ -handlers handlers ]

Defined in packages/workflow/tcl/workflow-procs.tcl

Create a new workflow from spec. Workflows must belong to either a package key or an object id.

Switches:

-package_key (optional)

A package to which this workflow belongs

-object_id (optional)

The id of an ACS Object indicating the scope the workflow. Typically this will be the id of a package type or a package instance but it could also be some other type of ACS object within a package, for example the id of a bug in the Bug Tracker application.

-spec (required)

The workflow spec

-array (optional)

The name of an array in the caller's namespace. Values in this array will override workflow attributes of the workflow being cloned.

-workflow_handler (optional)

-handlers (optional)

Returns:

The ID of the workflow created

Author:

Lars Pind <lars@collaboraid.biz>

See Also:

• workflow::new

Partial Call Graph (max 5 caller/called nodes):

Testcases:

No testcase defined.

Source code:

    if { $array ne "" } {
        upvar 1 $array row
        set array row
    }
    return [workflow::new_from_spec  -package_key $package_key  -object_id $object_id  -spec $spec  -array $array  -workflow_handler "workflow::fsm"  -handlers {
                    roles workflow::role
                    actions workflow::action
                    states workflow::state::fsm
                    actions workflow::action::fsm
                }]

Generic XQL file:

packages/workflow/tcl/workflow-procs.xql

PostgreSQL XQL file:

packages/workflow/tcl/workflow-procs-postgresql.xql

Oracle XQL file:

packages/workflow/tcl/workflow-procs-oracle.xql