基本语法

变量名称

在最简单的形式中,变量如下指定:

[Group.Variable]

变量名称括在方括号中。变量指定中不允许出现空格。

变量名称包含两个片段,以英文句号隔开。第一个片段为组名称;第二个片段为该组中变量名称。

参数

某些变量可能包含有助于确定变量动态值的参数。参数如下指定:

[Group.Variable:ArgumentName1="Value",ArgumentName2="Value"]

在本示例中,两个参数通过名称"ArgumentName1"和"ArgumentName2"定义。若变量有参数,则变量名称后面为冒号,冒号后面为参数。对于每一个参数,变量名称后面为等号和加单引号或双引号的参数值。若参数值加双引号,则参数值可包含单引号,或,若参数值加单引号,则参数值可包含双引号。若有多个参数,则以逗号隔开。变量指定中不得包含任何空格,除非加引号的参数值中需要使用空格。

嵌套变量

[Switch.Calculation]变量的 Expression 参数和数据库变量的 SQL 参数可能包含嵌套变量。这些变量用于定义参数值。

[Group.Variable:ArgumentName1="[Variable1]"]

嵌套变量与常规变量采用相同的语法,并且始终括在方括号内。

某些示例:
  • [Switch.Calculation:Expression="[Job.Size]"]
  • [Database.TextIndexed:SQL="SELECT JobName FROM Jobs",Connection="DBConnection",Separator=", "]
  • [Database.Text:SQL="SELECT JobName FROM Files WHERE FileName='[Job.Name]'",Connection="DBConnection"]
注: 嵌套变量不允许用在其他参数类型中。若使用,则忽略嵌套变量,并作为常规文本处理。

嵌套可以是多层的,也就是说,嵌套变量可以包含其他嵌套变量。

例如:
  • [Database.Text:SQL="SELECT PublisherName FROM Jobs WHERE JobName='[Database.Text:SQL="SELECT JobName FROM Files WHERE FileName='[Job.Name]'",Connection="DBConnection"]'",Connection="DBConnection"]

    (其中嵌套变量 [Job.Name] 包含在变量 [Database.Text:SQL="SELECT JobName FROM Files WHERE FileName='[Job.Name]'",Connection="DBConnection"] 中)

注: 若用于支持嵌套变量的参数,则 Switch 会将左方括号"["解读为新变量的开始。如将方括号用作静态文本,应使用双左方括号:"[["。请注意,无需使用双右方括号。
例如:
  • 若存在变量[Database.Text:SQL="SELECT [[JobName] FROM Files WHERE FileName='[Job.Name]'",Connection="DBConnection"]
  • 对于名称为 TestFile.pdf 的作业,将执行 SQL 请求 SELECT [JobName] FROM Files WHERE FileName='TestFile.pdf'。

另请参阅: