View or edit the Python code in playbooks

In the Data preview panel of the Visual Playbook Editor, select the Python Playbook Editor tab to view the underlying Python code for your playbook. The code for the entire playbook is shown by default. Select any block in your playbook to view the code for the selected block only.

See the following documentation for more information about the Data preview panel and Python code in your playbooks:

• Use Data Preview to build, test, and edit playbooks
• Python Playbook Tutorial for overview in the Python Playbook Tutorial for manual.
• About playbook automation APIs in the Python Playbook API Reference for manual.

Splunk does not support custom Python packages.

Manage your editing session

Use the icons in the Python Playbook Editor to manage your editing session.

Icon	Description
	View the Python code for the entire playbook. Using this icon is useful if you are viewing the Python code for a specific block on the canvas, and want to return to view the Python code for the entire playbook.
	View the Python code for the selected playbook block. Using this icon is useful if you are viewing the Python code for the entire playbook, and want to view the Python code for the selected playbook block.
	View looping logic for the selected playbook block, if any exists. Using this icon is useful if you want to focus on the looping functionality of the selected playbook block.
	View callback function for the selected block. The callback function is used to view to the block of code that is generated to split the output of the single block into multiple blocks.
	View join function for the selected block. The callback function is used to view to the block of code that is generated to join the output of the multiple blocks into a single block.
	Add code that needs to be defined at the global level of the playbook, inserted below import statements for Python libraries.
	Select to wrap lines of text. Select again to stop line wrapping.
	Go back to the original version and discard all changes. If there are changes to revert, the button turns white when you hover over it.

How custom Python edits affect the visual playbook editor

When you see Playbook Code in the Python Playbook Editor, you are making changes affecting the whole playbook. When you begin to make edits, you are prompted to verify that you want to continue. If you continue, you will no longer be able to edit the playbook using the playbook editor. All changes to the playbook must be made by editing or adding Python code.

If you select a block in the playbook, your edits only disable the playbook editor for that block. The Python Playbook Editor changes from Playbook Code to the name of the Python function called in that block. You can continue to use the playbook editor to add, edit, or delete other blocks in the playbook. If you want to add another block downstream from the block you edited, you have to manually enter a Python function call for the next block, such as phantom.act(). The playbook editor doesn't generate Python code for any block containing custom edits.

When editing the Python code for a Code block, make your edits in the editable area in order for callback functions to work.

1. Create a Code block in the playbook editor. See Add custom code to your playbook with the code block.
2. Select Python Playbook Editor.
3. Select the Code block.
4. Write your custom code in the area with the # Write your custom code here... text.

   ################################################################################
   ## Custom Code Start
   ################################################################################
   
   # Write your custom code here...
   
   ################################################################################
   ## Custom Code End
   ################################################################################