この機能を使用すると、事前に Dablio Robô でフローを作成して保存しなくても、メモリ内で組み立てられた一時フローを実行できます。 JSON は、ページ URL 自体を介して、または JavaScript イベントを介して送信できます。 CustomEvent.

システム間の統合、内部パネル、ERP、クイック アクション リンク、間接 Webhook、ブラウザーでローカル オートメーションをトリガーする必要があるページ、およびフローが外部アプリケーションによって動的に生成されるシナリオに推奨されます。

URLで利用可能なパラメータ

JSONをBase64URLにエンコードする方法

パラメータ dablioroboWorkflow, dablioroboCommands そして dablioroboData URL 内の引用符、アクセント、中括弧、スラッシュ、スペース、特殊文字の問題を避けるために、Base64URL として送信する必要があります。

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

短いコマンドで受け入れられるエイリアス

フローに沿って変数を送信する

使用する dablioroboData 実行の初期データを送信します。このデータはフローのコンテキストに入り、ブロックによって変数として使用できます。

https://www.google.com/?dablioroboWorkflow=BASE64URL_DO_WORKFLOW&dablioroboData=BASE64URL_DAS_VARIAVEIS&runToken=SUA_SENHA&dablioroboOnce=1&dablioroboNow=1

例 3 — CustomEvent を介して一時的なワークフローを実行する

ページがすでに開いていて、URL をリロードせずに JavaScript 経由で自動化をトリガーしたい場合は、この形式を使用します。

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 つだけ必要です。

フローがいつどのように開始されるかを定義します。間隔、曜日、Web サイト訪問時、特定の日付/時刻、ブラウザを開いたとき、コンテキスト メニューまたはキーボード ショートカットによる手動トリガーをサポートします。

// Disparar pelo ID do fluxo
window.dispatchEvent(new CustomEvent('dabliorobo:execute-workflow', {
  detail: { id: 'workflow-id' }
}));

// Passar variáveis para o fluxo
window.dispatchEvent(new CustomEvent('dabliorobo:execute-workflow', {
  detail: {
    id: 'workflow-id',
    data: {
      variables: {
        nome: 'João Silva',
        busca: 'produto XYZ'
      }
    }
  }
}));

別のフローをサブルーチンとして呼び出します。子フローは親から変数とテーブルを自動的に受け取り、完了後、親はデフォルトのパスに沿って通常どおり続行します。

この時点から別のワークフローを実行します。親フローと子フロー間で変数、テーブル、ターゲット タブを自動的に共有します。

現時点で別のフローが実行されているかどうかをリアルタイムで確認します。並列実行を回避したり、同時ストリームの終了を待機したりする場合に役立ちます。

特定のフローが現在実行されているかどうかを確認します。 true (実行中) または false (停止中) を返します。

現在のフローまたは進行中の他のフローの実行を停止します。成功ステータスで終了することも、エラーをスローして失敗処理ブロックをアクティブにすることもできます。

現在のフローまたは進行中の他のフローの実行を停止します。正常に終了する場合もあれば、エラーがスローされる場合もあります。

次のブロックに進む前に、設定された時間実行を一時停止します。読み込み、ページアニメーション、アクション間の時間枠を待機するために不可欠です。

次のブロックに進む前に、ミリ秒単位で設定された時間フローの実行を一時停止します。

フローによって収集されたデータをローカル ファイルにエクスポートします。データテーブル、個々の変数、カスタムコンテンツを複数の出力形式でサポートします。

収集したデータ (テーブル、変数、またはカスタム テキスト) をさまざまな形式でローカル ファイルにエクスポートします。

外部 API に対して HTTP/HTTPS リクエストを行います。すべての REST 動詞、ヘッダーによる認証、複数の本文形式、および応答タイプをサポートします。

API または外部サービスに HTTP リクエストを送信します。すべてのメソッド、カスタム ヘッダー、ボディ タイプをサポートし、応答を JSON、テキスト、または Base64 として受け取ります。

Authorization: Bearer {{meuToken}}
Content-Type: application/json
X-Api-Key: minha-chave-secreta

{
  "status": 200,
  "data": {
    "nome": "Lista de preços",
    "valores": [
      { "id": 1, "preco": 4000 },
      { "id": 2, "preco": 24000 }
    ]
  }
}

[
  ["campo", "valor"],
  ["arquivo", "C:\\Downloads\\documento.pdf"],
  ["imagem", "https://exemplo.com/foto.png"]
]

{
  "nome": "{{nomeCliente}}",
  "email": "{{emailCliente}}",
  "total": {{valorTotal}}
}

システム クリップボードにデータを読み書きします (Ctrl+C/Ctrl+V)。ストリームとオペレーティング システムの間でデータを転送する場合に便利です。

テキストをシステムのクリップボードにコピーするか、ユーザーがコピーした現在のコンテンツを読み取ります。

