Refresh Conversions Utility (Magic xpi 4.6)
|
Note:
|
This utility currently refreshes only the conversion table for the server that it runs on.
|
Magic xpi's Refresh Conversions utility lets you refresh a conversion table during runtime, at any point in a flow. During server startup, all defined static conversion tables are initialized and loaded into the memory. When you use the Refresh Conversions utility at runtime, the selected conversion tables are refreshed in the memory.
Dynamic conversion tables are created by the utility, using the file name defined by the utility. These tables are available only in the context of the thread that they are created in. The table is deleted from the memory when the thread is terminated.
This utility implements standard Magic xpi error behavior, and has the following runtime errors:
-
"Conversion Table XXX not found". This error message appears when a defined file does not exist.
-
"Duplicate Conversion Table key XXX". This warning means that this key will not be processed. A warning message will be sent to the log.
To use the Refresh Conversions utility:
-
Drag the Refresh Conversions utility from the Toolbox pane to your flow.
-
In the Properties pane, enter the information as described in the table below:
|
|
|
|
General
|
|
Step Name
|
Type a name that describes the utility in the flow.
|
|
Description
|
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.
|
|
Condition
|
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.
|
Note:
|
This is available only if the Refresh Conversions 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.
|
Note:
|
This is available only when the Refresh Conversions utility is a Linear step and if it is not the first step in the flow.
|
|
|
Advanced
|
|
Save point
|
Select Yes to indicate that the step is a Save Point in your flow.
|
Note:
|
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).
|
-
Double-click or right-click on the Refresh Conversions utility and select Configuration from the context menu to open the Refresh Conversions Configuration dialog box. This dialog box has the following fields:
|
|
|
|
Conversion Table Name
|
Click to select a conversion table name from the Data Converters List. The list contains the data converters that you created in the Data Converter Repository.
|
|
Dynamic
|
This field is read-only, and reflects how you defined the specific data converter in the Data Converter Repository. The possible options are Yes and No.
|
|
File Name
|
If the selected data converter is dynamic, you should enter a name for the file here. You can also do this by clicking  to open the Expression Editor.
If the selected data converter is static, this field is disabled. In this situation, the file name that you defined in the Data Converter Repository is displayed.
|
-
Click OK to close the Refresh Conversions Configuration dialog box. The Refresh Conversions utility is displayed in the flow.
|
Note:
|
If you open the Data Converter Repository, and attempt to delete or change an entry that you are using in a Refresh Conversions Table utility, a confirmation message is displayed.
|
Refresh Conversions Utility - Error Handling
