De Dealernet Wiki | Portal de Soluo, Notas Tcnicas, Verses e Treinamentos da Ao Informtica
Tabela de conteúdo |
Introdução
O IntAgendaFord é um serviço Windows que visa integrar os processos de agendamentos realizados no site da Ford (AgendaFORD), interagindo automaticamente com o WebService da Ford.
O serviço tem duas funções principais:
-
Obter agendamentos cadastrados no AgendaFORD e exportar as ordens de serviços faturados destes agendamentos baixados. Na primeira rotina, o serviço busca as informações dos agendamentos cadastrados no site a cada cinco minutos, e cadastra no sistema Dealer, sendo consultado no módulo Oficina, menu Serviços\Agendamento.
-
Consultar ordens de serviços faturadas ligadas a um agendamento e envia as informações de serviços e peças para o site da Ford, adicionando essas informações ao agendamento já existente no site. O agendamento não é fechado neste momento, pois a conclusão do agendamento é processada no fim do dia pelos servidores da Ford. No outro dia, os agendamentos com informações de ordens de serviços aparecem com status "Concluído" no site.
Pré-Requisitos para instalação:
1. Obter 2 (dois) certificados para serem utilizados pelo serviço, um da concessionária e outro da Ford Company. Caso não possua certificado validado junto à Ford, realizar requisição de certificado no servidor onde será instalado a integração e encaminhar a requisição para à Ford;
2. Internet liberada no servidor onde será instalado o IntAgendaFord.
3. É necessário ter instalado o IIS 6.0 ou superior na máquina.
4. É necessário ter instalado o Framework.net 4.0 ou superior na máquina.
5. Sistema Operacional: Windows Server (não pode ser utilizado com Linux), se instalado no servidor, se em outras máquinas o sistema operacional deve ser compatível com o Windows XP, Vista e Windows 7.
A instalação do IntAgendaFord pode ser realizada em qualquer horário da concessionária.
Certificado
Como Solicitar Certificado
Para solicitar um certificado para a Ford, siga os procedimentos abaixo de instalação do serviço IntAgendaFord.
1. Acesse o Gerenciador dos Serviços de Informações da Internet (IIS), em Iniciar\Painel de Controle\Ferramentas Administrativas (no Windows 7). Na janela, clique no ícone Certificados de Servidor;
2. Na janela de certificados de Servidor, clique na opção Cria Solicitação de Certificado..., que encontra-se na parte superior direita da janela;
3. Com a janela de solicitação de certificado aberta, preencha os campos seguindo as seguintes regras:
- Nome comum: SZBRA0XXXX.b2d.ford.com, onde XXXX é o código da concessionária na FORD. O sufixo "b2d.ford.com" deve ser em letras minúsculas.
- Organização: informar o nome da concessionária sem caracteres especiais.
- Unidade organizacional: preencher com "Dealer".
- Cidade/localidade: preencher com "BR".
- Estado/província: preencher com "BR".
- País/região: preencher com "BR".
4. Ao final, clique no botão Avançar;
5. Na próxima janela, mude o tamanho do bit de 1024 para 2048, e clique em Avançar;
6. Na última janela, clique no botão 
para escolher o nome do arquivo e o diretório onde será salvo. Esse nome é apenas do arquivo de solicitação, não é o definitivo. Depois, clique em Concluir.
O arquivo gerado deve ser enviado à FORD como solicitação de certificado digital informando o código da concessionária na FORD. Esse envio pode ser feito para o e-mail de Silvio Roseval (smelo5@ford.com). Algum tempo depois ele enviará um arquivo final com o certificado feito a partir da solicitação enviada, para concluir a instalação do certificado na máquina onde estará o serviço.
Como Concluir Instalação do Certificado
1. Acesse o Gerenciador dos Serviços de Informações da Internet (IIS), em Iniciar\Painel de Controle\Ferramentas Administrativas (no Windows 7). Na janela, clique no ícone Certificados de Servidor e depois clique no link Concluir Solicitação de Certificado... no canto superior direito na janela;
2. Dentro da janela, clique no botão para selecionar o arquivo de resposta da FORD e depois, no campo Nome amigável, coloque o nome da concessionária ou grupo;
3. Se a conclusão deu certo, o nome do certificado aparecerá na lista de certificados de servidor do IIS. Pode aparecer uma janela de erro depois da conclusão do certificado e ele não aparecer na lista, mas é possível que seja um erro do próprio IIS. Certifique-se se deu certo ou não fechando o IIS e abrindo-o novamente. Se ele não estiver na lista, tente fazer uma nova solicitação de certificado e envie para a FORD, informando que a solicitação anterior apresentou erro ao concluir, ou entre em contato com a DealerNet. Caso o certificado tenha aparecido na lista, é só prosseguir para o próximo passo;
4. Por fim, é necessário gerar um certificado com outra extensão (.PFX) para posterior importação em seus certificados confiáveis. Para isso, basta clicar com o botão direito em cima do certificado importado, que aparece na lista de certificados do servidor no IIS, e escolher a opção Exportar.... Escolha o local onde será salvo o arquivo exportado e o nome do arquivo no botão "..." do campo Exportar para:, depois coloque uma senha, que será utilizada na importação do certificado gerado, e confirme-a;
Como Importar Certificados
Para concluir as configurações relacionadas a certificados, é necessário importar tanto o certificado público da FORD quanto o certificado privado da concessionária, que foi gerado seguindo os passos anteriores. O certificado público da FORD pode ser solicitado a qualquer momento e geralmente o arquivo é o xgtw.ford.com.p7b. Com os dois certificados em mãos, siga o procedimento para importação no servidor.
1. Acesse o console de certificados em Iniciar\Executar, digite mmc e clique Enter. Na janela do console, vá ao menu Arquivo\Adicionar/remover snap-in...;
2. Ao clicar na opção, uma janela será aberta. Na lista de Snap-ins disponíveis, selecione a opção Certificados e clique no botão Adicionar;
3. Na janela seguinte, escolha a opção Conta de computador, clique em Avançar;
4. Marque a opção Permitir que o computador selecionado seja alterado ao ser iniciado da linha de comando. Isso só se aplica se você salvar o console e clique em Concluir. De volta na tela de seleção de snap-in, clique em OK;
5. A tela de console possui agora a opção Certificados (computador local) em uma lista em árvore na parte esquerda da janela. Primeiro, adicionamos o certificado público da FORD. Para isso, expanda a opção Certificados, clique com o botão direito na pasta Outras Pessoas e vá na opção todas as tarefas\Importar...;
6. Será aberto o assistente de importação de certificado. Na tela inicial, clique em Avançar. Na próxima janela, selecione o arquivo relativo ao certificado da FORD;
7. Deixe a opção Colocar todos os certificados no repositório a seguir selecionada e clique em Avançar;
8. E em seguida clique em Concluir;
9. Há dois certificados extras que são importados juntamente com o certificado da FORD. Eles devem ser transferidos para a pasta Autoridades de Certificação Raiz Confiáveis. Caso ele exiba uma mensagem informando que esses certificados já existem na pasta, peça para substituir os existentes;
10. Agora falta instalar o certificado privado da concessionária. O processo é bem parecido, porém é realizado na pasta Pessoal. Clique com o botão direito na pasta Pessoal e vá à opção Todas as tarefas\Importar.... Isso abrirá a janela de assistente de importação de certificado. Clique em Avançar e na próxima janela selecione o arquivo referente ao certificado .PFX gerado pelo IIS. Lembre-se de mudar a extensão da pesquisa. Depois disso, uma janela solicitando uma senha aparecerá. Essa senha é a mesma informada no momento da geração do certificado .PFX pelo IIS. Deixe apenas a opção Incluir todas as propriedades estendidas marcada e clique em Avançar;
11. Na janela seguinte, deixe a opção Colocar todos os certificados nos repositórios a seguir selecionada e clique em Avançar e em seguida, clique em Concluir. Depois da mensagem de importação com sucesso, feche a janela de console sem salvar. Pronto, as importações de certificados estão concluídas.
Instalando e Configurando Serviço
Como Instalar Agend@Ford
1. Clique no arquivo Dealernet_Ford_Agend@Ford3.0_V1.0 para começar a instalação;
2. Na janela de Dealernet - Ford - Agend@Ford 3.0 clique em Avançar;
3. Clique em Avançar;
4. Instalação sendo realizada;
5. Nesta janela no campo Configurações das Conexões com Banco de Dados informe: Servidor (nome do servidor do banco de dados), Banco Matriz (banco de dados da matriz, que será atualizado e irá disponibilizar as informações), Login (login do banco de dados) e Senha (senha de acesso ao banco de dados);
6. Marque a opção Instalar filiais simultaneamente;
7. Caso não seja necessário backup, desmarque a opção Verificar Backup e confirme a mensagem abaixo que aparece sinalizando;
8. Na janela de compilação dos scripts, selecione na opção Bandeiras a marca FORD. Assim, os scripts serão executados apenas no banco matriz e nos bancos FORD. Depois, clique no botão Compilar;
9. Procedures sendo executadas;
10. Caso todas as procedures sejam executadas, a mensagem abaixo aparecerá. Clique em OK.
Como Instalar IntAgendaFord
1. Clique no arquivo IntAgendaFord.Setup para começar a instalação;
2. Na janela de IntAgendaFord_V1.0 clique Avançar;
3. A janela Selecionar Pasta de Instalação traz a Pasta C:\Arquivos de programas\Ação Informática\IntAgendaFord_V1.0\. Para alterá-lo, clique Procurar e escolha o diretório;
4. Selecione Todos para que todos os usuários do computador tenham acesso ao programa ou Somente eu para ter acesso ao programa, somente o usuário que está logado. Clique Avançar;
5. Clique Avançar para confirmar o início da instalação;
6. Aguarde enquanto o produto IntAgendaFord é instalado;
7. Instalação concluída com êxito. Clique Fechar;
8. Na janela Configurações IntAgendaFord no campo Banco de dados do sistema DealerNet informe: Servidor (nome do servidor do banco de dados), Banco Matriz FORD (banco de dados da matriz, que será atualizado e irá disponibilizar as informações), Login (login do banco de dados) e Senha (senha de acesso ao banco de dados). Lembrando que o usuário do banco de dados deve possuir privilégios para gravar dados;
9. No campo Configuração de email para notificação de erro (separe com vírgula os destinatários preencha as informações para o envio de e-mail;
10. E no campo Configurações do certificado informe: DN Code Grupo (código da empresa matriz informada na solicitação do certificado), Certificado Dealer (clique no botão 
para selecionar o certificado da empresa, enviada pela FORD como resposta à solicitação de certificado) e Certificado Ford (clique no botão para selecionar o certificado público da Ford, comumente nomeado xgtw.ford.com);
11. Caso seja necessária uma carga para buscar os agendamentos não baixados, normalmente feito na primeira instalação, utilize o campo Última Execução e mude para a data desejada, e marque a opção Checar Última Execução;
12. Em seguida clique em Salvar;
13. Selecione a(s) empresa(s) e clique Salvar. Ou utilize o check box Todas Empresas para instalar os serviços para todas as empresas do grupo;
14. Instalação concluída. Clique Concluir;
15. Após instalação, vá para o diretório C:\Arquivos de Programas\Ação Informática\IntAgendaFord, copie um atalho do aplicativo IntAgendaFord.exe e cole no menu Iniciar de sua máquina.
Como Iniciar Serviço IntAgendaFord
Após instalar, é necessário iniciar o serviço no Windows, conforme procedimento abaixo:
1. Clique Meu Computador, Painel de Controle e Ferramentas Administrativas;
2. Em seguida clique em Serviços;
3. Selecione o serviço IntAgendaFord_V1.0 e clique com o botão direito em Iniciar;
4. Serviço iniciado.
Configurando Sistema DealerNet
Como Configurar Sistema DealerNet
Antes de seguir as indicações abaixo, certifique-se de que todos os scripts necessários para a instalação de serviço e da solução no sistema tenham sido executadas no banco de dados.
1. Para que os agendamentos sejam devidamente cadastrados no sistema Dealer, é necessário que o consultor esteja cadastrado em ambos os sistemas (Dealernet e AgendaFORD), sendo que no Dealernet, é preciso preencher o CPF (CPF/CNPJ) e o código do funcionário na montadora (Cód. Fun. Montadora), sendo este último o código numérico dele no AgendaFORD, com 10 dígitos, completando com 0 à esquerda. Essa alteração é realizada no cadastro de funcionários, no módulo Segurança, menu Cadastros\Usuários, utilizando o botão de Alterar.
2. O agendamento cadastrado no Dealer, advindo do site do AgendaFORD, não insere serviço. O agendamento do site não possui horas a serem trabalhadas no serviço nem o produtivo que será alocado para ela. Então se faz necessário cadastrar o serviço no agendamento, selecionando-o no módulo Oficina, menu Serviços\Agendamento. O procedimento é importante para preencher o quadro de agendamentos por produtivo.
3. O IntAgendaFORD não integra agendamentos com data menor que a data do dia. Esse tipo de validação não aparece no monitor de integrações.
4. Para que uma ordem de serviço seja exportada para o site do AgendaFORD, para conclusão do agendamento, no site do AgendaFORD, ela precisa estar vinculada a um agendamento, ter pelo menos um tipo de serviço encerrado e faturado, e ter data de liberação do veículo.
5. Para visualizar o dia-a-dia da integração do serviço com o site, existe um monitor com alguns filtros úteis para pesquisas, no módulo Integração com a Fábrica, menu Opções\Monitor Integrações.