COM – Configuration (Magic xpi 3.x)
The COM component creates a COM interface to be used by another client to trigger a flow.
The Component Configuration: COM dialog box contains the following fields:
|
|
|
|
Service Details
|
|
Service Name
|
This read-only field displays the name of the service that you selected in the Component Properties dialog box.
|
|
Operation Name
|
This drop-down list displays the COM operations that you created in the Service Repository. Select the required operation.
|
|
Argument Details: These read-only fields were defined by you in the Service Repository.
|
|
Name
|
The argument name. The first argument, by default, is IBPrincipal, which cannot be modified. This argument contains the user name that is used to authenticate the flow, and is essentially a security feature. This field is read-only.
|
|
Data Type
|
The argument's data type. This field is read-only.
|
|
Picture
|
The argument's format. You defined this read-only field in the Service Repository.
|
|
Direction
|
The argument's direction. You defined this read-only field in the Service Repository.
|
|
COM Type
|
The COM type that you defined in the Service Repository. This field is read-only.
|
|
Mapping Variable
|
The arguments are received by the trigger and are mapped to your variables.
Click  to open the Variables List. Choose the required variable, and click Select.
|
|
Arguments XML Location: Click to the right of the field to open the Variables List. From the list, select a variable or parameter as a location for the XML results.
|
|
Return Parameter Details
|
|
Type
|
Select the parameter type from the drop-down list.
|
|
Picture
|
Define the returned parameter's format by entering a string of characters. For example, a 15-character alpha-numeric parameter has a picture definition of 15. A picture that defines a date is MM/DD/YY.
|
|
COM Type
|
Select a return COM type from the drop-down list.
|
|
Value
|
Click  to the right of the field to open the Expression Editor. Use the editor to enter the value of the return parameter.
|
To configure the COM component as a trigger, follow these steps:
-
Define COM as a service in the Service Repository. For more information, click here.
-
Place the COM component into a flow's trigger area to open the Component Properties dialog box.
-
Click the Settings tab, and select the required Service Name from the drop-down list.
-
Click Configuration to open the Component Configuration: COM dialog box and enter the relevant information.
-
When you have finished configuring your COM trigger, click OK to save the settings and to exit the dialog box. Alternatively, you can click Cancel to exit the dialog box without saving your settings.
