Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Descrição:

QIEIntAPI - Eventos de Integração do SIGAQIE com as APIs do APP Minha Produção

Versões:

Microsiga Protheus 12

Idioma:

Português (Brasil)

Sistemas Operacionais Suportados:

Todos

Compatível com as Bases de Dados:

Todos

Parâmetro:

ParamIXB[1] - Objeto Json com dados correspondentes ao Evento (ParamIXB[4]), por exemplo:

  1. Evento "laboratoriosRelacionadosAoUsuario" - Filtra os dados do aplicativo relacionados aos laboratórios retornados no array:
    1. oDados['loginUsuario'] -> Login do usuário logado

  2. Evento "complementoAmostra" - Gravação complementar após inclusão da amostra de resultados:
    1. oDados['QPR_' + ...]  -> Campos da QPR relacionados a gravação

  3. Evento "complementoResultados" - Gravação complementar após inclusão de todas as amostras de resultados;:
    1. oDados['items']  -> Array de amostras destinadas pelo aplicativo para inclusão conforme documentação POST Postman processinspectiontestresults/api/qip/v1/save;

  4. Evento "complementoLaudo" - Gravação complementar após a inclusão de laudos:
    1. oDados['login']  -> Login do usuário logado
    2. oDados['laudo']  -> geral / laboratorio / operacao
    3. oDados['insert']  -> Indicador de operação de inclusão
    4. oDados['update']  -> Indicador de operação de atualização

    5. Laudo Geral / Laudo de Laboratório:
      1. oDados['recnoQPL']  -> RECNO do registro relacionado na tabela QPL - Laudo da Ordem de Produção

    6. Laudo Operação:
      1. oDados['recnoQPM']  -> RECNO do registro relacionado na tabela QPM - Laudo da Operação

  5. Evento "bloqueioDataInspecao" - Bloqueia o campo de data de inspeção da amostra de resultados:
    1. oDados['login']  -> Login do usuário logado
    2. oDados['recnoQPK']  -> RECNO do registro relacionado na tabela QPK - Insp.Processos - Avaliacoes
    3. oDados['recnoQPR']  -> RECNO do registro relacionado na tabela QPR - Medições - Dados Genericos
    4. oDados['operationID']  -> Código da operação relacionada
    5. oDados['insert']  -> Indicador de operação de inclusão
    6. oDados['update']  -> Indicador de operação de atualização

  6. Evento "bloqueioHoraInspecao" - Bloqueia o campo de hora de inspeção da amostra de resultados:
    1. oDados['login']  -> Login do usuário logado
    2. oDados['recnoQPK']  -> RECNO do registro relacionado na tabela QPK - Insp.Processos - Avaliacoes
    3. oDados['recnoQPR']  -> RECNO do registro relacionado na tabela QPR - Medições - Dados Genericos
    4. oDados['operationID']  -> Código da operação relacionada
    5. oDados['insert']  -> Indicador de operação de inclusão
    6. oDados['update']  -> Indicador de operação de atualização

  7. Evento "qpuInclusaoSemQIPQNC" - Permite inclusão de Não Conformidades na tabela QPU relacionadas à inspeção sem integração ao módulo QNC, quando MV_QIPQNC desabilitado.
    1. oDados['code']  -> Status da mensagem de retorno;
    2. oDados['result']  -> .T. se MV_QIPQNC habilitado, .F. se MV_QIPQNC desabilitado.

  8. Evento "qpuCamposAdicionais" - Permite indicar campos adicionais a serem exibidos no APP na relação de NCs.
    1. oDados → Nil


ParamIXB[2] - Endpoint de execução do ponto de entrada;
ParamIXB[3] - Classe da API relacionada;
ParamIXB[4] - Evento, exemplo:

  1. "laboratoriosRelacionadosAoUsuario" - Filtra os dados do aplicativo relacionados aos laboratórios retornados no array;
  2. "complementoAmostra" - Gravação complementar após inclusão da amostra de resultados; 
  3. "complementoResultados" - Gravação complementar após inclusão de todas as amostras de resultados;
  4. "complementoLaudo" - Gravação complementar após a inclusão de laudos;
  5. "bloqueiaDataInspecao" - Bloqueia o campo de data de inspeção da amostra de resultados;
  6. "bloqueiaHoraInspecao" - Bloqueia o campo de hora de inspeção da amostra de resultados;
  7. "qpuInclusaoSemQIPQNC" - Permite inclusão de Não Conformidades na tabela QPU relacionadas à inspeção sem integração ao módulo QNC, quando MV_QIPQNC desabilitado;
  8. "qpuCamposAdicionais" - Permite indicar campos adicionais a serem exibidos no APP na relação de NCs.

Retorno:

