Hablando del scripts del proceso...

Los scripts pueden ser asociados a los eventos del proceso para personalizar lo que debe suceder cuando ocurre determinado evento. Se llaman a lo largo de la ejecución del proceso, en momentos predeterminados por los eventos, tales como la creación de una solicitud o la llegada de una solicitud a una determinada etapa del proceso.

Al utilizar scripts en los procesos, es posible manipular valores del formulario relacionado a ellos, hacer la comunicación con servicios externos, enviar correos electrónicos a personas externas, manipular anexos de la solicitud y hacer publicación en el recurso Documentos, consultar datasets, agregar validaciones en la movimentación de la solicitud, integrar con otras solicitudes u otros puntos de la plataforma, generar logs, etc.

Obtenha más detalles e información más técnica sobre el desarrollo de scripts para eventos en:


En un proceso de Pago a proveedores, existe la necesidad de enviar una notificación por correo electrónico a una persona de la empresa proveedora cuando el pago se realice y la solicitud se finalice. Al ser de otra empresa, esta persona no es un participante del proceso ni tiene registro en la plataforma, por lo que no es posible notificarla a partir de las configuraciones de notificación disponibles en el componente Fin.

En este caso, es posible agregar un script para el evento afterProcessFinish. Así, cuando la solicitud se finalice, la persona de la empresa proveedora estará al tanto de que su pago ya ha sido realizado, ya que también recibirá el correo electrónico de notificación.

function afterProcessFinish(processId) {
    try {
        var remetente = "MATRICULA_DO_REMETENTE";
        //El código de la plantilla de correo electrónico previamente registrado en
        //"Panel de control > Plantillas de correo electrónico"
        var templateEmail = "CODIGO_TEMPLATE_EMAIL";
        var parametros = new java.util.HashMap(); 
		//Parámetro que se utilizará como asunto del correo electrónico
        parametros.put("subject", "Su pago ha sido realizado");
        //Parámetro de la plantilla que recibirá el nombre del responsable contenido en
        //el campo "responsavelFornecedor" del formulario
        parametros.put("NOME_RESPONSAVEL", hAPI.getCardValue("responsavelFornecedor"));
        //Parámetro de la plantilla que recibirá el valor pagado y que está contenido en
        //el campo "valorPago" del formulario
        parametros.put("VALOR_PAGAMENTO", hAPI.getCardValue("valorPago"));
     
        //Instancia lista de destinatarios
        var destinatarios = new java.util.ArrayList();         
		//Agrega el correo electrónico externo del responsable por el proveedor de la solicitud
		//que está contenido en el campo "emailFornecedor" del formulario
        destinatarios.add(hAPI.getCardValue("emailFornecedor"));               
		//Realiza el envío del correo electrónico         
		notifier.notify(remetente, templateEmail, parametros, destinatarios, "text/html");
    } catch(e) {
        log.error("Error al enviar el correo electrónico al proveedor: " + e);
    }
}


Ver scripts del proceso

01. Con el proceso en modo de edición, haz clic en la pestaña  Script – ubicada en el medio de la barra superior.

02. En el lateral izquierdo, verás todos los eventos del proceso que tienen scripts.

03. Haz clic en cada evento para ver su script

Para ocultar la lista de eventos, haz clic en Cerrar . Para ver la lista nuevamente, simplemente haz clic en Abrir.


Agregar script en el proceso

01. Con el proceso en modo de edición, haz clic en la pestaña  Script – ubicada en el medio de la barra superior.

02. En el lado izquierdo, haga clic en Agregar script– ubicado en la parte superior.

03. Seleccione el evento del proceso para el cual desea agregar un script.

04. Haga clic en Agregar.

05. En el área de codificación, ingrese el código del script que debe ejecutarse cuando ocurra el evento seleccionado en el proceso.

06. Haga clic en Guardar borrador – ubicado en el lado derecho de la barra superior – para guardar el script creado.

07. En el mensaje mostrado, haga clic en Ok, entendí.


Editar script del proceso

01. Con el proceso en modo de edición, haz clic en la pestaña  Script – ubicada en el medio de la barra superior.

02. En el lado izquierdo, localice y haga clic en el evento para el cual desea editar el script.

03. En el área de codificación, edite el código del script que debe ejecutarse cuando ocurra el evento seleccionado en el proceso.

04. Haga clic en Guardar borrador – ubicado en el lado derecho de la barra superior – para guardar los cambios realizados en el script.

05. En el mensaje mostrado, haga clic en Ok, entendí.


Excluir script del proceso

01. Con el proceso en modo de edición, haz clic en la pestaña  Script – ubicada en el medio de la barra superior.

02. En el lado izquierdo, localice el evento del cual desea excluir el script.

03. Haga clic en Eliminar.

04. Haga clic en Guardar borrador – ubicado en el lado derecho de la barra superior – para guardar el proceso considerando la exclusión del script.

05. En el mensaje mostrado, haga clic en Ok, entendí.


Esta documentación es válida a partir de la actualización Voyager (2.0). Si utiliza una actualización anterior, puede contener información diferente de la que ve en su plataforma.



<!-- Hotjar Tracking Code for http://tdn.totvs.com/display/fb -->
<script>
    (function(h,o,t,j,a,r){
        h.hj=h.hj||function(){(h.hj.q=h.hj.q||[]).push(arguments)};
        h._hjSettings={hjid:1280165,hjsv:6};
        a=o.getElementsByTagName('head')[0];
        r=o.createElement('script');r.async=1;
        r.src=t+h._hjSettings.hjid+j+h._hjSettings.hjsv;
        a.appendChild(r);
    })(window,document,'https://static.hotjar.com/c/hotjar-','.js?sv=');
</script>