Speaking of process scripts...

Scripts can be associated with process events to customize what should happen when a specific event occurs. They are called throughout the execution of the process, at predetermined moments by the events, such as the creation of a request or the arrival of a request at a certain stage of the process.

By using scripts in processes, you can manipulate values of the related form, communicate with external services, send emails to external people, handle request attachments and publish in the Documents resource, query datasets, add validations to the transaction of the request, integrate with other requests or other points of the platform, generate logs, etc.

function afterProcessFinish(processId) {
    try {
        var remetente = "MATRICULA_DO_REMETENTE";
        //The code of the email template previously registered in
        //"Control Panel > Email Templates"
        var templateEmail = "CODIGO_TEMPLATE_EMAIL";
        var parametros = new java.util.HashMap();         
        //Parameter that will be used as the subject of the email
        parametros.put("subject", "Seu pagamento foi realizado");
        //Template parameter that will receive the name of the person in charge contained in
        //the "responsavelFornecedor" field of the form
        parametros.put("NOME_RESPONSAVEL", hAPI.getCardValue("responsavelFornecedor"));
        //Template parameter that will receive the amount paid and that is contained in
        //the "valorPago" field of the form
        parametros.put("VALOR_PAGAMENTO", hAPI.getCardValue("valorPago"));
        //Instantiates the list of recipients
        var destinatarios = new java.util.ArrayList();
        //Adds the external email of the person in charge of the supplier of the request
        //that is contained in the "emailFornecedor" field of the form
        destinatarios.add(hAPI.getCardValue("emailFornecedor"));
       //Sends the email
       notifier.notify(remetente, templateEmail, parametros, destinatarios, "text/html");
    } catch(e) {
        log.error("Error sending email to the supplier: " + e);
    }
}

View process scripts

01. With the process in edit mode, click the  Script tab – located in the middle of the top bar.

02. On the left side, see all the process events that have scripts.

03. Click each event to view its script.

Add script to the process

01. With the process in edit mode, click the Script tab – located in the middle of the top bar.

02. On the left side, click Add script– located at the top.

03. Select the process event for which you want to add a script.

04. Click Add.

05. In the coding area, enter the script code that must run when the selected event occurs in the process.

06. Click Save draft – located on the right side of the top bar – to save the created script.

07. In the displayed message, click Ok, I understand.

Edit process script

01. With the process in edit mode, click the Script tab – located in the middle of the top bar.

02. On the left side, locate and click the event for which you want to edit the script.

03. In the coding area, edit the script code that must run when the selected event occurs in the process.

04. Click Save draft – located on the right side of the top bar – to save the changes made to the script.

05. In the displayed message, click Ok, I understand.

Delete process script

01. With the process in edit mode, click the Script tab – located in the middle of the top bar.

02. On the left side, locate the event from which you want to delete the script.

03. Click Delete.

04. Click Save draft – located on the right side of the top bar – to save the script deletion process.

05. In the displayed message, click Ok, I understand.