xReturn, varia de acordo com o Evento (ParamIXB[4]), por exemplo:

  1. Evento "laboratoriosRelacionadosAoUsuario":
    1. aLabsFil - Array com relação de laboratórios que o usuário faz parte;

  2. Evento "complementoAmostra":
    1. Nil - não usado.

  3. Evento "complementoResultados":
    1. Nil - não usado.

  4. Evento "complementoLaudo":
    1. Nil - não usado,

  5. Evento "bloqueioDataInspecao":
    1. lBloqueio - Lógico indicando se deve bloquear o campo data de inspeção da amostra;

  6. Evento "bloqueioHoraInspecao":
    1. lBloqueio - Lógico indicando se deve bloquear o campo Hora de inspeção da amostra;

  7. Evento "qpuInclusaoSemQIPQNC":
    1. lRetorno - Lógico indicando se deve incluir Não Conformidades na tabela QPU relacionadas à inspeção sem integração ao módulo QNC, quando MV_QIPQNC desabilitado.

  8. Evento "qpuCamposAdicionais":

    1. aCampos – Array Json com relação de campos customizados da tabela QPU para uso em telas de inclusão, edição e consulta de NCs. Propriedades:

      1. codigo (obrigatório): código do campo, por exemplo "QPU_MEUCPO".

      2. default (opcional): valor padrão atribuído ao campo na inclusão.

      3. placeHolder (opcional): texto de sugestão a ser exibido no campo.

      4. tabelasx5 (opcional): código da tabela SX5 para uso em consultas do APP.

      5. permiteInclusao (opcional): indica se o campo será exibido na tela de inclusão.

      6. permiteEdicao (opcional): indica se o campo pode ser editado nas telas de Detalhes da Ficha / Edição da Ficha.

      7. conteudoConsulta (opcional): código ADVPL executado para retorno do conteúdo em consultas de NCs, ex.: QPU→QPU_MEUCPO.

      8. tituloConsulta (obrigatório): título exibido nas telas de consulta.

      9. tituloInclusao (opcional): título exibido somente na tela de inclusão.

      10. grid (opcional): indica se o campo será exibido na grid.

      11. tamanho (interno): limite de caracteres aceito no preenchimento do APP.

      12. obrigatorio (interno): indica se o campo é de preenchimento obrigatório.

    2. Propriedades obrigatórias:

      1. "codigo" e "tituloConsulta".

      2. Em caso de campo "permiteInclusao", obrigatório preenchimento de "tituloInclusao" ou "placeHolder";
    3. Observações:

      1. Quando o campo não for encontrado na SX3, o sistema utilizará o conteúdo fornecido pelo cliente.

      2. Somente permitido para uso com campos do tipo caracter.

      3. Pode ser utilizado com campo fictício e retorno de posicionamento externo com base posicionamento atual na QPR e QPU;
Eventos de chamada de Ponto de Entrada:

Varia de acordo com o Evento (ParamIXB[4]):

  1. Evento "laboratoriosRelacionadosAoUsuario", endpoints:
    1. incominginspectiontestreports/api/qie/v1/list

    2. incominginspectiontestreports/api/qie/v1/test
    3. incominginspectiontestreports/api/qie/v1/pendinglist
    4. incominginspectiontestreports/api/qie/v1/search
    5. incominginspectiontestreports/api/qie/v1/inspection

  2. Evento "complementoAmostra", endpoints:
    1. incominginspectiontestreports/api/qie/v1/save

  3. Evento "complementoResultados", endpoints:
    1. incominginspectiontestreports/api/qie/v1/save

  4. Evento "complementoLaudo", endpoints:
    1. incominginspectiontestreports/api/qie/v1/savegeneralreport
    2. incominginspectiontestreports/api/qie/v1/savelaboratoryreport
    3. incominginspectiontestreports/api/qie/v1/saveoperationreport

  5. Evento "bloqueiaDataInspecao", endpoints:
    1. incominginspectiontestreports/api/qie/v1/dateeditpermission

  6. Evento "bloqueiaHoraInspecao", endpoints:
    1. incominginspectiontestreports/api/qie/v1/timeeditpermission

  7. Evento "qpuInclusaoSemQIPQNC", endpoints:
    1. nonconformancerecords/api/qip/v1/processinspectionintegrationstatus

  8. Evento "qpuCamposAdicionais", endpoints:
    1. nonconformancerecords/api/qip/v1/qpuextrafields
    2. processinspectiontestresults/api/qip/v1/save
    3. nonconformancerecords/api/qip/v1/qipinspectionrelatednonconformance
Programa Fonte:

QualityAPIManager.prw

QIELaudosEnsaios.prw

InspecoesDeEntradasAPI.prw

ResultadosEnsaiosInspecaoDeEntradasAPI.prw

EnsaiosInspecaoDeEntradasAPI.prw

...