Guide d'intégration à Salesforce.com. Version 5.5

Transcription

1 Guide d'intégration à Salesforce.com Version 5.5

2 2013 Pitney Bowes Software Inc. Tous droits réservés. Ce document peut contenir des informations confidentielles et exclusives appartenant à Pitney Bowes Inc et/ou ses filiales et sociétés associées. Portrait Software, le logo Portrait Software, Portrait, et la marque Portrait de Portrait Software sont des marques déposées de Portrait Software International Limited et ne peuvent être utilisées ou exploitées de quelque manière que ce soit sans l'accord exprès, préalable et écrit de Portrait Software International Limited. Marques déposées Tous les autres noms de produits, noms de société, marques, logos et symboles mentionnés ci-après peuvent être des marques ou des marques déposées de leurs propriétaires respectifs. Assistance Portrait Software Si vous avez besoin d'aide concernant un sujet qui n'est pas couvert par cette documentation, essayez notre Base de Connaissance sur notre site Internet et suivez le lien vers votre produit. Vous pouvez également télécharger d'autres documents d'informations Portrait Software à partir de notre site. Si vous ne possédez pas de nom d'utilisateur ou de mot de passe, ou si vous les avez oubliés, nous vous prions de nous contacter par l'un des moyens énoncés ci-dessous. Si vous rencontrez un problème lors de l'utilisation, de l'installation ou avec la documentation de ce produit, veuillez nous contacter en utilisant l'une des méthodes suivantes : Courriel : support@portraitsoftware.com Téléphone USA/Canada (numéro gratuit) Reste du monde Lorsque vous nous signalez un problème, il nous est utile de connaître : Le nom du logiciel Les circonstances dans lesquelles le problème est survenu Les messages d'erreur que vous avez vus (s'il y en a eu) La version du logiciel que vous étiez en train d'utiliser Pitney Bowes Software Inc. June 13, 2013

3 Table des matières Chapitre 1 : Introduction...5 But...6 Public visé...6 Documentation liée...6 Chapitre 2 : Présentation...7 Présentation de Salesforce.com/Interaction Optimizer...8 Chapitre 3 : Intégration d'interaction Optimizer à Salesforce.com...11 Prérequis...12 Limitations...12 Considérations sur le Web Service Interaction Optimizer...13 Nécessité de l'intercepteur...14 Instructions relatives à l'intercepteur...16 Client d'interaction Optimizer Salesforce.com...18 Composants VisualForce...19 Contrôleurs de composants...19 Proxy Entity Wrapper pour recommandation...20 Pages Apex VisualForce...21 Extension de contrôleur VisualForce...21 Téléchargement et installation de l'échantillon de code...22 Mise à jour des classes proxy...22 Gestion des réponses aux recommandations...23 Chapitre 4 : Annexe...25 Fragments XSLT...26 InlineXsdInWsdlBehavior.cs code...27 Composants Salesforce.com...29

4 Code Apex Portrait IO 5.5

5 Chapitre 1 Introduction Dans cette section : But Public visé Documentation liée

6 But But Ce document explique comment intégrer Portrait Interaction Optimizer (Interaction Optimizer) à Salesforce.com. Ce document identifie les contraintes d'utilisation du Web Service Interaction Optimizer au sein de Salesforce.com et explique comment contourner ces limitations. Public visé Ce document est destiné aux développeurs de Salesforce.com qui souhaitent intégrer à Salesforce des recommandations en temps réel destinées aux clients et provenant d'interaction Optimizer. Documentation liée Document Support d'installation (zip/dvd) et emplacement Guide d'administration de Portrait Interaction Optimizer Dans le support d'installation de Portrait Interaction Optimizer : \Documentation\Portrait Interaction Optimizer Administration Guide.pdf Notes de publication de Portrait Interaction Optimizer Dans le support d'installation de Portrait Interaction Optimizer : \Documentation\Interaction Optimizer-release-notes.pdf Conseil : Tous les documents sont également disponibles sur le site Internet d'assistance de Portrait Software : 6 Portrait IO 5.5

7 Chapitre 2 Présentation Dans cette section : Présentation de Salesforce.com/Interaction Optimizer..8

8 Présentation de Salesforce.com/Interaction Optimizer Présentation de Salesforce.com/Interaction Optimizer Salesforce.com est une solution SaaS d'automatisation des forces de vente dotée de fonctions de vente, de service et d'aide, supportées par un modèle de données standard, mais extensible, comprenant des comptes, des contacts et des opportunités. Salesforce.com dispose de son propre environnement de développement d'applications (Apex), qui peut être utilisé pour créer de nouvelles applications au sein de Salesforce.com et également pour élargir des fonctionnalités existantes en intégrant des systèmes tiers (tels qu'interaction Optimizer), via un Web Service. Le client Salesforce.com pour Interaction Optimizer est doté des éléments suivants : une interface de Web Service Apex pour Interaction Optimizer, qui inclut des données sous forme de contenu Salesforce.com configurable ainsi que des champs de compte par défaut, qui sont mappés dans la demande Interaction Optimizer pour les recommandations ; une extension du Contact Controller Salesforce.com qui permet d'afficher les recommandations Interaction Optimizer grâce à un échantillon de code de page VisualForce. Cela permet d'afficher les recommandations et de collecter les retours positifs, négatifs ou non affichés. 8 Portrait IO 5.5

