Forbind ODBC-applikationer på Windows til SugarCRM

SugarCRM ODBC-driveren giver dig mulighed for at arbejde med SugarCRM-data uden for SugarCRM-webgrænsefladen. Driveren giver dig mulighed for at bruge SugarCRM-data i ethvert program, der understøtter ODBC. For eksempel:

• Adgang
• Excel
• SQL-server
• Oracle
• Perl

Du kan forespørge SugarCRM samt tilføje og opdatere SugarCRM-poster.

Installation af SugarCRM ODBC-driveren

1. Installer og licenser SugarCRM ODBC-driveren på den maskine, hvor dit klientprogram er installeret.

   Hvis du f.eks. vil arbejde med SugarCRM-data i Excel, skal du installere SugarCRM ODBC-driveren på den maskine, hvor Excel er installeret.

   For at gøre dette skal du udføre den fildistribution, du fik i det forrige trin, og følge instruktionerne på skærmen.

   Installationsprogrammet starter Easysoft License Manager, fordi du ikke kan bruge SugarCRM ODBC-driveren, før en licens er opnået.

   Følgende licenstyper er tilgængelige:

   • Gratis tidsbegrænset prøvelicens, som giver dig gratis og ubegrænset brug af produktet i en begrænset periode (normalt 14 dage).
   • Fuld licens, hvis du har købt produktet. Ved køb af produktet får du en autorisationskode, som du bruger til at opnå en licens
2. Indtast dine oplysninger i Easysoft License Manager.

   Du SKAL indtaste felterne Navn, E-mailadresse og Firma.

   E-mail-adressen SKAL være den samme som den adresse, der blev brugt til at registrere og downloade fra Easysoft-webstedet, ellers vil du ikke være i stand til at få prøvelicenser.

3. Vælg Anmod om licens.

   Du bliver bedt om en licenstype.

4. Gør et af følgende:
   • For en prøvelicens skal du klikke på Tidsbegrænset prøveversion og derefter klikke på Næste.

     Licensadministratoren spørger, hvilken software du licenserer. Vælg Easysoft SugarCRM ODBC Driver fra rullelisten, og klik derefter på Næste.

   • Hvis du har fået en godkendelseskode til en købt licens, skal du vælge Ikke-udløbende licens og derefter klikke på Næste.

     Licensadministratoren anmoder om din autorisationskode.

     Indtast godkendelseskoden, og klik derefter på Næste.

5. Licensadministratoren viser en oversigt over de oplysninger, du har indtastet, og giver dig mulighed for at vælge metoden til at ansøge om din licens.
6. Gør et af følgende:
   • Vælg onlineanmodning, hvis din maskine er forbundet til internettet og kan oprette udgående forbindelser til port 8884.

     Licensadministratoren sender derefter en anmodning til Easysoft-licensserveren om at aktivere din licensnøgle automatisk. Dette er den hurtigste metode og resulterer i, at dine oplysninger straks indtastes i vores supportdatabase.

   • De resterende tre muligheder (e-mail-anmodning, udskriftsanmodning og se anmodning) er alle måder at få en licens på, hvis din maskine er offline (dvs. ikke har forbindelse til internettet).

     Hver af disse metoder involverer at give Easysoft oplysninger, herunder dit maskinnummer (et nummer, der er unikt for din maskine) og derefter vente på at modtage din licensnøgle.

     I stedet for at sende dine oplysninger til Easysoft via e-mail, kan du indtaste dem direkte på Easysofts websted, og din licensnøgle vil automatisk blive sendt til dig via e-mail.

     For at bruge denne metode skal du klikke på Vis anmodning og derefter gå til:

     • Prøvlicensside
     • Fuld licensside

     På siden Licens skal du indtaste dit maskinnummer (og autorisationskode for købt licens), klikke på Send, og din licensnøgle vil blive sendt til dig via e-mail.

     Når du modtager licensnøglen, kan du aktivere den enten ved at dobbeltklikke på den vedhæftede e-mail eller ved at klikke på Enter License på hovedskærmen i License Manager og indsætte licensnøglen i dialogboksen.

   • Vælg Udfør for at afslutte License Manager.

     Installationen er fuldført.

Konfiguration af en ODBC-datakilde

Før du kan bruge SugarCRM ODBC-driveren til at forbinde din applikation til SugarCRM, skal du konfigurere en ODBC-datakilde. En ODBC-datakilde gemmer forbindelsesdetaljerne for måldatabasen (f.eks. SugarCRM) og den ODBC-driver, der kræves for at oprette forbindelse til den (f.eks. SugarCRM ODBC-driveren).

