Conecte aplicativos ODBC no Windows ao SugarCRM

• Acesso
• Excel
• SQL Server
• Oráculo
• Perl

Instalando o driver ODBC SugarCRM

1. Instale e licencie o driver ODBC SugarCRM na máquina em que seu aplicativo cliente está instalado.
   Por exemplo, se você deseja trabalhar com dados do SugarCRM no Excel, instale o driver ODBC do SugarCRM na máquina em que o Excel está instalado.
   
   Para fazer isso, execute a distribuição de arquivos que você obteve na etapa anterior e siga as instruções na tela.
   
   O programa de instalação inicia o Easysoft License Manager, porque você não pode usar o Driver ODBC SugarCRM até que uma licença seja obtida.
   
   Os seguintes tipos de licença estão disponíveis:
   
   • Licença de avaliação gratuita por tempo limitado que oferece uso gratuito e irrestrito do produto por um período limitado (geralmente 14 dias).
   • Licença completa se você comprou o produto. Ao comprar o produto, você recebe um código de autorização, que você usa para obter uma licença
2. No Easysoft License Manager, insira seus dados.
   Você DEVE inserir os campos Nome, Endereço de e-mail e Empresa.
   
   O endereço de e-mail DEVE ser o mesmo que o endereço usado para se registrar e fazer download do site da Easysoft ou você não poderá obter licenças de teste.
   
3. Escolha Solicitar Licença.
   Você é solicitado a fornecer um tipo de licença.
   
4. Faça um dos seguintes:
   • Para uma licença de avaliação, clique em Avaliação por tempo limitado e clique em Avançar.
     O License Manager pergunta qual software você está licenciando. Selecione Easysoft SugarCRM ODBC Driver na lista suspensa e clique em Avançar.
     
   • Se você obteve um código de autorização para uma licença adquirida, selecione Licença sem vencimento e clique em Avançar.
     O License Manager solicita seu código de autorização.
     
     Digite o código de autorização e clique em Avançar.
     
5. O License Manager exibe um resumo das informações inseridas e permite que você escolha o método de solicitação de sua licença.
6. Faça um dos seguintes:
   • Escolha Solicitação on-line se sua máquina estiver conectada à Internet e puder fazer conexões de saída para a porta 8884.
     O License Manager então envia uma solicitação ao servidor de licenças Easysoft para ativar sua chave de licença automaticamente. Este é o método mais rápido e faz com que seus dados sejam inseridos imediatamente em nosso banco de dados de suporte.
     
   • As três opções restantes (Solicitação de e-mail, Solicitação de impressão e Solicitação de visualização) são formas de obter uma licença se sua máquina estiver off-line (ou seja, não tiver conexão com a Internet).
     Cada um desses métodos envolve fornecer à Easysoft informações, incluindo o número de sua máquina (um número exclusivo para sua máquina) e aguardar o recebimento de sua chave de licença.
     
     Em vez de enviar seus dados por e-mail para a Easysoft, você pode inseri-los diretamente no site da Easysoft e sua chave de licença será enviada por e-mail automaticamente.
     
     Para usar esse método, clique em Exibir solicitação e visite:
     
     • Página de licença de avaliação
     • Página de licença completa
     
     Na página Licenciamento, insira o número da sua máquina (e o código de autorização para a licença adquirida), clique em Enviar e sua chave de licença será enviada por e-mail para você.
     
     Ao receber a chave de licença, você pode ativá-la clicando duas vezes no anexo de e-mail ou clicando em Enter License na tela principal do License Manager e colando a chave de licença na caixa de diálogo.
     
   • Escolha Concluir para sair do Gerenciador de licenças.
     A instalação está completa.
     

Configurando uma fonte de dados ODBC

• Meu aplicativo é de 32 bits
  Na caixa de diálogo Executar do Windows, digite:
  

  %windir%\syswow64\odbcad32.exe

  
  
• Meu aplicativo é de 64 bits
  Abra Sistema e Segurança> Ferramentas Administrativas no Painel de Controle e abra Fontes de Dados ODBC (64 bits). (No Windows Server 2003 e anterior, o miniaplicativo do Painel de Controle que inicia o Administrador ODBC é rotulado como Fontes de Dados.)
  

Como posso saber se meu aplicativo é de 32 bits ou 64 bits?

select SERVERPROPERTY('edition')

