Refresh Conversions Service (Magic xpi 3.x)
Magic xpi's Refresh Conversions service 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 service at runtime, the selected conversion tables are refreshed in the memory.
Dynamic conversion tables are created by the service, using the file name defined by the service. 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 service 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 service:
-
From the Component repository, drag the Refresh Conversions service to your flow.
-
In the top half of the Refresh Conversions Configuration dialog box, enter the information described in the table below:
|
|
|
|
Name
|
Enter a name for your new Refresh Conversions service. If you try to save the service without giving it a name, an error message appears.
|
|
Description
|
Enter a description of your new Refresh Conversions service (optional).
|
|
Magic xpi Server
|
Select the Magic xpi Server where the Refresh Conversions service is executed.
Click  to open the Servers List. Select a Server from the list, and click Select.
|
|
Processing mode
|
Select whether the step should be executed linear, parallel or stand-alone. This is only available if the Refresh Conversions service is not the first step in the flow.
|
|
Wait for completion
|
Select whether the step should be run in Wait for Completion mode. The options are Yes or No. This is only available if the Refresh Conversions service is a Linear step and 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).
|
-
Click New. A new line appears in the bottom half of the Conversions Configuration dialog box.
-
In the bottom half of this dialog box, enter the information described in the table below:
|
|
|
|
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.
|
|
Scope
|
The scope can be either dynamic or static. This field is read-only, and reflects how you defined the specific data converter in the Data Converter Repository.
|
|
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.
|
-
You can enter further conversion table names by following the same procedure. You can also remove conversion table names by clicking Delete.
-
When you have entered the required information, click OK to create the service. If you did not select a name for the service, an error message appears. Click Cancel to exit the Conversions Configuration dialog box without creating the service.
|
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 Service, a confirmation message is displayed.
|
|
Refresh Conversions Service - Error Handling
