UiPath Documentation
maestro-automate
latest
false
Maestro Automate ユーザー ガイド

VS Code でビルドする

インストールとサインインからコマンドと設定まで、UiPath 拡張機能を使用して Visual Studio Code でワークフローを構築、デバッグ、デプロイする方法。

UiPath for Visual Studio Code 拡張機能は、無料のコード エディターである Visual Studio Code (VS Code) にフロー キャンバスを追加します。拡張子が .flow のワークフロー ファイルをビジュアル エディターで開き、UiPath にサインインして、作業を UiPath Automation Cloud にデプロイします。

フロー キャンバス、ノード、変数、デバッグは、どの環境でも同じです。このページでは、VS Code に固有の内容 (拡張機能のインストール、サインイン、ローカル ワークスペースからのデプロイ) について説明します。最初のワークフローは 、最初から最後までワークフローを構築します。

開始する前に​

以下が必要です。

  • VS コード 1.110.0 以上。
  • UiPath アカウント。登録 作成 方法について説明しています。
  • UiPath Automation Cloud へのインターネット アクセス。
  • コマンドラインプログラムを実行およびインストールするためのツールであるNode.jsとnpmは、端末がそれらを見つけることができるようにインストールされます。初回サインイン時に、拡張機能は npm を使用して UiPath コマンド ライン ツール uip (npm install -g @uipath/cli) をインストールします。

Windows Subsystem for Linux (WSL)、SSH、Codespaces、開発コンテナーなどのリモート ワークスペースで作業している場合、拡張機能はリモート ホストで実行されます。Node.js と npm をローカル マシンではなくそこにインストールし、UiPath CLI もリモート ホストにインストールするようにします。

拡張機能をインストールする​

  1. VS Code Marketplace または Open VSX レジストリ から UiPath Maestro をインストールします。
  2. プロンプトが表示されたら、VS Code を再読み込みします。
  3. アクティビティ バーの [ UiPath ] アイコンを選択して、[UiPath Maestro] ビューを開きます。

UiPath Maestro ビューには、次のセクションがあります。

  • [接続] には、サインインしているユーザー、接続ステータス、および作業している組織とテナントが表示されます。
  • [新規作成] - その下にワークスペース内のソリューション、プロジェクト、ワークフローが表示されます。
  • [リソース] には、デプロイ済みのプロセスなど、テナントに既に存在するものが検索ボックスとともに表示されます。
  • [問題] は、ワークフロー内の問題のリストを表示します。
  • [ビルド & デプロイ] に、パッケージのステータス、[デプロイ] ボタン、デプロイ履歴が表示されます。

サインイン​

拡張機能は、Web ブラウザーからサインインします。トークンは保存されません。

  1. [ 接続 ] セクションで [ サインイン] を選択します。
  2. CLI がまだインストールされていない場合は、プロンプトを受け入れてインストールします。この拡張機能は npm install -g @uipath/cli実行されます。
  3. ブラウザーが開き、サインインが完了します。拡張機能は、自分のコンピューターのポート 8104 で結果を受け取ります。
  4. 承認したら、VS Code に戻ります。それ以降は、セッションは自動的に更新されます。

サインアウトするには、[接続] セクションで [サインアウト] を選択します。これにより、プロセス内でサインアウトされ、キャッシュされたセッションがクリアされます。

注:

サインインでは、OAuth コールバックにポート 8104 on localhost を使用します。サインインに失敗する場合は、古いプロセスによってポートが保持されている可能性があります。解放してもう一度やり直してください。macOS または Linux の場合は、 lsof -ti :8104 | xargs kill -9を実行します。Windows では、 netstat -ano | findstr :8104 を実行してプロセス ID を見つけてから、 taskkill /F /PID <id>を実行します。

環境とテナントを選択する​

サインイン後、作業する場所を選択します。コマンドはコマンド パレットから実行されます。 Ctrl/Cmd+Shift+Pを押してコマンド名を入力して選択します。

  1. UiPath を実行します。[環境] を選択して、環境を確認します。既定値は Cloud です。
  2. UiPath を実行します。[テナント] を選択してテナントを選択します。[ 接続 ] セクションには、テナントが属する組織が表示されます。

後でテナントを切り替えるには、[ 接続 ] セクションで組織とテナントの横にある矢印を選択します。

[ リソース] セクションでは、選択したテナントのフォルダーとリソースを参照できます。

結果: [リソース] セクションには、選択したテナントのフォルダーとリソースが一覧表示されます。

ワークフローを作成または開く​

