MAN page from OpenSuSE perl-OpenXPKI-Core-0.9.1389-6.362.CS.i586.rpm

OpenXPKI::Server::Workflow::Activity::Tools::ForkWorkflowInstance

Section: User Contributed Perl Documentation (3)
Updated: 2008-09-30
Index

Name

Description

This class creates a new instance of a workflow from with a parent workflow.The child workflow is running independent and asynchronously from theparent. This is useful if you want to start a (potentially) long-runningworkflow. You can always see what state it is in by looking at yourcontext parameters wf_child_instance_type and _id and retrieving theworkflow info using the Server Workflow API. As with CreateWorkflowInstance,the type is specified in the activity parameter workflow_type.

Example:
  <action name=``I18N_OPENXPKI_WF_ACTION_SPAWN_CERT_ISSUANCE''         class=``OpenXPKI::Server::Workflow::Activity::Tools::ForkWorkfowInstance''
         workflow_type=``I18N_OPENXPKI_WF_TYPE_CERTIFICATE_ISSUANCE''>

  </action>

Alternatively, this activity may be creatively used in anotheractivity class, for example when you want to fork severalworkflow instances. This requires that you pass on the workflowtype and the parameters as parameters to the execute method.

Example:

my $fork_wf_instance = OpenXPKI::Server::Workflow::Activity::Tools->new();$fork_wf_instance->execute(
    $workflow,
    'I18N_OPENXPKI_WF_TYPE_CERTIFICATE_ISSUANCE',
    $params);

When creating a new forked workflow, the activity adds an entry ina shared memory segment indexed using the parent PID. This allowsto figure out which children are still running.

This document was created byman2html,using the manual pages.