--- auto_validation: true time: 15 author_name: Daniel Wroblewski author_profile: https://github.com/thecodester tags: [ tutorial>beginner, topic>cloud ] primary_tag: topic>cloud parser: v2 slug: joule-studio-codejam-4-skill-delayed canonical_url: https://developers.sap.com/tutorials/joule-studio-codejam-4-skill-delayed --- # 4 - Create Skill to Show Delayed Shipments Create a skill to return all shipments that are delayed. ## You will learn - How to create a Joule skill ## Prerequisites - You have completed the previous tutorial in the Joule Studio CodeJam Mission, [Create Skill to Track Shipments](joule-studio-codejam-3-skill-track). ## Intro In this skill, we will use the same API but provide different binding, specifically, a different filter so a list of all delayed shipments are returned. ### Create empty skill 1. In your project, select the **Overview** tab. 2. Click **Create**, and choose **Joule Skill**. ![Create skill](https://raw.githubusercontent.com/sap-tutorials/developer-advocates/main/tutorials/joule-studio-codejam-4-skill-delayed/1-empty-1.png) 3. In the **Create Joule Skill** dialog, enter the following details: | Field | Value | |---------------|-------------------------------------------| | **Name** | `Get Delayed Shipments` | | **Description** | `A skill to get all delayed shipments from the GTT system` | Click **Create**. ![Name skill](https://raw.githubusercontent.com/sap-tutorials/developer-advocates/main/tutorials/joule-studio-codejam-4-skill-delayed/1-empty-2.png) Once the Joule skill is created, you are taken to the skill builder. ### Add action to skill You will again add the action **getReadquery** to read data from the shipments app, but now you will change the filter to bring back only delayed shipments. 1. In the skill builder, click on the **+** button right under the trigger step. ![Add step](https://raw.githubusercontent.com/sap-tutorials/developer-advocates/main/tutorials/joule-studio-codejam-4-skill-delayed/2-action-1.png) Choose **Call Action** ![Call action](https://raw.githubusercontent.com/sap-tutorials/developer-advocates/main/tutorials/joule-studio-codejam-4-skill-delayed/2-action-2.png) 2. Since you previously used the **getReadquery** action, it now appears in the list of **Available Actions**. Click **getReadquery** to select it. ![getReadquery](https://raw.githubusercontent.com/sap-tutorials/developer-advocates/main/tutorials/joule-studio-codejam-4-skill-delayed/2-action-3.png) The action is added to the skill flow. ### Configure action Again, you need to map the action to a destination (that is, a specific backend), and also provided the filter for the API call. 1. Make sure the action is selected. 2. In the first, **General** tab, click inside the **Destination Variable** field. This time we do not have to create a new destination variable since we can reuse the one we created in the previous skill, since we are using the same action with the same destination (but different configuration). Select **GetFromGTT**. ![Pick destination](https://raw.githubusercontent.com/sap-tutorials/developer-advocates/main/tutorials/joule-studio-codejam-4-skill-delayed/3-configure-1.png) 5. You will now specify a different filter, this time to retrieve the delayed shipments. With the action selected, select the **Input** tab on the right-side pane. Click inside the **$filter** field, and select **Apply a Formula**. The formula editor opens. ![Bind filter](https://raw.githubusercontent.com/sap-tutorials/developer-advocates/main/tutorials/joule-studio-codejam-4-skill-delayed/3-configure-2.png) >**IMPORTANT:** DO NOT ENTER THE FORMULA DIRECTLY INTO THE FIELD. You must click **Apply a Formula** and enter the formula in the formula box. > >![Do not do this](https://raw.githubusercontent.com/sap-tutorials/developer-advocates/main/tutorials/joule-studio-codejam-4-skill-delayed/DoNot.png) Enter the following formula in the box: ```JavaScript ConcatenateStrings(["delayStatus eq ", true, ""], "") ``` ![Add formula](https://raw.githubusercontent.com/sap-tutorials/developer-advocates/main/tutorials/joule-studio-codejam-4-skill-delayed/3-configure-3.png) Click **Apply**. ### Add output parameter You need to create output parameters, so that the skill returns data to Joule (or to an agent), which can then use to determine the best response to the user. 1. Click the **Trigger** step. 2. Click the **Parameters** tab, and next to **Skill Outputs** click **Configure**. ![Configure output](https://raw.githubusercontent.com/sap-tutorials/developer-advocates/main/tutorials/joule-studio-codejam-4-skill-delayed/4-output-1.png) 4. Click **Add Ouput** and add the following output parameter. | **Name** | **Description** | **Type** | **Required** | **List** | |--------|------------|-----------|---------------|-----------| | `json` | `JSON` | Any | ✅ Checked| ✅ Checked | Click **Apply**. ![Add output](https://raw.githubusercontent.com/sap-tutorials/developer-advocates/main/tutorials/joule-studio-codejam-4-skill-delayed/4-output-2.png) 5. Click **Save** (upper right). ### Bind data to output parameters You created the output parameters to send data back to Joule or the agent. Now you need to supply the data. 1. Click the **End** step. ![Click end](https://raw.githubusercontent.com/sap-tutorials/developer-advocates/main/tutorials/joule-studio-codejam-4-skill-delayed/5-end-1.png) 2. For **json** output parameter, map it to **getReadquery > result > d > list - results**. ![Bind end](https://raw.githubusercontent.com/sap-tutorials/developer-advocates/main/tutorials/joule-studio-codejam-4-skill-delayed/5-end-2.png) 3. Click **Save** (upper-right). ### Test the skill 1. Click **Test** in the upper-right. ![Test](https://raw.githubusercontent.com/sap-tutorials/developer-advocates/main/tutorials/joule-studio-codejam-4-skill-delayed/6-test-1.png) 2. The **Test Project** dialog should already be populated with the correct details, since you already tested and specified values. | Field | Value | |---------------|-------------------------------------------| | **Environment** | Select the email address of your user | | **Environment variables > GetFromGTT** | Select **gttGetService** | Click **Continue**. ![Test variables](https://raw.githubusercontent.com/sap-tutorials/developer-advocates/main/tutorials/joule-studio-codejam-4-skill-delayed/6-test-2.png) A new browser tab opens with Joule. 3. As a prompt, enter the following: ```Prompt I would like to find all the delayed shipments ``` ![Prompt](https://raw.githubusercontent.com/sap-tutorials/developer-advocates/main/tutorials/joule-studio-codejam-4-skill-delayed/6-test-3.png) Joule will output a list of delayed shipments. ![Response](https://raw.githubusercontent.com/sap-tutorials/developer-advocates/main/tutorials/joule-studio-codejam-4-skill-delayed/6-test-4.png) 4. Once you are done testing, click **Stop Testing**. ![Stop testing](https://raw.githubusercontent.com/sap-tutorials/developer-advocates/main/tutorials/joule-studio-codejam-4-skill-delayed/6-test-5.png) ### Questions to ponder - Why can I set the type for an output parameter but not for an input parameter? - What is the purpose of actions?