Skip to Content

Create a Filter in an Action Project

Requires Customer/Partner License
Create a filter in an action project to simplify the use of the OData service in Joule Studio.
You will learn
  • How to adjust the input of an action and create a custom filter
  • How to use the filter in a Joule skill
  • How to get Joule to automatically generate the conversation message
mhplumMartin PlummerJuly 15, 2025
Created by
mhplum
July 15, 2025
Contributors
mhplum

Prerequisites

  • Step 1
    1. Open SAP Build Lobby.

      The lobby is a central page for creating, accessing, and managing your projects in SAP Build.

    2. Choose Connectors, then choose Actions.

      Actions save as new project
    3. Select your API_BUSINESS_PARTNER action project, then choose Versions.

    4. Choose by the Published to Library version, then choose Save As New Project.

      Save as new project popup
    5. Enter:

      • FilterBusinessPartners for the Project Name.
      • This is to give Joule access to information about business partners. An extra input field is added to simplify the use of the filter. for the Description.
    6. Choose Save As New.

      Actions
    7. Choose the new project.

      Actions add input
    8. Choose the GET Retrieves business partner general data action.

    9. On the Input tab, choose Add.

      Actions add new field
    10. Choose New Field.

    11. Enter FirstName as the Key and the Label, then choose Add.

    12. Choose the Value field of $filter.

      Filter popup
    13. In the side panel $filter, choose the Value field to open the Condition Editor.

      Condition Editor
    14. For Column, Condition, and Criteria, select FirstName, equal to, and ${FirstName} respectively. Then choose choose OK.

    15. Choose the Test tab.

    16. Enter Jane in the FirstName field, then choose Test.

      Actions test
    17. Choose Save, then Release, and finally Publish.

      Actions published
  • Step 2
    1. Go to the SAP Build Lobby

      Lobby
    2. Choose Create.

      Create Project
    3. Choose Joule Skill, then choose Next.

    4. Enter name SearchWithName and description Uses an Action containing a mapped condition to filter on the FirstName..

      Create Project
    5. Choose Review, then choose Create.

    6. In Joule Studio, choose Create > Joule Skill.

      Joule Studio
    7. Enter:

      • SearchWithFirstName for Name.
      • Retrieve information about employees with a given first name. Usually John or Jane is used for Description.
      Create Joule Skill popup
    8. Choose Create.

    9. Choose Trigger to open the side panel.

    10. Enable Allow Joule to generate a response.

      Joule Studio generate responses
    11. Choose Parameters, then choose Configure beside Skill Inputs.

      Joule Studio parameters
    12. Choose Add Input. Enter FirstName for Name, First name of employee for Description, and select Required.

      Joule Studio configure skill inputs
    13. Choose Apply

    14. Choose Configure beside Skill Outputs.

      Joule Studio parameters
    15. Choose Add Output

    16. Enter:

      • Name Employees
      • Description Employees
      • Type Any
      • List Select
      Joule Studio configure skill outputs
    17. Choose Apply.

    18. Close the side pane and choose Save.

  • Step 3
    1. Choose the +.

      Joule Studio select action
    2. Choose Action.

      Joule Studio browse actions
    3. Choose Browse All Actions.

      Joule Studio add action
    4. Select the GET Retrieves business partner general data action of the project FilterBusinessPartners and choose Add beside it.

    5. Choose Select a Destination Variable, then + Create Destination Variable.

    6. Enter S4HANA_MOCK and BusinessPartner API, followed by Create.

      Joule Studio destination variable
    7. Select the destination variable.

    8. Choose the Inputs tab.

    9. Choose the FirstName field to open the Skill Content pane.

    10. Choose FirstName in the Skill Content pane to map to the selected FirstName field.

      Joule Studio map input
    11. Choose the Outputs tab just to see the output.

      Joule Studio outputs
    12. Close the pane and choose Save.

  • Step 4
    1. Choose the End element.

    2. Choose the Employees field to open the Skill Content pane.

    3. Choose {..} list - results.

      Joule Studio configure end
    4. Choose Save.

  • Step 5
    1. Choose Release.

      Joule Studio release
    2. Choose Release.

      Joule Studio show project version
    3. Choose Show project version, to change to the released version.

    4. Choose Deploy.

      Joule Studio deploy
    5. Select your environment and choose Deploy.

    6. Select your S4HANA_MOCK destination and choose Deploy.

      Joule Studio deployed
  • Step 6
    1. Open the SAP Build Lobby

    2. Choose Control Tower, then choose the Environments tile.

    3. Choose your environment.

    4. Choose the Joule tab.

      Environment
    5. Choose Launch.

      Joule conversation
    6. Choose New Conversation.

    7. Enter I am at the front desk in the reception area. A person claiming to be an employee is here. Can you check if Jane is in the system?

      Joule conversation prompt
    8. Choose Send.

      Joule conversation message
    9. Enter Thanks, I meant you to check if John is in the system., then choose Send.

      Joule conversation
    10. You can select any of the employees in the list to see their details.

  • Step 7

    When you get Joule to generate the response message, where do you configure the data mapping?

Back to top