TechNet
Export (0) Print
Expand All

Register and use a custom workflow activity assembly

 

Applies To: Dynamics CRM 2016, Dynamics CRM Online

After you compile your custom workflow activity to create an assembly, you have to register the assembly with Microsoft Dynamics CRM. Your custom activity then appears in the process form of Microsoft Dynamics CRM Online or Microsoft Dynamics CRM 2016 depending on which deployment you registered the custom workflow activity with.

You can use Windows PowerShell to enable or disable custom workflow activities and plug-in execution for an on-premises server as described here. Alternatively, you can use the Deployment web service. For more information, see Deployment entities and deployment configuration settings to learn how to set the CustomCodeSettings.AllowExternalCode property.

  1. Open a Windows PowerShell command window.

  2. Add the Microsoft Dynamics CRM PowerShell snap-in:

    Add-PSSnapin Microsoft.Crm.PowerShell
    
  3. Retrieve the current setting:

    $setting = get-crmsetting customcodesettings
    
  4. Modify the current setting:

    $setting.AllowExternalCode="True"
    
    set-crmsetting $setting
    
  5. Verify the setting:

    get-crmsetting customcodesettings
    

  1. Open a Windows PowerShell command window.

  2. Add the Microsoft Dynamics CRM PowerShell snap-in:

    Add-PSSnapin Microsoft.Crm.PowerShell
    
  3. Retrieve the current setting:

    $setting = get-crmsetting customcodesettings
    
  4. Modify the current setting:

    $setting.AllowExternalCode=0
    
    set-crmsetting $setting
    
  5. Verify the setting:

    get-crmsetting customcodesettings
    

Custom workflow activity assemblies are registered using the Plug-in Registration tool. The tool provides a graphical user interface and supports registering assemblies that contain plug-ins or custom workflow activities. When registering an assembly that contains custom workflow activities with Microsoft Dynamics CRM Online, you must register the assembly in the sandbox (partial trust).

For more information about how to register and deploy a custom activity assembly by using the tool, see Specify the name and group name for a custom workflow activity.

System_CAPS_noteNote

You can find the Plug-in Registration tool’s executable file in the SDK\Tools\PluginRegistration folder of the SDK. Download the Microsoft Dynamics CRM SDK package. The tool can be added to the Microsoft Visual Studio Tools menu as an external tool to speed up the development process.

After you have registered your custom workflow activity assembly, you can use it in the process designer in Microsoft Dynamics CRM.

To use your custom workflow activity in a process:

  1. Sign in to Microsoft Dynamics CRM.

  2. Go to Settings > Processes.

  3. Create or open an existing process.

  4. In the process designer, click or tap Add Step. Your custom workflow activity name will appear in the drop-down list.

Microsoft Dynamics CRM 2016 and CRM Online

© 2016 Microsoft. All rights reserved. Copyright

Community Additions

Show:
© 2016 Microsoft