Glossary: rephrase definitions of services and actions (#33769)

This commit is contained in:
c0ffeeca7 2024-07-16 12:01:58 +02:00 committed by GitHub
parent b52ea0eac1
commit 3234f35f39
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -12,14 +12,17 @@
definition: |- definition: |-
Actions are used in several places in Home Assistant. As part of a script or Actions are used in several places in Home Assistant. As part of a script or
automation, actions define what is going to happen once a trigger is automation, actions define what is going to happen once a trigger is
activated. In scripts, an action is called *sequence*. Actions use service activated. In scripts, an action is called *sequence*. An action is a **software
calls and/or scenes to interact with entities and cause these entities to do function that interacts with targets to make something happen**. Actions can use other actions
and/or scenes to interact with entities and cause these entities to do
something. Actions can also include conditions and a delay. An action can something. Actions can also include conditions and a delay. An action can
call multiple services at the same time. For example, if your presence is perform multiple actions at the same time. For example, if your presence is
detected in a room, an action may call one service to turn on a light and detected in a room, an action may perform one action to turn on a light and
call another service to start playing music after a delay. Actions are also perform another action to start playing music after a delay. Actions are also
used on the dashboard, for example as tap or hold action on a UI element. used on the dashboard, for example as tap or hold action on a UI element.
When triggered, the action calls a service. When triggered, the action performs another action. Home Assistant provides a series of predefined actions,
such as `homeassistant.turn_on`, `homeassistant.toggle`, or
`homeassistant.reload`.
aliases: aliases:
- actions - actions
link: /docs/automation/action/ link: /docs/automation/action/
@ -481,26 +484,11 @@
- selectors - selectors
- term: Service - term: Service
definition: |- definition: |-
The term service has 2 meanings in Home Assistant: **The information The term "service" in Home Assistant is used in the sense of an **information
service** For example, the municipal waste management service that provides service**. For example, the municipal waste management service that provides
entities for organic, paper, and packaging waste. In terms of functionality, entities for organic, paper, and packaging waste. In terms of functionality,
the information service is like a device. It is called *service* to avoid the information service is like a device. It is called *service* to avoid
confusion, as it does not come with a piece of hardware. **The software confusion, as it does not come with a piece of hardware.
function that interacts with targets to make something happen** A service
carries out one specific task, for example: turning on the light in the
living room or sending a notification to a mobile phone. A service has
targets and data. Service targets are: areas, devices, and entities. Service
data carries the information required to define the desired state change in
the target. For example, the target, together with brightness 150 and RGB
color `[255,0,0]`, or the message “Your coffee is ready”. Services can be
used in, for example, automation, scripts, dashboards, or voice commands to
control your home. Home Assistant provides a series of predefined services,
such as `homeassistant.turn_on`, `homeassistant.toggle`, or
`homeassistant.reload`.
excerpt: >
A service carries out one specific task, for example: turn on the light in
the living room. A service has targets and data and can be called by
actions, a dashboard, or via voice command.
link: /docs/scripts/service-calls/ link: /docs/scripts/service-calls/
aliases: aliases:
- services - services