--- author_name: Martin Plummer author_profile: https://github.com/mhplum keywords: tutorial auto_validation: true time: 20 tags: [ tutorial>beginner, software-product>sap-business-technology-platform, tutorial>license] primary_tag: software-product>sap-build parser: v2 slug: joulestudio-skill-action-filter canonical_url: https://developers.sap.com/tutorials/joulestudio-skill-action-filter --- # Create a Filter in an Action Project Create a filter in an action project to simplify the use of the OData service in Joule Studio, classic edition. ## Prerequisites - Access to an SAP BTP tenant configured for Joule and Joule Studio, classic edition. See [Set Up Joule Studio](https://help.sap.com/docs/Joule_Studio/45f9d2b8914b4f0ba731570ff9a85313/04b323352fa645238211ce017f634d34.html) or the [Discovery Center mission](https://discovery-center.cloud.sap/missiondetail/4651/4940/). - You have [configured the destinations to the OData services](joulestudio-skill-environment-setup) - You have [created and configured the action projects](joulestudio-skill-action-create) ## 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 ### Copy action project for BusinessPartner service 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**. 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**. ![Actions save as new project](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-action1.png) 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**. ![Save as new project popup](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-action2.png) 7. Choose the new project. ![Actions](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-action3.png) 8. Choose the **GET Retrieves business partner general data** action. 9. On the **Input** tab, choose **Add**. ![Actions add input](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-action4.png) 10. Choose **New Field**. 11. Enter **`FirstName`** as the **Key** and the **Label**, then choose **Add**. ![Actions add new field](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-action5.png) 12. Choose the **Value** field of **$filter**. 13. In the side panel **$filter**, choose the **Value** field to open the **Condition Editor**. ![Filter popup](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-action7.png) 14. For **Column**, **Condition**, and **Criteria**, select **`FirstName`**, **`equal to`**, and **`${FirstName}`** respectively. Then choose choose **OK**. ![Condition Editor](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-action9.png) 15. Choose the **Test** tab. 16. Enter **`Jane`** in the **FirstName** field, then choose **Test**. ![Actions test](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-action12.png) 17. Choose **Save**, then **Release**, and finally **Publish**. ![Actions published](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-action13.png) ### Create a Joule Skill 1. Go to the **SAP Build Lobby** ![Lobby](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-skill1.png) 2. Choose **Create**. ![Create Project](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-skill2.png) 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](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-skill3.png) 5. Choose **Review**, then choose **Create**. 6. In Joule Studio classic, choose **Create** **>** **Joule Skill**. ![Joule Studio](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-skill6.png) 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](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-skill7.png) 8. Choose **Create**. 9. Choose **Trigger** to open the side panel. 10. Enable **Allow Joule to generate a response**. ![Joule Studio generate responses](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-skill10.png) 11. Choose **Parameters**, then choose **Configure** beside **Skill Inputs**. ![Joule Studio parameters](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-skill10c.png) 12. Choose **Add Input**. Enter **`FirstName`** for **Name**, **`First name of employee`** for **Description**, and select **Required**. ![Joule Studio configure skill inputs](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-skill12.png) 13. Choose **Apply** 14. Choose **Configure** beside **Skill Outputs**. ![Joule Studio parameters](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-skill12c.png) 15. Choose **Add Output** 16. Enter: - **Name** **`Employees`** - **Description** **`Employees`** - **Type** **`Any`** - **List** **`Select`** ![Joule Studio configure skill outputs](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-skill12b.png) 17. Choose **Apply**. 15. Close the side pane and choose **Save**. ### Add Action to Joule Skill 1. Choose the **+**. ![Joule Studio select action](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-skill14.png) 2. Choose **Action**. ![Joule Studio browse actions](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-skill15.png) 3. Choose **Browse All Actions**. ![Joule Studio add action](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-skill16.png) 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](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-skill17.png) 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](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-skill20.png) 11. Choose the **Outputs** tab just to see the output. ![Joule Studio outputs](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-skill21.png) 12. Close the pane and choose **Save**. ### Configure End 1. Choose the **End** element. 2. Choose the **Employees** field to open the **Skill Content** pane. 22. Choose **{..} list - results**. ![Joule Studio configure end](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-skill22.png) 23. Choose **Save**. ### Release and Deploy 1. Choose **Release**. ![Joule Studio release](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-release2.png) 2. Choose **Release**. ![Joule Studio show project version](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-release3.png) 3. Choose **Show project version**, to change to the released version. 4. Choose **Deploy**. ![Joule Studio deploy](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-deploy1.png) 5. Select your environment and choose **Deploy**. 6. Select your **S4HANA_MOCK** destination and choose **Deploy**. ![Joule Studio deployed](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-deploy2.png) ### Test Joule Skill 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](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-test5.png) 5. Choose **Launch**. ![Joule conversation](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-test6.png) 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](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-test8.png) 8. Choose **Send**. ![Joule conversation message](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-test9.png) 9. Enter **`Thanks, I meant you to check if John is in the system.`**, then choose **Send**. ![Joule conversation](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joulestudio-skill-action-filter/joulestudio-skill-test10.png) 10. You can select any of the employees in the list to see their details. ### Test yourself