Du konfigurerer ODBC-datakilder i ODBC Administrator, som er inkluderet i Windows. Hvordan du kører ODBC Administrator afhænger af, om dit program er 32-bit eller 64-bit:

• Min applikation er 32-bit

  Skriv:

  i dialogboksen Kør i Windows

  %windir%\syswow64\odbcad32.exe

• Min applikation er 64-bit

  Åbn System og sikkerhed> Administrative værktøjer i Kontrolpanel, og åbn derefter ODBC-datakilder (64-bit). (På Windows Server 2003 og tidligere er kontrolpanel-appletten, der starter ODBC Administrator, mærket Datakilder.)

Hvordan kan jeg se, om mit program er 32-bit eller 64-bit?

select SERVERPROPERTY('edition')

I ODBC Administrator:

1. Vælg fanen System DSN, og vælg derefter Tilføj.
2. Vælg Easysoft ODBC-SugarCRM-driver i dialogboksen Opret ny datakilde, og vælg derefter Udfør.
3. Udfyld disse felter i dialogboksen Easysoft ODBC-SugarCRM Driver DSN Setup:

   Indstilling	Værdi
   DSN	SugarCRM
   Brugernavn	Navnet på din SugarCRM-bruger. For eksempel admin.
   Adgangskode	Adgangskoden til din SugarCRM-bruger.
   Login-Uri	URI'en for den SugarCRM-instans, som du vil oprette forbindelse til. For eksempel: https://sg-richarddemo.demo.sugarcrm.eu/ Easysoft ODBC-SugarCRM-driveren kan oprette forbindelse til en SugarCRM-instans både over https og http

4. I din applikation skal du oprette forbindelse til din nyligt konfigurerede datakilde og køre en prøveforespørgsel. For eksempel:

   select top 10 * from Accounts

Opret forbindelse til SugarCRM fra Perl

Strawberry Perl er en Perl-distribution til Windows, der inkluderer de nødvendige middleware-lag (Perl DBI og Perl DBD::ODBC) for at gøre det muligt for SugarCRM ODBC-driveren at forbinde dine Perl-applikationer til SugarCRM.

1. På din Strawberry Perl-maskine skal du oprette et nyt Perl-script med følgende indhold:

   #!/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-scriptet, som derefter vil hente poster fra tabellen Produkter.

Forbind Microsoft Access til SugarCRM

Microsoft Access bruger en ODBC-driver til at interagere med en ekstern datakilde. ODBC er en dataadgangsteknologi, hvis Microsoft-implementering er inkluderet i Windows. Du kan bruge SugarCRM ODBC-driveren til at forbinde Microsoft Access til en SugarCRM-instans, så du kan forespørge og opdatere SugarCRM-data fra en Microsoft Access-frontend.

1. Åbn din Microsoft Access-database.
2. Gør et af følgende:
   • For Microsoft Access 2003 og tidligere skal du i menuen Filer vælge Hent eksterne data> Linktabeller.

     Dialogboksen Link vises.

   • For Microsoft Access 2007 skal du på fanen Eksterne data vælge Mere> ODBC-database.

     Guiden Hent eksterne data starter.

   • For Microsoft Access 2010 og nyere skal du på fanen Eksterne data vælge ODBC-database.

     Guiden Hent eksterne data starter.

3. Gør et af følgende:
   • For Microsoft Access 2003 og tidligere skal du vælge ODBC-databaser på listen Filtyper.
   • For Microsoft Access 2007 og nyere skal du vælge Link til datakilden ved at oprette en sammenkædet tabel og derefter vælge OK.

   Dialogboksen Vælg datakilde vises.

4. Vælg din SugarCRM ODBC-datakilde fra listen Maskindatakilde, og vælg derefter OK.

   Dialogboksen Link Tables vises.

5. Vælg den tabel, du vil linke til, og vælg derefter OK.
6. Vælg den linkede tabel i Microsoft Access, og vælg derefter RETURN for at arbejde med de linkede data.

Tilslutning af Excel til SugarCRM

Følg disse trin for at returnere data fra SugarCRM til Microsoft Excel ved hjælp af Microsoft Query:

1. Gør et af følgende:
   • For Excel 2007 og nyere skal du på fanen Data vælge Hent eksterne data. I gruppen Fra andre kilder skal du vælge Fra Microsoft-forespørgsel.
   • For Excel 2003 og tidligere skal du i menuen Data vælge Importer eksterne data og derefter vælge Ny databaseforespørgsel.

   Kommandoen New Database Query bruger Microsoft Query til at importere data. Microsoft Query er en valgfri funktion, som som standard ikke er installeret. Hvis du ikke har installeret Microsoft Query, vil du blive bedt om at installere den, hvis du vælger New Database Query. For at gøre dette skal du i Kontrolpanel vælge Programmer og funktioner (eller Tilføj eller fjern programmer). Vælg Microsoft Office (hvis du har installeret Excel som en del af Office) eller Microsoft Excel, og vælg derefter Skift. Følg instruktionerne på skærmen. Vælg Vælg avanceret tilpasning af programmer under installationsguiden, hvis denne mulighed er til stede for din version af Office/Excel. Microsoft Query er placeret under Office Tools.

   Gentag trin 1, når du har installeret Microsoft Query.

