レポートを取得

UiPath.Workday.Activities.GetReport

[ レポートを取得] アクティビティは、SOAP ベースの Reports as a Service (RaaS) を使用して、指定したレポート ([レポート URL]) を取得します。

レポートを取得した後、アクティビティはレポートを DataTable ([結果]) またはネイティブの String 形式 ([結果ネイティブ]) で出力します。さらに、このアクティビティは Web サービス要求のステータス (成功/失敗情報) を、後続のアクティビティ (例: 条件ロジック) で使用できる ResponseStatus オブジェクト ([応答ステータス]) に出力します。

動作のしくみ

以下の手順とメッセージ シーケンス ダイアグラムは、設計時 (つまり、アクティビティの依存関係と入/出力プロパティ) から実行時に至るまでの、アクティビティの動作のしくみの例を示したものです。

1. 「セットアップ」の手順を完了します。
2. プロジェクトに [ Workday スコープ ] アクティビティを追加します。
3. [Workday スコープ] アクティビティ内に [レポートを取得] アクティビティを追加します。
4. [レポートを取得] アクティビティの [設定] ボタンをクリックします (オブジェクト ウィザードが開きます)。
5. 取得する レポート URL を入力します。
   • 設計時にレポート URL を検証するには、[ レポートを取得 ] ボタンをクリックして、実行時に返される結果を表示します。
6. [出力] セクションのプロパティのために DataTable 型変数、String 型変数、および ResponseStatus 型変数を作成し、入力します。

   • 要求は 、サービスとしてのレポート (RaaS) に送信されます。

   • 操作は、DataTable、String、ResponseStatus の値を、出力プロパティ変数に返します。

     

アクティビティの本体

[レポートを取得] のプロパティ値を入力するには、[設定] ボタンをクリックしてオブジェクト ウィザードを使用する必要があります。

オブジェクト ウィザードの詳細については、「ビジネス アクティビティのフレームワーク」のページをご覧ください。

プロパティ

共通

• 表示名 - アクティビティの表示名です。このフィールドは Strings または String 型変数のみをサポートします。

入力

• レポート URL - 取得するレポートの URL です。String または String の変数を入力します。設計時に URL を検証するには、[ 設定 ] ボタンをクリックし、 レポート URL を入力して [ レポートを取得 ] をクリックし、実行時に返される結果を表示します。
  • 詳細については、Workday ドキュメントの「 RaaS 出力にアクセスする 」をご覧ください。

その他

• プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。

出力

• 応答ステータス - 要求のステータスです (成功/失敗に関する情報)。ResponseStatus 型変数を入力します (UiPath.BAF.Models.ResponseStatus)。ResponseStatus オブジェクトには、他のアクティビティで使用できる 3 つのプロパティが含まれています。
  • Success - Boolean - API 要求が成功したかどうかを示します。
  • ErrorCode - String - API 要求が成功しなかった場合の応答エラーです (Success = False)。
  • Message - String - エラー メッセージです。
• 結果 - DataTable オブジェクトで返される、取得したレポートです。DataTable変数を入力します。このプロパティは、 ReportURL 値が *.../service/systemreport2/uipath_dpt1/Worker_Details?*format=gdata のいずれかのレポート形式 (例: *.../service/systemreport2/?*format=gdata) を指定している場合には適用されません。
  • ReportURL に上記の形式のいずれかが含まれている場合は、ResultsNative プロパティを使用します。
  • デザイン時に、 オブジェクト ウィザード は、指定された形式の種類に関係なく、常に表形式でレポートを表示します。
• ResultsNative - String オブジェクトで返されるレポートのネイティブ形式です。String変数を入力します。ReportURL 値で次のいずれかのレポート形式が指定されている場合、結果は次のリストに従ってStringとして返されます (例: *.../service/systemreport2/uipath_dpt1/Worker_Details?*format=gdata)。
  • CSV ファイルに保存すると、結果は String として返されます。
  • csv - コンマ区切りの文字列
  • gdata - gdata 形式の json 文字列
  • json - json 文字列
  • rss - 通常の xml 文字列です。
  • simplexml - 簡体字の xml 文字列です。
    注:

    デザイン時に、 オブジェクト ウィザード は、指定された形式の種類に関係なく、常に表形式でレポートを表示します。

例

次の画像は、アクティビティの依存関係と入力/出力プロパティの値の例です。

ステップバイステップの手順および例は、クイックスタート ガイドをご覧ください。