Esta documentación se refiere al nuevo editor de procesos de la plataforma.

 Portugués Español Inglés


Hablando del scripts del proceso...

Los scripts pueden vincularse a los eventos del proceso para personalizar lo que debe suceder cuando ocurre determinado evento. Se activan 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 mover valores del formulario relacionado con estos, hacer la comunicación con servicios externos, enviar e-mails a personas externas, mover documentos adjuntos a la solicitud y hacer la publicación en el recurso Documentos, consultar datasets, agregar validaciones en el movimiento de la solicitud, integrar con otras solicitudes u otros puntos de la plataforma, generar logs, etc.

Encuentra 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 e-mail 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 e-mail de notificación.

function afterProcessFinish(processId) {
    try {
        var remetente = "MATRICULA_DO_REMETENTE";
        //El código del template de e-mail previamente registrado en
        //"Panel de control > Templates de e-mail"
        var templateEmail = "CODIGO_TEMPLATE_EMAIL";
        var parametros = new java.util.HashMap(); 
		//Parámetro que se utilizará como asunto del e-mail
        parametros.put("subject", "Su pago se realizó");
        //Parámetro del template que recibirá el nombre del responsable contenido en
        //el campo "responsavelFornecedor" del formulario
        parametros.put("NOME_RESPONSAVEL", hAPI.getCardValue("responsavelFornecedor"));
        //Parámetro del template 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 e-mail 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 e-mail         
		notifier.notify(remetente, templateEmail, parametros, destinatarios, "text/html");
    } catch(e) {
        log.error("Error al enviar el e-mail al proveedor: " + e);
    }
}


Ver scripts del proceso

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

02. Al lado izquierdo, verá todos los eventos del proceso que tienen scripts.

03. Haga 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 el modo de edición, haga clic en la pestaña  Script, ubicada en el medio de la barra superior.

02. Al 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 el modo de edición, haga clic en la pestaña  Script, ubicada en el medio de la barra superior.

02. Al lado izquierdo, encuentre 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í.


Eliminar script del proceso

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

02. Al lado izquierdo, encuentre el evento del cual desea eliminar 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 eliminació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 tener 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>