Mise à niveau de l’intégration intégrée de OneSpan Sign pour le CRM

Amélioration

Si vous souhaitez mettre à niveau une installation existante de OneSpan Sign Embedded Integration for CRM, un administrateur de déploiement Dynamics CRM doit effectuer les procédures suivantes :

1. Mise à jour de la solution gérée

2. Updating the Dashboard & Reports

3. Mise à jour du service de notification

4. Mise à jour des paramètres du compte

Lorsque vous mettez à niveau le connecteur, assurez-vous qu’aucun utilisateur CRM n’utilise Dynamics CRM.

Mise à jour de la solution gérée

Une solution gérée est une solution complète destinée à être distribuée et installée.

Pour mettre à jour votre solution gérée :

1. En procédant comme suit, assurez-vous que le service de notification de OneSpan Sign est en cours d’exécution et qu’il a traité toutes les notifications :

   1. Sur le serveur CRM, ouvrez SQL Server Management Studio.

   2. Connectez-vous et développez les bases de données à partir de l’Explorateur d’objets.

   3. Cliquez avec le bouton droit de la souris sur la base de données créée lors de l’installation SQL (par exemple, esignlive).

   4. Exécutez la requête suivante :

      select * from EslNotifications where Processed is null

      1. Si la colonne Processed contient NULL, vous devez attendre jusqu’à ce que : (1) toutes les entrées soient traitées et mises à jour vers 1 par le service Windows ; (2) Il n’y a pas d’autres inscriptions.

      2. Exécutez à nouveau la requête ci-dessus. S’il n’y a pas de lignes, cela signifie que toutes les lignes ont été traitées.

2. Arrêtez le service de notification eSignLive. Cliquez sur Démarrer > Outils d’administration > Services.

3. En procédant comme suit, importez la nouvelle solution OneSpan Sign Embedded Integration for CRM :

   1. Connectez-vous à Dynamics CRM en tant qu’utilisateur disposant de privilèges d’administrateur.

   2. Dans le menu supérieur de Dynamics CRM, sélectionnez Paramètres > Solutions.

   3. Dans la grille Solutions , cliquez sur Importer.

   4. Dynamics CRM vous demandera l’emplacement du package de solution. Cliquez sur Parcourir, puis sélectionnez le package de solution fourni (par exemple, ESLConnector_1_0_0_X_managed.zip).

4. Cliquez sur Suivant pour afficher des informations sur la solution. Dynamics CRM indiquera que la nouvelle solution contient une mise à jour pour la solution actuellement installée.

5. Assurez-vous que : (i) l’option Gérer les personnalisations (recommandée) est activée ; (ii) vous avez sélectionné les étapes de traitement des messages du SDK incluses dans la solution.

6. Cliquez sur Suivant. La solution sera importée et une page récapitulative apparaîtra. Il se peut que vous receviez un message d’avertissement qui peut être ignoré en toute sécurité. Ce message indique que lors de l’importation de la solution, les étapes de message du SDK ont été désactivées, puis activées.

7. Cliquez sur Fermer.

8. Cliquez sur Publier toutes les personnalisations à partir de toutes les solutions, puis rechargez la page. Vous devez voir que la solution gérée porte le numéro de version de votre mise à jour de solution.

Mise à jour du tableau de bord et des rapports

Pour mettre à jour le tableau de bord et les rapports :

1. Sauvegardez le fichier web.config, qui se trouve dans le répertoire où vous avez installé le package Tableau de bord et Rapports .

2. Arrêtez le site IIS associé au tableau de bord et aux rapports.

3. Extrayez le nouveau 7z fichier et remplacez tous les fichiers Tableau de bord et Rapports.

4. Mettez à jour le nouveau web.config fichier à l’aide des informations de la sauvegarde que vous avez effectuée à l’étape 1. En cas de doute, reportez-vous à la section Installation du tableau de bord.

5. Redémarrez le site IIS.

Mise à jour du service de notification

Pour mettre à jour le service de notification :

1. Sauvegardez le fichier eSignLive.comESLNotifcationService.exe.config, qui se trouve dans le répertoire où vous avez installé le package du service de notification .

