Création de demandes de service d'ESS vers ESM

Pour qu'Efecte Self-Service puisse créer ou interroger correctement de nouvelles demandes de service, les attributs et codes d'attribut suivants doivent exister et avoir une valeur :

• Effet efecte_id
• statusAttribute - statut
• Attribut demandé pour e-mail – Demandé pour
• serviceItemExternalIdAttribute – ServiceItem. Si la valeur de cet attribut est vide, ESS utilise la valeur de defaultIntegrationServiceItemId définie dans le connecteur Efecte Service Management d'ESS.

Si l’un des champs obligatoires ci-dessus est vide , la demande de service ne sera pas créée.

Les règles détaillées pour le traitement des demandes de service sont les suivantes :

• WebShopId - si présent, une mise à niveau d'une demande de service existante sera effectuée
• efecte_id : si WebShopId est vide et qu'aucune demande n'est associée à cet efecte_id dans ESS, une nouvelle demande de service est créée. Si une demande avec cet efecte_id existe dans ESS, une mise à jour de celle existante est effectuée.
• RequestedFor : un utilisateur avec une adresse e-mail correspondante doit figurer dans les informations de l'organisation dans ESS. Dans le cas contraire, la demande de service ne sera pas créée.
• OrderedBy : un utilisateur dont l'adresse e-mail correspond doit figurer dans les informations de l'organisation. Dans le cas contraire, la demande de service ne sera pas créée. Si la valeur du champ est vide, l'adresse e-mail RequestedFor sera utilisée.
• ServiceItem : un élément de service portant exactement le même identifiant doit exister et être valide (des vérifications sont également effectuées sur la copie de travail dans Efecte Self Service). Si cette condition n'est pas remplie, la demande de service n'est pas créée dans ESS.
• ServiceOffering : si l'attribut est défini, la demande de service sera créée avec le nom donné. 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 ServiceItem dans ESS.
• ServiceItemName : 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 du service sera copié à partir de l'élément de service trouvé dans ESS.
• Prix / Abonnement mensuel : si l'attribut est défini, la demande de service sera créée avec les données correspondantes. Si l'attribut n'est pas défini, les attributs seront copiés à partir de l'élément de service trouvé à partir de ServiceItem.
• Informations supplémentaires : si la valeur de l'attribut « Informations supplémentaires » commence par « Description », le connecteur traitera le texte suivant la partie « Description » jusqu'à la fin de la ligne. Si le champ « Informations supplémentaires » ne commence pas par le préfixe « Description », tout le contenu de la valeur de l'attribut sera traité.

Réception des évaluations des articles Knowledge Base de l'ESS à l'ESM

Les utilisateurs peuvent noter les articles de la base de connaissances dans ESS si cette fonctionnalité est activée. Pour activer la notation des articles de la base de connaissances sur ESM, procédez comme suit :

• Ajoutez un attribut « Évaluation » au modèle d'article Knowledge Base
• Définissez AverageHandler sur l'attribut.
• Aucune métadonnée n'est requise, mais vous pouvez définir la valeur maximale Pro barre de progression : 1 et le mode de la barre de Pro : valeur. Ces paramètres affichent la valeur sous forme de barre de progression.
• Type de données : nombre décimal. (La configuration du gestionnaire modifie automatiquement le type de données.)
• Définir la visibilité : Afficher uniquement dans la vue
• Enregistrer l'attribut
• Accédez à la classe dans laquelle se trouve l'attribut
• Confirmer que l'attribut possède un code (devrait être donné automatiquement)
• Configurer les autorisations de l'attribut
• Assurez-vous que dans la configuration ESS, la note est mappée à cet attribut
• Créez des vues qui utilisent l'attribut Évaluation pour afficher les notes moyennes des articles Knowledge Base .

Barre de Pro

Lorsqu'elle est correctement configurée, la barre de progression s'affiche dans les vues Liste et Carte de données. Elle est également visible dans les vues Liste de l'interface utilisateur mobile.

Il a les paramètres suivants :

• Modèle de sortie décimal.
• Valeur maximale.
• Code d'attribut pour la valeur maximale de la barre de progression.
• Échelle Pro progression
• Deux modes pris en charge :
  • Valeur
  • Pourcentage

Paramètres d'administration pour la barre de progression (affichée pour le nombre décimal) :

Publication des annonces de service de l'ESM vers l'ESS

La publication des annonces de l'ESM vers l'ESS est implémentée à l'aide des fonctionnalités suivantes :

• Les auditeurs, qui envoient des annonces de l'ESM à l'ESS avec SendDataCardXmlToHttpAction
• Un écouteur, qui définit l'expiration de l'annonce
• Un événement qui déclenche la sauvegarde de la carte de données lorsque la validité de l'annonce est expirée. La sauvegarde de la carte de données déclenche l'écouteur mentionné ci-dessus.

Activation des annonces de service dans un environnement ESM-ESS existant

Importation du package de configuration

