Verbind ODBC-toepassingen op Windows met SugarCRM

Met het SugarCRM ODBC-stuurprogramma kunt u met SugarCRM-gegevens werken buiten de SugarCRM-webinterface. Met het stuurprogramma kunt u SugarCRM-gegevens gebruiken in elke toepassing die ODBC ondersteunt. Bijvoorbeeld:

• Toegang
• Excel
• SQL-server
• Oracle
• Perl

U kunt SugarCRM opvragen en SugarCRM-records toevoegen en bijwerken.

Het SugarCRM ODBC-stuurprogramma installeren

1. Installeer en licentieer het SugarCRM ODBC-stuurprogramma op de computer waarop uw clienttoepassing is geïnstalleerd.

   Als u bijvoorbeeld met SugarCRM-gegevens in Excel wilt werken, installeert u de SugarCRM ODBC-driver op de computer waarop Excel is geïnstalleerd.

   Om dit te doen, voert u de bestandsdistributie uit die u in de vorige stap hebt verkregen en volgt u de instructies op het scherm.

   Het installatieprogramma start de Easysoft License Manager, omdat u de SugarCRM ODBC Driver niet kunt gebruiken totdat een licentie is verkregen.

   De volgende soorten licenties zijn beschikbaar:

   • Gratis proeflicentie met beperkte tijd die u gratis en onbeperkt gebruik van het product geeft voor een beperkte periode (meestal 14 dagen).
   • Volledige licentie als je het product hebt gekocht. Bij aankoop van het product krijgt u een autorisatiecode die u gebruikt om een ​​licentie te verkrijgen
2. Voer in Easysoft License Manager uw gegevens in.

   U MOET de velden Naam, E-mailadres en Bedrijf invoeren.

   Het e-mailadres MOET hetzelfde zijn als het adres dat is gebruikt om u te registreren en te downloaden van de Easysoft-website, anders kunt u geen proeflicenties verkrijgen.

3. Kies Licentie aanvragen.

   U wordt gevraagd om een ​​licentietype.

4. Voer een van de volgende handelingen uit:
   • Klik voor een proeflicentie op Time Limited Trial en klik vervolgens op Volgende.

     De licentiebeheerder vraagt ​​welke software u in licentie geeft. Selecteer Easysoft SugarCRM ODBC-stuurprogramma in de vervolgkeuzelijst en klik vervolgens op Volgende.

   • Als u een autorisatiecode voor een gekochte licentie hebt verkregen, selecteert u Licentie niet-verlopen en klikt u op Volgende.

     De licentiebeheerder vraagt ​​om uw autorisatiecode.

     Voer de autorisatiecode in en klik vervolgens op Volgende.

5. De Licentiemanager geeft een samenvatting weer van de informatie die u hebt ingevoerd en stelt u in staat de methode te kiezen om uw licentie aan te vragen.
6. Voer een van de volgende handelingen uit:
   • Kies Online Verzoek als uw machine is verbonden met internet en uitgaande verbindingen kan maken met poort 8884.

     De License Manager stuurt vervolgens een verzoek naar de Easysoft-licentieserver om uw licentiesleutel automatisch te activeren. Dit is de snelste methode en zorgt ervoor dat uw gegevens onmiddellijk worden ingevoerd in onze ondersteuningsdatabase.

   • De overige drie opties (e-mailverzoek, afdrukverzoek en weergaveverzoek) zijn allemaal manieren om een ​​licentie te verkrijgen als uw machine offline is (d.w.z. geen verbinding met internet heeft).

     Elk van deze methoden houdt in dat u Easysoft informatie verstrekt, waaronder uw machinenummer (een nummer dat uniek is voor uw machine) en vervolgens wacht op het ontvangen van uw licentiesleutel.

     In plaats van uw gegevens naar Easysoft te e-mailen, kunt u ze rechtstreeks op de Easysoft-website invoeren en wordt uw licentiesleutel automatisch naar u gemaild.

     Om deze methode te gebruiken, klikt u op Verzoek bekijken en gaat u naar:

     • Pagina proeflicentie
     • Volledige licentiepagina

     Voer op de pagina Licentieverlening uw machinenummer (en autorisatiecode voor gekochte licentie) in, klik op Verzenden en uw licentiesleutel wordt naar u gemaild.

     Wanneer u de licentiesleutel ontvangt, kunt u deze activeren door te dubbelklikken op de e-mailbijlage of door te klikken op Licentie invoeren in het hoofdscherm van Licentiebeheer en de licentiesleutel in het dialoogvenster te plakken.

   • Kies Voltooien om Licentiebeheer af te sluiten.

     De installatie is voltooid.

