Conectar aplicaciones ODBC en Windows a SugarCRM

El controlador ODBC de SugarCRM le permite trabajar con datos de SugarCRM fuera de la interfaz web de SugarCRM. El controlador le permite utilizar los datos de SugarCRM en cualquier aplicación compatible con ODBC. Por ejemplo:

• Acceso
• Excel
• Servidor SQL
• Oráculo
• Perl

Puede consultar SugarCRM así como agregar y actualizar registros de SugarCRM.

Instalación del controlador ODBC de SugarCRM

1. Instale y licencie el controlador ODBC de SugarCRM en la máquina donde está instalada su aplicación cliente.

   Por ejemplo, si desea trabajar con datos de SugarCRM en Excel, instale el controlador ODBC de SugarCRM en la máquina donde está instalado Excel.

   Para hacer esto, ejecute la distribución de archivos que obtuvo en el paso anterior y siga las instrucciones en pantalla.

   El programa de instalación inicia el Administrador de licencias de Easysoft, ya que no puede usar el controlador ODBC de SugarCRM hasta que obtenga una licencia.

   Están disponibles los siguientes tipos de licencia:

   • Licencia de prueba gratuita por tiempo limitado que le permite utilizar el producto de forma gratuita y sin restricciones durante un período limitado (normalmente 14 días).
   • Licencia completa si ha comprado el producto. Al comprar el producto, se le proporciona un código de autorización, que utiliza para obtener una licencia
2. En Easysoft License Manager, ingrese sus datos.

   DEBE ingresar los campos Nombre, Dirección de correo electrónico y Compañía.

   La dirección de correo electrónico DEBE ser la misma que la utilizada para registrarse y descargar desde el sitio web de Easysoft o no podrá obtener licencias de prueba.

3. Seleccione Solicitar licencia.

   Se le solicita un tipo de licencia.

4. Haga uno de lo siguiente:
   • Para obtener una licencia de prueba, haga clic en Prueba por tiempo limitado y luego haga clic en Siguiente.

     El administrador de licencias le pregunta qué software está licenciando. Seleccione Easysoft SugarCRM ODBC Driver de la lista desplegable y luego haga clic en Siguiente.

   • Si obtuvo un código de autorización para una licencia comprada, seleccione Licencia sin vencimiento y luego haga clic en Siguiente.

     El administrador de licencias solicita su código de autorización.

     Ingrese el código de autorización y luego haga clic en Siguiente.

5. El Administrador de licencias muestra un resumen de la información que ingresó y le permite elegir el método para solicitar su licencia.
6. Haga uno de lo siguiente:
   • Elija Solicitud en línea si su máquina está conectada a Internet y puede realizar conexiones salientes al puerto 8884.

     Luego, el Administrador de licencias envía una solicitud al servidor de licencias de Easysoft para activar su clave de licencia automáticamente. Este es el método más rápido y da como resultado que sus datos se ingresen inmediatamente en nuestra base de datos de soporte.

   • Las tres opciones restantes (Solicitud de correo electrónico, Solicitud de impresión y Solicitud de visualización) son todas formas de obtener una licencia si su máquina está fuera de línea (es decir, no tiene conexión a Internet).

     Cada uno de estos métodos implica proporcionar a Easysoft información, incluido el número de su máquina (un número único para su máquina) y luego esperar a recibir su clave de licencia.

     En lugar de enviar sus datos por correo electrónico a Easysoft, puede ingresarlos directamente en el sitio web de Easysoft y su clave de licencia se le enviará automáticamente por correo electrónico.

     Para usar este método, haga clic en Ver solicitud y luego visite:

     • Página de licencia de prueba
     • Página de licencia completa

     En la página Licencias, ingrese el número de su máquina (y el código de autorización para la licencia comprada), haga clic en Enviar y se le enviará su clave de licencia por correo electrónico.

     Cuando reciba la clave de licencia, puede activarla haciendo doble clic en el archivo adjunto del correo electrónico o haciendo clic en Introducir licencia en la pantalla principal del Administrador de licencias y pegando la clave de licencia en el cuadro de diálogo.

   • Elija Finalizar para salir del Administrador de licencias.

     La instalación está completa.

Configuración de una fuente de datos ODBC

Antes de que pueda usar el controlador ODBC de SugarCRM para conectar su aplicación a SugarCRM, debe configurar una fuente de datos ODBC. Una fuente de datos ODBC almacena los detalles de conexión para la base de datos de destino (p. ej., SugarCRM) y el controlador ODBC necesario para conectarse (p. ej., el controlador ODBC de SugarCRM).

Las fuentes de datos ODBC se configuran en el Administrador ODBC, que se incluye con Windows. La forma en que ejecuta el Administrador de ODBC depende de si su aplicación es de 32 bits o de 64 bits:

• Mi aplicación es de 32 bits

  En el cuadro de diálogo Ejecutar de Windows, escriba:

  %windir%\syswow64\odbcad32.exe

• Mi aplicación es de 64 bits

  Abra Sistema y seguridad> Herramientas administrativas en el Panel de control y luego abra Orígenes de datos ODBC (64 bits). (En Windows Server 2003 y versiones anteriores, el subprograma del Panel de control que inicia el Administrador de ODBC tiene la etiqueta Orígenes de datos).

¿Cómo sé si mi aplicación es de 32 bits o de 64 bits?

select SERVERPROPERTY('edition')

En el Administrador ODBC:

1. Elija la pestaña DSN del sistema y luego elija Agregar.
2. En el cuadro de diálogo Crear nueva fuente de datos, seleccione Easysoft ODBC-SugarCRM Driver y luego seleccione Finalizar.
3. Complete estos campos en el cuadro de diálogo Easysoft ODBC-SugarCRM Driver DSN Setup:

   Configuración	Valor
   DNS	SugarCRM
   Nombre de usuario	El nombre de su usuario de SugarCRM. Por ejemplo, administrador.
   Contraseña	La contraseña de su usuario de SugarCRM.
   URI de inicio de sesión	El URI de la instancia de SugarCRM a la que desea conectarse. Por ejemplo: https://sg-richarddemo.demo.sugarcrm.eu/ El controlador ODBC-SugarCRM de Easysoft puede conectarse a una instancia de SugarCRM a través de https y http

4. En su aplicación, conéctese a su fuente de datos recién configurada y ejecute una consulta de muestra. Por ejemplo:

   select top 10 * from Accounts

Conéctese a SugarCRM desde Perl

Strawberry Perl es una distribución de Perl para Windows que incluye las capas de middleware necesarias (Perl DBI y Perl DBD::ODBC) para permitir que el controlador ODBC de SugarCRM conecte sus aplicaciones Perl a SugarCRM.

1. En su máquina Strawberry Perl, cree un nuevo script Perl con el siguiente contenido:

   #!/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. Ejecute el script Perl, que luego recuperará los registros de la tabla Productos.

Conectar Microsoft Access a SugarCRM

Microsoft Access utiliza un controlador ODBC para interactuar con una fuente de datos externa. ODBC es una tecnología de acceso a datos, cuya implementación de Microsoft se incluye con Windows. Puede usar el controlador ODBC de SugarCRM para conectar Microsoft Access a una instancia de SugarCRM, lo que le permite consultar y actualizar los datos de SugarCRM desde un front-end de Microsoft Access.

1. Abra su base de datos de Microsoft Access.
2. Haga uno de lo siguiente:
   • Para Microsoft Access 2003 y versiones anteriores, en el menú Archivo, seleccione Obtener datos externos> Vincular tablas.

     Se muestra el cuadro de diálogo Enlace.

   • Para Microsoft Access 2007, en la pestaña Datos externos, elija Más> Base de datos ODBC.

     Se inicia el asistente Obtener datos externos.

   • Para Microsoft Access 2010 y versiones posteriores, en la pestaña Datos externos, elija Base de datos ODBC.

     Se inicia el asistente Obtener datos externos.

3. Haga uno de lo siguiente:
   • Para Microsoft Access 2003 y versiones anteriores, elija Bases de datos ODBC de la lista Archivos de tipo.
   • Para Microsoft Access 2007 y versiones posteriores, elija Vincular a la fuente de datos mediante la creación de una tabla vinculada y, a continuación, seleccione Aceptar.

   Se muestra el cuadro de diálogo Seleccionar fuente de datos.

4. Elija su fuente de datos ODBC de SugarCRM de la lista Fuente de datos de la máquina y luego elija Aceptar.

   Se muestra el cuadro de diálogo Vincular tablas.

5. Elija la tabla que desea vincular y luego seleccione Aceptar.
6. Elija la tabla vinculada en Microsoft Access y luego elija VOLVER para trabajar con los datos vinculados.

Conectando Excel a SugarCRM

Siga estos pasos para devolver datos de SugarCRM a Microsoft Excel mediante Microsoft Query:

