Linha Logix

Páginas filhas
  • WfProcess
  • Criado por Usuário desconhecido (claudio.montenegro), última alteração por Usuário desconhecido (rubens.santos) em 17 mar, 2014

Cria ou atualiza um novo processo workflow.

Durante a criação ou atualização do processo é possível informar as atividades do processo e atribuir responsáveis para as mesmas.

 

Sintaxe:
    LET nResult = _ADVPL_WfProcess( cProcessId, cDescription, cInstruction, nFormId, aStates, aEvents, aProperties )
Parâmetros:
    cProcessId → Id do processo do qual deseja criar ou atualizar <obrigatório>.
    cDescription → Descrição do processo <obrigatório>.
    cInstructions → Instruções de utilização do processo <obrigatório>.
    nFormId → Id do formulário HTML que será utilizado no processo <obrigatório>.
    aStates → Lista com informações das atividades do processo (mais detalhes abaixo) <obrigatório>.
    aEvents → Lista com os eventos específicos do processo [opcional].
    aProperties → Lista com as propriedades específicas do processo [opcional].
Retorno:
    nResult → Verdadeiro se o processo foi criado ou atualizado com sucesso.
Lista de Atividades

A lista de atividades deve ser uma variável do tipo ARRAY OF RECORD, cada linha desta lista irá representar uma atividade do processo e deverá possuir as seguintes informações:

  1. name - Nome da atividade
  2. description - Descrição da atividade
  3. instruction - Instruções de uso da atividade
  4. deadline - Prazo para a conclusão da atividade em minutos (opcional)
  5. attribution - Mecanismo de atribuição, sendo: 0 - Nenhum, 1 - Grupo de Usuários ou 2 - Usuário
  6. codattribution - Nome do grupo ou do usuário (conforme parâmetro acima).
Lista de eventos

A lista de eventos deve ser uma variável do tipo ARRAY OF RECORD com os atributos:

  1. name - Nome do evento (podendo ser um evento padrão do ECM)
  2. code - Código Javascript do evento.
Lista de propriedades

A lista de propriedades deve ser uma variável do tipo ARRAY OF RECORD com os atributos:

  1. name - Nome da propriedade
  2. title - Título da propriedade

Exemplo

#--------------------------------#
FUNCTION log02700_create_process()
#--------------------------------#
    DEFINE la_html   ARRAY[1] OF RECORD
                         name CHAR(50),
                         code TEXT
                     END RECORD
 
    DEFINE la_events ARRAY[1] OF RECORD
                         name CHAR(50),
                         code TEXT
                     END RECORD
 
    DEFINE la_states ARRAY[3] OF RECORD
                         name           CHAR(050),
                         description    CHAR(100),
                         instruction    CHAR(200),
                         deadline       INTEGER,
                         attribution    INTEGER,
                         codattribution CHAR(100)
                     END RECORD
 
    DEFINE l_form_id INTEGER
    DEFINE l_return  CHAR(100)
 
    # Nome e conteúdo do formulário HTML que será criado para o processo.
    LET la_html[1].name = 'log002700.html'
    LET la_html[1].code = log02700_get_wf_html()
 
    # Define os eventos do formulário.
    LET la_events[1].name = 'validateForm'
    LET la_events[1].code = log02700_get_wf_form_event(la_events[1].name)
 
    # Cria o formulário HTML no ECM.
    LET l_form_id = _ADVPL_WfCard('LOG02700','Manutenção de Usuários','Usuários',la_html,la_events)
 
    IF  l_form_id < 1 THEN
        CALL LOG_message(_ADVPL_WfGetError(1),'ERROR',_ADVPL_WfGetError(2),NULL,0)
        RETURN FALSE
    END IF
 
    # Define as atividades do processo.
    LET la_states[1].name           = 'inicio'
    LET la_states[1].description    = 'Início'
    LET la_states[1].instruction    = 'Informar os dados do usuário'
    LET la_states[1].deadline       = 0
    LET la_states[1].attribution    = 0
    LET la_states[1].codattribution = ''
 
    LET la_states[2].name           = 'revisao'
    LET la_states[2].description    = 'Revisão'
    LET la_states[2].instruction    = 'Revisar os dados do usuário'
    LET la_states[2].deadline       = 0
    LET la_states[2].attribution    = 2
    LET la_states[2].codattribution = 'admlog' # Somente o Administrador poderá revisar e efetivar o cadastro.
 
    LET la_states[3].name           = 'efetivacao'
    LET la_states[3].description    = 'Efetivação'
    LET la_states[3].instruction    = 'Efetiva criação do usuário no ERP Logix'
    LET la_states[3].deadline       = 0
    LET la_states[3].attribution    = 0
    LET la_states[3].codattribution = ''
 
    # Define os eventos do processo.
    LET la_events[1].name = 'afterProcessFinish'
    LET la_events[1].code = log02700_get_wf_process_event(la_events[1].name)
 
    # Cria o processo no ECM.
    LET l_return = _ADVPL_WfProcess('LOG02700','Processo de manutenção de Usuários','Usuários',l_form_id,la_states,la_events)
 
    IF  l_return THEN
        CALL LOG_message('Processo criado com sucesso!','INFO',NULL,NULL,0)
    ELSE
        CALL LOG_message(_ADVPL_WfGetError(1),'ERROR',_ADVPL_WfGetError(2),NULL,0)
    END IF
 
    RETURN l_return
