document d`installation du connecteur maileva connect

Transcription

DOCUMENT D’INSTALLATION
DU CONNECTEUR
MAILEVA CONNECT
Version : 01 - Date : 22/05/2013
Maileva Connect - Version : 01 - Date : 22/05/2013
SOMMAIRE
CONTEXTE ET OBJECTIFS DU DOCUMENT
4
Contexte
Objectifs
Documents liés/Références
4
4
4
PRÉREQUIS
5
INSTALLATION DU PACKAGE
6
Import de la solution
6
1. Accès à la zone Solutions
Sommaire
2. Sélection du fichier Solution
3. Informations sur la solution
4. Options d’importation
5. Résumé de l’importation
CONTENU DE LA SOLUTION
11
Entités personnalisables
11
1. Connexion au service
Accès au service
Informations envoyées
13
13
1. Format des données
Entités personnalisées utilisateur (Journal Maileva Connect)
Entités personnalisées administrateur
Workflows et Plug-ins
14
14
15
1. Workflows
2. Plugins
CONFIGURATION
Paramètres Maileva
17
17
1. Expiration
2. Url
3. Username
4. Password
5. Chunksize
Compteur
20
1. docapost_monitoringtrigger
Document d’installation du connecteur Maileva Connect - 2/29
2. docapost_journauxdesuivi
Déclencheurs traitement suivi
Assemblage de rapport
22
22
ACTIVATION DU CONNECTEUR
Tâche planifiée
Accès utilisateurs
TEST DU CONNECTEUR
Envoi d’un fichier contact
Suivi de l’envoi
23
23
24
25
25
27
28
Codes pays
28
Sommaire
ANNEXE
CONTEXTE ET OBJECTIFS
DU DOCUMENT
Dans le cadre du développement de son activité, la société DOCAPOST DPS souhaite mettre en place
un connecteur avec Microsoft Dynamics CRM permettant aux utilisateurs de cette solution de bénéficier
des services proposés par la société DOCAPOST DPS.
Objectifs
L’objectif de ce connecteur permettra dans un premier temps :
•
•
•
•
La configuration des utilisateurs Microsoft Dynamics CRM pour renseigner les informations de
connexions au service Maileva
L’envoi d’un document unitaire (par exemple un devis) au service Maileva qui procédera à son
impression et à son expédition
D’envoyer un document unitaire (par exemple un mailing) dans le cadre d’une campagne
marketing au service Maileva qui procédera à son impression et à son expédition à une liste de
destinataires
De suivre depuis Microsoft Dynamics CRM le statut de l’envoi des courriers aux différents
destinataires.
Documents liés/Références
Aucun.
Contexte et objectifs du document
Contexte
PRÉREQUIS
Prérequis
L’utilisateur qui installe la solution doit avoir les droits nécessaires des solutions et des personnalisations
de Dynamics CRM.
INSTALLATION DU PACKAGE
Import de la solution
Une fois la solution téléchargée (fichier *.zip), vous devez vous connecter à Microsoft Dynamics CRM
pour l’importer.
Une fois connecté à Dynamics CRM, vous devez naviguer vers la zone de gestion des solutions.
L’accès à cette zone se fait par les Paramètres :
Installation du package
1. Accès à la zone Solutions
2. Sélection du fichier Solution
Lorsque vous cliquez sur le bouton « Importer », il apparaîtra la boîte de dialogue suivante :
3. Informations sur la solution
La validation du fichier à importer affiche les détails de la solution :
4. Options d’importation
La solution contient des Workflows et Plug-ins. Nous vous recommandons de cocher la case sur
l’impression suivante afin qu’ils soient activés.
Lorsque vous cliquez sur le bouton « Suivant », la solution s’importera :
5. Résumé de l’importation
Cette boîte de dialogue vous affiche un résumé de l’importation :
A la fermeture de la boîte de dialogue, la solution que vous venez d’importer apparaîtra dans la liste des
solutions :
L’import de la solution met à jour la navigation de l’application.
Afin de visualiser la nouvelle navigation, veuillez vous déconnecter de l’application
et vous reconnecter.
CONTENU DE LA SOLUTION
Entités personnalisables
Le service Maileva Connect a été implémenté sur les entités ci-dessous. Elles ont été personnalisées
avec l’ajout d’un bouton dans le ruban Compte, Contact, Opportunité, Devis, Commande, Facture,
Liste Marketing
Le bouton qui est ajouté dans le ruban est le suivant
.
Contenu de la solution
1. Connexion au service
Si l’utilisateur a les accès au service Maileva Connect, il pourra effectuer des envois de fichier au service
Maileva Connect. L’interface Silverlight suivante permet d’accéder au service :
Accès au service
Le formulaire « Utilisateur » est également personnalisé. L’accès aux utilisateurs se fait en cliquant sur
Paramètres -> Administration -> Utilisateurs.
Un nouvel onglet « Maileva Connect » est ajouté avec les informations suivantes :
•
Maileva Connect OUI /NON : Définissant si le connecteur MAILEVA - MS DYNAMICS CRM est
disponible ou non pour cet utilisateur.
Le schéma ci-dessous illustre le nouvel onglet du formulaire « Utilisateur » :
Informations envoyées
En plus du fichier sélectionné, il est affiché dans l’interface, des informations issues de Dynamics CRM.
Elles sont modifiables avant envoi mais ne mettent pas à jour Dynamics CRM.
Les informations utilisées pour le compte / contact sont :
•
•
•
•
•
•
•
(Nom) - Name ou fullname (pour le contact)
(Rue 1) - address1_line1
(Code postal) - address1_postalcode
(Ville) - address1_city
(Pays) - address1_country
Pour l’opportunité, il sera utilisé l’adresse du client qui y est rattachée. Le client peut être un compte ou
un contact.
Les informations utilisées pour le devis / commande / facture sont :
•
•
•
•
•
•
•
(Nom) - Name
(Rue 1) - bilto_line1
(Code postal) - bilto_postalcode
(Ville) - bilto_city
(Pays) - bilto_country
Si la fiche utilisateur est configurée pour accéder au service, alors l’utilisateur correspondant accédera au
service Maileva Connect.
1. Format des données
Le service a besoin d’un code pays qui est déterminé en fonction du pays. Pour cela, le pays doit être
écrit correctement.
Vous trouverez la liste des pays en annexe de ce document.
De plus, le code postal et la ville sont concaténés afin de respecter le format d’entrée du service.
Entités personnalisées utilisateur (Journal Maileva Connect)
Un journal Maileva Connect est qualifié par les informations suivantes :
Le champ « Description » contiendra le type de l’entité et le nom.
Entités personnalisées administrateur
Les entités personnalisées administrateur sont utilisées par le connecteur. Elles sont accessibles depuis
la zone « Paramètres / Extension » comment montré ci-dessous :
L’utilisateur a la possibilité de suivre le statut de sa demande grâce à l’entité « Journal Maileva
Connect ». Elle est visible dans l’espace de travail comme indiqué ci-dessous :
Workflows et Plug-ins
Pour réaliser les traitements, le connecteur utilise des Workflows et plug-ins. Ils ont été activés lors de
l’importation de la solution si vous avez coché la case correspondante comme indiqué dans le chapitre
3.1.4 Options d’importation.
1. Workflows
L’accès aux Workflow se fait en cliquant sur « Paramètres » -> « Processus »
Les deux Workflows cités ci-dessus sont montrés sur la figure suivante.
2. Plugins
Les plugins sont utilisés pour les traitements internes, une seule DLL a été enregistrée avec plusieurs
étapes.
CONFIGURATION
Afin que le connecteur soit opérationnel, il est nécessaire de configurer les paramètres généraux et les
informations « Maileva Connect » des fiches des utilisateurs.
Les paramètres se configurent dans la zone « Paramètres » de Dynamics CRM.
Paramètres Maileva
Configuration
Ces paramètres se configurent à l’aide de l’entité « Paramètre Maileva » accessible depuis la zone
« Paramètres / Extension ».
Il existe cinq paramètres à configurer. Il sera donc nécessaire de créer les cinq enregistrements
suivants :
•
•
•
•
•
Expiration
Url
Username
Password
ChunSize
Les paramètres Password et Username seront transmis par Maileva à la suite
d’une contractualisation. Contactez le N°Azur 0810 802 801 (prix d’appel local)
pour obtenir des informations sur la démarche de contractualisation.
1. Expiration
Ce paramètre permet de définir le nombre de jours avant qu’un journal Maileva Connect sans retour de
Maileva soit clôturé.
Nom du paramètre : journal:expiration
Valeur du paramètre : 4
2. Url
Il s’agit de l’URL d’accès au web service Maileva Connect.
Configuration
Nom du paramètre : webservice:url
Valeur du paramètre : https://webservices.maileva.com/public/connecteurHTTP/index.php
3. Username
Il s’agit du login d’accès au service web Maileva Connect. L’impression écran suivante montre un
exemple d’enregistrement de paramètre de login.
Nom du paramètre : webservice:username
Valeur du paramètre : spécifier la valeur du paramètre transmis dans votre contrat
Il s’agit du mot de passe d’accès au service web Maileva Connect. La figure ci-dessous montre un
exemple d’enregistrement avec ce paramètre.
Nom du paramètre : webservice:password
Valeur du paramètre : spécifier la valeur du paramètre transmis dans votre contrat
5. Chunksize
Ce paramètre spécifie la taille en octet d’un fragment Maileva Connect. Cette valeur vous sera
communiquée par les équipes techniques Maileva Connect lors de la mise en place du connecteur.
Ce paramètre est optionnel.
Configuration
4. Password
Nom du paramètre : webservice:chunkSize
Valeur du paramètre : 8192
L’entité « Compteur » est accessible depuis la zone « Paramètres ».
Pour le bon fonctionnement du connecteur, deux enregistrements sont nécessaires :
•
•
docapost_monitoringtrigger
docapost_journauxdesuivi
Ces enregistrements comportent des champs obligatoires (système) et facultatifs. Les valeurs des
champs « Nom » et « Champ cible » sont imposées et ne doivent pas être modifiées.
1. docapost_monitoringtrigger
Ce compteur est le compteur technique de la tâche planifiée d’actualisation des journaux.
Nom : docapost_monitoringtrigger
Champ cible : docapost_name
Préfixe : préfixe du numéro (Saisissez auto_)
Incrément : valeur de l’incrément (généralement définie à 1)
Suffixe : suffixe du numéro
Valeur suivante : valeur courante (généralement définie à 1 lors de l’initialisation)
Configuration
Compteur
Longueur : Permet d’avoir un numéro avec une longueur fixe (numéro sera complété par le caractère 0
afin de faire la longueur définie)
2. docapost_journauxdesuivi
Nom : docapost_journauxdesuivi
Champ cible : docapost_number
Préfixe : préfixe du numéro
Incrément : valeur de l’incrément (généralement définie à 1)
Suffixe : suffixe du numéro
Valeur suivante : valeur courante (généralement définie à 1 lors de l’initialisation)
Longueur : Permet d’avoir un numéro avec une longueur fixe (numéro sera complété par le caractère 0
afin de faire la longueur définie)
Configuration
Il s’agit du compteur des références internes des demandes Maileva. Cette référence est utilisée dans la
liste des journaux Maileva Connect et est communiquée à l’utilisateur lors de l’envoi d’une demande.
Déclencheurs traitement suivi
Cette entité est utilisé par le Workflow « Mise à jour du journal Maileva Connect ». Un enregistrement
est créé à chaque déclenchement.
Elle apparaît dans le menu « Paramètres ».
Assemblage de rapport
Configuration
Cette entité est utilisée en interne par les plugins. Elle apparaît également dans le menu « Paramètres ».
Il est créé un assemblage de rapport lorsqu’un fichier est mis à disposition. Le fichier est
automatiquement joint en tant que notes à l’enregistrement. La référence client de l’assemblage est mise
à jour une fois le fichier final réceptionné.
ACTIVATION DU CONNECTEUR
Tâche planifiée
La tâche planifiée permet l’actualisation des journaux Maileva Connect et est à faire une seule fois après
installation du connecteur.
Test du connecteur
Pour activer le connecteur, il suffit de créer un enregistrement de type « Déclencheur traitement
suivi ».
Il faut saisir un nom. Le texte saisi n’est pas important mais il est préférable de mettre un texte
compréhensible.
Lors de l’enregistrement, il est vérifié si la communication avec Maileva Connect fonctionne.
Une erreur est remontée dans le champ « Erreur » si la communication est en échec. Ensuite, le
mécanisme créera lui-même les prochains enregistrements (toutes les heures).
Accès utilisateurs
L’accès aux utilisateurs à Maileva Connect via le connecteur se configure sur le formulaire
« Utilisateur ». Dans la vue des utilisateurs, sélectionner l’utilisateur pour lequel vous souhaitez donner
l’accès.
Test du connecteur
Sur la fiche utilisateur, il apparaît un onglet pour la configuration à Maileva Connect.
TEST DU CONNECTEUR
Envoi d’un fichier contact
Test du connecteur
Pour les tests, il a été utilisé un contact avec les informations suivantes :
Test du connecteur
L’action sur le bouton Maileva Connect affiche la fenêtre suivante :
Une fois cliqué sur le bouton « Envoyer », un message s’affiche avec un numéro qui sera repris dans le
journal Maileva Connect qui vient d’être créé.
Le journal Maileva Connect correspondant est le suivant :
Suivi de l’envoi
La validation entraîne la création d’un journal Maileva Connect qui est en attente de réception. Les
différents statuts d’un journal sont :
•
•
•
En attente de réception
En attente de réalisation
Clôture
Test du connecteur
Depuis le journal de suivi, il est possible de visualiser le statut d’envoi au destinataire.
ANNEXE
{"AFGHANISTAN","AF"},
{"DOMINICAINE, REPUBLIQUE","DO"},
{"AFRIQUE DU SUD","ZA"},
{"DOMINIQUE","DM"},
{"ÅLAND, ÎLES","AX"},
{"EGYPTE","EG"},
{"ALBANIE","AL"},
{"EL SALVADOR","SV"},
{"ALGERIE","DZ"},
{"EMIRATS ARABES UNIS","AE"},
{"ALLEMAGNE","DE"},
{"EQUATEUR","EC"},
{"ANDORRE","AD"},
{"ERYTHREE","ER"},
{"ANGOLA","AO"},
{"ESPAGNE","ES"},
{"ANGUILLA","AI"},
{"ESTONIE","EE"},
{"ANTARCTIQUE","AQ"},
{"ETATS-UNIS","US"},
{"ANTIGUA ET BARBUDA","AG"},
{"ETHIOPIE","ET"},
{"ARABIE SAOUDITE","SA"},
{"FALKLAND, ILES (MALVINAS)","FK"},
{"ARGENTINE","AR"},
{"FEROE, ILES","FO"},
{"ARMENIE","AM"},
{"FIDJI","FJ"},
{"ARUBA","AW"},
{"FINLANDE","FI"},
{"AUSTRALIE","AU"},
{"FRANCE","FR"},
{"AUTRICHE","AT"},
{"GABON","GA"},
{"AZERBAIDJAN","AZ"},
{"GAMBIE","GM"},
{"BAHAMAS","BS"},
{"GEORGIE","GE"},
{"BAHREIN","BH"},
{"GEORGIE DU SUD ET LES ILES SANDWICH DU SUD","GS"},
{"BANGLADESH","BD"},
{"GHANA","GH"},
{"BARBADE","BB"},
{"GIBRALTAR","GI"},
{"BELARUS","BY"},
{"GRECE","GR"},
{"BELGIQUE","BE"},
{"GRENADE","GD"},
{"BELIZE","BZ"},
{"GROENLAND","GL"},
{"BENIN","BJ"},
{"GUADELOUPE","GP"},
{"BERMUDES","BM"},
{"GUAM","GU"},
{"BHOUTAN","BT"},
{"GUATEMALA","GT"},
{"BOLIVIE, l'ETAT PLURINATIONAL DE","BO"},
{"GUERNESEY","GG"},
{"BONAIRE, SAINT-EUSTACHE ET SABA","BQ"},
{"GUINEE","GN"},
{"BOSNIE-HERZEGOVINE","BA"},
{"GUINEE-BISSAU","GW"},
{"BOTSWANA","BW"},
{"GUINEE EQUATORIALE","GQ"},
{"BOUVET, ILE","BV"},
{"GUYANA","GY"},
{"BRESIL","BR"},
{"GUYANE FRANCAISE","GF"},
{"BRUNEI DARUSSALAM","BN"},
{"HAITI","HT"},
{"BULGARIE","BG"},
{"HEARD, ILE ET MCDONALD, ILES","HM"},
{"BURKINA FASO","BF"},
{"HONDURAS","HN"},
{"BURUNDI","BI"},
{"HONG KONG","HK"},
{"CAIMANES, ILES","KY"},
{"HONGRIE","HU"},
{"CAMBODGE","KH"},
{"ILE DE MAN","IM"},
{"CAMEROUN","CM"},
{"ILES MINEURES ELOIGNEES DES ETATS-UNIS","UM"},
{"CANADA","CA"},
{"ILES VIERGES BRITANNIQUES","VG"},
{"CAP-VERT","CV"},
{"ILES VIERGES DES ETATS-UNIS","VI"},
{"CENTRAFRICAINE, REPUBLIQUE","CF"},
{"INDE","IN"},
{"CHILI","CL"},
{"INDONESIE","ID"},
{"CHINE","CN"},
{"IRAN, REPUBLIQUE ISLAMIQUE D'","IR"},
{"CHRISTMAS, ILE","CX"},
{"IRAQ","IQ"},
{"CHYPRE","CY"},
{"IRLANDE","IE"},
{"COCOS (KEELING), ILES","CC"},
{"ISLANDE","IS"},
{"COLOMBIE","CO"},
{"ISRAEL","IL"},
{"COMORES","KM"},
{"ITALIE","IT"},
{"CONGO","CG"},
{"JAMAIQUE","JM"},
{"CONGO, LA REPUBLIQUE DEMOCRATIQUE DU","CD"},
{"JAPON","JP"},
{"COOK, ILES","CK"},
{"JERSEY","JE"},
{"COREE, REPUBLIQUE DE","KR"},
{"JORDANIE","JO"},
{"COREE, REPUBLIQUE POPULAIRE DEMOCRATIQUE DE","KP"},
{"KAZAKHSTAN","KZ"},
{"COSTA RICA","CR"},
{"KENYA","KE"},
{"COTE D'IVOIRE","CI"},
{"KIRGHIZISTAN","KG"},
{"CROATIE","HR"},
{"KIRIBATI","KI"},
{"CUBA","CU"},
{"KOWEIT","KW"},
{"CURACAO","CW"},
{"LAO, REPUBLIQUE DEMOCRATIQUE POPULAIRE","LA"},
{"DANEMARK","DK"},
{"LESOTHO","LS"},
{"DJIBOUTI","DJ"},
{"LETTONIE","LV"},
Annexe
Codes pays
{"LIBAN","LB"},
{"ROYAUME-UNI","GB"},
{"LIBERIA","LR"},
{"RUSSIE, FEDERATION DE","RU"},
{"LIBYENNE, JAMAHIRIYA ARABE","LY"},
{"RWANDA","RW"},
{"LIECHTENSTEIN","LI"},
{"SAHARA OCCIDENTAL","EH"},
{"LITUANIE","LT"},
{"SAINT-BARTHELEMY","BL"},
{"LUXEMBOURG","LU"},
{"SAINTE-HELENE, ASCENSION ET TRISTAN DA CUNHA","SH"},
{"MACAO","MO"},
{"SAINTE-LUCIE","LC"},
{"MACEDOINE, L'EX-REPUBLIQUE YOUGOSLAVE DE","MK"},
{"SAINT-KITTS-ET-NEVIS","KN"},
{"MADAGASCAR","MG"},
{"SAINT-MARIN","SM"},
{"MALAISIE","MY"},
{"SAINT-MARTIN (PARTIE FRANCAISE)","MF"},
{"MALAWI","MW"},
{"SAINT-MARTIN (PARTIE NEERLANDAISE)","SX"},
{"MALDIVES","MV"},
{"SAINT-PIERRE-ET-MIQUELON","PM"},
{"MALI","ML"},
{"SAINT-SIEGE (ETAT DE LA CITE DU VATICAN)","VA"},
{"MALTE","MT"},
{"SAINT-VINCENT-ET-LES GRENADINES","VC"},
{"MARIANNES DU NORD, ILES","MP"},
{"SALOMON, ILES","SB"},
{"MAROC","MA"},
{"SAMOA","WS"},
{"MARSHALL, ILES","MH"},
{"SAMOA AMERICAINES","AS"},
{"MARTINIQUE","MQ"},
{"SAO TOME-ET-PRINCIPE","ST"},
{"MAURICE","MU"},
{"SENEGAL","SN"},
{"MAURITANIE","MR"},
{"SERBIE","RS"},
{"MAYOTTE","YT"},
{"SEYCHELLES","SC"},
{"MEXIQUE","MX"},
{"SIERRA LEONE","SL"},
{"MICRONESIE, ETATS FEDERES DE","FM"},
{"SINGAPOUR","SG"},
{"MOLDOVA, REPUBLIQUE DE","MD"},
{"SLOVAQUIE","SK"},
{"MONACO","MC"},
{"SLOVENIE","SI"},
{"MONGOLIE","MN"},
{"SOMALIE","SO"},
{"MONTENEGRO","ME"},
{"SOUDAN","SD"},
{"MONTSERRAT","MS"},
{"SRI LANKA","LK"},
{"MOZAMBIQUE","MZ"},
{"SUEDE","SE"},
{"MYANMAR","MM"},
{"SUISSE","CH"},
{"NAMIBIE","NA"},
{"SURINAME","SR"},
{"NAURU","NR"},
{"SVALBARD ET ILE JAN MAYEN","SJ"},
{"NEPAL","NP"},
{"SWAZILAND","SZ"},
{"NICARAGUA","NI"},
{"SYRIENNE, REPUBLIQUE ARABE","SY"},
{"NIGER","NE"},
{"TADJIKISTAN","TJ"},
{"NIGERIA","NG"},
{"TAIWAN, PROVINCE DE CHINE","TW"},
{"NIUE","NU"},
{"TANZANIE, REPUBLIQUE-UNIE DE","TZ"},
{"NORFOLK, ILE","NF"},
{"TCHAD","TD"},
{"NORVEGE","NO"},
{"TCHEQUE, REPUBLIQUE","CZ"},
{"NOUVELLE-CALEDONIE","NC"},
{"TERRES AUSTRALES FRANCAISES","TF"},
{"NOUVELLE-ZELANDE","NZ"},
{"THAILANDE","TH"},
{"OCEAN INDIEN, TERRITOIRE BRITANNIQUE DE L'","IO"},
{"TIMOR-LESTE","TL"},
{"OMAN","OM"},
{"TOGO","TG"},
{"OUGANDA","UG"},
{"TOKELAU","TK"},
{"OUZBEKISTAN","UZ"},
{"TONGA","TO"},
{"PAKISTAN","PK"},
{"TRINITE-ET-TOBAGO","TT"},
{"PALAOS","PW"},
{"TUNISIE","TN"},
{"PALESTINIEN OCCUPE, TERRITOIRE","PS"},
{"TURKMENISTAN","TM"},
{"PANAMA","PA"},
{"TURKS ET CAIQUES, ILES","TC"},
{"PAPOUASIE-NOUVELLE-GUINEE","PG"},
{"TURQUIE","TR"},
{"PARAGUAY","PY"},
{"TUVALU","TV"},
{"PAYS-BAS","NL"},
{"UKRAINE","UA"},
{"PEROU","PE"},
{"URUGUAY","UY"},
{"PHILIPPINES","PH"},
{"VANUATU","VU"},
{"PITCAIRN","PN"},
{"VATICAN, ETAT DE LA CITE DU","VA"},
{"POLOGNE","PL"},
{"VENEZUELA, REPUBLIQUE BOLIVARIENNE DU","VE"},
{"POLYNESIE FRANCAISE","PF"},
{"VIET NAM","VN"},
{"PORTO RICO","PR"},
{"WALLIS ET FUTUNA","WF"},
{"PORTUGAL","PT"},
{"YEMEN","YE"},
{"QATAR","QA"},
{"ZAMBIE","ZM"},
{"REUNION","RE"},
{"ZIMBABWE","ZW"}
{"ROUMANIE","RO"},
Annexe

document d`installation du connecteur maileva connect

Transcription

Documents pareils

vos envois courrier et multicanal en moins de 15 min

Applicafions disponibles avec les cerfificats

maileva confie l`infogérance de sa plate

CS 100

Maileva signe un partenariat technologique avec Labo Online et

Relation client : le multicanal m o n t e e n p u i ssa n c e Relation

Aménagements

Plaquette Maileva

2011 - tarif prestations 2011

Mon CV / résumé de graphiste freelance