2. Ouvrez une invite de commande Windows, sélectionnez Exécuter en tant qu’administrateur et accédez au dossier Service de notification .

3. Exécutez la commande suivante : eSignLive.comESLNotificationService.exe -uninstall.

4. À partir du fichier extrait 7z , remplacez tous les fichiers du service de notification.

5. Mettez à jour le nouveau eSignLive.comESLNotifcationService.exe.config fichier à l’aide de la sauvegarde que vous avez effectuée à l’étape 1. En cas de doute, reportez-vous à la section Installation du service de notification.

   Au cours de ce processus, vous avez la possibilité de configurer un intervalle de temps pour la mise à jour du service de notification.

6. Exécutez la commande suivante : eSignLive.comESLNotificationService.exe -install.

7. Ouvrez l’outil de gestion des services Windows (Démarrer > Outils d’administration > Services) et confirmez que le service de notification OneSpan Sign est présent.

8. Démarrez le service de notification OneSpan Sign.

9. Ouvrez l’Observateur d’événements Windows (Démarrer > Outils d’administration > Observateur d’événements) et vérifiez qu’un nouveau journal des événements appelé eSignLive.comEventLog a été créé sous le groupe Journaux des applications et des services .

10. Accédez à , eSignLive.comEventLogpuis confirmez l’enregistrement d’un événement indiquant que le service a été démarré.

Mise à jour des paramètres du compte

Pour mettre à jour les paramètres du compte :

1. Dans Dynamics CRM, accédez à Compte OneSpan Sign.

2. Sélectionnez le compte OneSpan Sign que vous avez créé, puis cliquez sur Modifier. La page Compte OneSpan Sign : Informations s’ouvre.

3. Mettez à jour l’URL de l’hôte de téléchargement de documents avec le site (y compris le port) qui héberge le tableau de bord et les rapports, tel que vous l’avez configuré dans IIS.

   

Amélioration

Si vous souhaitez mettre à niveau une installation existante de OneSpan Sign Embedded Integration for CRM, un administrateur de déploiement Dynamics CRM doit effectuer les procédures suivantes :

1. Updating the Managed Solution

2. Updating the Dashboard & Reports

3. Updating the Notification Service

4. Updating the Account Settings

Lorsque vous mettez à niveau le connecteur, assurez-vous qu’aucun utilisateur CRM n’utilise Dynamics CRM.

Mise à jour de la solution gérée

Une solution gérée est une solution complète destinée à être distribuée et installée.

Pour mettre à jour votre solution gérée :

1. En procédant comme suit, assurez-vous que le service de notification de OneSpan Sign est en cours d’exécution et qu’il a traité toutes les notifications :

   1. Sur le serveur CRM, ouvrez SQL Server Management Studio.

   2. Connectez-vous et développez les bases de données à partir de l’Explorateur d’objets.

   3. Cliquez avec le bouton droit de la souris sur la base de données créée lors de l’installation SQL (par exemple, esignlive).

   4. Exécutez la requête suivante :

      select * from EslNotifications where Processed is null

      1. Si la colonne Processed contient NULL, vous devez attendre jusqu’à ce que : (1) toutes les entrées soient traitées et mises à jour vers 1 par le service Windows ; (2) Il n’y a pas d’autres inscriptions.

      2. Exécutez à nouveau la requête ci-dessus. S’il n’y a pas de lignes, cela signifie que toutes les lignes ont été traitées.

2. Arrêtez le service de notification eSignLive. Cliquez sur Démarrer > Outils > services d’administration.

3. En procédant comme suit, importez la nouvelle solution OneSpan Sign Embedded Integration for CRM.

   1. Connectez-vous à Dynamics CRM en tant qu’utilisateur disposant de privilèges d’administrateur.

   2. Dans le menu supérieur de Dynamics CRM, sélectionnez Paramètres > Solutions.

   3. Dans la grille Solutions , cliquez sur Importer.

   4. Dynamics CRM vous demandera l’emplacement du package de solution. Cliquez sur Parcourir, puis sélectionnez le package de solution fourni (par exemple, ESLConnector_1_0_0_X_managed.zip).

