Anslut ODBC-applikationer på Windows till SugarCRM

SugarCRM ODBC-drivrutinen gör att du kan arbeta med SugarCRM-data utanför SugarCRM-webbgränssnittet. Drivrutinen låter dig använda SugarCRM-data i alla program som stöder ODBC. Till exempel:

• Åtkomst
• Excel
• SQL-server
• Oracle
• Perl

Du kan fråga SugarCRM samt lägga till och uppdatera SugarCRM-poster.

Installera SugarCRM ODBC-drivrutinen

1. Installera och licensiera SugarCRM ODBC-drivrutinen på maskinen där ditt klientprogram är installerat.

   Om du till exempel vill arbeta med SugarCRM-data i Excel, installerar du SugarCRM ODBC-drivrutinen på maskinen där Excel är installerat.

   För att göra detta, kör fildistributionen som du fick i föregående steg och följ instruktionerna på skärmen.

   Installationsprogrammet startar Easysoft License Manager, eftersom du inte kan använda SugarCRM ODBC-drivrutinen förrän en licens har erhållits.

   Följande typer av licenser är tillgängliga:

   • Gratis tidsbegränsad testlicens som ger dig fri och obegränsad användning av produkten under en begränsad period (vanligtvis 14 dagar).
   • Fullständig licens om du har köpt produkten. När du köper produkten får du en auktoriseringskod som du använder för att få en licens
2. I Easysoft License Manager anger du dina uppgifter.

   Du MÅSTE ange fälten Namn, E-postadress och Företag.

   E-postadressen MÅSTE vara densamma som adressen som användes för att registrera och ladda ner från Easysofts webbplats, annars kommer du inte att kunna erhålla testlicenser.

3. Välj Begär licens.

   Du ombeds ange en licenstyp.

4. Gör något av följande:
   • För en testlicens klickar du på Tidsbegränsad provperiod och klickar sedan på Nästa.

     Licenshanteraren frågar vilken programvara du licensierar. Välj Easysoft SugarCRM ODBC-drivrutin från rullgardinsmenyn och klicka sedan på Nästa.

   • Om du har erhållit en auktoriseringskod för en köpt licens, välj Non-expiring License och klicka sedan på Nästa.

     Licenshanteraren begär din auktoriseringskod.

     Ange auktoriseringskoden och klicka sedan på Nästa.

5. Licenshanteraren visar en sammanfattning av den information du angett och låter dig välja metod för att ansöka om din licens.
6. Gör något av följande:
   • Välj Online-förfrågan om din maskin är ansluten till internet och kan göra utgående anslutningar till port 8884.

     Licenshanteraren skickar sedan en begäran till Easysofts licensserver för att aktivera din licensnyckel automatiskt. Detta är den snabbaste metoden och resulterar i att dina uppgifter omedelbart läggs in i vår supportdatabas.

   • De återstående tre alternativen (e-postbegäran, utskriftsbegäran och Visa begäran) är alla sätt att få en licens om din maskin är offline (dvs. inte har en anslutning till internet).

     Var och en av dessa metoder innebär att Easysoft förses med information inklusive ditt maskinnummer (ett nummer som är unikt för din maskin) och sedan väntar på att få din licensnyckel.

     Istället för att e-posta dina uppgifter till Easysoft kan du ange dem direkt på Easysofts webbplats och din licensnyckel kommer automatiskt att skickas till dig via e-post.

     För att använda den här metoden, klicka på Visa begäran och besök sedan:

     • Provlicenssida
     • Fullständig licenssida

     På licenssidan anger du ditt maskinnummer (och auktoriseringskoden för köpt licens), klickar på Skicka och din licensnyckel kommer att skickas till dig via e-post.

     När du får licensnyckeln kan du aktivera den antingen genom att dubbelklicka på e-postbilagan eller genom att klicka på Enter License på huvudskärmen i License Manager och klistra in licensnyckeln i dialogrutan.

   • Välj Slutför för att avsluta Licenshanteraren.

     Installationen är klar.

Konfigurera en ODBC-datakälla

Innan du kan använda SugarCRM ODBC-drivrutinen för att ansluta din applikation till SugarCRM måste du konfigurera en ODBC-datakälla. En ODBC-datakälla lagrar anslutningsdetaljerna för måldatabasen (t.ex. SugarCRM) och ODBC-drivrutinen som krävs för att ansluta till den (t.ex. SugarCRM ODBC-drivrutinen).

