SlideShare une entreprise Scribd logo
Fonctionnement de SOAP 
sur SugarCRM pour 
développer de nouveaux 
connecteurs 
1. Descriptif du document :...................................................................................... 2 
2. Pré-requis : .......................................................................................................... 2 
3. Vérifier la disponibilité du serveur SugarCRM..................................................... 2 
3.1. Soap_test.xml............................................................................................... 2 
3.2. Soap_testResponse.xml .............................................................................. 2 
4. Identification sur le serveur SugarCRM............................................................... 3 
4.1. Soap_login.xml............................................................................................. 3 
4.2. Soap_loginResponse.xml............................................................................. 3 
5. Récupération de l’identifiant de l’utilisateur ......................................................... 4 
5.1. Soap_get_user_id.xml.................................................................................. 4 
5.2. Soap_get_user_idResponse.xml.................................................................. 4 
6. Listing d’un module trié et filtré............................................................................ 5 
6.1. Soap_get_entry_list_Search.xml.................................................................. 5 
6.2. Soap_get_entry_listResponse_Search.xml.................................................. 5 
7. Exemple des fichiers XML envoyés/reçus ........................................................... 6 
8. Que se passe t’il réllement pour les puristes ....................................................... 6 
Si vous avez besoin d’aide : ....................................................................................... 8 
Liens utiles :................................................................................................................ 8 
Sources : .................................................................................................................... 8 
20/06/2006 SOAP_sur_SugarCRM_pour_developpement_connecteurs_V1.0.doc page 1 / 8 
Toute reproduction, même partielle, tout transfert à un tiers, sous quelque forme que ce soit, sont strictement interdits sans 
autorisation préalable écrite de SYNOLIA
1. Descriptif du document : 
Ce document décrit le fonctionnement de la couche SOAP au sein de SugarCRM et 
permettra aux développeurs de mieux appréhender celle-ci afin de réaliser des 
connecteurs pour échanger à partir de flux XML. 
Tout langage peut être utilisé du moment qu’il est capable de réaliser une connexion 
distante ainsi que de traiter les résultats en XML. 
Ce document n’a pas pour but d’être exhaustif mais uniquement de présenter 
quelques fonctions permettant de réaliser une connexion SOAP puis de demander 
un listing. 
2. Pré-requis : 
· Disposer de SugarCRM installé sur votre machine ou sur un serveur 
· Disposer d’une classe qui gère le XML tel nuSOAP en PHP est un plus qui 
facilitera grandement le travail du développeur. 
3. Vérifier la disponibilité du serveur SugarCRM 
3.1. Soap_test.xml 
Fichier XML envoyé pour connaître l’état du serveur et ainsi tester sa disponibilité. 
En paramètre(s) d’entrée : 
· string : « Server Available » 
3.2. Soap_testResponse.xml 
20/06/2006 SOAP_sur_SugarCRM_pour_developpement_connecteurs_V1.0.doc page 2 / 8 
Toute reproduction, même partielle, tout transfert à un tiers, sous quelque forme que ce soit, sont strictement interdits sans 
autorisation préalable écrite de SYNOLIA 
Fichier XML reçu 
En paramètre(s) de sortie : 
· return : « Server Available »
20/06/2006 SOAP_sur_SugarCRM_pour_developpement_connecteurs_V1.0.doc page 3 / 8 
Toute reproduction, même partielle, tout transfert à un tiers, sous quelque forme que ce soit, sont strictement interdits sans 
autorisation préalable écrite de SYNOLIA 
 
4. Identification sur le serveur SugarCRM 
4.1. Soap_login.xml 
Fichier XML envoyé pour ouvrir une session sur l’application. 
En paramètre(s) d’entrée : 
· user_auth 
 user_name : login utilisateur 
 password : mot de passe utilisateur (MD5) 
 version : .1 
