在源文本开头前插入

“在源文本开头前插入”操作会打开指定的源，并在源文本的开头前插入提供的文本或字符。

可以在以下选项卡上为“在源文本开头前插入”操作配置属性。

在开头前插入选项卡

来源

源：指定希望执行操作的数据的来源。
- 嵌入式模板：
  - 值：使用输入框输入想要操作使用的数据。也可以添加变量来指定数据，或者向输入的值添加特殊字符。
  - 导入：打开“打开文件”对话框，浏览到包含所需数据的文件并将其选中。系统会将该文件的内容导入到“值”输入框中。
  - 导出：打开“保存文件”对话框以便将“值”输入框中的内容另存为外部文件。可以将值另存为新文件或替换现有文件的内容。
  - 编辑嵌入的值 :打开“的值”对话框，可以在其中编辑嵌入式源的值。
- 变量：
  - 变量：输入想要为来源使用的变量。也可以单击选择最近使用的变量，或单击“更多变量”打开“插入变量”对话框。
- 外部文件：
  - 位置：指定源文件夹所在的文件系统或位置。文件系统或位置可以是临时存储文件夹、本地文件系统或网络共享、Librarian 或受支持的云存储位置。有关受支持的云存储位置的更多信息，请参阅 Administration Console 的云存储页面。
  - 文件名：指定文件路径。可以输入文件夹位置，或单击“浏览”以找到并选择所需的文件（当“位置”设置为“临时存储”时，“浏览”选项不可用）。也可以添加变量来指定文件，或者向输入的值添加特殊字符。
  - 文件编码：指定源文件使用的编码方案。

选项

Show CR/LF/HT characters:Specifies that carriage return («CR»), line feed («LF»), and horizontal tab («HT») control characters are displayed when you enter them in the Insert box.These characters are otherwise not visible.
插入：指定希望插入的文本或字符。输入所需的内容。也可以“添加变量”以指定要插入的内容，或者向输入的值“添加特殊字符”。
插入文本包含变量：指定包含在插入文本中的所有变量在要插入的文本之前处理。

输出类型

将输出保存到变量:指定想要保存操作输出的变量。输入所需变量。或者，可以添加一个变量。

操作选项卡

操作

名称：指定操作的名称。可以通过在字段中输入新名称来替换默认名称。
描述：指定操作的描述。
运行操作:指定所需的操作运行频率。
- 始终：指定只要发生事件就运行操作。
- 从不：指定发生事件时不运行操作。
- 根据变量，在一定条件下：指定仅当所选变量满足指定条件时，才会运行操作。在仅有一个条件可以确定是否运行操作的情况下才可使用此选项。选择此选项后，就可以在输入框中创建条件语句。
  
  输入框控件
  - 变量：指定希望为条件语句使用的变量。在输入框中输入变量。单击查看最近使用的变量的列表，或单击“更多变量”打开“插入变量”对话框。
  - [关系运算符]：指定用于条件语句的关系运算符。单击现有运算符显示更多运算符的列表，然后单击一个希望使用的运算符。有关更多信息，请参见关系运算符。列表中的可用运算符取决于为“类型”选项选择的是“文本”还是“小数”。
  - 值：指定用于条件语句的值。要添加值，请单击，单击“<输入值>”，输入所需值，然后按 Enter。要删除值，请使用次要鼠标按钮单击该值，然后单击“删除”。一些运算符（如“is blank”和“is not blank”）不需要指定值。在这些情况下，“值”字段不可用。
  - 类型：指定条件语句是对文本值还是小数值求值。
- 根据表达式，在一定条件下：指定操作的运行条件。此选项在需要不只一个条件语句的情况下使用。如果选择此选项，则可通过创建所需条件语句，在输入框中创建条件表达式。可以在“树视图”选项卡中创建和编辑条件表达式。单击“文本视图”选项卡可查看条件表达式的只读文本视图。
  
  输入框控件（“树视图”选项卡）
  - [条件连接符]:指定组中的条件语句的条件连接符。默认条件连接符为 And。
    
    单击现有条件连接符将显示一个菜单，可用于以下面的一种方式配置条件表达式：
    - And、Or、NotAnd、NotOr:在列表中单击希望为条件语句使用的条件连接符。有关受支持的条件连接符的更多信息，请参阅条件连接符。
    - 添加条件:单击可向当前组添加其他条件语句。
    - 添加组：单击可向当前组添加一个条件语句子组。
    - 移除组:单击将删除子组。在从子组打开菜单时可用。
    - 全部清除：单击可删除所有条件语句（包括子组）。在从最上方的组打开菜单时可用。
  - :向与该连接符关联的组中添加条件语句。在表达式中每个条件连接符的右侧可见。
  - :删除该条件语句。指向某个现有条件语句时在该条件语句的右侧可见。
  - 变量：指定希望为条件语句使用的变量。在输入框中输入变量。单击查看最近使用的变量的列表，或单击“更多变量”打开“插入变量”对话框。
  - [关系运算符]：指定用于条件语句的关系运算符。单击现有运算符显示更多运算符的列表，然后单击一个希望使用的运算符。有关更多信息，请参见关系运算符。列表中的可用运算符取决于为“类型”选项选择的是“文本”还是“小数”。
  - 值：指定用于条件语句的值。要添加值，请单击，单击“<输入值>”，输入所需值，然后按 Enter。要删除值，请使用次要鼠标按钮单击该值，然后单击“删除”。一些运算符（如“is blank”和“is not blank”）不需要指定值。在这些情况下，“值”字段不可用。
  - 类型：指定条件语句是对文本值还是小数值求值。

错误处理和诊断

忽略错误并继续运行操作:指定如果操作失败，那么会继续运行其余操作。如果未选中此选项，并且操作失败，那么产生的行为取决于多种因素，如下所示：

操作位于“组”操作中
- 如果在“编组”操作的“执行”选项卡中为“执行操作”属性指定了“按顺序”，则不会运行该“组”操作中的任何进一步操作。此“组”操作外的任何操作都不会受到影响。
- 如果在“编组”操作的“执行”选项卡中为“执行操作”属性指定了“并行”，则系统会忽略错误并运行该“组”操作中的其他操作。此“组”操作外的任何操作都不会受到影响。
操作不位于“组”操作中
- 如果在事件的“执行”选项卡上为“执行动作”属性顺序指定了，则事件内不会再运行其他动作。
- 如果在事件的“执行”选项卡中为“执行操作”属性指定了“并行”，则系统会忽略错误并运行该事件中的其他操作。

失败时重试:指定如果操作失败，那么 BarTender 会尝试再次运行操作。
- 最大重试次数:指定 BarTender 将会再次尝试运行操作的最大次数。选中“失败时重试”选项时可用。
- 重试间隔:指定 BarTender 在操作失败后尝试再次运行操作之前等待的时间长度。选中“失败时重试”选项时可用。