读取文件 |
“读取文件”操作在指定文件夹中查找定义的文件类型,然后读取该文件中包含的数据,再将这些数据保存到变量。
可以在以下选项卡上配置“读取文件”操作的属性。
来源
位置:指定源文件夹所在的文件系统。文件系统或位置可包含本地文件系统或网络共享、Librarian 或受支持的云存储位置。有关受支持的云存储位置的更多信息,请参阅 Administration Console 的
文件名: 指定操作从中进行读取的文件。可以输入文件夹位置和文件名,或单击“浏览”以找到并选中所需文件。也可以通过添加变量来指定所需文件,或者向输入的值添加特殊字符。
|
如果在“文件检测”下单击以选中“等待文件到达”复选框(如下所示),那么“文件名”选项会更改为“要扫描的文件夹”选项。 |
要扫描的文件夹: 指定希望操作在其中查找文件的文件夹位置。您可以输入文件夹位置或单击“浏览”找到并选择所需的文件夹。也可以“添加变量”以指定要扫描的文件夹,或者向输入的值“添加特殊字符”。 在单击以选中“文件检测”下的“等待文件到达”复选框时可用。
扫描子文件夹: 指定操作还会监控“要扫描的文件夹”属性指定的文件夹的所有子文件夹。
文件编码: 指定用于编码正在读取的文件的方法。
文件内容格式: 指定数据内容类型。操作将根据此格式处理文件的内容。
数据包含在 SOAP 消息中: 指定操作会查找要包含在 SOAP 消息中的数据。
已锁定的文件超时: 指定尝试打开最初发现为其他应用程序锁定的文件的时间。
文件检测
等待文件到达: 指定如果文件夹中尚不存在该文件,则操作会等待该文件到达。
|
仅当单击以选中了“等待文件到达”复选框之后,才会提供文件检测选项。 |
检测选项
扫描方法: 指定操作用于在扫描文件夹中监控指定文件是否已到达的方法。
通知和轮询: 指定操作将连续监控扫描文件夹,并且还会按设定的时间间隔扫描文件夹。如果您对文件系统的可靠性有担忧,那么此选项很有用。如果连续扫描时错过某个事件,那么轮询扫描将会确保检测到该事件。选中此选项后,可以以毫秒、秒、分钟或小时为单位指定轮询间隔。
仅通知: 指定操作将连续监控扫描文件夹。
仅轮询: 指定操作会按设定的时间间隔对扫描文件夹进行扫描。选中此选项后,可以以毫秒、秒、分钟或小时为单位指定轮询间隔。
轮询间隔: 指定操作扫描文件的频率。指定操作扫描文件的频率。为“扫描方法”选中“通知和轮询”或“仅轮询”时可用。
文件样式:指定该操作用于标识要在其上运行该操作的文件的筛选器。此筛选器可以包含通配符(例如 ? 和 *)或正则表达式(例如 (?i)^.*\.csv$)。单击 可查看受支持的正则表达式或通配符修改器的列表,然后单击修改器以添加。您还可以添加变量以指定文件样式,或者向输入的值添加特殊字符。
使用正则表达式:指定操作使用正则表达式来标识文件样式。当您选择此选项时,可以向先前的属性添加正则表达式修改器,以便对搜索条件进行更多的控制。
最小文件大小:指定文件要被操作接受为源文件而不得低于的文件大小。
最大文件大小:指定文件要被操作接受为源文件而不得超过的文件大小。
文件空闲时间: 指定位于指定文件夹中的文件可以处于空闲状态而仍被操作接受为源文件的最长时间。最长空闲时间可以以毫秒、秒、分钟或小时为单位进行指定,并且将会与文件的“上次修改时间”属性进行比较。
多个文件排序顺序
定义在多个文件符合所指示文件样式时,操作处理所指定文件夹中的文件的顺序。如果在属性页中未指定任何排序顺序,那么排序过程默认为按创建时间(升序)排序,然后按文件名(升序)排序。最多可以指定四个排序条件。
顺序: 指定排序条件应用到指定文件夹中匹配文件的顺序。
排序字段: 指定应用到匹配文件的条件。
方向: 指定将排序字段条件应用到匹配文件时,使用升序还是降序。
添加排序条件: 指定更多排序条件。
输出类型
将文件内容保存到变量: 指定希望保存文件内容的变量。在输入框中输入变量。或者,可以添加一个变量。
Action
名称: 指定操作的名称。可以通过在字段中输入新名称来替换默认名称。
描述: 指定操作的描述。
运行操作: 指定所需的操作运行频率。
始终: 指定只要发生事件就运行操作。
从不: 指定发生事件时不运行操作。
根据变量,在一定条件下: 指定仅当所选变量满足指定条件时,才会运行操作。在仅有一个条件可以确定是否运行操作的情况下才可使用此选项。选择此选项后,就可以在输入框中创建条件语句。
变量: 指定希望为条件语句使用的变量。在输入框中输入变量。单击 查看最近使用的变量的列表,或单击“更多变量”打开“插入变量”对话框。
[关系运算符]: 指定用于条件语句的关系运算符。单击现有运算符显示更多运算符的列表,然后单击一个希望使用的运算符。有关更多信息,请参见关系运算符。列表中的可用运算符取决于为“类型”选项选择的是“文本”还是“小数”。
值: 指定用于条件语句的值。要添加值,请单击 ,单击“<输入值>”,输入所需值,然后按
Enter
。要删除值,请使用次要鼠标按钮单击该值,然后单击“删除”。一些运算符(如“is blank”和“is not blank”)不需要指定值。在这些情况下,“值”字段不可用。
类型: 指定条件语句是对文本值还是小数值求值。
根据表达式,在一定条件下: 指定操作的运行条件。此选项在需要不只一个条件语句的情况下使用。如果选择此选项,则可通过创建所需条件语句,在输入框中创建条件表达式。可以在“树视图”选项卡中创建和编辑条件表达式。单击“文本视图”选项卡可查看条件表达式的只读文本视图。
[条件连接符]: 指定组中的条件语句的条件连接符。默认条件连接符为 And。
单击现有条件连接符将显示一个菜单,可用于以下面的一种方式配置条件表达式:
And、Or、NotAnd、NotOr: 在列表中单击希望为条件语句使用的条件连接符。有关受支持的条件连接符的更多信息,请参阅条件连接符。
添加条件: 单击可向当前组添加其他条件语句。
添加组: 单击可向当前组添加一个条件语句子组。
移除组: 单击将删除子组。在从子组打开菜单时可用。
全部清除: 单击可删除所有条件语句(包括子组)。在从最上方的组打开菜单时可用。
: 向与该连接符关联的组中添加条件语句。在表达式中每个条件连接符的右侧可见。
: 删除该条件语句。 指向某个现有条件语句时在该条件语句的右侧可见。
变量: 指定希望为条件语句使用的变量。在输入框中输入变量。单击 查看最近使用的变量的列表,或单击“更多变量”打开“插入变量”对话框。
[关系运算符]: 指定用于条件语句的关系运算符。单击现有运算符显示更多运算符的列表,然后单击一个希望使用的运算符。有关更多信息,请参见关系运算符。列表中的可用运算符取决于为“类型”选项选择的是“文本”还是“小数”。
值: 指定用于条件语句的值。要添加值,请单击 ,单击“<输入值>”,输入所需值,然后按
Enter
。要删除值,请使用次要鼠标按钮单击该值,然后单击“删除”。一些运算符(如“is blank”和“is not blank”)不需要指定值。在这些情况下,“值”字段不可用。
类型: 指定条件语句是对文本值还是小数值求值。
错误处理和诊断
忽略错误并继续运行操作: 指定如果操作失败,那么会继续运行其余操作。如果未选中此选项,并且操作失败,那么产生的行为取决于多种因素,如下所示:
失败时重试: 指定如果操作失败,那么 BarTender 会尝试再次运行操作。
最大重试次数: 指定 BarTender 将会再次尝试运行操作的最大次数。选中“失败时重试”选项时可用。
重试间隔: 指定 BarTender 在操作失败后尝试再次运行操作之前等待的时间长度。选中“失败时重试”选项时可用。