Een ODBC-gegevensbron configureren

Voordat u de SugarCRM ODBC Driver kunt gebruiken om uw applicatie te verbinden met SugarCRM, moet u een ODBC-gegevensbron configureren. Een ODBC-gegevensbron slaat de verbindingsdetails op voor de doeldatabase (bijv. SugarCRM) en het ODBC-stuurprogramma dat nodig is om er verbinding mee te maken (bijv. het SugarCRM ODBC-stuurprogramma).

U configureert ODBC-gegevensbronnen in ODBC Administrator, dat bij Windows wordt geleverd. Hoe u ODBC Administrator uitvoert, hangt af van of uw toepassing 32-bits of 64-bits is:

• Mijn applicatie is 32-bits

  Typ in het dialoogvenster Uitvoeren van Windows:

  %windir%\syswow64\odbcad32.exe

• Mijn applicatie is 64-bits

  Open Systeem en beveiliging> Systeembeheer in het Configuratiescherm en open vervolgens ODBC-gegevensbronnen (64-bits). (Op Windows Server 2003 en eerder wordt de applet van het Configuratiescherm waarmee ODBC Administrator wordt gestart, Data Sources genoemd.)

Hoe weet ik of mijn toepassing 32-bits of 64-bits is?

select SERVERPROPERTY('edition')

In ODBC-beheerder:

1. Kies het tabblad Systeem-DSN en kies vervolgens Toevoegen.
2. Kies in het dialoogvenster Nieuwe gegevensbron maken de optie Easysoft ODBC-SugarCRM-stuurprogramma en kies vervolgens Voltooien.
3. Vul deze velden in het dialoogvenster Easysoft ODBC-SugarCRM Driver DSN Setup in:

   Instelling	Waarde
   DSN	SugarCRM
   Gebruikersnaam	De naam van uw SugarCRM-gebruiker. Bijvoorbeeld beheerder.
   Wachtwoord	Het wachtwoord voor uw SugarCRM-gebruiker.
   Aanmeld-URI	De URI van de SugarCRM-instantie waarmee u verbinding wilt maken. Bijvoorbeeld: https://sg-richarddemo.demo.sugarcrm.eu/ Het Easysoft ODBC-SugarCRM-stuurprogramma kan verbinding maken met een SugarCRM-instantie zowel via https en http

4. Maak in uw toepassing verbinding met uw nieuw geconfigureerde gegevensbron en voer een voorbeeldquery uit. Bijvoorbeeld:

   select top 10 * from Accounts

Verbind met SugarCRM vanuit Perl

Strawberry Perl is een Perl-distributie voor Windows die de nodige middleware-lagen bevat (Perl DBI en Perl DBD::ODBC) om de SugarCRM ODBC-driver in staat te stellen uw Perl-applicaties te verbinden met SugarCRM.

1. Maak op uw Strawberry Perl-machine een nieuw Perl-script met de volgende inhoud:

   #!/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. Voer het Perl-script uit, dat dan records uit de tabel Producten zal ophalen.

Verbind Microsoft Access met SugarCRM

