概念: Reports as a Service (RaaS)
RaaS の紹介
詳細レポートや検索レポートを Web サービスとして有効化できます。Workday Web サービスを使用すると、URL を介したレポート結果へのアクセスが可能になります。この Web サービスは以下で使用できます。
- カスタム Workday Extend アプリケーション
- Workday と外部ビジネス サービスとのインテグレーション例: 給与計算や福利厚生プロバイダ。
- Workday データにアクセスするための外部レポート ツール。例: Microsoft Excel
Web サービスの出力オプションには、以下のものがあります。
- CSV
- GData
- JSON
- RSS
- 簡易 XML
- Workday XML
スタンダード レポートを Web サービスとして有効にする前に、スタンダード レポートをカスタム レポートにコピーすることを検討してください。Workday でスタンダード レポートが更新された場合にインテグレーション プロセスが中断されないようにするには、代わりにカスタム レポートを Web サービスとして有効にします。
Web サービスとしてカスタム レポートを有効にし、レポート所有者のユーザー名にバックスラッシュ (\) 文字が含まれていると、GET RaaS リクエストは失敗します。
RaaS 名前空間
Web サービスとしてカスタム レポートを有効にすると、レポート用に一意の RaaS 名前空間が次のフォーマットで生成されます。
urn:com.workday.report/
Report_Name
レポート出力を使用するインテグレーションの中断を最小限に抑えるため、レポート名やレポート オーナーが変更されても、RaaS 名前空間は変更されません。
カスタム レポートのネームスペースを編集できます。ただし、以下を考慮してください。
- Workday では、RaaS 名前空間が一意かどうかは検証されません。
- インテグレーションでレポートを Web サービスとして使用する場合は、新しい名前空間で更新する必要があります。
Web サービス出力タイプ
出力タイプ | 説明 |
|---|---|
CSV | CSV 出力オプションは、できるだけシンプルかつ迅速にスプレッドシートにデータをインポートしたい場合に使用できます。XML やスキーマの知識は必要ありません。
UTF-8 エンコーディングを使用する CSV ファイルにデータを出力する場合は、以下のクエリー パラメータを Web サービスの URL に追加します。 &bom=true このパラメータにより、Microsoft Excel などの他のアプリケーションは、エンコーディングを正しく解釈して、CSV ファイル内の文字を表示できます。 "グループ列見出し" がある詳細レポートの場合、CSV 出力に列のグループ化または列グループの見出しは保持されません。CSV 出力に含まれる列は、レポート定義に含まれる列の順序と一致しない場合があります。 |
GData | Google デバイスとのインテグレーションに GData 出力を使用できます。 |
JSON | JSON 出力オプションは、JSON 形式が必要なシステム間のインテグレーションで使用できます。 |
RSS | 詳細カスタム レポートはすべて RSS Web サービスとして有効化でき、ユーザーはそのサービスを RSS フィードとしてサブスクライブできます。ユーザーは、Workday にログインすることなく、RSS フィードを通じてテナントの更新をモニタリングできます。 |
シンプル XML | シンプル XML では、Workday XML を簡素化して、他のデスクトップ アプリケーションが処理できるようにします。シンプル XML 変更:
シンプル XML を使用することで、Microsoft Excel や社割レポートなど、他のレポート ツールとの基本的なデスクトップ インテグレーションを行うことができます。 シンプル XML 出力オプションでは、以下の URL が提供されます。
|
Workday XML | Workday XML オプションは、Workday からリテラル XML コードを出力します。このオプションは、REST または SOAP ベースのインテグレーションで役立つ場合があります。Workday XML は、一部のインテグレーション ニーズに対して複雑すぎる場合があります。例: Microsoft Excel を使用してリフレッシュ可能なレポートをすばやく作成する場合。このような場合、Simple XML の方が適切である可能性があります。
Workday XML 出力オプションでは、次の 3 つの URL が提供されます。
|