· application_name : SugarWap (En fait le nom de votre appli) 
4.2. Soap_loginResponse.xml 
Fichier XML reçu 
En paramètre(s) de sortie : 
· id : ID de session
5. Récupération de l’identifiant de l’utilisateur 
5.1. Soap_get_user_id.xml 
Fichier XML envoyé pour récupérer l’ID de l’utilisateur 
En paramètre(s) d’entrée : 
· session : ID de session 
5.2. Soap_get_user_idResponse.xml 
20/06/2006 SOAP_sur_SugarCRM_pour_developpement_connecteurs_V1.0.doc page 4 / 8 
Toute reproduction, même partielle, tout transfert à un tiers, sous quelque forme que ce soit, sont strictement interdits sans 
autorisation préalable écrite de SYNOLIA 
Fichier XML reçu 
En paramètre(s) de sortie : 
· return : ID de l’utilisateur
6. Listing d’un module trié et filtré 
6.1. Soap_get_entry_list_Search.xml 
Fichier XML envoyé pour récupérer une liste d’enregistrement pour un module donné 
En paramètre(s) d’entrée : 
· session : ID de session 
· module_name : Nom du module (contacts) 
· query : Condition « where » de la requête que Sugar va opérer sur la base 
· order_by : Champ « order by » de la requête pour trier les résultats 
· offset : Correspond au « LIMIT x, 10 » du SQL 
· select_fields item : Champs à retourner 
· max_results : Nombre max d’enregistrements à retourner 
· deleted : enregistrements supprimés à retourner 0 ou 1 
6.2. Soap_get_entry_listResponse_Search.xml 
20/06/2006 SOAP_sur_SugarCRM_pour_developpement_connecteurs_V1.0.doc page 5 / 8 
Toute reproduction, même partielle, tout transfert à un tiers, sous quelque forme que ce soit, sont strictement interdits sans 
autorisation préalable écrite de SYNOLIA 
Fichier XML reçu 
En paramètre(s) de sortie : 
· Les paramètres de sortie sont dépendants de ce que vous avez demandé en 
entrée
7. Exemple des fichiers XML envoyés/reçus 
20/06/2006 SOAP_sur_SugarCRM_pour_developpement_connecteurs_V1.0.doc page 6 / 8 
Toute reproduction, même partielle, tout transfert à un tiers, sous quelque forme que ce soit, sont strictement interdits sans 
autorisation préalable écrite de SYNOLIA
Si vous avez besoin de ces fichiers d’exemple vous pouvez 
contacter Synolia directement ou faire une demande sur le forum 
CRM-France.com. 
 
8. Que se passe t’il réllement pour les puristes 
Vous pouvez tester en telnet sur le port 80 afin de mieux visualiser l’échange de 
données.
20/06/2006 SOAP_sur_SugarCRM_pour_developpement_connecteurs_V1.0.doc page 7 / 8 
Toute reproduction, même partielle, tout transfert à un tiers, sous quelque forme que ce soit, sont strictement interdits sans 
autorisation préalable écrite de SYNOLIA 
Contenu XML envoyé :

Contenu connexe

En vedette

Exemple après la voyance complete
Exemple après la voyance completeExemple après la voyance complete
Exemple après la voyance complete
https://www.predicta-voyance.fr
 
Bureaux portables sur clé USB
Bureaux portables sur clé USBBureaux portables sur clé USB
Bureaux portables sur clé USB
URFIST de Paris
 
Modelo de negocio indra dzoara muñoz
Modelo de negocio indra dzoara muñozModelo de negocio indra dzoara muñoz
Modelo de negocio indra dzoara muñoz
Indra Dzoara MJ
 
Trabajo etica
Trabajo eticaTrabajo etica
Trabajo etica
miblogtochulo
 
La publicité
La publicité La publicité
La publicité
katheuh
 
Manual bosch frigorifico kdn32 x10
Manual bosch   frigorifico kdn32 x10Manual bosch   frigorifico kdn32 x10
Manual bosch frigorifico kdn32 x10
Alsako Electrodomésticos
 
Tournoi de poker ADCO GROUPd_2011
Tournoi de poker ADCO GROUPd_2011Tournoi de poker ADCO GROUPd_2011
Tournoi de poker ADCO GROUPd_2011Karine Trudel
 
Kitmobilisation climat 21 pdf
Kitmobilisation climat 21 pdfKitmobilisation climat 21 pdf
Kitmobilisation climat 21 pdfFanny Despouys
 
Exposé version finale
Exposé version finaleExposé version finale
Exposé version finaledoubletilde
 
Municipales et impact de l'actualité
Municipales et impact de l'actualitéMunicipales et impact de l'actualité
Municipales et impact de l'actualité
LCP Assemblée nationale
 
แม่สี
แม่สี แม่สี
แม่สี sjrschool
 
