Handling Custom .DLL Files

Overview

To understand how to add custom code to the platform, developers should be well acquainted with an integrated development environment (IDE) and on building Class Libraries in .NET Core.

This article details how to add, update, and delete a custom .dll file into a Decisions environment.

If experiencing issues with a custom .dll, refer to the Troubleshooting a Custom .DLL File article for further information.

Uploading a Custom .DLL File

This example will demonstrate how to add the .dll file created from a compiled .NET Core project. The following method will be used in this example.

using DecisionsFramework.Design.Flow;

[AutoRegisterMethodsOnClass(true, "Documentation/Examples")]
public class DocumentationExample
{
    public static double GetSimpleInterest(decimal interest, int termInYears, double principal) 
    {
        return principal * (double) interest * termInYears;
    }
}

1. After compiling the code in a .NET Core project, navigate to where the .dll Class Library file is located and copy the file.
2. Navigate to C:\Program Files\Decisions\Decisions Server\modules\Decisions.Local\CoreServicesDlls and paste the file to this folder.

   

3. Restart Decisions.
4. In the Toolbox panel of the Flow Designer, navigate find the step within the category named off the dll's registered method on class. 
   Steps that are not categorized when using the SDK will be displayed under the .NET Libraries category. To learn more about creating and customizing steps, see SDK: Flow Steps (Basic) and SDK: Flow Steps (Advanced)
   
   

Removing Custom .DLL Modules

Custom Modules for Decisions can be removed by performing the following:

1. Navigate to C:\Program Files\Decisions\Decisions Server\modules\Decisions.Local\CoreServicesDlls, move the custom .dll file to the Deleted folder. 
2. Navigate to C:\Program Files\Decisions\FileStorage\Primary\Settings.
3. Create an empty text file named ForceLocalModule.txt at this location.
4. Restart Decisions. 

After restarting successfully, the newly added text file will be deleted, and custom steps will be removed from the decisions instance.