INTRODUÇÃO

Este manual tem a finalidade de ajudá-lo a instalar o extrator do RetailApp em seu servidor.

Requisitos

• Windows 7/Server 2008 ou superior.

• 2gb RAM.

• 20gb HD.

• Acesso a internet.

• Liberação de Firewall para a API do RetailApp (é informada na contratação do produto).

• A máquina deve permanecer ligada 24 horas ou, pelo menos, no horário de expediente da loja.

• Acesso ao banco de dados do sistema(TOTVS Moda)

Os arquivos para instalação da ferramenta de extração deve ser solicitado ao suporte do TOTVS Moda que ira providenciar e enviar o mesmo a quem necessitar. No arquivo deverão existir duas pastas: RetailApp.WConfig e RetailApp.WService.

RetailApp.WConfig

Nesta pasta estão os arquivos que são utilizados para a criação do componente de extração manual e configuração do RetailApp.

RetailApp.WService

Nesta pasta estão os arquivos que são utilizados para a extração automática de dados do RetailApp. Aqui também é localizado o instalador do serviço Windows que ficará responsável pelo envio de dados.

Configuração dos arquivos de extração manual RetailApp.Wconf

 

Copie a pasta RetailApp.Wconf para a pasta onde está localizada a instalação do sistema TOTVS Moda, a mesma está localizada em C:\virtualage\storeage\Cole a pasta aqui. Dentro desta pasta há 4 arquivos que precisam ser configurados, com os nomes: ‘RetailApp.Wconf.exe.config’, ‘RetailApp.Wambiente.exe.config’, ‘RetailApp.Repositorio.dll.config’ e ‘RetailApp.Servico.dll.config’, onde em cada um há um XML com algumas configurações da aplicação, como a informação de qual o nome do banco de dados que os dados serão extraídos.

Configuração dos arquivos:

• RetailApp.Wconf.exe.config

  Troque a tag appSetings → add<key = hostname> <value = ORAWEB>

          Para appSetings → add<key = hostname> <value = NOME_DO_BANCO>       

• RetailApp.WAmbiente.exe.config

  Troque a tag appSetings → add<key = hostname> <value = ORAWEB>

         
 
         Para appSetings → add<key = hostname> <value = NOME_DO_BANCO>    

• RetailApp.Repositorio.dll.config

  
  Troque a tag appSetings → add<key = hostname> <value = ORAWEB>

         

          Para appSetings → add<key = hostname> <value = NOME_DO_BANCO>

• RetailApp.Servico.dll.config

  Troque a tag appSetings → add<key = hostname> <value = ORAWEB>

          Para appSetings → add<key = hostname> <value = NOME_DO_BANCO>

         

 
Com a pasta RetailApp.Wconf adicionada em C:\virtualage\storeage\ e os arquivos configurados com o nome do banco de dados, já é possível acessar a ferramenta de extração manual através do sistema Virtual Age, através do componente DICFM019, para informações sobre como configurá-lo, siga o manual de configuração Configuração inicial para o RetailApp.

Configuração dos arquivos de extração automática RetailApp.Wconf

Copie a pasta RetailApp.WService para algum local onde achar mais conveniente, não há restrições quanto ao local contanto que a mesma não seja movida posteriormente. Dentro desta pasta há 3 arquivos que precisam ser configurados, com os nomes: ‘RetailApp.Wconf.exe.config’, ‘RetailApp.Repositorio.dll.config’ e ‘RetailApp.Servico.dll.config’, onde em cada um há um XML com algumas configurações da aplicação, como a informação de qual o nome do DataBase que os dados serão extraídos. 

Configuração dos arquivos:

•  RetailApp.WService.exe.config

           Troque a tag appSetings → add<key = hostname> <value = ORAWEB>

           Para appSetings → add<key = hostname> <value = NOME_DO_BANCO>

• RetailApp.Repositorio.dll.config

           Troque a tag appSetings → add<key = hostname> <value = ORAWEB>

           Para appSetings → add<key = hostname> <value = NOME_DO_BANCO>

• RetailApp.Servico.dll.config

           Troque a tag appSetings → add<key = hostname> <value = ORAWEB>

          Para appSetings → add<key = hostname> <value = NOME_DO_BANCO>

Após a configuração dos arquivos, é preciso instalar o serviço do Windows que ficará responsável por enviar os dados para o RetailApp de tempos em tempos. O instalador está localizado na pasta copiada RetailApp.Wservice, lá há o executável com o nome ‘RetailApp.Winstall.exe’, abra-o e será apresentada uma tela com um botão ‘Instalar’, clique nele, e nas telas seguintes basta clicar em ‘Sim’. Com isso o serviço estará instalado. Para verificar, basta entrar no gerenciador de tarefas, na aba Serviços, há um registro com o nome ‘ServiceRetailApp’.

Agora assim que os parâmetros de extração do RetailApp forem configurados no sistema conforme documentação Configuração inicial para o RetailApp, e o checkbox ‘Utiliza RetailApp’ da tela DICFM019 estiver marcado, a ferramenta automática enviará os dados para o servidor do RetailApp.