Workshop Biomimicry: Introduction - CFI
Workshop Biomimicry: Introduction - CFIWorkshop Biomimicry: Introduction - CFI
Workshop Biomimicry: Introduction - CFI
Karim Network
 
Sesión 13 edurel quinto sec.
Sesión 13 edurel quinto sec.Sesión 13 edurel quinto sec.
Sesión 13 edurel quinto sec.
Carlos Enrique Espinoza Caceres
 
Lbmg l'hotel & le nomade
Lbmg   l'hotel & le nomadeLbmg   l'hotel & le nomade
Lbmg l'hotel & le nomadeoni121
 
137490867 langue-francaise-lecture-courante-cp-ce1-elocution-et-vocabulaire-p...
137490867 langue-francaise-lecture-courante-cp-ce1-elocution-et-vocabulaire-p...137490867 langue-francaise-lecture-courante-cp-ce1-elocution-et-vocabulaire-p...
137490867 langue-francaise-lecture-courante-cp-ce1-elocution-et-vocabulaire-p...Ettaoufik Elayedi
 
Manual bosch campana a pared dwb06 d650
Manual bosch   campana a pared dwb06 d650Manual bosch   campana a pared dwb06 d650
Manual bosch campana a pared dwb06 d650
Alsako Electrodomésticos
 
iMA final
iMA finaliMA final
iMA final
Cornelia Laros
 
Manual Balay - campana 3 bc777p
Manual Balay -  campana 3 bc777pManual Balay -  campana 3 bc777p
Manual Balay - campana 3 bc777p
Alsako Electrodomésticos
 

En vedette (20)

Exemple après la voyance complete
Exemple après la voyance completeExemple après la voyance complete
Exemple après la voyance complete
 
Inscription linkedin
Inscription linkedinInscription linkedin
Inscription linkedin
 
Bureaux portables sur clé USB
Bureaux portables sur clé USBBureaux portables sur clé USB
Bureaux portables sur clé USB
 
Modelo de negocio indra dzoara muñoz
Modelo de negocio indra dzoara muñozModelo de negocio indra dzoara muñoz
Modelo de negocio indra dzoara muñoz
 
Trabajo etica
Trabajo eticaTrabajo etica
Trabajo etica
 
La publicité
La publicité La publicité
La publicité
 
Manual bosch frigorifico kdn32 x10
Manual bosch   frigorifico kdn32 x10Manual bosch   frigorifico kdn32 x10
Manual bosch frigorifico kdn32 x10
 
Tournoi de poker ADCO GROUPd_2011
Tournoi de poker ADCO GROUPd_2011Tournoi de poker ADCO GROUPd_2011
Tournoi de poker ADCO GROUPd_2011
 
Kitmobilisation climat 21 pdf
Kitmobilisation climat 21 pdfKitmobilisation climat 21 pdf
Kitmobilisation climat 21 pdf
 
Exposé version finale
Exposé version finaleExposé version finale
Exposé version finale
 
Municipales et impact de l'actualité
Municipales et impact de l'actualitéMunicipales et impact de l'actualité
Municipales et impact de l'actualité
 
Greselle
GreselleGreselle
Greselle
 
แม่สี
แม่สี แม่สี
แม่สี
 
Workshop Biomimicry: Introduction - CFI
Workshop Biomimicry: Introduction - CFIWorkshop Biomimicry: Introduction - CFI
Workshop Biomimicry: Introduction - CFI
 
Sesión 13 edurel quinto sec.
Sesión 13 edurel quinto sec.Sesión 13 edurel quinto sec.
Sesión 13 edurel quinto sec.
 
Lbmg l'hotel & le nomade
Lbmg   l'hotel & le nomadeLbmg   l'hotel & le nomade
Lbmg l'hotel & le nomade
 
137490867 langue-francaise-lecture-courante-cp-ce1-elocution-et-vocabulaire-p...
137490867 langue-francaise-lecture-courante-cp-ce1-elocution-et-vocabulaire-p...137490867 langue-francaise-lecture-courante-cp-ce1-elocution-et-vocabulaire-p...
137490867 langue-francaise-lecture-courante-cp-ce1-elocution-et-vocabulaire-p...
 
Manual bosch campana a pared dwb06 d650
Manual bosch   campana a pared dwb06 d650Manual bosch   campana a pared dwb06 d650
Manual bosch campana a pared dwb06 d650
 
