ESS : connecteur de gestion des services d'effet
ESS : connecteur de gestion des services d'effet
Connecteur Efecte Service Management en bref
Avec l'aide de ce connecteur, Efecte Self-Service peut
- Créer de nouveaux incidents et demandes de service dans Efecte Service Management
- Mises à jour du sondage lorsque les incidents et les demandes de service sont modifiés dans Efecte Service Management (par exemple, lorsque le statut de la demande est modifié)
- Sondage et envoi de données d'évaluation sur les articles de la base de connaissances en lien avec les trucs et astuces
- Sondage et envoi de données d'évaluation et de commentaires sur de nouvelles idées en lien avec Like My Idea
- Interroger les données utilisateur dynamiques d'Efecte Service Management (MyServices)
- Sondage des données pour maintenir les données de l'offre de service à jour (éléments du catalogue)
- Envoyer des décisions d'approbation pour les approbations de flux de travail visuel dans Efecte Service Management
- Envoyer les commentaires recueillis auprès des utilisateurs finaux à Efecte Service Management
La plupart des fonctionnalités du connecteur fonctionnent automatiquement en utilisant les valeurs par défaut auxquelles il est fait référence dans tout ce document.
Cet article décrit le comportement d'Efecte Service Management Connector dans la version ESS 2022.3 ou plus récente.
Note
Pour deux cas d'utilisation, Efecte Service Management envoie activement des données à Efecte Self-Service. Il s'agit des annonces de problèmes affectant de nombreuses personnes et des approbations pour l'automatisation visuelle des workflows, où la décision est censée être prise dans Efecte Self-Service. Pour tous les autres cas, Efecte Self-Service est l'acteur principal.
Modèles pris en charge
Deux modèles sont pris en charge par défaut pour le connecteur Efecte : Demande de service (ServiceRequest) et Incident (incident). Si plusieurs modèles doivent être pris en charge, plusieurs connecteurs ESM peuvent être déployés pour le locataire et la destination des requêtes peut différer de celle par défaut. Dans ce cas, un seul connecteur peut inclure la base de connaissances et, comme je l'ai suggéré, la configuration. Si plusieurs connecteurs sont configurés, le jeu de résultats utilisé pour afficher les articles sur la page d'accueil est le dernier récupéré par Efecte Self-Service, ce qui peut engendrer une expérience utilisateur confuse, notamment avec des pointeurs vers différentes sources au sein d'ESM.
D'un autre côté, l'utilisation d'un modèle unique peut être intéressante. Avec une configuration appropriée, toutes les requêtes peuvent être dirigées vers le modèle souhaité. Cependant, soyez attentif aux codes d'attributs et aux valeurs de statut, ainsi qu'aux moyens de séparer les différents types de requêtes afin d'éviter la génération de journaux superflus dus à des configurations incohérentes.
Format de message ESM
Le format des messages échangés entre les produits ESS et ESM est codé en dur.
Remarque : les champs à valeurs multiples pour la fonctionnalité MyService sont transmis au format CSV dans les balises XML.
Configuration de la connexion
Pour configurer la connexion pour ESM, utilisez le bean de la classe com.efecte.integration.connector.configuration.ConnectionConfiguration, comme dans l'exemple suivant :
<bean id="connectionConfiguration" class="com.efecte.integration.connector.configuration.ConnectionConfiguration">
<property name="url" value="https://xxxxxxxxx.efectecloud.com/api/itsm" />
<property name="user" value="webapi-user" />
<property name="password" value="xxxxxxxxxxxxxxxxxxxxxxxxxx" />
<property name="connectionRequestTimeout" value="300" />
<property name="connectTimeout" value="300" />
<property name="socketTimeout" value="300" />
<property name="acceptSelfSignedCertificates" value="false"/>
<property name="allowAllHostnamesInCertificate" value="false"/>
</bean>Remarque ! Lorsque plusieurs connecteurs sont utilisés et que certains d'entre eux font référence à des configurations de connexion différentes (par exemple, un environnement différent), ils doivent avoir un identifiant unique pour chaque configuration de connexion. Autrement dit, assurez-vous de ne pas utiliser le même identifiant de bean pour deux configurations de connexion différentes. Cette configuration s'applique lors de la connexion à deux environnements ESM différents depuis un même ESS ; il peut donc être judicieux d'indiquer l'environnement dans l'identifiant du bean, par exemple.
bean id="connectionConfigurationEnvName”
Ce bean prend en charge les propriétés suivantes :
| Nom | Valeur par défaut | Description |
| URL | http://efecte.company.com | URL de API ESM |
| utilisateur | utilisateur de l'API Web | nom d'utilisateur |
| mot de passe | Mot de passe API ESM | |
| accepter les certificats auto-signés | FAUX | Si les « vrais » certificats auto-signés sont acceptés |
| autoriser tous les noms d'hôtes dans le certificat | FAUX | Si « true » est activé, la vérification du nom d'hôte du serveur est désactivée pour les certificats. Cette option doit toujours être définie sur « false » sur les systèmes de production ! |
| Délai d'expiration de la demande de connexion | 300 | Renvoie le délai d'expiration en secondes utilisé lors de la demande de connexion au gestionnaire de connexions. Une valeur de délai d'expiration de zéro est interprétée comme un délai d'expiration infini. Une valeur de délai d'expiration de zéro est interprétée comme un délai d'expiration infini. Une valeur négative est interprétée comme indéfinie (valeur par défaut du système). |
| délai de connexion expiré | 300 | Détermine le délai d'expiration (en secondes) avant l'établissement d'une connexion. Une valeur nulle est interprétée comme un délai infini. Une valeur négative est interprétée comme indéfinie (valeur par défaut du système). |
| délai d'expiration du socket | 300 | Définit le délai d'attente du socket (SO_TIMEOUT) en secondes. Il s'agit du délai d'attente des données, autrement dit, de la durée maximale d'inactivité entre deux paquets de données consécutifs. Une valeur de zéro est interprétée comme un délai infini. Une valeur négative est interprétée comme indéfinie (valeur par défaut du système). |
Configuration de la demande de service
Les mappages d'attributs de demande de service peuvent être définis dans le fichier connector-efecte.xml. Exemple de configuration de toutes les options disponibles :
<bean id="connectorEfecte"
class="com.efecte.integration.connector.efecte.EfecteConnector">
<property name="serviceRequestAttributes">
<bean class="com.efecte.integration.connector.configuration.ServiceRequestAttributes">
<property name="templateCode" value="ServiceRequest"/>
<property name="bundleTemplateCode" value="ServiceRequestBundle"/>
<property name="folderCode" value="ServiceRequests"/>
<property name="attachmentAttribute" value="RequestAttachments"/>
<property name="statusAttribute" value="status"/>
<property name="reopenReasonAttribute" value="reopen_reason"/>
<property name="creationDateAttribute" value="created"/>
<property name="deadlineAttribute" value="deadline"/>
<property name="updatedAttribute" value="updated"/>
<property name="efecteIdAttribute" value="efecte_id"/>
<property name="languageAttribute" value="Language"/>
<property name="feedbackAttribute" value="rating"/>
<property name="resolutionTextAttribute" value="resolution"/>
<property name="supportPersonAttribute" value="support_person"/>
<property name="serviceOfferingNameAttribute" value="ServiceOffering"/>
<property name="serviceItemNameAttribute" value="ServiceItemName"/>
<property name="serviceItemExternalIdAttribute" value="ServiceItem"/>
<property name="priceAttribute" value="Price"/>
<property name="monthlySubscriptionAttribute" value="MonthlySubscription"/>
<property name="requestedForAttribute" value="RequestedFor"/>
<property name="costCenterAttribute" value="CostCenter"/>
<property name="deliveryAddressAttribute" value="DeliveryAddress"/>
<property name="orderedByAttribute" value="OrderedBy"/>
<property name="additionalInformationAttribute" value="AdditionalInformation"/>
<property name="siteIDAttribute" value="SiteID"/>
<property name="siteNameAttribute" value="SiteName"/>
<property name="requestBundleAttribute" value="RequestBundle"/>
<property name="requestBundleNameAttribute" value="RequestBundleName"/>
<property name="orderedByEmailAttribute" value="OrderedBy:email"/>
<property name="requestedForEmailAttribute" value="RequestedFor:email"/>
<property name="commentAttribute" value="external_comments"/>
<property name="reasonAttribute" value="user_reason"/>
<property name="dedicatedApproverAttribute" value="DedicatedApprover"/>
<property name="superiorApproverAttribute" value="approving_manager"/>
<property name="totalPriceAttribute" value="totalPrice"/>
<property name="quantityAttribute" value="quantity"/>
<property name="totalMonthlySubscriptionAttribute"value="TotalMonthlySubscription"/>
<property name="punchout" value="punchOutOrderId"/>
</bean>
</property>
<!-- other configuration -->
</bean> La cartographie des incidents peut être ajustée via l'interface d'administration du locataire, dans l'onglet Configuration des canaux d'assistance. Lors de la création d'un canal d'assistance, les valeurs par défaut sont visibles dans la configuration.
Les règles détaillées pour le traitement des propriétés des demandes de service sont les suivantes :
| Nom de l'attribut | Description |
| attribut d'intégration | Si présent, la mise à niveau d'une demande de service existante sera effectuée (mappée dans le bean GeneralConfiguration, il est recommandé de ne pas la modifier – la valeur par défaut est WebShopId) |
| attribut d'identification d'effet | Si integrationIdAttribute est vide et qu'il n'y a aucune demande dans ESS avec la valeur efecteIdAttribute donnée, une nouvelle demande de service sera créée ; si une demande avec la valeur efecteIdAttribute donnée est présente dans ESS, la mise à jour de la demande existante sera exécutée. |
| Attribut demandé pour e-mail | Un utilisateur avec cette adresse e-mail doit figurer dans les informations de l'organisation dans ESS. Dans le cas contraire, la demande de service sera rejetée avec les informations correctes dans le fichier journal ESS (exemple d'entrée de journal : Impossible de faire correspondre l'utilisateur avec l'adresse e-mail… à l'utilisateur. La demande de service n'est pas créée pour l'ID…). |
| Attribut commandé par e-mail | Un utilisateur avec une adresse e-mail correspondante doit exister dans les informations de l'organisation. S'il n'existe pas, la demande de service sera rejetée et les informations appropriées seront consignées dans le fichier journal ESS. Si la valeur du champ est vide, l'attribut requestedForEmailAttribute sera utilisé. |
| Attribut serviceItemExternalId | L'élément de service portant cet identifiant doit exister et être valide ( des vérifications sont également effectuées sur la copie de travail ). Si cette condition n'est pas remplie, la demande de service est rejetée avec les informations correctes dans le fichier journal ESS. |
| Attribut de nom d'offre de service | Si l'attribut est défini, la demande de service sera créée avec ce nom. Si l'attribut n'est pas défini, le nom de l'offre de service sera copié à partir de l'offre de service trouvée à partir de serviceItemExternalIdAttribute. |
| Attribut du nom de l'élément | Si l'attribut est défini, la demande de service sera créée avec ce nom. Si l'attribut n'est pas défini, le nom de l'élément de service sera copié à partir de l'élément de service trouvé à partir de serviceItemExternalIdAttribute. |
| Attribut de prix / Attribut d'abonnement mensuel | Si l'attribut est défini, la demande de service sera créée avec ce prix/abonnement mensuel. Si l'attribut n'est pas défini, les attributs seront copiés à partir de l'élément de service trouvé à partir de serviceItemExternalIdAttribute. |
| Attribut d'informations supplémentaires | Si la valeur de l'attribut d'informations supplémentaires d'ESM commence par « Description », le connecteur prendra en compte le texte suivant la partie « Description » jusqu'à la fin de la ligne. Si le champ d'informations supplémentaires ne commence pas par le préfixe « Description », tout le contenu de la valeur de l'attribut sera traité. |
| reasonAttribute | Collecte la valeur saisie par l'utilisateur dans le champ « Motif » lors de la confirmation de commande. Par défaut, la valeur correspond au code d'attribut ESM « user_reason ». |
| Attribut de groupe de demandes | La valeur de cet attribut est unique à chaque commande groupée dans la base de données ESS. Elle est mappée à l'attribut ESM « RequestBundle ». Chaque commande groupée peut comporter une ou plusieurs demandes de service, chacune possédant son propre serviceItemExternalIdAttribute. |
| Attribut requestBundleName | La valeur de cet attribut correspond au nom de l'offre uid . Cette valeur est mappée à l'attribut ESM « RequestBundleName ». |
Si l'option « Quantité d'articles activée » est sélectionnée pour l'offre de service, les règles supplémentaires suivantes sont traitées pour la demande de service :
| Nom de l'attribut | Description |
|
quantitéAttribut |
Les informations quantitatives de la commande dans l'ESS sont transmises à l'attribut ESM dont le code est « quantité ». Le type d'attribut dans l'ESM doit être « numéro ». |
|
AttributPrixtotal |
Le prix total de chaque commande de service dans l'ESS est transmis à l'attribut ESM dont le code est « totalPrice ». Le type d'attribut dans l'ESM peut être un nombre décimal. |
|
Attribut d'abonnement mensuel total |
Le prix total de l'abonnement mensuel de chaque commande de service dans l'ESS est transmis à l'attribut ESM dont le code est « TotalMonthlySubscription ». Le type d'attribut dans l'ESM peut être un nombre décimal. |
Remarque ! Les attributs listés ci-dessus sont les valeurs par défaut. Si elles doivent être modifiées, les codes correspondants doivent être ajoutés au fichier du connecteur.
La fonctionnalité PunchOut permet aux utilisateurs d'Efecte Self-Service d'utiliser une boutique en ligne externe pour collecter des articles dans le cadre de leur demande de service. Les attributs suivants sont requis dans le connecteur pour la fonctionnalité PunchOut. Consultez le uid de configuration PunchOut pour plus d'informations.
| Nom de l'attribut | Description |
|
AttributPrixtotal |
Voir ci-dessus |
|
poinçonnage |
Le code punchOutOrderId de l'attribut punchout sert d'identifiant de commande. Il doit être renseigné avant qu'une commande approuvée soit envoyée au fournisseur de services PunchOut. |
Connecteur de suivi
Le connecteur de suivi déclenche l'interrogation des mises à jour d'Efecte Service Management pour les incidents et les demandes de service. Le mappage de domaine par défaut pour les incidents provenant d'ESM vers ESS et le mappage d'éléments de service pour les demandes de service peuvent être configurés en définissant les propriétés suivantes du bean EfecteTrackingConnector :
| Nom | Valeur par défaut | Description |
| ID de catégorie d'intégration par défaut | CATÉGORIE_PAR_DÉFAUT | Mappage de domaine par défaut pour les incidents |
| ID d'élément de service d'intégration par défaut | ÉLÉMENT_DE_SERVICE_PAR_DEFAUT | Mappage des éléments de service par défaut pour les demandes de service |
| pollNewServiceRequestActivé | FAUX | Permet l'interrogation des nouvelles demandes de service provenant d'ESM |
| sondageNewIncidentActivé | vrai | Si défini sur false, il ne récupère pas les incidents avec un u uid vide (ceux qui sont créés dans ESM et non dans ESS) |
Remarque ! Par défaut, les incidents sont interrogés, et non les demandes de service. Pour interroger également les demandes de service, le connecteur de suivi des effets doit être ajouté au fichier connecteur.
Pour que le nouveau sondage des demandes de service fonctionne correctement, les attributs suivants sont obligatoires côté ESM :
- Identifiant de la requête transmis dans efecteIdAttribute, par défaut « efecte_id »
- Statut transmis dans statusAttribute.default 'status'
- Identifiant client transmis dans requestedForEmailAttribute par défaut « RequestedFor:email »
- ID d'élément transmis dans serviceItemExternalIdAttribute, par défaut « ServiceItem » - si la valeur de cet attribut est vide, le connecteur prendra la valeur de defaultIntegrationServiceItemId dans la configuration du connecteur de suivi
Pour que le nouveau sondage d'incident fonctionne correctement, les attributs suivants sont obligatoires côté ESM :
- Identifiant de l'incident transmis dans efecteIdAttribute, par défaut « efecte_id »
- Statut transmis dans le statusAttribute.default 'status'
- Identifiant client transmis dans l'attribut e-mail client, par défaut customer:email
- ID de catégorie transmis dans integrationCategoryAttribute, WebShopCategory par défaut - si la valeur de cet attribut est vide, le connecteur prendra la valeur de defaultIntegrationCategoryId dans la configuration du connecteur de suivi (une catégorie avec l'ID de catégorie doit être publiée dans ESS)
La fréquence d'interrogation peut être ajustée à l'aide des propriétés « updateFrequency » et « errorUpdateFrequency » de la classe « EfecteTrackingConnector ». Les valeurs sont exprimées en unités configurables.
Remarque ! Il est très rarement nécessaire de modifier la valeur par défaut de « updateQuerySlidingWindowTime ». Les données d'interrogation incluent toujours toutes les cartes de données modifiées au cours de la période, et au-delà, les mêmes tickets sont renvoyés à plusieurs reprises dans le jeu de résultats. Dès la première tentative, le ticket est mis à jour dans ESS. Augmenter cette fenêtre risque de ralentir les opérations dans ESS et ESM, sans aucun avantage supplémentaire.
| Nom | Valeur par défaut | Description |
| fréquence de mise à jour | 10 | Période de rafraîchissement lorsque les données ont été récupérées avec succès |
| mettre à jour l'unité de fréquence | MINUTES | Unité de fréquence de la période de rafraîchissement (réussie) |
| erreurUpdateFrequency | 10 | Période de rafraîchissement lorsque la récupération des données a échoué |
| erreurUpdateFrequencyUnit | MINUTES | Unité de fréquence de la période de rafraîchissement (erreur) |
Lors de sa première exécution, le connecteur récupère les requêtes et les incidents des dernières 24 heures. Ce délai peut être ajusté en configurant les propriétés initialQuerySlidingWindowTime et initialQuerySlidingWindowUnit.
Les autres valeurs par défaut du connecteur de suivi des effets sont :
| Nom | Valeur par défaut | Description |
| updateQuerySlidingWindowTime | 20 | À partir de quelle période les données sont récupérées, en comparaison avec l'heure de la dernière mise à jour de l'ESM (par exemple, à partir des 20 dernières minutes) |
| updateQuerySlidingWindowUnit | MINUTES | Unité de fréquence de la période de rafraîchissement (réussie) |
| initialQuerySlidingWindowTime | 1 | À partir de quelle période les données sont récupérées lors de la première exécution, en comparaison avec l'heure de la dernière mise à jour de l'ESM (par exemple, à partir des dernières 24 heures) |
| unité de fenêtre coulissante de requête initiale | JOURS | Unité de fréquence de la période de rafraîchissement (erreur) |
| serviceRequestPollCondition | La condition par défaut pour les mises à jour des demandes de service d'interrogation | |
| incidentPollCondition | La condition par défaut pour les mises à jour des incidents d'interrogation |
Exemple de configuration :
<property name="efecteTrackingConnector">
<bean class="com.efecte.integration.connector.efecte.EfecteTrackingConnector">
<property name="updateQuerySlidingWindowTime" value="20"/>
<property name="updateQuerySlidingWindowUnit" value="MINUTES"/>
<property name="initialQuerySlidingWindowTime" value="1"/>
<property name="initialQuerySlidingWindowUnit" value="DAYS"/>
<property name="updateFrequency" value="10" />
<property name="updateFrequencyUnit" value="MINUTES" />
<property name="errorUpdateFrequency" value="10" />
<property name="errorUpdateFrequencyUnit" value="MINUTES" />
<property name="defaultIntegrationServiceItemId" value="DEFAULT_SERVICE_ITEM" />
<property name="pollNewServiceRequestEnabled" value="false" />
<property name="defaultIntegrationCategoryId" value="DEFAULT_EFECTE_CATEGORY"/>
<property name="serviceRequestPollCondition" value="and $creator$ = 'WebAPI'"/>
<property name="incidentPollCondition" value="and $creator$ = 'WebAPI'"/>
<property name="pollNewIncidentEnabled" value="true" />
</bean>
</property>Si la propriété « updateQuerySlidingWindowTime » n'est pas configurée dans le connecteur de suivi, la valeur de « pollingInterval » multipliée par deux (2) sera utilisée comme taille de fenêtre glissante par défaut.
Formulaire de commentaires
Le formulaire de commentaires est pris en charge par défaut dans le connecteur ESM. Les attributs utilisés pour le mappage aux champs ESM peuvent être configurés en modifiant les propriétés de la classe EfecteFeedbackFormConnector du bean et dans le formulaire lui-même, via l'onglet « Gestion des commentaires » de l'interface d'administration. Les propriétés suivantes sont prises en charge :
| Nom | Valeur par défaut | Description |
| code de modèle | gestion des commentaires | Code du modèle de formulaire de commentaires |
| code de dossier | retour | Dossier de formulaire de commentaires |
| attribut d'identification d'effet | ticket_id | Nom de l'attribut qui contient l'ID du ticket |
| Attribut client | client | Nom de l'attribut qui contient la référence client |
| Attribut de notation | évaluation des billets | Nom de l'attribut qui contient la note numérique |
Exemple de configuration de EfecteFeedbackFormConnector dans EfecteConnector dans connector-efecte.xml :
<bean id="defaultConnectorEfecte" class="com.efecte.integration.connector.efecte.EfecteConnector">
<property name="connectionConfiguration" ref="connectionConfiguration" />
<property name="feedbackFormConnector">
<bean class="com.efecte.integration.connector.efecte.EfecteFeedbackFormConnector">
<property name="feedbackAttributes">
<bean class="com.efecte.integration.connector.configuration.FeedbackAttributes">
<property name="templateCode" value="feedback_management" />
<property name="folderCode" value="feedback" />
<property name="efecteIdAttribute" value="ticket_id" />
<property name="customerAttribute" value="customer" />
<property name="ratingAttribute" value="ticket_rating" />
</bean>
</property>
</bean>
</property>
</bean>Note
Pour soumettre un retour sur les problèmes initialement enregistrés dans l'outil de gestion des services Efecte, assurez-vous que les problèmes sont d'abord transmis au portail libre-service Efecte via le connecteur de suivi. Le service d'assistance technique doit avoir le problème dans sa base de données avant de pouvoir soumettre un retour.
Conseils et astuces
Cette fonctionnalité permet d'importer Knowledge Base depuis le système de gestion des services Efecte. Pour plus de détails, veuillez consulter le uid de configuration complet.
Configuration de la suite d'intégration
Tous les fichiers de configuration d'Integration Suite se trouvent dans le répertoire /etc/integration-hub/ et ses sous-répertoires. Les connecteurs spécifiques aux locataires se trouvent dans les sous-répertoires tenant-configs/{tenant_name}.
Pour configurer la prise en charge des « Trucs et astuces » dans Integration Suite, veuillez modifier le fichier connector-efecte.xml. Ajoutez le bean de la classe « EfecteKnowledgeBaseConnector » et fournissez-lui le bean de configuration de connexion ESM.
<bean id="connectionConfiguration"
class="com.efecte.integration.connector.configuration.ConnectionConfiguration">
<property name="url" value=" http://efecte.efecte.com/efecte " />
<property name="user" value="webapi-user" />
<property name="password" value="PASSWORD" />
</bean>
<bean id="efecteKnowledgeBaseConnector" class="com.efecte.integration.connector.efecte.EfecteKnowledgeBaseConnector">
<property name="connectionConfiguration" ref="connectionConfiguration"/>
</bean>Remarque ! Il est recommandé de partager la configuration des connexions entre les connecteurs Efecte. Voici donc le code suivant (couramment utilisé dans les configurations) :
<bean id="defaultConnectorEfecte" class="com.efecte.integration.connector.efecte.EfecteConnector">
<property name="connectionConfiguration">
<bean class="com.efecte.integration.connector.configuration.ConnectionConfiguration">
<property name="url" value="http://efecte.company.com" />
<property name="user" value="webapi-user" />
<property name="password" value="PASSWORD" />
</bean>
</property>
</bean>peut être remplacé par :
<bean id="defaultConnectorEfecte" class="com.efecte.integration.connector.efecte.EfecteConnector">
<property name="connectionConfiguration" ref="connectionConfiguration"/>
</bean>Configuration des paramètres du modèle de base de connaissances
Afin d'ajuster les noms des attributs utilisés dans ESM pour la prise en charge Knowledge Base , les paramètres du modèle peuvent être configurés en ajoutant la propriété knowledgeBaseAttributes au bean effecteKnowledgeBaseConnector. Sinon, les paramètres par défaut seront utilisés.
<bean id="efecteKnowledgeBaseConnector" class="com.efecte.integration.connector.efecte.EfecteKnowledgeBaseConnector">
<property name="connectionConfiguration" ref="connectionConfiguration"/>
<property name="knowledgeBaseAttributes" >
<bean id="knowledgeBaseAttributes" class="com.efecte.integration.connector.configuration.KnowledgeBaseAttributes">
<property name="templateCode" value="knowledge_base_article"/>
<property name="pollingFolderCode" value="knowledge_base"/>
<property name="updateReadStatsFallbackFolderCode" value="knowledge_base"/>
<property name="ratingFallbackFolderCode" value="knowledge_base"/>
<property name="publishedInEssAttr" value="published_in_self_service"/>
<property name="publishedInEssValue" value="Yes"/>
<property name="deletedAttr" value="deleted"/>
<property name="nameAttr" value="solution_name"/>
<property name="descriptionAttr" value="solution_description"/>
<property name="categoryAttr" value="category"/>
<property name="adGroupsAttr" value="ad_groups"/>
<property name="efecteIdAttr" value="efecte_id"/>
<property name="updatedAttr" value="updated"/>
<property name="ratingAttr" value="rating"/>
<property name="rankingAttr" value="rating"/>
<property name="readStatsAttr" value="read_count"/>
<property name="keywordsAttr" value="solution_keywords"/>
<property name="keywordsSeparator" value=","/>
</bean>
</property>
</bean>Les propriétés suivantes de la classe bean KnowledgeBaseAttributes sont prises en charge :
| Nom | Valeur par défaut | Description |
| code de modèle | article_de_la_base_de_connaissances | Code du modèle Knowledge Base |
| code du dossier de sondage | si pollingFolderCode est défini, les articles sont interrogés uniquement à partir de ce dossier. Si pollingFolderCode n'est PAS défini, les articles sont interrogés sans limitation de dossier. |
|
| évaluationFallbackFolderCode | base de connaissances | Nom du code du dossier de secours utilisé lors de l'enregistrement du vote. |
| mettre à jourReadStatsFallbackFolderCode | base de connaissances | Nom du code du dossier de secours utilisé lors de la mise à jour des statistiques de lecture. |
|
|
Nom de l'attribut, indiquant si l'article doit être récupéré sur ESS |
|
|
Valeur de l'attribut nommé dans publishedInEssAttr indiquant que l'article doit être récupéré. |
|
|
Nom de l'attribut, indiquant si l'article de la base de connaissances est supprimé |
|
|
Nom de l'attribut qui contient le nom de l'article de la base de connaissances |
|
|
Nom de l'attribut qui contient le contenu de l'article de la base de connaissances |
|
|
Nom de l'attribut qui contient la catégorie de l'article de la base de connaissances |
|
|
Attribut ESM utilisé pour le filtrage des trucs et astuces en fonction du rôle EIM de l'utilisateur connecté |
|
|
Nom de l'attribut qui contient l'ID effectif de l'article de la base de connaissances |
|
|
Nom de l'attribut qui contient la date de la dernière mise à jour de l'article de la base de connaissances |
|
|
Nom de l'attribut, indiquant où les commentaires de la base de connaissances doivent être stockés |
|
|
Nom de l'attribut, indiquant où le classement de la base de connaissances est stocké |
|
|
Nom de l'attribut qui contient les statistiques de lecture de l'article de la base de connaissances |
|
|
Nom de l'attribut qui contient les mots-clés d'un article de la base de connaissances |
|
|
Si un article de la base de connaissances comporte plusieurs mots-clés, ce séparateur de mots-clés doit être utilisé |
Configuration de la fréquence de mise à jour des « Trucs et astuces »
Par défaut, si aucune erreur ne se produit, la base de connaissances est mise à jour toutes les deux heures. En cas d'erreur, le temps d'actualisation est ramené à deux minutes.
Le délai de démarrage de la planification (temps après lequel le connecteur commencera à fonctionner mesuré depuis le démarrage du hub d'intégration) peut être configuré à l'aide de la propriété startUpDelay pour le bean connectorScheduler dans le fichier hub.xml.
| Nom | Valeur par défaut | Description |
| délai de démarrage | 20000 | Durée (en millisecondes) après laquelle la première récupération est effectuée (par défaut : 20 secondes) |
Exemple de hub.xml :
<bean name="connectorScheduler" class="com.efecte.integration.container.ConnectorScheduler">
<property name="taskScheduler" ref="taskScheduler"/>
<property name="startUpDelay" value="20000"/>
</bean> Les fréquences de mise à jour et d'erreur peuvent être configurées dans la configuration XML du connecteur (connector-efecte.xml). Veuillez utiliser les propriétés suivantes :
| Nom | Valeur par défaut | Description |
| fréquence de mise à jour | 2 | Période de rafraîchissement lorsque la base de connaissances a été récupérée avec succès (par défaut : 2 heures) |
| mettre à jour l'unité de fréquence | HEURES | Unité de fréquence de la période de rafraîchissement (réussie) |
| erreurUpdateFrequency | 2 | Période d'actualisation lorsque la récupération de la base de connaissances échoue (par défaut : 2 minutes) |
| erreurUpdateFrequencyUnit | MINUTES | Unité de fréquence de la période de rafraîchissement (erreur) |
Exemple de connector-efecte.xml :
<bean id="efecteKnowledgeBaseConnector" class="com.efecte.integration.connector.efecte.EfecteKnowledgeBaseConnector">
<property name="connectionConfiguration" ref="connectionConfiguration"/>
<property name="updateFrequency" value="30"/>
<property name="updateFrequencyUnit" value="SECONDS"/>
</bean>J'aime mon idée
Cette fonctionnalité permet d'afficher et de commenter les idées stockées dans le système Efecte Service Management.
Tous les fichiers de configuration d'Integration Suite se trouvent dans le répertoire /etc/integration-hub/ et ses sous-répertoires. Les connecteurs spécifiques aux locataires se trouvent dans les sous-répertoires tenant-configs/{tenant_name}.
Pour configurer la prise en charge de « J'aime mon idée » dans Integration Suite, veuillez modifier le fichier connector-efecte.xml. Ajoutez « http://www.springframework.org/schema/context ». http://www.springframework.org/schema/context/spring-context-4.2.xsd " emplacements de schéma pour la définition des beans principaux.
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
http://camel.apache.org/schema/spring http://camel.apache.org/schema/spring/camel-spring.xsd
http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.2.xsd">Ajoutez l'élément « annotation-config » et le bean de la classe « EfecteLikeMyIdeaConnector » et fournissez-lui un bean de configuration de connexion ESM. Ajoutez également un bean de type « EfecteConnectorContext ».
<bean id="efecteLikeMyIdeaConnector" class="com.efecte.integration.connector.efecte.EfecteLikeMyIdeaConnector" autowire="constructor">
<property name="connectionConfiguration" ref="connectionConfiguration"/>
<property name="likeMyIdeaAttributes" >
<bean id="likeMyIdeaAttributes" class="com.efecte.integration.connector.configuration.LikeMyIdeaAttributes">
<property name="nameAttr" value="demand_name"/>
<property name="ratingFallbackFolderCode" value="ideas"/>
<property name="descriptionAttr" value="demand_details"/>
<property name="efecteIdAttr" value="efecte_id"/>
<property name="createdAttr" value="created"/>
<property name="likesAttr" value="likes"/>
<property name="dislikesAttr" value="dislikes"/>
<property name="templateCode" value="ideas"/>
<property name="pollingFolderCode" value="ideas"/>
<property name="deletedAttr" value="deleted"/>
<property name="commentsAttr" value="comment"/>
<property name="publishedInEssAttr" value="publish_for_rating" />
<property name="publishedInEssValue" value="Yes" />
</bean>
</property>
</bean>Les propriétés suivantes de la classe bean LikeMyIdeaAttributes sont prises en charge :
| Nom | Valeur par défaut | Description |
| code de modèle | gestion_de_la_demande_fr | Code du modèle J'aime mon idée |
| code du dossier de sondage | idées | Si pollingFolderCode est défini, les idées sont interrogées uniquement à partir de ce dossier. Si pollingFolderCode n'est pas défini, les idées sont interrogées sans limitation de dossier. |
| évaluationFallbackFolderCode | idées | Nom du code du dossier de secours utilisé lors de l'enregistrement du vote. |
|
|
Nom de l'attribut, indiquant si l'article doit être récupéré sur ESS |
|
|
Valeur de l'attribut nommé dans publishedInEssAttr indiquant que l'article doit être récupéré. |
|
|
Nom de l'attribut, indiquant si l'idée est supprimée |
|
|
Nom de l'attribut contenant la date de création |
|
|
Nom de l'attribut qui contient le nom de l'idée |
|
|
Nom de l'attribut qui contient le contenu de l'idée |
|
|
Nom de l'attribut qui contient l'ID d'effet de l'idée |
|
|
Nom de l'attribut contenant le nombre de likes |
|
|
Nom de l'attribut contenant le nombre de dislikes |
|
|
Nom de l'attribut qui contient les commentaires |
Configuration de la fréquence de mise à jour « J'aime mon idée »
Par défaut, si aucune erreur ne se produit, la section « J'aime mes idées » est mise à jour toutes les deux heures. En cas d'erreur, le temps d'actualisation est ramené à deux minutes.
Le délai de démarrage de la planification (temps écoulé depuis le démarrage du hub d'intégration) peut être configuré à l'aide de la propriété startUpDelay du bean connectorScheduler dans le fichier hub.xml. Veuillez suivre les instructions de la section Trucs et astuces.
Les fréquences de mise à jour et d'erreur peuvent être configurées dans la configuration XML du connecteur (connector-efecte.xml). Veuillez utiliser les propriétés suivantes :
| Nom | Valeur par défaut | Description |
| fréquence de mise à jour | 2 | Période de rafraîchissement lorsque les idées sont récupérées avec succès (par défaut : 2 heures) |
| mettre à jour l'unité de fréquence | HEURES | Unité de fréquence de la période de rafraîchissement (réussie) |
| erreurUpdateFrequency | 2 | Période de rafraîchissement lorsque la récupération d'idées échoue (par défaut : 2 minutes) |
| erreurUpdateFrequencyUnit | MINUTES | Unité de fréquence de la période de rafraîchissement (erreur) |
Exemple de connector-efecte.xml :
<bean id="efecteLikeMyIdeaConnector" class="com.efecte.integration.connector.efecte.EfecteLikeMyIdeaConnector">
<property name="connectionConfiguration" ref="connectionConfiguration"/>
<property name="updateFrequency" value="30"/>
<property name="updateFrequencyUnit" value="SECONDS"/>
</bean>Mes services
Mes services est un nom commun pour un ensemble de mécanismes d'intégration permettant aux systèmes externes de modifier dynamiquement le contenu du catalogue visible par les utilisateurs.
Définition des champs MyServices
- Accédez à la page d'administration ESS -> Intégrations -> Champs de données externes
- Appuyez sur le bouton Ajouter le champ Mes services
- Entrer la configuration
- Nom du champ - saisissez le nom qui sera utilisé comme alias pour ce champ MyServices
- Données de - sélectionnez le connecteur Efecte Service Management
- Données de modèle d' Efecte Service Management mappées au champ Mes services (Connectez-vous à Efecte Service Management -> Administration -> Modèles -> sélectionner un modèle)
- Code de dossier – facultatif, limite les éléments à récupérer au dossier défini
- Code du modèle - remplir avec la valeur d'utilisation du code du modèle
- Code d'attribut de nom - code de l'attribut utilisé comme nom (cet attribut peut être visible par l'utilisateur)
- Code d'attribut d'identification technique - code d'attribut utilisé comme identifiant DataCard (doit être marqué comme attribut principal dans ESM)
- Code d'attribut utilisateur - référence au modèle décrivant l'utilisateur associé à ce modèle (le modèle cible doit avoir un attribut de courrier électronique pour que les associations d'utilisateurs fonctionnent correctement)
- Appuyez sur le bouton Mettre à jour - s'il n'y a pas d'erreurs, dans le tableau des éléments de champ MyServices, vous devriez voir les noms des DataCards d' Efecte Service Management
- Vous pouvez le vérifier en consultant un tableau avec des cartes de données associées au modèle sélectionné dans ESM
Mon catalogue de services et d'offres
Entrée MyService comme source pour les ID d'éléments de service
- Sur la page d'administration, ouvrez l'onglet Services et sélectionnez Élément de service dans une offre de service
- Dans les propriétés de l'élément, ouvrez la liste déroulante Lien de données externes et sélectionnez le nom du champ de données externes
- Dans la liste déroulante « ID d'élément », sélectionnez l'élément dont vous avez besoin.
L'ID de l'élément sélectionné sera utilisé comme ItemID lorsque les utilisateurs passeront des commandes pour l'article donné.
Associations entre utilisateurs et cartes de données
Connector n'est pas seulement responsable de la récupération des informations des DataCards, mais également de :
- suivi des associations entre les DataCards et les utilisateurs
- modifier lesdites associations
Pour utiliser cette fonctionnalité :
- Sur la page d'administration, ouvrez Service et sélectionnez Élément de service
- Dans les propriétés de l'élément de service, ouvrez la liste déroulante Lien MyServices et sélectionnez le nom du champ MyServices
- Dans la liste déroulante Sous-éléments, sélectionnez :
- Utilisateur utilisant - dans ce cas, l'utilisateur se verra présenter une liste de cartes de données auxquelles il est associé
- Utilisateur n'utilisant pas - dans ce cas, l'utilisateur se verra présenter une liste de cartes de données auxquelles il n'est pas associé
La soumission d'une commande pour un article de service entraînera
- Suppression
- Ajout
association entre l'utilisateur passant commande et DataCard
Articles du catalogue
Les types de données d'attribut ESM suivants sont pris en charge lors de la configuration des éléments de catalogue
| Nom du champ | Type d'attribut ESM |
| ID technique | Chaîne |
| Nom | Chaîne |
| Modèle | Chaîne |
| Page d'information | Chaîne |
| Prix | Nombre décimal |
| Abonnement mensuel | Nombre décimal |
Exemple de connecteur
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
http://camel.apache.org/schema/spring http://camel.apache.org/schema/spring/camel-spring.xsd">
<bean id="connectionConfiguration" class="com.efecte.integration.connector.configuration.ConnectionConfiguration">
<property name="url" value="https://xxxxxxxxx.efectecloud.com/api/itsm" />
<property name="user" value="WebAPI" />
<property name="password" value="xxxxxxxxxxxxxxxxxxxxxxxxxx" />
<property name="connectionRequestTimeout" value="300" />
<property name="connectTimeout" value="300" />
<property name="socketTimeout" value="300" />
<!--property name="acceptSelfSignedCertificates" value="true"/>
<property name="allowAllHostnamesInCertificate" value="true"/-->
</bean>
<bean id="defaultConnectorEfecte" class="com.efecte.integration.connector.efecte.EfecteConnector">
<property name="connectionConfiguration" ref="connectionConfiguration" />
<!-- property name="generalConfiguration"> NOT RECOMMENDED TO BE CHANGED
<bean class="com.efecte.integration.connector.configuration.GeneralConfiguration">
<property name="dateTimeFormat" value="yyyy-MM-dd HH:mm:ss z"/>
<property name="integrationIdAttribute" value="WebShopId"/>
<property name="integrationCategoryAttribute" value="WebShopCategory"/>
</bean>
</property -->
<!-- property name="serviceRequestAttributes">
<bean class="com.efecte.integration.connector.configuration.ServiceRequestAttributes">
<property name="templateCode" value="ServiceRequest"/>
<property name="bundleTemplateCode" value="ServiceRequestBundle"/>
<property name="folderCode" value="ServiceRequests"/>
<property name="attachmentAttribute" value="RequestAttachments"/>
<property name="statusAttribute" value="status"/>
<property name="reopenReasonAttribute" value="reopen_reason"/>
<property name="creationDateAttribute" value="created"/>
<property name="deadlineAttribute" value="deadline"/>
<property name="updatedAttribute" value="updated"/>
<property name="efecteIdAttribute" value="efecte_id"/>
<property name="languageAttribute" value="Language"/>
<property name="feedbackAttribute" value="rating"/>
<propriété nom="attributdetextederésolution" valeur="résolution"/>
<propriété nom="supportPersonAttribute" valeur="personne_de_soutien"/>
<propriété nom="serviceOfferingNameAttribute" valeur="Offredeservice"/>
<propriété nom="serviceItemNameAttribute" valeur="ServiceItemName"/>
<propriété nom="serviceItemExternalIdAttribute" valeur="ServiceItem"/>
<propriété nom="priceAttribute" valeur="Prix"/>
<propriété nom="monthlySubscriptionAttribute" valeur="Abonnementmensuel"/>
<propriété nom="requestedForAttribute" valeur="DemandéPour"/>
<propriété nom="costCenterAttribute" valeur="Centredecoûts"/>
<propriété nom="deliveryAddressAttribute" valeur="Adressedelivraison"/>
<propriété nom="orderedByAttribute" valeur="Ordonnépar"/>
<propriété nom="additionalInformationAttribute" valeur="Informationssupplémentaires"/>
<propriété nom="siteIDAttribute" valeur="SiteID"/>
<propriété nom="siteNameAttribute" valeur="Nomdusite"/>
<propriété nom="requestBundleAttribute" valeur="RequestBundle"/>
<propriété nom="requestBundleNameAttribute" valeur="RequestBundleName"/>
<propriété nom="orderedByEmailAttribute" valeur="Commandépar:e-mail"/>
<propriété nom="requestedForEmailAttribute" valeur="Demandépour : e-mail"/>
<propriété nom="commentAttribute" valeur="commentaires_externes"/>
<propriété nom="reasonAttribute" valeur="raison_utilisateur"/>
<propriété nom="dedicatedApproverAttribute" valeur="DedicatedApprover"/>
<propriété nom="superiorApproverAttribute" valeur="gestionnaire_approbateur"/>
<propriété nom="totalPriceAttribute" valeur="prixtotal"/>
<propriété nom="quantitéAttribute" valeur="quantité"/>
<propriété nom="totalMonthlySubscriptionAttribute" valeur="Abonnementmensueltotal"/>
</bean>
</propriété -->
<!-- propriété nom="approvalResponseAttributes"> PAS RECOMMANDÉ À ÊTRE MODIFIÉ
<haricot classe="com.efecte.integration.connector.configuration.ApprovalResponseAttributes">
<propriété nom="templateCode" valeur="approbation"/>
<propriété nom="codedossier" valeur="approbations"/>
<propriété nom="efecteId" valeur="efecte_id"/>
<propriété nom="actualApprover" valeur="ActualApprover"/>
<propriété nom="approbationDécision" valeur="ApprovalDecision"/>
<propriété nom="raison" valeur="Raison"/>
<propriété nom="esmApprovedCode" valeur="approuvé"/>
<propriété nom="esmRejectedCode" valeur="rejeté"/>
</bean>
</propriété -->
<!-- propriété name="effecteTrackingConnector">
<haricot class="com.efecte.integration.connector.efecte.EfecteTrackingConnector">
<propriété nom="updateQuerySlidingWindowTime" valeur="20"/>
<propriété nom="updateQuerySlidingWindowUnit" valeur="MINUTES"/>
<propriété nom="initialQuerySlidingWindowTime" valeur="1"/>
<propriété nom="initialQuerySlidingWindowUnit" valeur="JOURS"/>
<propriété nom="updateFrequency" valeur="10" />
<propriété nom="updateFrequencyUnit" valeur="MINUTES" />
<propriété nom="errorUpdateFrequency" valeur="10" />
<propriété nom="errorUpdateFrequencyUnit" valeur="MINUTES" />
<propriété nom="defaultIntegrationServiceItemId" valeur="DEFAULT_SERVICE_ITEM" />
<propriété nom="pollNewServiceRequestEnabled" valeur="faux" />
<propriété nom="defaultIntegrationCategoryId" valeur="DEFAULT_EFECTE_CATEGORY"/>
<propriété nom="serviceRequestPollCondition" valeur="et $créateur$ = 'SefServicePortal'"/>
<propriété nom="incidentPollCondition" valeur="et $créateur$ = 'Boutiqueenligne'"/>
</bean>
</propriété -->
<!-- propriété nom="feedbackFormConnector">
<haricot class="com.efecte.integration.connector.efecte.EfecteFeedbackFormConnector">
<propriété nom="feedbackAttributes">
<haricot classe="com.efecte.integration.connector.configuration.FeedbackAttributes">
<propriété nom="templateCode" valeur="feedback_management" />
<propriété nom="codedossier" valeur="feedback" />
<propriété nom="efecteIdAttribute" valeur="ticket_id" />
<propriété nom="attributclient" valeur="client" />
<propriété nom="ratingAttribute" valeur="ticket_rating" />
</bean>
</property>
</bean>
</propriété -->
</bean>
<haricot id="efecteKnowledgeBaseConnector" classe="com.efecte.integration.connector.efecte.EfecteKnowledgeBaseConnector">
<propriété nom="connectionConfiguration" ref="connectionConfiguration"/>
<propriété nom="knowledgeBaseAttributes" >
<haricot id="knowledgeBaseAttributes" classe="com.efecte.integration.connector.configuration.KnowledgeBaseAttributes">
<propriété nom="templateCode" valeur="article_de_la_base_de_connaissances"/>
<propriété nom="pollingFolderCode" valeur="base_de_connaissances"/>
<propriété nom="updateReadStatsFallbackFolderCode" valeur="base_de_connaissances"/>
<propriété nom="ratingFallbackFolderCode" valeur="base_de_connaissances"/>
<propriété nom="publiéDansEssAttr" valeur="publié_en_libre-service"/>
<propriété nom="publishedInEssValue" valeur="Oui"/>
<propriété nom="deletedAttr" valeur="supprimé"/>
<propriété nom="nameAttr" valeur="nom_solution"/>
<propriété nom="descriptionAttr" valeur="solution_description"/>
<propriété nom="categoryAttr" valeur="catégorie"/>
<propriété nom="efecteIdAttr" valeur="efecte_id"/>
<propriété nom="updatedAttr" valeur="miseàjour"/>
<propriété nom="ratingAttr" valeur="note"/>
<propriété nom="rankingAttr" valeur="note"/>
<propriété nom="readStatsAttr" valeur="read_count"/>
<propriété nom="mots-clésAttr" valeur="solution_keywords"/>
<propriété nom="séparateurdemots-clés" valeur=","/>
</bean>
</property>
</bean>
</beans>