OSF Integrator pour. Demandware et Microsoft Dynamics CRM 2013

Transcription

1 OSF Integrator pour Demandware et Microsoft Dynamics CRM 2013 Guide d Intégration Page 1

2 Table des Matières 1. Résumé Aperçu des Composants Aperçu des Fonctionnalités Composants d Intégration Cas d emploi Compatibilité Guide de mise en œuvre Cartouche Demandware Mise en Place Configuration Solution Microsoft Dynamics CRM Mise en Place Enregistrement Testing Roles de Sécurité Désinstallation de la solution CRM Operations, Maintenance Historique des Versions Page 2

3 1. Résumé OSF Integrator pour Demandware et Microsoft Dynamics CRM 2013 est un plugin qui permet la synchronisation automatique dans Microsoft Dynamics CRM des données et commandes clients en provenance de la plateforme Demandware Commerce. Auditoire visé Ce document est destiné au personnel technique chargé de mettre en place le plugin et de synchroniser les plateformes Microsoft Dynamics CRM et Demandware e- commerce. 2. Aperçu des Composants 2.1 Aperçu des Fonctionnalités Cet outil d intégration permet aux utilisateurs : De voir les enregistrements clients directement dans Microsoft Dynamics CRM De voir les commandes directement dans Microsoft Dynamics CRM D accéder, dans Microsoft Dynamics CRM, à des rapports et à des vues customisées D analyser en ligne l activité clients 2.2 Composants d Intégration Pour pouvoir utiliser le plugin il faut obligatoirement installer et configurer deux solutions, chacune sur sa plateforme spécifique (Demandware et Microsoft Dynamics CRM): 1. La cartouche Demandware 2. Microsoft Dynamics CRM managed solution Page 3

4 La cartouche Demandware est à téléchargeable partir du site : 6655 Blvd. Pierre Bertrand, Office 240 OSF Integrator : La solution Microsoft Dynamics CRM est téléchargeable à partir du site OSF Integrator en accédant à l URL suivant et en complétant fa fiche de souscription : Après s être enregistré via notre site l utilisateur recevra un fournissant : Une clé de licence unique et un identifiant de l organisation ; ils permettent d utiliser la version d essai Un lien pout télécharger «CRM managed solution» et un lien pour télécharger la cartouche Demandware Un lien pour télécharger le Guide d Intégration et un lien pour télécharger le Guide de l Utilisateur Page 4

5 2.3 Cas d emploi Importation de Demandware vers Microsoft Dynamics CRM 2013 d enregistrements nouvellement créés (clients ou commandes). Importation de Demandware vers Microsoft Dynamics CRM 2013 d enregistrements existants qui ont été modifiés (clients ou commandes). 2.4 Compatibilité Basée et testée sur Demandware version 13.1 et Microsoft Dynamics CRM Guide de mise en œuvre 3.1 Cartouche Demandware Cette cartouche permet aux sites en ligne utilisant Demandware d utiliser le plugin Demandware vers CRM. Après avoir installé la cartouche l utilisateur devra configurer certains paramètres dans Demandware pour que l intégration puisse fonctionner. Le connecteur d intégration Dynamics possède la cartouche principale suivante : - int_osfintegrator_connector Cette cartouche a des pipelines qui peuvent être invoqués pour obtenir la liste des commandes et celle des clients se en Place Importez la cartouche int_osfintegrator_connector dans Demandware, en vous servant d un client FTP (par exemple bitkinex). Page 5