iMA final
iMA finaliMA final
iMA final
 
Manual Balay - campana 3 bc777p
Manual Balay -  campana 3 bc777pManual Balay -  campana 3 bc777p
Manual Balay - campana 3 bc777p
 

Similaire à Soap sur sugar_crm_pour_developpement_connecteurs_v1.0

Analyse d'un WebShell trouvé sur un serveur Web
Analyse d'un WebShell trouvé sur un serveur WebAnalyse d'un WebShell trouvé sur un serveur Web
Analyse d'un WebShell trouvé sur un serveur Web
Ba-Consultants
 
Ssl et certification electronique - (construction de certification)
Ssl et certification electronique  - (construction de certification)Ssl et certification electronique  - (construction de certification)
Ssl et certification electronique - (construction de certification)
achraf_ing
 
Weos création d'une dmz
Weos création d'une dmzWeos création d'une dmz
Weos création d'une dmz
Fabian Vandendyck
 
08 04 mise en place d'un serveur mandataire (proxy)
08 04 mise en place d'un serveur mandataire (proxy)08 04 mise en place d'un serveur mandataire (proxy)
08 04 mise en place d'un serveur mandataire (proxy)
Noël
 
PHP et PHP Framework
PHP et PHP FrameworkPHP et PHP Framework
PHP et PHP Framework
Jérémie Campari
 
Gestion des LOGS savec syslog+loganalyzer
Gestion des LOGS savec syslog+loganalyzerGestion des LOGS savec syslog+loganalyzer
Gestion des LOGS savec syslog+loganalyzer
Mohamet Lamine DIOP
 
alphorm.com - Formation Configuration Exchange 2010 (70-662)
alphorm.com - Formation Configuration Exchange 2010 (70-662)alphorm.com - Formation Configuration Exchange 2010 (70-662)
alphorm.com - Formation Configuration Exchange 2010 (70-662)
Alphorm
 
Joomla : AcyMailing et ElasticEmail
Joomla : AcyMailing et ElasticEmailJoomla : AcyMailing et ElasticEmail
Joomla : AcyMailing et ElasticEmail
Marc DECHEVRE
 
Serveur sms avec traitement de contenu, avec Gammu
Serveur sms avec traitement de contenu, avec GammuServeur sms avec traitement de contenu, avec Gammu
Serveur sms avec traitement de contenu, avec Gammu
Fabrice Sonzahi
 
Support Web Services SOAP et RESTful Mr YOUSSFI
Support Web Services SOAP et RESTful Mr YOUSSFISupport Web Services SOAP et RESTful Mr YOUSSFI
Support Web Services SOAP et RESTful Mr YOUSSFI
ENSET, Université Hassan II Casablanca
 
Joomla : AcyMailing et ElasticEmail (version 2019)
Joomla : AcyMailing et ElasticEmail (version 2019)Joomla : AcyMailing et ElasticEmail (version 2019)
Joomla : AcyMailing et ElasticEmail (version 2019)
Marc DECHEVRE
 
Weos tunnel ssl hôte à site
Weos   tunnel ssl hôte à siteWeos   tunnel ssl hôte à site
Weos tunnel ssl hôte à site
Fabian Vandendyck
 
Support de cours angular
Support de cours angularSupport de cours angular
Support de cours angular
ENSET, Université Hassan II Casablanca
 
Silverlight 3.MSDays EPITA 11/06/2009
Silverlight 3.MSDays EPITA 11/06/2009Silverlight 3.MSDays EPITA 11/06/2009
Silverlight 3.MSDays EPITA 11/06/2009
Frédéric Queudret
 
Push to the web - Websocket et SignalR
Push to the web -  Websocket et SignalRPush to the web -  Websocket et SignalR
Push to the web - Websocket et SignalR
MSDEVMTL
 
F5 ltm administering big ip v11
F5 ltm administering big ip v11F5 ltm administering big ip v11
F5 ltm administering big ip v11
Amine Haddanou
 
Forensics: Banking Troubles
Forensics: Banking TroublesForensics: Banking Troubles
[Tutoriel] Comment activer le protocole SSL avec Le CMS Joomla ?
[Tutoriel] Comment activer le protocole SSL avec Le CMS Joomla ?[Tutoriel] Comment activer le protocole SSL avec Le CMS Joomla ?
[Tutoriel] Comment activer le protocole SSL avec Le CMS Joomla ?
Sylvie CECI
 