2. I dialogboksen Vælg datakilde skal du vælge din SugarCRM ODBC-driverdatakilde fra listen og derefter vælge OK.
3. I forespørgselsguiden skal du vælge de kolonner, der indeholder de data, du vil hente, og derefter klikke på Næste.
4. Hvis du vil returnere en delmængde af dataene, skal du bruge skærmbilledet Filtrer data til at filtrere resultaterne af din forespørgsel (dette svarer til en SQL WHERE klausul), og klik derefter på Næste.
5. Hvis du vil ændre sorteringsrækkefølgen af ​​dine data, skal du bruge skærmen Sorteringsrækkefølge til at sortere resultaterne af din forespørgsel (dette svarer til en SQL ORDER BY klausul), og klik derefter på Næste.
6. Vælg Returner data til Excel i menuen Filer.
7. Vælg en placering for dataene på dit regneark, når du bliver bedt om det.

   Bemærk Hvis intet ser ud til at ske på dette sidste trin, har måltabellen flere kolonner, end der kan hentes i én Microsoft Query-session. Microsoft Query kører i baggrunden. Skift til Forespørgsel, og reducer antallet af kolonner, der skal hentes. Gentag ovenstående trin for at hente de yderligere kolonner. (Med andre ord skal du muligvis opdele tabellen over flere forespørgselssessioner for at hente alle de data, den indeholder.)

Opret forbindelse til SugarCRM fra Oracle

1. Opret en DG4ODBC init-fil på din Oracle-maskine. For at gøre dette skal du skifte til %ORACLE_HOME%\hs\admin vejviser. Opret en kopi af filen initdg4odbc.ora . Navngiv den nye fil initsugar.ora .

   Bemærk I denne vejledning skal du erstatte %ORACLE_HOME% med placeringen af ​​dit Oracle HOME-bibliotek. For eksempel C:\oraclexe\app\oracle\product\11.2.0\server .

2. Sørg for, at disse parametre og værdier er til stede i din init-fil:

   HS_FDS_CONNECT_INFO = my_sugarcrm_odbc_dsn
   

   Erstat my_sugarcrm_odbc_dsn med navnet på en SugarCRM ODBC-driverdatakilde, der forbinder til SugarCRM-målforekomsten. For eksempel

   HS_FDS_CONNECT_INFO = "SugarCRMSystemDSN"
   

3. Kommenter linjen, der aktiverer DG4ODBC-sporing. For eksempel:

   #HS_FDS_TRACE_LEVEL = <trace_level>
   

4. Tilføj en post til %ORACLE_HOME%\network\admin\listener.ora der opretter en SID_NAME for DG4ODBC. For eksempel:

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

5. Tilføj en DG4ODBC-post til %ORACLE_HOME%\network\admin\tnsnames.ora der specificerer SID_NAME oprettet i det forrige trin. For eksempel:

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

   Erstat oracle_host med værtsnavnet på din Oracle-maskine.

6. Start (eller genstart) Oracle Listener:

   cd %ORACLE_HOME%\bin
   lsnrctl stop
   lsnrctl start
   

7. Opret forbindelse til din Oracle-database i SQL*Plus.
8. I SQL*Plus skal du oprette et databaselink til SugarCRM-målforekomsten. For eksempel:

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

9. Prøv at forespørge på dine SugarCRM-data. For eksempel:

   SELECT * FROM "Categories"@SUGARLINK;
   

Bemærkninger

• Hvis du har problemer med at oprette forbindelse til SugarCRM fra Oracle, skal du aktivere DG4ODBC-sporing og kontrollere sporingsfilerne skrevet til %ORACLE_HOME%\hs\trace vejviser. For at aktivere DG4ODBC-sporing skal du tilføje linjen HS_FDS_TRACE_LEVEL = DEBUG til initsugar.ora og start/genstart derefter Oracle-lytteren. Hvis trace bibliotek eksisterer ikke, opret det.
• Hvis du aktiverer ODBC Driver Manager-sporing, men ikke får en sporingsfil eller får en tom sporingsfil, skal du ændre sporingsfilens placering til Windows TEMP-mappen. For eksempel C:\Windows\Temp\SQL.log .