レポートを取得

UiPath.Workday.Activities.GetReport

[ レポートを取得] アクティビティは、SOAP ベースの レポートをサービス (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 - エラー メッセージです。
• Results - DataTable オブジェクトに返される取得したレポートです。 DataTable 型変数を入力します。このプロパティは、[ レポート URL] の値で次のいずれかのレポート形式 (例: ../service/systemreport2/uipath_dpt1/Worker_Details) を指定した場合は適用されません。format=gdata):csv、gdata、json、rss、simpelxml
  • [レポート URL ] に上記の形式のいずれかが含まれている場合は、[ ResultsNative ] プロパティを使用します。
  • 設計時には、 オブジェクト ウィザード は、指定した形式の種類に関係なく、常にレポートを表形式で表示します。
• ResultsNative - String オブジェクトで返されるレポートのネイティブ形式です。 String 型変数を入力します。 [レポート URL ] の値が以下のいずれかのレポート形式を指定している場合、結果は次のリストに従って String として返されます (例: .../service/systemreport2/uipath_dpt1/Worker_Details?format=gdata):
  • CSV ファイルに保存すると、結果は String として返されます。
  • csv - コンマ区切りの文字列
  • gdata - gdata 形式の json 文字列
  • json - json 文字列
  • rss - 通常の xml 文字列です。

  • simplexml - 簡体字の xml 文字列です。

    メモ： 設計時には、 オブジェクト ウィザード は、指定した形式の種類に関係なく、常にレポートを表形式で表示します。

例

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

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