Skip to content

Commit aef4983

Browse files
committed
Updated text and images
1 parent a6b68f6 commit aef4983

File tree

5 files changed

+16
-12
lines changed

5 files changed

+16
-12
lines changed
6.62 KB
Loading
79.6 KB
Loading
Binary file not shown.
Binary file not shown.

powerapps-docs/developer/data-platform/register-plug-in.md

Lines changed: 16 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -18,18 +18,22 @@ contributors:
1818

1919
[!INCLUDE[cc-terminology](includes/cc-terminology.md)]
2020

21-
After a plug-in is written and compiled, it must be registered with the event framework to execute when a specific entity type (table) and operation (message) is processed by Dataverse. To register a plug-in with the Dataverse event framework requires use of a tool - Plug-in Registration tool (PRT), or the Power Platform Tools extension for Visual Studio.
21+
After a plug-in is written and compiled, it must be registered with the event framework to execute when a specific entity type (table) and operation (message) is processed by Dataverse. To register a plug-in with the Dataverse event framework requires use of a tool - Plug-in Registration tool (PRT), or the Power Platform Tools extension for Visual Studio.
2222

23-
The PRT specializes in object registrations and editing those registrations. This article describes how to register a plug-in assembly and step using the Plug-in Registration tool.
23+
The PRT creates Dataverse object registrations and supports editing those registrations. This article describes how to register a plug-in assembly and step using the Plug-in Registration tool.
2424

25-
The Visual Studio extension provides a more feature rich development environment and covers the entire coding, deployment, and debugging/profiling flow. For information about using the Power Platform Tools extension for Visual Studio see [quickstart](tools/devtools-create-plugin.md).
25+
The Visual Studio extension provides a more feature rich development environment and covers the entire coding, deployment, and debugging/profiling development process. For information about using the Power Platform Tools extension for Visual Studio, see the [quickstart](tools/devtools-create-plugin.md).
2626

27-
## Plug-in Registration tool
27+
More information: [Event framework](event-framework.md)
2828

29-
The Plug-in Registration tool (PRT) enables you to register your plug-in assemblies, and other types of objects, with Dataverse. PRT is one of several Dataverse tools available for download from NuGet.org. Follow the instructions in [Dataverse development tools](download-tools-nuget.md) to download PRT and optionally other development tools.
29+
## About the Plug-in Registration tool
30+
31+
The Plug-in Registration tool (PRT) supports registration of plug-in assemblies, message processing steps, and other types of objects with Dataverse. PRT is one of several Dataverse tools available for download from [NuGet.org](https://www.nuget.org). Follow the instructions in [Dataverse development tools](download-tools-nuget.md) to download PRT and optionally other development tools.
3032

3133
After you download the PRT, follow the [Connect using the Plug-in Registration tool](tutorial-write-plug-in.md#connect-using-the-plug-in-registration-tool) instructions to connect the tool to your target Dataverse environment where your plug-in is to be registered.
3234

35+
:::image type="content" source="media/dv_plugin_registration_tool.png" alt-text="The Plug-in Registration tool main window.":::
36+
3337
## Register an assembly
3438

3539
Registering an assembly is the process of uploading the assembly to the Dataverse database. See the instructions found at [Register your assembly](tutorial-write-plug-in.md#register-your-assembly) in the [Tutorial: Write and register a plug-in](tutorial-write-plug-in.md)
@@ -242,28 +246,28 @@ You can also delete **Plug-in Assemblies** and **Sdk Message Processing Steps**
242246

243247
With the Plug-in Registration tool running and logged into the target Dataverse environment, you can proceed to disable or enable plug-in steps. Disabling a step effectively turns off the plug-in from executing when Dataverse processes the entity and message combination specified in the step registration.
244248

249+
> [!IMPORTANT]
250+
> Disabling a plug-in can negatively affect the functionality of your app, a solution, or the Dataverse system. Make sure you understand the implications before you proceed.
251+
245252
To disable or enable a registered plug-in step:
246253

247254
1. Expand the target plug-in assembly node in the assembly view until you see the desired step registration node.
248255
1. Choose the step, and then choose **Enable** or **Disable** in either the context menu or the toolbar.
249256

250-
|Disable a plug-in step|Enable a plug-in step|
251-
|--|---|
252-
|:::image type="content" source="media/enable-step-prt.png" alt-text="Disable a step using the Plug-in Registration tool.":::
253-
|:::image type="content" source="media/enable-step-prt.png" alt-text="Enable a step using the Plug-in Registration tool.":::|
257+
:::image type="content" source="media/disable-step-prt.png" alt-text="Disable a step using the Plug-in Registration tool.":::
254258

255259
You can also disable or enable steps in the legacy Dataverse Solution Explorer user interface using the **Activate** and **Deactivate** command options.
256260

257-
![Changing a plug-in step in legacy Solution Explorer.](media/step-activate-deactivate-commands-solution-explorer.png)
261+
:::image type="content" source="media/step-activate-deactivate-commands-solution-explorer.png" alt-text="Changing a plug-in step in legacy Solution Explorer.":::
258262

259263
### Change user impersonation for a step
260264

261-
With the Plug-in Registration tool running and logged into the target Dataverse environment, you can proceed to make changes to an existing step registration. In this section, we will discuss changing the user on whos behalf the plug-in will perform its operations. Meaning, the effective user that is performing the data operations initiated by the plug-in. By default, the calling user (the user that invoked an operation in Dataverse) is the owner of said operations. However a different user can be specified in the step registration. You will need to have the System Administrator or System Customizer role to perform this operation.
265+
With the Plug-in Registration tool running and logged into the target Dataverse environment, you can proceed to make changes to an existing step registration. In this section, we will discuss changing the user on whos behalf the plug-in will perform its operations. Meaning, the effective user that is performing the data operations initiated by the plug-in. By default, the calling user (the user that invoked an operation in Dataverse) is the owner of said operations. However a different user can be specified in the step registration. You will need to have the System Administrator or System Customizer security role to perform this operation.
262266

263267
To change the user in a registered plug-in step:
264268

265269
1. Expand the target plug-in assembly node in the assembly view until you see the desired (Step) registration node.
266-
1. Select the step, and then select **Update** in either the context menu or the toolbar.
270+
1. Choose the step node, and then choose **Update** in either the context menu or the toolbar.
267271
1. Choose a different user from the drop-down list of available users next to the **Run in User's Context** label.
268272
1. Choose **Update Step**.
269273

0 commit comments

Comments
 (0)