以前に接続されていたすべてのブロックが完了するまで待ってから続行します。並列ストリームを同期するのに役立ちます。

コンテナ内の他のブロックを視覚的にグループ化して、フローを整理および構造化します。それ自体ではアクションは実行されません。

ビジュアルメモ帳。フロー中にアクションは実行されません。これは、キャンバスを文書化して整理するためにのみ使用されます。

視覚的なアラートをユーザーに表示します。ネイティブの Windows 通知 (画面の隅) として、またはブラウザーのアクティブなページ内のフローティング ポップアップとして表示されます。

Windows オペレーティング システム上でユーザーに通知を表示したり、アクティブなページ内の HTML ポップアップとして、さまざまな視覚スタイルを使用して通知を表示します。

タスクの実行中または実行後に、警告音を鳴らしてユーザーの注意を引きます。ストリームがバックグラウンドで実行されている場合に便利です。

設定した時間、警告音を鳴らします。重要なタスクやイベントの完了を知らせるのに役立ちます。

ページ上に読み込みインジケーターを備えた半透明のオーバーレイを表示し、ロボットの動作中にユーザーがクリックしたり操作したりできないようにします。

フローの実行中にユーザーの操作を防ぐために、読み込みインジケーターを備えたロック画面を表示します。

ページ内にインタラクティブなモーダル ウィンドウを表示します。シンプル (OK 付きの情報) にすることも、テキスト フィールド、選択、複数のアクション ボタンを備えたミニフォームにすることもできます。

画面にダイアログ ボックスを表示し、ユーザーのアクションを待ちます。複数の応答ボタン、テキスト フィールド、選択、チェックボックスをサポートします。

どのブラウザ タブが次のブロックのターゲットになるかを定義します。実行コンテキストを、設定された基準によって見つかったタブに変更します。

特定のタブに焦点を当て、それをフロー内の今後のすべてのブロックのターゲットとして定義します。

構成された URL を使用してブラウザーで新しいタブを開き、ウィンドウ、識別、読み込み動作を完全に制御できます。

ブラウザーで新しいタブを開き、高度なウィンドウ コントロール、ページの識別を行い、完全な読み込みを待機します。

実行フォーカスを、URL、タイトル、インデックス、または相対位置によって識別される、ブラウザーですでに開いている別のタブに切り替えます。

URL、タイトル、インデックス、相対位置、または保存されたページに基づいて、フォーカスを別のタブに切り替えます。

現在のタブとは別に、新しいブラウザ ウィンドウを開きます。プライベート/シークレット モード、アドレス バーのないポップアップ、カスタム ディメンションをサポートします。

新しいブラウザ ウィンドウが開き、高度なオプション (プライベート/シークレット モード、タイプ、初期状態、カスタム ディメンション) が表示されます。

アクティブなタブの履歴の前のページに移動します。ブラウザの「戻る」ボタンに相当します。

アクティブなタブの前のページに戻ります。ブラウザの「戻る」ボタンに相当します。

アクティブなタブの履歴内の次のページに移動します (存在する場合のみ)。ブラウザの [次へ] ボタンに相当します。

アクティブなタブの次のページに進みます。ブラウザの「次へ」ボタンに相当します。

ストリーミング中に特定のタブまたはウィンドウを閉じます。複数の選択基準をサポートしており、一度に複数のタブを閉じることができます。

アクティブなタブ、表示されているタブ、ウィンドウ、URL、タイトル、インデックス、または保存したページなどの基準に従ってタブまたはウィンドウを閉じます。複数のクローズをサポートします。

4 つのモードで画面イメージをキャプチャします: ページの表示領域、スクロールのあるページ全体、特定の要素、または画面よりも高い高さの完全な要素。

表示領域、ページ全体、特定の要素、またはスクロールのある要素全体のスクリーンショットを撮ります。

特定のブラウザまたはページのイベント (タブの開閉、クリック、入力、フォームの送信、スクロールなど) を待機しているフローを一時停止します。

ブラウザまたはページ要素で特定のイベントが発生するまでフローを一時停止します。

すべてのブラウザ ナビゲーション用にプロキシ サーバーを構成します。これは、地理的制限をバイパスしたり、スクレイピング オートメーションで IP をローテーションしたりする場合に役立ちます。

ブラウザ接続全体に対してプロキシ サーバー (HTTP/HTTPS/SOCKS4/SOCKS5) を構成するか、現在の構成を削除します。

実行コンテキストを <iframe> ページ上で。インタラクションする要素がインライン フレーム内にある場合に必要です。

実行フォーカスをページ上の特定の iFrame に変更するか、メイン ページに戻します。

ブラウザ ウィンドウまたは特定のページ要素の表示方法を制御します。スクリーンショットや全画面表示が必要なシステムに役立ちます。

