通知を受け取る

UiPath Robot

UiPath Robot ガイド

ピクチャ イン ピクチャ

概要

ピクチャ イン ピクチャ機能は、有人の自動化プロセスをロボットと協働して実行できるようにする機能です。ピクチャ イン ピクチャ モードで開始されたプロセスは独立した Windows セッションで実行されるため、プロセスの実行中もユーザーはそのコンピューターを使用することができます。

プロセスをピクチャ イン ピクチャ モードで開始するには、Studio の [デバッグ] タブや StudioX から、あるいは直接 UiPath Assistant でプロセスのコンテキスト メニュー searchsearch から実行します。

📘

注:

PiP セッションでプロセスを開始するタイムアウトの既定値は 60 秒です。ピクチャ イン ピクチャ セッションへのログイン時間が既定値を超える場合は、タイムアウト エラーがスローされます。このタイムアウトの既定値は、マシンの環境変数 UIPATH_SESSION_TIMEOUT を使用して変更できます。

プロセスをピクチャ イン ピクチャ モードで開始するとデスクトップ上にプレビュー ウィンドウが表示されるため、プロセスの実行状況をリアルタイムで把握できます。このウィンドウは、サイズ変更や移動、全画面表示ができるほか、他のウィンドウの手前に配置することもできます。ピクチャ イン ピクチャ モードは、いつでも終了できます。ピクチャ イン ピクチャ ウィンドウのタスク バーのエントリを右クリックして [ウィンドウを閉じる] を選択するか、単純にウィンドウを閉じます。確認ダイアログが表示されます。ここで PiP ウィンドウを閉じることを選択すると、実行中のプロセスが停止します。

📘

注:

マシン上でピクチャ イン ピクチャ機能を有効化するには、管理者権限が必要です。この権限が必要なのはピクチャ イン ピクチャ機能を初めて使用する時のみであり、その後実際にピクチャ イン ピクチャでプロセスを開始する時には不要です。

プログラムを使用してピクチャ イン ピクチャ機能を有効化する方法について詳しくは、下記の「コマンド ライン パラメーター」セクションをご覧ください。

コントロール

PiP ウィンドウでは、以下のコントロールを使用できます。

  • searchsearch (制御する) - このコントロールを有効にすると、PiP セッションを管理できます。無効にすると、マウスとキーボードがメイン セッションでのみ機能します。
  • searchsearch (常に手前に表示) - このコントロールを有効にすると、フォーカスが外れているときでも PiP ウィンドウを常に他のアプリケーションの前面に表示できます。
  • searchsearch 最小化 - プロセスを中断せずに、PiP ウィンドウを最小化してメイン セッションのタスク バーに収めます。
  • searchsearch 最大化 - PiP ウィンドウを最大化します。
  • searchsearch 閉じる - PiP ウィンドウを閉じ、実行中のプロセスをすべて停止し、PiP セッションからログオフします。

ピクチャ イン ピクチャ セッションを初めて開始すると、Windows 資格情報の入力を求められます。コンピューターを再起動すると、資格情報の再入力を求められなくなります。

プロセスを PiP 対応済みにする

Studio の [プロジェクト設定] セクションで、プロセスを [PiP 対応確認済] に設定できます。つまり、そのプロセスはテスト済みであり、PiP セッション内で安全に実行できるということです。既定でピクチャ イン ピクチャ セッションで開始するよう、プロセスを設定することもできます。

呼び出し系アクティビティに PiP を使用する

[プロセスを呼び出し]、[ワークフロー ファイルを呼び出し]、[プロセスを並列実行] などの呼び出し系アクティビティでは、新しいプロセスの開始場所を選択できます。

Studio 内で [その他] > [ターゲット セッション] の順に移動し、アクティビティの [プロパティ] タブから設定できます。

📘

注:

[ターゲット セッション] プロパティは Studio からのみ変更できます。StudioX で開発されたプロジェクトでこのプロパティを変更するには、プロジェクトを Studio で開く必要があります。

以下のオプションを利用できます。

  • Current - 子プロセスが親プロセスと同じセッション内に開きます。
  • Process Default - 子プロセスがプロセスの設定を使用します。
  • Main - 親プロセスの実行場所に関係なく、メイン セッション内で子プロセスが開始します。
  • Picture in Picture - 親プロセスの実行場所に関係なく、ピクチャ イン ピクチャ セッション内で子プロセスが開始します。

Enable PiP via Command Line

The Command Line Arguments provide an option to enable or disable the Picture in Picture functionality on the machine using the command line interface.

The settings are applied on the local machine and affects all users and is used for modifying existing installations.

Command

Description

PiP