プロジェクトを作成するには、以下の手順を実行します。

  1. UiPath Maestro ビューで [新規作成] を選択します。

  2. [ 新しいプロジェクト ] リストで [ Maestro Automate] を選択します。このリストには 、Maestro Orchestrate と Data Fabric (プレビュー) も含まれています。

プロジェクトがフロー キャンバス上で開き、下部のツールバーに [Maestro Automate] が表示されます。

既存のワークフローを開くには、エクスプローラーで .flow ファイルを選択するか、[ フロー: フローを開く ] (Ctrl/Cmd+Alt+O) を実行します。

ワークフローが読み書きするデータをモデル化する Data Fabric エンティティは、プレビュー機能と同じワークスペース内で作成および編集できます。VS Code のエンティティでは 、その方法について説明します。Studio Web により、エンティティ プロジェクトを含むソリューションが開きます。

Autopilot で構築​

Autopilot (プレビュー) は、UiPath がパブリッシュした別の拡張機能 UiPath Autopilot として、VS Code で利用できます。インストールするには、拡張機能ビュー (macOS の場合はCtrl+Shift+X、 Cmd+Shift+X ) を開き、 UiPath Autopilot を検索して [ インストール] を選択します。次に 、UiPath Autopilot でサインインします。 コマンド パレットでサインインし、 UiPath Autopilot とのチャットを開きます。 Autopilot を開きます。ワークフローを記述すると、Autopilot が構築します。

ワークフローを検証する​

検証エラーと警告は、編集時に UiPath Maestro ビューの [ 問題 ] セクションと VS Code の [ 問題] パネルに表示されます。

任意のエントリを選択すると、問題のあるノード (サブフロー内のノードを含む) にキャンバス上で直接移動できます。パネルの更新を待つのではなく、オンデマンドで検証するには、[ フロー: フローを検証 ] (Ctrl/Cmd+Shift+V) を実行します。

ワークフローをデプロイする​

VS Code からデプロイすると、ワークスペースが UiPath ソリューションとしてパッケージ化され、UiPath Automation Cloud にデプロイされます。「ワークフローをデプロイする」では、デプロイの処理について説明します。

UiPath Maestro ビューの [ 構築とデプロイ ] セクションで、[ デプロイ] を選択します。ソリューションを 1 ステップでパッケージ化してデプロイします。[ デプロイ] の横の矢印には、各ステップが個別に表示されます。

  • パッケージ: パッケージのみをビルドし、デプロイしません。
  • [デプロイ] では、すでにビルド済みのパッケージのみがデプロイされます。

デプロイ後、[ ビルドしてデプロイ ] セクションに最後のパッケージのステータスとデプロイの履歴が表示されます。

これらのアクションは、コマンド パレットから実行することもできます。コマンド パレットは Ctrl+Shift+P、macOS の場合は Cmd+Shift+P で開きます。たとえば、「 UiPath: Package &; Deploy」を実行します。VS Code 拡張機能 には、すべてのコマンドが一覧表示されます。

既定では、拡張機能はデプロイの成功後にデプロイをアクティブ化します。アクティブ化せずにデプロイするには、[ uipath.autoActivateDeployment ] 設定をオフにします。

UiPath CLI から同じパッケージを実行するには、「 UiPath: Generate .env File」を実行します。これにより、uipに対応した .env ファイルが書き込まれます。

ワークフローをテストする​

キャンバスの下部のツールバーで [ デバッグを実行 ] (▶) を選択します。ダイアログが表示され、トリガーの入力の値 ( productId や customerIdなど) を確認するメッセージが表示されます。それらを入力して実行を開始します。ワークフローは選択したテナントで実行され、実行の進行に応じて各ノードのステータスがキャンバスに表示されます。

キャンバスの下の [ 実行 ] タブは、実行後に続きます。

  • [デバッグ実行] には、テスト実行が、そのステータスおよび期間とともに一覧表示されます。
  • 実行トレース には、実行された各ノードとその実行時間が順番に一覧表示されます。エージェント ノードを展開して、そのエージェントの実行とモデル化された呼び出しを確認します。
  • 実行の詳細には、 実行の変数、 インシデント、 メタデータが表示されます。

他のタブ ( [データセット]、[ 評価器]、 および [評価の実行] ) で評価を保持します。テスト実行を評価データ ポイントに変換するには、下部のツールバーにあるフラスコ アイコン、[ 評価を実行するデータ ポイントを追加] を選択します。評価は、その機能を説明するものです。

「デバッグの基本」では、実行を読み取って失敗を解決する方法について説明します。

次のステップ​

このページは役に立ちましたか?

接続

ヘルプ リソース サポート(opens in new window)

学習する UiPath アカデミー(opens in new window)

質問する UiPath フォーラム(opens in new window)

最新情報を取得