END FUNCTION
 
#-----------------------------#
FUNCTION log02700_get_wf_html()
#-----------------------------#
    DEFINE l_wf_html TEXT
 
    LET l_wf_html = l_wf_html CLIPPED,'<div id="ALL" class="fw-box" style="height: 99%; width: 100%">'
    LET l_wf_html = l_wf_html CLIPPED,'    <div id="USUARIOS" class="fw-fields">'
    LET l_wf_html = l_wf_html CLIPPED,'        <fieldset>'
    LET l_wf_html = l_wf_html CLIPPED,'            <div class="fw-input">'
    LET l_wf_html = l_wf_html CLIPPED,'                <label class="fw-descr-top">Usu&aacute;rio:</label>'
    LET l_wf_html = l_wf_html CLIPPED,'                <input type="text" name="cod_usuario" class="fw-input-char" maxlength="8" size="8">'
    LET l_wf_html = l_wf_html CLIPPED,'            </div>'
    LET l_wf_html = l_wf_html CLIPPED,'            <div class="fw-input">'
    LET l_wf_html = l_wf_html CLIPPED,'                <label class="fw-descr-top">Nome:</label>'
    LET l_wf_html = l_wf_html CLIPPED,'                <input type="text" name="nom_funcionario" class="fw-input-char" maxlength="30" size="30" data="{picture:\'@!\'}">'
    LET l_wf_html = l_wf_html CLIPPED,'            </div>'
    LET l_wf_html = l_wf_html CLIPPED,'        </fieldset>'
    LET l_wf_html = l_wf_html CLIPPED,'        <div class="fw-folder" id="USUARIOS_FOLDER">'
    LET l_wf_html = l_wf_html CLIPPED,'            <ul>'
    LET l_wf_html = l_wf_html CLIPPED,'                <li><a href="#USUARIOS_1">Dados principais</a></li>'
    LET l_wf_html = l_wf_html CLIPPED,'                <li><a href="#USUARIOS_2">Dados complementares</a></li>'
    LET l_wf_html = l_wf_html CLIPPED,'            </ul>'
    LET l_wf_html = l_wf_html CLIPPED,'            <div id="USUARIOS_1" class="fw-sheet">'
    LET l_wf_html = l_wf_html CLIPPED,'                <div class="ui-widget-content ui-corner-all">'
    LET l_wf_html = l_wf_html CLIPPED,'                    <fieldset>'
    LET l_wf_html = l_wf_html CLIPPED,'                        <div class="fw-input">'
    LET l_wf_html = l_wf_html CLIPPED,'                            <label class="fw-descr-top">Telefone:</label>'
    LET l_wf_html = l_wf_html CLIPPED,'                            <input type="text" name="num_telefone" class="fw-input-char" maxlength="20" size="20" data="{picture:\'(99) 9999-9999\'}">'
    LET l_wf_html = l_wf_html CLIPPED,'                        </div>'
    LET l_wf_html = l_wf_html CLIPPED,'                        <div class="fw-input">'
    LET l_wf_html = l_wf_html CLIPPED,'                            <label class="fw-descr-top">Ramal:</label>'
    LET l_wf_html = l_wf_html CLIPPED,'                            <input type="text" name="num_ramal" class="fw-input-char" maxlength="5" size="5" data="{picture:\'99999\'}">'
    LET l_wf_html = l_wf_html CLIPPED,'                        </div>'
    LET l_wf_html = l_wf_html CLIPPED,'                        <div class="fw-input">'
    LET l_wf_html = l_wf_html CLIPPED,'                            <label class="fw-descr-top">E-mail:</label>'
    LET l_wf_html = l_wf_html CLIPPED,'                            <input type="text" name="e_mail" class="fw-input-char" maxlength="35" size="35">'
    LET l_wf_html = l_wf_html CLIPPED,'                        </div>'
    LET l_wf_html = l_wf_html CLIPPED,'                        <div class="fw-input">'
    LET l_wf_html = l_wf_html CLIPPED,'                            <label class="fw-descr-top">Empresa padr&atilde;o:</label>'
    LET l_wf_html = l_wf_html CLIPPED,'                            <input type="text" name="cod_empresa_padrao" class="fw-input-char" maxlength="02" size="02" data="{picture:\'@!\',zoom:{name:\'zoom_empresa\',selection:[[\'cod_empresa_padrao\',\'cod_empresa\']]}}">'
    LET l_wf_html = l_wf_html CLIPPED,'                        </div>'
    LET l_wf_html = l_wf_html CLIPPED,'                        <div class="fw-input">'
    LET l_wf_html = l_wf_html CLIPPED,'                            <label class="fw-descr-top">Dispositivo padr&atilde;o:</label>'
    LET l_wf_html = l_wf_html CLIPPED,'                            <input type="text" name="cod_impress_padrao" class="fw-input-char" maxlength="10" size="10" data="{picture:\'@!\'}">'
    LET l_wf_html = l_wf_html CLIPPED,'                        </div>'
    LET l_wf_html = l_wf_html CLIPPED,'                        <div class="fw-input">'
    LET l_wf_html = l_wf_html CLIPPED,'                            <label class="fw-descr-top">Idioma:</label>'
    LET l_wf_html = l_wf_html CLIPPED,'                            <select name="idioma" class="fw-input-select" value="1">'
    LET l_wf_html = l_wf_html CLIPPED,'                                <option value="1">Portugu&ecirc;s</option>'
    LET l_wf_html = l_wf_html CLIPPED,'                                <option value="2">Ingl&ecirc;s</option>'
    LET l_wf_html = l_wf_html CLIPPED,'                                <option value="3">Espanhol</option>'
    LET l_wf_html = l_wf_html CLIPPED,'                            </select>'
    LET l_wf_html = l_wf_html CLIPPED,'                        </div>'
    LET l_wf_html = l_wf_html CLIPPED,'                        <div class="fw-input">'
    LET l_wf_html = l_wf_html CLIPPED,'                            <label class="fw-descr-top">&Eacute; administrador?</label>'
    LET l_wf_html = l_wf_html CLIPPED,'                            <select name="ind_admlog" class="fw-input-select" value="N">'
    LET l_wf_html = l_wf_html CLIPPED,'                                <option value="S">Sim</option>'
    LET l_wf_html = l_wf_html CLIPPED,'                                <option value="N">N&atilde;o</option>'
    LET l_wf_html = l_wf_html CLIPPED,'                            </select>'
    LET l_wf_html = l_wf_html CLIPPED,'                        </div>'
    LET l_wf_html = l_wf_html CLIPPED,'                        <div class="fw-input">'
    LET l_wf_html = l_wf_html CLIPPED,'                            <label class="fw-descr-top">Cria pesquisa relacional?</label>'
    LET l_wf_html = l_wf_html CLIPPED,'                            <select name="mantem_pesq_relac" class="fw-input-select" value="N">'
    LET l_wf_html = l_wf_html CLIPPED,'                                <option value="S">Sim</option>'
    LET l_wf_html = l_wf_html CLIPPED,'                                <option value="N">N&atilde;o</option>'
    LET l_wf_html = l_wf_html CLIPPED,'                            </select>'
    LET l_wf_html = l_wf_html CLIPPED,'                        </div>'
    LET l_wf_html = l_wf_html CLIPPED,'                    </fieldset>'
    LET l_wf_html = l_wf_html CLIPPED,'                </div>'
    LET l_wf_html = l_wf_html CLIPPED,'            </div>'
    LET l_wf_html = l_wf_html CLIPPED,'            <div id="USUARIOS_2" class="fw-sheet">'
    LET l_wf_html = l_wf_html CLIPPED,'                <div class="ui-widget-content ui-corner-all">'
    LET l_wf_html = l_wf_html CLIPPED,'                    <fieldset>'
    LET l_wf_html = l_wf_html CLIPPED,'                        <div class="fw-input">'
    LET l_wf_html = l_wf_html CLIPPED,'                            <label class="fw-descr-top">Senha:</label>'
    LET l_wf_html = l_wf_html CLIPPED,'                            <input type="password" name="senha" class="fw-input-char" maxlength="24" size="24">'
    LET l_wf_html = l_wf_html CLIPPED,'                        </div>'
    LET l_wf_html = l_wf_html CLIPPED,'                        <div class="fw-input">'
    LET l_wf_html = l_wf_html CLIPPED,'                            <label class="fw-descr-top">Confirma&ccedil;&atilde;o de senha:</label>'
    LET l_wf_html = l_wf_html CLIPPED,'                            <input type="password" name="confirma_senha" class="fw-input-char" maxlength="24" size="24">'
    LET l_wf_html = l_wf_html CLIPPED,'                        </div>'
    LET l_wf_html = l_wf_html CLIPPED,'                        <div class="fw-input">'
    LET l_wf_html = l_wf_html CLIPPED,'                            <label class="fw-descr-top">Dica de senha:</label>'
    LET l_wf_html = l_wf_html CLIPPED,'                            <input type="text" name="dica_senha" class="fw-input-char" maxlength="16" size="24">'
    LET l_wf_html = l_wf_html CLIPPED,'                        </div>'
    LET l_wf_html = l_wf_html CLIPPED,'                    </fieldset>'
    LET l_wf_html = l_wf_html CLIPPED,'                </div>'
    LET l_wf_html = l_wf_html CLIPPED,'            </div>'
    LET l_wf_html = l_wf_html CLIPPED,'        </div>'
    LET l_wf_html = l_wf_html CLIPPED,'    </div>'
    LET l_wf_html = l_wf_html CLIPPED,'</div>'
 
    RETURN l_wf_html
