
文档 沃博品牌
所有自动化块的完整参考。在侧边栏中选择一个块或使用搜索来开始。
通过 URL 或 CustomEvent 的临时流
✦ 高级此功能允许您运行在内存中组装的临时流程,而无需事先在 Dablio Robô 中创建和保存流程。 JSON 可以通过页面 URL 本身或通过 JavaScript 事件发送 CustomEvent.
建议用于系统、内部面板、ERP、快速操作链接、间接 Webhook、需要在浏览器中触发本地自动化的页面以及外部应用程序动态生成流程的场景之间的集成。
已保存流的差异
保存的流程由 dablioroboId 或 dabliorobo 并且已经存在于扩展商店中。临时流以 JSON 形式发送,在内存中执行,并在执行开始后丢弃。
完整的工作流程
使用 dablioroboWorkflow 当你已经有一个完整的流对象包含 blocks, connections, startBlockId, trigger 和其他元数据。
命令列表
使用 dablioroboCommands 当您想要发送简单的、连续的命令列表时。 Dablio Robô 会自动将此列表转换为临时工作流程。
后端验证
在执行之前,机器人会调用现有会话验证。当 runToken 发送后,端点检查 código de execução 并确认流程是否可以继续。
URL 中可用的参数
| 参数 | 描述 |
|---|---|
dablioroboWorkflow |
以 Base64URL 编码的 JSON 的完整工作流程。运行临时流而不保存它。 |
dablioroboCommands |
以 Base64URL 编码的 JSON 格式的命令数组。机器人将命令转换为连续的块。 |
runToken |
后端配置的密码,用于授权临时执行。强制要求 dablioroboWorkflow 和 dablioroboCommands. |
dablioroboData |
Base64URL 中的可选 JSON 以及初始执行数据/变量。 |
dablioroboOnce |
当设置为 1,避免在导航/重新加载期间重复触发相同的 URL。 |
dablioroboNow |
当设置为 1,尝试立即执行,而不等待稍后的自动行为。 |
dablioroboWorkflow 和 dablioroboCommands 在一起。每个镜头仅使用一种格式。如果两者都被发送,则实现应仅优先考虑其中之一或拒绝执行以避免歧义。如何将 JSON 编码为 Base64URL
参数 dablioroboWorkflow, dablioroboCommands 和 dablioroboData 必须以 Base64URL 形式发送,以避免 URL 中出现引号、重音符号、花括号、斜杠、空格和特殊字符的问题。
function toBase64Url(obj) {
const json = JSON.stringify(obj);
const utf8 = new TextEncoder().encode(json);
let binary = '';
utf8.forEach(byte => {
binary += String.fromCharCode(byte);
});
return btoa(binary)
.replace(/\+/g, '-')
.replace(/\//g, '_')
.replace(/=+$/g, '');
}
const workflowBase64 = toBase64Url(workflowJson);
const commandsBase64 = toBase64Url(commandsJson);
示例 1 — 通过 URL 发送完整的工作流程
您可以使用此格式发送整个工作流程,类似于 Dablio Robô 导出的流程。该流不会保存到本地存储。
{
"nome": "Consulta rápida no Google",
"ativo": true,
"blockDelay": 500,
"startBlockId": "start",
"trigger": {
"tipo": "manual",
"config": {}
},
"blocks": [
{
"id": "start",
"type": "trigger",
"config": []
},
{
"id": "abrir_google",
"type": "new-tab",
"config": {
"ativo": true,
"url": "https://www.google.com",
"criarNa": "janelaAtual",
"aguardarCarregamento": true,
"definirAbaAtiva": true
}
},
{
"id": "digitar_busca",
"type": "forms",
"config": {
"ativo": true,
"seletor": "textarea[name='q'], input[name='q']",
"aguardarSeletor": true,
"tempoAguardarSeletor": 15000,
"acao": "text",
"valor": "Dablio Group",
"limparCampo": true
}
},
{
"id": "enviar_form",
"type": "forms",
"config": {
"ativo": true,
"seletor": "form[action*='/search']",
"aguardarSeletor": true,
"tempoAguardarSeletor": 10000,
"acao": "submit"
}
}
],
"connections": [
{
"from": { "blockId": "start", "port": "default" },
"to": { "blockId": "abrir_google", "port": "in" }
},
{
"from": { "blockId": "abrir_google", "port": "default" },
"to": { "blockId": "digitar_busca", "port": "in" }
},
{
"from": { "blockId": "digitar_busca", "port": "default" },
"to": { "blockId": "enviar_form", "port": "in" }
}
]
}
https://www.google.com/?dablioroboWorkflow=BASE64URL_DO_WORKFLOW&runToken=SUA_SENHA&dablioroboOnce=1&dablioroboNow=1
示例 2 — 通过 URL 发送顺序命令
在此格式中,您仅发送命令列表。机器人自动组装起始块、中间块和顺序连接。
[
{
"type": "open",
"url": "https://www.google.com",
"wait": true
},
{
"type": "type",
"selector": "textarea[name='q'], input[name='q']",
"value": "Dablio Group",
"wait": true,
"clear": true
},
{
"type": "submit",
"selector": "form[action*='/search']",
"wait": true
},
{
"type": "click",
"selector": "h3",
"wait": true
}
]
https://www.google.com/?dablioroboCommands=BASE64URL_DOS_COMANDOS&runToken=SUA_SENHA&dablioroboOnce=1&dablioroboNow=1
短命令中接受的别名
| 别名 | 等效块/动作 |
|---|---|
clickclicarclique |
转换为块 click-element. |
typedigitarpreencher |
转换为块 forms 与文字动作。 |
submitenviar |
转换为块 forms 用行动 submit. |
selectselecionar |
转换为块 forms 与选择动作。 |
keyhotkeyatalho |
转换为块 press-key. |
waitsleepaguardar |
转换为块 delay. |
openopen-urlnova-aba |
转换为块 new-tab. |
jsjavascript |
转换为块 javascript-code. |
windows |
转换为块 windows,当本地主机安装并授权时。 |
type real 块并将所有配置放入其中 config。示例: { type: "click-element", config: { seletor: "#botao" } }.随流发送变量
使用 dablioroboData 发送运行的初始数据。该数据进入流的上下文,并且可以作为变量被块使用。
https://www.google.com/?dablioroboWorkflow=BASE64URL_DO_WORKFLOW&dablioroboData=BASE64URL_DAS_VARIAVEIS&runToken=SUA_SENHA&dablioroboOnce=1&dablioroboNow=1
示例 3 — 通过 CustomEvent 执行临时工作流程
当页面已打开并且您希望通过 JavaScript 触发自动化而不重新加载 URL 时,请使用此格式。
window.dispatchEvent(new CustomEvent('dabliorobo:execute-workflow', {
detail: {
runToken: 'SUA_SENHA',
workflow: {
nome: 'Fluxo temporário via evento',
ativo: true,
blockDelay: 500,
startBlockId: 'start',
trigger: {
tipo: 'manual',
config: {}
},
blocks: [
{
id: 'start',
type: 'trigger',
config: []
},
{
id: 'aguardar_1s',
type: 'delay',
config: {
ativo: true,
tempoMs: 1000
}
}
],
connections: [
{
from: { blockId: 'start', port: 'default' },
to: { blockId: 'aguardar_1s', port: 'in' }
}
]
},
data: {
cliente: '123',
origem: 'meu-sistema'
}
}
}));
示例 4 — 通过 CustomEvent 执行命令
window.dispatchEvent(new CustomEvent('dabliorobo:execute-workflow', {
detail: {
runToken: 'SUA_SENHA',
commands: [
{
type: 'open',
url: 'https://www.google.com',
wait: true
},
{
type: 'type',
selector: "textarea[name='q'], input[name='q']",
value: 'Dablio Group',
wait: true,
clear: true
},
{
type: 'submit',
selector: "form[action*='/search']",
wait: true
}
],
data: {
origem: 'custom-event'
}
}
}));
捕获执行反馈
内容脚本收到请求后,通过事件返回结果 dabliorobo:execute-workflow:result。此返回通知流是否已收到、是否已启动以及阻塞情况下的错误是什么。
window.addEventListener('dabliorobo:execute-workflow:result', function (event) {
console.log('Resultado Dablio Robô:', event.detail);
if (event.detail.ok) {
console.log('Fluxo recebido e iniciado:', event.detail.instanceId);
} else {
console.error('Falha ao iniciar fluxo:', event.detail.error);
}
});
使用 runToken 进行安全验证
1. 用户必须经过身份验证
机器人调用现有会话验证。如果会话无效、过期或没有本地令牌,则执行将被阻止。
2、用户必须有权限
通常,除了有效会话之外,后端返回还需要允许流程执行。
3、执行代码必须事先在面板中配置好
在采取任何操作之前,用户需要访问他们的面板并检查他们是否有执行该操作的权限,然后配置执行代码(并且必须在请求中告知),否则临时流程不会被执行。
主要阻塞错误
| 错误 | 当它发生时 |
|---|---|
RUN_TOKEN_REQUIRED |
发送了临时工作流程,但参数 runToken 没有被告知。 |
RUN_TOKEN_INVALID |
后台不接受 runToken |
AUTH_REQUIRED |
用户的本地会话无效或后端拒绝身份验证。 |
PERMISSION_DENIED_RUN_WORKFLOW |
用户已通过身份验证,但无权运行流程。 |
WORKFLOW_NOT_FOUND |
当未找到保存的流时,适用于按 ID/publicId 触发的触发器。它不得出现在有效的临时工作流程中。 |
runToken 作为密码。请勿在公共页面、共享 URL、屏幕截图、服务器日志、浏览器历史记录或发送给第三方的链接上显示此值。对于敏感集成,最好在系统的经过身份验证的区域中生成链接并在后端限制其有效性。dablioroboWorkflow 发送完整的流, dablioroboCommands 发送简单的命令, dablioroboData 对于变量和 runToken 授权在后端临时执行。触发
街区 触发 它是任何流程的强制性起点。它定义了 当 和 如何 流程将开始。每个流必须恰好有一个触发器。
定义流程开始的方式和时间。支持手动触发,按时间间隔、星期几、访问网站时、特定日期/时间、打开浏览器时、通过上下文菜单或键盘快捷键。
手册
单击 Dablio Robô 面板上的 ▶ 按钮启动流程。非常适合测试和特定执行。
按间隔
字段中定义的每 N 分钟重复运行一次流程 Intervalo (minutos)。计数器在第一次手动运行或激活流程后启动。
访问网站时
当浏览器访问与配置模式匹配的 URL 时自动触发。支持纯文本、精确匹配、正则表达式和 SPA(单页应用程序)站点,并具有路由更改检测功能。
具体日期/时间
使用本地系统时间安排流程在指定的日期和时间运行一次。
星期几
每周在固定的日期和时间运行 - 例如,每周一 08:00。
打开浏览器时
打开浏览器时自动启动。非常适合系统启动例程或日常数据收集。
上下文菜单
将流量添加为右键单击菜单中的选项。它可以按 URL 和上下文进行过滤:图像、链接、可编辑字段、选定的文本等。
键盘快捷键
将流绑定到组合键(例如:Ctrl+Shift+1)。它仅适用于网页,不适用于内部浏览器页面 (chrome://)。
| 参数 | 描述 |
|---|---|
Tipo de disparo |
手动·按时间间隔·访问网站时·特定日期/时间·星期几·打开浏览器时·上下文菜单·键盘快捷键 |
Intervalo (min) |
每次自动执行之间的分钟数 |
URL do site |
访问时触发流的 URL 或 URL 的一部分 |
Considerar exato |
仅当 URL 完全相同时才会触发触发器 |
Usar regex |
将 URL 字段解释为正则表达式 |
Support SPA |
当单页应用程序中的 URL 更改时也会触发 |
Executar automaticamente |
如果未选中,则流程仅在手动启动时运行 |
Aguardar carregamento completo |
仅在页面加载事件后启动流程 |
Dia da semana / Data / Hora |
预定拍摄的日期和时间设置 |
Atalho de teclado |
触发流程的组合键(例如:CTRL+SHIFT+1) |
Executar automaticamente 取消选中会在页面上显示浮动按钮,允许用户在正确的时间启动流程。通过 JavaScript 触发(自定义事件)
您可以使用以下命令从任何页面以编程方式触发流程 CustomEvent 来自 JavaScript:
chrome:// 或 chrome-extension:// 不支持键盘快捷键。执行作业
将另一个流程作为子例程调用。子流自动从父流接收变量和表,完成后,父流将沿着默认路径正常继续。
从此时开始运行另一个工作流程。自动在父流和子流之间共享变量、表和目标选项卡。
上下文共享
变量、表和当前目标选项卡会自动传递给子级。返回时,父级可以看到子级对变量所做的更改。
推荐用途
非常适合创建可重用子例程库:登录、填写重复表单、发送通知等。多个流程可以调用同一子流程。
| 参数 | 描述 |
|---|---|
Workflow alvo |
选择要执行的流程 |
{{nomeVariavel}}.上下文共享
共享什么
子流自动从父流接收所有变量、表和当前目标选项卡。返回时,父级可以看到子级对变量所做的更改。
检查流量
实时检查此时是否有另一个流程正在运行。对于避免并行执行或等待并发流完成非常有用。
检查特定流程当前是否正在运行。返回 true(运行)或 false(停止)。
返回
返回 true 如果流程正在运行, false 否则。结果可以保存在变量中。
使用案例
防止两个流同时访问同一个系统;在复杂的自动化中创建控制信号量;监控自动流的运行状况。
| 参数 | 描述 |
|---|---|
Origem do fluxo |
从列表中选择或手动输入 ID |
Fluxo / workflowId |
待检查流量 |
Salvar resultado na variável |
将真/假保存在变量中 |
停止流动
停止当前流程或其他正在进行的流程的执行。它可以以成功状态终止或抛出错误以激活失败处理块。
停止当前流程或其他正在进行的流程的执行。它可能会成功终止或引发错误。
停止电流流动
立即关闭该流程。硒 抛出错误 被选中,状态为错误并且配置的消息出现在日志中。
停止所有流量
对于所有正在运行的实例。选项 除当前流外 保持这个活着,同时取消其他的。
停止特定流
取消选定流的所有实例,而不影响其他正在运行的流。
| 参数 | 描述 |
|---|---|
O que parar |
当前流量 · 所有流量 · 特定流量 |
Exceto o fluxo atual |
对于其他人来说,但要让这个活着 |
Lançar um erro |
以错误状态而非成功状态终止 |
Mensagem de erro |
因错误关闭时日志中显示的消息 |
稍等一下
在前进到下一个块之前暂停执行配置的时间。对于等待加载、页面动画和操作之间的时间窗口至关重要。
在前进到下一个块之前,将流程执行暂停指定的时间(以毫秒为单位)。
时间(以毫秒为单位)
1秒=1000ms·500ms=半秒·3000ms=3秒。设置所需的最短时间——时间太长会不必要地减慢流速。
延迟的替代方案
要等待特定元素出现,请选择选项 等待选择器 在交互块中。它比固定时间更可靠,因为它不依赖于估计。
| 参数 | 描述 |
|---|---|
Tempo (ms) |
暂停持续时间(以毫秒为单位)(例如:1000 = 1 秒) |
时间参考
500ms= 半秒1000ms= 1 秒3000ms= 3 秒60000ms= 1 分钟
导出数据
将流程收集的数据导出到本地文件。支持数据表、单个变量和自定义内容,具有多种输出格式。
将收集的数据(表、变量或自定义文本)以各种格式导出到本地文件。
资料来源:表
导出流程创建的表中的所有数据(例如从网站抓取的数据)。非常适合 CSV 和 JSON。
来源:变量
导出特定变量的内容。对于保存长文本、API 响应或捕获的 HTML 内容很有用。
来源:自定义内容
使用插入变量从文本模板组装文件: Nome: {{nome}}, E-mail: {{email}}.
文件的 Base64 格式
将 Base64 字符串(例如从 API 接收的图像或 PDF)转换回相应的二进制文件。
选择具体位置
使用浏览器的文件系统访问 API,它将文件直接保存到用户选择的文件夹中,而无需通过默认的“下载”文件夹。
| 参数 | 描述 |
|---|---|
Fonte dos dados |
数据表·变量·自定义内容 |
Formato |
JSON · CSV · TXT · HTML · XML · Base64 到文件 · 自定义 MIME |
Nome do arquivo |
输出文件名。接受变量 {{var}} |
Escolher local específico |
保存到选定的文件夹而不是默认的下载文件夹 |
Conflito de nome |
生成唯一名称·覆盖·询问用户 |
{{data}} 在文件名中创建单个文件: relatorio_{{data}}.csv.可用的导出格式
- JSON — 使用缩进格式化的对象或数组。非常适合通过 API 进行消费。
- CSV — 逗号分隔的工作表。与 Excel、Sheets 和 LibreOffice 兼容。
- TXT — 纯文本,每条记录一行。
- 超文本标记语言 — 保留捕获的 HTML 结构。
- XML - 遗留集成的结构化格式。
- Base64 转文件 — 将 Base64 字符串转换回原始二进制文件(PDF、图像等)。
- 自定义 (MIME) — 为未列出的格式指定任何 MIME 类型。
{{data}} 或文件名中的另一个日期变量来创建时间戳导出: relatorio_{{data}}.csvHTTP请求
向外部 API 发出 HTTP/HTTPS 请求。支持所有 REST 动词、通过标头进行身份验证、多种正文格式和响应类型。
向 API 或外部服务发出 HTTP 请求。支持所有方法、自定义标头、正文类型并接收 JSON、文本或 Base64 形式的响应。
自定义标头
在格式中每行添加一个标题 Chave: Valor。对于身份验证: Authorization: Bearer {{token}}。变量会自动替换。
内容类型
application/json 对于标准 REST API; application/x-www-form-urlencoded 对于遗留表格; multipart/form-data 用于上传文件。
JSON 中的路径
从响应中提取特定字段,而无需处理完整的 JSON。使用点符号: data.users.0.email — 返回数组中第一个用户的电子邮件。
Base64 响应
非常适合从 API 下载二进制文件(PDF、图像、文档)。结果可与导出数据块一起使用,将文件保存到磁盘。
| 参数 | 描述 |
|---|---|
Método |
获取·发布·放置·修补·删除·头 |
URL |
完整的 API 地址。接受变量 {{var}} |
Tempo limite |
如果请求时间过长,则中止请求的时间(以毫秒为单位)(0 = 禁用) |
Cabeçalhos |
键:值格式中每行一个标头 |
Tipo de conteúdo |
JSON · 表单 URL 编码 · 多部分 · 文本 · HTML |
Body |
请求正文(用于 POST/PUT/PATCH)。接受变量 |
Tipo de resposta |
JSON(对象)·文本(字符串)·Base64(二进制/文件) |
Caminho no JSON |
使用点表示法提取 JSON 的一部分(例如:data.items.0.id) |
Salvar resposta |
将存储结果的变量的名称 |
Authorization: Bearer {{meuToken}}
Content-Type: application/json
X-Api-Key: minha-chave-secreta
数据路径
使用点表示法从 JSON 响应中提取特定字段。例如,对于如下响应:
- 获取数组
valores: 写data.valores - 获取第一个元素:写
data.valores.0 - 要获取第二件商品的价格:写入
data.valores.1.preco
使用表单数据发送(多部分/表单数据)
当内容类型为 multipart/form-data,主体必须遵循pair数组格式:
在请求正文中使用变量
对于类型的值 字符串,将变量用双引号括起来:
$response 在外地 数据中的路径 捕获完整的 HTTP 响应,包括 status, statusText 和原始数据。剪贴板
读取数据或将数据写入系统剪贴板 (Ctrl+C/Ctrl+V)。对于在流和操作系统之间传输数据很有用。
将文本复制到系统剪贴板或读取用户复制的当前内容。
复制
将当前剪贴板内容替换为配置的文本。接受变量: {{nome}} - {{email}}.
阅读
捕获当前剪贴板内容并将其保存到流变量中以供将来的块使用。
| 参数 | 描述 |
|---|---|
Ação |
复制·阅读 |
Texto |
要复制的文本(用于“复制”操作)。接受变量 |
Salvar na variável |
将接收读取文本的变量(用于“读取”操作) |
使用案例
复制(写入剪贴板)
将当前内容替换为配置的文本。接受变量 {{var}}。对于在粘贴到不响应表单块的系统之前准备文本很有用。
读取(从剪贴板捕获)
捕获剪贴板的当前内容并将其保存到变量中。用于捕获用户手动复制的数据或其他程序放置在剪贴板上的数据。
Ctrl+V.等待连接
等待所有先前连接的块完成后再继续。对于同步并行流很有用。
何时使用
当多个并行块汇聚到流程中的单个点时,该块 等待连接 等大家都说完了再继续。如果没有它,流程可能会在所有分支完成之前前进。
块组
以视觉方式将容器内的其他块分组以组织和构建流程。它本身不执行任何操作。
评论
可视化记事本。流程期间不执行任何操作。它专门用于记录和组织画布。
通知
向用户显示视觉警报:作为本机 Windows 通知(屏幕一角)或作为浏览器活动页面内的浮动弹出窗口。
在 Windows 操作系统上向用户显示通知和/或以 HTML 弹出窗口的形式在活动页面中以不同的视觉样式显示通知。
浏览器
在当前页面中显示样式化的 toast/弹出窗口。支持 7 种视觉风格:标准、成功、关注、失败、信息和彩色警报。
窗户
使用本机 Chrome/Edge 通知 API,无论打开哪个页面,都会在 Windows 屏幕的右下角显示警报。
持续时间
设置 0 毫秒以保留弹出窗口,直到用户手动关闭它 - 对于不应自动消失的重要消息来说是理想的选择。
| 参数 | 描述 |
|---|---|
Título |
通知标题 |
Mensagem |
通知文本。接受变量 {{var}} |
Onde exibir |
仅限浏览器 · 仅限 Windows · Windows 和浏览器 |
Estilo |
标准·成功(绿色)·注意(橙色)·失败(红色)·信息(蓝色)·警报(紫色/棕色) |
Duração no navegador (ms) |
弹出窗口消失之前的时间(0 = 保持直到关闭) |
声音警报
✦ 独家在执行任务期间或之后播放声音警报以吸引用户的注意力。当流在后台运行时很有用。
在设定的时间内播放声音警报。用于发出重要任务或事件完成的信号。
声音类型
5 个选项:简单蜂鸣声(谨慎通知)、一般警报(中等注意力)、成功/完成(任务完成)、警报/紧急(严重错误)和数字(技术风格)。
体积
范围从 0(静音)到 100(最大音量)。声音在活动浏览器选项卡中播放。
| 参数 | 描述 |
|---|---|
Escolha o som |
简单的蜂鸣声 · 一般警报 · 成功/完成 · 警报/紧急 · 数字 |
Duração (segundos) |
闹钟会响多久? |
Volume (0 a 100) |
警报音量级别 |
加工
✦ 独家在页面上显示带有加载指示器的半透明覆盖层,防止用户在机器人工作时单击或交互。
显示带有加载指示器的锁定屏幕,以防止流程运行时的用户交互。
打开屏幕
立即锁定界面。配置消息、颜色和透明度,以在视觉上与目标站点集成。
关闭屏幕
消除重叠,恢复正常交互。每当流程结束或出现错误时使用。
完成后保持打开状态
当流程结束但您希望用户在收回页面控制权之前确认结果时很有用。
允许在消息中使用 HTML
启用高级消息格式:粗体、链接、表情符号,甚至带有内联 HTML/CSS 的自定义进度条。
| 参数 | 描述 |
|---|---|
Ação |
打开处理画面 · 关闭处理 |
Mensagem de status |
显示给用户的文本。接受变量和 HTML |
Tamanho da fonte (px) |
消息文字大小 |
Permitir HTML |
将内容呈现为 HTML 而不是纯文本 |
Cor do texto e spinner |
消息和加载图标颜色 |
Cor de fundo |
叠加颜色 |
Transparência (%) |
0 = 不可见(只是块),100 = 完全黑暗 |
Manter aberto ao finalizar |
在流程结束时不会自行关闭 — 显示 CLOSE 按钮 |
Exibir botão FECHAR |
允许用户随时解锁屏幕 |
显示对话框
✦ 独家在页面内显示交互式模式窗口。它可以是简单的(单击“确定”的信息)或带有文本字段、选择和多个操作按钮的迷你表单。
在屏幕上显示一个对话框并等待用户操作。支持多个响应按钮、文本字段、选择和复选框。
简单模式
使用“确定”(→ 默认输出)和“取消”(→ 后备输出)按钮显示标题和消息。消息中允许使用 HTML。
测验模式
添加自定义输入字段:文本输入、下拉菜单(选择)、复选框和带有自定义标签的按钮。每个按钮都会在块中生成自己的输出。
保存值
在字段中输入的值会自动保存在为每个字段配置的变量中,这些变量可在以下块中使用。
| 参数 | 描述 |
|---|---|
Título |
可选对话标题 |
Mensagem |
消息文本(接受 HTML) |
Modo Questionário |
启用多个按钮和输入字段 |
Campos de diálogo |
动态添加按钮、输入、选择和复选框 |
激活选项卡/窗口
定义哪个浏览器选项卡将成为下一个块的目标。将执行上下文更改为按配置条件找到的选项卡。
专注于特定选项卡并将其定义为流程中所有未来块的目标。
通过网址
搜索其 URL 包含、等于或匹配通知的正则表达式的第一个选项卡。
按标题
通过浏览器选项卡中显示的标题查找选项卡。
下一个/上一个
按循环顺序导航到当前选项卡右侧或左侧的选项卡。
页面已保存
使用选项通过先前保存的名称引用选项卡 保存ID 在“新选项卡”或“新窗口”等块中。
焦点选项卡
将选项卡置于浏览器的最前面——当机器人需要选项卡可见以捕获屏幕时非常有用。
| 参数 | 描述 |
|---|---|
Encontrar aba por |
当前选项卡 · 按 URL · 标题 · 下一个选项卡 · 上一个选项卡 · 索引 · 打开选项卡 · 保存的页面 |
Focar aba/janela |
将选项卡直观地置于屏幕前面 |
为什么需要这个块
Dablio Robô 需要知道在哪个选项卡中执行每个操作。该块定义了 执行上下文 对于所有后续块。在流程开始时或每当您需要将焦点更改到另一个选项卡时使用。
新标签页
使用配置的 URL 在浏览器中打开一个新选项卡,并提供对窗口、识别和加载行为的完全控制。
在浏览器中打开一个新选项卡,其中包含高级窗口控件、页面识别并等待完全加载。
重用选项卡
它不会打开新选项卡,而是使用新 URL 更新当前选项卡。节省资源并避免重复流程中积累不必要的选项卡。
等待加载
暂停流程,直到页面完全加载(加载事件)。仅当您想立即继续而不等待时才取消选中。
保持襟翼在后面
在后台打开选项卡,而不会窃取视觉焦点。非常适合在用户继续浏览时预加载页面。
静音选项卡
将选项卡切换为自动静音 - 对于打开带有音频自动播放功能的视频或页面非常有用。
保存ID
保存此选项卡的名称(例如:“abaPortal”),该名称可用作流程中其他块的引用。
| 参数 | 描述 |
|---|---|
URL |
要打开的页面的地址。接受变量 |
Criar na janela |
当前窗口 · 活动窗口 · 特定窗口 · 按标题/URL/保存的页面 |
Reutilizar aba |
刷新现有选项卡而不是打开新选项卡 |
Aguardar carregamento |
等待页面完全加载后再继续 |
Manter aba atrás |
打开时不会夺走屏幕的视觉焦点 |
Silenciar aba |
静音新标签声音(视频、通知) |
Salvar identificação |
保存名称以在其他块中引用此选项卡 |
重用选项卡选项
循环保存资源
当处于活动状态时,该块会导航当前选项卡而不是打开新选项卡。非常适合按顺序访问多个 URL 的流程 — 避免积累数十个打开的选项卡。
切换选项卡/窗口
将执行焦点切换到浏览器中已打开的另一个选项卡,由 URL、标题、索引或相对位置标识。
根据 URL、标题、索引、相对位置或保存的页面将焦点切换到另一个选项卡。
通过网址
搜索所有打开的选项卡并激活第一个与模式匹配的选项卡。支持纯文本、精确文本或正则表达式文本。
下一个/上一个
在需要按顺序处理选项卡的循环中很有用。按循环顺序导航(在最后一个之后,转到第一个)。
回退输出
如果未找到挡板,则流量继续通过出口 后备 而不是生成错误 - 允许您优雅地处理“未找到选项卡”的情况。
| 参数 | 描述 |
|---|---|
Encontrar aba por |
URL · 标题 · 下一页 · 上一页 · 索引 · 打开选项卡 · 保存的页面 |
Definir como aba ativa |
此选项卡将成为下一步操作的目标 |
新窗口
打开一个新的浏览器窗口,与当前选项卡分开。支持私人/隐身模式、没有地址栏的弹出窗口和自定义尺寸。
打开一个新的浏览器窗口,其中包含高级选项:私人/隐身模式、类型、初始状态和自定义尺寸。
隐身模式
在私人窗口中打开,没有主会话的历史记录或 cookie。需要扩展设置权限。
弹出式
没有标签栏、地址或工具的紧凑窗口 - 非常适合显示特定内容或模拟打开旧版 Web 系统。
自定义状态
在屏幕上准确定位窗口:顶部、左侧、宽度和高度(以像素为单位)——对于在多个监视器上进行监视或查看非常有用。
| 参数 | 描述 |
|---|---|
URL |
在新窗口中加载的地址 |
Janela anônima |
以私密模式打开(需要扩展权限) |
Tipo |
正常 · 弹出窗口(无选项卡) · 面板 |
Estado inicial |
正常·最大化·最小化·全屏·自定义(位置/大小) |
Salvar identificação |
保存名称以引用其他块中的窗口 |
返回
导航到活动选项卡历史记录中的上一页,相当于浏览器的后退按钮。
返回活动选项卡中的上一页,相当于浏览器的后退按钮。
典型用法
在抓取循环或表单中处理详细信息项后返回列表。
下一页
导航到活动选项卡历史记录中的下一页(仅当存在时),相当于浏览器的“下一步”按钮。
前进到活动选项卡中的下一页,相当于浏览器的“下一步”按钮。
典型用法
在用户已向后导航且机器人需要恢复的审阅流程中非常有用。
关闭选项卡/页面
流式传输时关闭特定选项卡或窗口。它支持多种选择标准,并且可以一次关闭多个选项卡。
按条件关闭选项卡或窗口:活动选项卡、可见选项卡、窗口、按 URL、标题、索引或保存的页面。支持多次关闭。
通过网址
关闭 URL 与该模式匹配的所有选项卡。激活 接近倍数 一次性关闭它们;否则,它仅关闭找到的第一个。
活动选项卡与当前选项卡
活动选项卡(工作) 关闭流用作目标的选项卡; 当前选项卡(可见) 关闭用户当前正在查看的选项卡。
| 参数 | 描述 |
|---|---|
O que fechar |
活动选项卡 · 当前选项卡 · 活动/当前窗口 · 特定选项卡 · 按标题/索引/URL/保存的页面 |
Fechar múltiplos |
关闭所有符合条件的选项卡 |
关闭方式
活动选项卡(工作)与当前选项卡(可见)
活动选项卡(工作) 关闭流程用作其执行上下文的选项卡。 当前选项卡(可见) 关闭用户当前在浏览器中查看的选项卡。当机器人在后台工作时,这些可以是不同的选项卡。
截图
以 4 种模式捕获屏幕图像:页面的可见区域、带滚动的整页、特定元素或高度大于屏幕的完整元素。
截取可见区域、整页、特定元素或带滚动的完整元素的屏幕截图。
整页
Dablio Robô 自动从上到下滚动页面,收集碎片并使用画布组装完整的图像。等待惰性图像加载字段 等待(毫秒).
具体元素
在捕获之前滚动元素并使元素在屏幕上居中。使用 CSS 或 XPath 选择器来识别确切的元素。
完整元素(带滚动)
对于溢出的元素:scroll — Dablio Robô 在元素内滚动以捕获所有内容,即使它比视口大。
保存到变量
结果是一个 Base64 字符串 (data:image/png;base64,...)可与 OCR 一起使用、导出为文件或发送到 AI API。
| 参数 | 描述 |
|---|---|
Alvo |
可见页面·整页·一个元素·一个完整元素(带滚动条) |
Em qual aba |
当前选项卡或按 URL/标题/索引/保存的页面搜索 |
Seletor do elemento |
要捕获的元素的 CSS 或 XPath 选择器 |
Aguardar (ms) |
滚动加载动态内容后暂停 |
Salvar no computador |
下载 PNG/JPG 文件 |
Salvar em variável |
将图像以 Base64 格式保存在变量中 |
拍摄模式
可见页面(视口)
仅捕获浏览器窗口的可见区域。快速且无需滚动。
整页
Dablio Robô 自动从上到下滚动页面,捕获片段并使用画布组装完整的图像。配置字段 等待(毫秒) 1000–2000ms 之间,以确保延迟图像加载。
具体元素
滚动页面直到元素可见并仅捕获该区域。使用 CSS 或 XPath 选择器来识别确切的元素。
完整元件(带内部滚动)
对于具有以下元素的元素 overflow: scroll,机器人在元素内部滚动并将片段缝合在一起,捕获所有内容,即使它比屏幕大。
监听浏览器
暂停流程,等待特定的浏览器或页面事件:选项卡打开/关闭、单击、键入、表单提交、滚动等。
暂停流程,直到浏览器或页面元素上发生特定事件。
选项卡事件
等待选项卡加载、创建或关闭。在异步打开弹出窗口或新选项卡的流程中必不可少。
鼠标和键盘事件
等待用户交互:单击任意位置、特定元素、在字段中键入等。将机器人变成反应触发器。
元素监测器
当活动时,仅当事件发生在配置的选择器内时才会被接受 - 它会忽略页面其他部分中的相同事件。
回退输出
如果事件在时限内没有发生,流程将继续通过输出 后备,允许无故障地处理超时。
| 参数 | 描述 |
|---|---|
Tempo limite (ms) |
如果事件没有发生,则遵循后备输出 |
Evento a escutar |
选项卡:加载/关闭/创建 · 窗口:创建/关闭 · 鼠标:单击/双击/鼠标悬停 · 键盘:keydown/keyup · 表单:输入/更改/聚焦/模糊/提交 · 剪贴板:复制/剪切/粘贴 · 触摸 · 滚动 · 调整大小 · 加载 |
Monitorar em |
活动选项卡·按 URL·标题·索引·已保存页面 |
Monitor elemento |
该事件必须发生在选定的选择器内 |
代理
为所有浏览器导航配置代理服务器,对于绕过地理限制或在抓取自动化中轮换 IP 很有用。
为整个浏览器连接配置代理服务器 (HTTP/HTTPS/SOCKS4/SOCKS5) 或删除当前配置。
设置代理
配置主机、端口、协议和凭据。代理处于活动状态时影响所有浏览器连接。
清除代理
删除代理配置并返回到操作系统的默认网络设置。
例外情况
列出的域名 例外情况清单 (以逗号分隔)不走代理:localhost、127.0.0.1、企业内网。
| 参数 | 描述 |
|---|---|
Ação |
设置代理·清除/禁用 |
Protocolo |
HTTP · HTTPS · SOCKS4 · SOCKS5 |
Host/IP |
代理服务器地址 |
Porta |
代理服务器端口 |
Usuário/Senha |
可选的身份验证凭据 |
Lista de exceções |
不使用代理的域(逗号分隔) |
配置
支持的协议
HTTP、HTTPS、SOCKS4 和 SOCKS5。对于需要身份验证的代理,请填写字段 用户 和 密码。凭据由浏览器自动发送。
例外情况清单
逗号分隔的域不会通过代理。始终包括 localhost 和 127.0.0.1 不通过代理路由本地流量。
切换框架
将执行上下文更改为 <iframe> 在页面上。当您要交互的元素位于内联框架内时必需。
将执行焦点更改为页面上的特定 iFrame 或返回主页。
选择框架
聚焦于某个框架后,后续块中的所有选择器都会查找该框架内的元素,而不是主页上的元素。
返回主页
使用选项 返回主页 退出框架并返回到全局页面上下文。
通过选择器
Dablio Robô 查找元素 <iframe> 在 DOM 中使用给定的选择器并自动映射frameId。
| 参数 | 描述 |
|---|---|
Modo |
返回主页 · 通过 CSS/XPath 选择器 · 通过框架 URL · 通过索引 |
Seletor |
<iframe> 元素 CSS 或 XPath 选择器 |
URL do frame |
用于查找框架的 URL 模式 |
Índice |
列表中的框架位置(0 = 主框架) |
它是如何运作的
对某一帧对焦后, 以下块中的所有选择器 他们开始在该框架内寻找元素,而不是在主页上。使用 返回主页 退出框架并返回到全局上下文。
<iframe> 或 <frame> 在页面结构中。屏幕显示
控制浏览器窗口或特定页面元素的显示方式,对于屏幕截图和需要全屏的系统很有用。
更改显示模式:窗口(正常/最大化/最小化/全屏)、全页或展开特定元素。
窗户
更改窗口的状态:正常、最大化、最小化或全屏。在屏幕截图之前很有用,可确保完全可见。
元素
在特定元素(例如视频播放器或地图)上调用浏览器的全屏 API,而不影响窗口的其余部分。
| 参数 | 描述 |
|---|---|
Alterar |
当前窗口 · 当前页面 · 特定部分(元素) |
Modo de exibição |
正常·最大化·最小化·全屏 |
Seletor do elemento |
将特定元素扩展到全屏 |
充值
重新加载一个或多个浏览器选项卡,相当于 F5。对于更新仪表板中的数据或需要重新加载的修改后非常有用。
按条件重新加载一个或多个选项卡:活动选项卡、可见、按标题、索引或 URL。
重新加载多个
通过 URL 搜索时,选择 重新加载多个 一次更新与该模式匹配的所有选项卡。
| 参数 | 描述 |
|---|---|
Qual aba recarregar |
活动选项卡·当前选项卡·特定·按标题/索引/URL/保存的页面 |
Recarregar múltiplos |
重新加载符合条件的所有选项卡 |
常见用途
- 修改后更新仪表板或报告
- 在具有积极缓存的系统上强制数据重新加载
- 重新启动在自动化过程中卡住的页面
- 一次重新加载多个监控选项卡
获取网址
捕获打开选项卡的 URL 和/或标题并将其保存在流变量中以供以后使用。
获取一个或多个打开的选项卡的 URL 和/或标题并将其保存在变量中。
活动选项卡
返回流当前定位的选项卡的 URL 和标题。
所有选项卡
返回包含当前窗口中所有选项卡的 URL 和标题的数组。可选过滤器允许您仅选择相关选项卡。
| 参数 | 描述 |
|---|---|
Modo |
活动选项卡 · 所有选项卡 |
Filtros |
选择“所有选项卡”时要过滤的 URL 和标题 |
Variável para URL |
将接收 URL(或 URL 列表)的变量的名称 |
Variável para título |
将接收标题(或列表)的变量的名称 |
常见用途
- 在执行条件操作之前检查流所在的 URL
- 捕获重定向后的 URL 以提取参数
- 保存自动化期间访问的 URL 的历史记录
- 在继续之前验证流程是否到达预期页面
饼干
管理特定网站的浏览器 cookie:读取值、创建/更新或删除会话 cookie。
从当前网站读取、创建、更新或删除 cookie。
阅读
返回已配置变量的 cookie 值。对于捕获会话令牌或保存的首选项很有用。
记录
创建或更新给定 URL 的 cookie。用于模拟身份验证状态或用户首选项。
删除
删除 cookie,对于强制重新身份验证或清除会话状态很有用。
| 参数 | 描述 |
|---|---|
Operação |
读·写·删除 |
Nome |
饼干名称 |
URL |
Cookie 所属网站的 URL |
Valor |
要写入的值(用于“写入”操作) |
Variável destino |
将接收读取值的变量 |
可用操作
阅读
按名称和 URL 捕获 cookie 的值并将其保存到流变量中。返回 null 如果cookie不存在。
记录
创建或更新指定 URL 的 cookie。对于在访问页面之前模拟会话状态或设置首选项很有用。
删除
按名称和 URL 删除 cookie。用于在运行之间强制重新验证或清除会话状态。
下载文件
拦截和管理文件下载:它可以等待下载开始、直接通过 URL 下载或从页面元素中提取媒体(图像、视频、音频)。
等待下载开始,通过直接 URL 下载文件或从页面元素中提取媒体(img、音频、视频)。
等待下载
它会等待,直到浏览器开始下载(用户单击或页面重定向)。对于捕获网站动态生成的文件很有用。
直接网址
立即从指定的 URL 下载文件。接受每行分隔的多个链接。
媒体元素
提取选择器中的 img、视频、音频元素的 src URL 并下载它们。激活 多个 下载所有找到的媒体。
使用通配符重命名
使用 * 保留原来的名称: fotos/*.jpg 将每张图像以其原始名称保存在“照片”文件夹中; relatorio_* 保留名称并更改扩展名。
| 参数 | 描述 |
|---|---|
Modo |
等待下载 · 直接 URL · 媒体元素 |
Seletor do elemento |
搜索媒体的容器(元素模式) |
Múltiplos |
下载所有找到的媒体 |
Aguardar conclusão |
暂停流直到下载完成 |
Renomear arquivo |
使用 * 保留原始名称(例如:folder/*.jpg) |
Salvar em local específico |
设置自定义目标文件夹 |
Salvar caminho em variável |
保存下载文件的路径 |
使用通配符 (*) 重命名模式
人物 * 保留原始文件名,只允许更改前缀、后缀或扩展名:
fotos/*— 保存到文件夹 照片 保留原来的名字*.jpg— 保留名称,强制 JPG 扩展名relatorio_*— 在原始名称上添加前缀backup/*.pdf— 以 PDF 扩展名保存在备份文件夹中
单击该元素
使用 CSS 或 XPath 选择器单击页面元素。 Web 自动化中最常用的块。
使用 CSS 或 XPath 选择器单击页面上的一个或多个元素,并支持等待元素出现。
CSS选择器
例如: #botao-salvar, .btn-primary, button[type='submit'], a.menu-link:nth-child(3).
XPath 选择器
例如: //button[text()='Salvar'], //input[@placeholder='Buscar']。当 CSS 不足以识别元素时使用。
多个
按顺序单击选择器找到的所有元素。对于关闭多个弹出窗口、选择列表中的复选框等很有用。
等待选择器
该块在单击之前等待元素出现。单击之前无需使用延迟块。
| 参数 | 描述 |
|---|---|
Seletor |
元素的 CSS 或 XPath(例如:#btn-save、//button[@type='submit']) |
Múltiplos |
单击选择器找到的所有元素 |
Aguardar seletor |
等待元素出现后再单击 |
Tempo máximo (ms) |
等待元素超时 |
支持的选择器
CSS选择器
任何有效的 CSS 选择器都可以: #id, .classe, button[type="submit"], ul.menu > li:nth-child(2) > a。使用 Dablio Robô 的选择器工具直接从页面捕获选择器。
XPath 选择器
当 CSS 不够用时很有用。示例: //button[text()='Confirmar'], //input[@placeholder='Buscar']。 XPath 开头为 // 或 (//.
获取内容
从页面元素中提取内容:纯文本、内部 HTML 或表单字段值。将其保存到变量以供后续块使用。
从页面元素中提取文本、内部 HTML 或值。支持多个元素(返回数组)。
内部文本与文本内容
内部文本 返回可见文本(尊重显示:无和格式)。 文本内容 返回所有节点文本,包括 CSS 隐藏的内容。
多个元素
返回一个数组(列表),其中包含所有找到的元素的内容。与块一起使用 浏览数据 来处理每个项目。
包含 HTML
捕获innerHTML而不是纯文本——对于提取HTML结构以进行进一步处理非常有用。
| 参数 | 描述 |
|---|---|
Seletor |
目标元素的 CSS 或 XPath |
Salvar em variável |
将接收值的变量的名称 |
Múltiplos elementos |
将所有找到的元素捕获为列表 |
Incluir tags HTML |
捕获innerHTML而不是纯文本 |
Usar textContent |
使用 .textContent(原始文本)而不是 .innerText(可见) |
Aguardar elemento |
捕获之前等待元素出现 |
table 与 包含 HTML 活动 — 您将拥有要处理的表格的完整 HTML。拍摄模式
内部文本(默认)
仅返回可见文本,将 CSS 视为 display:none。这是与用户在屏幕上看到的最接近的行为。
文本内容
返回所有节点文本,包括 CSS 和空格隐藏的内容。当元素具有需要捕获的隐藏文本时很有用。
内部HTML
捕获元素的内部 HTML 代码。激活 包含 HTML 标签 当您需要处理元素结构而不仅仅是文本时。
多个元素
激活时,返回一个 数组 包含选择器找到的所有元素的内容。与块匹配 浏览数据 单独处理每个项目。
形式
用于与表单交互的最通用的块:填写文本字段、选择选项、标记复选框、单击单选按钮并可以一次从表单中提取所有数据。
与表单交互:填写文本字段、从列表中选择选项、标记复选框和单选按钮,或从表单中提取数据。
文本字段
在字段中输入值。使用 清晰的视野 删除之前的内容。 打字延迟 模拟人类一个字符一个字符地打字。
选择列表(选择)
按内部值、选项文本、位置(索引)或第一个/最后一个选项进行选择。接受动态选择的变量。
获取值
一次提取所有表单字段,以 JSON、URL 编码或文本格式返回。非常适合审核已完成的表格。
提交
单击提交按钮或直接调用表单上的submit()。
| 参数 | 描述 |
|---|---|
Seletor |
表单字段或容器的 CSS |
Aguardar elemento |
等待该字段可用 |
Múltiplos |
将操作应用于找到的所有字段 |
Obter valores |
从表单中提取数据而不是填写数据 |
Tipo de ação |
文本字段·选择列表·复选框·单选·提交 |
Valor |
要输入的文本或要选择的值 |
Limpar campo |
写作前清理内容 |
Atraso de digitação (ms) |
输入每个字符之间的时间 |
Modo de seleção |
按值 · 第一个选项 · 最后一个选项 · 按位置 |
Formato de extração |
JSON · 编码 URL · 文本(获取值时) |
支持的字段类型
文本字段(输入/文本区域)
填写字段值。使用 内容清晰 在键入之前清除先前的值。领域 打字延迟 逐字符模拟人类打字 — 对于检测自动完成的系统,设置在 50-150 毫秒之间。
选择列表(选择)
根据您的情况选择一个选项 内在价值 (属性 value HTML),而不是显示的文本。要找到正确的值,请使用浏览器的开发人员工具检查元素(F12→选择 <option> 所需)。
复选框和单选按钮
领域 选择选项 定义元素是否应该被标记(true) 或未选中 (false)。对于单选按钮,选择一个按钮会自动取消选择同一组中的其他按钮。
滚动
使用滚动条将页面或元素滚动到特定位置或在屏幕上显示元素。
水平和/或垂直滚动页面或特定元素,并提供滚动支持以实现流畅的预览和动画。
绝对位置与增量位置
无增量:从顶部/左侧转到确切的 X/Y 位置。带增量:将值添加到当前滚动位置。
滚动查看
自动滚动,直到目标元素在视口中向上或向下可见 - 无需计算位置。
溢出元件
要在元素内滚动,请使用 overflow: scroll (列表、表格、面板),在字段中输入选择器 目标元素.
| 参数 | 描述 |
|---|---|
Elemento alvo |
要滚动的元素的 CSS/XPath 选择器(空 = 整页) |
Rolagem horizontal (px) |
正=右,负=左 |
Rolagem vertical (px) |
正=下降,负=上升 |
Rolar para visualização |
滚动直到目标元素在屏幕上可见 |
Rolagem suave |
使用滚动动画而不是瞬时动画 |
Incrementar |
添加到当前位置而不是转到绝对位置 |
滚动模式
绝对位置与增量位置
不递增:滚动到输入的确切坐标(从左上角开始的 X/Y)。带增量:将值添加到当前位置。例如, +300px 从原来位置向下移动 300 像素。
滚动进入视图
自动滚动页面,直到目标元素在屏幕可见区域可见,而无需计算坐标。 Dablio Robô 自行发现元素的位置。
溢出元素
要在具有自己的滚动条(列表、表格、面板)的容器内滚动,请在字段中输入容器的 CSS/XPath 选择器 目标元素 而不是将其留空。
属性
从任何元素读取、设置或删除 HTML 属性。涵盖从标准属性(href、src、class)到自定义数据属性(data-id、data-value)。
从元素中读取、设置或删除 HTML 属性,例如 href、src、class、style、data-id 和任何其他自定义属性。
获取
读取属性值并将其保存在配置的变量中。例如:阅读 href 单击之前的链接,或 data-id 列表项的。
套装
动态修改 DOM 中的属性。例如:改变 src 图像的,禁用/启用按钮通过 disabled.
删除
从元素中完全删除属性——对于删除很有用 readonly 或 disabled 被封锁的字段。
| 参数 | 描述 |
|---|---|
Seletor |
目标元素的 CSS 或 XPath |
Ação |
获取值·设置值·删除属性 |
Nome do atributo |
例如:href、src、类、数据 ID、占位符 |
Salvar em variável |
将接收读取值的变量(“获取”操作) |
Valor a atribuir |
新的属性值。接受变量 |
Múltiplos |
将操作应用于所有找到的元素 |
disabled 或 readonly,将此块与操作一起使用 删除 在尝试填写表单块之前。最常用的属性
href— 链接 URL,对于在浏览之前捕获目的地很有用src— 图像、视频和脚本的路径value— 表单块无法修改的隐藏字段或输入的当前值data-id,data-*— 网站嵌入的标识符和元数据disabled,readonly——场地限制;使用 删除 解锁它们class,style— 元素的视觉控制
运行JS
将 JavaScript 直接注入并执行到页面(主世界上下文)或 Service Worker 中。它可以完全访问 DOM、流变量和扩展 API。
在页面(页面上下文)或后台(服务工作人员)执行 JavaScript。使用“return”将结果保存在流变量中。
页面上下文
该代码的执行就像页面自身 JavaScript 的一部分一样。它可以访问窗口、文档、全局页面变量和框架(React、Vue 等)。
背景语境
在 Service Worker 上运行,可以访问 Chrome API,例如 chrome.tabs、chrome.storage、chrome.downloads。它无权访问 DOM。
流量变量
使用 vars.minhaVariavel 阅读和 vars.minhaVariavel = 'valor' 写。使用 globals.varGlobal 用于流之间的全局变量。
返回
的价值 return 保存在配置的变量中 返回变量。支持对象、数组、数字和字符串。
| 参数 | 描述 |
|---|---|
Contexto |
在活动选项卡(页面)·后台(服务工作者) |
Tempo antes de executar (ms) |
注入代码之前等待 |
Código JS |
JavaScript 正在运行。可以访问 vars(流变量)和全局变量 |
Variável de retorno |
将接收“返回”值的变量 |
Executar em cada nova aba |
在打开的新选项卡上自动重新运行 |
Executar antes da página |
选项卡开始加载后立即注入 |
async/await — Dablio Robô 在继续流程之前等待 Promise 解决。// Lê variável do fluxo
const usuario = vars.nomeUsuario;
// Manipula DOM
document.querySelector('#campo-login').value = usuario;
// Faz uma requisição assíncrona
const resp = await fetch('/api/verificar?user=' + usuario);
const dados = await resp.json();
// Salva resultado no fluxo
vars.usuarioAtivo = dados.ativo;
// Retorna para variável configurada
return dados.ultimoAcesso;
代码中可用的实用函数
vars — 读取和写入流变量
使用 vars.nomeVar 阅读和 vars.nomeVar = valor 记录。更改的变量在流程的所有后续块中都可用。
globals - 跨流的全局变量
使用 globals.nomeVar 访问多个流之间共享的变量。对于自动化的配置、令牌或全局状态很有用。
return — 将值返回给变量
返回的值 return 保存在字段中配置的变量中 返回变量。支持任何类型:字符串、数字、对象或数组。
async/await 直接在块代码中。该流程会自动等待 Promise 解决后再继续。触发事件
触发页面元素上的 DOM 事件,模拟其他块未涵盖的交互。对于仅响应本机 JavaScript 事件的系统至关重要。
触发页面元素上的 DOM 事件:鼠标、键盘、表单、剪贴板、触摸等,并具有高级修饰符和坐标选项。
鼠标事件
click, dblclick, mousedown, mouseup, mouseover, contextmenu。配置按钮(左/右/中)和修饰键(Ctrl、Shift、Alt)。
键盘事件
keydown, keyup, keypress。配置 key, code 和 keyCode 准确地模拟特定的按键。
表单事件
input, change, focus, blur, submit。对于强制字段重新验证或触发与值更改相关的 JavaScript 逻辑很有用。
多个
按顺序在选择器找到的所有元素上触发事件。
| 参数 | 描述 |
|---|---|
Seletor |
将接收事件的元素的 CSS 或 XPath |
Evento |
鼠标:单击/双击/鼠标向下/鼠标悬停 · 键盘:keydown/keyup/keypress · 表单:输入/更改/聚焦/模糊/提交 · 剪贴板:复制/剪切/粘贴 · 触摸 · 滚动 · 调整大小 |
Botão do mouse |
左·中·右 |
Modificadores |
CTRL·SHIFT·ALT·元 |
Múltiplos |
拍摄找到的所有元素 |
Opções avançadas |
气泡、可取消、坐标、键、keyCode、deltaX/Y |
input 通过 JavaScript 填写值后。何时使用此块
现代框架(React、Vue、Angular)
这些框架通过内部状态控制输入——直接填充字段不会触发更新。通过 Form 或 JavaScript 块填写值后,触发事件 input 或 change 迫使框架认识到变化。
隐藏的验证和侦听器
某些站点仅在发生特定事件时才执行验证或加载新字段。使用此块以编程方式触发此行为。
悬停
模拟悬停在页面元素上(鼠标悬停/悬停),显示仅当光标悬停在元素上时才会出现的下拉菜单、工具提示和内容。
模拟将鼠标悬停在页面元素上(鼠标悬停/悬停事件),对于显示菜单、工具提示和动态内容很有用。
典型用法
悬停时展开的导航菜单;嵌套子菜单;带有额外信息的工具提示;将鼠标悬停在表格行上时出现的操作按钮。
| 参数 | 描述 |
|---|---|
Seletor |
目标元素的 CSS 或 XPath |
Aguardar seletor |
等待元素出现后再模拟悬停 |
使用案例
- 显示仅在悬停时出现的下拉菜单
- 显示带有额外信息的工具提示
- 在表格行上显示操作按钮(编辑、删除)
- 启用显示内容的 CSS 动画
拖动元素
模拟拖放页面元素的操作。对于与看板、列表排序、滑块和编辑工具的接口非常有用。
使用位置、速度和按钮按下设置模拟将元素从 A 点拖动到 B 点。
人体模拟
Dablio Robô 将运动分为多个间隔可配置的中间步骤,模拟人类鼠标的自然运动而不是瞬移。
锚点
配置单击将在源元素上开始的位置(中心、角落)以及目标元素上将放置项目的位置。偏移允许对像素进行微调。
按下按钮
大多数拖放操作都使用左按钮。某些界面使用中间或右侧按钮 - 根据预期行为进行配置。
| 参数 | 描述 |
|---|---|
Botão pressionado |
无·左·右·中 |
Seletor de origem |
要拖动的元素 |
Seletor de destino |
项目将被放置的元素或区域 |
Ponto de origem/destino |
中心·左上/右上·左下/右下 |
Offsets X/Y |
出发地和目的地的额外旅行 |
Passos |
鼠标中间移动次数 |
Intervalo entre passos (ms) |
每个动作之间暂停以模拟人体阻力 |
Segurar antes de arrastar (ms) |
移动前需要按住按钮 |
mousedown → mousemove (várias vezes) → mouseup.发送文件
将文件上传到字段中 input[type=file],绕过浏览器不允许操作系统文件选择器直接自动化的限制。
通过URL/Base64、本地文件夹、绝对路径或模拟点击供用户手动选择上传文件。
URL 或 Base64
以公共 URL 或 Base64 字符串形式提供文件。 Dablio Robô 下载文件并将其直接注入到输入中,而无需打开系统选择器。
本地文件夹
选择计算机上之前授权的文件夹并输入文件名。 Dablio Robô 会自动读取并注入它。
绝对路径
提供文件的完整路径(C:\Users\arquivo.pdf 或 URL)。需要扩展设置中的本地文件访问权限。
手册
单击上传按钮并暂停 - 用户手动选择文件。选择后流程继续。
| 参数 | 描述 |
|---|---|
Seletor |
来自输入的 CSS 或 XPath[type=file] |
Aguardar seletor |
等待输入出现 |
Múltiplos |
填写所有找到的上传字段 |
Origem do arquivo |
手册 · URL/Base64 · 本地文件夹 · 绝对路径 |
支持的文件源
公共 URL 或 Base64
Dablio Robô 从 URL 下载文件或解码 Base64 并直接注入到字段中 input[type=file] 无需打开操作系统选择器。
本地文件夹
选择计算机上的一个文件夹(浏览器会询问一次权限)。输入此文件夹中的文件名称 - 接受动态名称变量。
绝对路径
输入文件的完整路径(例如: file:///C:/Users/arquivo.pdf)。需要扩展设置中文件 URL 的访问权限。
手动(点击按钮)
机器人只是单击上传按钮并暂停。将出现一条通知,要求用户手动选择文件。选择后流程将恢复。
按键
模拟按键和键盘快捷键,或通过可配置的计时逐个按键输入完整的文本。
按键盘快捷键(例如 CTRL+S)或逐键键入文本,可选择将焦点放在目标元素上。
按快捷键
执行 Ctrl+S(保存)、Ctrl+A(全选)、F2(重命名)、Enter、Escape、Tab 等组合。使用快捷方式记录器捕获所需的组合。
输入文字
逐个字符输入文本,按键之间的时间可配置。与直接设置值的 Form 块不同,这个块模拟真实的输入。
目标元素
配置后,Dablio Robô 聚焦于每个按键之前的元素 - 确保即使焦点发生变化,按键也会发送到正确的元素。
| 参数 | 描述 |
|---|---|
Ação |
按快捷键·输入文字 |
Tecla/combinação |
例如:CTRL+SHIFT+1、ALT+Q(使用快捷方式录音器) |
Tempo de pressão (ms) |
按键会被按下多长时间 |
Texto para reproduzir |
将逐键键入的文本 |
Target element |
将在每个键之前接收焦点的元素的选择器 |
常用快捷键
Enter— 确认表格和对话框Tab— 在字段之间导航Escape— 关闭模式和菜单Ctrl+A— 选择全部Ctrl+C/Ctrl+V— 复制并粘贴F2— 进入编辑模式(Excel、桌面应用程序)Delete/Backspace— 删除选定的内容
Alt+F4 或 Ctrl+Alt+Del 无法通过扩展来模拟。创建 HTML
将自定义 HTML、CSS 和 JavaScript 直接注入到页面中相对于目标元素的位置。允许您直观地扩展任何网站,而无需修改其代码。
将 HTML、CSS 和 JavaScript 代码插入到页面中与目标元素相关的特定位置。
插入位置
第一个/最后一个孩子:内部元素; 前一个/后一个兄弟姐妹:在元素旁边; 更换:将元素与注入的内容交换。
标签脚本
标签 <script> 包含在 HTML 中的代码在注入后立即执行。非常适合向页面添加 JavaScript 逻辑。
加载前运行
将内容注入到事件中 loading 在页面完成加载之前,选择选项卡的 - 以覆盖原始脚本或样式。
| 参数 | 描述 |
|---|---|
Elemento alvo |
参考元素的 CSS 或 XPath |
Posição |
作为第一个子元素 · 作为最后一个子元素 · 上一个兄弟元素 · 下一个兄弟元素 · 替换元素 |
Executar antes do carregamento |
在页面加载开始时注入 |
HTML/CSS/SCRIPT |
要插入的代码。 <script>标签将被执行 |
<div style='position:fixed;bottom:20px;right:20px;z-index:9999;background:#1a6eff;color:white;padding:12px 20px;border-radius:8px;cursor:pointer;font-family:sans-serif;box-shadow:0 4px 20px rgba(26,110,255,0.4)' onclick='window.__dablioExportar()'>💾 Exportar Dados</div>
<script>
window.__dablioExportar = function(){
window.dispatchEvent(new CustomEvent('dablio-export'));
};
</script>
元素存在
检查页面的 DOM 中是否存在某个元素,并在完成之前可配置多次重试。返回 存在 或 后备.
在通过成功或回退端口之前,通过多次尝试检查页面上是否存在某个元素。
尝试
每次尝试都会在重复之前等待配置的时间间隔。如果该元素出现在任何尝试中,它会立即沿着路径返回 存在.
在循环中使用
在循环开始时使用来检查是否仍有项目需要处理。当元素不再存在时(例如“下一页”按钮),循环通过回退自然结束。
| 参数 | 描述 |
|---|---|
Seletor |
要检查的元素的 CSS 或 XPath |
Número de tentativas |
多少次检查才得出不存在的结论 |
Intervalo (ms) |
每次验证尝试之间的时间 |
块输出
输出存在(找到元素)
当元素在配置的尝试次数内位于 DOM 中时,流程将遵循此路径。 Dablio Robô 在第一次成功尝试后返回,无需等待其他尝试。
回退输出(未找到)
当所有尝试都用尽而未找到该元素时,流程将遵循此路径。用于处理替代方案:跳过步骤、尝试不同的操作或结束循环。
打开链接
读取属性 href 链接元素并导航到目的地 - 比直接单击更强大,因为它不依赖于链接的 CSS 或 JavaScript 行为。
读取元素的 href 属性并导航到同一选项卡、新选项卡或新窗口中的链接。
在当前页面上
在选项卡本身内导航,相当于设置 window.location.href。
新标签页
在新选项卡中打开链接。激活 设置为活动选项卡 以便流程在新选项卡中继续。
新窗口
在带有类型选项(正常/弹出)和初始状态的单独窗口中打开。
| 参数 | 描述 |
|---|---|
Seletor |
元素的 CSS 或 XPath 或带有链接的容器 |
Como abrir |
当前页面·新标签·新窗口 |
Tipo de janela |
正常 · 弹出窗口(无选项卡) |
Aguardar elemento |
等待元素出现 |
Salvar identificação |
保存名称以引用选项卡/窗口 |
文件存在吗?
在尝试处理文件之前检查本地文件夹中是否存在文件,以防止依赖外部文件的流程中出现错误。
检查选定的本地文件夹中是否存在文件。支持按精确名称、基本名称或正则表达式进行搜索。
按确切名称搜索
如果名称包含扩展名(例如report.pdf),则搜索是准确的。如果没有扩展名,则搜索具有该基本名称的任何文件,无论扩展名如何。
通过正则表达式搜索
允许高级模式: ^fatura_\d{8}\.pdf$ 查找姓名中带有日期的发票; .*\.xlsx$ 查找任何 Excel 电子表格。
| 参数 | 描述 |
|---|---|
Pasta Local |
将在其中搜索文件的文件夹 |
Nome do arquivo |
确切名称、基本名称(无扩展名)或正则表达式模式 |
Usar Regex |
将字段解释为正则表达式 |
有条件的
比较两个值并将流程引导至路径的决策块 真实 或 错误.
比较两个值并沿着 True 或 False 路径引导流程。支持文字值、变量、元素文本、HTML 属性和 JavaScript 代码。
基本运算符
等于(==): 不区分大小写。 平等(SM): 敏感。 不同(!=).
数字运算符
大于、小于、大于或等于、小于或等于 — 值会自动转换为数字。
文本运算符
包含、不包含(不敏感/敏感)、开始于、结束于。
正则表达式
对照第二个值的正则表达式测试第一个值。例如:检查 CPF 格式、电子邮件、日期。
DOM元素
检查页面元素的存在性、可见性(在 DOM 和视口中)或属性值 - 无需单独的选择器。
JavaScript 代码
第一个值可以是一段 JS 代码,它为任意复杂的逻辑返回 true/false。
| 参数 | 描述 |
|---|---|
Tipo do 1º valor |
文字值·变量存在·变量值·JS代码·文本/属性/元素可见性 |
Operador |
等于 · 不等于 · 大于/小于(大于) · 大于/小于或等于 · 包含 · 不包含 · 开头/结尾为 · 正则表达式 |
Tipo do 2º valor |
值·变量·元素文本/属性 |
Sensível a maiúsculas |
SM 版本的运算符区分大小写 |
return vars.x > 10 && vars.status === 'ativo';可用的运营商
- 等于(==) — 不区分大小写的比较。 “约翰”==“约翰”→ true。
- 平等(敏感) — 精确比较,区分大小写。
- 包含/不包含 — 检查第一个值是否包含第二个值。
- 开始于/结束于 — 检查文本的前缀或后缀。
- 最大/最小/≥/≤ ——数值比较。值会自动转换为数字。
- 正则表达式 — 根据正则表达式测试第一个值。示例:
^\d{3}\.\d{3}\.\d{3}-\d{2}$验证公积金。 - 元素存在/可见 — 检查页面上选择器的存在或可见性,没有第二个值。
- JS代码 — 执行 JavaScript 代码,为任意逻辑返回 true/false。
return vars.x > 10 && vars.status === 'ativo';循环遍历元素
迭代选择器找到的所有元素,为每个元素执行内部块。相当于 forEach 在网络自动化领域。
循环遍历所有出现的 CSS/XPath 选择器,为找到的每个元素执行内部块。
循环标识符
每个元素接收属性 wRobo-loop='nome_N' (其中 N 是索引)。使用选择器 [wRobo-loop='nome_0'] 在循环内专门与当前元素交互。
最大出现次数
限制迭代次数——当页面有数百个元素但您只想处理前 N 个元素时很有用。
颠倒顺序
从下到上处理元素 - 当删除项目或分页影响索引时是必要的。
| 参数 | 描述 |
|---|---|
Seletor |
返回元素列表的 CSS 或 XPath |
Aguardar elemento |
等待元素出现 |
Inverter ordem |
从最后一个元素开始到第一个元素 |
Máximo de ocorrências |
限制迭代次数(0 = 全部) |
Identificador personalizado |
向每个元素添加 wRobo-loop 属性以引用它 |
table tbody tr)并在循环内选择单元格([wRobo-loop='linha_N'] td:nth-child(2)) 访问每一列。循环标识符
Dablio Robô 自动添加属性 wRobo-loop 在循环期间遇到的每个元素。在内部块上使用此属性可以专门与当前元素交互:
table tbody tr 并在循环内访问列 [wRobo-loop="linha_N"] td:nth-child(X).重复任务
重复内部块固定次数。相当于一个循环 for(i=0; i<N; i++).
重复内部块一定次数。
自动计数器
Dablio Robô 自动注入变量 {{loopIndex}} 与每次迭代中的当前索引(从 0 开始)。
中断与停止重复
使用块 停止重复 当满足条件时,在完成所有迭代之前退出循环。
| 参数 | 描述 |
|---|---|
Repetir quantas vezes |
循环迭代次数 |
https://site.com/lista?page={{pagina}}.自动索引变量
Dablio Robô 自动注入变量 {{loopIndex}} 在每次迭代中,从 0。用于根据当前迭代构建动态 URL、文件名或条件逻辑:
浏览数据
迭代数据列表:变量数组、数值范围或自定义 JSON 数据。当前项目可通过配置的变量访问。
迭代列表(变量数组、序列号或 JSON 数据),重复每个项目的内部块。
来源:变量
迭代保存在变量中的数组(例如电子邮件列表、CNPJ 列表)。当前项目变量可通过以下方式访问 {{loopItem}}.
资料来源:数字
生成从开始值到结束值的整数序列。 {{loopItem}} 包含当前号码。
来源:JSON
迭代直接在块中定义的 JSON 数组。每个项目都是一个具有配置属性的对象。
首页索引
跳过前 N 项 — 对于恢复中断的处理很有用。
| 参数 | 描述 |
|---|---|
Fonte de dados |
变量·数字·JSON |
ID do loop |
将接收当前项目的变量的名称(例如:{{loopItem}}) |
Do número / Até o número |
“数字”模式的范围 |
Dados JSON |
JSON 模式的 [{key, value}] 格式的 JSON |
Inverter ordem |
从列表中的最后一项开始 |
Índice inicial |
从给定索引开始 |
Máximo de ocorrências |
限制迭代次数(0 = 全部) |
支持的数据源
变量(数组)
迭代保存在流变量中的数组。当前商品有售 {{loopItem}} 和索引 {{loopIndex}} 循环内。
数值范围
生成从开始值到结束值的数字序列。非常适合浏览编号页面或通过索引控制重复 N 次。
自定义 JSON
直接在块中定义 JSON 数组。每个项目可以是具有多个属性的对象,在循环中访问为 {{loopItem.propriedade}}.
停止重复
立即中断最近的循环(重复任务、遍历数据或遍历元素)并在循环块之后继续流程。
立即停止最近的循环或重复(重复任务、循环数据或循环元素)。
与条件一起使用
与块结合 有条件的 当满足条件时退出循环,例如“如果价格大于 X,则停止搜索”。
停止重播和停止流之间的区别
- 停止重复 — 仅中断最近的循环。循环块之后流程正常继续。
- 停止流动 — 结束整个流(或其他流)的执行。仅当您想要完成所有事情时才使用。
输入数据
最直接的变量创建块:设置变量的值,将数据添加到流表中,或从文件中读取内容。
填充变量、流表或本地存储表。接受手册文本、变量和文件内容。
变量
设置或覆盖变量的值。数据字段接受自由文本、插值变量({{nome}}) 和表达式。
流量表
将一行数据添加到指定的表中,一次一列。组合多个插入数据块以构建完整的记录。
报告文件
读取本地文件或 URL 的内容并将其存储在变量中。支持二进制文件的纯文本和 Base64 转换。
| 参数 | 描述 |
|---|---|
Aplicar em |
变量·流表·存储表 |
Nome da variável |
目标变量(变量模式) |
Dados |
要插入的内容。接受变量 {{var}} |
Informar arquivo |
从本地文件或 URL 读取内容 |
Formato |
模式(文本)·转换为 Base64 |
vars.objeto = {id: vars.id, nome: vars.nome};可用目的地
流量变量
创建或替换变量的值。接受自由文本、插值变量 {{var}} 以及任何类型的数据:字符串、数字、数组或 JSON 对象。
流量表
将一行数据添加到流的内部表(逐列)。使用多个块 输入数据 在使用块导出之前按顺序构建完整记录 导出数据.
本地文件(URL 或路径)
读取计算机文件或公共 URL 的内容并将其存储在变量中。激活 转换为 Base64 适用于 PDF 和图像等二进制文件。
设置数据
从现有变量中转换和提取数据:字符串切片、按内容类型和正则表达式提取。
创建、更新部分内容或将部分内容提取到新变量中。支持文本/数据切片、按类型和正则表达式提取。
文本切片
按位置提取子字符串:字符索引中的开始和结束。例如:提取邮政编码的前 4 位数字(0 到 4)。
数据切片
对于数组和对象,按索引提取。例如:从列表中选择前 3 项。
提取数字/文本
仅过滤字符串中的数字或字母字符。对于清除 CPF/CNPJ/电话号码很有用。
正则表达式
提取与模式匹配的文本。激活 多个 以数组形式返回所有出现的情况。激活 更换 替换而不是提取。
| 参数 | 描述 |
|---|---|
Valor/Conteúdo |
源文本或变量 {{var}} |
Tratamento |
无·从文本(切片)中提取索引·从数据中提取索引·提取数字·提取文本·正则表达式 |
Início / Final |
切片操作的位置 |
RegEx |
用于提取或替换的正则表达式 |
Substituir |
替换找到的片段而不是提取 |
Nome da variável |
将接收结果的变量 |
123.456.789-09 → 12345678909),使用治疗 仅提取数字.可用的文本处理
文本切片(索引提取)
按字符位置提取子字符串。索引 0 = 开始,负索引 = 从结束开始。示例:提取日期的前 8 位数字 20240115 → 索引 0 到 4 返回 2024.
仅提取数字
删除所有非数字字符。可用于清除 CPF、CNPJ、电话号码和邮政编码: 123.456.789-09 → 12345678909.
正则表达式(RegEx)
使用模式提取或替换部分文本。激活 多个 以数组形式返回所有出现的情况。激活 更换 将找到的模式与另一个文本交换。
增量变量
将变量的数值增加或减少配置的量。用于创建计数器的最简单的块。
将变量的数值增加或减少给定值。
循环计数器
创建一个变量 pagina 值为 1 并在每次迭代时递增 1 以浏览编号的页面。
负值
要递减,请配置一个正值 — Dablio Robô 始终会将此值添加到当前值。要进行减法,请使用块 计算器.
| 参数 | 描述 |
|---|---|
Variável |
要递增的变量名称 |
Valor incremento |
要添加的值(正)或减去的值(负) |
用作循环计数器
浏览编号页面的经典模式:
删除数据
从流内存中删除变量。对于释放长流中的空间或确保变量不携带先前迭代中的值非常有用。
在流程执行期间从内存中删除变量或数据。
嵌套路径
支持点符号从对象中删除属性: usuario.senha 仅从用户对象中删除密码字段。
| 参数 | 描述 |
|---|---|
Dados de |
变量·表 |
Nome da variável |
要删除的变量。支持嵌套路径(例如:obj.campo) |
嵌套路径
使用点表示法仅从对象中删除一个属性,而不删除整个对象:
usuario— 删除变量 用户 完全usuario.senha— 仅删除字段 密码 物体的 用户lista.0— 从数组中删除第一项 列表
计算器
✦ 独家执行数学计算,支持巴西业务场景的专用函数,包括雷亚尔 (BRL) 货币格式。
使用标准运算符和专用函数执行数学计算,包括巴西货币转换。
基本运算符
+ 总和, - 减法, * 乘法, / 分部, ^ 电源, % 模块(该部门的剩余部分)。
舍入函数
Calc.arredonda(valor, casas) — 标准数学舍入。 Calc.arredondaBaixo - 总是向下(地板)。 Calc.arredondaCima — 始终向上(天花板)。
货币功能
Calc.valorBRL(1500.5, 2) → '1.500,50' — 将数字格式化为巴西标准。 Calc.valorUSD('1.500,50', 2) → 1500.50 — 将 BRL 文本转换为数字。
统计功能
Calc.max(a, b, c...) — 参数中的最高值。 Calc.min(a, b, c...) — 较低的价值。
| 参数 | 描述 |
|---|---|
Expressão matemática |
例如:Calc.max({{v1}}, {{v2}}, 50) + 10.50 |
Funções disponíveis |
Calc.max · Calc.min · Calc.rounded · Calc.roundedBow · Calc.roundedUp · Calc.removeDecimals · Calc.turnPositive · Calc.rootSquare · Calculation.power · Calc.random · Calc.sine · Calc.cosine · Calc.tangent · Calc.logarithm · Calc.valueBRL · Calc.valueUSD |
Variável de retorno |
将接收结果的变量 |
Casas decimais |
最终结果的四舍五入 |
Calc.max({{preco1}}, {{preco2}}, {{preco3}})。变量在计算之前被替换。// Calcular valor com desconto e formatar em BRL
Calc.valorBRL({{valor}} * (1 - {{desconto}} / 100), 2)
// Calcular juros compostos
Calc.arredonda({{principal}} * Calc.potencia(1 + {{taxa}}/100, {{meses}}), 2)
// Maior entre dois preços e aplicar margem
Calc.max({{precoA}}, {{precoB}}) * 1.15
转换数据
✦ 独家数据转换中心:文件格式、数据类型和文本表示之间的转换。
多格式转换器:文件和 URL 转换为 Base64、JSON 解析/字符串化、文本转换为数字/整数、日期格式和 Base64 解码。
文件 → Base64
将文件从公共 URL、本地文件夹或绝对路径转换为 Base64 字符串,准备通过 API、WhatsApp 或电子邮件发送。
JSON 解析/字符串化
将 JSON 字符串转换为 JavaScript 对象(解析)或将对象转换为 JSON 文本(字符串化)。在收到来自 API 的文本响应后使用。
文本 → 数字
将“42.5”或“1,234.56”(BRL 格式)等字符串转换为数字。在计算中使用值之前需要。
设置日期格式
将时间戳或 ISO 日期转换为配置的格式: DD/MM/YYYY, YYYY-MM-DD HH:mm:ss等
解码 Base64
将 Base64 字符串转换回文本。对于读取从 API 以 Base64 形式接收的文件内容非常有用。
| 参数 | 描述 |
|---|---|
Tipo de conversão |
文本→Base64 · URL→Base64 · 本地文件→Base64 · 绝对路径→Base64 · 文件(输入)→Base64 · 对象→文本 · JSON 解析 · JSON 字符串化 · 文本→数字 · 文本→整数 · 格式化日期 · 解码 Base64 |
Conteúdo/Variável |
待转换数据 |
Origem do arquivo |
对于文件转换:本地文件夹、URL、绝对路径 |
Formato de data |
输出掩码:YYYY、MM、DD、HH、mm、ss |
Variável de retorno |
将接收结果的变量 |
Calc.valorBRL().使用 WA-JS 库与 WhatsApp Web 完全集成。没有付费 API,没有强制性的企业帐户 - 适用于在浏览器中激活 WhatsApp Web 的任何号码。
使用 WA-JS 或手动模式通过 WhatsApp Web 发送自动消息。支持文本、图像、视频、音频、文档和状态发布。
检查 WhatsApp
确认 WhatsApp Web 已登录。可以选择验证连接的帐户是否为配置的号码 - 确保机器人从正确的帐户发送。
发送文本(WA-JS模式)
通过 WA-JS 直接向指定收件人发送消息(带有区号 + 55 的号码,例如 5511999999999)。 WhatsApp 可以打开或在后台运行。
发送文本(手动模式)
打开带有 URL 的临时弹出窗口 web.whatsapp.com/send?phone=...,单击发送按钮并关闭窗口。当 WA-JS 不可用时的后备。
发送文件
支持图像、视频、音频和文档。该文件可以来自公共 URL、Base64、本地文件夹或绝对路径。接受自定义标题和名称。
单视图
对于图像:作为单视图消息发送 - 收件人在消失之前只能看到一次。类似于应用程序的本机功能。
状态
在 WhatsApp 状态(故事)上发布内容。支持带有背景颜色的文本和带有标题的图像。
| 参数 | 描述 |
|---|---|
Ação |
检查 WhatsApp · 发送文本 · 发送图像 · 发送视频 · 发送音频 · 发送文档 · 文本状态 · 图像状态 |
Destinatário |
带区号的电话(例如:5511999999999)或 chatId (@c.us) |
Mensagem |
要发送的文本。接受变量 {{var}} |
Origem do arquivo |
URL/Base64 · 本地文件夹 · 绝对路径 · 本地文件 |
Visualização única |
发送单视图图像(查看后消失) |
Mensagem de voz |
以语音消息而不是文件的形式发送音频 |
Abrir/Fechar/Focar WhatsApp |
控制 WhatsApp 网页选项卡 |
Verificar conta |
确认连接的帐户与输入的号码匹配 |
脸书
✦ 独家Facebook 身份验证验证和自动化。通过会话 cookie 和页面 DOM 检测登录状态。
检查 Facebook 是否在浏览器中登录,并自动使用电子邮件/电话和密码登录。
登录验证
分析 cookie (c_user)、界面元素和 URL 来准确判断用户是否通过身份验证。
自动登录
填写电子邮件和密码字段,然后单击输入。当检测到多个帐户时支持“使用另一个配置文件”流程。
| 参数 | 描述 |
|---|---|
Ação |
验证 Facebook · Facebook Graph API |
Fazer login |
如果未登录则执行自动登录 |
E-mail/Telefone |
访问凭据。接受变量 |
Senha |
脸书密码。接受变量 |
Aguardar após entrar (ms) |
验证前登录完成的时间 |
Abrir Facebook |
请勿打开·新窗口·新标签 |
使者
✦ 独家Messenger Web 中的身份验证和自动化。包括处理对话历史记录恢复 PIN 模式。
检查Messenger是否登录,执行自动登录,支持聊天记录恢复PIN。
重置密码
当 Messenger 要求输入 PIN 码来恢复加密的聊天历史记录时,WROBOBRANDOONE 可以通过单击“继续而不恢复”来自动进入或关闭模式。
| 参数 | 描述 |
|---|---|
Ação |
检查 Messenger · Messenger Graph API |
Fazer login |
如果未登录则执行自动登录 |
E-mail/Telefone / Senha |
访问凭证 |
PIN |
历史恢复 PIN(如果需要) |
Abrir Messenger |
请勿打开·新窗口·新标签 |
Instagram Web 上的身份验证和自动化。通过会话 cookie 检测登录(sessionid)和界面元素。
检查 Instagram 是否已登录浏览器并自动使用电子邮件/用户名/电话号码和密码登录。
登录后
成功登录后,Dablio Robô 自动处理“保存登录信息?”单击“现在不”,避免流程阻塞。
| 参数 | 描述 |
|---|---|
Ação |
验证 Instagram · Instagram Graph API |
Fazer login |
如果未登录则执行自动登录 |
E-mail/Telefone / Senha |
访问凭证 |
Abrir Instagram |
请勿打开·新窗口·新标签 |
电报
✦ 独家Telegram Web 上的身份验证检查。分析 localStorage 和 cookie 以确定登录状态并验证帐户电话号码。
检查 Telegram Web 是否已登录,并可选择验证特定电话号码。
号码验证
输入电话号码以检查连接到 Telegram Web 的帐户是否匹配。支持多种格式:带国家代码、不带国家代码等。
| 参数 | 描述 |
|---|---|
Telefone |
要检查的号码(例如:559912345678)。接受变量 |
Aguardar após login (ms) |
页面加载时间 |
Abrir Telegram |
请勿打开·新窗口·新标签 |
谷歌表格
与 Google Sheets 直接集成,用于在电子表格中读取和写入数据。
通过 API 集成读取数据或将数据写入 Google Sheets 电子表格。
读取数据
将一系列单元格中的数据作为数组返回,以便在流中进行处理。
追加
将新行添加到工作表末尾,而不覆盖现有数据。
| 参数 | 描述 |
|---|---|
ID da planilha |
从电子表格 URL 中提取的 ID |
Range |
单元格范围(例如:A1:D10) |
Modo |
读取·追加(添加行) |
需要身份验证
可用操作
读取数据
将一系列单元格中的数据作为数组返回,以便在后续块中使用。结合与 浏览数据 逐行处理。
添加(追加)
在电子表格末尾插入新行,而不覆盖现有数据。非常适合随着时间的推移积累刮擦结果。
OCR:读取图像
与 Google Cloud Vision API 集成,用于 OCR(图像中的文本识别)和其他计算机视觉分析。
将图像发送到 Google Cloud Vision API 以进行 OCR、标签、物体、面部、徽标检测和安全分析。
简单与简单 OCR 文档
简单 OCR 适用于文本稀疏的图像。 OCR 文档针对表格、扫描的 PDF 和发票等密集文档进行了优化。
其他类型的检测
标签(对象分类)、人脸检测、公司徽标、旅游景点、安全搜索(不当内容)和网页检测(反向搜索)。
结果
对于 OCR,以字符串形式返回提取的文本。对于其他类型,从 API 返回完整的 JSON 以使用块进行处理 设置数据.
| 参数 | 描述 |
|---|---|
API Key |
谷歌云视觉 API 密钥 |
Origem do arquivo |
手册 · URL/Base64 · 本地文件夹 · 绝对路径 |
Tipo |
简单 OCR · 文档 OCR · 标签 · 物体 · 人脸 · 徽标 · 安全搜索 · 网页检测... |
Máx. resultados |
最大检测结果数 |
Variável de retorno |
对于OCR,保存提取的文本;对于其他类型,保存完整的 JSON |
谷歌文档人工智能
✦ 独家使用 Google Cloud Document AI 进行高级文档处理。使用专门的处理器从发票、合同、身份和表格中提取结构化字段。
将文档(PDF 或图像)发送到 Google Cloud Document AI,以便使用配置的处理器进行高级处理。
处理器
每个处理器都针对一种类型的文档进行了培训。在 WROBOBRANDOONE 中使用之前,请在 Google Cloud Console 中创建和配置。
访问令牌
与 Vision API 不同,Document AI 需要 OAuth 2.0 身份验证(而不是 API 密钥)。使用通过 Google Auth 获取的 Bearer 令牌。
结果
对于 OCR,返回全文。对于表单解析器和发票解析器,返回带有提取字段及其值的结构化 JSON。
| 参数 | 描述 |
|---|---|
Access Token (OAuth) |
具有文档 AI 权限的令牌承载 OAuth 2.0 |
Project ID |
Google Cloud 中的项目 ID |
Location |
我们·我 |
Processor ID |
在 Document AI 控制台中创建的处理器 ID |
Processor Version |
特定处理器版本(可选) |
Origem do arquivo |
手册 · URL/Base64 · 本地文件夹 · 绝对路径 |
MIME Type |
应用程序/pdf 图像/png 图像/jpeg |
Variável de retorno |
对于 OCR,保存文本;对于解析器,保存 JSON |
N8N
✦ 独家与 N8N 双向集成,以触发更复杂的自动化流程或与 N8N 上提供的数百个连接器集成。
通过 webhook 运行现有流程,或在 N8N 上创建并运行新流程,并可选择在使用后自动删除它。
运行现有流程
将 HTTP 请求发送到已在 N8N 上创建和配置的流的 Webhook。按照 Webhook 的预期配置方法、标头和正文。
创建并运行流程
通过 API 在 N8N 中创建一个新流,激活它,触发 webhook 并可选择在执行后删除该流。非常适合临时或动态流动。
等待返回
Dablio Robô 等待 N8N 的响应后再继续。根据N8N上预计的流量持续时间配置超时。
| 参数 | 描述 |
|---|---|
Modo |
运行 N8N 流(webhook) · 在 N8N 中创建新流 |
URL do webhook |
现有流的完整 URL |
Método HTTP |
获取·发布·放置·修补·删除 |
Cabeçalhos/Body |
请求标头和正文 |
Aguardar retorno |
暂停直播直至 N8N 响应 |
JSON do novo fluxo |
N8N导出的JSON用于创建流程(创建模式) |
Executar fluxo criado |
创建后触发 webhook |
Manter salvo no N8N |
如果未选中,则执行后删除流 |
Salvar retorno |
将接收响应的变量 |
发送电子邮件
通过服务器上配置的后端 API 发送电子邮件。支持 HTML、内容中的多个收件人和流变量。
通过配置的后端 API 发送电子邮件,支持 HTML 和多个收件人。
正文中的 HTML
消息字段接受完整的 HTML — 用于创建采用表格、图像、内联样式和可单击链接格式化的电子邮件。
多个收件人
在抄送字段中,用逗号分隔电子邮件,以便同时复制给多个收件人。
| 参数 | 描述 |
|---|---|
De (remetente) |
发件人电子邮件(必须与后端帐户匹配) |
Para (destinatário) |
收件人电子邮件 |
Cc |
复制 — 多封电子邮件,以逗号分隔 |
Assunto |
电子邮件主题。接受变量 |
Mensagem |
HTML 或文本形式的电子邮件正文。接受变量 |
<p>Total processado hoje: <strong>{{total}}</strong></p>人工智能
✦ 独家与主要提供商的人工智能模型集成。非常适合分类、摘要、信息提取、文本生成和基于内容的决策。
与 AI 模型集成:ChatGPT (OpenAI)、DeepSeek 和 Gemini (Google)。配置智能响应的上下文、要求和提示。
OpenAI (ChatGPT)
GPT-5、GPT-4.1 型号和变体。使用 要求 作为定义 AI 角色和上下文的系统提示,以及 提示 来处理要处理的内容。
深度搜索
V3.1(标准)和V3.1-Think(扩展推理)模型。葡萄牙语文本分析任务具有出色的成本效益。
谷歌双子座
2.5 Flash 和 Pro 型号。闪存速度更快、更经济; Pro 更能胜任复杂任务。
用例:提取
配置 要求 比如:“你是一个数据提取者。仅返回 JSON,不带 Markdown 格式。' — 该块将 JSON 保存到变量中以供立即使用。
| 参数 | 描述 |
|---|---|
Fornecedor |
OpenAI (ChatGPT) · DeepSeek · 谷歌 (Gemini) |
Modelo |
GPT-5/4.1/o3 · DeepSeek-V3.1 · Gemini 2.5 flash/pro |
Requisitos/Contexto |
定义人工智能角色和行为的系统指令 |
Prompt |
要处理的问题或内容。接受变量 {{var}} |
Variável de resposta |
将接收 AI 响应的变量 |
Analise o seguinte texto e extraia o valor total da fatura: {{textoCapturado}}窗户
✦ 独家独有的 Dablio Robô 块可将自动化扩展到 Windows 操作系统级别,控制浏览器之外的任何桌面应用程序。
将自动化命令发送到 Windows 上安装的本地主机。除了浏览器之外,您还可以控制操作系统:鼠标、键盘、窗口、进程、屏幕 OCR、PowerShell 等等。
移动并单击
以绝对屏幕坐标控制鼠标光标。与模式一起使用 捕获位置 发现遗留系统中元素的坐标。
输入文字
模拟在系统中的任何活动窗口或字段中进行键入。它适用于 ERP、终端、Java 应用程序、没有 API 的遗留系统。
窗口/进程存在吗?
按标题(支持正则表达式)或进程名称(.exe)检查。如果启用则返回窗口坐标 返回坐标.
在屏幕上查找元素(UI)
使用 Windows Accessibility API (UIAutomation) 查找界面元素。对于 Java 系统,启用 Java 访问桥 (JAB).
在屏幕上查找文本 (OCR)
捕获屏幕并使用光学字符识别来查找文本。它适用于任何应用程序,包括那些不公开辅助功能元素的应用程序。
电源外壳
运行具有完整系统访问权限的完整 PS1 脚本。结果(stdout)可以捕获在流变量中。
多重动作
定义一个包含多个按顺序操作的 JSON 数组:比在桌面系统上使用多个单独的块进行登录更有效。
| 参数 | 描述 |
|---|---|
Ação |
连接测试(Ping)·移动鼠标·单击·键入文本·按ENTER键·等待(睡眠)·滚动(滚动)·捕获位置·关闭计算机·取消关闭·窗口/进程存在吗? · 在屏幕上查找元素 (UI) · 在屏幕上查找文本 (OCR) · 打开/运行文件 · PowerShell · 多重操作 · 自定义命令 |
Coordenadas X/Y |
鼠标操作在屏幕上的位置 |
Botão do mouse |
左·右 |
Número de cliques |
单人、双人或个性化 |
Texto |
进入系统的文字 |
Título da janela |
用于识别窗口的文本或正则表达式 |
Nome do processo |
例如:SistemaXYZ.exe |
Usar JAB |
为 Java 应用程序启用 Java Access Bridge |
Aguardar retorno |
暂停流,直到收到主机的响应 |
Variável de retorno |
将接收来自主机的响应的变量 |
[
{"cmd":"move", "x":450, "y":320},
{"cmd":"click", "x":450, "y":320, "button":"left", "clicks":1},
{"cmd":"sleep", "ms":800},
{"cmd":"type", "text":"{{usuario}}"},
{"cmd":"type", "text":"\t"},
{"cmd":"type", "text":"{{senha}}", "enter":true}
]
验证码
✦ 独家完善的验证码管理:检测、等待手动解析或通过AI自动解析,成功率高。
检测页面上是否存在验证码,并等待手动或通过人工智能自动解决。支持市场上的主要类型。
自动检测
无需手动配置即可识别 reCAPTCHA v2/v3、hCaptcha、Cloudflare Turnstile、FunCaptcha、GeeTest、Amazon WAF、DataDome 等。
等待手动解决
将焦点放在选项卡上(将其置于最前面)并等待验证码从 DOM 中消失或响应令牌已填充。如有必要,将验证码坐标保存在变量中。
自动解析
自动检测页面上的必要参数(SiteKey、pageURL、User-Agent)。将其发送到 AI 服务并将响应令牌注入到正确的字段中。
自定义选择器
对于未映射的验证码:输入验证码元素的 CSS/XPath 选择器。该块会等待,直到选择器消失,或配置应出现的“已解析的验证码”选择器。
输出
真实:验证码已被检测并解决。 假的: 超时或未解决。 默认:页面上未检测到验证码。
| 参数 | 描述 |
|---|---|
Tipo |
自动(检测)·reCAPTCHA v2/v3·hCaptcha·Cloudflare Turnstile·FunCaptcha·GeeTest v3/v4·Amazon WAF·DataDome·CyberSiara·Imperva·MtCaptcha·Friendly·Tencent·Capy·CutCaptcha·Lemin·自定义 |
Tempo máx. espera (ms) |
等待手动解决的时间 |
Intervalo de verificação (ms) |
检查验证码是否仍然存在的频率 |
Focar aba quando detectar |
将选项卡向前显示以供用户解决 |
Resolver automaticamente |
使用人工智能,成功率高(需要学分) |
Timeout de resolução (seg) |
AI自动解析的最长时间 |
Parâmetros manuais |
SiteKey、pageURL、UserAgent 以及每种类型的特定字段 |
Salvar resposta |
将响应令牌保存到变量以供手动注入 |
PDF 到图像
✦ 独家直接在浏览器中使用 PDF.js 将 PDF 页面转换为 PNG 或 JPG 图像。对于从文档中提取图像或为 OCR 准备 PDF 很有用。
使用 PDF.js 将 PDF 的特定页面转换为 PNG 或 JPG 图像,并进行缩放质量控制。
规模/质量
1.0 = 原始分辨率。 2.0 = 双倍分辨率(OCR 的理想选择)。 3.0 = 打印高分辨率。它越大,生成的文件就越大。
保存到变量
返回 Base64 格式的图像,以便与 OCR (Google Vision) 一起使用,通过 WhatsApp、API 发送或导出为文件。
具体页面
输入要转换的页码(1 = 第一个)。要转换所有页面,请匹配块 浏览数据 从 1 迭代到总页数。
| 参数 | 描述 |
|---|---|
Origem do PDF |
手册 · URL/Base64 · 本地文件夹 · 绝对路径 |
Número da página |
要转换哪一页(1 = 第一页) |
Escala/Qualidade |
1.0 = 原始分辨率,2.0 = 双倍分辨率(更高质量) |
Formato |
PNG(最佳质量)·JPG(最小尺寸) |
Destino |
将 Base64 保存到变量·下载文件 |
数据库连接
✦ 独家直接连接到数据库以在自动化过程中执行 SQL 查询、插入和检索数据。
对连接到系统的数据库执行 SQL 查询。
配置
在 Dablio Robô 设置中连接数据库。可以为不同的环境(开发、生产)配置多个连接。
结果
查询返回的数据保存在配置为对象数组的变量中,准备好与循环块进行迭代。
| 参数 | 描述 |
|---|---|
Banco de dados |
选择配置的连接 |
Consulta SQL |
要执行的 SQL 查询 |
Variável de resposta |
将接收结果的变量 |
Excel
Excel 文件(XLS、XLSX、ODS、XLSB)的高级读写,支持多个处理引擎。
Excel 文件的读取、写入和高级实用程序。支持多种读/写引擎和XLS、XLSX、ODS和XLSB格式。
列表选项卡
以列表形式返回工作表中所有选项卡的名称。对于动态处理具有可变数量选项卡的电子表格非常有用。
读取数据(Excel 输入)
从可配置范围内的特定选项卡读取数据,并提供处理标题、空行、编码和错误的选项。
导出(Excel 输出)
使用流数据创建一个新的 Excel 文件。支持模板、选项卡保护、自动列调整和带日期/时间的动态名称。
高级写作(Excel Writer)
写入现有文件的特定单元格,对位置(起始单元格)、冲突行为和样式保留进行精细控制。
| 参数 | 描述 |
|---|---|
Recurso |
列表选项卡 · 读取数据(Excel 输入) · 导出(Excel 输出) · 高级写入(Excel Writer) |
Caminho do arquivo |
Excel 文件的完整路径 |
Motor |
XLS (JXL) · XLSX (POI) · XLSX 流媒体 · ODS · XLSB |
Aba |
要处理的选项卡的名称或索引 |
Linha/coluna inicial |
阅读或写作的起点 |
Cabeçalho |
忽略或包含第一行作为标题 |
Formato de saída |
名称、扩展名、拆分、保护和模板设置 |
杀毒软件
✦ 独家与 VirusTotal (Google) 集成,在自动处理文件、URL 和哈希之前检查它们的安全性。
扫描 VirusTotal (Google) 上的文件、URL 或哈希,并返回带有可配置阻止策略的完整安全报告。
检查哈希值
检查文件的 MD5、SHA1 或 SHA256。如果该文件不在 VirusTotal 数据库中,则返回未定义的结果。
检查网址
分析URL是否是恶意的。返回包含防病毒引擎检测结果的报告。
封锁政策
配置阈值:如果 ≥ N 个引擎检测到它是恶意或可疑的,则该块将通过后备输出,从而允许该文件被视为威胁。
| 参数 | 描述 |
|---|---|
Ação |
检查哈希 · 检查 URL · 检查文件 |
API Key VirusTotal |
VirusTotal 服务 API 密钥 |
Hash |
文件的 MD5、SHA1 或 SHA256 |
URL |
需要检查的地址 |
Limite de detecções maliciosas |
如果 ≥ N 个防病毒软件标记为恶意,则阻止 |
Limite de suspeitos |
如果 ≥ N 个防病毒软件标记为可疑,则阻止 |
Campo de saída |
将写入 JSON 报告的字段名称 |