Lien d'autoconnexion


Definition

Un lien d'autoconnexion est un raccourci vers une fiche Service Manager d'un objet donné. Il permet à une application tierce (Power BI, Excel, ...) d'ouvrir Service Manager et d'accéder directement à la fiche sans passer par les options de menu ou la recherche  - Open url.png voir Exemples

EndDefinition

Caractéristiques d'un lien d'autoconnexion

  • Le lien est construit en précisant la fiche à ouvrir, le champ servant de critère de recherche et la valeur recherchée pour ce champ.

    exemple  

    • Fiche : DialogFO_Incidents
    • Champ de recherche : RFC_NUMBER
    • Valeur recherchée : I200803_000008
  • Il se présente sous la forme d'une URL suivie de paramètres introduits par des variables field.
https://{your_server}/autoconnect_mail.php?/field1={your_account_crypted}&field2=login&field3=password&field4={form_id}&field5=ViewDialog&field6={searched_value}&field7={search_field}
  • {your_server} : URL du serveur
             exemple  https://your_company.easyvista.com 
  • field1 = {your_account_crypted} : Compte Service Manager utilisé (40000, 50004, 50005), qui est crypté
  • field4 = {form_id} : Identifiant de la fiche de recherche
  • field6 = {searched_value} : Valeur recherchée
  • field7 = {search_field} : Nom du champ de recherche

exemple

https//:.../autoconnect_mail.php?field1=...&field2=...&field5=ViewDialog&field6=I200803_000008&field7=RFC_NUMBER
  • La valeur recherchée est stockée dans la variable générique field6 ; elle doit être remplacée dans l'application tierce par la chaîne de caractères recherchée.

    exemple  

    • Dans le lien d'autoconnexion : field6=Incident_Number
    • Dans l'application tierce : field6=I200803_000008

Exemples

  • Envoyer un e-mail depuis une étape d'un workflow Incident, puis consulter la fiche Incident dans Service Manager via un lien d'autoconnexion  - Open url.png voir Cas d'utilisation
  • Depuis un rapport Power BI, accéder aux fiches Incident via un lien d'autoconnexion  - Open url.png voir Cas d'utilisation
  • Depuis Excel, rechercher un employé via son numéro de téléphone, puis consulter sa fiche dans Service Manager via un lien d'autoconnexion  - Open url.png voir Cas d'utilisation
  • Utiliser une fonction de montée de fiche automatique à partir d'un outil de téléphonie (CTI) via un lien d'autoconnexion  - Open url.png voir Cas d'utilisation

Remarques

  • Les fiches et champs pouvant être utilisés dans un lien d'autoconnexion sont définis par EasyVista. Vous ne pouvez pas en ajouter.
  • Un login / mot de passe peut être demandé à l'ouverture de la fiche dans Service Manager en fonction des paramètres de sécurité de l'application tierce.
  • Les liens d'autoconnexion ne sont pas stockés dans la base Service Manager.

Description de l'écran

         Auto connection link.png

Accès menu : Administration > Gestion des accès > Lien d'autoconnexion

Nom de la fiche : Nom physique de la fiche Service Manager à ouvrir depuis l'application tierce.

Nom du champ : Nom physique du champ Service Manager, utilisé comme critère de recherche par l'application tierce. 

Valeur : Valeur du critère de recherche, à remplacer dans l'application tierce.

URL : URL générée à partir des paramètres, utilisée par l'application tierce pour accéder directement à la fiche Service Manager

Procédure : Comment créer un lien d'autoconnexion

1. Allez sur l'écran Administration > Gestion des accès > Lien d'auto connexion.

2. Sélectionnez les paramètres souhaités.

3. Cliquez sur Générer le lien.

4. Copiez-collez le lien d'autoconnexion dans votre application tierce, en rendant la variable générique field6 contextuelle pour accéder aux fiches Service Manager  - Open url.png voir Cas d'utilisation

Cas d'utilisation

Accéder à la fiche Incident depuis un e-mail envoyé par un workflow

Étape 1 : Génération du lien d'autoconnexion dans Service Manager

1. Saisissez les paramètres suivants.

  • Nom de la forme : DialogFO_Incidents
  • Champ de recherche : RFC_NUMBER (Numéro de ticket)
  • Valeur recherchée : Saisissez la valeur générique Incident_Number

2. Générez le lien d'autoconnexion.

https://.../autoconnect_mail.php?field1=...&field2=...&field5=ViewDialog&field6=Incident_Number&field7=RFC_NUMBER

Étape 2 : Paramétrage de l'e-mail dans une étape Envoi d'e-mail du workflow