Similaire à Soap sur sugar_crm_pour_developpement_connecteurs_v1.0 (20)

iTunes Stats
iTunes StatsiTunes Stats
iTunes Stats
 
Analyse d'un WebShell trouvé sur un serveur Web
Analyse d'un WebShell trouvé sur un serveur WebAnalyse d'un WebShell trouvé sur un serveur Web
Analyse d'un WebShell trouvé sur un serveur Web
 
Ssl et certification electronique - (construction de certification)
Ssl et certification electronique  - (construction de certification)Ssl et certification electronique  - (construction de certification)
Ssl et certification electronique - (construction de certification)
 
Weos création d'une dmz
Weos création d'une dmzWeos création d'une dmz
Weos création d'une dmz
 
08 04 mise en place d'un serveur mandataire (proxy)
08 04 mise en place d'un serveur mandataire (proxy)08 04 mise en place d'un serveur mandataire (proxy)
08 04 mise en place d'un serveur mandataire (proxy)
 
PHP et PHP Framework
PHP et PHP FrameworkPHP et PHP Framework
PHP et PHP Framework
 
Gestion des LOGS savec syslog+loganalyzer
Gestion des LOGS savec syslog+loganalyzerGestion des LOGS savec syslog+loganalyzer
Gestion des LOGS savec syslog+loganalyzer
 
alphorm.com - Formation Configuration Exchange 2010 (70-662)
alphorm.com - Formation Configuration Exchange 2010 (70-662)alphorm.com - Formation Configuration Exchange 2010 (70-662)
alphorm.com - Formation Configuration Exchange 2010 (70-662)
 
Joomla : AcyMailing et ElasticEmail
Joomla : AcyMailing et ElasticEmailJoomla : AcyMailing et ElasticEmail
Joomla : AcyMailing et ElasticEmail
 
Serveur sms avec traitement de contenu, avec Gammu
Serveur sms avec traitement de contenu, avec GammuServeur sms avec traitement de contenu, avec Gammu
Serveur sms avec traitement de contenu, avec Gammu
 
Support Web Services SOAP et RESTful Mr YOUSSFI
Support Web Services SOAP et RESTful Mr YOUSSFISupport Web Services SOAP et RESTful Mr YOUSSFI
Support Web Services SOAP et RESTful Mr YOUSSFI
 
Joomla : AcyMailing et ElasticEmail (version 2019)
Joomla : AcyMailing et ElasticEmail (version 2019)Joomla : AcyMailing et ElasticEmail (version 2019)
Joomla : AcyMailing et ElasticEmail (version 2019)
 
Weos tunnel ssl hôte à site
Weos   tunnel ssl hôte à siteWeos   tunnel ssl hôte à site
Weos tunnel ssl hôte à site
 
Support de cours angular
Support de cours angularSupport de cours angular
Support de cours angular
 
Silverlight 3.MSDays EPITA 11/06/2009
Silverlight 3.MSDays EPITA 11/06/2009Silverlight 3.MSDays EPITA 11/06/2009
Silverlight 3.MSDays EPITA 11/06/2009
 
Push to the web - Websocket et SignalR
Push to the web -  Websocket et SignalRPush to the web -  Websocket et SignalR
Push to the web - Websocket et SignalR
 
F5 ltm administering big ip v11
F5 ltm administering big ip v11F5 ltm administering big ip v11
F5 ltm administering big ip v11
 
Forensics: Banking Troubles
Forensics: Banking TroublesForensics: Banking Troubles
Forensics: Banking Troubles
 
[Tutoriel] Comment activer le protocole SSL avec Le CMS Joomla ?
[Tutoriel] Comment activer le protocole SSL avec Le CMS Joomla ?[Tutoriel] Comment activer le protocole SSL avec Le CMS Joomla ?
[Tutoriel] Comment activer le protocole SSL avec Le CMS Joomla ?
 
Meetup angular rshop
Meetup angular rshopMeetup angular rshop
Meetup angular rshop
 

Dernier

Le support de présentation des Signaux 2024
Le support de présentation des Signaux 2024Le support de présentation des Signaux 2024
Le support de présentation des Signaux 2024
UNITECBordeaux
 
