Configurez le First AdvantageSpoke

Rversion finale: Zurich

Mis à jour 31 juil. 2025

7 minutes de lecture

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

Avant de commencer

Demandez un Centre d'intégration abonnement.
Activez le First AdvantageSpoke .
Rôle requis : admin.

Créer un enregistrement de connexion pour le First AdvantageSpoke

Créez un enregistrement de connexion pour intégrer votre ServiceNow instance et le serveur First Advantage. Votre ServiceNow instance utilise cet enregistrement de connexion pour effectuer les actions de spoke First Advantage.

Avant de commencer

Rôle requis : admin.

Obtenez la clé API à partir du serveur First Advantage.

Procédure

Accédez à la Tous > Automatisation des processus > Studio de workflow.
Sélectionnez Intégrations.
Sélectionnez l’onglet Connexions .
Dans le champ Rechercher toutes les connexions, saisissez First Advantage.
Confirmez que l’onglet sortant est sélectionné.
Sur la vignette FirstAdvantage, sélectionnez Afficher les détails.
Sélectionnez Configurer.

Remplissez le formulaire.

Tableau 1. Formulaire de connexion de spoke First Advantage
Champ	Description
Nom de la connexion	Nom de la connexion. Le nom par défaut et en lecture seule du premier enregistrement est le même que celui de l’alias de connexion. Vous pouvez fournir un nom différent lorsque vous créez un enregistrement de connexion en cliquant sur Ajouter une connexion.
URL de connexion	Option permettant de fournir l’URL de connexion au serveur First Advantage. L’URL est https://rest-ua.fadv.com.
E-mail de distribution	Option permettant de fournir un ID d’e-mail de distribution.
Version	Option permettant de fournir la version de l’API.
Clé API	Option permettant d’entrer la clé API que le serveur First Advantage utilise pour authentifier les demandes d’accès.

Formulaire de connexion First Advantage.

Sélectionnez Configurer la connexion.
L’enregistrement de connexion est configuré.

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

Créez des First Advantage états à afficher dans la liste d’états 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

Dans le navigateur de filtre, saisissez sys_choice.list.
Les enregistrements de la table Choix [sys_choice] s’affichent.
Cliquez sur Nouveau.

Renseignez ces valeurs sur le formulaire et créez trois enregistrements pour l’état Brouillon.

Tableau 2. Enregistrement 1 : état Brouillon
Champ	Valeur
Table	Tâche [task]
Élément	État
Étiquette	Brouillon
Valeur	137

Remarque :

Assurez-vous de fournir les chiffres exacts dans le champ Valeur , comme indiqué ici. Les flux de spoke ne seront pas déclenchés en cas de changement de ces nombres.
Assurez-vous que l’enregistrement est créé dans l’application Global .

Cliquez sur Envoyer.

De même, créez des enregistrements pour les états Prêt et En cours.

Tableau 3. Enregistrement 2 : état Prêt
Champ	Valeur
Table	Tâche [task]
Élément	État
Étiquette	Prêt
Valeur	173

Tableau 4. 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 chiffres exacts dans le champ Valeur , comme indiqué ici. Les flux de spoke ne seront 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

Accédez à la Tous > Spoke First Advantage > Tâches de commande.
Cliquez sur Nouveau.

Remarque :
Assurez-vous que l’enregistrement est créé dans l’application First Advantage .
Cliquez avec le bouton droit sur État , puis sur Configurer les choix.
Procédez comme suit pour créer l’état Annulé :
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 indiqué ici. Les flux de spoke ne seront pas déclenchés en cas de changement de ces nombres.
3. Cliquez sur Ajouter.
4. Cliquez sur Enregistrer.
Procédez comme suit pour créer l’état Terminé :
1. Entrez Terminé dans le texte 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 seront 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 de tâches First Advantage [sn_fadv_spoke_first_advantage_task].

Créer les états Terminer – Succès et Terminer – Accord rompu

Créez les états Terminer - Succès et Terminer - 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

Accédez à la Tous > Spoke First Advantage > Tâche de l’employé.
Cliquez sur Nouveau.

Remarque :
Assurez-vous que l’enregistrement est créé dans l’application First Advantage .
Cliquez avec le bouton droit sur État , puis sur Configurer les choix.
Procédez comme suit pour créer l’état Annulé :
1. Entrer Terminé : réussite dans le texte 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 seront pas déclenchés en cas de changement de ces nombres.
3. Cliquez sur Ajouter.
4. Cliquez sur Enregistrer.
Procédez comme suit pour créer l’état Terminé :
1. Entrer Terminé : accord rompu 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 seront 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

Créer une clé d’autorisation pour le spoke First Advantage

Créez une clé d’autorisation pour autoriser les demandes provenant de Jenkins.

Avant de commencer

Rôle requis : admin

Procédure

Accédez à la Tous > Définition du système > Scripts - Arrière-plan.
Entrez cette commande dans le champ de texte Script exécuté (JavaScript exécuté sur le serveur) :
gs.info(GlideSecureRandomUtil.getSecureRandomString(32));
Cliquez sur Exécuter le script.
Copiez et enregistrez la valeur générée pour une utilisation ultérieure.

Fournir une clé dans votre ServiceNow instance

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

Avant de commencer

Créer une clé d’autorisation pour le spoke First Advantage et enregistrez la valeur.
Rôle requis : admin

Procédure

Accédez à la Tous > Spoke First Advantage > Détails du client Webhook FADV.
Cliquez sur Nouveau.

Renseignez ces valeurs sur le formulaire.


Champ	Description
Nom	Nom permettant d'identifier l'enregistrement de façon unique.
Clé d'autorisation	Clé d’autorisation que vous avez générée. Pour plus d'informations, consultez Créer une clé d’autorisation pour le spoke First Advantage.

Cliquez sur Envoyer.

Points de terminaison de l’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

Accédez à la Tous > Services web du système > API REST basées sur un script.
Ouvrez l’enregistrement pour le , par exemple, le First AdvantageSpoke webhook First Advantage.
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 détails avec First Advantage:

En-tête personnalisé au format suivant : fadvKey <authorization-key>.
Remarque :
- Assurez-vous que l’en-tête personnalisé n’est que dans ce format. Les flux de spoke ne sont pas déclenchés en cas de changement.
- Fournissez la même clé que celle que vous aviez fournie précédemment dans Spoke First Advantage > Détails du client Webhook FADV.
- Utilisez la même casse que celle mentionnée 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 packages en synchronisant First Advantage les First Advantage comptes et les packages avec ServiceNow.

Avant de commencer

Rôle requis : administrateur First Advantage

Procédure

Accédez à la Tous > Spoke First Advantage > Comptes.
Cliquez sur Nouveau.

Renseignez les valeurs du formulaire.

Tableau 5. 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 primaire.
Nom du compte	Nom du compte primaire.

Cliquez sur Envoyer.
Le compte principal est créé et l’enregistrement s’affiche.
Accédez à la Spoke First Advantage > Comptes.
Cliquez sur la liste connexe Obtenir des comptes .
Accédez à la Spoke First Advantage > Packages.
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.