Cet article fait partie d’une série d’articles détaillés sur les connecteurs K2. Vous pouvez retrouver des liens vers les autres articles en fin de billet.
Ce connecteur a été mis à jour avec la sortie de K2 Five. Se référer à l’article dédié à cette nouvelle version pour des informations plus fraîches.
Parmi les connecteurs standards K2, on retrouve le connecteur pour SalesForce (dans le vocabulaire K2, on parlera de service broker K2
), solution de CRM en ligne mondialement connue et reconnue.
Ce connecteur est un connecteur dynamique (comme celui de SQL Server), c’est-à-dire que lors de son instanciation, K2 va aller découvrir la liste des entités du CRM et créer les méthodes d’accès associées ; lorsqu’une mise à jour de la structure de vos entités SalesForce est réalisée, il faudra mettre à jour le WSDL associé et rafraîchir l’instance du service broker K2 afin d’y faire refléter les modifications.
Nous allons donc faire un petit tour d’horizon des fonctionnalités attachées à ce connecteur et aborder les éléments de configuration, mais voyons dans un 1er temps quel peut-être son usage.
Usage
Le service broker
SalesForce a principalement 2 usages :
- Permettre d’utiliser, dans ses applications K2, des données provenant d’entités SalesForce déjà existantes.
- Proposer l’ensemble des fonctionnalités K2 (formulaires, smartobjects et workflows) directement dans l’interface SalesForce, sans code. Un article sera dédié à cet usage.
Pré-requis
Bien évidemment, il va vous falloir un tenant SalesForce pour utiliser ce connecteur. Si vous n’êtes pas client SalesForce mais que vous souhaitez quand même tester ce service broker
, vous pouvez (gratuitement), vous créer un compte développeur sur le site de SalesForce.
Une fois votre compte (et donc tenant) créé, vous allez avoir besoin du WSDL de votre tenant et de votre jeton de sécurité :
- Pour récupérer le WSDL :
- Menu
configuration
>Elaborer
>Développer
>API
> Télécharger le WSDL… - Récupérez le WSDL enterprise en local (clic-droit “enregistrer le lien sous…”, plutôt que de faire un copier-coller du contenu de WSDL chargé dans votre navigateur) sur votre serveur K2 :
- Menu
- Pour récupérer votre jeton de sécurité :
- NB : le jeton de sécurité est spécifique à l’utilisateur et il doit être renouvelé à chaque fois que l’utilisateur change de mot de passe. Il est donc préférable de faire cette manipulation là avec un utilisateur Salesforce dont le mot de passe n’expire jamais.
- Menu Profil >
Mes paramètres
>Personnel
>Réinitialiser mon jeton de sécurité
. - Un mail vous est alors envoyé sur votre adresse de contact, il contient votre jeton de sécurité.
Récupérer le jeton de sécurité pour s’intégrer avec son tenant SalesForce
Une fois les éléments SalesForce disponibles, il faudra également vérifier la présence (et le cas échéant l’installer) du SDK du framework .net 4.0.
Configuration
La configuration des intégrations SalesForce se réalise depuis la broker management console de K2, outil aujourd’hui peu connu qui ne sert plus qu’à référencer ses intégrations SalesForce. Cette console est disponible dans l’arborescence K2, par défaut c:\Program Files (x86)\K2 blackpearl\ServiceBroker\BrokerManagement.exe
.

- Cliquez sur
SalesForce Instance Generator
. - Remplir les champs :
WSDL file path and name
: avec l’adresse locale du fichier WSDL téléchargé précédemment.UserName
: l’adresse mail du compte de votre tenant.Password
: attention, petite subtilité ici, il s’agit du jeton de sécurité récupéré dans les pré-requis précédé du mot de passe de votre compte (soit “xxxyyy” où xxx est le mot de passe de votre compte et yyy le jeton de sécurité).Instance Destination Path
: le chemin d’accès vers un répertoire local qui recevra les fichiers dll et xml générés automatiquement et utilisés par l’instance du service broker K2. Ce chemin ne doit contenir ni espaces ni caractères spéciaux.The Instance Name
: un nom unique pour l’instance qui va être créée (sans espace).- Cliquez ensuite sur
Generate
, et attendre… longtemps (plusieurs minutes). K2 découvre alors la structure du tenant SalesForce puis génère l’ensemble des fichiers nécessaires à K2. - Vous obtenez alors le message suivant, cliquez sur
OK
.
- A la question : “Would you like to register this intance withe the broker store?”, répondez OUI. Une nouvelle fenêtre permettant de configurer le service apparaît : renseignez
Username
(comme en 2.b) etPassword
(comme en 2.c) et cliquez sur le boutonSave
- Une nouvelle fenêtre apparaît permettant de configurer l’instance du service broker K2, vous pouvez alors éventuellement modifier les différents champs présents :
- Dernière étape, mettre en cache les informations de connexion de façon à ne pas être prompté à chaque appel au broker. Sur la Broker Management Console, cliquez sur
Cache SalesForce Credentials
. RenseignezUsername
etPassword
conformément aux étapes précédentes 2-b et 2-c. Cliquez surSave
, attendre le message de confirmation puis cliquer surClose
.
Fonctionnalités
Lors de l’instanciation du broker, K2 va exposer sous forme de service object l’ensemble des entités et exposer les méthodes d’accès à ces objets :
- Les méthodes
CRUD
sont exposées dès lors que l’entité dispose d’une clé. - Une méthode de type liste est toujours exposée et des filtres peuvent être mis en place en s’appuyant sur chacune des propriétés.
Sur la copie d’écran suivante, on peut voir une partie des entités découvertes par le broker K2, et pour l’entité Compte
, les méthodes exposées :

Il est donc possible de créer les smartobjects correspondant aux entités SalesForce qui vous intéressent et utiliser le smartobject event
lorsque vous êtes dans la modélisation d’un processus ou l’action de règle Execute a SmartObject method
dans la configuration d’un formulaire. Dans le cas où vous souhaiteriez accéder à ces objets par du développement K2, vous pouvez y accéder via les API.net, les services WCF ou les services REST de K2.


N’hésitez pas à utiliser les commentaires si vous avez des questions.
Vous trouverez également des informations relatives à la configuration et l’utilisation du connecteur SalesForce dans la documentation K2.
Autres billets de la série sur les connecteurs :
- Vue macroscopique de l’ensemble des connecteurs.
- Le connecteur K2 pour Active Directory.
- Le connecteur K2 pour Exchange.
- Le connecteur K2 pour SQL Server.
- Le connecteur K2 pour DocuSign.
- Le connecteur K2 pour Dynamics CRM.
- Le connecteur K2 pour SAP.
- Et d’autres à venir très bientôt (Oracle, SharePoint, Web Services…).
Happy K2ing !
Bonjour.
Merci pour ce post très intéressant. j’ai tenté la manipulation, mais dans la console BrokerManagement, lorsque je clique sur générer, j’ai immédiatement le message suivant : the system cannot find the specified file.
Avez vous une idée d’où cela peut provenir ?
Olivier
Bonjour Olivier,
Ceci provient surement du fait que soit le SDK du framework.net 4 n’est pas installé, soit la clé de registre [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework]-SDKInstallRootv4.0 ne pointe pas vers le bon répertoire (en général : C:\Program Files (x86)\Microsoft SDKs\Windows\v7.0A\).
Pouvez-vous vérifier ces points ?
Cordialement,
Jean