---
sourceDocument: Xanadu: Integrationen mit Anwendungen erstellen
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/integrate-applications

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu: Integrationen mit Anwendungen erstellen

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Richten Sie die ein First Advantage-Spoke

# Richten Sie die ein First Advantage-Spoke {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 Minuten Lesedauer

Integrieren Sie die Instanz ServiceNow in Ihren Account First Advantage, indem Sie einen API-Schlüssel verwenden, um Anforderungen von ServiceNow zu authentifizieren.

## Vorbereitungen

* IntegrationHub-Abonnement anfordern
* First Advantage-Spoke aktivieren
* Erforderliche Rolle: admin
{#setup-first-adv__ul_l2l_mph_gfb}

## Anmeldeinformationsdatensatz für die First Advantage-Spoke erstellen {#ariaid-title2}

Erstellen Sie Anmeldeinformationsdatensätze für First Advantage-Spoke. Der Alias für Verbindungen und Anmeldeinformationen First Advantage-Spoke verwenden diese Anmeldeinformationen zum Autorisieren von Aktionen.

### Vorbereitungen

Erforderliche Rolle: admin.

### Prozedur

1. Navigieren zu AlleVerbindungen und AnmeldeinformationenAkadem. Grade.
2. Klicken Sie auf Neu.  
   Das System zeigt die Meldung Welche Art von Anmeldeinformationen möchten Sie erstellen? an..
3. Wählen Sie API Key-Anmeldeinformationen aus.  
   Ein leeres Formular mit Anmeldeinformationen für API-Schlüssel wird angezeigt.
4. Geben Sie die folgenden Werte ein.  
   {#create-cred-fadv__table_twl_mk2_5kb__entry__2}

   | Feld | Wert erforderlich |
   |-|-|
   | Name | Name zur eindeutigen Identifizierung des Datensatzes. Geben Sie beispielsweise <kbd class="ph userinput">FADV-Anmeldeinformationen</kbd>ein. |
   | Aktiv | Option zur aktiven Verwendung des Anmeldeinformationsdatensatzes. |
   | API-Schlüssel | API-Schlüssel, der für Ihre Instanz First Advantage generiert wurde. Hinweis: Wenden Sie sich an das Team First Advantage, um den API-Schlüssel zu erhalten. |
   | Bestellung | Wählen Sie die Reihenfolge aus, in der diese Anmeldeinformationen angewendet werden. Geben Sie z. B. <kbd class="ph userinput">100</kbd> ein. |
   [ ]

   {#create-cred-fadv__table_twl_mk2_5kb}
5. Klicken Sie auf Absenden.
{#create-cred-fadv__steps_swl_mk2_5kb}

## Verbindungsdatensatz für die First Advantage-Spoke erstellen {#ariaid-title3}

Erstellen Sie einen Verbindungsdatensatz für die First Advantage -API. Der Alias für Verbindungen und Anmeldeinformationen First Advantage-Spoke verwendet diese Verbindungen, um Aktionen in First Advantageauszuführen.

### Vorbereitungen

Erforderliche Rolle: admin.

### Prozedur

1. Navigieren zu AlleVerbindungen und AnmeldeinformationenAliasse für Verbindungen und Anmeldeinformationen.
2. Öffnen Sie für den Datensatz für First Advantage.
3. Klicken Sie auf der Registerkarte Verbindungen auf Neu.  
   Das System zeigt ein leeres HTTP(s)-Verbindungsformular an.
4. Geben Sie die folgenden Werte ein.  
   {#create-conn-fadv__table_any_shp_gfb__entry__2}

   | Feld | Wert erforderlich |
   |-|-|
   | Name | Name zur eindeutigen Identifizierung des Verbindungsdatensatzes. Geben Sie beispielsweise <kbd class="ph userinput">FADV-Verbindung</kbd>ein. |
   | Anmeldeinformationen | Anmeldeinformationsdatensatz, den Sie für First Advantageerstellt haben. Wählen Sie beispielsweise FADV-Anmeldeinformationen aus. |
   | Verbindungs-URL | First Advantage Verbindungs-URL. Geben Sie <kbd class="ph userinput">https://rest-ua.fadv.com ein</kbd>. |
   [ ]

   {#create-conn-fadv__table_any_shp_gfb}
5. Geben Sie auf der Registerkarte Attribute diese Werte ein.  
   {#create-conn-fadv__table_y55_pq2_5kb__entry__2}

   | Feld | Beschreibung |
   |-|-|
   | Distributions-E-Mail | Distributions-E-Mail-Adresse Ihrer Organisation. |
   |   |   |
   | u_version | v1.1 Hinweis: Wenn Sie eine andere Version von First Advantageverwenden, geben Sie die Versionsnummer an. |
   [ ]

   {#create-conn-fadv__table_y55_pq2_5kb}
6. Klicken Sie auf Absenden.
7. Navigieren zu Verbindungen und AnmeldeinformationenAliasse für Verbindungen und Anmeldeinformationen.
8. Öffnen Sie für den Datensatz für First Advantage.
9. Klicken Sie auf die Registerkarte Verbindungsattribute.
10. Ändern Sie die Standardwerte der Verbindungsattributdatensätze entsprechend Ihren Anforderungen.  
    {#create-conn-fadv__table_qft_wp2_5kb__entry__2}

    | Verbindungsattributdatensatz | Standardwert |
    |-|-|
    | Distributions-E-Mail | Distributions-E-Mail-Adresse Ihrer Organisation. |
    |   |   |
    | Version | v1.1 Hinweis: Wenn Sie eine andere Version von First Advantageverwenden, geben Sie die Versionsnummer an. |
    [ ]

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

## Erstellen Sie First Advantage -Status in Ihrer Instanz ServiceNow . {#ariaid-title4}

Erstellen Sie First Advantage -Status, die in der Statusliste in Ihrer Instanz ServiceNow angezeigt werden sollen.

### Vorbereitungen

Erforderliche Rolle: admin

### Erstellen Sie die Status Entwurf, Bereit und In Bearbeitung {#ariaid-title5}

Erstellen Sie die Status „Entwurf", „Bereit" und „In Bearbeitung" in der Aufgabentabelle \[task\].

#### Vorbereitungen

Erforderliche Rolle: admin.

#### Prozedur

1. Geben Sie im <kbd class="ph userinput">Filternavigator sys_choice.list</kbd>ein.  
   Die Datensätze in der Tabelle „Auswahl" \[sys_choice\] werden angezeigt.
2. Klicken Sie auf Neu.
3. Füllen Sie diese Werte im Formular aus, und erstellen Sie drei Datensätze für den Status Entwurf.  
   {#draft-inp-ready-fadv__table_z25_l1x_vkb__entry__2}

   | Feld | Wert |
   |-|-|
   | Tabelle | Aufgabe \[task\] |
   | Element | Staat |
   | Bezeichnung | Entwurf |
   | Wert | 137 |
   [Tabelle : 1. Datensatz 1: Status „Entwurf".]

   {#draft-inp-ready-fadv__table_z25_l1x_vkb}  
   Hinweis:  
   * Stellen Sie sicher, dass Sie im Feld „Wert" genau die hier genannten Zahlen angeben. Die Spoke-Flows werden nicht ausgelöst, wenn sich diese Zahlen ändern.
   * Stellen Sie sicher, dass der Datensatz in der globalen Anwendung erstellt wird.
   {#draft-inp-ready-fadv__ul_dhl_zpy_vkb}
4. Klicken Sie auf Absenden.
5. Erstellen Sie auf ähnliche Weise Datensätze für die Status „Bereit" und „In Bearbeitung".  
   {#draft-inp-ready-fadv__table_v1g_mdy_vkb__entry__2}

   | Feld | Wert |
   |-|-|
   | Tabelle | Aufgabe \[task\] |
   | Element | Staat |
   | Bezeichnung | Bereit |
   | Wert | 173 |
   [Tabelle : 2. Datensatz 2: Status „Bereit".]

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

   | Feld | Wert |
   |-|-|
   | Tabelle | Aufgabe \[task\] |
   | Element | Staat |
   | Bezeichnung | In Bearbeitung |
   | Wert | 181 |
   [Tabelle : 3. Datensatz 3: Status „In Bearbeitung".]

   {#draft-inp-ready-fadv__table_wyf_mdy_vkb}  
   Hinweis:  
   * Stellen Sie sicher, dass Sie im Feld „Wert" genau die hier genannten Zahlen angeben. Die Spoke-Flows werden nicht ausgelöst, wenn sich diese Zahlen ändern.
   * Stellen Sie sicher, dass der Datensatz in der globalen Anwendung erstellt wird.
   {#draft-inp-ready-fadv__d39078e139}
{#draft-inp-ready-fadv__steps_nkw_tbx_vkb}

#### Ergebnisse

In der Aufgabentabelle \[task\] werden die Status „Entwurf", „Bereit" und „In Bearbeitung".

### Erstellen Sie die Status Abgeschlossen und Abgebrochen {#ariaid-title6}

Erstellen Sie in der Tabelle „First Advantage-Aufgabe" \[sn_fadv_spoke_first_advantage_task\] die Status „Abgeschlossen" und „Abgebrochen".

#### Vorbereitungen

Erforderliche Rolle: admin.

#### Prozedur

1. Navigieren zu AlleFirst Advantage-SpokeArbeitsaufgaben.
2. Klicken Sie auf Neu.  
   Hinweis:  
   Stellen Sie sicher, dass der Datensatz in der Anwendung „ First Advantage " erstellt wird.
3. Klicken Sie mit der rechten Maustaste auf Status und anschließend auf Konfigurieren der Auswahlmöglichkeiten.
4. Führen Sie diese Schritte aus, um den Status Abgebrochen zu erstellen:
   1. Geben Sie im Text des neuen Elements den Wert <kbd class="ph userinput">Abgebrochen</kbd>ein.
   2. Geben Sie <kbd class="ph userinput">149</kbd> unter Numerischer Wertein.  
      Hinweis:  
      Stellen Sie sicher, dass Sie im Feld „ Numerischer Wert " genau die Zahlen angeben, die hier erwähnt werden. Die Spoke-Flows werden nicht ausgelöst, wenn sich diese Zahlen ändern.
   3. Klicken Sie auf Hinzufügen.
   4. Klicken Sie auf Speichern.
   {#add-complete-canc-fadv__substeps_oly_w2d_wkb}
5. Führen Sie diese Schritte aus, um den Status Abgeschlossen zu erstellen:
   1. Geben Sie im Text des neuen Elements den Wert <kbd class="ph userinput">Abgeschlossen</kbd>ein.
   2. Geben Sie <kbd class="ph userinput">127 </kbd> unter Numerischer Wertein.  
      Hinweis:  
      Stellen Sie sicher, dass Sie im Feld „ Numerischer Wert " genau die Zahlen angeben, die hier erwähnt werden. Die Spoke-Flows werden nicht ausgelöst, wenn sich diese Zahlen ändern.
   3. Klicken Sie auf Hinzufügen.
   4. Klicken Sie auf Speichern.
   {#add-complete-canc-fadv__substeps_oxx_2fd_wkb}

#### Ergebnisse

Die Status „Abgeschlossen" und „Abgebrochen" werden in der Tabelle „First Advantage-Aufgabe" \[sn_fadv_spoke_first_advantage_task\] erstellt.

### Erstellen Sie die Status Abgeschlossen -- Erfolg und Abgeschlossen -- Geschäft abgebrochen {#ariaid-title7}

Erstellen Sie die Status Abgeschlossen -- Erfolg und Abgeschlossen -- Geschäft abgebrochen in der Tabelle „First Advantage-Mitarbeiteraufgabe" \[sn_fadv_spoke_first_advanage_employee_task_table\].

#### Vorbereitungen

Erforderliche Rolle: admin.

#### Prozedur

1. Navigieren zu AlleFirst Advantage-SpokeMitarbeiteraufgabe.
2. Klicken Sie auf Neu.  
   Hinweis:  
   Stellen Sie sicher, dass der Datensatz in der Anwendung „ First Advantage " erstellt wird.
3. Klicken Sie mit der rechten Maustaste auf Status und anschließend auf Konfigurieren der Auswahlmöglichkeiten.
4. Führen Sie diese Schritte aus, um den Status Abgebrochen zu erstellen:
   1. Geben Sie im Text des neuen Elements „ <kbd class="ph userinput">Abgeschlossen – Erfolg</kbd>" ein.
   2. Geben Sie <kbd class="ph userinput">161</kbd> unter Numerischer Wertein.  
      Hinweis:  
      Stellen Sie sicher, dass Sie im Feld „ Numerischer Wert " genau die Zahlen angeben, die hier erwähnt werden. Die Spoke-Flows werden nicht ausgelöst, wenn sich diese Zahlen ändern.
   3. Klicken Sie auf Hinzufügen.
   4. Klicken Sie auf Speichern.
   {#add-complete-state-fadv__substeps_oly_w2d_wkb}
5. Führen Sie diese Schritte aus, um den Status Abgeschlossen zu erstellen:
   1. Geben Sie im Text „Neues Element " „ <kbd class="ph userinput">Abgeschlossen – Deal unterbrochen</kbd>" ein.
   2. Geben Sie <kbd class="ph userinput">117 </kbd> unter Numerischer Wertein.  
      Hinweis:  
      Stellen Sie sicher, dass Sie im Feld „ Numerischer Wert " genau die Zahlen angeben, die hier erwähnt werden. Die Spoke-Flows werden nicht ausgelöst, wenn sich diese Zahlen ändern.
   3. Klicken Sie auf Hinzufügen.
   4. Klicken Sie auf Speichern.
   {#add-complete-state-fadv__substeps_oxx_2fd_wkb}
{#add-complete-state-fadv__steps_cxx_xyd_wkb}

#### Ergebnisse

Die Status „Abgeschlossen -- Erfolg" und „Abgeschlossen -- Geschäft fehlgeschlagen" werden in der Tabelle „First Advantage-Mitarbeiteraufgabe" \[sn_fadv_spoke_first_advanage_employee_task_table\] erstellt.

## Richten Sie First Advantage -Webhooks ein {#ariaid-title8}

Empfangen Sie Aktualisierungen für Einladungs- und Bestellereignisse in Ihrer Instanz ServiceNow, indem Sie die Webhooks einrichten.

### Vorbereitungen

Erforderliche Rolle: admin

### Geben Sie den Schlüssel in Ihrer Instanz ServiceNow an {#ariaid-title9}

Richten Sie den Webhook First Advantage ein, indem Sie den Schlüssel für den Webhook-Client First Advantage bereitstellen.

#### Vorbereitungen

* Generieren Sie einen sicheren Schlüssel gemäß Ihren Anforderungen, und erfassen Sie den Wert. Zum Beispiel ein base64-codierter Schlüssel.
* Erforderliche Rolle: admin
{#add-fadv-key__ul_qxk_yq2_wkb}

#### Prozedur

1. Navigieren zu AlleFirst Advantage-SpokeDetails zum FADV-Webhook-Client.
2. Klicken Sie auf Neu.
3. Füllen Sie diese Werte im Formular aus.  
   {#add-fadv-key__table_gx1_fr2_wkb__entry__2}

   | Feld | Beschreibung |
   |-|-|
   | Name | Name zur eindeutigen Identifizierung des Datensatzes. |
   | Autorisierungsschlüssel | Schlüssel, den Sie gemäß Ihrer Anforderung generiert haben. |
   [ ]

   {#add-fadv-key__table_gx1_fr2_wkb}
4. Klicken Sie auf Absenden.

### Greifen Sie auf API-Endpunkte zu {#ariaid-title10}

Greifen Sie auf den API-Endpunkt für die Einladungs- und Bestellereignisse zu, und teilen Sie die erforderlichen Details mit First Advantage, um die Webhooks einzurichten.

#### Vorbereitungen

Erforderliche Rolle: admin

#### Prozedur

1. Navigieren zu AlleSystem-WebservicesScripted REST APIs.
2. Öffnen Sie den Datensatz für First Advantage-Spoke, z. B. First Advantage Webhook.
3. Auf der Registerkarte Ressourcen :
   1. Öffnen Sie den Datensatz für das Einladungsereignis, z. B. Einladungsstatus.
   2. Kopieren Sie den in Ressourcenpfad angegebenen Pfad, und notieren Sie ihn, z. B. <kbd class="ph userinput">/api/sn_fadv_spoke/fadv/invite_status</kbd>.
   3. Öffnen Sie den Datensatz für das Bestellereignis, z. B. Bestellstatus.
   4. Kopieren Sie den in Ressourcenpfad angegebenen Pfad, und notieren Sie ihn, z. B. <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}

#### Nächste Maßnahme

Wenden Sie sich an \[ First Advantage, um Webhooks für Ihre Instanz ServiceNow \] einzurichten. Teilen Sie dazu diese Details mit First Advantage:

* Anwenderdefinierter Header in diesem Format: <kbd class="ph userinput">fadvKey</kbd>\<authorization-key\> .  
  Hinweis:  
  * Stellen Sie sicher, dass der anwenderdefinierte Header nur in diesem Format vorliegt. Die Spoke-Flows werden nicht ausgelöst, wenn sich etwas ändert.
  * Geben Sie denselben Schlüssel an, den Sie zuvor in angegeben hatten First Advantage-SpokeDetails zum FADV-Webhook-Client.
  * Verwenden Sie den hier genannten Fall: <kbd class="ph userinput">fadvKey</kbd>.
  {#conf-api-fadv__ul_kfx_lvc_ykb}
* API-Endpunkt für die Einladungsereignisse in diesem Format:\<ServiceNow-instance-URL\> <kbd class="ph userinput">/api/sn_fadv_spoke/fadv/invite_status</kbd>
* API-Endpunkt für die Bestellereignisse in diesem Format:\<ServiceNow-instance-URL\> <kbd class="ph userinput">/api/sn_fadv_spoke/fadv/order_status</kbd>
{#conf-api-fadv__ul_jgh_5d2_wkb}

## First Advantage Accounts und Pakete mit ServiceNowsynchronisieren {#ariaid-title11}

Speichern Sie die Details der First Advantage -Accounts und -Pakete, indem Sie die -Accounts und -Pakete von First Advantage mit ServiceNowsynchronisieren.

### Vorbereitungen

Erforderliche Rolle: First Advantage-Administrator

### Prozedur

1. Navigieren zu AlleFirst Advantage-SpokeAccounts.
2. Klicken Sie auf Neu.
3. Füllen Sie die Werte im Formular aus.  
   {#sync-packages-fadv__table_hhk_nzk_ynb__entry__2}

   | Feld | Beschreibung |
   |-|-|
   | Primärer Account | Option, um anzugeben, dass der Account ein primärer Account ist. Aktivieren Sie das Kontrollkästchen . |
   | Account-ID | ID des primären Accounts |
   | Accountname | Name des primären Accounts |
   [Tabelle : 4. Account-Formular]

   {#sync-packages-fadv__table_hhk_nzk_ynb}
4. Klicken Sie auf Absenden.  
   Der primäre Account wird erstellt, und der Datensatz wird angezeigt.
5. Navigieren zu First Advantage-SpokeAccounts.
6. Klicken Sie auf die zugehörige Liste Accounts abrufen.
7. Navigieren zu First Advantage-SpokePakete.
8. Klicken Sie auf den zugehörigen Link Pakete abrufen.
{#sync-packages-fadv__steps_evy_h1l_ynb}

### Ergebnisse

Die Details zum Account First Advantage und Paket werden abgerufen.  
Hinweis:  
Nur Benutzer mit der Rolle „FADV-Administrator" können die Account- und Paketdetails synchronisieren. Anwender mit der Rolle „FADV" können die abgerufenen Details nur anzeigen.