获取文件名
组件介绍
“获取文件名”组件可以获取当前选择文件的路径，文件名，文件属性等相关信息。同时该组件也可以获取当前选择的目录下所有文件的路径，文件名，文件属性等相关信息。
- 输入：需要读取信息的文件或目录
- 输出：读取的所有文件信息数据
页面介绍
文件标签
打开“获取文件名”组件得到文件标签的界面。
参数选项
“获取文件名”组件的文件标签页面包含如下选项：
| 选项 | 说明 | 样例值 |
|---|---|---|
| 步骤名称 | 在画布上指定“获取文件名”步骤的唯一名称，可以自定义名称或保留默认名称。 | 获取文件名 |
| 文件或目录 | 指定文件或者目录的名称，或通过单击“浏览文件”导航到输入文件。 | |
| 正则表达式 | 在上一个选项中指定的目录中指定要用于选择文件的正则表达式。例如，您要处理所有扩展名为 .txt的文件。 | |
| 正则表达式(排除) | 排除满足此正则表达式指定的条件的所有文件（在给定位置）。 |
字段表
组件底部表格为字段表，在配置好参数后，点击“增加”按钮即可根据上述配置信息自动填充字段表。该表包含以下列：
| 列名 | 说明 | 样例值 |
|---|---|---|
| 文件/目录 | 文件或者目录的名称 | |
| 通配符号 | 与参数中的正则表达式部分相同 | |
| 通配符号(排除) | 与参数中的正则表达式(排除)部分相同 | |
| 要求 | 是否必须 | |
| 包含子目录 | 是否匹配子目录 |
过滤标签
过滤标签的页面如下。
参数选项
“获取文件名”组件的过滤标签页面包含如下选项：
| 选项 | 说明 | 样例值 |
|---|---|---|
| 获取 | 当前参数有三个选项。all_files：读取所有的文件和目录 only_files：读取所有的文件 only_folders：读取所有的目录 | |
| 在输出中包括行号 | 选择是否需要增加一个字段(整型)，用来保存行号 | |
| 行号字段名 | 为增加的字段命名 | |
| 当没有文件或目录时不报错 | 勾选则启用 | |
| 限制 | 默认值为0，即不对结果数量做任何限制 |
若设置的值为N，则表示输出结果数量被限制为N-1条。其中N>1 若设置的值为1，则输出一条结果 | | | 将文件名添加到结果文件中 | 将文件名添加到结果文件列表中，以便后续使用，如作为邮件附件 | |
使用案例
拖拽“获取文件名”组件至画布中，双击组件，点击“浏览”，选择需要获取信息的文件或者目录，这里我们使用了个人文件库中的 tmpdir 目录作为案例。 文件库中目录结构如下：
选择成功后，点击“增加”按钮，此时字段表中会被填充相关信息。参数设置和结果如下图所示：
点击“确定”，再点击左上角“运行这个转换”，组件右上角将出现绿色正确符号，表示转换执行成功，右击该组件选择“预览数据”，得到结果如下图所示，表格中的数据就是 tmpdir 目录下的文件信息。
