<action-sequence> <name> <version> <title> <loggin-level> <documentation> <author> <description> <help> <result-type> <icon> <inputs> <param-name type="data-type"> <default-value> <sources> <outputs> <param-name type="data-type" > <logging-level> <resources> <resource-name > <resource-type> <location> <mime-type> <*actions [loop-on="parameter-name"] > <actions [loop-on="parameter-name"] > <action-definition> <action-inputs> <input-name type="data-type" mapping="param"> <action-outputs> <output-name type="data-type" > <component-name> <component-definition>
标记为 REQUIRED 的 XML 节点仅当使用了他们的父节点时,才是必需的。方括号[ ]中的属性是可选的。 <action-sequence> REQUIRED - Action Sequence 文档的最上层节点。 <name> REQUIRED – Action Sequence 的名字,它必须匹配文档的文件名。 <version> NOT USED – 这个文档的版本。 <title> NOT REQUIRED – 文档的用户友好的名字。仅用于显示。 <logging-level> NOT REQUIRED – 为整个 Action Sequence 设置日志级别。有效值有:TRACE,DEBUG,INFO,WARN,ERROR 和 FATAL。如果没有设置日志级别,使用 ERROR。 <documentation> NOT REQUIRED – 包含用于产生文档的描述性节点。 <author> - NOT REQUIRED – 这个 Action Sequence 的作者。 <description> - NOT REQUIRED – Action Sequence 的简短 (1-3 行) 描述。Solution 浏览组件使用这个描述来生成它的显示。 <help> - NOT REQUIRED – Action Sequence 的长描述,包含一个最终用户需要使用的指令。 <result-type> - NOT REQUIRED – 这个 Action Sequence 将产生的输出的类型。Solution 浏览组件使用它来生成它的显示。浏览组件不显示没有 result-type 的 Action Sequences。有效值是:Report,Process,Rule,View 和 None。 <icon> - NOT REQUIRED – 浏览组件用于生成它用于显示的小图。图像的路径相对于ActionSequence 文档位于的目录。例如:Example1_image.png。 <inputs> - NOT REQUIRED – 输入参数的集合。 < param-name type=” data-type” > - NOT REQUIRED – param-name 是 Action Sequence 期望在运行时可用的一个参数的名字。type 属性指定了这个参数的数据类型。有效数据类型请参考下面的附录。 <default-value> - NOT REQUIRED – 允许输入参数指定一个默认值,如果还没有提供一个值的话。如果有 default-value 节点,但没有指定的值,如果可能,用户将被提示输入值。 <sources> - NOT REQUIRED – 参数 providers 的列表,按照他们被查询获得一个参数的顺序。有效值是 request,session 和 runtime。 注意:如果设置了一个 param-name,但没有指定 default-value 和sources,那么会出现一个 validation 错误。 <outputs> - NOT REQUIRED – 输出参数的集合。 < param-name type=” data-type” > - NOT REQUIRED – param-name 是 Action Sequence 期望的一个参数的名字,它将在所有 action 定义执行完时被设置。type 属性指定了这个参数的数据类型。有效数据类型请参考下面的附录。 <logging-level> NOT REQUIRED – 在 action 定义的执行期间,设置日志级别。有效值是:TRACE,DEBUG,INFO,WARN,ERROR 和 FATAL。如果没有设置日志级别,使用 ERROR。 <resources> - NOT REQUIRED – resource 参数的集合。 < resource-name > - NOT REQUIRED – resource-name 是 Action Sequence 期望使用的一个 resource 的名字。type 属性指定了这个参数的数据类型。有效数据类型请参考下面的附录。 < resource-type> - REQUIRED – 必需的 resource 的类型名。有效值是:solution-file,file 和 url。 <location> - REQUIRED – resource 的路径。对于一个类型为 solution-file 的 resource,location 是一个相对于当前 solution 的顶层的路径名。如果 resource-type 是 file,那么 location 被假定是一个完全有效的路径。对于 url 的 resource-type,location 假定是一个完全有效的URL。 <mime-type> - NOT REQUIRED – 为 resource 的 mime 类型提供一个提示。 <actions [loop-on=” parameter-name”] > - REQUIRED – actions 节点包含 actiondefinition 节点和可选的更多 actions 节点。 loop-on 属性是可选的。当使用它时,actions 内的节点将执行多次。有必要指定一个类型为 list 的参数(string-list 或 propertymap- list),对于 list 中的每个元素,一组节点将被执行一次。一个输入参数将被产生,其和 loop-on 属性同名,但是它将有 list 中一个元素的值。例如:如果一个名为 department 的 loop-on 属性是一个有 department names 的 string-list,那么一个名为 department 的参数将可用,并在每次迭代时,被设置成一个不同的 department name。 <actions [loop-on=” parameter-name”] > - NOT REQUIRED – 因为一个单一层次的 looping 不很有趣,actions 节点可在 actions 节点内被嵌套多次 – 不管看起来多么可笑。 <action-definition> - REQUIRED (至少1个) – 它定义了为了执行一个任务,对一个组件的完整调用。 <action-inputs> - NOT REQUIRED – action-input 参数的集合。 < input-name type=” data-type” mapping= ”param”> - NOT REQUIRED – input-name 是 Action Definition 期望在运行时可用的一个参数的名字。type 属性指定了这个参数的数据类型。有效数据类型请参考下面的附录。mapping 属性允许这个输入被映射到一个 Action Sequence 输入或一个早先的不同名的 action-definition 输出。 <action-outputs> - NOT REQUIRED – action-output 参数的集合。 < output-name type=” data-type” > - NOT REQUIRED – 输出名是一个参数的名字,这个参数是组件在完成执行时,已经设置的。type 属性指定了这个参数的数据类型。有效数据类型请参考下面的附录。 <component-name> - REQUIRED – 要执行的组件的 java 类的 fully qualified name。 <component-definition> - REQUIRED – 组件特定的 XML 定义。特定组件的更多信息请参考文档。这个节点可能为空,但是它必须存在,否则的话,会出现一个 validation 错误。
- 一个hellworld.xacktion的访问地址:
- 利用System Action控制数据存取:http://wiki.pentaho.org/display/PentahoDoc/Using+System+Actions+to+Control+Data+Access
Action Sequences的设计指南:http://wiki.pentaho.org/display/PentahoDoc/03.+Action+Sequences
Action Sequences的设计工具:Design Studio