Richten Sie ein First Advantage-Spoke

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 7 Minuten Lesedauer

    • Integrieren Sie ServiceNow Instanz mit Ihrem First AdvantageAccount, der einen API-Schlüssel zur Authentifizierung verwendet ServiceNow Anforderungen.

    Vorbereitungen

    • Fordern Sie an IntegrationHub Abonnement.
    • Aktivieren Sie First Advantage-Spoke.
    • Erforderliche Rolle: admin.

    Erstellen Sie einen Verbindungsdatensatz für First Advantage-Spoke

    Erstellen Sie einen Verbindungsdatensatz, um Ihren zu integrieren ServiceNow Instanz und First Advantage-Server. Ihr ServiceNow Die Instanz verwendet diesen Verbindungsdatensatz, um die First Advantage Spoke-Aktionen auszuführen.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Rufen Sie den API-Schlüssel vom First Advantage-Server ab.

    Prozedur

    1. Navigieren zu Alle > Prozessautomatisierung > Workflow-Studioan.
    2. Wählen Sie Aus Integrationen .
    3. Wählen Sie aus Verbindungen Registerkarte.
    4. Geben Sie im Feld alle Verbindungen durchsuchen ein First Advantage .
      Bestätigen Sie, dass Ausgehend Registerkarte ist ausgewählt.
    5. Wählen Sie auf der Kachel FirstAdvantage die Option aus Details Anzeigen .
      Schaltfläche „Details anzeigen“ auf der FirstAdvantage-Aliaskachel.
    6. Wählen Sie Konfigurieren.
    7. Füllen Sie das Formular aus.
      Tabelle : 1. Verbindungsformular für First Advantage-Spoke
      Feld Beschreibung
      Verbindungsname Name der Verbindung Der standardmäßige und schreibgeschützte Name des ersten Datensatzes ist mit dem des Verbindungsalias identisch. Sie können einen anderen Namen angeben, wenn Sie einen Verbindungsdatensatz erstellen, indem Sie auf klicken Verbindung Hinzufügen .
      Verbindungs-URL Option zum Bereitstellen der Verbindungs-URL für den First Advantage-Server. Die URL ist https://rest-ua.fadv.com.
      Distributions-E-Mail Option zum Bereitstellen einer Verteilungs-E-Mail-ID.
      Version Option zum Bereitstellen der Version der API.
      API-Schlüssel Option zum Eingeben des API-Schlüssels, den der First Advantage-Server zur Authentifizierung von Zugriffsanforderungen verwendet.
      First Advantage-Verbindungsformular.
    8. Wählen Sie Aus Konfigurieren Sie Die Verbindung .
      Der Verbindungsdatensatz ist konfiguriert.

    Erstellen First Advantagestatus in Ihrem ServiceNow Instanz

    Erstellen First Advantagestatus, die in angezeigt werden sollen Status Liste in Ihrem ServiceNow Instanz.

    Vorbereitungen

    Erforderliche Rolle: admin

    Erstellen Sie die status Entwurf, bereit und in Bearbeitung

    Erstellen Sie die status Entwurf, bereit und in Bearbeitung in der Tabelle „Aufgabe“ [Aufgabe].

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Geben Sie im Filternavigator ein sys_choice.list .
      Die Datensätze in der Auswahltabelle [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.
      Tabelle : 2. Datensatz 1: Entwurfsstatus
      Feld Wert
      Tabelle Aufgabe [task]
      Element Status
      Bezeichnung Entwurf
      Wert 137
      Hinweis:
      • Stellen Sie sicher, dass Sie die genauen Zahlen im angeben Wert Feld wie hier erwähnt. Die Spoke-Flows werden nicht ausgelöst, wenn sich diese Zahlen ändern.
      • Stellen Sie sicher, dass der Datensatz in erstellt wird Global Anwendung.
    4. Klicken Sie auf Absenden.
    5. Erstellen Sie auf ähnliche Weise Datensätze für die status „bereit“ und „in Bearbeitung“.
      Tabelle : 3. Datensatz 2: Status „bereit“
      Feld Wert
      Tabelle Aufgabe [task]
      Element Status
      Bezeichnung Bereit
      Wert 173
      Tabelle : 4. Datensatz 3: Status „in Bearbeitung“
      Feld Wert
      Tabelle Aufgabe [task]
      Element Status
      Bezeichnung In Bearbeitung
      Wert 181
      Hinweis:
      • Stellen Sie sicher, dass Sie die genauen Zahlen im angeben Wert Feld wie hier erwähnt. Die Spoke-Flows werden nicht ausgelöst, wenn sich diese Zahlen ändern.
      • Stellen Sie sicher, dass der Datensatz in erstellt wird Global Anwendung.

    Ergebnisse

    Die status Entwurf, bereit und in Bearbeitung werden in der Tabelle Aufgabe [Aufgabe] erstellt

    Erstellen Sie die status Abgeschlossen und Abgebrochen

    Erstellen Sie die status „Abgeschlossen“ und „Abgebrochen“ in der Tabelle „First Advantage-Aufgabe“ [sn_fadv_Spoke_first_Advantage_Task].

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Navigieren zu Alle > First Advantage-Spoke > Arbeitsaufgabenan.
    2. Klicken Sie auf Neu.
      Hinweis:
      Stellen Sie sicher, dass der Datensatz in erstellt wird First Advantage Anwendung.
    3. Rechtsklick Status Und klicken Sie auf Konfigurieren Sie Auswahlmöglichkeiten .
    4. Führen Sie die folgenden Schritte aus, um den Status „Abgebrochen“ zu erstellen:
      1. Geben Sie Ein Abgebrochen In Neuer Elementtext .
      2. Geben Sie Ein 149 In Numerischer Wert .
        Hinweis:
        Stellen Sie sicher, dass Sie die genauen Zahlen im angeben Numerischer Wert Feld wie hier erwähnt. Die Spoke-Flows werden nicht ausgelöst, wenn sich diese Zahlen ändern.
      3. Klicken Sie auf Hinzufügen.
      4. Klicken Sie auf Speichern.
    5. Führen Sie die folgenden Schritte aus, um den Status „Abgeschlossen“ zu erstellen:
      1. Geben Sie Ein Abgeschlossen In Neuer Elementtext .
      2. Geben Sie Ein 127 In Numerischer Wert .
        Hinweis:
        Stellen Sie sicher, dass Sie die genauen Zahlen im angeben Numerischer Wert Feld wie hier erwähnt. Die Spoke-Flows werden nicht ausgelöst, wenn sich diese Zahlen ändern.
      3. Klicken Sie auf Hinzufügen.
      4. Klicken Sie auf Speichern.

    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äftsunterbrechung“

    Erstellen Sie die status „Abgeschlossen – Erfolg“ und „Abgeschlossen – Geschäftsunterbrechung“ in der Tabelle „First Advantage-Mitarbeiteraufgabe“ [sn_fadv_Spoke_First_Advantage_Employee_Task_table].

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Navigieren zu Alle > First Advantage-Spoke > Mitarbeiteraufgabean.
    2. Klicken Sie auf Neu.
      Hinweis:
      Stellen Sie sicher, dass der Datensatz in erstellt wird First Advantage Anwendung.
    3. Rechtsklick Status Und klicken Sie auf Konfigurieren Sie Auswahlmöglichkeiten .
    4. Führen Sie die folgenden Schritte aus, um den Status „Abgebrochen“ zu erstellen:
      1. Geben Sie Ein Abgeschlossen: Erfolg In Neuer Elementtext .
      2. Geben Sie Ein 161 In Numerischer Wert .
        Hinweis:
        Stellen Sie sicher, dass Sie die genauen Zahlen im angeben Numerischer Wert Feld wie hier erwähnt. Die Spoke-Flows werden nicht ausgelöst, wenn sich diese Zahlen ändern.
      3. Klicken Sie auf Hinzufügen.
      4. Klicken Sie auf Speichern.
    5. Führen Sie die folgenden Schritte aus, um den Status „Abgeschlossen“ zu erstellen:
      1. Geben Sie Ein Abgeschlossen: Deal Gebrochen In Neuer Elementtext .
      2. Geben Sie Ein 117 In Numerischer Wert .
        Hinweis:
        Stellen Sie sicher, dass Sie die genauen Zahlen im angeben Numerischer Wert Feld wie hier erwähnt. Die Spoke-Flows werden nicht ausgelöst, wenn sich diese Zahlen ändern.
      3. Klicken Sie auf Hinzufügen.
      4. Klicken Sie auf Speichern.

    Ergebnisse

    Die status „Abgeschlossen – Erfolg“ und „Abgeschlossen – Deal gebrochen“ werden in der Tabelle „First Advantage-Mitarbeiteraufgabe“ [sn_fadv_Spoke_First_Advantage_Employee_Task_table] erstellt.

    Einrichten First AdvantageWebhooks

    Erhalten Sie Updates zu Einladungs- und Bestellereignissen auf Ihrem ServiceNow Instanz durch Einrichten der Webhooks.

    Vorbereitungen

    Erforderliche Rolle: admin

    Erstellen Sie einen Autorisierungsschlüssel für die First Advantage-Spoke

    Erstellen Sie einen Autorisierungsschlüssel, um Anforderungen von Jenkins zu autorisieren.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > Systemdefinition > Skripts – Hintergrundan.
    2. Geben Sie diesen Befehl in ein Skript ausführen (JavaScript auf Server ausgeführt) Textfeld:
      gs.info(GlideSecureRandomUtil.getSecureRandomString(32));
    3. Klicken Sie auf Skript ausführen.
    4. Kopieren Sie den generierten Wert, und zeichnen Sie ihn zur späteren Verwendung auf.
      Geheimer Clientschlüssel oder Autorisierungsschlüssel

    Geben Sie den Schlüssel in an ServiceNow Instanz

    Richten Sie ein First AdvantageWebhook durch Angabe des Schlüssels für First AdvantageWebhook-Client.

    Vorbereitungen

    Prozedur

    1. Navigieren zu Alle > First Advantage-Spoke > Details zum FADV-Webhook-Clientan.
    2. Klicken Sie auf Neu.
    3. Füllen Sie diese Werte im Formular aus.
      Feld Beschreibung
      Name Name zur eindeutigen Identifizierung des Datensatzes.
      Autorisierungsschlüssel Autorisierungsschlüssel, den Sie generiert haben. Weitere Informationen finden Sie unter Erstellen Sie einen Autorisierungsschlüssel für die First Advantage-Spoke.
    4. Klicken Sie auf Absenden.

    Greifen Sie auf API-Endpunkte zu

    Greifen Sie auf den API-Endpunkt für die Einladungs- und Auftragsereignisse zu, und geben Sie die erforderlichen Details für frei First AdvantageZum Einrichten der Webhooks.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Navigieren zu Alle > System-Webservices > Scripted REST APIsan.
    2. Öffnen Sie den Datensatz für First Advantage-Spoke, Beispiel: First Advantage-Webhook .
    3. In Ressourcen Registerkarte:
      1. Öffnen Sie den Datensatz für das Einladungsereignis, z. B. Einladungsstatus .
      2. Kopieren Sie den in angegebenen Pfad, und zeichnen Sie ihn auf Ressourcenpfad , Beispiel: /api/sn_fadv_Spoke/fadv/einladen_Status .
      3. Öffnen Sie den Datensatz für das Auftragsereignis, z. B. Auftragsstatus .
      4. Kopieren Sie den in angegebenen Pfad, und zeichnen Sie ihn auf Ressourcenpfad , Beispiel: /api/sn_fadv_Spoke/fadv/order_Status .

    Nächste Maßnahme

    Kontakt First AdvantageZum Einrichten von Webhooks für Ihren ServiceNow Instanz. Geben Sie diese Details hierfür mit frei First Advantage:
    • Anwenderdefinierter Header in diesem Format: FadvKey-<authorization-key> .
      Hinweis:
      • Stellen Sie sicher, dass der anwenderdefinierte Header nur dieses Format hat. Die Spoke-Flows werden bei einer Änderung nicht ausgelöst.
      • Geben Sie denselben Schlüssel an, den Sie zuvor in angegeben haben First Advantage-Spoke > Details zum FADV-Webhook-Clientan.
      • Verwenden Sie denselben Fall wie hier erwähnt: FadvKey .
    • API-Endpunkt für die Einladungsereignisse in diesem Format: <ServiceNow-instance-URL>/api/sn_fadv_Spoke/fadv/einladen_Status
    • API-Endpunkt für die Auftragsereignisse in diesem Format: <ServiceNow-instance-URL>/api/sn_fadv_Spoke/fadv/order_Status

    Synchronisieren First AdvantageAccounts und Pakete mit ServiceNow

    Speichern Sie die Details des First AdvantageAccounts und Pakete durch Synchronisierung First AdvantageAccounts und Pakete mit ServiceNow.

    Vorbereitungen

    Erforderliche Rolle: First Advantage-Administrator

    Prozedur

    1. Navigieren zu Alle > First Advantage-Spoke > Accountsan.
    2. Klicken Sie auf Neu.
    3. Geben Sie die Werte im Formular ein.
      Tabelle : 5. Account-Formular
      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.
      Account-Name Name des primären Accounts.
    4. Klicken Sie auf Absenden.
      Der primäre Account wird erstellt, und der Datensatz wird angezeigt.
    5. Navigieren zu First Advantage-Spoke > Accountsan.
    6. Klicken Sie auf Accounts Abrufen Zugehörige Liste.
    7. Navigieren zu First Advantage-Spoke > Paketean.
    8. Klicken Sie auf Pakete Abrufen Zugehöriger Link.

    Ergebnisse

    Die First AdvantageAccount- und Paketdetails werden abgerufen.
    Hinweis:
    Nur Anwender mit der FADV-Administratorrolle können die Account- und Paketdetails synchronisieren. Anwender mit der FADV-Anwenderrolle können nur die abgerufenen Details anzeigen.