PORTAL DE DOCUMENTAÇÃO
Gestão Empresarial | ERP - versão 5.10.3 (XTended)
Integrações com outros sistemas > Web services > Web services disponíveis no Gestão Empresarial > Com.senior.g5.co.ger.monitorprocesso

Web service Com.senior.g5.co.ger.monitorprocesso

O web service de Monitor de Processos tem como objetivo retornar a visão geral de como está a execução dos Processos automáticos e Web services. O retorno das informações é feito no padrão JSON, dividindo em dois blocos as informações:

As informações são as mesmas da tela Monitoramento de Processos ERP XT (F000MPE) do sistema.

Tipo de execução

Para cada tipo de execução, existem diferentes parâmetros que podem ser comuns a todas as portas.

Autenticação

Caso seja utilizada alguma forma de autenticação para integração de informações através de web services, é necessário identificar o tipo no parâmetro <encryption>, conforme seus valores possíveis.

Campos numéricos

Orientação válida para qualquer campo de web service que possui objetivo de receber valores, independentemente do seu tipo ser Integer, Double e String. Estas orientações devem ser seguidas nas requisições efetuadas via SOAP e em execuções efetuadas através do SGI, relatórios e regras LSP.

ClosedCampos que representam valores monetários, quantidade e percentual e estão declarados como String
  • Envio no formato ZZZZ,ZZ
  • É fundamental não enviar os campos numéricos com separador de milhar, pois ocorrerá erro ao executar a requisição
  • Obrigatória a utilização do separador decimal com vírgula, e não com ponto
  • Obrigatória a utilização do zero a direita. Por exemplo, se o valor for 350,20, a requisição deve ser enviada com este exato valor. Se o valor enviado for enviado como 350,2, o sistema não irá interpretar a requisição adequadamente
ClosedExemplo:

number(005,2) = 350,20 - o sistema espera que o número digitado contenha até 3 casas antes da vírgula e obrigatoriamente duas após;

number(015,2): 35000,20 - o sistema espera que o número digitado contenha até 13 casas antes da vírgula e obrigatoriamente duas após;

number(008,4) = 3200,2074 - o sistema espera que o número digitado contenha até 4 casas antes da vírgula e obrigatoriamente duas após.

ClosedCampos que representam valores monetários, quantidade e percentual e não estão declarados como String
  • Envio no formato ZZZZ.ZZ
  • É fundamental não enviar os campos numéricos com separador de milhar, pois ocorrerá erro ao executar a requisição
  • Obrigatória a utilização do separador decimal com ponto, e não com vírgula
ClosedExemplo:
  • number(005,2) = 350.20 - o sistema espera que o número digitado contenha até 3 casas antes da vírgula e obrigatoriamente duas após;
  • number(015,2): 35000.20 - o sistema espera que o número digitado contenha até 13 casas antes da vírgula e obrigatoriamente duas após;
  • number(008,4) = 3200.2074 - o sistema espera que o número digitado contenha até 4 casas antes da vírgula e obrigatoriamente duas após.

WSDL

Portas

ClosedExecutar

Necessita autenticação: sim.

Situação de versão: atual.

Versão: 1.

ClosedRequisição: 
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:Executar>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <linhaDados>
          <datIni>DateTime</datIni>
          <datFim>DateTime</datFim>
        </linhaDados>
      </parameters>
    </ser:Executar>
  </soapenv:Body>
</soapenv:Envelope>
ClosedParâmetros da requisição:
Nome Tipo Preenchimento Descrição
linhaDados Set Opcional  
linhaDados.datIni DateTime Obrigatório Date(DD/MM/AAAA) - Data inicial da execução do processo automático e do serviço (Período máximo 3 dias)
linhaDados.datFim DateTime Obrigatório Date(DD/MM/AAAA) - Data final da execução do processo automático e do serviço (Período máximo 3 dias)
ClosedResposta:

Observação

Envelope SOAP de resposta de requisições síncronas. Para requisições assíncronas ou agendamentos, a resposta é apenas uma String chamada "result" com o valor "OK", se foi executado com sucesso ou, caso contrário, a mensagem do erro ocorrido. 

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:ExecutarResponse>
      <result>
        <retorno>
          <jSon>String</jSon>
          <tipRet>Integer</tipRet>
          <msgRet>String</msgRet>
        </retorno>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:ExecutarResponse>
  </soapenv:Body>
