jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-18 23:06:58 +00:00
Code Issues Packages Projects Releases Wiki Activity

2024.8: Finalize services -> actions

Browse Source
This commit is contained in:
Franck Nijhof 2024-08-07 17:28:30 +02:00
parent 9c6a7014c0
commit 978c54170a
No known key found for this signature in database
GPG Key ID: D62583BA8AB11CA3
1 changed files with 15 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
source/_posts/2024-08-07-release-20248.markdown
View File

@ -153,28 +153,27 @@ by this change, nothing breaks with this, and everything will continue to work
just as it did before. just as it did before.
In the 2024.1 release, we [unified the actions](/2024/01/03/release-20241/#unified-actions) In the 2024.1 release, we [unified the actions](/2024/01/03/release-20241/#unified-actions)
in the Home Assistant automation & script editors. The goal of that change in the Home Assistant {% term automation %} & script editors. The goal of
was to make our automation editor easier to understand for newer users, by that change was to make our automation editor easier for newer users to
removing the "Service call" layer and terminology. understand by removing the “Service call” layer and terminology.
<img class="no-shadow" src="/images/blog/2024-01/add-action-search.png" alt="Screenshot showing the new add action dialog utilizing the search function to find whatever you need."> <img class="no-shadow" src="/images/blog/2024-01/add-action-search.png" alt="Screenshot showing the new add action dialog utilizing the search function to find whatever you need.">
The above screenshot shows the UI that has been in use since the January release, The above screenshot shows the UI that has been in use since the [January release](/2024/01/03/release-20241/),
and was very well received in general. However, the underlying terminology and was very well received in general. However, the underlying terminology
in our documentation and all other places in Home Assistant was still using in our documentation and all other places in Home Assistant still used the
the "service call" terminology. "service call" terminology.
Additionally, the term "services" in Home Assistant is overloaded and ambiguous. Additionally, the term "services" in Home Assistant is overloaded and ambiguous.
It is used for both the services you can call in Home Assistant, but also for It is used for both the services you can call in Home Assistant and services you
services you might integrate with, like a weather or music service. might integrate with, like weather or music services. In the latter case, we
In the latter case, we are talking about integrating with a service provided by are talking about integrating with a service provided by a program or website,
a program or website, which is referenced in our Settings page as which is referenced in our Settings page as **Devices & services**. 😵‍💫
**Devices & services**. 😵‍💫
To make things more clear, we are now changing the terminology around _service calls_ in Home Assistant To make things more clear, we are now changing the terminology around
from "services" to "actions" **everywhere**. _service calls_ in Home Assistant from "services" to "actions" **everywhere**.
Every occurance in the documentation, the UI, the code, and everywhere else Every occurrence in the documentation, the UI, the code, and everywhere else
in Home Assistant, has been replaced with "action". Unlike the previous services in Home Assistant, has been replaced with "action". Unlike the previous services
which were "called", actions are "performed". which were "called", actions are "performed".
@ -182,7 +181,7 @@ which were "called", actions are "performed".
{% important %} {% important %}
If you are writing automations in YAML, you will notice that the `service` key If you write automations in YAML, you will notice that the `service` key
in your actions is now called `action`. For example: in your actions is now called `action`. For example:
```yaml ```yaml
@ -193,7 +192,7 @@ in your actions is now called `action`. For example:
Existing UI-managed automations will be automatically converted the next time they Existing UI-managed automations will be automatically converted the next time they
are edited and saved. If you write automation in YAML, you can are edited and saved. If you write automation in YAML, you can
use either `action` or `service` as this change is fully backward compatible, use either `action` or `service`, as this change is fully backward compatible,
but we recommend using `action` from now on. but we recommend using `action` from now on.
{% endimportant %} {% endimportant %}