6 1. Ouvrir le client FTP Bitkinex 2. Clic droit sur Http/WebDAV new Http/WebDAV 3. Insérer l adresse de votre organisation Demandware organization (par exemple test.dw.demandware.net), puis Enter 4. Insérer l adresse du serveur (test.dw.demandware.net), sélectionner security https, ajouter username et password (de votre compte Demandware); presser OK 5. Clic droir sur http/webnav Browse Yes 6. Clic droit sur / directory Change directory insert /on/demandware.servlet/webdav/sites/cartridges/version1/ 7. Chercher le repertoire int_osfintegrator_connector sur votre ordinateur et le copier sur le serveur Importer les Préférences propres au site dans Demandware Business Manager 1. Connectez-vous à Demandware Business Manager 2. Cliquez sur Administration Sites development Import & Export 3. Cliquez sur Upload 4. Cherchez meta_data_osfintegrator _connector.zip cliquez Upload 5. Cliquez sur l icone <<Back au bas de la page 6. Cliquez Import 7. Selectionnez meta_data_osfintegrator_connector.zip dans la liste s affichant en dessous 8. Cliquez Next 9. Lorsque la validation est terminée, cliquez Next Les attributs suivants seront ajoutés (par les données méta) aux objets Système : Order Page 6

7 osfintegratorid (String) osfintegratoridlastmodified (Date+Time) Profile osfintegratorid (String) osfintegratoridlastmodified (Date+Time) Les attributs suivants seront ajoutés (par les données méta) à l objet Système SitePreferences et deviendront ainsi disponibles dans les préférences propres au site : OSFIntegratorConnectorUser (String) OSFIntegratorConnectorPassword (String) Joindre int_osfintegrator_connector à l Effective Cartridge Path Après avoir importé la cartouche int_osfintegrator_connector dans votre espace de travail et l avoir chargée dans votre exemplaire Demandware, vous devrez ajouter int_osfintegrator_connector au chemin de recherche de la cartouche pour chacun des sites qui doit se servir de l intégrateur de connexion Demandware vers Dynamics. 1. Cliquer Administration Sites Manage Sites 2. Sélectionner le site dans la liste 3. Cliquer sur le signet Settings 4. Rajouter :int_osfintegrator_connector à la fin de chaque chemin, après une double point de séparation 5. Cliquer Apply Par exemple, si le chemin de recherche de la cartouche est: app_storefront_example, alors cette étape le changera en : app_storefront_example:int_osfintegrator_connector Page 7

8 3.1.2 Configuration Accréditations Pour mettre en place la cartouche d intégration du connecteur Dynamics il faut fournir le nom d utilisateur et le mot de passe dont Dynamics se servira comme accréditations pour authentifier les demandes. 1. Dans Business Manager, aller sur Site Site Preferences Custom Preferences OSFIntegratorConnector 2. Fournir nom d utilisateur OSFIntegrator et mot de passe OSFIntegrator 3. Cliquer sur Apply 4. Ces paramètres doivent également être mis en place dans la page de configuration de Microsoft Dynamics CRM prenez connaissance du chapitre 3.2 Microsoft Dynamics CRM 2013 solution L image ci-dessous montre les préférences spécifiques du site telles qu elles apparaissent dans Demandware Business Manager: Page 8

9 3.2 Solution Microsoft Dynamics CRM 2013 Le plugin OSF Integrator pour Demandware et Microsoft Dynamics CRM 2013 peut être installé sur les deux versions de Dynamics CRM : - la version sur site - la version on-line (y inclus la version Microsoft Dynamics CRM On-line intégrée avec Office 365) se en Place La première étape pour installer dans Microsoft Dynamics CRM 2013 une solution gérée par MD consiste à localiser le fichier à installer, à le télécharger et à le placer sur votre ordinateur. Connectez-vous à votre session Microsoft Dynamics CRM 2013 en tant qu Administrateur Système, ou en tant que Customiseur Système (ceci requiert que vous disposiez des privilèges administratifs). Allez sur Settings > Solutions et cliquez sur Import. Page 9

10 La fenêtre qui s ouvrira vous permettra d apercevoir la solution que vous souhaitez importer. Sélectionnez ce fichier et cliquez sur Next. Page 10

11 Si vous le souhaitez, vous pourrez examiner les composants et attributs du package en cliquant sur View solution package details Page 11

12 Dans la fenêtre suivante, cochez la case Activate all Processes (CECI EST IMPORTANT CAR SINON LA SOLUTION NE S EXECUTERA PAS CORRECTEMENT) puis cliquez sur Next. Page 12

13 Une barre de progression verte vous montrera l avancement du processus d importation, voir l illustration ci-dessous : Page 13