表示モードを変更します: ウィンドウ (通常/最大化/最小化/全画面)、全ページ、または特定の要素を展開します。

1 つ以上のブラウザ タブをリロードします (F5 と同等)。ダッシュボード内のデータを更新する場合や、リロードが必要な変更後にデータを更新する場合に便利です。

基準 (アクティブなタブ、表示、タイトル、インデックス、または URL) に従って 1 つ以上のタブを再読み込みします。

開いているタブの URL やタイトルをキャプチャし、後で使用できるようにフロー変数に保存します。

1 つ以上の開いているタブの URL やタイトルを取得し、変数に保存します。

特定の Web サイトのブラウザー Cookie を管理します。値を読み取り、セッション Cookie を作成/更新または削除します。

現在の Web サイトから Cookie を読み取り、作成、更新、または削除します。

ファイルのダウンロードを傍受して管理します。ダウンロードの開始を待機したり、URL 経由で直接ダウンロードしたり、ページ要素からメディア (画像、ビデオ、オーディオ) を抽出したりできます。

ダウンロードが開始されるのを待ち、直接 URL 経由でファイルをダウンロードするか、ページ要素からメディア (画像、オーディオ、ビデオ) を抽出します。

CSS または XPath セレクターを使用してページ要素をクリックします。 Web オートメーションで最も使用されるブロック。

CSS または XPath セレクターを使用して、ページ上の 1 つ以上の要素をクリックします。要素が表示されるまでの待機がサポートされています。

ページ要素 (プレーン テキスト、内部 HTML、またはフォーム フィールド値) からコンテンツを抽出します。後続のブロックで使用できるように変数に保存します。

ページ要素からテキスト、内部 HTML、または値を抽出します。複数の要素をサポートします (配列を返します)。

フォームを操作するための最も多用途なブロック: テキスト フィールドに入力し、オプションを選択し、チェックボックスをマークし、ラジオ ボタンをクリックし、フォームからすべてのデータを一度に抽出できます。

フォームを操作します。テキストフィールドに入力したり、リストからオプションを選択したり、チェックボックスやラジオボタンをマークしたり、フォームからデータを抽出したりします。

スクロールバーを使用してページまたは要素を特定の位置までスクロールするか、画面上の要素を表示します。

スムーズなプレビューとアニメーションのためのスクロール サポートを使用して、ページまたは特定の要素を水平および/または垂直にスクロールします。

任意の要素から HTML 属性を読み取り、設定、または削除します。標準属性 (href、src、class) からカスタム データ属性 (data-id、data-value) までをカバーします。

href、src、class、style、data-id、その他のカスタム属性などの要素から HTML 属性を読み取り、設定または削除します。

JavaScript をページ (メイン ワールド コンテキスト) またはサービス ワーカーに直接挿入して実行します。 DOM、フロー変数、拡張 API に完全にアクセスできます。

JavaScript をページ上 (ページ コンテキスト) またはバックグラウンド (サービス ワーカー) で実行します。結果をストリーム変数に保存するには、「return」を使用します。

// 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;

// Ler variável do fluxo
const cliente = vars.nomeCliente;

// Modificar DOM da página
document.querySelector('#campo-busca').value = cliente;

// Fazer requisição assíncrona (await funciona normalmente)
const resp = await fetch('https://api.exemplo.com/dados?q=' + cliente);
const dados = await resp.json();

// Gravar resultado de volta no fluxo
vars.totalResultados = dados.total;

// Retornar valor para a variável configurada no bloco
return dados.items[0].nome;

ページ要素で DOM イベントをトリガーし、他のブロックではカバーできないインタラクションをシミュレートします。ネイティブ JavaScript イベントにのみ応答するシステムに不可欠です。

高度な修飾子と座標オプションを使用して、ページ要素 (マウス、キーボード、フォーム、クリップボード、タッチなど) で DOM イベントをトリガーします。

ページ要素上でのホバー (マウスオーバー/ホバー) をシミュレートし、要素上にカーソルを置いた場合にのみ表示されるドロップダウン メニュー、ツールチップ、およびコンテンツを表示します。

ページ要素上でのマウスのホバーをシミュレートします (マウスオーバー/ホバー イベント)。これは、メニュー、ツールヒント、および動的コンテンツの表示に役立ちます。

ページ要素のドラッグ アンド ドロップのアクションをシミュレートします。カンバン ボード、リストの順序付け、スライダー、編集ツールとのインターフェイスに役立ちます。

位置、速度、ボタン押しの設定を使用して、ポイント A からポイント B への要素のドラッグをシミュレートします。

ファイルをフィールドにアップロードする input[type=file]、ブラウザーがオペレーティング システムのファイル セレクターの直接自動化を許可しないという制限を回避します。

URL/Base64、ローカル フォルダー、絶対パスを介してファイルをアップロードするか、ユーザーが手動で選択するためのクリックをシミュレートします。

