Configurações especiais

Otimizar tempo de execução dos serviços

Para web services, há um recurso para otimizar o tempo de execução dos serviços, quando são executados consecutivamente e pelo mesmo usuário. O recurso possibilita efetuar um único login de usuário, quando o serviço for executado pela primeira vez, e o mantém ativo por determinado período de tempo, e após a execução permite efetuar outros serviços com o mesmo usuário, sem a necessidade de efetuar o login e logoff.

Caso o recurso não for utilizado, a cada nova execução do serviço será efetuado o login de usuário e, após a execução do serviço será efetuado o logoff. Com o recurso ativo, enquanto o tempo determinado não expirar e houver envio de serviços consecutivamente para a mesma instância de serviços para o mesmo usuário, o logoff não será efetuado e o usuário permanecerá ativo.

O objetivo deste recurso é otimizar o tempo de execução dos serviços, pois todos os recursos e permissões do usuário não necessitam ser filtrados novamente para cada execução do serviço, apenas uma vez. Caso o período de tempo determinado for ultrapassado ou algum dos serviços enviados, dentro do período de tempo, for executado por outro usuário, será efetuado o logoff do usuário atual e o novo login será realizado, recomeçando a contagem do tempo.

Observações
  • O sistema permanece validando o usuário e a senha, independente se o login do usuário continua ativo;
  • O recurso deve ser utilizado apenas se houver vários serviços consecutivos sendo executados com o mesmo usuário. Como exemplo, em situações de integrações, onde é comum um aplicativo externo acionar serviços com o mesmo usuário. Serviços que recebem grande massa de dados não se beneficiam plenamente desse recurso, pois o tempo de processamento da massa de dados pode ultrapassar o tempo em que o login do usuário é mantido ativo;
  • Quando esse recurso estiver ativo, o usuário é mantido ativo no sistema todo o tempo. O logoff não é efetuado explicitamente após o término do serviço, mas sim quando receber uma nova solicitação para execução de um serviço;
  • O tempo de permanência de login ativo deve ser definido na configuração do ambiente, aprimorando-se conforme a necessidade. Não há uma sugestão padrão para o valor, visto ser necessário adequar conforme o ambiente de utilização dos serviços, hardware, número de requisições, tipo de serviço sendo utilizado e massa de dados a ser processada a cada requisição;
  • Serviços anônimos forçam o logoff do usuário atual, independente do novo recurso.

A configuração do tempo para realização do login é efetuada em: SeniorConfiCenter > Sistemas > Gestão Empresarial (ERP) > Configurações > Tempo máximo para refazer o login de usuário em Web Services. Esse campo é representado por segundos.


Limite de página e índice de página

Alguns web services possuem dois campos específicos para tratar o limite de página e o índice de página. Segue abaixo informação sobre a funcionalidade deles e também um exemplo de utilização, que vale para qualquer web service que disponibiliza esses parâmetros.

Abrangência/codificação de produto

Quando um código de produto contém o caractere hífen ("-"), como em MOPR-000650, as rotinas de busca do sistema dividem o código em duas partes e isso pode causar inconsistências nas buscas. Dessa forma, para o correto funcionamento, deve-se enviar o código do produto entre aspas, por exemplo: "MOPR-000650". Isso garante que a execução ocorrerá corretamente. Esse comportamento é generalizado no ERP para qualquer campo chave que contenha hífen e que possa ser buscado com abrangência em algum web service.