Collega le applicazioni ODBC su Windows a SugarCRM

Il driver SugarCRM ODBC ti consente di lavorare con i dati SugarCRM al di fuori dell'interfaccia web di SugarCRM. Il driver consente di utilizzare i dati SugarCRM in qualsiasi applicazione che supporti ODBC. Ad esempio:

• Accesso
• Eccellere
• SQL Server
• Oracolo
• Perl

Puoi interrogare SugarCRM così come aggiungere e aggiornare i record di SugarCRM.

Installazione del driver ODBC SugarCRM

1. Installa e autorizza il driver SugarCRM ODBC sulla macchina in cui è installata l'applicazione client.

   Ad esempio, se desideri lavorare con i dati di SugarCRM in Excel, installa il driver ODBC di SugarCRM sul computer in cui è installato Excel.

   Per fare ciò, esegui la distribuzione dei file che hai ottenuto nel passaggio precedente e segui le istruzioni sullo schermo.

   Il programma di installazione avvia Easysoft License Manager, poiché non è possibile utilizzare SugarCRM ODBC Driver fino a quando non viene ottenuta una licenza.

   Sono disponibili i seguenti tipi di licenza:

   • Licenza di prova gratuita a tempo limitato che ti offre l'uso gratuito e illimitato del prodotto per un periodo limitato (di solito 14 giorni).
   • Licenza completa se hai acquistato il prodotto. All'acquisto del prodotto ti viene fornito un codice di autorizzazione, che utilizzi per ottenere una licenza
2. In Easysoft License Manager, inserisci i tuoi dati.

   DEVI inserire i campi Nome, Indirizzo E-Mail e Azienda.

   L'indirizzo e-mail DEVE essere lo stesso utilizzato per la registrazione e il download dal sito Web di Easysoft, altrimenti non sarà possibile ottenere le licenze di prova.

3. Scegli Richiedi licenza.

   Ti viene chiesto un tipo di licenza.

4. Esegui una delle seguenti operazioni:
   • Per una licenza di prova, fare clic su Prova a tempo limitato e quindi su Avanti.

     Il License Manager chiede quale software stai concedendo in licenza. Selezionare Easysoft SugarCRM ODBC Driver dall'elenco a discesa e quindi fare clic su Avanti.

   • Se hai ottenuto un codice di autorizzazione per una licenza acquistata, seleziona Licenza non in scadenza e quindi fai clic su Avanti.

     Il gestore delle licenze richiede il tuo codice di autorizzazione.

     Immettere il codice di autorizzazione e quindi fare clic su Avanti.

5. Il Gestore delle licenze mostra un riepilogo delle informazioni che hai inserito e ti consente di scegliere il metodo per richiedere la tua licenza.
6. Esegui una delle seguenti operazioni:
   • Scegli Richiesta in linea se la tua macchina è connessa a Internet e può effettuare connessioni in uscita alla porta 8884.

     Il License Manager invia quindi una richiesta al server delle licenze Easysoft per attivare automaticamente la chiave di licenza. Questo è il metodo più rapido e fa sì che i tuoi dati vengano inseriti immediatamente nel nostro database di supporto.

   • Le restanti tre opzioni (Richiesta e-mail, Richiesta di stampa e Visualizza richiesta) sono tutti modi per ottenere una licenza se la tua macchina è offline (cioè non ha una connessione a Internet).

     Ciascuno di questi metodi prevede di fornire a Easysoft informazioni incluso il numero della macchina (un numero univoco per la macchina) e quindi attendere di ricevere la chiave di licenza.

     Invece di inviare i tuoi dati via e-mail a Easysoft, puoi inserirli direttamente sul sito Web di Easysoft e la tua chiave di licenza ti verrà inviata automaticamente via e-mail.

     Per utilizzare questo metodo, fai clic su Visualizza richiesta, quindi visita:

     • Pagina della licenza di prova
     • Pagina della licenza completa

     Nella pagina Licenza, inserisci il numero della tua macchina (e il codice di autorizzazione per la licenza acquistata), fai clic su Invia e la tua chiave di licenza ti verrà inviata via email.

     Quando ricevi la chiave di licenza, puoi attivarla facendo doppio clic sull'allegato e-mail o facendo clic su Immetti licenza nella schermata principale di License Manager e incollando la chiave di licenza nella finestra di dialogo.

   • Scegli Fine per uscire da License Manager.

     L'installazione è completa.

Configurazione di un'origine dati ODBC

Prima di poter utilizzare il driver ODBC di SugarCRM per connettere la tua applicazione a SugarCRM, devi configurare un'origine dati ODBC. Un'origine dati ODBC memorizza i dettagli di connessione per il database di destinazione (ad es. SugarCRM) e il driver ODBC necessario per connettersi ad esso (ad es. il driver ODBC SugarCRM).

