GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  WORKFLOW::ACTION::INPUTFIELD (3)

.ds Aq ’

NAME

Workflow::Action::InputField - Metadata about information required by an Action

CONTENTS

VERSION

This documentation describes version 1.09 of this package

SYNOPSIS



 # Declare the fields needed by your action in the configuration...

 <action name="CreateUser">
    <field name="username"
           is_required="yes"
           source_class="App::Field::ValidUsers" />
    <field name="email"
           is_required="yes" />
    <field name="office"
           source_list="Pittsburgh,Hong Kong,Moscow,Portland" />
 ...



DESCRIPTION

A workflow Action can declare one or more input fields required to do its job. Think of it as a way for the external world (your application) to discover what information an action needs from it. The application can request these fields from the workflow by action name and present them to the user in whatever form appropriate for the application. The sample command-line application shipped with this distribution just cycles through them one at a time and presents a query to the user for data entry.

For instance, in the above declaration there are three fields, ’username’, ’email’ and ’office’. So your application might do:



 my @action_fields = $wf->get_action_fields( CreateUser );
 foreach my $field ( @action_fields ) {
     print "Field ", $field->name, "\n",
           $field->description, "\n",
           "Required? ", $field->is_required, "\n";
     my @enum = $field->get_possible_values;
     if ( scalar @enum ) {
         print "Possible values: \n";
         foreach my $val ( @enum ) {
             print "  $val->{label} ($val->{value})\n";
         }
     }
     print "Input? ";
     my $response = <STDIN>;
     chomp $response;
     $wf->context->param( $field->name => $response );
 }
 $wf->execute_action( CreateUser );



METHODS

    Public Methods

new( \%params )

Typical constructor; will throw exception if ’name’ is not defined or if the property ’source_class’ is defined but the class it specifies is not available.

You will usually not need to use or override this method unless you derive your own input field class (see class in Properties below). For example, suppose you need to add extra properties to all your fields like index, disabled, etc.

In your actions definition XML file, you can just add them and the parser will pick them up. Pay close attention the custom InputField class property.



  <actions>
    <type>foo</type>
    <action name="Bar"
      class="your::action::class">
      <field index="0" name="id" type="integer" disabled="yes"
        is_required="yes" class="your::custom::inputfieldclass"/>
    </action>



But you need to give them life by creating the accessors for these extra properties. Just derive your custom fields class like so:



  package your::custom::inputfieldclass;

  use warnings;
  use strict;

  use base qw( Workflow::Action::InputField );
  use Workflow::Exception qw( workflow_error );

  # extra action class properties
  my @EXTRA_PROPS = qw( index disabled );
  __PACKAGE__->mk_accessors(@EXTRA_PROPS);

  sub new {
    my ( $class, $params ) = @_;
    my $self = $class->SUPER::new($params);
    # set only our extra properties
    foreach my $prop (@EXTRA_PROPS) {
      next if ( $self->$prop );
      $self->$prop( $params->{$prop} );
    }
    warn "INDEX IS NOW WORKING:".$self->index;
    warn "AND SO IS DISABLED:".$self->disabled;
    return $self;
  }

  1;



is_required()

Returns ’yes’ if field is required, ’no’ if optional.

is_optional()

Returns ’yes’ if field is optional, ’no’ if required.

get_possible_values()

Returns list of possible values for this field. Each possible value is represented by a hashref with the keys ’label’ and ’value’ which makes it easy to create dropdown lists in templates and the like.

add_possible_values( @values )

Adds possible values to be used for this field. Each item in @values may be a simple scalar or a hashref with the keys ’label’ and ’value’.

init

Init is a dummy and just returns no special actions are taken

    Properties

<B>nameB> (required)

Name of the field. This is what the action expects as the key in the workflow context.

<B>labelB> (optional)

Label of the field. If not set the value for name is used.

<B>descriptionB> (optional)

What does the field mean? This is not required for operation but it is <B>stronglyB> encouraged so your clients can create front ends to feed you the information without much fuss.

<B>typeB> (optional)

Field types are implementation dependant are they should be intrinsically implemented by validators. In other words, you can use any mnemonic value for your convinience like integer, text, etc. but it won’t affect anything unless you use a validator to validate your action data. By default it is set to ’basic’.

<B>requirementB> (’required’|’optional’)

If field is required, ’required’, otherwise ’optional’.

<B>source_classB> (optional)

If set the field will call ’get_possible_values()’ on the class when the field is instantiated. This should return a list of either simple scalars or a list of hashrefs with ’label’ and ’value’ keys.

<B>source_listB> (optional)

If set the field will use the specified comma-separated values as the possible values for the field. The resulting list returned from get_possible_values() will have the same value for both the ’label’ and ’value’ keys.

<B>classB> (optional)

You may specify a custom InputField class. It should use base qw( Workflow::Action ); and probably override the new() method which should call SUPER::new($params). See new( \%params ) above for an example.

SEE ALSO

Workflow::Action

COPYRIGHT

Copyright (c) 2003-2007 Chris Winters. All rights reserved.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

AUTHORS

Jonas B. Nielsen (jonasbn) <jonasbn@cpan.org> is the current maintainer.

Chris Winters <chris@cwinters.com>, original author.

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 WORKFLOW::ACTION::INPUTFIELD (3) 2016-04-03

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.