Installation de OneSpan Sign for Microsoft Dynamics CRM

Pour installer OneSpan Sign for Microsoft Dynamics CRM 2013 pour la première fois, effectuez successivement les procédures suivantes :

Étape 1 : Importation de la solution

Étape 2 : Configuration du tableau de bord et des rapports

Étape 3 : Configuration des paramètres du connecteur

Étape 4 : Configuration de la langue

Étape 5 : Installation du service de notification pour Dynamics CRM

Étape 1 : Importation de la solution

Pour importer la solution dans OneSpan Sign for Microsoft Dynamics CRM :

Connectez-vous à OneSpan Sign for Microsoft Dynamics CRM en tant qu'utilisateur avec des privilèges d'administrateur.
Dans le menu supérieur, cliquez sur OneSpan Sign for Microsoft Dynamics CRM > Paramètres.

Dans Personnalisation, cliquez sur Solutions.

À partir de Toutes les solutions, cliquez sur Importer.

Dynamics CRM vous invite à indiquer l'emplacement du paquet de solutions. Cliquez sur Parcourir, et sélectionnez le paquet de solutions ESLConnector_1_0_0_X_managed.zip.

Cliquez sur Suivant pour afficher les informations sur la solution.
Cliquez sur Suivant pour afficher les options d'importation. Cochez la case pour activer tous les processus, puis cliquez sur Suivant. La solution sera importée, et une page de résumé apparaîtra.
Cliquez sur Fermer pour terminer l'installation de la solution.
À partir de Solutions, cliquez sur Publier toutes les personnalisations.

Étape 2 : Configuration du tableau de bord et des rapports

Pour configurer le tableau de bord et le rapport :

Créez un nouveau site nommé ESL Dashboard and Report.
Décompressez le fichier ESL Dashboard and Report.zip.
Indiquez le chemin physique vers le dossier décompressé ci-dessus.

Fournissez un nom d'hôte. Cette mise en correspondance du nom d'hôte avec l'IP du serveur physique doit également être effectuée dans le serveur DNS.
Changez le numéro de port pour le port de votre choix.
Cliquez sur OK.
Dans la boîte de dialogue Modifier le bassin d'applications, effectuez les réglages correspondant à l'écran suivant.

Dans le dossier décompressé, modifiez le fichier Web.config comme suit :

<appSettings>
            <add key="CRMURL" value="http://ServerName/OrganizationName/XRMServices/2011/Organization.svc" />
            <add key="crmuser" value="UserName" />
            <add key="crmpass" value="Password" />
            </appSettings>

Dans Paramètres, allez dans Personnalisations et cliquez sur Personnaliser le système.

Sélectionnez Ressources Web dans le volet de gauche, puis trouvez la ressource Web de type ESL Dashboard ressource Web de type HTML.

Ouvrez-le, et remplacez le nom de l'hôte par le nom du site (où Tableau de bord et des rapports est déployé). Ensuite, enregistrez-le et publiez-le.

Répétez le processus pour la ressource Web du rapport OneSpan Sign.

Étape 3 : Configuration des paramètres du connecteur

Pour configurer les paramètres du connecteur :

Dans l'onglet Paramètres sous Paramètres OneSpan Sign, cliquez sur Compte OneSpan Sign. Une grille affichant les comptes OneSpan Sign apparaît. Sa liste doit initialement être vide.

Dans le ruban, cliquez sur Nouveau pour créer un nouveau compte OneSpan Sign.

Une nouvelle boîte de dialogue apparaît.

Saisissez les informations requises suivantes.
- Nom : Nom de l'élément de configuration
- Courriel : Adresse courriel du propriétaire du compte
- Pour les clients américains qui effectuent un déploiement dans un environnement de production américain et dont l'URL de connexion est https://apps.esignlive.com/login :
  - URL DE L'API :
```
https://apps.esignlive.com/api
```
- URL du concepteur :
```
https://apps.esignlive.com/auth?senderAuthenticationToken={0}&target=https://apps.esignlive.com/designer/{1}?profile=dynamics1.2
```
URL de signature :

https://apps.esignlive.com/auth?signerAuthenticationToken={0}&target=https://apps.esignlive.com/packages/{1}/sign

Pour les clients américains qui effectuent un déploiement dans un environnement Sandbox américain et dont l'URL de connexion est https://sandbox.esignlive.com/login :
- URL DE L'API :
```
https://sandbox.esignlive.com/api
```
URL du concepteur :

https://sandbox.eSignlive.com/auth?senderAuthenticationToken={0}&target=https://sandbox.esignlive.com/designer/{1}?profile=dynamics1.2

URL de signature :

https://sandbox.eSignlive.com/auth?signerAuthenticationToken={0}&target=https://sandbox.esignlive.com/packages/{1}/sign

Pour les clients américains qui effectuent un déploiement dans un environnement de production américain et dont l'URL de connexion est https://apps.e-Signlive.com/login :
- URL DE L'API :
```
https://apps.e-SignLive.com/api
```
URL du concepteur :

https://apps.e-SignLive.com/auth?senderAuthenticationToken={0}&target=https://apps.e-SignLive.com/designer/{1}?profile=dynamics1.2

URL de signature :

https://apps.e-SignLive.com/auth?signerAuthenticationToken={0}&target=https://apps.e-SignLive.com/packages/{1}/sign

Pour les clients américains qui effectuent un déploiement dans un environnement Sandbox américain et dont l'URL de connexion est https://sandbox.e-SignLive.com/login :
- URL DE L'API :
```
https://sandbox.e-SignLive.com/api
```
URL du concepteur :