14 Dès la fin de l importation, un écran résumera les composants de la solution tel qu illustré dans la capture d écran "Successful Import Dialog" ci-dessous. Le bandeau jaune du haut indique que l importation s est déroulée avec succès. Cliquer sur Close. Ce processus peut demander plusieurs minutes, soyez patient et veuillez attendre jusqu à ce qu il se termine. Page 14

15 3.2.2 Enregistrement L étape suivante consiste à mettre en place les accréditations pour OSF Integrator, pour Demandware et pour Microsoft Dynamics CRM Pour le faire, allez sur l écran Settings / OSF Demandware Integrator / Configuration et complétez tous les champs pour tous les signets : Page 15

16 1.Clé de licence et identifiant de l organisation ils vous ont été fournis dans l accompagnant les liens pour télécharger la solution. Important : ne manquez pas de prendre connaissance de la fonction d Importation Initiale qui vous permettra de transférer les données déjà existantes. Pour en savoir plus, consultez le document OSF Initial Import. 2.Accréditations Demandware elles permettent de se connecter à son compte Demandware 3.Accréditations Dynamics CRM 2013 credentials elles permettent de se connecter à son compte Microsoft Dynamics Le type de compte Microsoft Dynamics CRM utilisé constitue un autre aspect important. Si vous utilisez la version Microsoft Dynamics CRM Online intégrée avec Office 365, vous devrez cocher l option appropriée comme cela est montré ci-dessous : Page 16

17 Cliquez sur Edit puis, pour chaque signet : complétez tous les champs ; ensuite cliquez sur Save. Patientez jusqu à ce que toutes les informations soient vérifiées et validées. Page 17

18 3.3 Testing Pour vérifier si OSF Integrator pour Demandware et Microsoft Dynamics CRM s est bien installé et fonctionne correctement, veuillez suivre les étapes suivantes : 1. Allez sur l écran Settings / Customization / OSF Demandware Integrator / Activity Log 2. Vérifiez si une tâche de synchronisation (Sync Task) s est exécutée (si oui, Finish date affichera une date) 3. Après qu une tache de synchronisation se soit exécutée, les données clients et les commandes doivent se trouver dans Dynamics CRM 4. Pour voir les derniers clients qui ont été synchronisés, allez sur Sales / Accounts / New DW Accounts created in the last 24 hours 5. La liste des clients créés au cours des 24 dernières heures sera affichée 6. Pour vérifier les commandes, allez sur Sales / Orders / New DW SO s created in the last 24 hours 7. La liste des commandes des dernières 24 heures sera affichée 8. Ces listes sont également visibles sur le tableau de bord de Demandware, pour les voir allez sur Workplace / Dashboards / DW Dashboard. Page 18

19 9. Vous pouvez également vérifier chaque compte client et chaque commande pour confirmer si les données qui ont été synchronisées dans Dynamics CRM sont bien identiques à celles se trouvant dans DW 3.4 Roles de Sécurité Pour pouvoir accéder à OSF Integrator pour Demandware et Microsoft Dynamics CRM 2013 les utilisateurs il faut que le rôle de sécurité de Demandware e- Commerce ait été assigné à leur compte Microsoft Dynamics. Les Administrateurs Système se chargeront de cette opération (Settings / System / Administration / Users). Il existe deux rôles de sécurité: - Demandware ecommerce Integration Administrator - Demandware ecommerce Integration User Page 19

20 3.5 Désinstallation de la solution CRM Pour désinstaller le plugin, veuillez suivre les étapes suivantes: 1. Dans Microsoft Dynamics CRM 2013, allez sur le signet Settings 2. Sélectionnez Solutions 3. Dans la liste Solutions, sélectionnez la solution OSF Integrator for Demandware and Microsoft Dynamics CRM 2013 et cliquez sur Delete 4. Confirmez votre choix et le plugin sera désinstallé du système Page 20

21 4. Operations, Maintenance Support Le support peut être joint par sur 5. Historique des Versions No de Version Date Description March 2013 Version Initiale Page 21