机器人请求文件
在交互过程中提示用户提供特定文件。
命令可用性: 本地 IBM RPA SaaS 和 IBM RPA
脚本语法
IBM RPA 的专有脚本语言的语法与其他编程语言类似。 该脚本语法在脚本文件中定义命令的语法。 您可以在 IBM RPA Studio的 脚本 方式下使用此语法。
chatAskFile [--fileextensions(String)] [--retry(Boolean)] [--attempts(Numeric)] [--retrytext(String)] [--timeoutsub(String)] [--language(Language)] --text(String) [--textformat(String)] [--timeout(TimeSpan)] (String)=value (String)=utterance (Boolean)=timedout (Boolean)=success (String)=botHistoryMessageId
输入参数
下表显示了此命令中提供的输入参数的列表。 在表中，您可以看到在 IBM RPA Studio的脚本方式及其 Designer 方式等效标签中工作时的参数名称。
| 设计器方式标签 | 脚本方式名称 | 必需的 | 接受的变量类型 | Description |
|---|---|---|---|---|
| 文件扩展名 | fileextensions |
Optional |
Text |
向用户请求的文件扩展名。 使用 .extension 格式来指定扩展名。示例： .pdf |
| 重试 | retry |
Optional |
Boolean |
启用以允许机器人在第一次尝试后没有答案的情况下询问新问题。 |
| 尝试次数 | attempts |
Optional |
Number |
Alternative texts 中的问题重复次数。 |
| 备选文本 | retrytext |
Optional |
Text |
第一次尝试但未获得答案时，将向用户询问的备选问题。 |
| 超时子例程 | timeoutsub |
Optional |
Text |
用户响应时间耗尽时运行的子例程。 |
| 语言 | language |
Optional |
Language |
用于机器人通信的语言。 使用创建语言 (createLanguage) 命令来获取语言变量。 |
| 文本 | text |
Required |
Text |
询问以获取文件的问题。 |
| 超时 | timeout |
Optional |
Time Span, Number, Text |
用于等待用户响应的超时。 |
输出参数
| 设计器方式标签 | 脚本方式名称 | 接受的变量类型 | Description |
|---|---|---|---|
| 值 | value |
Text |
用户输入的完整路径和文件名。 |
| 话语 | utterance |
Text |
返回用户提供的文本。 |
| 已超时 | timedout |
Boolean |
如果用户响应时间耗尽，那么返回“True”，否则返回“False”。 |
| 成功 | success |
Boolean |
如果文件成功运行，那么会返回“True”，否则会返回“False”。 |
| 历史消息 | botHistoryMessageId |
Text |
用于将其他命令的历史记录链接到此命令的历史记录的值。 如果在 连接到聊天机器人或 IVR上设置了 Storage Adapter ，那么此字段将返回保存的历史记录的身份值。 要使用此项，只需将此输出添加到要将此命令的历史记录链接到的特定于命令的输入参数的历史记录即可。 |
示例
机器人提示用户提供 PDF 格式的文件，并返回收到的完整路径和文件名。
defVar --name languageUs --type Language
defVar --name pdfFileInformed --type String
defVar --name phraseInsert --type String
createLanguage --culture "enUS" languageUs=value
botConnect --type "Chat" --language ${languageUs} --timedout TimeOut --autoanswer--timeout 00:05:00
chatAskFile --fileextensions ".pdf" --language ${languageUs} --text "Please send us the slip in PDF format for review." --timeout 00:05:00 pdfFileInformed=value phraseInsert=utterance
botDisconnect