:information-source: Command is available for Robot v2020.10.4 and above, for previous versions, please use childsession instead of PiP.

The PiP command is used to enable the Picture in Picture functionality of the machine when the UiPath Products are already installed.

It can have the following parameters:

PiP --enable
Enables the Picture in Picture functionality of the machine.
PiP --disable
Disables the Picture in Picture functionality of the machine.
Example: UiRobot.exe PiP --Enable
Administrator rights are required to execute these commands.

ENABLE_PIP

The ENABLE_PIP command is used to enable the Picture in Picture functionality of the machine during the UiPath command-line installation.

To enable it, use the following parameter:
ENABLE_PIP=1
Example:
UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,Packages ENABLE_PIP=1

既知の問題と制限事項

ピクチャ イン ピクチャ機能を使用する際の注意事項は以下のとおりです。

  • Windows のメイン セッションへのログインに PIN を使用している場合、ピクチャ イン ピクチャのセッションを開始するたびに資格情報の入力を求められます。
  • ピクチャ イン ピクチャ セッションが開くと、PiP セッション内にも起動プログラムが開きます。このため、周辺機器の一部の設定が既定値にリセットされる可能性があります (キーボードやマウスの照明設定など)。
  • PiP プロセス実行時にメッセージが表示されるときにリモート デスクトップ セッションを有効にする場合は、メインの Windows セッションからログアウトした後で再度ログインして変更を反映する必要があります。
  • PiP セッションを事前に閉じる必要があるため、PiP セッションが開いている間はマシンを再起動またはシャットダウンできません。
  • ピクチャ イン ピクチャの実行に関するオペレーティング システムの制限により、Windows 8 および 10 の Home Edition はサポートされていません。
  • [管理者として実行] は、PiP セッションで使用できません。
  • 一度に開始できるピクチャ イン ピクチャ セッションは 1 つのみです。

Microsoft Office の自動化

  • Microsoft Office のリソースを使用するオートメーションは、メイン セッションでそのリソースが既に開いている場合、ピクチャ イン ピクチャで正常に実行されません。オートメーションが PiP でスムーズに実行できるように、次の操作を行います。

    • Microsoft Office アプリケーションで使用されているリソースをメイン セッションから閉じて、PiP セッションで開けるようにします。

    • Use an InvokeIsolatedWorkflow activity to invoke the part of the automation using Microsoft Office and set its Target Session to Picture in Picture from Studio..

  • メイン セッションでアプリケーションが既に開いている場合、Microsoft Outlook に依存するオートメーションは PiP で正常に実行されません。オートメーションをスムーズに実行できるように、プロジェクトを PiP で実行する前にメイン セッションで Microsoft Outlook を終了します。

PIP セッションで Web ブラウザーを使用する

ピクチャ イン ピクチャ セッションのブラウザー データは、既定でメイン セッションに保存されます。すべての種類のブラウザーで同じユーザー データ フォルダーが使用されるため、PiP セッションでアクティブにできるブラウザーの種類は 1 つだけです。

ただし、ブラウザー データのモードと場所は、[ブラウザーを開く] アクティビティのプロパティから設定できます。

UserDataFolderMode プロパティを Automatic に設定すると、ブラウザーはメイン セッションと PiP セッションに別々のユーザー データ フォルダーを使用できます。

このモードで %LocalAppData%\UiPath\PIP Browser Profiles フォルダーからユーザー データをクリアする場合は、対応するブラウザー拡張機能を再度有効化する必要があります。

メイン セッションのデータ (Cookie、保存されたパスワードなど) を使用する必要がある場合は、UserDataFolderMode プロパティを DefaultFolder に設定することを検討してください。つまり、メイン セッションと PiP セッションでは、ブラウザーのユーザー データに同じフォルダーを使用します。

📘

注:

[ユーザー データ フォルダー モード] を DefaultFolder に設定すると、ブラウザーは一度に 1 つのセッションでのみ機能します。ブラウザーがメイン セッションで開いている場合は、PiP セッションでは機能しません。これは、同じブラウザー プロファイルを 2 つのセッションで同時に使用できないためです。

📘

注:

Target SessionUserDataFolderModeStudio でのみ変更できるプロパティです。これらのプロパティを変更するには、StudioX で開発されたプロジェクトを Studio で開く必要があります。

UserDataFolderMode プロパティを CustomFolder に設定することで、メイン セッションと PiP セッションに別々のユーザー データ フォルダーを指定できます。

2 日前に更新


ピクチャ イン ピクチャ


改善の提案は、API リファレンスのページでは制限されています

改善を提案できるのは Markdown の本文コンテンツのみであり、API 仕様に行うことはできません。