1. Haga uno de lo siguiente:
   • Para Excel 2007 y versiones posteriores, en la pestaña Datos, seleccione Obtener datos externos. En el grupo De otras fuentes, elija De Microsoft Query.
   • Para Excel 2003 y versiones anteriores, en el menú Datos, elija Importar datos externos y luego elija Nueva consulta de base de datos.

   El comando Nueva consulta de base de datos utiliza Microsoft Query para importar datos. Microsoft Query es una función opcional que, de forma predeterminada, no está instalada. Si no tiene Microsoft Query instalado, al elegir New Database Query se le pedirá que lo instale. Para ello, en el Panel de control, seleccione Programas y características (o Agregar o quitar programas). Elija Microsoft Office (si instaló Excel como parte de Office) o Microsoft Excel y luego elija Cambiar. Siga las instrucciones en pantalla. Seleccione Elegir personalización avanzada de aplicaciones durante el asistente de configuración si esta opción está presente para su versión de Office/Excel. Microsoft Query se encuentra en Herramientas de Office.

   Cuando haya instalado Microsoft Query, repita el paso 1.

2. En el cuadro de diálogo Elegir fuente de datos, elija la fuente de datos del controlador ODBC de SugarCRM de la lista y luego elija Aceptar.
3. En el Asistente de consultas, elija las columnas que contienen los datos que desea recuperar y luego haga clic en Siguiente.
4. Si desea devolver un subconjunto de los datos, use la pantalla Filtrar datos para filtrar los resultados de su consulta (esto es el equivalente a un SQL WHERE cláusula) y luego haga clic en Siguiente.
5. Si desea cambiar el orden de clasificación de sus datos, use la pantalla Orden de clasificación para ordenar los resultados de su consulta (esto es el equivalente a un ORDER BY de SQL cláusula) y luego haga clic en Siguiente.
6. En el menú Archivo, seleccione Devolver datos a Excel.
7. Elija una ubicación para los datos en su hoja de cálculo cuando se le solicite.

   Nota Si parece que no sucede nada en esta etapa final, la tabla de destino tiene más columnas de las que se pueden recuperar en una sesión de Microsoft Query. Microsoft Query se ejecutará en segundo plano. Cambie a Consulta y reduzca el número de columnas para recuperar. Repita los pasos anteriores para recuperar las columnas adicionales. (En otras palabras, es posible que deba dividir la tabla en varias sesiones de Query para recuperar todos los datos que contiene).

Conéctese a SugarCRM desde Oracle

1. Cree un archivo de inicio DG4ODBC en su máquina Oracle. Para hacer esto, cambie a %ORACLE_HOME%\hs\admin directorio. Crea una copia del archivo initdg4odbc.ora . Nombre el nuevo archivo initsugar.ora .

   Nota En estas instrucciones, reemplace %ORACLE_HOME% con la ubicación de su directorio Oracle HOME. Por ejemplo, C:\oraclexe\app\oracle\product\11.2.0\server .

2. Asegúrese de que estos parámetros y valores estén presentes en su archivo de inicio:

   HS_FDS_CONNECT_INFO = my_sugarcrm_odbc_dsn
   

   Reemplace my_sugarcrm_odbc_dsn con el nombre de un origen de datos del controlador ODBC de SugarCRM que se conecta a la instancia de SugarCRM de destino. Por ejemplo

   HS_FDS_CONNECT_INFO = "SugarCRMSystemDSN"
   

3. Comente la línea que habilita el seguimiento de DG4ODBC. Por ejemplo:

   #HS_FDS_TRACE_LEVEL = <trace_level>
   

4. Agregue una entrada a %ORACLE_HOME%\network\admin\listener.ora que crea un SID_NAME para DG4ODBC. Por ejemplo:

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

5. Agregue una entrada DG4ODBC a %ORACLE_HOME%\network\admin\tnsnames.ora que especifica el SID_NAME creado en el paso anterior. Por ejemplo:

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

   Reemplazar oracle_host con el nombre de host de su máquina Oracle.

6. Inicie (o reinicie) Oracle Listener:

   cd %ORACLE_HOME%\bin
   lsnrctl stop
   lsnrctl start
   

7. Conéctese a su base de datos Oracle en SQL*Plus.
8. En SQL*Plus, cree un enlace de base de datos para la instancia de SugarCRM de destino. Por ejemplo:

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

9. Intente consultar sus datos de SugarCRM. Por ejemplo:

   SELECT * FROM "Categories"@SUGARLINK;
   

Notas

• Si tiene problemas para conectarse a SugarCRM desde Oracle, habilite el rastreo DG4ODBC y verifique los archivos de rastreo escritos en %ORACLE_HOME%\hs\trace directorio. Para habilitar el rastreo DG4ODBC, agregue la línea HS_FDS_TRACE_LEVEL = DEBUG a initsugar.ora y luego inicie/reinicie Oracle listener. Si el trace directorio no existe, créelo.
• Si habilita el seguimiento del Administrador de controladores ODBC, pero no obtiene un archivo de seguimiento o obtiene un archivo de seguimiento vacío, cambie la ubicación del archivo de seguimiento al directorio TEMP de Windows. Por ejemplo, C:\Windows\Temp\SQL.log .