Configurare le origini dati ODBC in Amministratore ODBC, incluso in Windows. La modalità di esecuzione di ODBC Administrator dipende dal fatto che l'applicazione sia a 32 o 64 bit:

• La mia applicazione è a 32 bit

  Nella finestra di dialogo Esegui di Windows, digita:

  %windir%\syswow64\odbcad32.exe

• La mia applicazione è a 64 bit

  Apri Sistema e sicurezza> Strumenti di amministrazione nel Pannello di controllo, quindi apri Origini dati ODBC (64 bit). (Su Windows Server 2003 e versioni precedenti, l'applet del Pannello di controllo che avvia ODBC Administrator è denominata Origini dati.)

Come faccio a sapere se la mia applicazione è a 32 o 64 bit?

select SERVERPROPERTY('edition')

Nell'amministratore ODBC:

1. Scegli la scheda DSN di sistema, quindi scegli Aggiungi.
2. Nella finestra di dialogo Crea nuova origine dati, scegli Easysoft ODBC-SugarCRM Driver, quindi scegli Fine.
3. Compila questi campi nella finestra di dialogo Easysoft ODBC-SugarCRM Driver DSN Setup:

   Setting	Valore
   DSN	SugarCRM
   Nome utente	Il nome del tuo utente SugarCRM. Ad esempio, amministratore.
   Password	La password per il tuo utente SugarCRM.
   Uri di accesso	L'URI dell'istanza SugarCRM a cui vuoi connetterti. Ad esempio: https://sg-richarddemo.demo.sugarcrm.eu/ Il driver Easysoft ODBC-SugarCRM può connettersi a un'istanza SugarCRM sia su https e http

4. Nell'applicazione, connettiti all'origine dati appena configurata ed esegui una query di esempio. Ad esempio:

   select top 10 * from Accounts

Connetti a SugarCRM da Perl

Strawberry Perl è una distribuzione Perl per Windows che include i livelli middleware necessari (Perl DBI e Perl DBD::ODBC) per consentire al driver SugarCRM ODBC di connettere le tue applicazioni Perl a SugarCRM.

1. Sulla tua macchina Strawberry Perl, crea un nuovo script Perl con i seguenti contenuti:

   #!/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. Esegui lo script Perl, che recupererà i record dalla tabella Products.

Collega Microsoft Access a SugarCRM

Microsoft Access utilizza un driver ODBC per interagire con un'origine dati esterna. ODBC è una tecnologia di accesso ai dati, la cui implementazione Microsoft è inclusa in Windows. Puoi utilizzare il driver ODBC di SugarCRM per connettere Microsoft Access a un'istanza di SugarCRM, consentendoti di interrogare e aggiornare i dati di SugarCRM da un front-end di Microsoft Access.

1. Apri il tuo database Microsoft Access.
2. Esegui una delle seguenti operazioni:
   • Per Microsoft Access 2003 e versioni precedenti, nel menu File, scegliere Ottieni dati esterni> Collega tabelle.

     Viene visualizzata la finestra di dialogo Collegamento.

   • Per Microsoft Access 2007, nella scheda Dati esterni, scegliere Altro> Database ODBC.

     Viene avviata la procedura guidata Ottieni dati esterni.

   • Per Microsoft Access 2010 e versioni successive, nella scheda Dati esterni, scegliere Database ODBC.

     Viene avviata la procedura guidata Ottieni dati esterni.

3. Esegui una delle seguenti operazioni:
   • Per Microsoft Access 2003 e versioni precedenti, scegli Database ODBC dall'elenco Tipo file.
   • Per Microsoft Access 2007 e versioni successive, scegli Collega all'origine dati creando una tabella collegata, quindi scegli OK.

   Viene visualizzata la finestra di dialogo Seleziona origine dati.

4. Scegli la tua origine dati ODBC SugarCRM dall'elenco Origine dati macchina, quindi scegli OK.

   Viene visualizzata la finestra di dialogo Collega tabelle.

5. Scegli la tabella che desideri collegare e quindi scegli OK.
6. Scegli la tabella collegata in Microsoft Access, quindi scegli INVIO per lavorare con i dati collegati.

Collegamento di Excel a SugarCRM

Segui questi passaggi per restituire i dati da SugarCRM a Microsoft Excel utilizzando Microsoft Query:

1. Esegui una delle seguenti operazioni:
   • Per Excel 2007 e versioni successive, nella scheda Dati, scegli Ottieni dati esterni. Nel gruppo Da altre origini, scegli Da Microsoft Query.
   • Per Excel 2003 e versioni precedenti, nel menu Dati, scegli Importa dati esterni, quindi scegli Nuova query database.

   Il comando Nuova query database utilizza Microsoft Query per importare i dati. Microsoft Query è una funzionalità facoltativa, che per impostazione predefinita non è installata. Se non hai installato Microsoft Query, scegliendo Nuova query database ti verrà chiesto di installarlo. A tale scopo, nel Pannello di controllo, scegli Programmi e funzionalità (o Aggiungi o rimuovi programmi). Scegli Microsoft Office (se hai installato Excel come parte di Office) o Microsoft Excel, quindi scegli Cambia. Segui le istruzioni sullo schermo. Seleziona Scegli la personalizzazione avanzata delle applicazioni durante l'installazione guidata se questa opzione è presente per la tua versione di Office/Excel. Microsoft Query si trova in Strumenti di Office.

   Dopo aver installato Microsoft Query, ripetere il passaggio 1.

2. Nella finestra di dialogo Scegli origine dati, scegli l'origine dati del driver ODBC SugarCRM dall'elenco, quindi scegli OK.
3. Nella procedura guidata Query, scegli le colonne che contengono i dati che desideri recuperare, quindi fai clic su Avanti.
4. Se vuoi restituire un sottoinsieme di dati, usa la schermata Filtra dati per filtrare i risultati della tua query (questo è l'equivalente di un SQL WHERE clausola), quindi fare clic su Avanti.
5. Se desideri modificare l'ordinamento dei tuoi dati, utilizza la schermata Ordina per ordinare i risultati della tua query (questo è l'equivalente di un SQL ORDER BY clausola), quindi fare clic su Avanti.
6. Nel menu File, scegli Restituisci dati in Excel.
7. Scegli una posizione per i dati sul tuo foglio di lavoro quando richiesto.

   Nota Se non sembra accadere nulla in questa fase finale, la tabella di destinazione ha più colonne che possono essere recuperate in una sessione di Microsoft Query. Microsoft Query verrà eseguito in background. Passa a Query e riduci il numero di colonne da recuperare. Ripetere i passaggi precedenti per recuperare le colonne aggiuntive. (In altre parole, potrebbe essere necessario suddividere la tabella in più sessioni di query per recuperare tutti i dati in essa contenuti.)

Connettiti a SugarCRM da Oracle

1. Crea un file init DG4ODBC sulla tua macchina Oracle. Per fare ciò, cambia in %ORACLE_HOME%\hs\admin directory. Crea una copia del file initdg4odbc.ora . Assegna un nome al nuovo file initsugar.ora .

   Nota In queste istruzioni, sostituisci %ORACLE_HOME% con il percorso della tua directory Oracle HOME. Ad esempio, C:\oraclexe\app\oracle\product\11.2.0\server .

2. Assicurati che questi parametri e valori siano presenti nel tuo file init:

   HS_FDS_CONNECT_INFO = my_sugarcrm_odbc_dsn
   

   Sostituisci my_sugarcrm_odbc_dsn con il nome di un'origine dati del driver ODBC SugarCRM che si connette all'istanza SugarCRM di destinazione. Ad esempio

   HS_FDS_CONNECT_INFO = "SugarCRMSystemDSN"
   

3. Commenta la riga che abilita il tracciamento DG4ODBC. Ad esempio:

   #HS_FDS_TRACE_LEVEL = <trace_level>
   

4. Aggiungi una voce a %ORACLE_HOME%\network\admin\listener.ora che crea un SID_NAME per DG4ODBC. Ad esempio:

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

5. Aggiungi una voce DG4ODBC a %ORACLE_HOME%\network\admin\tnsnames.ora che specifica il SID_NAME creato nel passaggio precedente. Ad esempio:

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

   Sostituisci oracle_host con il nome host della tua macchina Oracle.

6. Avvia (o riavvia) Oracle Listener:

   cd %ORACLE_HOME%\bin
   lsnrctl stop
   lsnrctl start
   

7. Connettiti al tuo database Oracle in SQL*Plus.
8. In SQL*Plus, crea un collegamento al database per l'istanza SugarCRM di destinazione. Ad esempio:

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

9. Prova a interrogare i tuoi dati SugarCRM. Ad esempio:

   SELECT * FROM "Categories"@SUGARLINK;
   

Note

• Se hai problemi di connessione a SugarCRM da Oracle, abilita la traccia DG4ODBC e controlla i file di traccia scritti in %ORACLE_HOME%\hs\trace directory. Per abilitare il tracciamento DG4ODBC, aggiungi la riga HS_FDS_TRACE_LEVEL = DEBUG a initsugar.ora e quindi avviare/riavviare il listener Oracle. Se il trace la directory non esiste, creala.
• Se si abilita la traccia di ODBC Driver Manager, ma non si ottiene un file di traccia o un file di traccia vuoto, modificare il percorso del file di traccia nella directory TEMP di Windows. Ad esempio, C:\Windows\Temp\SQL.log .