Wiki Markup |
---|
{scrollbar} This is not actually a schema, but it does explain the Action Sequence XML and node requirements. XML Nodes marked as {color:#ff0000}REQUIRED{color} are only required if their parent node is being used. Attributes shown in square brackets \[PentahoDoc: \] are optional. * <*action-sequence*> {color:#ff0000}REQUIRED{color} \- Top level node for the Action Sequence Document ** <*name*> NOT REQUIRED - The name of the Action Sequence, it must match the file name of the document. ** <*version*> NOT USED - The version of this document ** <*title*> NOT REQUIRED - Friendly name of the document. Used for display only ** <*logging-level*> NOT REQUIRED - Sets the logging level for the entire Action Sequence. Valid values are: TRACE, DEBUG, INFO, WARN, ERROR and FATAL. If no logging level is set, ERROR will be used. ** <*documentation*> NOT REQUIRED - Contains descriptive nodes used for generating documentation. *** <*author*> - NOT REQUIRED - The author of this Action Sequence *** <*description*> - NOT REQUIRED - Short (1-3 lines) description of the Action Sequence. This description is used by the solution navigation component to generate its display. *** <*help*> - NOT REQUIRED - Long Description of the Action Sequence including instructions for it's use by an end user. *** <*result-type*> - NOT REQUIRED - Type of output this Action Sequence will generate. It is used by the solution navigation component to generate its display. Action Sequences without a result-type will not be displayed by the navigation component. Valid values are: Report, Process, Rule, View and None. *** <*icon*> - NOT REQUIRED - Thumbnail image that the navigation component will use for generating its display. The path to the image is relative to the directory that the ActionSequence document is in. For example: Example1_image.png ** <*inputs*> - NOT REQUIRED - Collection of input parameters. *** <_param-name_ *type*="_data-type_" > - NOT REQUIRED - _param-name{_}is the name of a parameter that the Action Sequence is expecting to be available at run time. The type attribute specifies the data type of this parameter. See below for valid data types. **** <*default-value*> - NOT REQUIRED - Allows the input parameter to specify a default value if a value has not been supplied. If the default-value node is present but has no value specified, the user will be prompted for the value if possible. **** <*sources*> - NOT REQUIRED - list of parameter providers in the order they should be queried to obtain a parameter. Valid values are request, session and runtime. Note: if a param-name is set but default-value and sources are both not specified, a validation error will occur. ***** *<request>* \- NOT REQUIRED \- Name of the request parameter that is to provide its value to this input ***** *<session>* \- NOT REQUIRED - Name of the session variable that is to provide its value to this input. ***** *<runtime>* \- NOT REQUIRED - Name of the runtime variable that is to provide its value to this input. ** <*outputs*> - NOT REQUIRED - Collection of output parameters. *** <_param-name_ *type*="_data-type_" > - NOT REQUIRED - _param-name{_}is the name of a parameter that the Action Sequence is expecting will be set by the time all action-definitions have executed. The type attribute specifies the data type of this parameter. See below for valid data types. ** <*resources*> - NOT REQUIRED - Collection of resource parameters. *** <_resource-name_ > - NOT REQUIRED - _resource-name{_}is the name of a resource that the Action Sequence is expecting to use. The type attribute specifies the data type of this parameter. See below for valid data types. **** <_resource-type_> - {color:#ff0000}REQUIRED{color} \- The name of the type of resource required. Valid values are: solution-file, file and url. ***** <*location*> - {color:#ff0000}REQUIRED{color} \- The path to the resource. For a resource-type of "solution-file", the location is a pathname relative to the top level of the current solution. If the resource-type is "file" then the location is assumed to be the a fully qualified path. For resource-type of "url" the location is assumed to be a fully qualified URL. ***** <*mime-type*> - NOT REQUIRED - Gives a hint about the mime type of the resource. ** <*actions loop-on="*{*}{_}parameter-name{_}{*}*" > -* {color:#ff0000}{*}REQUIRED{*}{color} *\-* The actions node contains "action-definition" nodes and optionally more "actions" nodes. The loop-on attribute is optional. When it is used, the nodes within "actions" will be executed multiple times. It is necessary to specify a parameter that is of type list (string-list or property-map-list) and the group of nodes that will be executed once for each element in the list. An input parameter will be generated with the same name as the loop-on attribute but it will have the value of one element in the list. For example: if a loop-on attribute named "department" is a string-list with department names, then a parameter named department will be available and be set to a different department name for each iteration. *** *<condition>* \- NOT REQUIRED - If a condition child element is present, its parent action will be executed only when the javascript expression text inside the condition element evaluates to true. *** <*actions loop-on="*{*}{_}parameter-name{_}{*}*"*> - NOT REQUIRED - Since a single level of looping is not very fun, actions nodes can be nested within actions nodes to any level desired - no matter how silly it may be to do so. *** <*action-definition*> - REQUIRED (At least 1) - It defines one complete call to a component for execution of a task. **** <*action-inputs*> - NOT REQUIRED - Collection of action-input parameters. ***** <_input-name_ *type*="_data-type_" *mapping*=_"param"_> - NOT REQUIRED - _input-name_ is the name of a parameter that the Action Definition is expecting to be available at run time. The *type* attribute specifies the data type of this parameter. See [3 - Data Types|3 - Data Types] for valid data types. The *mapping* attribute allows this input to be mapped to an Action Sequence input or a previous action-definition output with a different name. **** <*action-outputs*> - NOT REQUIRED - Collection of action-output parameters. ***** <_output-name_ *type*="_data-type_" > - NOT REQUIRED - _output-name{_}is the name of a parameter that the Component will have set by the time it finishes executing. The type attribute specifies the data type of this parameter. See below for valid data types. **** <*component-name*> - {color:#ff0000}REQUIRED{color} \- The name of the java class that executes the action definition. **** <component*<action-type>* \- NOT REQUIRED The human readable friendly name for this action-definition **** <*component-definition*> - {color:#ff0000}REQUIRED{color} \- The component specific XML definition. See the documentation for the specific component for more information. This node may be empty but it must exist or a validation error will occur. {note:title=TODO}\* Verify this is up to date * Add output destinations * Add resource types xml and string * come up with a better way to display this - table maybe? * Link to download the "real" xml schema{scrollbar} |
Page Comparison
General
Content
Integrations