END FUNCTION
 
#-----------------------------------------------#
FUNCTION log02700_get_wf_form_event(l_event_name)
#-----------------------------------------------#
    DEFINE l_event_name CHAR(50)
    DEFINE l_event_code TEXT
 
    CASE l_event_name
        WHEN "validateForm"
             LET l_event_code = l_event_code CLIPPED,'function validateForm(form) {'
             LET l_event_code = l_event_code CLIPPED,'    var senha = form.getValue("senha"),'
             LET l_event_code = l_event_code CLIPPED,'        confirma_senha = form.getValue("confirma_senha");'
             LET l_event_code = l_event_code CLIPPED,'    if (senha != confirma_senha) {'
             LET l_event_code = l_event_code CLIPPED,'        throw "Senhas informadas não conferem.";'
             LET l_event_code = l_event_code CLIPPED,'    }'
             LET l_event_code = l_event_code CLIPPED,'}'
    END CASE
 
    RETURN l_event_code
END FUNCTION
 
#--------------------------------------------------#
FUNCTION log02700_get_wf_process_event(l_event_name)
#--------------------------------------------------#
    DEFINE l_event_name CHAR(50)
    DEFINE l_event_code TEXT
 
    CASE l_event_name
        WHEN "afterProcessFinish"
             LET l_event_code = l_event_code CLIPPED,'function afterProcessFinish(processId) {
             LET l_event_code = l_event_code CLIPPED,'    var values,result;'
             LET l_event_code = l_event_code CLIPPED,'    values = {'
             LET l_event_code = l_event_code CLIPPED,'            "usuarios" : {'
             LET l_event_code = l_event_code CLIPPED,'                "cod_usuario" : hAPI.getCardValue("cod_usuario"),'
             LET l_event_code = l_event_code CLIPPED,'                "nom_funcionario" : hAPI.getCardValue("nom_funcionario"),'
             LET l_event_code = l_event_code CLIPPED,'                "num_telefone" : hAPI.getCardValue("num_telefone"),'
             LET l_event_code = l_event_code CLIPPED,'                "num_ramal" : hAPI.getCardValue("num_ramal"),'
             LET l_event_code = l_event_code CLIPPED,'                "e_mail" : hAPI.getCardValue("e_mail"),'
             LET l_event_code = l_event_code CLIPPED,'                "cod_empresa_padrao" : hAPI.getCardValue("cod_empresa_padrao"),'
             LET l_event_code = l_event_code CLIPPED,'                "cod_impress_padrao" : hAPI.getCardValue("cod_impress_padrao"),'
             LET l_event_code = l_event_code CLIPPED,'                "ind_admlog" : hAPI.getCardValue("ind_admlog")'
             LET l_event_code = l_event_code CLIPPED,'            },'
             LET l_event_code = l_event_code CLIPPED,'            "log_usuarios_compl" : {'
             LET l_event_code = l_event_code CLIPPED,'                "idioma" : hAPI.getCardValue("idioma"),'
             LET l_event_code = l_event_code CLIPPED,'                "mantem_pesq_relac" : hAPI.getCardValue("mantem_pesq_relac")'
             LET l_event_code = l_event_code CLIPPED,'            },'
             LET l_event_code = l_event_code CLIPPED,'            "usuario_senha" : {'
             LET l_event_code = l_event_code CLIPPED,'                "senha" : hAPI.getCardValue("senha")'
             LET l_event_code = l_event_code CLIPPED,'            },'
             LET l_event_code = l_event_code CLIPPED,'            "log_usu_troca_sen" : {'
             LET l_event_code = l_event_code CLIPPED,'                "dica_senha" : hAPI.getCardValue("dica_senha")'
             LET l_event_code = l_event_code CLIPPED,'            }'
             LET l_event_code = l_event_code CLIPPED,'    };'
             LET l_event_code = l_event_code CLIPPED,'    result = callLogixFunction("log02700_create_usuario", values);'
             LET l_event_code = l_event_code CLIPPED,'    if (result) {'
             LET l_event_code = l_event_code CLIPPED,'        if (result.status) {'
             LET l_event_code = l_event_code CLIPPED,'            log.info("[LOGIX] " + result.msg);'
             LET l_event_code = l_event_code CLIPPED,'        } else {'
             LET l_event_code = l_event_code CLIPPED,'            log.error("[LOGIX] Nao foi possivel concluir a criacao do usuario ["+ result.msg + "]");'
             LET l_event_code = l_event_code CLIPPED,'        }'
             LET l_event_code = l_event_code CLIPPED,'    }'
             LET l_event_code = l_event_code CLIPPED,'}'
    END CASE
 
    RETURN l_event_code
END FUNCTION

Observações

Se houver erros durante a manutenção do processo, para recuperar a mensagem e os detalhes do mesmo deve-se utilizar a função WfGetError.

Arquivo 4GL utilizado no exemplo desta função: log02700.4gl.