Cross Segmentos - Linha Datasul - MLA - Criação de novo documento para ser aprovado pelo MLA

 Tempo aproximado para leitura: 00:05:40 min

Dúvida
Quais os passos para criação de um novo documento para ser aprovado pelo módulo do MLA - Módulo Logístico de Aprovação?

Ambiente
Cross Segmentos - TOTVS Backoffice (Linha Datasul) - Aprovação Processo Logístico (MLA) - Versão 12

Solução
Para criação de um documento para ser aprovado pelo módulo do MLA, seja um documento padrão ou específico, deve-se seguir os passos listados na sequência: 

• Definir um número para documento em questão: 
  No caso de documentos padrões, a numeração deve ser até 500. Para verificar os documentos já existentes, consultar Cross Segmentos - Linha Datasul - MLA - Quais informações devem ser preenchidas no programa MLA0101, o ideal é criar o documento com a próxima numeração livre. 
  Após a liberação do novo documento, atualizar esse documento citado para contemplá-lo.
  No caso de documentos específicos a serem integrados ao MLA, deverão utilizar a faixa de códigos de 501 a 999.
  
  
• Definir qual será a chave do documento:
  Verificar exemplos existentes no artigo: Cross Segmentos - Linha Datasul - MLA - Chaves dos documentos no MLA0102.
  No caso de documentos padrões, atualizar esse documento citado para contemplar a chave do novo documento.
  
  
• Definir qual a referência que representa o documento em questão: 
  Essa referência poderá ser utilizada como diferencial de aprovação. Verificar exemplos existentes no artigo Cross Segmentos - Linha Datasul - MLA - Informações consideradas como referência para os documentos do MLA. No caso de documentos padrões, atualizar esse documento citado para contemplar a referência do novo documento.
  
  
• Preparar a geração das pendências: 
  Para a criação, alteração ou eliminação de pendências do documento no módulo do MLA, deverá ser utilizada a API lap/mlaapi001.p. Para mais informações sobre como utilizar, verifique a documentação técnica da mesma. É importante ressaltar que é necessário fazer a chamada dessa API em todos os momentos que houverem modificações no documento que originou a pendência no MLA, caso contrário a pendência pode ficar divergente do documento original. 
  
  
• Preparar a consulta e aprovação das pendências: 
  Para consulta e aprovação das pendências, deve-se realizar algumas implementações que permitam a visualização/aprovação da mesma:
  • MLA0121 - Programa de Consulta: Para que seja possível consultar informações de negócio da pendência gerada, através do programa MLA0301 - Aprovação de Pendências, é possível disponibilizar programas de consulta para serem utilizados neste caso. 
  • Portal HTML: Para que seja possível aprovar o novo documento através das telas HTML, é necessário seguir as orientações apresentadas no artigo: Cross Segmentos - Linha Datasul - MLA - Como criar documentos para o Portal do MLA em HTML ou customizar documentos existentes, tópico Criação de Documentos Novos, que fica após a parte de customização.
  • Aprovação por e-mail: Para que seja possível realizar a aprovação por e-mail, do documento criado, deverá ser criado um programa com a seguinte nomenclatura: mlahtml<código do documento com 3 dígitos>e.p, que deverá ficar no diretório lapthml. Exemplo para o documento 1: laphtml/mlahtml001e.p.
    O programa deve possuir os seguintes parâmetros:  
    • Código do tipo do documento (INTEGER - INPUT), Código do aprovador (CHARACTER - INPUT), Chaves do documento - tt-mla-chave (TEMP-TABLE - definição na include: lap/mlaapi001.i99 - INPUT) HTML do e-mail - tt-html (TEMP-TABLE - definição na include: laphtml/mlahtml.i - OUTPUT).
      
      
• APP Minhas Pendências de Aprovação: Para que seja possível aprovar o novo documento através do APP, é necessário seguir as orientações apresentadas no artigo Cross Segmentos - Linha Datasul - MLA - Disponibilizar documentos para serem aprovados pelo APP - Minhas Pendências de Aprovação.
  
  
• Programa de aprovação/rejeição: Caso haja necessidade de executar alguma atualização no módulo de origem, assim que ocorrer a aprovação ou rejeição do documento no MLA, é possível criar um programa para incluir essas regras a serem executadas. Esses programas são cadastrados no MLA0101 – Tipos de Documentos.
  O programa criado deve receber três parâmetros, todos de entrada: 
  • Rowid da pendência do MLA – tabela mla-doc-pend-aprov - Tipo ROWID;
  • Código do aprovador da pendência - Tipo CHARACTER – x(12);
  • Indicador de que se trata da última pendência de uma hierarquia - Tipo LOGICAL.
    
    
• Preparar a inclusão facilitada do documento: no caso de documentos padrões, é preciso realizar as implementações no programa MLA0122 – Inclusão Facilitada Tipo Documento, para que o novo documento e sua chave possam ser gerados de forma automatizada pelo usuário.
  
  
• Alteração de BOs que fazem a verificação e geração de pendências, quando há mais de um tipo de aprovação: no caso de novos documentos (padrões ou específicos), é preciso realizar as implementações nos seguintes pontos:
  • inbo/boin767b.p – procedure geraPend: Incluir o tratamento para o novo documento, seguir o exemplo dos já existentes;
  • inbo/boin767a.p – procedure checkPend: Incluir o tratamento para o novo documento, seguir o exemplo dos já existentes.

Para o caso de documentos específicos quando existir necessidade de mais de um tipo de aprovação, será necessário solicitar customização das BOs boin767b e boin767a para incluir o tratamento para o novo documento.