Microsoft Access gebruikt een ODBC-stuurprogramma om te communiceren met een externe gegevensbron. ODBC is een technologie voor gegevenstoegang, waarvan de Microsoft-implementatie bij Windows wordt geleverd. U kunt het SugarCRM ODBC-stuurprogramma gebruiken om Microsoft Access te verbinden met een SugarCRM-instantie, zodat u SugarCRM-gegevens kunt opvragen en bijwerken vanaf een Microsoft Access-frontend.

1. Open uw Microsoft Access-database.
2. Voer een van de volgende handelingen uit:
   • Voor Microsoft Access 2003 en eerder kiest u in het menu Bestand de optie Externe gegevens ophalen> Tabellen koppelen.

     Het dialoogvenster Koppeling wordt weergegeven.

   • Kies voor Microsoft Access 2007 op het tabblad Externe gegevens de optie Meer> ODBC-database.

     De wizard Externe gegevens ophalen wordt gestart.

   • Voor Microsoft Access 2010 en later kiest u op het tabblad Externe gegevens de optie ODBC-database.

     De wizard Externe gegevens ophalen wordt gestart.

3. Voer een van de volgende handelingen uit:
   • Kies voor Microsoft Access 2003 en eerder ODBC-databases in de lijst Bestandstype.
   • Kies voor Microsoft Access 2007 en later Koppelen aan de gegevensbron door een gekoppelde tabel te maken en kies vervolgens OK.

   Het dialoogvenster Gegevensbron selecteren wordt weergegeven.

4. Kies uw SugarCRM ODBC-gegevensbron in de lijst Machinegegevensbron en kies vervolgens OK.

   Het dialoogvenster Tabellen koppelen wordt weergegeven.

5. Kies de tabel die u wilt koppelen en kies vervolgens OK.
6. Kies de gekoppelde tabel in Microsoft Access en kies vervolgens RETURN om met de gekoppelde gegevens te werken.

Excel verbinden met SugarCRM

Volg deze stappen om gegevens van SugarCRM naar Microsoft Excel te retourneren met behulp van Microsoft Query:

1. Voer een van de volgende handelingen uit:
   • Voor Excel 2007 en later kiest u op het tabblad Gegevens de optie Externe gegevens ophalen. Kies in de groep Van andere bronnen de optie Van Microsoft Query.
   • Voor Excel 2003 en eerder kiest u in het menu Gegevens de optie Externe gegevens importeren en kiest u vervolgens Nieuwe databasequery.

   De opdracht Nieuwe databasequery gebruikt Microsoft Query om gegevens te importeren. Microsoft Query is een optionele functie die standaard niet is geïnstalleerd. Als u Microsoft Query niet hebt geïnstalleerd, wordt u door het kiezen van New Database Query gevraagd deze te installeren. Kies hiervoor in het Configuratiescherm Programma's en onderdelen (of Programma's toevoegen of verwijderen). Kies Microsoft Office (als u Excel als onderdeel van Office hebt geïnstalleerd) of Microsoft Excel en kies vervolgens Wijzigen. Volg de instructies op het scherm. Selecteer Geavanceerde aanpassing van toepassingen kiezen tijdens de installatiewizard als deze optie aanwezig is voor uw versie van Office / Excel. Microsoft Query bevindt zich onder Office Tools.

   Als u Microsoft Query hebt geïnstalleerd, herhaalt u stap 1.

