Le client et le cient Web de IBM Cognos Incentive Compensation Management peuvent être configurés de manière à être intégrés à des applications externes, telles que Salesforce.com, ou à être accessibles depuis ces applications.
Le client Cognos Incentive Compensation Management peut être intégré aux applications IBM Cognos Territory and Quota Management et IBM Producer Lifecycle and Credential Management.
Il est possible d'importer des rapports d'affectation détaillés créés dans Cognos Territory and Quota Management et des tables à partir de Producer Lifecycle and Credential Management, puis de les utiliser comme sources dans les calculs et les rapports dans Cognos Incentive Compensation Management.
Connexion à IBM Cognos Territory and Quota Management
Pour que le client IBM Cognos Incentive Compensation Management puisse importer des données depuis IBM Cognos Territory and Quota Management, le fichier de configuration du service Windows de Cognos Incentive Compensation Management doit être modifié de manière à pointer vers l'instance Cognos Territory and Quota Management.
Procédure
1. Ouvrez le fichier de configuration du service Windows de Cognos Incentive Compensation Management.
2. Accédez à la section TerritoryManagementServiceAddress.
3. Dans la zone Value, indiquez l'adresse URL que vous utilisez pour vous connecter à Cognos Territory and Quota Management.
Omettez HTTPS://dans l'adresse URL et ajoutez :8443à la fin de celle-ci.
Connexion à IBM Producer Lifecycle and Credential Management
Pour que le client IBM Cognos Incentive Compensation Management puisse importer des données depuis IBM Producer Lifecycle and Credential Management, le fichier de configuration du service Windows de Cognos Incentive Compensation Management doit être modifié de manière à pointer vers l'application Producer Lifecycle and Credential Management.
Procédure
1. Ouvrez le fichier de configuration du service Windows de Cognos Incentive Compensation Management.
2. Accédez à la section PLCMServiceAddress.
3. Dans la zone Value, indiquez l'adresse URL que vous utilisez pour vous connecter à Producer Lifecycle and Credential Management.
Configuration du client Web d'IBM Cognos Incentive Compensation Management pour Salesforce.com
Après l'installation du client Web de IBM Cognos Incentive Compensation
Management, le fichier de configuration web.xml doit être modifié pour permettre l'accès au client Web à partir de Salesforce.com. Le client Web de Cognos Incentive Compensation Management doit d'abord être déployé.
Procédure
1. Naviguez jusqu'au fichier web.xmlqui se trouve, par défaut, à l'emplacement suivant : C:\Program Files\Apache Software Foundation\Tomcat
6.0\webapps\ICM\WEB-INF.
2. A la section Parameters, remplacez security.xmlpar security-salesforce-composite.xml.
3. Enregistrez le fichier, puis redémarrez le client Web de Cognos Incentive Compensation Management pour que les modifications prennent effet.
Accès à IBM Cognos Incentive Compensation Management depuis Salesforce.com
Vous pouvez permettre l'accès à l'application IBM Cognos Incentive Compensation Management à partir d'un onglet de Salesforce.
Procédure
1. Connectez-vous à Salesforce.com avec un ID utilisateur doté des droits d'administration.
2. Sélectionnez le lien Setup en haut de l'écran.
3. Dans la section App Setup du panneau de gauche, sélectionnez Create >
Tabs.
4. Cliquez sur New dans la section Web Tabs. Cette opération vous permet de créer un onglet personnalisé affichant du contenu Cognos Incentive
Compensation Management dans la fenêtre Salesforce.
5. Vous pouvez utiliser toute la largeur de la page pour afficher l'application Cognos Incentive Compensation Management ou y intégrer la barre de navigation de Salesforce.
6. Cliquez sur Next après avoir fait votre choix.
7. Définissez le contenu et les propriétés d'affichage de l'onglet Cognos Incentive Compensation Management en effectuant les opérations suivantes :
a. Dans la section Tab Content Definition, sélectionnez URL dans le menu Tab Type.
b. Dans la zone Tab Label, entrez le texte du libellé.
c. Dans la zone Tab Name, entrez un nom unique pour l'onglet. Ce nom peut être identique au libellé.
d. Choisissez la couleur de l'onglet en sélectionnant un style dans la zone Tab Style.
e. La zone Content Frame Height sert à définir la hauteur (en pixels) du cadre du contenu Cognos Incentive Compensation Management.
Indiquez une hauteur minimale de 800 pixels.
8. Vous pouvez également permettre l'utilisation de l'onglet Cognos Incentive Compensation Management en mode mobile, en définissant une page d'accueil, et en entrant la description de l'onglet. Ces zones ne sont pas obligatoires.
9. Appuyez sur le bouton Next une fois que vous avez défini le contenu et les propriétés d'affichage de l'onglet.
10. Dans l'écran des détails de l'URL, définissez l'adresse de l'application Web de Cognos Incentive Compensation Management sur le serveur d'applications Web sur lequel Cognos Incentive Compensation Management a été déployé. Il n'est pas nécessaire de définir des zones de fusion sur cet écran.
11. Entrez l'URL de la page d'accueil de l'application Web de Cognos Incentive Compensation Management et sélectionnez Unicode encoding. Vous devez inclure les traits de soulignement dans l'URL.
Si le client Web de Cognos Incentive Compensation Management est déployé sur https://localhost8080/ICM, son URL pour Salesforce est identique à celle-ci : https://localhost:8080/ICM/
sforce_composite_login?SessionId={!API.Session_ID}
&ServerURL={!API.Partner_Server_URL_100}
12. Cliquez sur Next lorsque vous avez terminé.
13. Dans l'écran Add to Profiles, vous pouvez sélectionner les profils utilisateur autorisés à visualiser le nouvel onglet Cognos Incentive Compensation Management.
14. Dans la page Add to Custom Apps, vous pouvez sélectionner les applications personnalisées dans lesquelles le nouvel onglet Cognos Incentive
Compensation Management sera visible.
15. Cliquez sur Save.
Résultats
L'application Cognos Incentive Compensation Management est maintenant accessible à partir de l'onglet nouvellement créé.
Intégration du client Web à Oracle CRM
Les utilisateurs d'Oracle peuvent installer un onglet IBM Cognos Incentive Compensation Management, afin d'accéder directement à Cognos Incentive Compensation Management à partir du site Oracle CRM.
Les utilisateurs connectés à Oracle CRM n'ont pas besoin de s'authentifier à nouveau lorsqu'ils accèdent à l'onglet Web de Cognos Incentive Compensation Management.
Important : Lorsque l'intégration à Oracle CRM est configurée dans l'application Web de Cognos Incentive Compensation Management, les utilisateurs ne peuvent pas se connecter directement au client Web de Cognos Incentive Compensation Management. L'onglet d'Oracle CRM devient le seul moyen d'accès possible à Cognos Incentive Compensation Management.
Configuration du client IBM Cognos Incentive Compensation Management pour une intégration avec Oracle CRM
Pour intégrer Oracle CRM avec IBM Cognos Incentive Compensation Management, vous devez ajouter une colonne à la table Bénéficiaire qui contient les noms d'utilisateur Oracle CRM de tous les bénéficiaires.
Procédure
1. Dans le modèle auquel les utilisateurs doivent accéder dans Oracle CRM, ajoutez à la table Bénéficiaire une colonne de texte destinée à l'intégration à Oracle.
Par exemple, ajoutez une colonne appelée ID utilisateur Oracle.
2. Ajoutez à la nouvelle colonne le nom d'utilisateur Oracle CRM de chaque bénéficiaire qui accédera au client Web de Cognos Incentive Compensation Management par un onglet d'Oracle CRM, par exemple : rivacent/huddle. 3. Créez un nouvel onglet dans le client en vue de l'intégration à Oracle CRM, et
autorisez les utilisateurs à accéder au client Web.
a. Accédez à Portal Access > Onglets Web, ajoutez un onglet Web du type Moduleet affectez-lui un objet édition de données.
b. Créez un groupe Portal Access contenant tous les bénéficiaires qui doivent accéder à Cognos Incentive Compensation Management via Oracle CRM.
Par exemple, créez un groupe appelé Groupe Oraclecontenant tous les bénéficiaires.
c. Créez une arborescence Portal Access et ajoutez-y le groupe Portal Access.
Par exemple, créez une arborescence Portal Access appelée Arborescence d'accès à Oracle, et contenant Groupe Oracle.
d. Dans l'onglet Affectation, donnez à l'arborescence d'accès à Oracle l'accès à l'onglet Web Oracle.
e. Dans l'onglet Groupes, autorisez tous les utilisateurs du groupe Oracle à accéder au client Web de Cognos Incentive Compensation Management.
Conseil : Bien qu'il soit nécessaire d'autoriser les utilisateurs à accéder au Web dans le client Cognos Incentive Compensation Management, ceux-ci n'utilisent jamais le mot de passe créé dans Cognos Incentive Compensation Management pour accéder à son client Web si l'intégration à Oracle CRM est mise en oeuvre.
Configuration du client Web d'IBM Cognos Incentive
Compensation Management pour une utilisation avec Oracle CRM
Pour configurer l'accès au client Web de IBM Cognos Incentive Compensation Management par un onglet dans Oracle CRM, vous devez éditer les fichiers crmondemand.propertieset web.xml.
Pourquoi et quand exécuter cette tâche
Si le client Web de Cognos Incentive Compensation Management est déployé sur Apache Tomcat, les fichiers se trouvent à l'emplacement par défaut suivant : C:\Program Files\Apache Software Foundation\Tomcat 6.0\webapps\ICM\WEB-INF.
Procédure
1. Déployez le fichier ICM.waret configurez le fichier jdbc.propertiesde manière qu'il pointe vers votre modèle.
2. Ouvrez le fichier crmondemand.propertieset modifiez les zones authenticationURLet userKeyColumn.
a. La zone authenticationURLdoit contenir l'URL de l'instance d'Oracle CRM à partir de laquelle vous vous connectez.
b. La zone userKeyColumncontient le nom de la colonne ajoutée à la table Bénéficiairede Cognos Incentive Compensation Management qui contient les noms des utilisateurs Oracle CRM.
3. Editez le paramètre de sécurité du fichier web.xml. Remplacez /WEB-INF/security.xmlpar /WEB-INF/security-crmondemand.xml.
4. Redémarrez le service Web de Cognos Incentive Compensation Management.
5. Connectez-vous à l'instance d'Oracle CRM en tant que l'un des utilisateurs référencés dans la colonne de la table Bénéficiaire contenant les noms des utilisateurs Oracle, et sélectionnez l'onglet configuré pour la connexion à Cognos Incentive Compensation Management.
Pour plus d'informations sur l'ajout d'onglets personnalisés dans les instances Oracle, consultez la rubrique d'aide d'Oracle CRM On Demand relative à l'affichage des pages externes dans les onglets.
Personnalisation de l'aspect du client IBM Cognos Incentive Compensation Management pour Salesforce.com
Une fois que l'onglet IBM Cognos Incentive Compensation Management a été défini dans Salesforce, vous pouvez personnaliser l'apparence de Cognos Incentive Compensation Management.
Vous pouvez réaliser cette tâche dans le client Cognos Incentive Compensation Management.
Modification du thème de Salesforce.com dans IBM Cognos Incentive Compensation Management
Lorsque vous accédez à IBM Cognos Incentive Compensation Management depuis Salesforce, vous pouvez personnaliser l'apparence de Cognos Incentive
Compensation Management pour la rendre plus cohérente avec celle de Salesforce.
Procédure
1. Sélectionnez l'option Thèmes dans le menu Outils du client Cognos Incentive Compensation Management.
2. Dans la section Thème Web, sélectionnez salesforce.com.
Intégration au serveur Web Microsoft IIS
Vous pouvez configurer le serveur Web IIS de Microsoft avec le serveur Web de IBM Cognos Incentive Compensation Management de sorte qu'IIS transmette les demandes à Cognos Incentive Compensation Management et renvoie les réponses à l'utilisateur.
Cette fonction permet d'intégrer Cognos Incentive Compensation Management sous la forme d'une adresse URL (par exemple http://mycompany.com/ICM) à plusieurs pages Web existantes publiées par IIS (par exemple http://
mycompany.com).
Le client Web de Cognos Incentive Compensation Management est conçu comme une application Web J2EE et a besoin d'un serveur d'applications Java (un conteneur de servlet) pour s'exécuter. IIS ne fournissant pas les services d'un serveur d'applications Java, il n'est pas possible d'y déployer directement le client Web de Cognos Incentive Compensation Management. En revanche, IIS peut être configuré pour servir de proxy et transmettre les demandes du client Web de
Cognos Incentive Compensation Management à un serveur d'applications sur lequel Cognos Incentive Compensation Management est déployé. Ainsi, si votre site Web principal s'exécute sur IIS, il est possible d'y intégrer Cognos Incentive Compensation Management.
Si vous devez intégrer le client Web de Cognos Incentive Compensation Management à IIS, déployez-le sur un serveur d'applications Java doté des fonctions d'intégration à IIS. Apache Tomcat en fait partie.
Configuration du client Web en vue de l'intégration avec le serveur Web Microsoft IIS
Avant d'intégrer le serveur Web IIS de Microsoft au serveur Web de IBM Cognos Incentive Compensation Management, vous devez tout d'abord configurer Cognos Incentive Compensation Management et tester le déploiement.
Procédure
1. Installez et configurez le client Web de Cognos Incentive Compensation Management.
2. Déployez le fichier WAR à l'aide d'Apache Tomcat.
Configuration de l'acceptation des demandes transmises par un proxy dans Apache Tomcat
Vous devez configurer Apache Tomcat de manière qu'il accepte les demandes transmises par un proxy à IBM Cognos Incentive Compensation Management et provenant d'IIS, et activer le connecteur AJP/1.3 dans Cognos Incentive
Compensation Management.
Procédure
1. Activez AJP/1.3 Connector dans Apache Tomcat.
a. Editez le fichier server.xml et vérifiez que AJP/1.3 Connectorest activé (c'est-à-dire qu'il n'est pas mis en commentaire).
Le fichier server.xmlest à l'emplacement par défaut suivant : C:\Program Files\Apache Software Foundation\Tomcat 6.0\conf.
b. Retirez les symboles de commentaire (<!-- et -->) autour de la section suivante dans le fichier conf/server.xml : <Connector port="8009"
protocol="AJP/1.3" redirectPort="8443"/>
2. Redémarrez Apache Tomcat et vérifiez que les journaux et la console Apache Tomcat ne contiennent pas d'erreurs relatives aux ports utilisés.
3. Vérifiez que le connecteur AJP écoute le port spécifié (8009 par défaut).
Par exemple, utilisez la commande netstat -nadans la fenêtre de commande et regardez si le port 8009 figure dans la sortie.
Configuration de la transmission des demandes à IBM Cognos Incentive Compensation Management dans IIS
Après avoir déployé le client Web de IBM Cognos Incentive Compensation Management à l'aide d'Apache Tomcat et configuré Tomcat pour l'acceptation des demandes transmises par un proxy, vous devez configurer IIS de manière qu'il transmette les demandes de Cognos Incentive Compensation Management à Apache Tomcat.
Procédure
1. Sur l'ordinateur sur lequel IIS est déployé, téléchargez le fichier isapi_redirect.dlldepuis le site Apache.
2. Lors du téléchargement, sélectionnez la version de Windows sur laquelle IIS s'exécute (win32 ou win64), puis la dernière version de jk disponible
(jk-1.2.31). Le fichier à télécharger s'appelle api_redirect_X.X.X.dll, où X.X.X est le numéro de version. Retirez le numéro de version du fichier DLL (par exemple, isapi_redirect.dll).
3. Placez le fichier DLL et les fichiers de propriétés associés dans un répertoire d'installation. Supposons par exemple que le répertoire s'appelle
C:\tomcat_iis_connector. Placez-y le fichier isapi_redirect.dll.
4. Téléchargez le fichier isapi_redirect.properties et placez-le dans le même répertoire que le fichier isapi_redirect.dll.
5. Créez un répertoire nommé confdans le répertoire d'installation (C:\tomcat_iis_connector\conf).
a. Téléchargez les fichiers uriworkermap.propertieset workers.properties.minimal.
b. Placez-les dans le répertoire C:\tomcat_iis_connector\conf.
6. Créez un répertoire nommé logs(C:\tomcat_iis_connector\logs).
Il est destiné aux journaux associés à l'exécution du fichier isapi_redirect.dll.
7. Dans le répertoire C:\tomcat_iis_connector, il est possible que vous deviez modifier le fichier isapi_redirect.properties. Le fichier
isapi_redirect.properties indique au connecteur où trouver ses fichiers de configuration ainsi que l'emplacement de la DLL par rapport au serveur IIS. Il contient les propriétés suivantes :
extension_uri
Chemin du répertoire virtuel qui contient le fichier isapi_redirect.dll.
og_file
Chemin du répertoire destiné aux fichiers journaux.
log_level
Niveau à partir duquel les journaux doivent être générés.
worker_file
Chemin du fichier workers.properties.minimaldans votre installation.
worker_mount_file
Chemin du fichier uriworkermap.properties dans votre installation.
Si vous installez le connecteur dans le répertoire C:\tomcat_iis_connectoren configurant le répertoire virtuel du fichier isapi_redirect.dllselon les instructions ci-dessous, il n'est pas nécessaire de modifier les propriétés du fichier fourni.
8. Dans le répertoire C:\tomcat_iis_connector\conf, il est possible que vous deviez modifier les fichier uriworkermap.propertieset
workers.properties.minimal.
a. Editez le fichier uriworkermap.propertieset vérifiez qu'il contient le mappage suivant pour Cognos Incentive Compensation Management : /ICM/*=worker1.
b. Editez le fichier workers.properties.minimalet modifiez la propriété worker.ajp13w.hostsi nécessaire.
Cette propriété définit le nom d'hôte et l'adresse IP de l'ordinateur sur lequel Apache Tomcat est exécuté. Si Apache Tomcat s'exécute sur le même ordinateur qu'IIS, vous pouvez conserver la valeur localhost. Si vous avez défini un nom d'hôte comme valeur de cette propriété, vérifiez que
l'ordinateur IIS peut la convertir dans la bonne adresse.
Si vous avez modifié le port du connecteur AJP, vous devez modifier la propriété worker.ajp13w.port.
9. Ouvrez Panneau de configuration > Outils d'administration > Internet Information Services. Si vous utilisez IIS 7.0, vous devez installer les extensions et les filtres ISAPI.
10. Accédez à Démarrer > Tous les programmes > Outils d'administration >
Service Manager.
a. Sélectionnez Web Server (IIS) \\ > Rôles.
b. Cliquez sur Ajouter des services de rôle.
11. Ajoutez un filtre ISAPI à IIS en procédant de l'une des manières suivantes : v Si vous utilisez IIS version 6.0 ou une version antérieure, procédez comme
suit :
a. Cliquez avec le bouton droit sur Site Web par défaut (ou sur le site web chargé de mettre en cache dans le proxy les demandes envoyées à Cognos Incentive Compensation Management) et cliquez sur Propriétés.
b. Cliquez sur l'onglet Filtres ISAPI.
c. Vérifiez qu'un filtre pointe vers le fichier isapi_redirect.dllet que celui-ci est bien à l'endroit indiqué. Sinon, cliquez sur Ajouter et créez-en un.
d. Entrez tomcatcomme nom de filtre et entrez l'emplacement du fichier isapi_redirect.dllcomme exécutable.
e. Cliquez sur Appliquer, puis sur OK.
v Si vous utilisez IIS version 7.0, procédez comme suit :
a. Cliquez sur Site Web par défaut (ou sur le site web chargé de mettre en cache dans le proxy les demandes envoyées à Cognos Incentive
Compensation Management) et cliquez sur Filtres ISAPI.
b. Cliquez sur l'icône Filtres ISAPI.
c. Vérifiez qu'un filtre pointe vers le fichier isapi_redirect.dllet que celui-ci est bien à l'endroit indiqué. Sinon, cliquez sur Ajouter et créez-en un.
d. Entrez tomcatcomme nom de filtre et entrez l'emplacement du fichier isapi_redirect.dll.
e. Cliquez sur OK.
12. Créez un répertoire virtuel pour Cognos Incentive Compensation Management dans IIS.
a. Cliquez avec le bouton droit sur Site Web par défaut (ou sur le site web chargé de mettre en cache dans le proxy les demandes envoyées à Cognos Incentive Compensation Management) et cliquez sur Nouveau >
Répertoire virtuel.
b. Comme valeur de l'alias, entrez sur celle du chemin de contexte, sans barres obliques, défini à la section Configuration de Cognos Incentive Compensation Management de ce document. Il peut pointer vers le répertoire de votre choix.
13. Créez un répertoire virtuel pour accéder au fichier isapi_redirect.dlldans IIS en procédant de l'une des manières suivantes :
v Si vous utilisez IIS version 6.0 ou une version antérieure, procédez comme suit :
a. Cliquez avec le bouton droit sur Site Web par défaut (ou sur le site web chargé de mettre en cache dans le proxy les demandes envoyées à Cognos Incentive Compensation Management) et cliquez sur Nouveau >
Répertoire virtuel.
b. Définissez l'alias sur jakarta. Celui-ci doit pointer vers le répertoire dans lequel est installé le fichier isapi_redirect.dll. Dans notre exemple, il s'agit de C:\tomcat_iis_connector.
c. Cochez la case Exécuter.
v Si vous utilisez IIS version 7.0, procédez comme suit :
a. Cliquez avec le bouton droit sur Site Web par défaut ou sur le site web chargé de mettre en cache dans le proxy les demandes envoyées à Cognos Incentive Compensation Management, et cliquez sur Ajouter un répertoire virtuel.
b. Définissez l'alias.
c. Chemin d'accès physiquedoit pointer vers le répertoire dans lequel le fichier isapi_redirect.dllest installé. Dans notre exemple, il s'agit de C:\tomcat_iis_connector.
d. Cliquez sur le répertoire virtuel de l'alias, puis cliquez deux fois sur Mappages de gestionnaires.
e. Cliquez sur Modifier les autorisations de fonction dans le panneau Action.
f. Cochez la case Exécuter.
f. Cochez la case Exécuter.