4. Cliquez sur Suivant pour afficher des informations sur la solution. Dynamics CRM indiquera que la nouvelle solution contient une mise à jour pour la solution actuellement installée.

5. Assurez-vous que : (i) l’option Gérer les personnalisations (recommandée) est activée ; (ii) vous avez sélectionné les étapes de traitement des messages du SDK incluses dans la solution.

6. Cliquez sur Suivant. La solution sera importée et une page récapitulative apparaîtra. Il se peut que vous receviez un message d’avertissement qui peut être ignoré en toute sécurité. Ce message indique que lors de l’importation de la solution, les étapes de message du SDK ont été désactivées, puis activées.

7. Cliquez sur Fermer.

8. Cliquez sur Publier toutes les personnalisations à partir de toutes les solutions, puis rechargez la page. Vous devez voir que la solution gérée porte le numéro de version de votre mise à jour de solution.

Mise à jour du tableau de bord et des rapports

Pour mettre à jour le tableau de bord et les rapports :

1. Sauvegardez le fichier web.config, qui se trouve dans le répertoire où vous avez installé le package Tableau de bord et Rapports .

2. Arrêtez le site IIS associé au tableau de bord et aux rapports.

3. Extrayez le nouveau 7z fichier et remplacez tous les fichiers Tableau de bord et Rapports.

4. Mettez à jour le nouveau web.config fichier à l’aide des informations de la sauvegarde que vous avez effectuée à l’étape 1. En cas de doute, reportez-vous à la section Installation du tableau de bord.

5. Redémarrez le site IIS.

Mise à jour du service de notification

Pour mettre à jour le service de notification :

1. Sauvegardez le fichier eSignLive.comESLNotifcationService.exe.config, qui se trouve dans le répertoire où vous avez installé le package du service de notification .

2. Ouvrez une invite de commande Windows, sélectionnez Exécuter en tant qu’administrateur et accédez au dossier Service de notification .

3. Exécutez la commande suivante : eSignLive.comESLNotificationService.exe -uninstall

4. À partir du fichier extrait 7z , remplacez tous les fichiers du service de notification.

5. Mettez à jour le nouveau eSignLive.comESLNotifcationService.exe.config fichier à l’aide des informations de la sauvegarde que vous avez effectuée à l’étape 1. En cas de doute, reportez-vous à la section Installation du service de notification.

   Au cours de ce processus, vous avez la possibilité de configurer un intervalle de temps pour la mise à jour du service de notification.

6. Exécutez la commande suivante : eSignLive.comESLNotificationService.exe -install.

7. Ouvrez l’outil de gestion des services Windows (Démarrer > Outils d’administration > Services) et confirmez que le service de notification OneSpan Sign est présent.

8. Démarrez le service de notification OneSpan Sign.

9. Ouvrez l’Observateur d’événements Windows (Démarrer > Outils d’administration > Observateur d’événements) et vérifiez qu’un nouveau journal des événements a été créé eSignLive.comEventLog sous le groupe Journaux des applications et des services .

10. Accédez à , eSignLive.comEventLogpuis confirmez l’enregistrement d’un événement indiquant que le service a été démarré.

Mise à jour des paramètres du compte

Pour mettre à jour les paramètres du compte :

1. Dans Dynamics CRM, accédez au compte OneSpan Sign.

2. Sélectionnez le compte OneSpan Sign que vous avez créé, puis cliquez sur Modifier. La page Compte OneSpan Sign : Informations s’ouvre.

3. Mettez à jour l’URL de l’hôte de téléchargement de documents avec le site (y compris le port) qui héberge le tableau de bord et les rapports, tel que vous l’avez configuré dans IIS.

   

Amélioration

Cette section n’est pertinente que si vous disposez d’un déploiement sur site de OneSpan Sign Embedded Integration for CRM.

Si vous souhaitez mettre à niveau une version 1.1 installée de OneSpan Sign Embedded Integration for CRM vers la version 2.1, un administrateur OneSpan Sign Embedded Integration for CRM doit effectuer séquentiellement les procédures suivantes :