https://sandbox.e-SignLive.com/auth?senderAuthenticationToken={0}&target=https://sandbox.e-SignLive.com/designer/{1}?profile=dynamics1.2

URL de signature :

https://sandbox.e-SignLive.com/auth?signerAuthenticationToken={0}&target=https://sandbox.e-SignLive.com/packages/{1}/sign

Pour les clients canadiens qui effectuent un déploiement dans un environnement de production canadien et dont l'URL de connexion est https://apps.e-SignLive.ca/login :
- URL DE L'API :
```
https://apps.e-SignLive.ca/api
```
URL du concepteur :

https://apps.e-SignLive.ca/auth?senderAuthenticationToken={0}&target=https://apps.eSignLive.ca/designer/{1}?profile=dynamics1.2

URL de signature :

https://apps.eSignLive.ca/auth?signerAuthenticationToken={0}&target=https://apps.e-SignLive.ca/packages/{1}/sign

Pour les clients canadiens qui effectuent un déploiement dans un environnement Sandbox canadien et dont l'URL de connexion est https://sandbox.e-SignLive.ca/login :
- URL DE L'API :
```
https://sandbox.e-SignLive.ca/api
```
URL du concepteur :

https://sandbox.e-SignLive.ca/auth?senderAuthenticationToken={0}&target=https://sandbox.e-SignLive.ca/designer/{1}?profile=dynamics1.2

URL de signature :

https://sandbox.e-SignLive.ca/auth?signerAuthenticationToken={0}&target=https://sandbox.e-SignLive.ca/packages/{1}/sign

Saisissez l'URL de rappel utilisée pour le service de notification des événements. Par exemple : http://server/PostEvent.svc/PostESLEvent
Enregistrez le formulaire, puis cliquez sur le bouton du ruban Définir l'URL de rappel pour enregistrer l'URL dans OneSpan Sign.
Saisissez la chaîne de connexion d'audit de la base de données créée précédemment.

Data Source=servername; Initial Catalog=databasename; uid=userid ; pwd=password

Indiquez si vous souhaitez utiliser l'intégration SharePoint. Si oui, alors :
1. Saisissez l'URL de l'hôte de téléversement des documents. Il s'agit du nom d'hôte du site hébergé créé à l'Étape 2 : Configuration du tableau de bord et des rapports
2. Saisissez l'URL des documents SharePoint, où eSignLive.com.ESL.WebService.wsp sera déployé dans votre intégration SharePoint. Il s'agit de l'URL du site SharePoint à partir de laquelle vous allez sélectionner des documents pour Dynamics CRM.
3. Saisissez l'URL du document SharePoint terminé. Il s'agit de l'URL de la bibliothèque de sites SharePoint dans laquelle les documents signés à partir de OneSpan Sign seront enregistrés.
Cliquez sur Vérifier les paramètres pour confirmer que la clé API et l'URL API sont correctes et que la communication avec le serveur OneSpan Sign peut être établie.

Étape 4 : Configuration de la langue

Pour configurer la langue d'affichage du connecteur :

Dans Paramètres, cliquez sur OneSpan SignLangue. Une grille Langues OneSpan Sign apparaît. Sa liste doit initialement être vide.
Pour configurer une nouvelle langue pour le connecteur, cliquez sur Nouvelle.
Saisissez le nom et la valeur de la langue. Par exemple, pour l'anglais : Nom = anglais et Valeur = en. Pour connaître les paires nom-valeur de toutes les langues prises en charge, voir Langues prises en charge.
Cliquez sur Enregistrer.

Étape 5 : Installation du service de notification pour Dynamics CRM

La procédure suivante installe un service de notification Windows qui : (1) lira les mises à jour de statut à partir de la table de la base de données des notifications SQL créée à l'étape précédente ; (2) appliquera ces mises à jour aux données de paquets OneSpan Sign de Dynamics CRM.

Pour installer le service de notification :

Décompressez le contenu de eSignLive.comESLNotificationService.zip dans un nouveau répertoire.
Ouvrez le fichier eSignLive.comESLNotificationService.exe.config dans un éditeur de texte.
Modifiez la chaîne de connexion pour le serveur SQL comme suit :

Chaîne de connexion du serveur SQL :

Data Source=<ServerName>;Initial Catalog=<dbname>;User ID=<sqluser>;Password=<password>

Remplacez <ServerName> avec le nom du serveur SQL.
Remplacez <dbname> avec le nom de la base de données où le tableau des notifications a été installé.
Remplacer <sqluser> et <password> avec les identifiants de connexion SQL qui ont un accès en lecture et en écriture à la base de données.

Modifiez la chaîne de connexion pour le serveur Dynamics CRM comme suit :

Chaîne de connexion CRM :

Url=<crmURL>; Domain=<domain>; Username=<user>; Password=<password>
            <appSettings>
            <addkey="CRMURL"value="<crmURL>/XRMServices/2011/Organization.svc"/>
            <add key="crmuser" value="Username" />
            <add key="crmpass" value="password" />
            </appSettings>

Remplacez <crmURL> par l'URL de l'installation CRM.
Remplacez <domain>, <user> et <password> par les informations d'identification de l'utilisateur du domaine qui dispose d'un accès administratif à l'installation CRM.

Ouvrez une invite de commande Windows, et sélectionnez Exécuter en tant qu'administrateur.

Accédez au dossier dans lequel les fichiers du service de notification ont été copiés à l'étape 1.

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

Ouvrez l'outil de gestion des services Windows (Démarrer > Outils d'administration > Services), et confirmez que le service eSignLive Notifications est présent.

Démarrez le service.

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

Naviguez jusqu'au eSignLive.comEventLog et confirmez l'enregistrement d'un événement qui indique que le service a été lancé.