Post on 22-Oct-2015
Manuais by You
Entenda como con!gurar a integração entre o by You e o ERP Protheus
Janeiro/2013 – v1.0
Integração 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, é necessário realizar o procedimento abaixo:
• Con!gurar no Protheus os dados da Integração• Cadastrar o servidor do Protheus no by You• Cadastrar o ambiente do Protheus no by You
Após realizar as con!gurações acima, os usuários do by You poderão adicionar os aplicativos do Protheus à sua área de aplicativos.
Manuais by You Integração Protheus
Pré-requisitos
• Ser administrador do tenante no by You• Ser administrador do Protheus• Ter conhecimentos do funcionamento de WebServices dentro do Protheus• Ter um certi!cado SSL que será utilizado no Protheus• Utilizar a versão 11 do Protheus• Aplicar o pacote de LIB contendo os fontes: APLIB260.PRW com data igualou superior a 08/03/2013 e FWGETWIDGET.PRW com data igual ou superior a 26/02/2013; • Versão do SmartClient HTML:2.0.12 (para build 7.00.120420A) e 2.1.2 (para build 7.00.121227P)
Configure no Protheus os dados da integração
Para con!gurar o Protheus, siga os passos abaixo:
1) Con!guração de HTTPS e WebService1.1) Acesse o Programa Inicial “ApWebWizard”: 1.2) Acesse as con!gurações HTTPS através do menu “Servidor Internet (HTTP/FTP)” à “HTTPS”;
1.2.1) Habilite o protocolo HTTPS, preencher o PATH de arquivos com uma pasta válida e uma porta desejada para o serviço:
Manuais by You Integração Protheus
!
1.3) Acesse as con!gurações SSL através do menu “Conexão (Server/Remote)” à “SSLCONFIGURE”
1.3.1) Coloque o caminho completo de onde estão os arquivos do certi!cado SSL e a senha do certi!cado:
Manuais by You Integração Protheus
1.4) Adicione WebService através do menu Módulos Web: 1.4.1) Habilite o serviço de webservices no Protheus, se não estiver habilitado. Para mais informações sobre esse ponto, consulte o manual do Protheus. 1.4.2) Selecione o módulo “WS”, coloque o nome da instancia que deseja, e selecione o “Enviromment”:
1.4.3) Coloque o caminho completo de onde estão os arquivos do certi!cado SSL e a senha do certi!cado:
Autenticação -> IP:Porta(HTTPS)/(ambiente)/oauth/1 e relacionar a uma empresa (qualquer empresa, não in#uencia na integração com o by You):
Manuais by You Integração Protheus
!
1.4.4) De!na a expectativa de usuários e !nalize o cadastro:
2) Cadastro do aplicativo no Protheus2.1) Acesse o Con!gurador do Protheus (SIGACFG ) 2.2) Acesse o menu: Usuário à Senhas à Política 2.3) Acesse a aba “Client ByYou”
2.3.1) Preencha os campos: Endereço IP e Porta do serviço HTTPS (Con!gurado no passo anterior), IP e porta do SmartClient HTML. 2.3.2) Clique no botão Gerar Chaves, e pressione o botão “Sim” para con!rmar a geração. 2.3.3) Clique no botão Con!rmar para salvar os dados, será apresentada uma tela perguntando se deseja enviar as informações do cadastro por e-mail. Estas informações são utilizadas para o cadastro do Protheus no by You.
Manuais by You Integração Protheus
!
Cadastre o servidor do Protheus no by You
1) Acesse o painel administrativo, e escolha a opção do menuAplicativo → Cadastrar servidores ERP
Manuais by You Integração Protheus
!
2) Clique no botão Criar servidor e insira as informações do servidorProtheus
Manuais by You Integração Protheus
Código: Identi!ca o servidor (informação de!nida pelo usuário) Descrição: Descrição do servidor (informação de!nida pelo usuário) IP: Obter essa informação no Protheus Porta: Obter essa informação no Protheus Ambiente: Obter essa informação no Protheus Obs: Os dados do Protheus são obtidos no passo 2.3.3 da Con!guração do Protheus
!
Cadastre o ambiente do Protheus no by You
1) Acesse o painel administrativo, e escolha a opção do menuAplicativo → Cadastrar ambiente ERP e escolha o servidor que deseja associar o ambiente
Manuais by You Integração Protheus
!
2) Clique no botão Criar ambiente e insira as informações do ambienteProtheus e do SmartClient
Manuais by You Integração Protheus
!
Código: Identi!ca o ambiente (informação de!nida pelo usuário) Descrição: Descrição do ambiente (informação de!nida pelo usuário) Chave Pública: Obter essa informação no Protheus Chave Privada: Obter essa informação no Protheus Comunicação: De!nição do protocolo de comunicação com o SmartClient. O Valor padrão é “TCP”. Ambiente: Obter essa informação no Protheus Idioma: Con!guração do idioma URL SmartClient HTML: IP e porta de acesso ao SmartClient WebServices comunicação produto: WebServices que realizará a comunicação entre o by You e Protheus. Essa informação se encontra na Lista de Serviços Ativos (wsindex.apw) do Protheus. Procurar pelo nome de serviço “FWWSPROTHEUSWIDGET” e copiar o valor do campo “URL da Descrição do Serviço (WSDL)” Obs: Os dados do Protheus são obtidos no passo 2.3.3 da Con!guração do Protheus
Incluir aplicativo do usuário
Finalizada a con!guração do servidor e do ambiente, o usuário poderá adicionar os aplicativos do Protheus em sua área de Aplicativos, seguindo os passos abaixo:
Manuais by You Integração Protheus
1) No per!l corporativo, acesse a opção de menu Aplicativos.
!
Anexo 1
Manuais by You Integração Protheus
2) Ao abrir a página de aplicativos, clique no botão Incluir aplicativo eselecione o servidor e o ambiente. Feito isso, clique no botão Buscar Aplicativos.
!
Manuais by You Integração Protheus
3) No primeiro acesso irá abrir a tela de login do Protheus.
!
Obs.: Veri!car o bloqueador de Popups, pois neste momento uma nova janela irá abrir no navegador.
Manuais by You Integração Protheus
4) Após realizar o login, o menu é carregado na tela. Navegue nascategorias até selecionar o aplicativo.
!
Manuais by You Integração Protheus
5) Ao selecionar o aplicativo aparecerá uma janela com algumasinformações sobre o aplicativo que podem ser alteradas.
!
Manuais by You Integração Protheus
6) O aplicativo será adicionado na área de Aplicativos do usuário e aoselecioná-lo uma nova tela será aberta com o Aplicativo Protheus.
!
Manuais by You Integração Protheus
7) Para alterar ou remover o aplicativo clique nos botões que aparecemà direita do aplicativo quando selecionado.
!
Remoção de servidor ERP no by You
Caso seja necessário remover o servidor, clique no “X” ao lado do código do servidor na listagem dos servidores cadastrados.
Irá aparecer uma caixa de diálogo com a opção para remover todos os ambientes e aplicativos associados a este servidor. Caso seja esta a intenção, selecione o checkbox e todas as informações associadas também serão removidas.
Manuais by You Integração Protheus
!
Anexo 2
Remoção de ambiente ERP no by You
Caso seja necessário remover o ambiente, clique no “X” ao lado do código do ambiente na listagem dos ambientes cadastrados.
Irá aparecer uma caixa de diálogo com a opção para remover todos os aplicativos associados ao ambiente. Caso seja esta a intenção, selecionar o checkbox e todas as informações associadas também serão removidas.
Manuais by You Integração Protheus
!
Anexo 3
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
Fale conosco
Siga o by You nas redes sociais e !que 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
Interessado no by You? Fale com a nossa equipe:
0800 882 9191 social.byyou.com
Até mais!
Manuais by You Integração Protheus