- 08 Apr 2024
- 3 Minutes to read
- Print
- DarkLight
Python Module
- Updated on 08 Apr 2024
- 3 Minutes to read
- Print
- DarkLight
Module Details | |
Core or Github Module | Core |
Restart Required | No |
Steps Exposed | Yes |
Step Location | Integration > Python |
Settings Location | System > Settings Python Module Settings |
Prerequisites |
|
The Python Module allows custom scripts written in Python to be created and used as steps inside a Flow. In order the utilize the Module, the file path must contain the Python executable to be ran. For example: C:\Program Files\Python\python.exe will be entered in Python Module Settings.
Settings
Navigate to System > Settings. Click on Python Module Settings and enter the full file path to the Python executable. Click SAVE once the file path has been configured. In order to update the file path, Decisions must be restarted.
Python Module in Container
/usr/bin/python3
. After installing the Python module, users need to point Python Module Settings path to /usr/bin/python3
.Creating Script Projects
Script Projects house Python Scripts that will be generated as steps They are mainly used for organization, as the name of the Script Project will appear as a sub-category under Integrations > Python in the step Toolbox. Navigate to System > Integrations. Right-click Python Script Projects and select Add Script Project. Name the project and click SAVE.
Adding Python Scripts
The following Python script will be used in the example.
import sys
def main():
print("Welcome", sys.argv[0])
if len(sys.argv) == 3:
print(" ", sys.argv[1], " ", sys.argv[2])
if __name__ == "__main__":
main()
- Right-click on the Script Project and select Add Script.
- Name the script and upload the Python file. Enter names for the Inputs (string1, string2) and click SAVE.
Below are the settings that can be configured when for a script.
Setting | Description |
---|---|
Name | The name that will be given to the step when accessed in a Flow. |
Description | A textbox which can be used to describe the script when inside of a Flow. |
Read Python Path From | Sets the file path used to search for the Python executable. If this is set to Default, the step will use the file path that was configured in System > Settings > Python Module Settings. If this is set to Custom, a new textbox will appear, allowing the file path to be specified. |
File | The file containing the python script. |
Working Directory | The working directory used to search for the executable and store generated files. If no values are entered, this location will point to: C:\Program Files\Decisions\Decisions Server. |
Inputs | Custom inputs that are used in the script. |
Python Scripts as Flow steps
- To add the Python Script to a Flow, navigate to Integrations > All Integrations > Python. Then, select the Python project and select the script and click ADD.
- With the step selected, change the input value mappings to Constant and enter "Hello" for string1 and "World" for string2.
- Add a Show Popup step to the Success path. Enter "Message" as the Subject. Click Unknown next to the Message field and select Select From Flow. Select Script Output [String] and click DONE.
- Connect the Error path and Done path to the End step.
- Click Save to save changes to the Flow. In the Flow Designer select debug and view inputs/outputs to the step. If the step succeeded, the output will display the configured result in the script.
Execute Python Script Step
The Execute Python Script step allows Python Scripts to be executed without the need to create a Script Project. However, only parameter values can be passed to the script, the values cannot be defined in the Flow.
Input | Description |
---|---|
Parameter(s) | The parameter inputs to the Script. |
Script File | Similar to the File input when configuring a Script as a Flow step, this will be the file containing the Python Script. |
Working Directory | The input controls the first location used to search for the Python executable, along with being the location custom files will be outputted from the Script. |