输入文本

输入文本 用于向网页输入框、文本域或可编辑区域写入内容。它常用于搜索、登录、表单填写、后台录入和批量数据处理。

指令标识：FillText
指令类型：网页指令
指令描述：在指定的网页元素中输入文本内容，支持多种文本生成和填充选项

先选使用方式

工作流支持「可视化编排」和「代码编排」两种创建方式。输入文本 在两种方式里都能用，核心业务参数一致，区别主要是你通过界面配置，还是通过 Python 脚本配置。

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入「输入文本」节点，捕获输入框、填写文本	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 bots.fillText(selector="...", text="示例公司")	熟悉代码、需要复用脚本或批量生成流程的用户

第一次使用建议先用可视化编排跑通，再迁移到 Python 代码编排。下方「参数说明」同时给出界面字段和代码参数名，方便两种方式对应。

什么时候用？

• 在搜索框中输入关键词。
• 在表单中填写姓名、手机号、订单号、备注等字段。
• 把上游变量写入页面输入框。
• 登录场景中填写用户名或密码。

如果只是发送 Enter、Control+C、Tab 等按键，请使用 模拟快捷键。

使用前确认

• 目标元素是可编辑元素，例如 <input>、<textarea> 或富文本编辑器。
• 页面已经加载完成，输入框没有被遮罩或禁用。
• 输入内容是固定文本、变量引用，还是运行时 AI 生成内容。
• 如果输入框在 iframe 中，需要配置 iframe 页面定位器。
• 输入前会清空原有内容，请确认这符合业务预期。

可视化编排：从 0 到跑通

1. 在页面加载完成后添加 输入文本 指令。
2. 捕获目标输入框、文本域或富文本编辑器。
3. 在 待填充文本 中填写固定文本或变量，例如 ${keyword}。
4. 运行后确认输入框显示预期内容。

新手建议在输入前先使用 等待元素存在，必要时先用 点击元素 让输入框获得焦点。

最小示例

一个搜索类 RPA 可以这样配置：

1. 打开网页：打开目标网站。
2. 等待元素存在：等待搜索框出现。
3. 输入文本：向搜索框输入关键词，例如 ${keyword}。
4. 模拟快捷键 或 点击元素：按 Enter 或点击搜索按钮。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
元素选择器	selector	String	是	-	用于定位目标输入框。建议从元素库捕获。
待填充文本	text	String	是	-	要写入的内容。支持固定文本、变量引用拼接，或运行时由 AI 按自然语言生成。
动态文本生成选项	dynamicTextOptions	JSON	否	-	高级选项。动态文本生成配置，支持变量替换、随机文本生成等。
是否隐私信息	masked	Boolean	否	False	是否为隐私信息（如密码），开启后日志等场景会脱敏显示。
iframe 页面定位器	frameSelector	String	否	-	高级选项。目标输入框在 iframe 中时填写。
查找元素高级配置	findElementOptions	JSON	否	-	高级选项。JSON 配置，可设置查找元素的超时等待等选项。
是否发送消息	sendMsgFlag	Boolean	否	True	是否发送节点消息。

输出参数

该指令没有业务输出变量，主要副作用是改变页面输入框内容。是否成功应通过页面中显示的文本、运行日志和后续提交/搜索结果判断。

成功标准

• 输入节点执行成功。
• 页面输入框中显示预期文本。
• 如果文本来自变量，日志中能看到上游变量有值。
• 后续提交或搜索节点能正常执行。

失败排查

该指令失败处理默认为「报错中止」（STOP_ON_FAILURE）：找不到元素或输入失败会中断流程并报错，需要静默跳过时请显式配置失败处理策略。

现象	可能原因	处理建议
节点报错：找不到目标元素（定位超时 / 元素未找到）	页面未加载或定位失效	输入前先用「等待元素存在」确认元素出现，再重新捕获
输入没有生效	元素不可编辑、未获得焦点或被禁用	先点击输入框，确认元素类型和状态
输入内容为空	上游变量为空或引用错误	查看上游节点输出和变量名
文本含特殊字符导致异常	文本包含 <、>、& 等特殊字符	优先用变量传入文本，避免直接拼接

Python 代码编排

代码编排以 Python 为主。运行上下文由代码编排模板创建，示例里只需要关注业务指令本身。

bots.openUrl(url="https://example.com")

# 向输入框写入文本，text 支持固定值或变量
bots.fillText(
    selector="//textarea[@id='chat-textarea']",
    text="示例公司",
)

如果你想在工作流中通过节点动态编排指令，可使用 执行指令（XML）节点。

常见问题

Q1：输入前会清空元素中已有的内容吗？

A： 是的。输入前会自动清空元素中已有的内容，然后输入新的文本。

Q2：目标元素必须是什么类型？

A： 目标元素必须是可编辑的元素，如 <input>、<textarea> 或富文本编辑器等。如果元素不可编辑，指令会抛出异常。

Q3：如果目标元素在iframe中怎么办？

A： 需要使用 iframe页面定位器 参数指定iframe的XPath位置。例如：//iframe[@id='myFrame']。

Q4：输入包含特殊字符时应该怎么处理？

A： 对于包含XML特殊字符（如 <、>、& 等）的文本，建议使用变量方式而不是直接在text属性中填写，以避免XML解析错误。

相关指令

• 浏览器自动化指令入门
• 点击元素（推荐）
• 模拟快捷键
• 获取元素属性