This component is used for executing Python Script. The Python Script to be executed is specified using the Custom Property Sheet (CPS). This component executes the script on documents it receives as input and returns the result.

Points to note

• Input message content and properties can be accessed using document object. For example, 'document.getText()' returns input message content.To access a message property named 'TestProperty, 'document.getRecord().getProperty('TestProperty')' returns the value of the property.
• Message properties can be set using 'setProperty' method.
• Message properties which are set on input message also appear on output message unless they are changed in the script.For example, if a property named 'TestProperty' is present on input message then output message also contains the property unless it is changed in the script provided.
• Output message content can be set either by using 'setText(String value)' of document object or by specifying a return value(using 'print') in the script provided. If both are present, the return value is set as message content.

Anchor
_Toc372741088 _Toc372741088

Configuration and Testing

Anchor
_Toc372741089 _Toc372741089

Interaction Configuration

Figure 1: Interaction Configurations panel in Python CPS

Attributes

Pre Processing XSL Configuration

Pre Processing XSL configuration can be used to transform request message before processing it. Click the ellipses button against the property to configure the properties.

Refer to the Pre/Post Processing XSL Configuration section under the Common Configurations page for details regarding Pre Processing XSL configuration and Post Processing XSL configuration (below).

Post Processing XSL Configuration 

Post Processing XSL configuration can be used to transform the response message before sending it to the output port.

Process Message Based on Property

The property helps components to skip certain messages from processing.

Refer to the Process Message Based On a Property section under the Common Configurations page.

Read Script from file?

If enabled, Script file path property appears where you can provide the location where the script file is saved.

Script File Path

Provide the complete path of the Python Script file (file should have .py extension) which you want to execute.


Figure 2: Script file path property to provide the location where the script file is saved

PythonScript

If the Read Script from file ? property is disabled, populate the PythonScript property with the Python Script.

Path Locations

Specify locations to be used in the path for the imports in the python script. Duplicate path locations are not allowed.

Replace Control Characters 

If this property is enabled, Control Characters present in the input will be replaced by a string representation of the same value during script evaluation. This is an expert property.

Cleanup resources (excluding connection) after each document

This closes all the resources except for the connection after every request. If the less processing time is more important the less memory usage, then it is recommended to disable this property and vice versa.

For more details, refer to the respective section under in the Common Configurations page.

Target Namespace

Refer to the Target Namespace section under the Common Configurations page.  

Monitoring Configuration

Please refer to the Monitoring Configuration section in Common Configurations page.

Scheduler Configuration

Please refer the respective section in Common Configurations page.

Transport Configurations

Please refer the respective section in Common Configurations page.

Error Handling

Please refer the sections Request Processing Error and Invalid Request Error in the Error Handling section of Common Configurations page for details.

Anchor
_Toc372741090 _Toc372741090

Sample Input and Output

The configuration can be tested by clicking the Test button in the interaction Configuration panel.

  Below is a sample Python script.

width = 20;
height = 5*9;
print width * height;

Figure 3: Sample Python Script

Below are the sample input and the output respectively for the above script.

Figure 4: Sample Input Message


Figure 5: Response Generated

Anchor
_Toc239744925 _Toc239744925

Functional Demonstration

Anchor
_Toc372741092 _Toc372741092

Scenario 1

Execution of Python Script provided.

Configure the Python Script adapter as described in Configuration and Testing section and use feeder and display component to send sample input and to check the response respectively.

Figure 6: Scenario demonstration with sample input and output

Anchor
_Toc372741093 _Toc372741093

Scenario 2

This sample demonstrates accessing an input message.

Configure the component with the following script.

print (document.getText());

Figure 7: Sample Python Script

Figure 8: Sample Input Message

Figure 9: Response Generated