• Importation de la nouvelle solution

• Spécification des paramètres du compte

• Finalisation de la mise à niveau

• Réinstallation du service de notification push

Importation de la nouvelle solution

Pour importer la nouvelle solution :

1. Connectez-vous à l’intégration intégrée de OneSpan Sign pour CRM en tant qu’utilisateur disposant de privilèges d’administrateur.

2. Dans le menu supérieur, sélectionnez Intégration intégrée de OneSpan Sign pour les paramètres > solutions de > CRM.

3. Dans la grille Solutions , cliquez sur Importer. Vous êtes invité à indiquer l’emplacement du package de solution.

4. Cliquez sur Parcourir, puis sélectionnez le package de solution fourni - par exemple, Télécharger l’intégration intégrée OneSpan Sign pour CRM v2.1 Release Candidate (package de solution).

5. Cliquez sur Suivant pour afficher les informations sur la solution. L’intégration intégrée de OneSpan Sign pour CRM indiquera qu’il existe une mise à jour pour la solution actuellement installée.

6. Assurez-vous que : (i) l’option Gérer les personnalisations (recommandée) est activée ; (ii) vous avez sélectionné les étapes de traitement des messages du SDK incluses dans la solution.

7. Cliquez sur Suivant. La solution est importée et une page de résumé s’affiche. Un message d’avertissement peut s’afficher et peut être ignoré en toute sécurité. Le message indique que lors de l’importation de la solution, les étapes de message du SDK ont été désactivées, puis activées.

8. Cliquez sur Fermer.

9. Dans Toutes les solutions, cliquez sur Publier toutes les personnalisations.

10. Rechargez la page. La solution devrait maintenant être la version mise à jour (par exemple, 2.1.1.2).

Spécification des paramètres du compte

Pour informer OneSpan Sign Embedded Integration for CRM au sujet de votre compte OneSpan Sign :

1. Accédez à l’intégration intégrée de OneSpan Sign pour le CRM > compte OneSpan Sign.

2. Sélectionnez votre compte OneSpan Sign. La page Compte OneSpan Sign : Informations s’affiche.

   

3. Spécifiez tous les paramètres de manière appropriée. Pour plus d’informations, reportez-vous à la Specifying Account Information.

Finalisation de la mise à niveau

Pour terminer votre mise à niveau vers la version 2.1 de l’intégration intégrée de OneSpan Sign pour CRM :

1. Installez le fichier eSignLive.com.Crm.UpgradeService.Setup.msid’installation .

   Cela crée un dossier dans C :\Program Files (x86)\eSignLive\eSignLive.com.Crm.UpgradeService.Setup.

   

2. Ouvrez le fichier eSignLive.com.Crm.UpgradeService.exe.configde configuration et mettez à jour les paramètres CrmLocal avec les informations d’identification de l’utilisateur du service OneSpan Sign Embedded Integration for CRM.

   Toutes les variables de l’exemple précédent font référence à l’intégration intégrée de OneSpan Sign pour CRM.

   Par exemple:

   <add name="CrmLocal" connectionString="Url=http://<server>/<organization>; Domain=xxxxxx; Username=xxxxx; Password=xxxx"/>

3. Exécutez le fichier services.msc à partir du menu Démarrer . Sélectionnez ensuite et démarrez le service nommé OneSpan Sign Connector Upgrade Service.

   

4. Exécutez l’Observateur d’événements et vérifiez l’état du service sélectionné (par exemple, il ne doit pas y avoir de messages d’erreur).

   

5. Connectez-vous à l’intégration intégrée de OneSpan Sign pour la gestion de la relation client et vérifiez que les données ont été correctement mises à jour pour les forfaits OneSpan Sign existants. Plus précisément, toutes les valeurs déroulantes Compte et Opportunité doivent être des champs Entité associée ou des champs Enregistrement associé .

Réinstallation du service de notification push

Pour réinstaller le service de notifications push, reportez-vous à la Deploying the Push Notification Service. Votre nouveau service remplacera le précédent service de notification push, mais il utilisera le même port.