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.
You must have access to Workday Journeys and Workday Extend to create and display external links for custom cards on the Workday Home page. Contact your Customer Base Account Executive for details.
You might need to take additional steps to enable this feature depending on your organization's subscription service agreement. For more information, see this Community article.
You want to create a custom Workday Home Card that displays a greeting to the user viewing the card.
Orchestration Builder is a tool on the Workday Developer Site. 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 the Workday Developer Site with your credentials.
  2. Click
    Create an Extend App
    , then click
    Start from Scratch
    .
  3. Name your app and, optionally, provide a description. Click
    Create and Go to Overview
    .
  4. Click
    Add Orchestration
     and then select the
    Workday Home Card
     template.
  5. Name your orchestration.
  6. From the
    Components
     panel, drag
    Send Workday API Request
     and drop it between
    Workday Home Card Request
     and
    CREATE WORKDAY HOME CARD
    .
  7. 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
      .
  8. 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
      .
  9. From the
    Components
     panel, drag
    Create Values
     and drop it between
    SEND WORKDAY API REQUEST
     and
    CREATE WORKDAY HOME 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
      .
  10. 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.
  11. Click
    Save Changes
    , then click
    Close
    .
  12. Select
    CREATE WORKDAY HOME CARD
     and click
    Edit Properties
    .
  13. 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
  14. Click
    Save Changes
    , then click
    Close
    .
  15. Click the
    Validate
     icon.
  16. 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.