1. Ouvrez le workflow.
L'éditeur graphique est ouvert.

2. Ajoutez une étape Envoi d'e-mail  - Open url.png voir Types d'action
         Auto connection link - Workflow example.png

3. Double-cliquez sur l'étape pour la configurer.

  • Saisissez la référence du ticket dans le champ Sujet.

    Best Practice icon.png  Utilisez la variable prédéfinie @RFC_NUMBER@.

  • Renseignez le texte de l'e-mail dans le champ Message.
    • Cliquez sur Tools icon.png puis sur Hyperlink icon.png dans la barre d'outils.
               Auto connection link - Workflow example 1.png
      La fenêtre de création d'un lien hypertexte est ouverte.
               Auto connection link - Workflow example 2.png
    • Ajoutez le lien vers la fiche Incident via le lien d'autoconnexion.
      • URL : Collez le lien d'autoconnexion.
      • Texte à afficher : Saisissez le texte cliquable du lien hypertexte.

4. Sauvegardez l'étape de workflow.

Étape 3 : Test du workflow et du bon envoi de l'e-mail

1. Créez un incident rattaché au sujet du workflow.

2. Vérifiez que l'e-mail envoyé par le workflow contient le bon lien vers la fiche Incident.

Paramétrage de l'e-mail Exemple : Ouverture de la fiche Incident
Auto connection link - Result in workflow.png Auto connection link - Result in workflow - Example.png

Accéder aux fiches Incident depuis un rapport Power BI

Étape 1 : Génération du lien d'autoconnexion dans Service Manager

1. Saisissez les paramètres suivants.

  • Nom de la forme : DialogFO_Incidents
  • Champ de recherche : RFC_NUMBER (Numéro de ticket)
  • Valeur recherchée : Saisissez la valeur générique Incident_Number

2. Générez le lien d'autoconnexion.

https://.../autoconnect_mail.php?field1=...&field2=...&field5=ViewDialog&field6=Incident_Number&field7=RFC_NUMBER

Étape 2 : Accès aux fiches Incident depuis le rapport Power BI via le lien d'autoconnexion

     Open url.png voir Processus d'intégration détaillé

Afficher une fiche Employé depuis Excel

Étape 1 : Génération du lien d'autoconnexion dans Service Manager

1. Saisissez les paramètres suivants.

  • Nom de la forme : DialogEmployee
  • Champ de recherche : PHONE_NUMBER (Numéro de téléphone)
  • Valeur recherchée : Saisissez la valeur générique MyNumber

2. Générez le lien d'autoconnexion.

https://.../autoconnect_mail.php?field1=...&field2=...&field5=ViewDialog&field6=MyNumber&field7=PHONE_NUMBER

Étape 2 : Accès aux fiches Employé depuis Excel via le lien d'autoconnexion

1. Créez un formulaire de saisie dans Excel.

  • Insérez un champ de saisie du numéro de téléphone d'un employé.
  • Ajoutez un lien hypertexte Cliquez ici... permettant l'accès direct à la fiche Service Manager.

          Auto connection link -  third-party application.png

2. Créez une macro construisant de façon automatique le lien hypertexte.

  • Ajoutez un lien hypertexte dans le formulaire de saisie et copiez-collez le lien d'autoconnexion.
  • Remplacez la variable MyNumber par la valeur de la zone Téléphone employé du formulaire.
    Note : N'insérez aucun espace ou autre caractère.

exemple  La valeur saisie dans la zone Téléphone employé est 0123456789

https//:.../autoconnect_mail.php?field1=...&field2=...&field5=ViewDialog&field6=0123456789&field7=PHONE_NUMBER

3. Vérifiez l'accès direct à la fiche Service Manager de l'employé en cliquant sur le lien hypertexte.

Utiliser un CTI avec Service Manager

Étape 1 : Génération du lien d'autoconnexion dans Service Manager

1. Saisissez les paramètres suivants.

  • Nom de la forme : DialogHD_NewIncidents
  • Champ de recherche : Quick Call
  • Valeur recherchée : Saisissez la valeur générique MyValue.

2. Générez le lien d'autoconnexion.

https://.../autoconnect_mail.php?field1=...&field2=...&field5=ViewDialog&field6=MyValue

Étape 2 : Utilisation du CTI dans le lien d'autoconnexion

1. Remplacez la valeur MyValue par le paramètre passé par le CTI.

exemple  Le paramètre passé par le CTI est 0623456789

https//:.../autoconnect_mail.php?field1=...&field2=...field5=ViewDialog&field6=0623456789

Tags :
Powered by XWiki © EasyVista 2022