2. Kies in het dialoogvenster Gegevensbron kiezen uw SugarCRM ODBC-stuurprogrammagegevensbron uit de lijst en kies vervolgens OK.
3. Kies in de Query Wizard de kolommen die de gegevens bevatten die u wilt ophalen en klik vervolgens op Volgende.
4. Als u een subset van de gegevens wilt retourneren, gebruikt u het scherm Gegevens filteren om de resultaten van uw zoekopdracht te filteren (dit is het equivalent van een SQL WHERE clausule) en klik vervolgens op Volgende.
5. Als u de sorteervolgorde van uw gegevens wilt wijzigen, gebruikt u het scherm Sorteervolgorde om de resultaten van uw zoekopdracht te sorteren (dit is het equivalent van een SQL ORDER BY clausule) en klik vervolgens op Volgende.
6. Kies in het menu Bestand de optie Gegevens retourneren naar Excel.
7. Kies een locatie voor de gegevens op uw werkblad wanneer daarom wordt gevraagd.

   Opmerking Als er in dit laatste stadium niets lijkt te gebeuren, heeft de doeltabel meer kolommen dan in één Microsoft Query-sessie kunnen worden opgehaald. Microsoft Query wordt op de achtergrond uitgevoerd. Schakel over naar Query en verminder het aantal op te halen kolommen. Herhaal de bovenstaande stappen om de extra kolommen op te halen. (Met andere woorden, het kan zijn dat u de tabel over meerdere Query-sessies moet splitsen om alle gegevens op te halen.)

Verbinden met SugarCRM vanuit Oracle

1. Maak een DG4ODBC init-bestand op uw Oracle-machine. Ga hiervoor naar de %ORACLE_HOME%\hs\admin map. Maak een kopie van het bestand initdg4odbc.ora . Geef het nieuwe bestand de naam initsugar.ora .

   Opmerking Vervang in deze instructies %ORACLE_HOME% door de locatie van uw Oracle HOME-directory. Bijvoorbeeld C:\oraclexe\app\oracle\product\11.2.0\server .

2. Zorg ervoor dat deze parameters en waarden aanwezig zijn in uw init-bestand:

   HS_FDS_CONNECT_INFO = my_sugarcrm_odbc_dsn
   

   Vervang my_sugarcrm_odbc_dsn met de naam van een SugarCRM ODBC-stuurprogrammagegevensbron die verbinding maakt met de doel-SugarCRM-instantie. Bijvoorbeeld

   HS_FDS_CONNECT_INFO = "SugarCRMSystemDSN"
   

3. Reageer op de regel die DG4ODBC-tracering mogelijk maakt. Bijvoorbeeld:

   #HS_FDS_TRACE_LEVEL = <trace_level>
   

4. Voeg een item toe aan %ORACLE_HOME%\network\admin\listener.ora dat maakt een SID_NAME voor DG4ODBC. Bijvoorbeeld:

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

5. Voeg een DG4ODBC-item toe aan %ORACLE_HOME%\network\admin\tnsnames.ora die de SID_NAME specificeert die in de vorige stap is gemaakt. Bijvoorbeeld:

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

   Vervang oracle_host met de hostnaam van uw Oracle-machine.

6. Start (of herstart) de Oracle Listener:

   cd %ORACLE_HOME%\bin
   lsnrctl stop
   lsnrctl start
   

7. Maak verbinding met uw Oracle-database in SQL*Plus.
8. Maak in SQL*Plus een databasekoppeling voor de beoogde SugarCRM-instantie. Bijvoorbeeld:

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

9. Probeer uw SugarCRM-gegevens op te vragen. Bijvoorbeeld:

   SELECT * FROM "Categories"@SUGARLINK;
   

Opmerkingen

• Als je problemen hebt om verbinding te maken met SugarCRM vanuit Oracle, schakel dan DG4ODBC-tracering in en controleer de traceerbestanden die zijn geschreven naar de %ORACLE_HOME%\hs\trace map. Om DG4ODBC-tracering in te schakelen, voegt u de regel HS_FDS_TRACE_LEVEL = DEBUG toe naar initsugar.ora en start / herstart vervolgens de Oracle-listener. Als de trace directory bestaat niet, maak deze aan.
• Als u ODBC Driver Manager-tracering inschakelt, maar geen traceerbestand krijgt of een leeg traceringsbestand krijgt, wijzigt u de locatie van het traceerbestand in de Windows TEMP-directory. Bijvoorbeeld C:\Windows\Temp\SQL.log .