Du konfigurerar ODBC-datakällor i ODBC Administrator, som ingår i Windows. Hur du kör ODBC Administrator beror på om din applikation är 32-bitars eller 64-bitars:

• Mitt program är 32-bitars

  I dialogrutan Kör i Windows skriver du:

  %windir%\syswow64\odbcad32.exe

• Mitt program är 64-bitars

  Öppna System och säkerhet> Administrativa verktyg på Kontrollpanelen och öppna sedan ODBC-datakällor (64-bitars). (På Windows Server 2003 och tidigare är kontrollpanelens applet som startar ODBC Administrator märkt Data Sources.)

Hur vet jag om mitt program är 32-bitars eller 64-bitars?

select SERVERPROPERTY('edition')

I ODBC Administrator:

1. Välj fliken System DSN och välj sedan Lägg till.
2. I dialogrutan Skapa ny datakälla väljer du Easysoft ODBC-SugarCRM-drivrutin och sedan Slutför.
3. Fyll i dessa fält i dialogrutan Easysoft ODBC-SugarCRM Driver DSN Setup:

   Inställning	Värde
   DSN	SugarCRM
   Användarnamn	Namnet på din SugarCRM-användare. Till exempel admin.
   Lösenord	Lösenordet för din SugarCRM-användare.
   Logga Uri	URI för SugarCRM-instansen som du vill ansluta till. Till exempel: https://sg-richarddemo.demo.sugarcrm.eu/ Easysoft ODBC-SugarCRM-drivrutinen kan ansluta till en SugarCRM-instans både över https och http

4. I din app ansluter du till din nykonfigurerade datakälla och kör en exempelfråga. Till exempel:

   select top 10 * from Accounts

Anslut till SugarCRM från Perl

Strawberry Perl är en Perl-distribution för Windows som inkluderar de nödvändiga mellanvaruskikten (Perl DBI och Perl DBD::ODBC) för att göra det möjligt för SugarCRM ODBC-drivrutinen att ansluta dina Perl-applikationer till SugarCRM.

1. Skapa ett nytt Perl-skript på din Strawberry Perl-maskin med följande innehåll:

   #!/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. Kör Perl-skriptet, som sedan hämtar poster från tabellen Produkter.

Anslut Microsoft Access till SugarCRM

Microsoft Access använder en ODBC-drivrutin för att interagera med en extern datakälla. ODBC är en dataåtkomstteknik, vars Microsoft-implementering ingår i Windows. Du kan använda SugarCRM ODBC-drivrutinen för att ansluta Microsoft Access till en SugarCRM-instans, vilket gör att du kan fråga och uppdatera SugarCRM-data från ett Microsoft Access-gränssnitt.

1. Öppna din Microsoft Access-databas.
2. Gör något av följande:
   • För Microsoft Access 2003 och tidigare, på Arkiv-menyn, välj Hämta externa data> Länktabeller.

     Dialogrutan Länk visas.

   • För Microsoft Access 2007, på fliken Externa data, välj Mer> ODBC-databas.

     Guiden Hämta extern data startar.

   • För Microsoft Access 2010 och senare väljer du ODBC-databas på fliken Externa data.

     Guiden Hämta extern data startar.

3. Gör något av följande:
   • För Microsoft Access 2003 och tidigare, välj ODBC-databaser från listan Filtyper.
   • För Microsoft Access 2007 och senare, välj Länka till datakällan genom att skapa en länkad tabell och välj sedan OK.

   Dialogrutan Välj datakälla visas.

4. Välj din SugarCRM ODBC-datakälla från listan Maskindatakälla och välj sedan OK.

   Dialogrutan Länktabeller visas.

5. Välj den tabell som du vill länka och välj sedan OK.
6. Välj den länkade tabellen i Microsoft Access och välj sedan RETURN för att arbeta med den länkade informationen.

Ansluter Excel till SugarCRM

Följ dessa steg för att returnera data från SugarCRM till Microsoft Excel genom att använda Microsoft Query:

1. Gör något av följande:
   • För Excel 2007 och senare, på fliken Data, välj Hämta externa data. I gruppen Från andra källor väljer du Från Microsoft Query.
   • För Excel 2003 och tidigare, på Data-menyn, välj Importera extern data och välj sedan Ny databasfråga.

   Kommandot New Database Query använder Microsoft Query för att importera data. Microsoft Query är en valfri funktion som inte är installerad som standard. Om du inte har Microsoft Query installerat kommer du att uppmanas att installera den om du väljer New Database Query. För att göra detta, i Kontrollpanelen, välj Program och funktioner (eller Lägg till eller ta bort program). Välj Microsoft Office (om du installerade Excel som en del av Office) eller Microsoft Excel och välj sedan Ändra. Följ instruktionerna på skärmen. Välj Välj avancerad anpassning av applikationer under installationsguiden om det här alternativet finns för din version av Office/Excel. Microsoft Query finns under Office Tools.

   När du har installerat Microsoft Query, upprepa steg 1.

2. I dialogrutan Välj datakälla väljer du din SugarCRM ODBC-drivrutindatakälla från listan och väljer sedan OK.
3. I frågeguiden väljer du kolumnerna som innehåller data du vill hämta och klickar sedan på Nästa.
4. Om du vill returnera en delmängd av data, använd skärmen Filtrera data för att filtrera resultaten av din fråga (detta motsvarar en SQL WHERE sats) och klicka sedan på Nästa.
5. Om du vill ändra sorteringsordningen för dina data använder du skärmen Sorteringsordning för att sortera resultaten av din fråga (detta motsvarar en SQL ORDER BY sats) och klicka sedan på Nästa.
6. Välj Returnera data till Excel på Arkiv-menyn.
7. Välj en plats för data på ditt kalkylblad när du uppmanas.

   Obs Om ingenting verkar hända i detta slutskede har måltabellen fler kolumner än vad som kan hämtas i en Microsoft Query-session. Microsoft Query kommer att köras i bakgrunden. Växla till Fråga och minska antalet kolumner som ska hämtas. Upprepa stegen ovan för att hämta de ytterligare kolumnerna. (Med andra ord kan du behöva dela tabellen över flera frågesessioner för att hämta all data den innehåller.)

Anslut till SugarCRM från Oracle

1. Skapa en DG4ODBC init-fil på din Oracle-dator. För att göra detta, byt till %ORACLE_HOME%\hs\admin katalog. Skapa en kopia av filen initdg4odbc.ora . Namnge den nya filen initsugar.ora .

   Obs I dessa instruktioner ersätter du %ORACLE_HOME% med platsen för din Oracle HOME-katalog. Till exempel, C:\oraclexe\app\oracle\product\11.2.0\server .

2. Se till att dessa parametrar och värden finns i din init-fil:

   HS_FDS_CONNECT_INFO = my_sugarcrm_odbc_dsn
   

   Ersätt my_sugarcrm_odbc_dsn med namnet på en SugarCRM ODBC-drivrutinsdatakälla som ansluter till SugarCRM-målinstansen. Till exempel

   HS_FDS_CONNECT_INFO = "SugarCRMSystemDSN"
   

3. Kommentera raden som möjliggör DG4ODBC-spårning. Till exempel:

   #HS_FDS_TRACE_LEVEL = <trace_level>
   

4. Lägg till en post i %ORACLE_HOME%\network\admin\listener.ora som skapar en SID_NAME för DG4ODBC. Till exempel:

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

5. Lägg till en DG4ODBC-post i %ORACLE_HOME%\network\admin\tnsnames.ora som anger SID_NAME som skapades i föregående steg. Till exempel:

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

   Ersätt oracle_host med värdnamnet för din Oracle-maskin.

6. Starta (eller starta om) Oracle Listener:

   cd %ORACLE_HOME%\bin
   lsnrctl stop
   lsnrctl start
   

7. Anslut till din Oracle-databas i SQL*Plus.
8. Skapa en databaslänk för SugarCRM-målinstansen i SQL*Plus. Till exempel:

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

9. Försök att fråga dina SugarCRM-data. Till exempel:

   SELECT * FROM "Categories"@SUGARLINK;
   

Anteckningar

• Om du har problem med att ansluta till SugarCRM från Oracle, aktivera DG4ODBC-spårning och kontrollera spårningsfilerna som skrivits till %ORACLE_HOME%\hs\trace katalog. För att aktivera DG4ODBC-spårning, lägg till raden HS_FDS_TRACE_LEVEL = DEBUG till initsugar.ora och starta/starta om Oracle-lyssnaren. Om trace katalogen finns inte, skapa den.
• Om du aktiverar ODBC Driver Manager-spårning, men inte får en spårningsfil eller får en tom spårningsfil, ändrar du spårningsfilens plats till Windows TEMP-katalogen. Till exempel, C:\Windows\Temp\SQL.log .