Configurer le First AdvantageSpoke

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 7 minutes de lecture

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

    Avant de commencer

    • Demander Hub d'intégration un abonnement
    • Activer le First AdvantageSpoke
    • Rôle requis : admin

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

    Créez des enregistrements d’informations d’identification dans le First AdvantageSpoke . L’alias First AdvantageSpoke de connexion et d’informations d’identification utilise 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 d’informations d’identification de clé API vide 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 l’ordre dans lequel appliquer 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 . L’alias First AdvantageSpoke de connexion et d’informations d’identification utilise 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. Ouvert pour l’enregistrement de 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. Entrez https://rest-ua.fadv.com.
    5. Dans l’onglet Attributs , entrez les valeurs suivantes.
      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. Ouvert pour l’enregistrement de 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 d’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, entrez sys_choice.list.
      Les enregistrements de la table Choix [sys_choice] s’affichent.
    2. Cliquez sur Nouveau.
    3. Sur le formulaire, renseignez ces valeurs 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 mentionné 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 mentionné 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 sur Configurer les choix.
    4. Pour créer l’état Annulé, procédez comme suit :
      1. Entrez Annulé dans le texte du nouvel élément.
      2. Entrez 149 en valeur numérique.
        Remarque :
        Assurez-vous de fournir les nombres exacts dans le champ Valeur numérique comme mentionné 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. Pour créer l’état Terminé, procédez comme suit :
      1. Entrez Terminé dans Nouveau texte d’élément.
      2. Entrez 127 dans Valeur numérique.
        Remarque :
        Assurez-vous de fournir les nombres exacts dans le champ Valeur numérique comme mentionné 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éer les états Terminé - Réussite et Terminé - Accord brisé

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

    Avant de commencer

    Rôle requis : admin.

    Procédure

    1. Accédez à la Tout > Spoke First Advantage > Tâche pour des employés.
    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 sur Configurer les choix.
    4. Pour créer l’état Annulé, procédez comme suit :
      1. Entrez Terminé : réussite dans le texte du nouvel élément.
      2. Entrez 161 dans Valeur numérique.
        Remarque :
        Assurez-vous de fournir les nombres exacts dans le champ Valeur numérique comme mentionné 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. Pour créer l’état Terminé, procédez comme suit :
      1. Entrer Terminé - Transaction rompue dans le texte du nouvel élément.
      2. Entrez 117 dans Valeur numérique.
        Remarque :
        Assurez-vous de fournir les nombres exacts dans le champ Valeur numérique comme mentionné 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 des mises à jour d’événements d’invitation et de commande sur votre ServiceNow instance en configurant les webhooks.

    Avant de commencer

    Rôle requis : admin

    Fournir 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 : admin

    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 : admin

    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 First Advantage, par exemple.
    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 le 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 le 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 informations avec First Advantage:
    • En-tête personnalisé au format suivant : fadvKey <authorization-key>.
      Remarque :
      • Assurez-vous que l’en-tête personnalisé est uniquement au format . 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 First Advantage détails des comptes et des 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 de 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 > Paquets.
    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 d’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.