Skip to content

Commit fd2eab5

Browse files
committed
Added action property and image example
1 parent b1db153 commit fd2eab5

File tree

2 files changed

+47
-4
lines changed

2 files changed

+47
-4
lines changed

docs/actions-and-automations/create-self-service-experiences/create-self-service-experiences.md

Lines changed: 47 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -232,6 +232,10 @@ Create a blueprint for `Action run`:
232232
"type": "string",
233233
"title": "Updated At",
234234
"format": "date-time"
235+
},
236+
"action": {
237+
"type": "string",
238+
"title": "Action"
235239
}
236240
},
237241
"required": []
@@ -289,7 +293,8 @@ To add it, follow these steps:
289293
"run_url": "https://app.port.io/organization/run?runId={{.event.diff.after.id}}",
290294
"status": "{{.event.diff.after.status}}",
291295
"created_at": "{{.event.diff.after.createdAt}}",
292-
"updated_at": "{{.event.diff.after.updatedAt}}"
296+
"updated_at": "{{.event.diff.after.updatedAt}}",
297+
"action": "{{.event.diff.after.action.title}}"
293298
},
294299
"relations": {}
295300
}
@@ -300,12 +305,50 @@ To add it, follow these steps:
300305
</details>
301306

302307
Once implemented, you can track your self-service action runs and see how they are progressing.
303-
For example, you can create the following widget to vizualize the distribution of action runs by their status:
308+
309+
For example, you can create the following widget to vizualize how `Action runs` are distributed by status for a specific `Action` over the past month:
304310

305311
1. Click **`+ Widget`** and select **Pie chart**.
306312

307-
2. Title: `Action run by status`.
313+
2. Title: `Action runs by status`.
308314

309315
3. Choose the `Action run` blueprint.
310316

311-
4. Under `Breakdown by property`, select the **status** property.
317+
4. Under `Breakdown by property`, select the **status** property.
318+
319+
5. Under `Additional filters` you can choose to filter by:
320+
- `Action runs` that were created in the last month.
321+
- `Action runs` of a specific self-service action.
322+
323+
Click on `filters`, then on `{...} Edit JSON`, and add the following snippet with your action title and relevant time frame.
324+
Below is an example JSON:
325+
326+
<details>
327+
<summary><b>filters JSON example (click to expand)</b></summary>
328+
``` json showLineNumbers
329+
{
330+
"combinator": "and",
331+
"rules": [
332+
{
333+
"property": "created_at",
334+
"operator": "between",
335+
"value": {
336+
"from": "2025-07-23T21:00:00.000Z",
337+
"to": "2025-08-23T21:00:00.000Z"
338+
}
339+
},
340+
{
341+
"property": "action",
342+
"operator": "=",
343+
"value": "<THE_ACTION_TITLE>"
344+
}
345+
]
346+
}
347+
```
348+
</details>
349+
350+
6. Click `Save`.
351+
352+
This will result in a widget similar to the following:
353+
354+
<img src='/img/self-service-actions/actionRunsByStatusPieChart.png' width='50%' border='1px' />
56.3 KB
Loading

0 commit comments

Comments
 (0)