Manuais by You

Integrao Protheus

Entenda como configurar a integrao entre o by You e o ERP Protheus

Janeiro/2013 v1.0

Manuais by You

Integrao Protheus

Este manual tem o objetivo de explicar como utilizar os aplicativos Protheus na rede corporativa do by You. Para que a funcionalidade seja habilitada, necessrio realizar o procedimento abaixo: Configurar no Protheus os dados da Integrao Cadastrar o servidor do Protheus no by You Cadastrar o ambiente do Protheus no by You Aps realizar as configuraes acima, os usurios do by You podero adicionar os aplicativos do Protheus sua rea de aplicativos.

Pr-requisitos
Ser administrador do tenante no by You Ser administrador do Protheus Ter conhecimentos do funcionamento de WebServices dentro do Protheus Ter um certificado SSL que ser utilizado no Protheus Utilizar a verso 11 do Protheus Aplicar o pacote de LIB contendo os fontes: APLIB260.PRW com data igual ou superior a 08/03/2013 e FWGETWIDGET.PRW com data igual ou superior a 26/02/2013; Verso do SmartClient HTML: 2.0.12 (para build 7.00.120420A) e 2.1.2 (para build 7.00.121227P)

Manuais by You

Integrao Protheus

Configure no Protheus os dados da integrao

Para configurar o Protheus, siga os passos abaixo: 1) Configurao de HTTPS e WebService
1.1) Acesse o Programa Inicial ApWebWizard: 1.2) Acesse as configuraes HTTPS atravs do menu Servidor Internet (HTTP/FTP) !!HTTPS; 1.2.1) Habilite o protocolo HTTPS, preencher o PATH de arquivos com uma pasta vlida e uma porta desejada para o servio:

Manuais by You

Integrao Protheus

1.3) Acesse as configuraes SSL atravs do menu Conexo (Server/ Remote) !!SSLCONFIGURE 1.3.1) Coloque o caminho completo de onde esto os arquivos do certificado SSL e a senha do certificado:

1.4) Adicione WebService atravs do menu Mdulos Web: 1.4.1) Habilite o servio de webservices no Protheus, se no estiver habilitado. Para mais informaes sobre esse ponto, consulte o manual do Protheus. 1.4.2) Selecione o mdulo WS, coloque o nome da instancia que deseja, e selecione o Enviromment:

Manuais by You

Integrao Protheus

1.4.3) Coloque o caminho completo de onde esto os arquivos do certificado SSL e a senha do certificado:
Autenticao -> IP:Porta(HTTPS)/(ambiente)/oauth/1 e relacionar a uma empresa (qualquer empresa, no influencia na integrao com o by You):

1.4.4) Defina a expectativa de usurios e finalize o cadastro:

Manuais by You

Integrao Protheus

2) Cadastro do aplicativo no Protheus

2.1) Acesse o Configurador do Protheus (SIGACFG ) 2.2) Acesse o menu: Usurio ! Senhas ! Poltica 2.3) Acesse a aba Client ByYou 2.3.1) Preencha os campos: Endereo IP e Porta do servio HTTPS (Configurado no passo anterior), IP e porta do SmartClient HTML. 2.3.2) Clique no boto Gerar Chaves, e pressione o boto Sim para confirmar a gerao. 2.3.3) Clique no boto Confirmar para salvar os dados, ser apresentada uma tela perguntando se deseja enviar as informaes do cadastro por e-mail. Estas informaes so utilizadas para o cadastro do Protheus no by You.

Manuais by You

Integrao Protheus

Cadastre o servidor do Protheus no by You

1) Acesse o painel administrativo, e escolha a opo do menu Aplicativo Cadastrar servidores ERP

Manuais by You

Integrao Protheus

2) Clique no boto Criar servidor e insira as informaes do servidor Protheus

Cdigo: Identifica o servidor (informao definida pelo usurio) Descrio: Descrio do servidor (informao definida pelo usurio) IP: Obter essa informao no Protheus Porta: Obter essa informao no Protheus Ambiente: Obter essa informao no Protheus Obs: Os dados do Protheus so obtidos no passo 2.3.3 da Configurao do Protheus

Manuais by You

