Using Python Operations

Python operations can be copied from both the Projects panel and the Dependencies panel. You can import them. They are read-only.

namespace: io.cloudslang.base.comparisons

operation:
  name: less_than_percentage
  inputs:
    - first_percentage
    - second_percentage
  python_action:
    script: |
      error_message = ""
      result = ""
      first_percentage_nr = first_percentage.replace("%", "")
      second_percentage_nr = second_percentage.replace("%", "")
      try:
          int_value1 = int(first_percentage_nr)
          int_value2 = int(second_percentage_nr)
          result = int_value1 < int_value2
      except ValueError:
          error_message = "Both inputs have to be integers"
  outputs:
    - error_message

  results:
    - LESS: ${error_message == "" and result}
    - MORE: ${error_message == "" and not result}
    - FAILURE

You can use operations as steps in flows by dragging them from the Dependencies pane or from the Projects pane.

Use the Operation Editor to display information about an operation.

1. Double-click an operation in the Projects or the Dependencies pane to open it in the Operation Editor as read-only.

   The Python Action view displays the python action script.

   

2. Click the Properties button to display the Properties view.

   You can return to the Python Action view, by clicking either the Python Action button or the Back to Action button.

3. Under the Inputs tab, view the inputs that the operation takes. Each input in an operation has a value that can be set in a number of ways. It may be a constant value, a python expression, the value of a flow variable or system property, and more.

   See Inputs.

   1. Under the Outputs tab, view the values returned from the python script, which will be sent back to the calling step.

      The outputs are a list of key:value pairs where the key is the name of the output and the value is the expression to be returned, blank, constant, or more.

      For example:

      ‘outputs:  

          - available: ${vacant}’ 

      will return the value of a variable called ‘vacant’ in the python code, with the name of ‘available’ to the calling flow. More complicated expressions can be passed, such as trimming, parsing etc. Output expressions must evaluate to strings.

      If the value is blank, the output result will be the name of the output, which will translate to a python variable that is declared inside a python code. For example, ‘outputs: -vacant’ will return the value of the variable vacant under its’ original name as declared inside the python code.

      See Outputs.

4. Under the Results tab, view the results that will be returned to the calling step.

   See Results.

5. Under the Description tab, view a description of what the operation does, if one was entered.

6. To view the code behind the operation, click the Show as Text button. A text box appears, displaying the code.

   Note Python scripts are not validated inside OO Designer.

   

7. Click OK to close the text box.