Configurer le First AdvantageSpoke

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 7 minutes de lecture

    • Intégrez l’instance à votre ServiceNowFirst Advantage compte à l’aide d’une clé API pour authentifier ServiceNow les demandes.

    Avant de commencer

    • Demander Hub d'intégration un abonnement
    • Activez l’option First AdvantageSpoke
    • Rôle requis : administrateur

    Créer un enregistrement d’informations d’identification pour le First AdvantageSpoke

    Créez des enregistrements d’informations d’identification dans le First AdvantageSpoke . Les First AdvantageSpoke alias de connexion et d’informations d’identification utilisent ces informations d’identification pour autoriser des actions.

    Avant de commencer

    Rôle requis : admin.

    Procédure

    1. Accédez à la Tout > Connexions et informations d'identification > Informations d'identification.
    2. Cliquez sur Nouveau.
      Le système affiche le message Quel type d’informations d’identification voulez-vous créer ?
    3. Sélectionnez Informations d’identification de clé API.
      Un formulaire vide d’informations d’identification de clé API s’affiche.
    4. Entrez ces valeurs.
      Champ Valeur requise
      Nom Nom permettant d'identifier l'enregistrement de façon unique. Par exemple, entrez Informations d’identification FADV.
      Actif Option permettant d'utiliser activement l'enregistrement des informations d'identification.
      Clé API Clé API générée pour votre First Advantage instance.
      Remarque :
      Contactez l’équipe First Advantage pour obtenir la clé API.
      Ordre Sélectionnez la commande d’application de ces informations d’identification. Par exemple, saisissez 100.
    5. Cliquez sur Envoyer.

    Créer un enregistrement de connexion pour le First AdvantageSpoke

    Créez un enregistrement de connexion à l’API First Advantage . Les First AdvantageSpoke alias de connexion et d’informations d’identification utilisent ces connexions pour effectuer des actions dans First Advantage.

    Avant de commencer

    Rôle requis : admin.

    Procédure

    1. Accédez à la Tout > Connexions et informations d'identification > Alias de connexion et d'informations d'identification.
    2. Ouvrir pour l’enregistrement pour First Advantage.
    3. Dans l’onglet Connexions , cliquez sur Nouveau.
      Le système affiche un formulaire de connexion HTTP(s) vide.
    4. Entrez ces valeurs.
      Champ Valeur requise
      Nom Nom permettant d’identifier de façon unique l’enregistrement de connexion. Par exemple, entrez Connexion FADV.
      Informations d'identification Enregistrement d’informations d’identification que vous avez créé pour First Advantage. Par exemple, sélectionnez Informations d’identification FADV.
      URL de connexion First Advantage URL de connexion. Saisissez https://rest-ua.fadv.com.
    5. Dans l’onglet Attributs , entrez ces valeurs.
      Champ Description
      E-mail de distribution E-mail de distribution de votre organisation.
      u_version v1.1
      Remarque :
      Si vous utilisez une autre version de , spécifiez le numéro de First Advantageversion.
    6. Cliquez sur Envoyer.
    7. Accédez à la Connexions et informations d'identification > Alias de connexion et d'informations d'identification.
    8. Ouvrir pour l’enregistrement pour First Advantage.
    9. Cliquez sur l’onglet Attributs de connexion .
    10. Modifiez les valeurs par défaut des enregistrements d’attributs de connexion selon vos besoins.
      Enregistrement des attributs de connexion Valeur par défaut
      E-mail de distribution E-mail de distribution de votre organisation.
      Version v1.1
      Remarque :
      Si vous utilisez une autre version de , spécifiez le numéro de First Advantageversion.

    Créer des First Advantage états dans votre ServiceNow instance

    Créez des First Advantage états à afficher dans la liste État de votre ServiceNow instance.

    Avant de commencer

    Rôle requis : admin

    Créer les états Brouillon, Prêt et En cours

    Créez les états Brouillon, Prêt et En cours dans la table Tâche [task].

    Avant de commencer

    Rôle requis : admin.

    Procédure

    1. Dans le navigateur de filtre, saisissez sys_choice.list.
      Les enregistrements de la table Choix [sys_choice] s’affichent.
    2. Cliquez sur Nouveau.
    3. Renseignez ces valeurs sur le formulaire et créez trois enregistrements pour l’état Brouillon.
      Tableau 1. Enregistrement 1 : état de brouillon
      Champ Valeur
      Table Tâche [task]
      Élément État
      Étiquette Brouillon
      Valeur 137
      Remarque :
      • Assurez-vous de fournir les nombres exacts dans le champ Valeur , comme indiqué ici. Les flux de spoke ne sont pas déclenchés en cas de changement de ces nombres.
      • Assurez-vous que l’enregistrement est créé dans l’application Global .
    4. Cliquez sur Envoyer.
    5. De même, créez des enregistrements pour les états Prêt et En cours.
      Tableau 2. Enregistrement 2 : état Prêt
      Champ Valeur
      Table Tâche [task]
      Élément État
      Étiquette Prêt
      Valeur 173
      Tableau 3. Enregistrement 3 : état En cours
      Champ Valeur
      Table Tâche [task]
      Élément État
      Étiquette En cours
      Valeur 181
      Remarque :
      • Assurez-vous de fournir les nombres exacts dans le champ Valeur , comme indiqué ici. Les flux de spoke ne sont pas déclenchés en cas de changement de ces nombres.
      • Assurez-vous que l’enregistrement est créé dans l’application Global .

    Résultats

    Les états Brouillon, Prêt et En cours sont créés dans la table Tâche [task]

    Créer les états Terminé et Annulé

    Créez les états Terminé et Annulé dans la table Tâche First Advantage [sn_fadv_spoke_first_advantage_task].

    Avant de commencer

    Rôle requis : admin.

    Procédure

    1. Accédez à la Tout > Spoke First Advantage > Tâches de commande.
    2. Cliquez sur Nouveau.
      Remarque :
      Assurez-vous que l’enregistrement est créé dans l’application First Advantage .
    3. Cliquez avec le bouton droit sur État , puis cliquez sur Configurer les choix.
    4. Procédez comme suit pour créer l’état Annulé :
      1. Saisissez Annulé dans le texte du nouvel élément.
      2. Entrez 149 dans Valeur numérique.
        Remarque :
        Assurez-vous de fournir les nombres exacts dans le champ Valeur numérique , comme indiqué ici. Les flux de spoke ne sont pas déclenchés en cas de changement de ces nombres.
      3. Cliquez sur Ajouter.
      4. Cliquez sur Enregistrer.
    5. Effectuez les étapes suivantes pour créer l’état Terminé :
      1. Saisissez Terminé dans letexte du nouvel élément.
      2. Entrez 127 en valeur numérique.
        Remarque :
        Assurez-vous de fournir les nombres exacts dans le champ Valeur numérique , comme indiqué ici. Les flux de spoke ne sont pas déclenchés en cas de changement de ces nombres.
      3. Cliquez sur Ajouter.
      4. Cliquez sur Enregistrer.

    Résultats

    Les états Terminé et Annulé sont créés dans la table Tâche First Advantage [sn_fadv_spoke_first_advantage_task].

    Créez les états Terminé - Réussite et Terminé - Accord brisé

    Créez les états Terminé - Réussite et Terminé - Rupture de l’accord dans la table Tâche de l’employé [sn_fadv_spoke_first_advantage_employee_task_table] First Advantage.

    Avant de commencer

    Rôle requis : admin.

    Procédure

    1. Accédez à la Tout > Spoke First Advantage > Tâche de l’employé.
    2. Cliquez sur Nouveau.
      Remarque :
      Assurez-vous que l’enregistrement est créé dans l’application First Advantage .
    3. Cliquez avec le bouton droit sur État , puis cliquez sur Configurer les choix.
    4. Procédez comme suit pour créer l’état Annulé :
      1. Entrer Terminé – Réussite dans le texte du nouvel élément.
      2. Entrez 161 en valeur numérique.
        Remarque :
        Assurez-vous de fournir les nombres exacts dans le champ Valeur numérique , comme indiqué ici. Les flux de spoke ne sont pas déclenchés en cas de changement de ces nombres.
      3. Cliquez sur Ajouter.
      4. Cliquez sur Enregistrer.
    5. Effectuez les étapes suivantes pour créer l’état Terminé :
      1. Entrer Terminé : rupture de l’accord dans le texte du nouvel élément.
      2. Entrez 117 en valeur numérique.
        Remarque :
        Assurez-vous de fournir les nombres exacts dans le champ Valeur numérique , comme indiqué ici. Les flux de spoke ne sont pas déclenchés en cas de changement de ces nombres.
      3. Cliquez sur Ajouter.
      4. Cliquez sur Enregistrer.

    Résultats

    Les états Terminé - Réussite et Terminé - Accord rompu sont créés dans la table Tâche de l’employé First Advantage [sn_fadv_spoke_first_advantage_employee_task_table].

    Configurer First Advantage des webhooks

    Recevez, invitez et commandez des mises à jour d’événements sur votre ServiceNow instance en configurant les webhooks.

    Avant de commencer

    Rôle requis : admin

    Fournissez la clé dans votre ServiceNow instance

    Configurez le First Advantage webhook en fournissant une clé pour le client webhook First Advantage .

    Avant de commencer

    • Générez une clé sécurisée selon vos besoins et enregistrez la valeur. Par exemple, une clé codée base64.
    • Rôle requis : administrateur

    Procédure

    1. Accédez à la Tout > Spoke First Advantage > Détails du client Webhook FADV.
    2. Cliquez sur Nouveau.
    3. Renseignez ces valeurs sur le formulaire.
      Champ Description
      Nom Nom permettant d'identifier l'enregistrement de façon unique.
      Clé d'autorisation Clé que vous avez générée selon vos besoins.
    4. Cliquez sur Envoyer.

    Points de terminaison d’API d’accès

    Accédez au point de terminaison de l’API pour les événements d’invitation et de commande et partagez les détails requis pour First Advantage configurer les webhooks.

    Avant de commencer

    Rôle requis : administrateur

    Procédure

    1. Accédez à la Tout > Services web du système > API REST basées sur un script.
    2. Ouvrez l’enregistrement du First AdvantageSpoke webhook , par exemple, First Advantage.
    3. Dans l’onglet Ressources :
      1. Ouvrez l’enregistrement de l’événement d’invitation, par exemple, État de l’invitation.
      2. Copiez et enregistrez le chemin d’accès fourni dans Chemin d’accès de la ressource, par exemple, /api/sn_fadv_spoke/fadv/invite_status.
      3. Ouvrez l’enregistrement de l’événement de commande, par exemple, État de la commande.
      4. Copiez et enregistrez le chemin d’accès fourni dans Chemin d’accès de la ressource, par exemple, /api/sn_fadv_spoke/fadv/order_status.

    Que faire ensuite

    Contact First Advantage pour configurer des webhooks pour votre ServiceNow instance. Pour cela, partagez ces détails avec First Advantage:
    • En-tête personnalisé au format suivant : fadvKey <authorization-key>.
      Remarque :
      • Assurez-vous que l’en-tête personnalisé est dans ce format uniquement. Les flux de spoke ne sont pas déclenchés en cas de changement.
      • Fournissez la même clé que celle que vous avez fournie précédemment dans Spoke First Advantage > Détails du client Webhook FADV.
      • Utilisez le même cas que celui mentionné ici : fadvKey.
    • Point de terminaison d’API pour les événements d’invitation au format suivant : < ServiceNow-instance-URL >/api/sn_fadv_spoke/fadv/invite_status
    • Point de terminaison d’API pour les événements de commande au format suivant : < ServiceNow-instance-URL >/api/sn_fadv_spoke/fadv/order_status

    Synchroniser les comptes et les First Advantage packages avec ServiceNow

    Stockez les détails des comptes et des First Advantage packages en synchronisant First Advantage les comptes et les packages avec ServiceNow.

    Avant de commencer

    Rôle requis : administrateur First Advantage

    Procédure

    1. Accédez à la Tout > Spoke First Advantage > Comptes.
    2. Cliquez sur Nouveau.
    3. Renseignez les valeurs du formulaire.
      Tableau 4. Formulaire de compte
      Champ Description
      Compte principal Option permettant de spécifier que le compte est un compte primaire. Cochez la case.
      ID du compte ID du compte principal.
      Nom du compte Nom du compte principal.
    4. Cliquez sur Envoyer.
      Le compte principal est créé et l’enregistrement s’affiche.
    5. Accédez à la Spoke First Advantage > Comptes.
    6. Cliquez sur la liste connexe Obtenir des comptes .
    7. Accédez à la Spoke First Advantage > Packages.
    8. Cliquez sur le lien connexe Obtenir des packages .

    Résultats

    Les First Advantage détails du compte et du package sont récupérés.
    Remarque :
    Seuls les utilisateurs disposant du rôle administrateur FADV peuvent synchroniser les détails du compte et du package. Les utilisateurs disposant du rôle d’utilisateur FADV ne peuvent afficher que les détails récupérés.