9 Chapitre 2 : Présentation Guide d'intégration à Salesforce.com 9

10

11 Chapitre 3 Intégration d'interaction Optimizer à Salesforce.com Dans cette section : Prérequis Limitations Considérations sur le Web Service Interaction Optimizer Nécessité de l'intercepteur Instructions relatives à l'intercepteur Client d'interaction Optimizer Salesforce.com

12 Prérequis Prérequis Prérequis pour intégrer une instance d'interaction Optimizer à Salesforce.com : Une instance Salesforce.com qui utilise des affichages Contact pour les interactions. Une instance d'interaction Optimizer publiquement adressable via Internet. Des compétences en administration d'interaction Optimizer, notamment le Web Service Interaction Optimizer, comme indiqué dans le guide d'administration d'interaction Optimizer. Des compétences en développement Apex (le langage de développement de la plateforme Force.com). Des compétences en développement.net/wcf pour créer un intercepteur qui effectue la translation des messages entre Salesforce.com et le Web Service Interaction Optimizer. Remarque : en fonction de la base utilisée pour la création de l'intercepteur, il est possible de choisir d'autres plateformes de développement comme Java. Limitations La plateforme de développement Force.com présente quelques limitations en matière d'utilisation du Web Service SOAP (c'est notamment le cas avec le Web Service Interaction Optimizer). Elle ne peut analyser un SOAP WSDL contenant les éléments suivants : Wsdl:import Xsd:import Xsd:attribute Xsd:extension Xsd:enumeration Xsd:anyType Les réactions de Force.com à ces éléments sont variables. Pour certains (par ex. wsdl:import, xsd:import ou xsd:attribute), la plateforme affiche un message d'erreur et ne peut pas analyser le WSDL. Pour les éléments xsd:extension, Force.com génère des classes, mais uniquement avec des éléments correspondant au type dérivé, comme dans l'exemple ci-dessous : <xsd:complextype name="getactionsresponse"> <xsd:complexcontent mixed="false"> <xsd:extension base="tns:iowebserviceresponse"> <xsd:sequence> <xsd:element minoccurs="0" name="output" nillable="true" type="tns:getactionsoutput"/> </xsd:sequence> </xsd:extension> </xsd:complexcontent> </xsd:complextype> 12 Portrait IO 5.5

13 Chapitre 3 : Intégration d'interaction Optimizer à Salesforce.com Ces types sont générés du fait de hiérarchies d'héritage de classes.net au sein d'interaction Optimizer. Ici, le type complexe GetActionsResponse est dérivé de IOWebServiceResponse. Force.com génère des classes à la fois pour IOWebServiceResponse et GetActionsResponse, mais la classe Apex analysée pour GetActionsResponse ne contient aucun membre de la classe de base IOWebServiceResponse. Cela empêche l'analyse, au moment de l'exécution, du message xml dans lequel l'élément GetActionsResponse contient des membres du type de base IOWebServiceResponse. S'il y a un membre «Foo» dans IOWebServiceResponse, l'exécution de Force.com entraîne un message d'erreur could not find Apex type for name>/foo. Cela est dû au fait que la plateforme cherche un membre Foo dans la classe GetActionsResponse générée, alors qu'il n'y en a pas. Pour les éléments xsd:enumeration, Force.com génère des éléments avec leurs types xsd sous-jacents. Intéressons-nous par exemple à l'élément suivant : <xsd:element name="refdata.marketingcampaigncategory" nillable="true" type="tns:refdata.marketingcampaigncategory"/> Dans ce cas, le type RefData.MarketingCampaginCategory est défini de la façon suivante : <xsd:simpletype name="refdata.marketingcampaigncategory"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="gatherinformation"/> <xsd:enumeration value="retain"/> <xsd:enumeration value="sell"/> <xsd:enumeration value="service"/> </xsd:restriction> </xsd:simpletype> Ici, Force.com analyse l'élément de type string (le type xsd sous-jacent dans le présent exemple). Considérations sur le Web Service Interaction Optimizer Bien que certaines limitations de Force.com puissent être contournées par le Web Service Interaction Optimizer, cela n est pas le cas pour d autres. Activation de la génération de WSDL simple dans Interaction Optimizer Le Web Service Interaction Optimizer peut être généré (par un outil appelé ServiceMaker) pour créer un WSDL qui ne contient aucune instruction wsdl:import ou xsd:import, c'est-à-dire que le WSDL tout entier est généré sous la forme d'un seul document. Pour cela, il faut activer l'option Avoid import statements in WSDL (dans l assistant ServiceMaker) ou en utilisant l'option /FlatWsdl (lors de l'utilisation de l'utilitaire de ligne de commande ServiceMaker). Bien que ce ne soit pas obligatoirement nécessaire, l'activation de cette option facilite l'écriture de l'intercepteur, en cas d'utilisation de ce dernier (voir plus bas dans le document). Espaces de noms et hiérarchies de types Guide d'intégration à Salesforce.com 13

14 Nécessité de l'intercepteur Le Web Service Interaction Optimizer génère un WSDL hiérarchique qui contient des éléments xsd:extension (voir explication ci-dessus) ne pouvant être analysés par Force.com. Il n'existe actuellement aucune option pour cela dans l'outil ServiceMaker. Il est possible de modifier cela en utilisant un xslt, mais ces types appartiennent souvent à des espaces de noms différents. Ainsi, on obtient des éléments xml qui ont des espaces de noms multiples, rendant toute analyse par Salesforce au moment de l'exécution impossible. Prenons par exemple l'élément suivant, issu d'un message xml (les messages de ce type peuvent être générés par le Web Service Interaction Optimizer, puisqu'il y a des hiérarchies) : <ExecuteWSTestResult xmlns:i=" <CompletionString xmlns=" Completed</CompletionString> <Outcome xmlns=" <Suspension xmlns= xmlns:a=" <a:contextdata>context</a:contextdata> <a:resumeid>resume</a:resumeid> <a:serialisationstrategy>strategy</a:serialisationstrategy> </Suspension> <Output> <MyString>Hello world</mystring> </Output> </ExecuteWSTestResult> Attardons-nous sur l'élément CompletionString. C'est une chaîne, mais l'élément contient une déclaration d'espace de noms par défaut pour l'espace de noms " Cela s'explique par le fait que cet élément est défini dans l un des types de base (appelé Response) de l'élément ExecuteWSTestResult, qui appartient à l'espace de noms xml " Nécessité de l'intercepteur Comme les capacités de Force.com sont limitées en matière d'analyse WSDL (comme indiqué dans la section précédente), il est impossible d'utiliser le Web Service Interaction Optimizer tel quel, à partir de Salesforce.com. Il existe plusieurs solutions alternatives : Il est possible d'utiliser le Web Service Interaction Optimizer en générant et en analysant les messages xml à l'aide de l'api native d'analyse DOM d'apex. Bien qu'envisageable, cette solution n'est pas la plus adaptée, puisqu'elle est basée sur une manipulation impliquant des chaînes de bas niveau et l'analyse du contenu xml. De plus, ce code ne peut pas être réutilisé sur plusieurs installations d'interaction Optimizer (dont les types de données peuvent varier en fonction des modèles utilisés, des personnalisations effectuées et des options sélectionnées pour la génération du service via le ServiceMaker). Il est également possible de créer un service d'intercepteur placé entre Salesforce.com et le Web Service Interaction Optimizer, et qui effectue la translation, dans les deux sens, des messages échangés entre les deux systèmes. 14 Portrait IO 5.5

15 Chapitre 3 : Intégration d'interaction Optimizer à Salesforce.com Bien que le code utilisé pour l'intercepteur ne soit pas non plus réutilisable sur plusieurs installations d'interaction Optimizer (puisque les sources de données de décision sont variables), cette solution est plus appropriée que l'analyse DOM xml basée sur des chaînes brutes. Un tel service d'intercepteur doit être hébergé et exposé via un point d'extrémité publiquement accessible (mais sécurisé) avec lequel Salesforce peut communiquer. Parmi les solutions susmentionnées pour l'intégration de Salesforce.com et d'interaction Optimizer, nous recommandons d'utiliser l'intercepteur en tant qu'approche intérimaire (jusqu'à ce que d'autres options soient prises en charge par les versions futures d'interaction Optimizer). Avantages Il n'est pas nécessaire d'analyser les DOM xml bruts. En ce qui concerne Salesforce, il faut simplement utiliser le service d'intercepteur qui fournit un WSDL que Salesforce peut comprendre. Cet intercepteur peut être créé à l'aide de n'importe quelle technologie standard capable d'analyser le WSDL actuellement exposé par le Web Service Interaction Optimizer (par ex..net/wcf, Java, etc.). Limitations Le code de l'intercepteur ne peut être générique pour toutes les installations d'interaction Optimizer, car les types exposés par le service Interaction Optimizer peuvent varier, tout comme les types exposés par l'intercepteur. La création d'un tel intercepteur nécessite de connaître une plateforme technologique autre que Force.com. Ce type de ressources peut ne pas être disponible dans certaines équipes informatiques d'entreprises ayant une installation Salesforce.com. Dans ce cas, la création de l'intercepteur peut éventuellement être prise en charge par l'équipe des services professionnels PBBI, qui assiste nos clients lors de la configuration, de l'installation et de la personnalisation de produits PBBI. Le service d'intercepteur et le service Interaction Optimizer réel peuvent être hébergés sur le même serveur ou sur des serveurs séparés. Les deux solutions sont possibles, à partir du moment où l'intercepteur est exposé via un point d'extrémité publiquement accessible (mais sécurisé), avec lequel Salesforce peut communiquer. Le schéma suivant détaille l'un des scénarios de déploiement possibles. Guide d'intégration à Salesforce.com 15

16 Instructions relatives à l'intercepteur Instructions relatives à l'intercepteur En écrivant un service WCF d'intercepteur, vous devez suivre certaines instructions pour vous assurer que le service est compatible avec Salesforce.com et que Salesforce.com peut y accéder. Quadrillage Le type d'intercepteur doit exposer tous les types exposés par le Web Service Interaction Optimizer sous une forme simplifiée (c'est-à-dire que si Interaction Optimizer expose un type GetActionsResponse, qui à son tour est dérivé de IOWebServiceResponse, alors l'intercepteur doit supprimer la relation d'héritage entre ces deux types dans le WSDL/contrat qu'il expose, répliquer tous les membres de IOWebServiceResponse dans GetActionsResponse et les traiter comme deux classes distinctes). Cela permet de garantir qu'il n'y a pas d'éléments xsd:extension dans le WSDL que Salesforce ne peut analyser. Tous les types ainsi simplifiés doivent appartenir à un seul espace de noms xml (de préférence, celui auquel appartient le type dérivé original). Le WSDL généré ne doit pas comprendre d'éléments xsd:attribute. L'intercepteur doit exposer un WSDL simple (sans éléments xsd:import ou wsdl:import). Voici une méthode pour créer un intercepteur : Elle décrit comment créer un service d'intercepteur en utilisant Windows Communication Foundation et Visual Studio. Cette approche respecte les instructions susmentionnées. Créez un projet de service WCF dans Visual Studio. Ajoutez dans ce projet une référence de service au Web Service Interaction Optimizer. Exportez le WSDL à partir du Web Service Interaction Optimizer (il est possible d'exécuter la commande svcutil.exe /t:metadata <url of the hosted Interaction Optimizer service>) au niveau de l'invite de commande pour effectuer cette tâche. Créez un xslt qui : simplifie toutes les hiérarchies de types ; 16 Portrait IO 5.5

17 Chapitre 3 : Intégration d'interaction Optimizer à Salesforce.com supprime tous les éléments xsd:attribute (c'est possible, car les xsd:attributes qui sont actuellement générés par Interaction Optimizer, ne sont utilisés dans aucune de ces opérations exposées) ; correspond à l'exemple de xslt se trouvant dans l'annexe. Utilisez ce WSDL transformé (généré à l'étape précédente) pour créer un ensemble de classes proxy (il est possible d'exécuter la commande svcutil.exe /o:<filename> /l:cs /n:<string,string><the name of the transformed WSDL file> - veuillez noter que l'option /n facilite le mappage des espaces de noms cible xsd/wsdl sur les espaces de noms clr dans le code et qu'il est possible de s'en servir pour mapper des types sur un seul espace de noms homogène). Ajoutez ce fichier (avec les classes générées) au projet de service WCF qui a été créé pour l'intercepteur. Ouvrez le fichier dans Visual Studio et changez les espaces de noms xml des types générés pour qu'ils soient différents de ceux utilisés par Interaction Optimizer. Regroupez tous les types générés sous un seul espace de noms clr (en incluant les interfaces et les classes de service). Recherchez le code de l'interface IIOWebService et supprimez toutes les opérations indésirables. Assurez-vous qu'il soit doté d'un ServiceContract et que ses opérations soient dotées d'une modalité OperationContract (cela devrait déjà être le cas, puisque la génération a été effectuée à l'aide de l'utilitaire svcutil). Supprimez l'interface IIOWebServiceChannel. Renommez la classe IOWebServiceClient avec un nom pertinent dans le contexte, par ex. IOWebServiceAdapter (elle servira de classe d'implémentation pour le service d'intercepteur et transfèrera les appels au Web Service Interaction Optimizer réel). Dotez la classe IOWebServiceAdapter d'une modalité ServiceBehavior et définissez, pour la propriété NameSpace de cette modalité, le même espace de noms xml que celui de l'interface IIOWebService. Écrivez la logique de translation pour transformer les types de Web Service Interaction Optimizer en types définis par l'intercepteur et vice-versa. Créez un élément d'extension de comportement qui expose un WSDL simple (c'est-à-dire sans éléments wsdl:import ou xsd:import) à partir de l'intercepteur le code associé se trouve dans l'annexe B. Ajoutez le code de cette classe au projet d'intercepteur. Construisez le projet pour vous assurer que tout se compile comme prévu. Hébergez le service d'intercepteur WCF sur un point accessible publiquement (par ex. en tant que service IIS hébergé sur la machine virtuelle d'un cloud). Si possible, ce service doit être situé au même endroit que le Web Service Interaction Optimizer. Ouvrez le fichier Web.Config du service hébergé et ajoutez la section suivante sous <system.servicemodel> : <extensions> <behaviorextensions> <add name="wsdlflatteningextension" type="messagetranslator.extensions.inlinexsdinwsdlbehavior, MessageTranslator.Extensions"/> </behaviorextensions> </extensions> Guide d'intégration à Salesforce.com 17

18 Client d'interaction Optimizer Salesforce.com Sous la section des comportements (créez-en une s'il n'y en a pas), dans <system.servicemodel>, ajoutez la section suivante : <behaviors> <endpointbehaviors> <behavior name="wsdlflatteningbehavior"> <WSDLFlatteningExtension/> </behavior> </endpointbehaviors> <servicebehaviors> <behavior name="servicebehavior"> <servicemetadata httpgetenabled="true"/> </behavior> </servicebehaviors> </behaviors> Créez la section des services comme suit : <services> <service name="<serviceimplementationclassname>" behaviorconfiguration="servicebehavior"> <endpoint address="test" binding="basichttpbinding" contract="<servicecontractinterfacename>" bindingnamespace=<bindingnamespace> behaviorconfiguration="wsdlflatteningbehavior"/> </service> </services> Assurez-vous que la valeur du bindingnamespace saisie dans la section ci-dessus est identique à celle saisie pour l'interface de contrat de service et la classe d'implémentation de service, c'est-à-dire que ces trois éléments doivent avoir la même valeur d'espace de noms (c'est essentiel pour que le service d'intercepteur expose un seul document WSDL). Essayez d'atteindre le fichier.svc pour ce service dans un navigateur et assurez-vous que la page de description de service s'affiche sans erreur. Cliquez sur le lien du WSDL de ce service (le lien de la page de description de service doit se terminer par?wsdl) et assurez-vous que le WSDL s'affiche correctement (sur certains navigateurs, comme IE 9, le fait de cliquer sur le lien peut directement entraîner l'ouverture d'une boîte de dialogue de téléchargement de fichier pour enregistrer le WSDL). Copiez/téléchargez le WSDL et enregistrez le fichier sur un système de fichiers locaux c'est ce WSDL qui doit être chargé dans Salesforce.com pour générer les proxies Apex). Client d'interaction Optimizer Salesforce.com Cette section présente (à l'aide d'échantillons de pages et de composants de Salesforce), les éléments de haut niveau qu'il faut créer en tant que partie d'une interface client au sein de Salesforce.com pour utiliser le Web Service d'intercepteur Interaction Optimizer (que nous appellerons à partir de maintenant service Interaction Optimizer) et afficher les recommandations au sein d'une page VisualForce. Pour cela, nous nous basons sur un échantillon de code qui peut être téléchargé à l'adresse suivante : 18 Portrait IO 5.5

19 Chapitre 3 : Intégration d'interaction Optimizer à Salesforce.com Vous trouverez dans l'annexe un schéma des classes illustrant les relations entre les différents composants Salesforce. A un haut niveau, il est nécessaire de créer les éléments suivants : Composants VisualForce RecommendationForSObject.component. Sert d'interface avec l'objet Salesforce actuel en contexte. Expose une modalité pour définir l'objet Salesforce actuel en contexte. Est généralement ajouté en tant que composant dans n'importe quelle page Salesforce standard/personnalisée (par ex. Contact, Compte, etc.). RecommendationComponent.component. Fournit l'interface utilisateur pour afficher et enregistrer les réponses aux recommandations provenant d'interaction Optimizer et s'affichant dans des pages Salesforce. Est généralement ajouté en tant que composant dans n'importe quelle page Salesforce standard/personnalisée (par ex. Contact, Compte, etc.). Cette approche nous permet de réutiliser la logique et l'interface utilisateur pour afficher les recommandations sur n'importe quelle page Salesforce et pas uniquement les contacts. Ce composant définit les méthodes et champs appropriés sur son contrôleur associé et accède à ces derniers pour transmettre/récupérer des données (par ex. les recommandations réelles). Contrôleurs de composants RecommendationForSObject.cls Contrôleur pour le composant RecommendationForSObject.component Fournit des champs et des accesseurs pour interroger et définir l'objet Salesforce actuel en contexte (Contact, Compte, etc.). RecommendationComponentCtlr.cls Contrôleur pour le composant RecommendationComponent.component Expose les champs et méthodes appelés à partir du composant RecommendationComponent.component pour récupérer les recommandations et enregistrer la réponse à une recommandation. Les données (entrées) requises par ces méthodes sont transmises via la définition de propriétés publiques exposées par le contrôleur. Ces méthodes confient la logique pour obtenir des recommandations ou enregistrer des réponses pour une classe d'aide IOHelper qui agit comme une surcouche pour appeler le service d'intercepteur Interaction Optimizer (comme expliqué dans la section précédente) à l'aide de classes proxy Apex (il y a dans l'annexe D un exemple de code montrant comment obtenir des recommandations et enregistrer une réponse à l une des recommandations renvoyées en appelant le service). Définit et expose une classe publique imbriquée RecommendationsWrapper qui agit uniquement en objet de transfert de données pour transmettre des recommandations au composant RecommendationComponent.component. Guide d'intégration à Salesforce.com 19

20 Proxy Entity Wrapper pour recommandation Interagit avec la classe RecommendationForSObject pour accéder à l'objet Salesforce actuel. La méthode retrieverecommendations de cette classe utilise les informations de l'objet Salesforce actuel (auquel on accède à partir de la classe RecommendationForSObject) afin de remplir les paramètres requis pour appeler la méthode GetActions du proxy du service d'intercepteur Interaction Optimizer sous-jacent. Cette méthode entraîne l'ajout des recommandations renvoyées à une liste d'instances RecommendationsWrapper à laquelle accède le composant RecommendationComponent.component pour se lier à l'interface utilisateur. Alors que la plupart des informations obligatoires pour obtenir des recommandations sont transmises dans le paramètre de requête, les données qui commandent le filtrage des invites renvoyées sont transmises dans le contexte supplémentaire. Il est possible d'accéder aux recommandations avec l'interface utilisateur des composants comme indiqué ci-dessous : <apex:panelbar items="!recommendations" var="a"> <apex:panelbaritem label="!a.campaignclass -!a.linktext"> <table> <tr> <td>!a.contenthtml</td> <td><button onclick="">accept</button> <button onclick="">refuse</button> <button onclick="">not Presented</button> </td> </tr> </table> </apex:panelbaritem> </apex:panelbar> Remarque : Ici, a fait référence à une instance de RecommendationsWrapper et on accède aux informations requises via ses propriétés publiques. La capture d'écran ci-dessous présente une recommandation développée : Proxy Entity Wrapper pour recommandation RecommendationsWrapper.cls C'est un simple objet de transfert de données utilisé pour lier les recommandations à l'interface utilisateur Salesforce. Agit comme une classe enveloppante pour la classe IOWebService_Action sous-jacente, exposée par le service d'intercepteur Interaction Optimizer. Expose une interface plus simple que IOWebService_Action avec des membres pertinents pour l'interface utilisateur Salesforce (par ex. propriétés du texte d'invite, classe de campagne, etc.). 20 Portrait IO 5.5

21 Chapitre 3 : Intégration d'interaction Optimizer à Salesforce.com Pages Apex VisualForce Recommendations.page Est utilisée pour afficher les recommandations. Est incluse dans d'autres présentations d'objets standard (par ex. Contact). Doit être créée pour chaque page standard où des recommandations doivent être affichées. Contient les composants RecommendationComponent.component et RecommendationForSObject.component. Définit la modalité SFDCObject du composant RecommendationForSObject avec l'objet SFDC associé de la page dont il fait partie. Le code de page VisualForce pour les recommandations (pour la page Contact standard) ressemble à cela : <apex:page standardcontroller="contact" extensions="recommendationcontactcntrlr" id="page1"> <apex:form id="frm1" > <c: RecomentationComponent SFDCObject="!Objcontact" /> </apex:form> </apex:page> Rendu de la page lorsqu'elle fait partie de la présentation de la page Contact Extension de contrôleur VisualForce Pour chaque page VisualForce où des recommandations doivent être affichées, il faut créer une extension de contrôleur. RecommendationContactCtrlr.cls Extension pour le Contact Controller standard Guide d'intégration à Salesforce.com 21

22 Téléchargement et installation de l'échantillon de code Le code pour une telle extension de contrôleur peut ressembler à cela : public with sharing class RecommendationContactCntrlr Contact objcontact; public RecommendationContactCntrlr (ApexPages.StandardController stdcontroller) objcontact=(contact)stdcontroller.getrecord(); public RecommendationContactCntrlr () public Contact getobjcontact() return this.objcontact; Téléchargement et installation de l'échantillon de code Cette section décrit les étapes à suivre pour télécharger l'échantillon de code dans une organisation Salesforce existante. 1. Ouvrez une fenêtre de navigateur et tapez l'url du progiciel non géré : dans la barre d'adresse. 2. Sur la page de connexion, entrez les détails de l'organisation Salesforce où le progiciel doit être téléchargé. 3. Après la connexion, suivez les instructions de téléchargement et acceptez les paramètres par défaut, jusqu'à l'invite d'installation du progiciel. 4. Installez le progiciel. 5. Allez dans Setup -> Customize -> Contacts -> Page Layouts. 6. Cliquez sur le bouton Page Layout Assignment. 7. Sur la page d'attribution de présentation, cliquez sur le bouton Edit Assignment. 8. Cliquez sur la ligne du profil pour lequel la section des recommandations doit être ajoutée à la présentation (la ligne doit être surlignée). 9. Sélectionnez Contact Layout for Interaction Optimizer dans la liste déroulante Page Layout to Use. 10. Cela devrait permettre d'appliquer la présentation. 11. Pour afficher toutes les recommandations applicables, ouvrez n'importe quel contact. Mise à jour des classes proxy Bien que le progiciel offre un point de départ pour le code d'intégration qui inclut les classes proxy Apex nécessaires pour appeler le service d'intercepteur Interaction Optimizer, on peut souhaiter, dans certains cas, régénérer ces dernières après l'installation du progiciel (par ex. quand le WSDL ou le service d'intercepteur change suite à une reconfiguration ou à un changement de version d'interaction Optimizer). Voici les étapes à suivre pour modifier le code concerné, utilisant les classes proxy : 22 Portrait IO 5.5

23 Chapitre 3 : Intégration d'interaction Optimizer à Salesforce.com 1. Chargez le WSDL mis à jour dans Salesforce (dans l'organisation, allez dans Setup/Develop/Apex Classes et cliquez sur le bouton Generate from WSDL, naviguez jusqu'au document WSDL et cliquez sur le bouton Parse WSDL. Une fois le processus terminé, cliquez sur Done.). 2. Retournez à Setup/Develop/Apex Classes et recherchez la classe appelée IOHelper (vous pouvez effectuer la recherche en cliquant sur le lien du chemin de navigation pour l'alphabet de départ du nom de la classe) et cliquer sur le lien Edit. 3. Modifiez le code de la classe pour qu'il corresponde entièrement aux classes proxy récemment générées. 4. Cliquez sur le bouton Save. Cela devrait permettre d'enregistrer le code sans erreur. 5. Testez les proxies récemment chargés en ouvrant une page Contact et en vous assurant que les recommandations sont renvoyées par Interaction Optimizer. Gestion des réponses aux recommandations Différentes réponses peuvent être enregistrées pour une recommandation récupérée à partir d'interaction Optimizer. Les options possibles varient en fonction de la configuration d'interaction Optimizer. Voici des exemples de valeurs possibles (disponibles dans l'installation par défaut d'interaction Optimizer) : Application CaptureLead Refusal TryAgainLater Certaines des options (par ex. Application) sont traitées comme des réponses positives, d'autres (par ex. Refusal) comme des réponses négatives et encore d'autres (par ex. TryAgainLater) comme des réponses neutres. L'échantillon de code fourni dans ce document utilise la valeur Application (on peut utiliser toute autre réponse positive) pour indiquer l'acceptation ou Refusal pour indiquer le rejet d'une recommandation. Dans tous les cas, la recommandation n'est pas renvoyée par Interaction Optimizer pour la liste ultérieure de recommandations requises pour le même contact (par ex. identifiant externe). Pour enregistrer toute autre réponse, le code Salesforce doit transmettre la valeur de réponse appropriée (voir la liste des réponses à une recommandation prises en charge pour la configuration d'interaction Optimizer déployée). Remarque : à l'avenir, si l'analyseur WSDL Salesforce prend en charge l'énumération, ces valeurs pourront faire partie du proxy Apex généré pour éliminer la possibilité d'erreurs de validation. Guide d'intégration à Salesforce.com 23

24

25 Chapitre 4 Annexe Dans cette section : Fragments XSLT InlineXsdInWsdlBehavior.cs code Composants Salesforce.com Code Apex

26 Fragments XSLT Fragments XSLT Fragment Xslt pour simplifier les types xsd : <?xml version="1.0" encoding="utf-8"?> <xsl:stylesheet version="1.0" xmlns:xsl=" xmlns:wsdl=" xmlns:xsd=" xmlns:xs=" xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"> <xsl:output method="xml" indent="yes"/> <xsl:template match="@* node()"> <xsl:copy> <xsl:apply-templates select="@* node()"/> </xsl:copy> </xsl:template> <!--Remove xsd:attribute elements--> <xsl:template match="//xsd:attribute"/> <!--Replace hierarchical xsd (xsd:extension) types with flattened ones--> <xsl:template match="//xsd:complextype[xsd:complexcontent[xsd:extension[@base]]]"> <xsl:element name=" name()"> <xsl:copy-of select="@*"/> <xsl:element name="xsd:sequence"> <xsl:call-template name="flattenelement"> <xsl:with-param name="element" select="." /> </xsl:call-template> </xsl:element> </xsl:element> </xsl:template> <xsl:template name="flattenelement"> <xsl:param name="element" /> <xsl:for-each select="$element"> <xsl:if test="./xsd:complexcontent/xsd:extension[@base]"> <xsl:variable name ="baseelementname "select="substring-after(.//xsd:extension/@base,':')" /> <xsl:call-template name="flattenelement"> <xsl:with-param name="element "select="//xsd:complextype[@name=$baseelementname]"/> </xsl:call-template> </xsl:if> <xsl:apply-templates select="descendant::*[name()='xsd:sequence']/child::*" /> </xsl:for-each> </xsl:template> </xsl:stylesheet> 26 Portrait IO 5.5

27 Chapitre 4 : Annexe InlineXsdInWsdlBehavior.cs code Code pour InlineXsdInWsdlBehavior.cs: using System; using System.Collections.Generic; using System.Linq; using System.Web.Services.Description; using WsdlDescription = System.Web.Services.Description.ServiceDescription; using System.ServiceModel.Description; using System.Xml.Schema; using System.ServiceModel.Configuration; namespace MessageTranslator.Extensions public class InlineXsdInWsdlBehavior : BehaviorExtensionElement, IWsdlExportExtension, IEndpointBehavior public void ExportContract(WsdlExporter exporter, WsdlContractConversionContext context) //Not Req public void ExportEndpoint(WsdlExporter exporter, WsdlEndpointConversionContext context) var schemaset=exporter.generatedxmlschemas; exporter.generatedwsdldocuments.cast< WsdlDescription >().ToList().ForEach(wsdl => var importslist = new List<XmlSchema>(); wsdl.types.schemas.cast< XmlSchema >().ToList().ForEach(schema => AddImportedSchemas(schema, schemaset, importslist); ); wsdl.types.schemas.clear(); importslist.foreach(schema => RemoveXsdImports(schema); wsdl.types.schemas.add(schema); ); ); private void RemoveXsdImports(XmlSchema schema) for ( var i = 0; i < schema.includes.count; i++) if (schema.includes[i] is XmlSchemaImport) schema.includes.removeat(i--); private void AddImportedSchemas(XmlSchema schema, Guide d'intégration à Salesforce.com 27

28 InlineXsdInWsdlBehavior.cs code XmlSchemaSet schemaset, List <XmlSchema> importslist) schema.includes.cast< XmlSchemaImport >().ToList().ForEach(import => schemaset.schemas(import.namespace).cast<xmlschema>().tolist().foreach(ixsd => if (!importslist.contains(ixsd)) ); importslist.add(ixsd); AddImportedSchemas(ixsd, schemaset, importslist); ); public void AddBindingParameters(ServiceEndpoint endpoint, System.ServiceModel.Channels.BindingParameterCollection bindingparameters) //Not Req public void ApplyClientBehavior(ServiceEndpoint endpoint, System.ServiceModel.Dispatcher. ClientRuntime clientruntime) //Not Req public void ApplyDispatchBehavior(ServiceEndpoint endpoint, System.ServiceModel.Dispatcher. EndpointDispatcher endpointdispatcher) //Not Req public void Validate(ServiceEndpoint endpoint) //Not Req public override Type BehaviorType get return typeof(inlinexsdinwsdlbehavior); protected override object CreateBehavior() return new InlineXsdInWsdlBehavior (); 28 Portrait IO 5.5

29 Chapitre 4 : Annexe Composants Salesforce.com Schéma de classes représentant les composants Salesforce : Code Apex Échantillon de code Apex pour obtenir des recommandations et enregistrer la réponse à l une des recommandations renvoyées : ProxyServiceClient proxy = new IOProxyServiceClient(); //Get recommendations GetActionsResponse getactionsresp = proxy.getactions(state, additionalcontext, getactionsrequest); //Record response for a recommendation Actions actions = getactionsresp.output.getactionsresponse.actions; IOWebService_Action action1 = actions.get(0); IOWebService_RecordActionResponseRequest actionresp = Guide d'intégration à Salesforce.com 29

30 Code Apex new IOWebService_RecordActionResponseRequest(); //Set its ActionDeliveryId to the same value as that of the returned recommendation (i.e. action1 in this case) actionresp.setactiondeliveryid(action1.actiondeliveryid); actionresp.setresponsetype(refdatamarketingcampaignresponsetype.tryagainlater); //Set other required attributes of actionresp object.. RecordActionResponseResponse resp = proxy.recordactionresponse(state, actionresp); 30 Portrait IO 5.5