1. Escolha a guia DSN do sistema e, em seguida, escolha Adicionar.
2. Na caixa de diálogo Criar nova fonte de dados, escolha Easysoft ODBC-SugarCRM Driver e, em seguida, escolha Concluir.
3. Preencha estes campos na caixa de diálogo Easysoft ODBC-SugarCRM Driver DSN Setup:

   Setting	Valor
   DSN	SugarCRM
   Nome de usuário	O nome do seu usuário SugarCRM. Por exemplo, administrador.
   Senha	A senha do seu usuário SugarCRM.
   Logon Uri	O URI da instância do SugarCRM à qual você deseja se conectar. Por exemplo: https://sg-richarddemo.demo.sugarcrm.eu/ O driver Easysoft ODBC-SugarCRM pode se conectar a uma instância do SugarCRM por https e http

4. No seu aplicativo, conecte-se à fonte de dados recém-configurada e execute uma consulta de amostra. Por exemplo:

   select top 10 * from Accounts

Conecte-se ao SugarCRM a partir do Perl

1. Em sua máquina Strawberry Perl, crie um novo script Perl com o seguinte conteúdo:

   #!/usr/bin/perl -w
   use strict;
   use DBI;
   my $dbh = DBI-> connect('dbi:ODBC:MySugarCRMODBCDataSource');
   
   my $sql = "select * from Products";
   
   # Prepare the statement.
   my $sth = $dbh->prepare($sql)
       or die "Can't prepare statement: $DBI::errstr";
   
   # Execute the statement.
   $sth->execute();
   
   while ( my @row = $sth->fetchrow_array ) {
         #print "@row\n";
         print DBI::neat_list(\@row), "\n";
   }
   
   $dbh->disconnect if ($dbh);

2. Execute o script Perl, que recuperará os registros da tabela Produtos.

Conecte o Microsoft Access ao SugarCRM

1. Abra seu banco de dados do Microsoft Access.
2. Faça um dos seguintes:
   • Para o Microsoft Access 2003 e versões anteriores, no menu Arquivo, escolha Obter dados externos> Vincular tabelas.
     A caixa de diálogo Link é exibida.
     
   • Para o Microsoft Access 2007, na guia Dados Externos, escolha Mais> Banco de Dados ODBC.
     O assistente Obter dados externos é iniciado.
     
   • Para o Microsoft Access 2010 e posterior, na guia Dados externos, escolha Banco de dados ODBC.
     O assistente Obter dados externos é iniciado.
     
3. Faça um dos seguintes:
   • Para o Microsoft Access 2003 e versões anteriores, escolha Bancos de dados ODBC na lista Arquivos do tipo.
   • Para o Microsoft Access 2007 e posterior, escolha Vincular à fonte de dados criando uma tabela vinculada e, em seguida, escolha OK.
   
   A caixa de diálogo Selecionar fonte de dados é exibida.
   
4. Escolha sua fonte de dados ODBC do SugarCRM na lista Fonte de dados da máquina e escolha OK.
   A caixa de diálogo Vincular tabelas é exibida.
   
5. Escolha a tabela que você deseja vincular e escolha OK.
6. Escolha a tabela vinculada no Microsoft Access e, em seguida, escolha RETURN para trabalhar com os dados vinculados.

Conectando o Excel ao SugarCRM

1. Faça um dos seguintes:
   • Para Excel 2007 e posterior, na guia Dados, escolha Obter Dados Externos. No grupo De outras fontes, escolha Do Microsoft Query.
   • Para Excel 2003 e versões anteriores, no menu Dados, escolha Importar dados externos e, em seguida, escolha Nova consulta de banco de dados.
   
   O comando New Database Query usa o Microsoft Query para importar dados. O Microsoft Query é um recurso opcional, que por padrão não está instalado. Se você não tiver o Microsoft Query instalado, escolher New Database Query solicitará que você o instale. Para fazer isso, no Painel de Controle, escolha Programas e Recursos (ou Adicionar ou Remover Programas). Escolha Microsoft Office (se você instalou o Excel como parte do Office) ou Microsoft Excel e, em seguida, escolha Alterar. Siga as instruções na tela. Selecione Escolher personalização avançada de aplicativos durante o assistente de instalação se esta opção estiver presente para sua versão do Office/Excel. O Microsoft Query está localizado em Ferramentas do Office.
   
   Depois de instalar o Microsoft Query, repita a etapa 1.
   
