Robot ガイド

最終更新日時 2024年10月25日

ウィジェット

ウィジェットとは、UiPath Assistant に統合された、ある機能を持つプラグインを指します。たとえば、Apps ウィジェットや独自のカスタムウィジェットなどです。

UiPath Assistant にウィジェットをインストールするには、2 つの方法があります。

ウィジェットをダウンロードする

UiPath で作成されたウィジェットは公式のフィードを介して配布されるのに対して、カスタムウィジェットは .nupkg ファイルとして Orchestrator のライブラリにパブリッシュされます。どちらの場合も、ガバナンスポリシーに基づいて UiPath Assistant にダウンロードされ、インストールされます。

ウィジェットのダウンロードは、次のような手順で実行されます。

UiPath Assistant は Automation Ops からガバナンスポリシーを取得します。
UiPath Assistant は Orchestrator ライブラリフィードで、要求されたウィジェットを検索します。
そこでウィジェットが見つからない場合は、公式の NuGet フィードが使用されます。

注: 両方のフィードを使用できる場合、UiPath Assistant はオフィシャル NuGet フィードよりも Orchestrator ライブラリフィードを優先します。
ウィジェットがダウンロードされ、UiPath Assistant に追加されます。

注: 新しいウィジェットを表示するには、UiPath Assistant を終了して再起動するか、サインアウトしてサインインし直すか、ウィジェットを再読み込みする必要があります。ウィジェットを再読み込みするには、 Windows トレイ -> UiPath Assistant のアイコンを右クリック -> [ウィジェットを再読み込み] をクリックします。

UiPath Assistant に手動でウィジェットを追加する

UiPath Assistant にウィジェットを手動で追加するには、コンパイルされた .js ファイルが必要です。ウィジェットが既に .js ファイルに組み込まれている場合は、UiPath Assistant のホームページにドラッグアンドドロップするだけです。それ以外の場合は、こちらの手順に従ってまずウィジェットを作成する必要があります。

注: UiPath Assistant で .js ファイルをドラッグアンドドロップできるようにするには、ガバナンスポリシーでカスタムウィジェットの使用を許可する必要があります。

Automation Ops を使用したウィジェットのガバナンス

ウィジェットのガバナンスによって、ウィジェットへのユーザーのアクセスを管理できます。詳しくは、ガバナンスポリシーの作成に関するドキュメントをご覧ください。

UiPath Assistant に作成したポリシーによって、以下が可能になります。

ユーザーによる、独自のカスタムウィジェットのインストールを許可するかどうかを選択します。
UiPath のオフィシャルウィジェットフィードを使用するかどうかを選択します。使用することを選択した場合、ウィジェットはオフィシャルフィードまたは Orchestrator ライブラリフィードからダウンロードされます。使用しないことを選択した場合、Orchestrator ライブラリフィードのみが有効化されます。
NuGet パッケージの名前とバージョンを追加して、ユーザーがアクセスできるようにするウィザードのリストを表示します。

注: カスタムウィジェットを許可しないようにガバナンスポリシーを設定した場合、ユーザーはドラッグアンドドロップでカスタムウィジェットを追加することはできず、Orchestrator のフィードまたはオフィシャルフィードを介してデプロイされたウィジェットをインストールすることしかできません。また、カスタムウィジェットとオフィシャルフィードを両方とも許可しない場合、ユーザーは Orchestrator フィードにパブリッシュされたウィジェットにしかアクセスできません。

Automation Ops を使用しないウィジェットのガバナンス

UiPath Assistant が Automation Ops で設定されたポリシーによって制御されていない場合、またはポリシーを適用できない場合は、agent-settings.json の設定が使用されます。どちらも使用できない場合は、Assistant は Marketplace ウィジェットと Apps ウィジェットの最新バージョンを含む既定のポリシーを使用します。

これを変更するには、%userprofile%\AppData\Roaming\UiPath にある agent-settings.json を開き、agent タグの下に defaultNugetWidgetConfig プロパティを追加します。

重要: agent-settings.json でポリシーを設定する場合は、必ず有効期限も設定してください。

"defaultNugetWidgetConfig": {
   "widgets": {
      "UiPath.Marketplace.Widget": "1.0.0"
    },
    "enableOldWidgets": true,
    "enableFallbackFeed": true,
    "expires": "2100-01-01T00:00:00.000Z",
    "policy": "My custom default policy"
}"defaultNugetWidgetConfig": {
   "widgets": {
      "UiPath.Marketplace.Widget": "1.0.0"
    },
    "enableOldWidgets": true,
    "enableFallbackFeed": true,
    "expires": "2100-01-01T00:00:00.000Z",
    "policy": "My custom default policy"
}