キーの押下やキーボード ショートカットをシミュレートしたり、設定可能なタイミングでキーごとに完全なテキストを入力したりできます。

キーボード ショートカット (CTRL+S など) を押すか、ターゲット要素にオプションでフォーカスを当てて、キーごとにテキストを入力します。

カスタム HTML、CSS、および JavaScript を、ターゲット要素に相対的な位置のページに直接挿入します。コードを変更せずに Web サイトを視覚的に拡張できます。

HTML、CSS、および JavaScript コードを、ターゲット要素に関連するページの特定の位置に挿入します。

<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()'>&#128190; Exportar Dados</div>
<script>
window.__dablioExportar = function(){
  window.dispatchEvent(new CustomEvent('dablio-export'));
};
</script>

ページの DOM に要素が存在するかどうかを確認します。完了するまでに複数回の再試行を構成可能です。戻る 存在します または フォールバック.

成功ポートまたはフォールバック ポートを通過する前に、複数回試行して要素がページ上に存在するかどうかを確認します。

属性を読み取る href リンク要素のリンクを取得して目的地に移動します。リンクの CSS または JavaScript の動作に依存しないため、直接クリックするよりも堅牢です。

要素の href 属性を読み取り、同じタブ、新しいタブ、または新しいウィンドウ内のリンクに移動します。

ファイルを処理する前にローカル フォルダー内のファイルの存在を確認し、外部ファイルに依存するフローでのエラーを防ぎます。

選択したローカル フォルダーにファイルが存在するかどうかを確認します。正確な名前、基本名、または正規表現による検索をサポートします。

2 つの値を比較し、フローをパスに導く決定ブロック 本当 または 偽.

2 つの値を比較し、True または False のパスに沿ってフローを指示します。リテラル値、変数、要素テキスト、HTML 属性、JavaScript コードをサポートします。

セレクターによって見つかったすべての要素を反復処理し、それぞれの内部ブロックを実行します。と同等のもの forEach ウェブオートメーションで。

見つかった各要素の内部ブロックを実行する CSS/XPath セレクターのすべての出現を循環します。

/* Se o identificador do loop for "linha" */
[wRobo-loop="linha_0"]              /* primeiro elemento */
[wRobo-loop="linha_0"] td:nth-child(2)  /* segunda coluna do primeiro elemento */
[wRobo-loop="linha_0"] .btn-acao    /* botão dentro do primeiro elemento */

内部ブロックを一定回数繰り返します。ループと同等 for(i=0; i<N; i++).

内部ブロックを設定回数繰り返します。

/* URL na Nova aba (loopIndex começa em 0, então somamos 1) */
https://site.com/produtos?pagina={{loopIndex + 1}}

/* Ou inicialize uma variável separada e use Incrementar Variável */
https://site.com/produtos?pagina={{pagina}}

データのリスト (変数配列、数値範囲、またはカスタム JSON データ) を反復処理します。現在の項目には、設定された変数を介してアクセスできます。

リスト (変数配列、連続番号、または JSON データ) を反復処理し、項目ごとに内部ブロックを繰り返します。

最も近いループ (タスクの繰り返し、データのトラバース、または要素のトラバース) を直ちに中断し、ループ ブロックの後のフローを続行します。

最も近いループまたは繰り返し (タスクの繰り返し、データの循環、または要素の循環) を直ちに停止します。

最も単純な変数作成ブロック: 変数の値を設定し、ストリーム テーブルにデータを追加するか、ファイルから内容を読み取ります。

変数、ストリーム テーブル、またはローカル ストレージ テーブルにデータを設定します。マニュアルのテキスト、変数、ファイルの内容を受け入れます。

既存の変数からデータを変換および抽出します: 文字列のスライス、コンテンツ タイプおよび正規表現による抽出。

コンテンツの一部を新しい変数に作成、更新、または抽出します。テキスト/データのスライス、タイプおよび正規表現による抽出をサポートします。

変数の数値を構成された量だけ増加または減少させます。カウンターを作成するための最も単純なブロック。

変数の数値を指定された値だけインクリメントまたはデクリメントします。

/* Antes do loop: Inserir dados */
Variável: pagina
Valor: 1

/* URL na Nova aba */
https://site.com/lista?page={{pagina}}

/* Dentro do loop: Incrementar variável */
Variável: pagina
Incremento: 1

ストリーム メモリから変数を削除します。長いストリームのスペースを解放したり、変数が前の反復の値を持たないようにする場合に便利です。

フローの実行中にメモリから変数またはデータを削除します。

レアル (BRL) での通貨書式設定など、ブラジルのビジネス シナリオに特化した関数をサポートして数学的計算を実行します。

標準演算子とブラジル通貨換算などの特殊な関数を使用して数学的計算を実行します。