- はじめに
- 開発
- デプロイして実行する
- 例
- 参照
フロー キャンバス
フロー キャンバス: すべてのツールが共有するツールバー、パネル、メニュー、デバッグ コントロールであり、Studio Web、VS Code、デスクトップ版の Studio の違いです。
フロー キャンバスは、VS Code、Studio Web、デスクトップ版の Studio など、あらゆる環境でワークフローを構築するビジュアル ワークスペースです。ワークフローの各ステップは 1 つのノードであり、ノード間の線によってステップが実行される順序が決まります。.flow ファイルを作成または開くと、キャンバスが開きます。
キャンバスは、3 つのツールすべてで同じように機能します。以下のセクションでは、共通点について説明します。また、 ツール間の違いについては 、それ以外について説明します。
キャンバスの各部分
| 領域 | 場所 | 目的 |
|---|---|---|
| キャンバス | 上下中央揃え | ノードを配置、接続、配置します。 |
| 下部のツールバー | 中央下部 | ワークフローの構築対象とする製品を選択し、デバッグの実行または評価を開始し、ノードを追加し、メモを追加します。 |
| プロパティ パネル | 右 | 選択したノードを設定します。 |
| キャンバスの下のパネル | 下 | デバッグ実行、実行トレース、各ノードの詳細を確認し、評価に取り組みます。 |
右端にあるアイコンのストリップにより、[ プロパティ] パネル、[ログ]、[ウォッチ] パネルが開きます。
下部のツールバー
下部のツールバーには、左から右に次のコントロールがあります。
- [次として構築] メニュー: プロジェクトを構築する製品を表示および設定します。
- デバッグを実行 (): ▶ デバッグ実行を開始します。
- 評価を実行 (フラスコ アイコン): [ 評価の実行を設定 ] パネルが開き、データセットのスコアリングが行われます。アイコンの横にある矢印をクリックするとメニューが開き、[ 評価を実行] によってデータセットを選択して実行が開始される、[ データ ポイントを追加] によってガイド付きウィザードで入力と期待される出力がキャプチャされます。評価では、それらの説明について説明します。
- ノードを追加 (+): [ ノードを追加 ] パネルを開きます。
- メモを追加 (ページ アイコン): キャンバスにメモを追加します。
ノードの追加
下部のツールバーの [ + ] ボタンをクリックすると [ ノードを追加 ] パネルが開きます。このパネルには検索ボックスが表示され、目的別のノードのグループが表示されます。
カテゴリは、エージェント、コネクタ、データ、ドキュメント、人間、コントロール、ツール、イベントを待機の順に選択し、その後に既存の作業を呼び出すカテゴリが続きます。パネルをスクロールして残りの部分を確認します。[ トリガー] カテゴリは、下部のツールバーからノードを追加すると表示されます。ノード参照 : すべてのノードをカテゴリ別に一覧表示します。
たとえば、[ ツール] カテゴリには、 スクリプト、 会話ツール、 キュー ツール、 音声ツールが含まれます。ツールは それらを説明します。
ノードの出力ハンドルの + は、新しいノードを追加し、1 ステップで接続します。
トリガーは、ノード ハンドルからは追加できず、下部のツールバーからのみ追加できます。
ノードの接続
ノードは、ノードの端にある小さなドットであるハンドルを介して接続されます。ノードの右側にある出力ハンドルは、次のノードの左側にある入力ハンドルに接続します。キャンバスではコネクションがリアルタイムで検証されます。緑は有効なコネクション、赤は無効なコネクションを示します。接続はノードの制約に従います。たとえば、トリガーを別のトリガーに接続することはできません。
エッジ セグメントはドラッグして再配置できます。調整されたパスはセッションのために保持されますが、保存されたドキュメントや元に戻す履歴には影響しません。
プロパティ パネル
ノードを選択すると、右側にプロパティ パネルが開き、そのノードの設定が表示されます。タブはノードの種類によって異なります。たとえば、スクリプト ノードには、[ パラメーター]、[ エラー処理]、[ 詳細設定] が表示されます。
ワークフロー全体に属する変数は、[プロパティ] パネルで管理されません。これらのアクティビティは、「 変数とデータ フロー」 で説明する独立した [ 変数] パネルに存在します。
ノードの全画面展開ビューは、ホバー ツールバーから利用できます。展開されたビューには、ノードがスキーマまたは JSON ビューで読み取ることができるデータを示す [入力]、ノードの設定を保持する [プロパティ]、ノードが生成したデータを示す [出力] の 3 つの列があります。[ 出力] 列には、[ 本稼働]、[ 静的モック]、[ 生成済み] のモード メニューがあり、「 出力モック」 で説明しています。
デバッグ
下部のツールバーの [デバッグを実行] (▶) キャンバス上でワークフローを実行します。トリガーに入力がある場合、最初にダイアログで入力の値を確認するメッセージが表示されます。実行が進むにつれて、各ノードのステータスが表示され、キャンバスの下のパネルに実行とその実行トレースが表示されます。
実行中、下部のツールバーには実行コントロール (赤い [デバッグを停止 ] ボタン、[ 続行]、[ 次のステップ]) が表示されます。ワークフローを変更すると、デバッグ セッションも終了します。
ブレークポイント
ブレークポイントはノード上のマーカーです。ブレークポイントを設定するには、ノード上でホバーし、ツールバーで [ブレークポイントを追加] > [⋮ (その他のオプション)] を選択します。ブレークポイントに到達すると実行は一時停止します。ブレークポイントはノード上に赤い点として表示され、そこで一時停止する実行には一時停止アイコンが表示されます。[続行] と [次のステップ] では、実行の続行方法を制御します。ブレークポイントは、実行前と実行中に設定できます。
キャンバスの下のパネル
デバッグの実行後、キャンバスの下にパネルが表示されます。
| タブ | 表示内容 |
|---|---|
| 実行 | デバッグ実行、選択した実行の実行トレース、および選択した項目の詳細実行の場合、[詳細] には [ 変数]、[ インシデント]、および [ メタデータ ] タブがあります。ノードの場合は、その入力と出力が表示されます。 |
| データセット、 評価器、 評価の実行 | [評価] タブ評価では、それらの説明について説明します。 |
実行トレースでノードを選択すると、対応するノードがキャンバス上で強調表示されます。
ノード メニューとキャンバス メニュー
ノードのメニューは、ホバー ツールバーの ⋮ (その他のオプション) から開くか、ノードを右クリックすると開きます。[ ブレークポイントを追加]、[ プローブを追加]、[ コピー]、[ 切り取り]、[ 貼り付け]、 および [削除] があります。トリガーには、[ デバッグ ] と [既定のエントリ ポイントとして設定] もあります。
既定のエントリ ポイントとして設定 : 選択したトリガーをワークフローの既定のエントリ ポイントとして設定します。プローブの追加 は、 プローブ パネルをノードにアタッチします。このパネルには、ノード独自の出力である $self.outputで始まる式の値が表示され、パネル内の + は別の式を追加します。
キャンバスの背景を右クリックすると、レイアウト オプションが表示されます。
- ノードの整理: すべてのノードを自動整列します
- 整然とした選択: 選択したノード (2 つ以上) を自動配置します
- 整列:左、中央、右、上、中央、下(2+選択)
- 分散: 水平方向、垂直方向 (3+ 選択)
- コピー/貼り付け/削除
[ノードを整理] または [整理] を選択すると、エッジはノードを通過するのではなくノードの周りをルーティングするため、ノードの位置を変更してもダイアグラムの可読性が維持されます。ループエッジ(自己接続ハンドルとループバックハンドル)は、既存のハンドルベースのルーティングを維持します。
キーボード ショートカット
キャンバスの主要なショートカット
Cmd+Z/Ctrl+Z: 元に戻すCmd+Shift+Z/Ctrl+Shift+Z: やり直しCmd+Shift+L/Ctrl+Shift+L: すべてのノードを自動レイアウトDelete/Backspace: 選択したノードを削除します
キーボード ショートカット: キャンバスのすべてのショートカットが一覧表示されます。
ツール間の違い
各ツールは、キャンバスの周囲に独自のエクスプローラーとツールバーを追加します。
| Studio Web | VS コード | デスクトップ版の Studio | |
|---|---|---|---|
| エクスプローラー | 左側 のエクスプローラー には、ソリューション、そのプロジェクト、およびワークフローで使用できるリソースが一覧表示されます。 | アクティビティ バーの [UiPath] アイコンから見た [UiPath Maestro] ビュー | デスクトップ 版の Studio エクスプローラー、およびソリューションとそのプロジェクト |
| 上部のツールバー | ビルド |[管理] スイッチ: [管理] にデプロイが表示され、左上に [デバッグ] メニューが表示されます。 | VS Code 拡張機能 のリストであるコマンド パレットの UiPath コマンド。 | [デザイン] タブと [デバッグ] タブ、および [ファイルをデバッグ]、[ファイルを実行]、[デバッグ]、[実行] を含む [デバッグ] メニュー |
| ステップごとにデバッグ | デ バッグ メニュー (Shift+F5) で、 | 利用できません。 | 利用できません。 |
| Autopilot (プレビュー) | [ Autopilot ] パネル | 別の UiPath Autopilot 拡張機能。 | 右側の [Autopilot ] パネル |
Studio Web のデバッグ メニュー
Studio Web のツールバーの左上にある [ デバッグ] メニューには、次のオプションがあります。
- デバッグ (
F5): 下部のツールバーの [ デバッグを実行 ] と同様に、ワークフローを実行します。 - ステップごとにデバッグ (
Shift+F5): ワークフローを一度に 1 ノードずつ実行します。 - デバッグ設定: [デバッグ設定] ダイアログを開きます。[ エントリ ポイントの引数 ] タブではデバッグ実行に対してトリガーの入力値を設定し、[ ソリューションのリソース ] タブでは [ デバッグの用途] で各リソースが使用する接続を選択します。[ デバッグ前に表示 ] がオンになっている間は、デバッグ実行を開始するたびにダイアログも開きます。
- デバッグ用にソリューションをデプロイ
デバッグ実行中は、右側の [ログ ] パネルに実行の準備手順が表示されます。
VS Code およびデスクトップ版の Studio の [プロパティ] パネルのオプション
VS Code およびデスクトップ版の Studio では、キャンバスの上の [ プロパティ] の横にあるスライダー アイコンにメニューが開き、プロパティ パネルの外観が変わります。
- セクション: パラメーター、 変数、 入力、 出力の表示または非表示を切り替えます。
- パネルの動作: 自動非表示 または 常に保持。
- 既定のレイアウトは、[ 既定] — 右、 既定 — 下、または 既定 — 分割です。
- 保存済みのプリセット: [プリセットとして保存] は 、現在のレイアウトをプリセットとして保存します。
[ パラメータ] タブと [変数 ]タブをグリップでドラッグして、並べ替えることもできます。
次のステップ
- キーボード ショートカット: キャンバス上を移動して、ノードの操作を高速化します。
- 最初のワークフロー: 約 15 分でステップごとに構築された注文受付ワークフロー
- デバッグの基本: ワークフローをデバッグするためのヒントです。
- コミュニティ: UiPath フォーラムで質問したり、他のビルダーとワークフローを共有したりできます。