Python Module
  • 20 Dec 2024
  • 2 Minutes to read
  • Dark
    Light

Python Module

  • Dark
    Light

Article summary

Module Details

Core or Github ModuleCore
Restart Required No 
Steps ExposedYes
Step Location Integration > Python
Settings Location System > Settings Python Module Settings
Prerequisites
  • A version of Python installed on the Decisions environment
  • Access to the file path to the Python directory after installation

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

Security Risk
This add-on module provides scripting capability.  Administrators acknowledge and accept full responsibility for securing the environment ahead of installing and using it.

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.


Feature Details
Introduced in Version8.10
Modified in Version9.6
LocationSystem > Settings > Python Module Settings

Python Module in Container

In order to use the Python Module in containers, Decisions has included Python in the container image. The container will have the most up-to-date version of Python installed. The default path for Python in containers is at /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.

  1. Navigate to [Project Name] > Manage > Integrations > Scripting > Python. Right-click Python Script Projects and select Add Script Project. Name the project and click SAVE. This action is not available in v9.0 or v9.1.

Python Scripts as Flow steps

  1. To add the Python Script to a Flow, navigate to Integrations > Python. Then, select the Python project and select the script and click ADD.
  2. With the step selected, change the input value mappings to Constant and enter "Hello" for string1 and "World" for string2.
  3. 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.
  4. Connect the Error path and Done path to the End step.
  5. 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.

InputDescription
Parameter(s)The parameter inputs to the Script.
Script FileSimilar to the File input when configuring a Script as a Flow step, this will be the file containing the Python script. 
Working DirectoryThe 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.


Feature Changes

DescriptionVersionRelease DateDeveloper Task
Added the right click action "Add Script Project" to the Python folder.9.2August 2024[DT-041379]
Script folders now have a delete action.
9.6January 2025[DT-042782]


For further information on Modules, visit the Decisions Forum.

Was this article helpful?