</soapenv:Envelope>
ClosedAtributos da resposta:
Nome Tipo Preenchimento Descrição
retorno Set Opcional  
retorno.jSon String Opcional

Retorno das informações dos Processos Automáticos (PA) e Serviços (WS). Retorna em formato JSON, conforme abaixo:

{
   "indicadores":{
      "versao_layout": Versão do layout do JSON,
      "tenant": Identificador do grupo de usuários,
      "clientecodigo": Código do Cliente,
      "data": Data de geração do JSON,
      "processos":[
         {
            "codpra": Código do PA,
            "despra": Descrição do PA,
            "medtmp": Tempo médio dos PAs executados no período filtrado e que foram executados com sucesso. (Em minutos),
            "qtdexc": Quantas vezes o PA foi executado dentro do período selecionado,
            "naofin": Quantas vezes o PA finalizado dentro do período selecionado,
            "sucess": Quantas vezes o PA executou com sucesso dentro do período selecionado,
            "errprc": Quantas vezes o PA deu erro dentro do período selecionado,
            "medmin": Tempo médio dos PAs executados no período filtrado e que foram executados com sucesso. (Em segundos),
            "maitmp": Maior tempo dos PAs executados no período filtrado e que foram executados com sucesso. (Em segundos),
            "mnrtmp": Menor dos PAs executados no período filtrado e que foram executados com sucesso. (Em segundos),
            "ultsta": Status do último PA executado,
            "tmpexc": Tempo que o PA está sendo executado (Válido apenas para os PA's em execução - "Andamento"),
            "sitexc": Situação do último PA executado,
            "tipper": Código da periodicidade que o PA é executado,
            "period": Descrição da periodicidade que o PA é executado,
            "ultexc": Data da última execução do PA,
            "ulthor": Hora da última execução do PA (Em minutos),
            "prxexc": Data prevista para a próxima execução do PA,
            "prxhor": Hora prevista para a próxima execução do PA (Em minutos),
            "datatu": Data de geração do JSON,
            "atuhor": Hora de geração do JSON (em minutos),
            "status": Se o PA foi executado dentro da periodicidade planejada,
            "interv": Intervalo de tempo, de acordo com a periodicidade, que o PA é executado
         }
      ],
      "webservices":[
         {
            "tipser": Tipo do WS executado,
            "nomsvr": Nome do WS executado,
            "qtdexc": Quantas vezes o WS foi executado dentro do período selecionado,
            "excsuc": Quantas vezes o WS executou com sucesso dentro do período selecionado,
            "medmin": Média de tempo em minutos que o PA leva para executar,
            "medseg": Média de tempo em segundos que o PA leva para executar,
            "minseg": Menor tempo de execução do WS. (Em segundos),
            "maxseg": Maior tempo de execução do WS. (Em segundos),
            "emexec": Quantas vezes o PA está sendo executado dentro do período selecionado,
            "errows": Quantas vezes o PA executou com erros dentro do período selecionado,
            "memomb": Memória utilizada na execução do WS (Em Megabytes),
            "ultsta": Status do último WS executado,
            "datsta": Data da última execução do WS,
            "horsta": Hora da última execução do WS (Em minutos)
         }
      ]
   }
}

retorno.tipRet Integer Obrigatório Tipo de Retorno de Processamento - Lista: 1 = Processado, 2 = Erro na Solicitação
retorno.msgRet String Opcional Mensagem de sucesso ou erro gerada após a execução do webservice.
erroExecucao String Opcional
  • Indica erros ocorridos no servidor ao executar o serviço, podendo conter os seguintes valores:
    • Vazio ou nulo, indicando que a execução foi feita com sucesso
    • A mensagem do erro ocorrido no servidor
  • Só impede a gravação quando o retorno.tipRet for igual a "2"

Este artigo ajudou você?

Base de Conhecimento

Portal de Exigências Legais

Documentação em outros idiomas:

English

Español

Senior Store

Universidade Corporativa

Fórum de Produtos

Trabalhe conosco

Blog

Todos os direitos de cópias reservadas para Senior Sistemas S.A.

A reprodução não autorizada desta publicação, no todo ou em parte, constitui violação dos direitos autorais (Lei 9.610/98).

Ver site completo