Instalação


  1. Criar no Linux o diretório “linx-servico-prisma-ws” embaixo do diretório de preferência. A escolha do deste diretório não irá interferir na execução do serviço;
  2. Extrair o conteúdo do arquivo “SERVICO-PRISMA-WS-xx.xx.xx-Dxx” no diretório criado.
  3. Abrir a pasta extraída, acessar a pasta “bin
  4. Executar o comando "dos2unix exec-servico.sh" para converter a quebra de linha do shell script para o padrão Linux.
  5. Executar  "exec-servico.sh &".
  6. O serviço já está em execução.


Configuração dos parâmetros com Servidor de Configuração


  1. Acessar “http://<ip>:<porta>/linx-servidor-configuracao/
  2. Entrar com “Nome de usuário” e “Senha
  3. Fazer upload de dados:
    1. A função deste passo é criar a estrutura dos parâmetros que serão posteriormente configurados e monitorados no servidor de configurações.
    2. Acessar manutenção -> Upload de Dados
    3. Ir na pasta em que o projeto foi extraído, abrir a pasta “serv-config” e arrastar ou adicionar o arquivo “serv-config-linx-servico-prisma-ws.xml” na área “Novo arquivo de dados” conforme mostra figura abaixo.
  4. Adicionar uma nova aplicação:
    1. Acessar Manutenção -> Aplicação -> NOVO
    2. Inserção dos dados
      1. Nome = nome da aplicação

      2. Grupo de parâmetros= GPR-LINX-SERVICO-PRISMA-WS – GLOBAL

      3. Endereço/porta = IP/Porta

      4. Tipo da chave = LINX-SERVICO-PRISMA-WS

      5. Empresa/Número = Empresa e número da loja

      6. Salvar

    3. Alterar parâmetros

      1. Acessar Manutenção -> Parâmetros -> Aplicação

      2. Pesquisar pela aplicação, empresa e loja

      3. Expandir GRP-LINX-SERVICO-PRISMA-WS-GLOBAL

      4. Alterar valor do parâmetro desejado e confirmar

      5. Os parâmetros do serviço serão atualizados assim que o serviço deste IP/porta estiver em execução.

    4. Descrição de parâmetros

      1. Login e senha do WebService = representam os dados de acesso ao WS. São criptografados em propertie do serviço.

      2. URL consulta/queima ofertas = URL destes serviços no WebService.

      3. Diretório padrão = Diretório em que os arquivos serão lidos e escritos. Lembrando que serão criados os diretórios “input” e “output” dentro desta pasta. Os arquivos de entrada estarão na pasta “input” e, após processados, os arquivos de saída estarão na pasta “output”.

      4. Os arquivos consulta ofertas e consulta queima são arquivos os arquivos que o prisma irá criar na pasta “input” que tratam de solicitações ao WS.

      5. Os arquivos resposta ofertas e resposta queima são o retorno do WS processados em arquivo texto pelo serviço-prisma-ws.


Configuração dos parâmetros direto no property


  1. Após a instalação, editar o arquivo parametros.properties dentro do diretório bin.
  2. Configurar o conteúdo dos parâmetros:
    1. webservice.login = <Usuário de autenticação do serviço criptografado. Utilizar a opção "Via linha de comando" do Linx Crypto - Instruções de Instalação para criptografar a string do nome do usuário. Este utilitário está disponível no FTP>

    2. webservice.senha = <Senha de autenticação do serviço criptografado. Utilizar a opção "Via linha de comando" do Linx Crypto - Instruções de Instalação para criptografar a string da senha.Este utilitário está disponível no FTP>

    3. webservice.url-consulta-ofertas = <URL do serviço de consulta de ofertas>

    4. webservice.url-queima-ofertas = <URL do serviço de queima de ofertas>

    5. arquivo.dir-base = //lasa//pdvs//dados//agentws//

    6. arquivo.consulta-oferta = COFERTAS

    7. arquivo.consulta-queima = SQUEIMA

    8. arquivo.resposta-oferta = ROFERTAS

    9. arquivo.resposta-queima = RQUEIMA

  3. Salvar o arquivo reiniciar o serviço.

 

Características e funcionamento


  1. Ao ser executado, o serviço irá verificar a validade dos parâmetros configurados. Caso os parâmetros não sejam válidos, o serviço ficará em loop até que sejam configurados parâmetros válidos no servidor de configurações.

  2. Após os parâmetros serem verificados, o serviço ira no diretório padrão verificar se existem arquivos não processados na pasta input. Caso tenha, o serviço instanciará uma thread para cada um desses arquivos realizando o seu processamento e escrevendo o resultado na pasta output.

  3. Ao processar todos os arquivos contidos na pasta, o serviço ficará observando o diretório padrão esperando a criação de mais arquivos para serem processados.

  4. Sempre que um arquivo for adicionado, o serviço acorda e instancia uma thread nova para o processamento desse arquivo.


Log


  1. No diretório bin/log será criado um arquivo de log para cada dia de processamento limitando-se a quantidade de 30 dias.



  • Sem rótulos