Le Comptoir OCTO - Équipes infra et prod, ne ratez pas l'embarquement pour l'...
Le Comptoir OCTO - Équipes infra et prod, ne ratez pas l'embarquement pour l'...Le Comptoir OCTO - Équipes infra et prod, ne ratez pas l'embarquement pour l'...
Le Comptoir OCTO - Équipes infra et prod, ne ratez pas l'embarquement pour l'...
OCTO Technology
 
OCTO TALKS : 4 Tech Trends du Software Engineering.pdf
OCTO TALKS : 4 Tech Trends du Software Engineering.pdfOCTO TALKS : 4 Tech Trends du Software Engineering.pdf
OCTO TALKS : 4 Tech Trends du Software Engineering.pdf
OCTO Technology
 
Ouvrez la porte ou prenez un mur (Agile Tour Genève 2024)
Ouvrez la porte ou prenez un mur (Agile Tour Genève 2024)Ouvrez la porte ou prenez un mur (Agile Tour Genève 2024)
Ouvrez la porte ou prenez un mur (Agile Tour Genève 2024)
Laurent Speyser
 
Le Comptoir OCTO - Qu’apporte l’analyse de cycle de vie lors d’un audit d’éco...
Le Comptoir OCTO - Qu’apporte l’analyse de cycle de vie lors d’un audit d’éco...Le Comptoir OCTO - Qu’apporte l’analyse de cycle de vie lors d’un audit d’éco...
Le Comptoir OCTO - Qu’apporte l’analyse de cycle de vie lors d’un audit d’éco...
OCTO Technology
 
De l'IA comme plagiat à la rédaction d'une « charte IA » à l'université
De l'IA comme plagiat à la rédaction d'une « charte IA » à l'universitéDe l'IA comme plagiat à la rédaction d'une « charte IA » à l'université
De l'IA comme plagiat à la rédaction d'une « charte IA » à l'université
Université de Franche-Comté
 

Dernier (6)

Le support de présentation des Signaux 2024
Le support de présentation des Signaux 2024Le support de présentation des Signaux 2024
Le support de présentation des Signaux 2024
 
Le Comptoir OCTO - Équipes infra et prod, ne ratez pas l'embarquement pour l'...
Le Comptoir OCTO - Équipes infra et prod, ne ratez pas l'embarquement pour l'...Le Comptoir OCTO - Équipes infra et prod, ne ratez pas l'embarquement pour l'...
Le Comptoir OCTO - Équipes infra et prod, ne ratez pas l'embarquement pour l'...
 
OCTO TALKS : 4 Tech Trends du Software Engineering.pdf
OCTO TALKS : 4 Tech Trends du Software Engineering.pdfOCTO TALKS : 4 Tech Trends du Software Engineering.pdf
OCTO TALKS : 4 Tech Trends du Software Engineering.pdf
 
Ouvrez la porte ou prenez un mur (Agile Tour Genève 2024)
Ouvrez la porte ou prenez un mur (Agile Tour Genève 2024)Ouvrez la porte ou prenez un mur (Agile Tour Genève 2024)
Ouvrez la porte ou prenez un mur (Agile Tour Genève 2024)
 
Le Comptoir OCTO - Qu’apporte l’analyse de cycle de vie lors d’un audit d’éco...
Le Comptoir OCTO - Qu’apporte l’analyse de cycle de vie lors d’un audit d’éco...Le Comptoir OCTO - Qu’apporte l’analyse de cycle de vie lors d’un audit d’éco...
Le Comptoir OCTO - Qu’apporte l’analyse de cycle de vie lors d’un audit d’éco...
 
De l'IA comme plagiat à la rédaction d'une « charte IA » à l'université
De l'IA comme plagiat à la rédaction d'une « charte IA » à l'universitéDe l'IA comme plagiat à la rédaction d'une « charte IA » à l'université
De l'IA comme plagiat à la rédaction d'une « charte IA » à l'université
 

