Create a New Script

Create a new Script to automate or add functionality to any Process.

Create a New Script

Your user account or group membership must have the following permissions to create a Script unless your user account has the Make this user a Super Admin setting selected:

• Scripts: Create Scripts

• Scripts: View Scripts

See the Scripts permissions or ask your Administrator for assistance.

Follow these steps to create a new Script:

1. View your Scripts. The Scripts page displays.

2. Click the +Script button. The Create Script screen displays.

   

   Create Script screen
3. In the Name setting, enter the name of the Script. Script names must be unique in your organization and can only use apostrophe characters (') and spaces. This is a required setting.

4. In the Description setting, enter the description of the Script. This is a required setting.

5. From the Category drop-down menu, select one or more Script Categories to associate with this Script. In doing so, Script Categories may be sorted from the Scripts page. To remove a Script Category that is currently selected, click theicon for that selection or press Enter when the drop-down is visible. This is a required setting.
6. From the Project drop-down menu, optionally select the Project(s) that this Script becomes an asset. This setting only displays Projects of which you are a member. To remove a Project that is currently selected, click theicon for that selection or press Enter when the drop-down is visible.
7. From the Language drop-down menu, select the Script Executor from which to run the Script for this Script's programming language. Your Administrator may have created custom Script Executors using ProcessMaker Platform-supported languages to run sanctioned custom third-party code and/or Docker commands that allow Scripts to successfully call third-party Application Program Interfaces (APIs) and Software Development Kits (SDKs). Below are the Script Executors ProcessMaker Platform provides, though some require packages to be installed:

   • csharp - C# Executor: This is the default Script Executor to run Scripts developed using C#. Note that if the C# package is not installed, this Script Executor is not available.

   • java - Java Executor: This is the default Script Executor to run Scripts developed using Java. Note that if the Java package is not installed, this Script Executor is not available.

   • javascript - Node Executor: This is the default Script Executor to run Scripts developed using JavaScript.

   • lua - LUA Executor: This is the default Script Executor to run Scripts developed using Lua.

   • python - Python Executor: This is the default Script Executor to run Scripts developed using Python. Note that if the Python package is not installed, this Script Executor is not available.

   • r - R Executor: This is the default Script Executor to run Scripts developed using R. Note that if the R package is not installed, this Script Executor is not available.

   This is a required setting.

8. From the Run script as drop-down menu, select which user's API client token to use with our REST API. Ensure that the selected user's account has the appropriate API permissions to access our REST API. This is a required setting.

9. In the Retry Attempts setting, configure how many times to re-run the Script if the Script returns a runtime error as follows:

   • Enter a number. Use the up and down arrows to increase or decrease the number.

   • Set 0 for no retry attempts.

10. In the Retry Wait Time setting, configure how many seconds to wait before attempting a retry as follows:

    • Enter the number of seconds. Use the up and down arrows to increase or decrease seconds.

    • Set 0 for no timeout.

11. In the Timeout setting, use the slider control or enter how many seconds the Script is allowed to run before it times out. Use 0 to indicate that the Script never times out. The default timeout is 60 seconds. This setting requires an integer.

12. Click Save. Script Editor displays so you can develop your Script. See Script Editor.

Related Topics

pageWhat is a Script?pageWhat is a Script Executor?pageManage Script CategoriespageView ScriptspageSearch for a ScriptpageConfigure a ScriptpageEdit a ScriptpageCopy a ScriptpageDelete a ScriptpageScript EditorpageWhat is a Package?pageC# PackagepageJava PackagepagePython PackagepageR Package