Integrao Protheus

Cadastre o ambiente do Protheus no by You

1) Acesse o painel administrativo, e escolha a opo do menu Aplicativo Cadastrar ambiente ERP e escolha o servidor que deseja associar o ambiente

Manuais by You

Integrao Protheus

2) Clique no boto Criar ambiente e insira as informaes do ambiente Protheus e do SmartClient

!
Cdigo: Identifica o ambiente (informao definida pelo usurio) Descrio: Descrio do ambiente (informao definida pelo usurio) Chave Pblica: Obter essa informao no Protheus Chave Privada: Obter essa informao no Protheus Comunicao: Definio do protocolo de comunicao com o SmartClient. O Valor padro TCP. Ambiente: Obter essa informao no Protheus Idioma: Configurao do idioma URL SmartClient HTML: IP e porta de acesso ao SmartClient WebServices comunicao produto: WebServices que realizar a comunicao entre o by You e Protheus. Essa informao se encontra na Lista de Servios Ativos (wsindex.apw) do Protheus. Procurar pelo nome de servio FWWSPROTHEUSWIDGET e copiar o valor do campo URL da Descrio do Servio (WSDL) Obs: Os dados do Protheus so obtidos no passo 2.3.3 da Configurao do Protheus

Manuais by You

Integrao Protheus

Anexo 1

Incluir aplicativo do usurio

Finalizada a configurao do servidor e do ambiente, o usurio poder adicionar os aplicativos do Protheus em sua rea de Aplicativos, seguindo os passos abaixo: 1) No perfil corporativo, acesse a opo de menu Aplicativos.

Manuais by You

Integrao Protheus

2) Ao abrir a pgina de aplicativos, clique no boto Incluir aplicativo e selecione o servidor e o ambiente. Feito isso, clique no boto Buscar Aplicativos.

Manuais by You

Integrao Protheus

3) No primeiro acesso ir abrir a tela de login do Protheus.

Obs.: Verificar o bloqueador de Popups, pois neste momento uma nova janela ir abrir no navegador.

Manuais by You

Integrao Protheus

4) Aps realizar o login, o menu carregado na tela. Navegue nas categorias at selecionar o aplicativo.

Manuais by You

Integrao Protheus

5) Ao selecionar o aplicativo aparecer uma janela com algumas informaes sobre o aplicativo que podem ser alteradas.

Manuais by You

Integrao Protheus

6) O aplicativo ser adicionado na rea de Aplicativos do usurio e ao selecion-lo uma nova tela ser aberta com o Aplicativo Protheus.

Manuais by You

Integrao Protheus

7) Para alterar ou remover o aplicativo clique nos botes que aparecem direita do aplicativo quando selecionado.

Manuais by You

Integrao Protheus

Anexo 2

Remoo de servidor ERP no by You

Caso seja necessrio remover o servidor, clique no X ao lado do cdigo do servidor na listagem dos servidores cadastrados. Ir aparecer uma caixa de dilogo com a opo para remover todos os ambientes e aplicativos associados a este servidor. Caso seja esta a inteno, selecione o checkbox e todas as informaes associadas tambm sero removidas.

Manuais by You

Integrao Protheus

Anexo 3

Remoo de ambiente ERP no by You

Caso seja necessrio remover o ambiente, clique no X ao lado do cdigo do ambiente na listagem dos ambientes cadastrados. Ir aparecer uma caixa de dilogo com a opo para remover todos os aplicativos associados ao ambiente. Caso seja esta a inteno, selecionar o checkbox e todas as informaes associadas tambm sero removidas.

Manuais by You

Integrao Protheus

Por dentro do by You

Acesse a comunidade Por dentro do by You, no ambiente pessoal do by You, para saber de todos os detalhes de releases, melhorias e novidades da rede.

by You nas redes sociais

Siga o by You nas redes sociais e fique por dentro das novidades: Youtube: www.youtube.com/byYouSocial Facebook: www.facebook.com/byYouSocial Twitter: www.twitter.com/byYouSocial LinkedIn: www.linkedin.com/company/by-you

Fale conosco
Interessado no by You? Fale com a nossa equipe:

0800 882 9191

social.byyou.com!

At mais!