> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parable.work/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Report (RaaS)

> Connect Parable to Workday using a Report-as-a-Service custom report URL and integration token

export const platform_0 = "Workday"

export const role_0 = undefined

<Tabs>
  <Tab title="Setup">
    <Card title="What You'll Need" icon="key">
      | Credential              | What it is                                                                                 |
      | ----------------------- | ------------------------------------------------------------------------------------------ |
      | **Custom Report Token** | Pre-encoded Basic auth token for the RaaS report (from Workday)                            |
      | **Tenant Name**         | Workday tenant identifier                                                                  |
      | **Custom Report URL**   | Full HTTPS URL to the RaaS report with `format=json`                                       |
      | **Base URL**            | *(Optional)* Workday services host override (e.g. `https://services1.wd501.myworkday.com`) |
    </Card>

    ## Overview

    The **Workday HRIS RaaS** connector ingests a single Workday custom report (Report-as-a-Service). Use this when your organization already publishes employee or org data via a dedicated RaaS URL rather than the REST Staffing API.

    <Warning>
      This connector does **not** call the Workday REST Staffing, Payroll, or Absence APIs. For those, use the [**Workday REST connector**](/connectors/workday/oauth/setup).
    </Warning>

    ## Prerequisites

    <Info>
      **Setup access in {platform_0}.** These steps require **{role_0}**, or a colleague with equivalent permissions who can create credentials for you.

      If that is not you, ask your {platform_0} administrator.
    </Info>

    * A published RaaS custom report with JSON output enabled
    * Integration token or ISU credentials encoded for Basic auth
    * Report URL copied from Workday (includes owner and report name)

    ## Setup Guide

    <Steps>
      <Step title="Copy the custom report URL">
        In Workday, open your custom report and copy the **Report URL** for JSON output. The URL typically looks like:

        ```
        https://services1.wd501.myworkday.com/ccx/service/customreport2/TENANT/owner/Report_Name?format=json
        ```
      </Step>

      <Step title="Obtain the integration token">
        Workday provides a pre-encoded Basic auth token for the integration system user, or base64-encoded `username:password` for the report ISU. Store this as the **Custom Report Token**.
      </Step>

      <Step title="Enter values in Parable">
        1. Select **Workday HRIS RaaS** in the connector catalog.
        2. Enter **Tenant Name**, **Custom Report URL**, and **Custom Report Token**.
        3. Optionally set **Base URL** if your tenant uses a non-default services host.
        4. Click **Save & test connection**.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Reference">
    <Check>
      **Success!** If you received a `200 OK` response with valid data, your credentials are configured correctly. You can now proceed to configure this connector in Parable.
    </Check>

    ## Troubleshooting

    | Error                | Meaning                  | Solution                                          |
    | -------------------- | ------------------------ | ------------------------------------------------- |
    | `401 Unauthorized`   | Invalid or expired token | Regenerate the ISU password or integration token  |
    | `404 Not Found`      | Wrong report URL         | Verify owner, report name, and tenant in the URL  |
    | Empty `Report_Entry` | Report returned no rows  | Confirm report criteria and security group access |

    ## Additional Resources

    <Card title="Workday REST connector" icon="cloud" href="/connectors/workday/oauth/setup">
      OAuth-based Staffing, Payroll, and Absence APIs
    </Card>
  </Tab>
</Tabs>