Soap sur sugar_crm_pour_developpement_connecteurs_v1.0

  • 1. Fonctionnement de SOAP sur SugarCRM pour développer de nouveaux connecteurs 1. Descriptif du document :...................................................................................... 2 2. Pré-requis : .......................................................................................................... 2 3. Vérifier la disponibilité du serveur SugarCRM..................................................... 2 3.1. Soap_test.xml............................................................................................... 2 3.2. Soap_testResponse.xml .............................................................................. 2 4. Identification sur le serveur SugarCRM............................................................... 3 4.1. Soap_login.xml............................................................................................. 3 4.2. Soap_loginResponse.xml............................................................................. 3 5. Récupération de l’identifiant de l’utilisateur ......................................................... 4 5.1. Soap_get_user_id.xml.................................................................................. 4 5.2. Soap_get_user_idResponse.xml.................................................................. 4 6. Listing d’un module trié et filtré............................................................................ 5 6.1. Soap_get_entry_list_Search.xml.................................................................. 5 6.2. Soap_get_entry_listResponse_Search.xml.................................................. 5 7. Exemple des fichiers XML envoyés/reçus ........................................................... 6 8. Que se passe t’il réllement pour les puristes ....................................................... 6 Si vous avez besoin d’aide : ....................................................................................... 8 Liens utiles :................................................................................................................ 8 Sources : .................................................................................................................... 8 20/06/2006 SOAP_sur_SugarCRM_pour_developpement_connecteurs_V1.0.doc page 1 / 8 Toute reproduction, même partielle, tout transfert à un tiers, sous quelque forme que ce soit, sont strictement interdits sans autorisation préalable écrite de SYNOLIA
  • 2. 1. Descriptif du document : Ce document décrit le fonctionnement de la couche SOAP au sein de SugarCRM et permettra aux développeurs de mieux appréhender celle-ci afin de réaliser des connecteurs pour échanger à partir de flux XML. Tout langage peut être utilisé du moment qu’il est capable de réaliser une connexion distante ainsi que de traiter les résultats en XML. Ce document n’a pas pour but d’être exhaustif mais uniquement de présenter quelques fonctions permettant de réaliser une connexion SOAP puis de demander un listing. 2. Pré-requis : · Disposer de SugarCRM installé sur votre machine ou sur un serveur · Disposer d’une classe qui gère le XML tel nuSOAP en PHP est un plus qui facilitera grandement le travail du développeur. 3. Vérifier la disponibilité du serveur SugarCRM 3.1. Soap_test.xml Fichier XML envoyé pour connaître l’état du serveur et ainsi tester sa disponibilité. En paramètre(s) d’entrée : · string : « Server Available » 3.2. Soap_testResponse.xml 20/06/2006 SOAP_sur_SugarCRM_pour_developpement_connecteurs_V1.0.doc page 2 / 8 Toute reproduction, même partielle, tout transfert à un tiers, sous quelque forme que ce soit, sont strictement interdits sans autorisation préalable écrite de SYNOLIA Fichier XML reçu En paramètre(s) de sortie : · return : « Server Available »
  • 3. 20/06/2006 SOAP_sur_SugarCRM_pour_developpement_connecteurs_V1.0.doc page 3 / 8 Toute reproduction, même partielle, tout transfert à un tiers, sous quelque forme que ce soit, sont strictement interdits sans autorisation préalable écrite de SYNOLIA 4. Identification sur le serveur SugarCRM 4.1. Soap_login.xml Fichier XML envoyé pour ouvrir une session sur l’application. En paramètre(s) d’entrée : · user_auth user_name : login utilisateur password : mot de passe utilisateur (MD5) version : .1 · application_name : SugarWap (En fait le nom de votre appli) 4.2. Soap_loginResponse.xml Fichier XML reçu En paramètre(s) de sortie : · id : ID de session
  • 4. 5. Récupération de l’identifiant de l’utilisateur 5.1. Soap_get_user_id.xml Fichier XML envoyé pour récupérer l’ID de l’utilisateur En paramètre(s) d’entrée : · session : ID de session 5.2. Soap_get_user_idResponse.xml 20/06/2006 SOAP_sur_SugarCRM_pour_developpement_connecteurs_V1.0.doc page 4 / 8 Toute reproduction, même partielle, tout transfert à un tiers, sous quelque forme que ce soit, sont strictement interdits sans autorisation préalable écrite de SYNOLIA Fichier XML reçu En paramètre(s) de sortie : · return : ID de l’utilisateur
  • 5. 6. Listing d’un module trié et filtré 6.1. Soap_get_entry_list_Search.xml Fichier XML envoyé pour récupérer une liste d’enregistrement pour un module donné En paramètre(s) d’entrée : · session : ID de session · module_name : Nom du module (contacts) · query : Condition « where » de la requête que Sugar va opérer sur la base · order_by : Champ « order by » de la requête pour trier les résultats · offset : Correspond au « LIMIT x, 10 » du SQL · select_fields item : Champs à retourner · max_results : Nombre max d’enregistrements à retourner · deleted : enregistrements supprimés à retourner 0 ou 1 6.2. Soap_get_entry_listResponse_Search.xml 20/06/2006 SOAP_sur_SugarCRM_pour_developpement_connecteurs_V1.0.doc page 5 / 8 Toute reproduction, même partielle, tout transfert à un tiers, sous quelque forme que ce soit, sont strictement interdits sans autorisation préalable écrite de SYNOLIA Fichier XML reçu En paramètre(s) de sortie : · Les paramètres de sortie sont dépendants de ce que vous avez demandé en entrée
  • 6. 7. Exemple des fichiers XML envoyés/reçus 20/06/2006 SOAP_sur_SugarCRM_pour_developpement_connecteurs_V1.0.doc page 6 / 8 Toute reproduction, même partielle, tout transfert à un tiers, sous quelque forme que ce soit, sont strictement interdits sans autorisation préalable écrite de SYNOLIA
  • 7. Si vous avez besoin de ces fichiers d’exemple vous pouvez contacter Synolia directement ou faire une demande sur le forum CRM-France.com. 8. Que se passe t’il réllement pour les puristes Vous pouvez tester en telnet sur le port 80 afin de mieux visualiser l’échange de données.
  • 8. 20/06/2006 SOAP_sur_SugarCRM_pour_developpement_connecteurs_V1.0.doc page 7 / 8 Toute reproduction, même partielle, tout transfert à un tiers, sous quelque forme que ce soit, sont strictement interdits sans autorisation préalable écrite de SYNOLIA Contenu XML envoyé :
  • 9. ! #
  • 10. $% '( )*$++
  • 16. *
  • 18. ,* +-'./017,!-'888 888$+ * +-'* *!$+,* +- !* 9'* -'888-'./017,!-'./01/)- En premier lieu il y a donc connexion au serveur, puis nous précisons qu’il s’agit de la méthode POST sur l'url /soap.php du serveur et en HTTP 1.1. Les normes du protocole http demandent alors de préciser au moins un host, la taille du contenu qui suit, et le charset (type de codage des caractères). Contenu XML reçu : 4: ; ,=6 !484?6 ).
  • 20. $% '( )*$++
  • 26. *
  • 29. *
  • 30. ,D!* On peut voir qu’il y a bien eu réponse à la demande de test de connexion. La réponse se fait en HTTP 1.1, le code 200 indique que le serveur web (Apache) n’a rencontré aucun problème pour le traitement de cette demande, quelques infos supplémentaires sont données et surtout la taille en octet de la réponse, ainsi que le charset. La connexion se ferme au bout d'une seconde d'inactivité car nous sommes sur un protocole http donc déconnecté.
  • 31. Si vous avez besoin d’aide : Le site CRM-France et le forum sont là pour vous aider : http://www.crm-france.com Liens utiles : Le site de SugarCRM : http://www.sugarcrm.com Le site de Synolia : http://www.synolia.com Qu’est ce que SOAP : http://www.soapuser.com/fr/basics1.html 20/06/2006 SOAP_sur_SugarCRM_pour_developpement_connecteurs_V1.0.doc page 8 / 8 Toute reproduction, même partielle, tout transfert à un tiers, sous quelque forme que ce soit, sont strictement interdits sans autorisation préalable écrite de SYNOLIA Sources : SYNOLIA, premier partenaire européen de SugarCRM et membre de l’équipe de développement SugarCRM, fournit des solutions CRM et e-business pour tous types d’entreprises. SYNOLIA accompagne les clients SugarCRM, quelque soit la version choisie, dans les phases de mise en place, développements de modules, formations (SYNOLIA est déclaré organisme de formation), maintenance... et propose également des solutions d'hébergement de SugarCRM. SYNOLIA accompagne déjà de nombreux clients SugarCRM en France et en Europe francophone. SYNOLIA a été fondé en 2004 par des professionnels du CRM et de l’ebusiness. La société a son siège à Lyon (France) et peut être jointe par mail à sugar@synolia.com ou par le biais de ses sites Internet http://www.synolia.com, http://ww.crm-france.com (site de la communauté SugarCRM en France) et http://www.businesshop.com.