Skip to main content
Documentation
Documentation
Administrator Guide
Last Updated: 2023-06-23
Example: Create External Home Page Cards Orchestration

Example: Create External Home Page Cards Orchestration

This example illustrates how to set up an orchestration that displays data on a custom home page card.
Workday Extend customers can create Workday Today Cards using the Orchestration Builder. To enable Workday Extend, contact your Customer Base Account Executive.
You want to create a custom Workday Home Card that displays a greeting to the user viewing the card.
The Orchestration Builder tool is within Workday Extend. To build custom cards, you need to:
  • Have access to Workday Extend.
  • Have technical skills, knowledge, and capabilities.
  • Be familiar with APIs.
  1. Log into Workday Extend with your credentials.
  2. In the
    Apps
     menu tab, click
    Create New App
     from a blank template on the Home Page, and then name your app.
  3. Click
    Add Orchestration
     and then click
    Workday Today Card
     template.
  4. From the
    Components
     panel, drag
    Send Workday API Request
     and drop it between
    WORKDAY TODAY CARD REQUEST
     and
    Create Workday Today Card
    .
  5. Select the
    Send Workday API Request
     component you just dropped and:
    1. Double-click
      SendWorkdayAPIRequest
       to rename this step to
      Get Workday Employee Data
      .
    2. On the
      Properties
       panel, enter a
      Reference Name
       of
      getWorkdayEmployeeData
      .
    3. Click
      Edit Properties
      .
  6. Enter these values.
    1. On the
      GET
       request row, click the
      +
       icon, and paste
      /common/v1/workers/me
      .
      This API request returns the worker who is viewing the card.
      You must return a specific worker or else the API request won't work.
    2. Select
      Json
       as the Response Type on the
      Settings
      tab.
    3. Click
      Save Changes
      , then click
      Close
      .
  7. From the
    Components
     panel, drag
    Create Values
     and drop it between
    SEND WORKDAY API REQUEST
     and
    CREATE WORKDAY TODAY CARD
    . Select the
    Create Values
     component you just dropped and:
    1. Double-click
      CreateValues
       to rename the step to
      Create Workday Employee Data
      .
    2. On the
      Properties
       panel, enter a
      Reference Name
       of
      createWorkdayEmployeeData
      .
    3. Click
      Edit Properties
      .
  8. Enter these values:
    Option
    Description
    Type
    String
    Key
    fullName
    Value
    • Click the
      +
       icon and then select
      Data from Orchestration Steps > Send Workday API Request > response
      .
    • Hover over
      getWorkdayEmployeeData.response
      , click the
      fx
       icon, and select
      stringAtJsonPath
      .
    • Click
      path
      and enter
      $.descriptor
       to return the name of the worker viewing the card.
  9. Click
    Save Changes
    , then click
    Close
    .
  10. Select
    CREATE WORKDAY TODAY CARD
     and click
    Edit Properties
    .
  11. Enter these values:
    Option
    Description
    Source
    Workday Extend
    Title
    • Click the
      +
       icon and enter
      Hello
      .
    • Click the
      +
       icon again and select
      Data from Orchestration Steps > Create Values > fullName
      .
    Subtitle
    Have a great day!
    Link Description
    https://www.workday.com
    Link Text
    Workday
  12. Click
    Save Changes
    , then click
    Close
    .
  13. Click the
    Validate
     icon.
  14. Click
    Save to App Hub
    .
You create content for Workday Home tailored specifically to your organizational needs, and incorporate Workday data as well as third-party data to make a truly personalized experience.
Deploy the app to your tenant and access the
Create External Card
 task in Workday to enable workers to view the card.