Un package de configuration (efecte-configuration_ESS_ANNOUNCEMENTS.xml), comprenant le modèle d'annonce de service et la plupart des configurations, est disponible. Les fichiers mentionnés ci-dessous sont également disponibles séparément. L'importation du package de configuration définit automatiquement la plupart des paramètres et simplifie les étapes ci-dessous. Importez le package de configuration via la fonction « Importer les configurations » de la vue Maintenance.

Le paquet contient:

• Le modèle d'annonce de service.
• Les auditeurs.
• Paramètres de plate-forme pré-remplis qui doivent être modifiés après l'importation.
• La tâche de file d'attente de messages.
• L'événement pour déclencher l'expiration de l'annonce.

Si vous importez le package, vous pouvez ignorer les parties suivantes :

• Importer le modèle d'annonce de service et les auditeurs.
• Configurez un événement sur le modèle d’annonce en libre-service.
• Une partie de la configuration de la tâche MessageQueue. Les paramètres de planification doivent être définis.

Après une importation de configuration réussie, vous devriez obtenir le rapport suivant :

Modèles créés : 1
Écouteurs de cartes de données créés : 3
Dossiers créés : 0
Rôles créés : 0
Utilisateurs créés : 0
Rapports créés : 0
Dashboard créé : 0
Tâches planifiables créées : 1
Modèles d'événements créés : 1
Autorisations créées : 0
Paramètres de la plateforme créés : 3
Mises en page créées : 0

Vous pouvez utiliser les sections suivantes pour vérifier que toutes les configurations sont correctes et pour remplir les parties qui doivent être configurées manuellement après l'importation de la configuration.

Modèle d'annonce de service d'importation et les auditeurs

• Importez le modèle d’annonce de service dans votre ESM à l’aide de l’importation de modèle.
• ESM_Template_ESS_Announcement_2015_4.xml
• Vérifiez les autorisations du modèle et sélectionnez les rôles qui ont accès au modèle.
• Créez un dossier « Annonces de service » dans lequel les cartes de données du modèle pourront être créées. Autorisez la création de cartes de données d'annonces de service dans ce dossier.
• Importez ces auditeurs dans le modèle d’annonce en libre-service :
  • Le premier définit une valeur d'aide pour la dernière action : 1_presave.set_Last_Action_For_ESS_Announcement.xml
  • 2ème envoie l'annonce à ESS : 2_postsave.1.POST_ESS_Announcement_To_ESS.xml
  • 3rd supprime l'annonce d'ESS : 3_postsave.2.DELETE_ESS_Announcement_From_ESS.xml

Insérez le jeton API ESS dans les paramètres de la plateforme ESM

• Si votre environnement est dans le cloud, contactez servicedesk@efecte.com Efecte Service Desk et ils pourront vous fournir le jeton API ESS, nécessaire à la communication ESM-ESS.
• Si votre environnement est sur site, accédez à l’administrateur global ESS et générez-y un jeton API .
• Créez un nouveau paramètre de plateforme « ess.token ».
• Définissez la valeur de ce paramètre en copiant-collant le jeton API .
• Il est possible de configurer le nom du paramètre, mais dans l'écouteur par défaut, le nom du paramètre est « ess.token ». Si vous modifiez le nom, mettez à jour le paramètre de plateforme et l'écouteur.

Insérez les paramètres du locataire ESS dans les paramètres de votre plateforme

• Créez un nouveau paramètre de plateforme « ess.tenant ».
• Définissez le nom de votre locataire ESS comme valeur de ce paramètre, par exemple mycompany.

Insérez l'URL ESS dans les paramètres de la plateforme

• Créez un nouveau paramètre de plateforme « ess.announcement.url ».
• Sur site : définissez votre URL ESS comme valeur de ce paramètre, par exemple https://mycompany.testefecte.com:55443/announcement
• Dans le cloud : définissez votre URL ESS comme valeur de ce paramètre, par exemple https://mycompany.efectecloud-dev.com/api/ssc/announcement
• Le port et le nom du service/l'annonce restent les mêmes pour tous les environnements ESS.
• Il est possible de configurer le nom du paramètre, mais dans l'écouteur par défaut, le nom du paramètre est « ess.announcement.url ». Si vous modifiez le nom, mettez à jour le paramètre de plateforme et l'écouteur.

Activer les annonces de l'ESS

• Activer « Annonces activées » dans l'administrateur du locataire ESS – Paramètres

Configurer un événement sur le modèle d'annonce en libre-service

Vérifier et configurer les tâches planifiables

• EventTask doit être configuré pour déclencher l'événement. Dans la plupart des environnements, cette fonction existe et aucune modification n'est nécessaire.
• MessageQueueTask doit être configuré pour nettoyer et retraiter l'élément de la file d'attente. Son exécution est effectuée toutes les 5 minutes par défaut.
  
  

Vérifier et configurer les paramètres réseau

Assurez-vous que le port d'annonce est accessible et qu'aucun pare-feu, etc., ne bloque les connexions d'ESM à l'environnement ESS.