---
sourceDocument: Xanadu : créer des intégrations avec des applications
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/integrate-applications

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Xanadu : créer des intégrations avec des applications

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Configurer le First AdvantageSpoke

# Configurer le First AdvantageSpoke {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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
{#setup-first-adv__ul_l2l_mph_gfb}

## Créer un enregistrement d'informations d'identification pour le First AdvantageSpoke {#ariaid-title2}

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 ToutConnexions et informations d'identificationInformations 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.  
   {#create-cred-fadv__table_twl_mk2_5kb__entry__2}

   | Champ | Valeur requise |
   |-|-|
   | Nom | Nom permettant d'identifier l'enregistrement de façon unique. Par exemple, entrez <kbd class="ph userinput">Informations d’identification FADV</kbd>. |
   | 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 <kbd class="ph userinput">100</kbd>. |
   [ ]

   {#create-cred-fadv__table_twl_mk2_5kb}
5. Cliquez sur Envoyer.
{#create-cred-fadv__steps_swl_mk2_5kb}

## Créer un enregistrement de connexion pour le First AdvantageSpoke {#ariaid-title3}

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 ToutConnexions et informations d'identificationAlias 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.  
   {#create-conn-fadv__table_any_shp_gfb__entry__2}

   | Champ | Valeur requise |
   |-|-|
   | Nom | Nom permettant d'identifier de façon unique l'enregistrement de connexion. Par exemple, entrez <kbd class="ph userinput">Connexion FADV</kbd>. |
   | 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 <kbd class="ph userinput">https://rest-ua.fadv.com</kbd>. |
   [ ]

   {#create-conn-fadv__table_any_shp_gfb}
5. Dans l'onglet Attributs , entrez ces valeurs.  
   {#create-conn-fadv__table_y55_pq2_5kb__entry__2}

   | 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. |
   [ ]

   {#create-conn-fadv__table_y55_pq2_5kb}
6. Cliquez sur Envoyer.
7. Accédez à la Connexions et informations d'identificationAlias 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.  
    {#create-conn-fadv__table_qft_wp2_5kb__entry__2}

    | 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. |
    [ ]

    {#create-conn-fadv__table_qft_wp2_5kb}
{#create-conn-fadv__steps_zwz_fhz_4fb}

## Créer des First Advantage états dans votre ServiceNow instance {#ariaid-title4}

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 {#ariaid-title5}

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 <kbd class="ph userinput">sys_choice.list</kbd>.  
   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.  
   {#draft-inp-ready-fadv__table_z25_l1x_vkb__entry__2}

   | Champ | Valeur |
   |-|-|
   | Table | Tâche \[task\] |
   | Élément | État |
   | Étiquette | Brouillon |
   | Valeur | 137 |
   [Tableau 1. Enregistrement 1 : état de brouillon]

   {#draft-inp-ready-fadv__table_z25_l1x_vkb}  
   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 .
   {#draft-inp-ready-fadv__ul_dhl_zpy_vkb}
4. Cliquez sur Envoyer.
5. De même, créez des enregistrements pour les états Prêt et En cours.  
   {#draft-inp-ready-fadv__table_v1g_mdy_vkb__entry__2}

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

   {#draft-inp-ready-fadv__table_v1g_mdy_vkb} {#draft-inp-ready-fadv__table_wyf_mdy_vkb__entry__2}

   | Champ | Valeur |
   |-|-|
   | Table | Tâche \[task\] |
   | Élément | État |
   | Étiquette | En cours |
   | Valeur | 181 |
   [Tableau 3. Enregistrement 3 : état En cours]

   {#draft-inp-ready-fadv__table_wyf_mdy_vkb}  
   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 .
   {#draft-inp-ready-fadv__d39078e139}
{#draft-inp-ready-fadv__steps_nkw_tbx_vkb}

#### 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é {#ariaid-title6}

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 ToutSpoke First AdvantageTâ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. <kbd class="ph userinput">Saisissez Annulé</kbd> dans le texte du nouvel élément.
   2. Entrez <kbd class="ph userinput">149</kbd> 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.
   {#add-complete-canc-fadv__substeps_oly_w2d_wkb}
5. Effectuez les étapes suivantes pour créer l'état Terminé :
   1. Saisissez <kbd class="ph userinput">Terminé dans le</kbd>texte du nouvel élément.
   2. Entrez <kbd class="ph userinput">127 </kbd> 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.
   {#add-complete-canc-fadv__substeps_oxx_2fd_wkb}

#### 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é {#ariaid-title7}

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 ToutSpoke First AdvantageTâ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. <kbd class="ph userinput">Entrer Terminé – Réussite</kbd> dans le texte du nouvel élément.
   2. Entrez <kbd class="ph userinput">161</kbd> 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.
   {#add-complete-state-fadv__substeps_oly_w2d_wkb}
5. Effectuez les étapes suivantes pour créer l'état Terminé :
   1. <kbd class="ph userinput">Entrer Terminé : rupture de l’accord</kbd> dans le texte du nouvel élément.
   2. Entrez <kbd class="ph userinput">117 </kbd> 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.
   {#add-complete-state-fadv__substeps_oxx_2fd_wkb}
{#add-complete-state-fadv__steps_cxx_xyd_wkb}

#### 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 {#ariaid-title8}

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 {#ariaid-title9}

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
{#add-fadv-key__ul_qxk_yq2_wkb}

#### Procédure

1. Accédez à la ToutSpoke First AdvantageDétails du client Webhook FADV.
2. Cliquez sur Nouveau.
3. Renseignez ces valeurs sur le formulaire.  
   {#add-fadv-key__table_gx1_fr2_wkb__entry__2}

   | 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. |
   [ ]

   {#add-fadv-key__table_gx1_fr2_wkb}
4. Cliquez sur Envoyer.

### Points de terminaison d'API d'accès {#ariaid-title10}

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 ToutServices web du systèmeAPI 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, <kbd class="ph userinput">/api/sn_fadv_spoke/fadv/invite_status</kbd>.
   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, <kbd class="ph userinput">/api/sn_fadv_spoke/fadv/order_status</kbd>.
   {#conf-api-fadv__substeps_cyb_md2_wkb}
{#conf-api-fadv__steps_gft_kr2_wkb}

#### 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 : <kbd class="ph userinput">fadvKey &lt;authorization-key&gt;</kbd>.  
  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 AdvantageDétails du client Webhook FADV.
  * Utilisez le même cas que celui mentionné ici : <kbd class="ph userinput">fadvKey</kbd>.
  {#conf-api-fadv__ul_kfx_lvc_ykb}
* Point de terminaison d'API pour les événements d'invitation au format suivant : <kbd class="ph userinput">&lt; ServiceNow-instance-URL &gt;/api/sn_fadv_spoke/fadv/invite_status</kbd>
* Point de terminaison d'API pour les événements de commande au format suivant : <kbd class="ph userinput">&lt; ServiceNow-instance-URL &gt;/api/sn_fadv_spoke/fadv/order_status</kbd>
{#conf-api-fadv__ul_jgh_5d2_wkb}

## Synchroniser les comptes et les First Advantage packages avec ServiceNow {#ariaid-title11}

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 ToutSpoke First AdvantageComptes.
2. Cliquez sur Nouveau.
3. Renseignez les valeurs du formulaire.  
   {#sync-packages-fadv__table_hhk_nzk_ynb__entry__2}

   | 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. |
   [Tableau 4. Formulaire de compte]

   {#sync-packages-fadv__table_hhk_nzk_ynb}
4. Cliquez sur Envoyer.  
   Le compte principal est créé et l'enregistrement s'affiche.
5. Accédez à la Spoke First AdvantageComptes.
6. Cliquez sur la liste connexe Obtenir des comptes .
7. Accédez à la Spoke First AdvantagePackages.
8. Cliquez sur le lien connexe Obtenir des packages .
{#sync-packages-fadv__steps_evy_h1l_ynb}

### 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.