アクティビティ デザイナー

Automation Suite の Integration Service のアクティビティ デザイナーを使用して、UiPath Studio に表示されるカスタム コネクタ アクティビティのレイアウトをプレビューして設定します。

概要

アクティビティ デザイナーでは、UiPath® Studio に表示される、ユーザー作成の Integration Service カスタム アクティビティのレイアウトをプレビューできます。

その主な機能は次のとおりです。

• レイアウトのプレビュー: カスタム アクティビティのデザインをプレビューし、Studio でどのように表示されるかを確認できます。 コネクタをデプロイする前に、設定を視覚化して必要な調整を行うことができます。
• パラメーター設定: パラメーター フィールドを作成および管理して、アクティビティをより柔軟にカスタマイズできます。 これには、入力、出力、入力/出力引数、およびワークフローで使用されるプロパティが含まれます。
• 要求フィールドと応答フィールド: 要求フィールドと応答フィールドを追加します。 これは、アクティビティ (要求) で必要な情報と、アクティビティ (応答) によって返される情報を定義するのに役立ちます。

入力フィールド

カスタム コネクタのリソースを設定するには、[ パラメーター ] タブを使用して、リクエストの種類に固有のフィールドを追加します。現在は、アクティビティ デザイナーによってすべてのパラメーター フィールドが取得され、[ 入力 ] セクションに表示されます。

次の図は、リソースの [ パラメーター ] タブを示しています。必須としてマークされるフィールドは 1 つだけです。

次の図は、リソースの [アクティビティ デザイナー ] タブを示しています。左側には同じパラメーターが表示されますが、プレビュー ウィンドウには [必須 ] とマークされたフィールドのみが表示されます。

パラメーターの編集

[アクティビティ デザイナー] タブでパラメーターを編集または削除するには、[その他のオプション] メニューをクリックします。

パラメーター名の横にある [ を編集] アイコンをクリックして、プレビュー ウィンドウでのパラメーターの表示方法 ( 表示名と 説明) を変更します。

入力パラメーター値

[アクティビティ デザイナー] タブでは、各入力フィールドを [必須]、[メイン]、または [追加] としてマークできます。各オプションによって、パラメーターの動作と、アクティビティ キャンバス上のどこに表示されるかが決まります。

• 必須: パラメーターは、アスタリスク (*) 記号を使用して必須としてマークされます。つまり、マスクは常にキャンバス上に表示され、値を指定する必要があります。

  

• Main: パラメーターは、アクティビティのプライマリ セクションに表示されます。オートメーションでアクティビティを使用する場合は、空白のままにすることができます。

  

• 追加: パラメーターはメイン キャンバスで非表示になります。これは、[ その他のオプションを表示] セクションの下に表示されます。これらのフィールドは任意であり、空白のままにすることができます。

  

入力パラメーターの順序付け

入力パラメーターの順序によって、アクティビティの [プレビュー] ウィンドウ内のパラメーターの場所が決まります。各パラメーターの横にあるドラッグ アイコンを使用して、順序を変更できます。

たとえば、[ タイミング ] フィールドを [入力 ] セクションの一番上に移動するには、対応する アイコンを上にドラッグします。

アクティビティの [プレビュー] ウィンドウには、フィールドが割り当てられているグループ ([必須]、[メイン]、[追加]) に応じて、[入力] タブのリスト順に表示されます。

要求フィールド

要求フィールドを使用すると、HTTP 要求の本文を設定できます。

要求フィールドは、ほとんどの場合、 POST、 PUT、または PATCH 要求 (レコードを挿入、更新/挿入、または更新アクティビティ) に関連付けられます。 GET要求またはDELETE要求に要求フィールドを追加すると (listing、get、または削除のアクティビティ)、その操作ではフィールドが表示されないことを示すエラー メッセージが表示されます。

次の図は、 DELETE リソースに要求フィールドを追加しようとしたときに表示されるエラー メッセージを示しています。

要求フィールドと応答フィールドの設定

要求フィールドと応答フィールドに値を設定する方法は 2 つあります。

オプション 1 (推奨)

適切な形式の JSON を使用します。

1. リソースの [要求を送信 ] を選択します。
2. JSON を追加します。
3. [ 送信要求時にフィールドを上書き ] オプションが有効化されていることを確認します。
4. [Execute] を選択します。

応答が成功すると、[ 入力 ] フィールドに要求に使用された JSON プロパティが入力され、 出力 フィールドは応答に基づいて入力されます。

注:

この方法を使用する場合は、アクティビティで使用するすべてのフィールドを網羅した要求を行うようにしてください。

次の図は、 POST 要求のペイロードの例を示しています。[ 送信要求でフィールドを上書き ] フィールドが有効になっていることを確認します。

オプション 2

各要求フィールドと応答フィールドは、[ アクティビティ デザイナー ] タブから手動で追加できます。

1. [アクティビティ デザイナー] タブに移動します。

2. [入力] タブで、メニューの [その他のオプション] を選択します。

3. [ 要求フィールドを追加] を選択します。

4. パラメーターを追加するのと同様の方法で、要求フィールドの詳細を追加します。

   

5. 回答フィールドを追加するには、[ 出力 ] タブに移動し、[ 回答フィールドを追加 ] オプションを選択します。

   

出力フィールド

アクティビティ デザイナーの出力フィールドは、[応答] フィールドから取得されます。値は、リソースへの要求を正常に行うことによって設定できます。

選別されたフィールド

出力フィールドは 検査済みとしてマークできます。フィールド値は応答オブジェクトから抽出され、変数に割り当てることができるため、オートメーションで使用するときに他のアクティビティで簡単にアクセスして使用できます。

以下の画像は、選定されたフィールド である URL がアクティビティの [ 出力 ] セクションにどのように直接表示されるかを示しています。