.NET Utility - Configuration (Magic xpi 4.5)

« Go Back


Created ByKnowledge Migration User
Approval Process StatusPublished

.NET Utility - Configuration (Magic xpi 4.5)

To add the .NET utility to a flow:

  1. Drag the .NET utility from the Toolbox pane to your flow.

  2. In the Properties pane, enter the information as described in the table below:




Step Name

Type a name that describes the service in the flow.


Type a description of the utility in your flow (optional).

Step ID

A read-only field displaying the ID of the step in the flow.

Component ID

An internal identifier number generated automatically.

Component Type

A read-only field displaying the name of the step type.


Enter a condition to specify the flow's execution behavior. You can either click to open the Expression Editor, or you can right-click on the component and select Condition from the context menu.

Processing mode

Select whether the step should be executed linear, parallel or stand-alone.


This is available only if the .NET utility is not the first step in a flow.

Wait for completion

Select whether the step should be run in Wait for Completion mode. The options are Yes or No.


This is available only when the .NET utility is a Linear step and if it is not the first step in the flow.


Save point

Select Yes to indicate that the step is a Save Point in your flow.


This is available only if the flow's Recovery Policy is set to Save Point.

Call logic flow

You can use this option if you want to call generic logic after the execution of a specific step. Once this step has been executed, the flow logic that you defined in the flow properties is called before the Server continues to the following steps.

The options are Yes or No (default).

  1. Double-click or right-click on the .NET utility and select Configuration from the context menu to open the .NET Configuration dialog box. This dialog box has the following fields:



Component Name

The name you give to your .NET utility.

Language Code

Select the language that you will use to create the .NET Framework component. You can select C# or VB.NET.

  1. Click OK to close the .NET Configuration dialog box. The .NET utility is displayed in the flow.

The .NET Configuration dialog box also has the following additional buttons:




Generates a .NET class with the name supplied by the user.


Calls the .NET Class Config method. You can use this to call existing .NET utilities, including ones created in V2.5. To do this, you have to save the component folder under the project folder, drag a .NET utility into the Flow Editor and configure the utility with the .NET class name and language. The .NET class will be located by the component name. When you click the Configuration button, the Class Config method will be called.


Lets you edit an existing .NET utility.


  • .NET SDK components from V2.5 will be automatically migrated to the current Magic xpi version's .NET utility. The component name is taken from the migrated project and used in the appropriate fields of the .NET utility.

  • The way in which Magic xpi transfers BLOBs (binary large objects) to and from .NET is different when using Magic xpi’s predefined context BLOB variables than when working with user-defined BLOB variables. Because of this, it is recommended to utilize user-defined variables (for example, F.Blb) to send and receive BLOB content when using the .NET utility.

Customizing the .NET utility Icon

Magic xpi allows you to customize the .NET utility icon. This confers several advantages. For example, you can ensure that a specific .NET utility stands out in a flow, or you can easily differentiate between multiple .NET utility instances in the same flow.


  • Only icons in .gif format are supported.

  • Your new icon will also be visible in the Magic xpi Monitor.

  • If you print your project, the new icon will be used.

To customize a .NET utility icon, follow these steps:

  1. Configure and generate a .NET utility. A folder named after the new .NET utility is automatically created in the <My Documents>\Magic\projects\<project name>\<current project> folder. The new <.NET utility> folder contains a default icon in .gif format, which is also named after the .NET utility.

  2. To use your own icon image instead of the default icon, rename your icon with the same name as the default icon.

  3. In the <.NET utility> folder, replace the default icon .gif with your new icon .gif.

  4. Repeat this process for other .NET utility steps, as required.

  5. The next time you open the flow, your new icons will be visible.