2. Na caixa de diálogo Escolher fonte de dados, escolha a fonte de dados do driver ODBC do SugarCRM na lista e escolha OK.
3. No Assistente de consulta, escolha as colunas que contêm os dados que você deseja recuperar e clique em Avançar.
4. Se você quiser retornar um subconjunto dos dados, use a tela Filtrar dados para filtrar os resultados de sua consulta (isso é o equivalente a um SQL WHERE cláusula) e clique em Avançar.
5. Se você quiser alterar a ordem de classificação de seus dados, use a tela Ordem de classificação para classificar os resultados de sua consulta (isso é o equivalente a um ORDER BY SQL cláusula) e clique em Avançar.
6. No menu Arquivo, escolha Retornar dados para o Excel.
7. Escolha um local para os dados em sua planilha quando solicitado.
   Observação Se nada acontecer neste estágio final, a tabela de destino tem mais colunas do que podem ser recuperadas em uma sessão do Microsoft Query. O Microsoft Query será executado em segundo plano. Mude para Consulta e reduza o número de colunas a serem recuperadas. Repita as etapas acima para recuperar as colunas adicionais. (Em outras palavras, pode ser necessário dividir a tabela em várias sessões de consulta para recuperar todos os dados que ela contém.)
   

Conecte-se ao SugarCRM da Oracle

1. Crie um arquivo init DG4ODBC em sua máquina Oracle. Para fazer isso, mude para o %ORACLE_HOME%\hs\admin diretório. Crie uma cópia do arquivo initdg4odbc.ora . Nomeie o novo arquivo initsugar.ora .
   Observação Nestas instruções, substitua %ORACLE_HOME% pelo local do seu diretório Oracle HOME. Por exemplo, C:\oraclexe\app\oracle\product\11.2.0\server .
   
2. Certifique-se de que estes parâmetros e valores estejam presentes em seu arquivo init:

   HS_FDS_CONNECT_INFO = my_sugarcrm_odbc_dsn
   

   
   Substitua my_sugarcrm_odbc_dsn com o nome de uma fonte de dados do driver ODBC SugarCRM que se conecta à instância SugarCRM de destino. Por exemplo
   

   HS_FDS_CONNECT_INFO = "SugarCRMSystemDSN"
   

3. Comente a linha que permite o rastreamento DG4ODBC. Por exemplo:

   #HS_FDS_TRACE_LEVEL = <trace_level>
   

4. Adicionar uma entrada a %ORACLE_HOME%\network\admin\listener.ora que cria um SID_NAME para DG4ODBC. Por exemplo:

   SID_LIST_LISTENER =
    (SID_LIST =
      (SID_DESC=
        (SID_NAME=sugar)
        (ORACLE_HOME=%ORACLE_HOME%)
        (PROGRAM=dg4odbc)
      )
    )
   

5. Adicione uma entrada DG4ODBC a %ORACLE_HOME%\network\admin\tnsnames.ora que especifica o SID_NAME criado na etapa anterior. Por exemplo:

   SUGAR =
     (DESCRIPTION =
       (ADDRESS = (PROTOCOL = TCP)(HOST = oracle_host)(PORT = 1521))
       (CONNECT_DATA =
         (SID = sugar)
       )
       (HS = OK)
     )
   

   
   Substitua oracle_host com o nome do host de sua máquina Oracle.
   
6. Inicie (ou reinicie) o Oracle Listener:

   cd %ORACLE_HOME%\bin
   lsnrctl stop
   lsnrctl start
   

7. Conecte-se ao seu banco de dados Oracle no SQL*Plus.
8. No SQL*Plus, crie um link de banco de dados para a instância SugarCRM de destino. Por exemplo:

   CREATE PUBLIC DATABASE LINK sugarlink CONNECT TO "mysugarcrmuser" IDENTIFIED BY "mysugarcrmpassword" USING 'sugar';
   

9. Tente consultar seus dados do SugarCRM. Por exemplo:

   SELECT * FROM "Categories"@SUGARLINK;
   

Observações

• Se você tiver problemas para se conectar ao SugarCRM do Oracle, ative o rastreamento DG4ODBC e verifique os arquivos de rastreamento gravados no %ORACLE_HOME%\hs\trace diretório. Para habilitar o rastreamento DG4ODBC, adicione a linha HS_FDS_TRACE_LEVEL = DEBUG para initsugar.ora e, em seguida, inicie / reinicie o ouvinte Oracle. Se o trace diretório não existe, crie-o.
• Se você habilitar o rastreamento do ODBC Driver Manager, mas não obtiver um arquivo de rastreamento ou um arquivo de rastreamento vazio, altere o local do arquivo de rastreamento para o diretório TEMP do Windows. Por exemplo, C:\Windows\Temp\SQL.log .