Skip to content

Commit 86733af

Browse files
committed
update actions
1 parent 336e1a8 commit 86733af

File tree

1 file changed

+19
-14
lines changed

1 file changed

+19
-14
lines changed

powerapps-docs/maker/data-platform/actions.md

Lines changed: 19 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
2-
title: "Use actions | MicrosoftDocs"
3-
description: "With actions, you can perform operations, such as Create, Update, Delete, Assign, or Perform Action. Internally, an action creates a custom message."
2+
title: "Use custom process actions | MicrosoftDocs"
3+
description: "With custom process actions, you can perform operations, such as Create, Update, Delete, Assign, or Perform Action. Internally, an custom process action creates a custom message."
44
ms.custom: ""
5-
ms.date: 08/07/2018
5+
ms.date: 04/28/2021
66
ms.reviewer: ""
77
ms.service: powerapps
88
author: MSFTMAN
@@ -19,25 +19,30 @@ search.audienceType:
1919
- flowmaker
2020
- enduser
2121
---
22-
# Use actions
2322

23+
# Use Custom process actions
2424

25-
[!INCLUDE[cc-data-platform-banner](../../includes/cc-data-platform-banner.md)]
26-
27-
Actions open a range of possibilities for composing business logic. With actions, you can perform operations, such as Create, Update, Delete, Assign, or Perform Action. Internally, an action creates a custom message. Developers refer to these actions as *messages*. Each of these messages is based on actions taken on a table row. If the goal of a process is to create a row, then update it, and then assign it, there are three separate steps. Each step is defined by the capabilities of the table—not necessarily your business process.
25+
Custom process actions, also known as *Custom actions*, or just *actions*. open a range of possibilities for composing business logic. With custom process actions, you can perform operations, such as Create, Update, Delete, Assign, or Perform Action. Internally, a custom process action creates a custom message. Developers refer to these actions as *messages*. If the goal of a process is to create a row, then update it, and then assign it, there are three separate steps. Each step is defined by the capabilities of the table—not necessarily your business process.
2826

29-
Actions provide the ability to define a single verb (or message) that matches an operation you need to perform for your business. These new messages are driven by a process or behavior rather than what can be done with a table. These messages can correspond to verbs like Escalate, Convert, Schedule, Route, or Approve—whatever you need. The addition of these verbs helps provide a richer vocabulary for you to fluently define your business processes. You can apply this richer vocabulary from clients or integrations rather than having to write the action within clients. This also makes it easier because you can manage and log the success or failure of the entire action as a single unit.
27+
Custom process actions provide the ability to define a single verb (or message) that matches an operation you need to perform for your business. These new messages are driven by a process or behavior rather than what can be done with a table. These messages can correspond to verbs like Escalate, Convert, Schedule, Route, or Approve—whatever you need. The addition of these verbs helps provide a richer vocabulary for you to fluently define your business processes. You can apply this richer vocabulary from clients or integrations rather than having to write the action within clients. This also makes it easier because you can manage and log the success or failure of the entire action as a single unit.
3028

31-
<a name="BKMK_ConfigurableMessages"></a>
32-
## Configurable messages
33-
Once an action is defined and activated, a developer can use that message like any of the other messages provided by the platform. However, a significant difference is that now someone who is not a developer can apply changes to what should be done when that message is used. You can configure the action to modify steps as your business processes change. Any custom code that uses that message does not need to be changed as long as the process arguments do not change.
29+
<a name="BKMK_ConfigurableMessages"></a>
30+
31+
## Configurable messages
32+
33+
Once an custom process action is defined and activated, a developer can use that message like any of the other messages provided by the platform. However, a significant difference is that now someone who is not a developer can apply changes to what should be done when that message is used. You can configure the custom process action to modify steps as your business processes change. Any custom code that uses that message does not need to be changed as long as the process arguments do not change.
3434

35-
Workflow processes and plug-ins continue to provide similar capabilities for defining automation. Workflow processes still provide the capability for a non-developer to apply changes. But the difference is in how the business processes are composed and how a developer can write their code. An action is a message that operates on the same level as any of the messages provided by the platform. Developers can register plug-ins for actions.
35+
Workflow processes and plug-ins continue to provide similar capabilities for defining automation. Workflow processes still provide the capability for a non-developer to apply changes. But the difference is in how the business processes are composed and how a developer can write their code. A custom process action is a message that operates on the same level as any of the messages provided by the platform. Developers can register plug-ins for actions.
36+
37+
> [!NOTE]
38+
> If you intend to write a plug-in to implement your logic for a custom process action instead of using the workflow designer, you should use Custom API instead. More information: [Compare Custom Process Action and Custom API](../../developer/data-platform/custom-actions.md#compare-custom-process-action-and-custom-api)
39+
3640

37-
<a name="BKMK_GlobalMessages"></a>
41+
<a name="BKMK_GlobalMessages"></a>
42+
3843
## Global messages
3944

40-
Unlike Microsoft Dataverse workflows or [plug-ins](../../developer/data-platform/apply-business-logic-with-code.md?branch=master#create-a-plug-in), an action doesn’t have to be associated with a specific table. You can define global actions that can be called on their own.
45+
Unlike Microsoft Dataverse workflows, an action doesn’t have to be associated with a specific table. You can define global actions that can be called on their own.
4146

4247
## Next steps
4348

0 commit comments

Comments
 (0)