Richten Sie die ein First Advantage-Spoke

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 6 Minuten Lesedauer

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

    Vorbereitungen

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

    Erstellen Sie einen Verbindungsdatensatz für First Advantage-Spoke

    Erstellen Sie einen Verbindungsdatensatz, um Ihre Instanz ServiceNow und den First Advantage-Server zu integrieren. Die Instanz ServiceNow 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-Studio.
    2. Wählen Sie Integrationenaus.
    3. Wählen Sie die Registerkarte Verbindungen.
    4. Geben Sie im Feld Alle Verbindungen durchsuchen den Wert First Advantageein.
      Bestätigen Sie, dass die Registerkarte Ausgehend ausgewählt ist.
    5. Wählen Sie auf der Kachel „FirstAdvantage“ Details anzeigen.
      Schaltfläche „Details anzeigen“ auf der Kachel „FirstAdvantage-Alias“.
    6. Wählen Sie Konfigurieren.
    7. Füllen Sie das Formular aus.
      Tabelle : 1. Formular „First Advantage-Spoke-Verbindung“.
      Feld Beschreibung
      Verbindungsname Name der Verbindung Der standardmäßige und schreibgeschützte Name des ersten Datensatzes entspricht dem des Verbindungsalias. Sie können einen anderen Namen angeben, wenn Sie einen Verbindungsdatensatz erstellen, indem Sie auf Verbindung hinzufügenklicken.
      Verbindungs-URL Option zur Bereitstellung der Verbindungs-URL für den First Advantage-Server. Die URL lautet https://rest-ua.fadv.com.
      Distributions-E-Mail Option zur Angabe einer Verteilungs-E-Mail-ID.
      Version Option zum Bereitstellen der Version der API.
      API-Schlüssel Option zur Eingabe des API-Schlüssels, den der First Advantage-Server zur Authentifizierung von Zugriffsanforderungen verwendet.
      Formular „First Advantage-Verbindung“
    8. Wählen Sie Verbindung konfigurierenaus.
      Der Verbindungsdatensatz ist konfiguriert.

    Erstellen Sie First Advantage -Status in Ihrer Instanz ServiceNow .

    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

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

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Geben Sie im Filternavigator sys_choice.listein.
      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.
      Tabelle : 2. Datensatz 1: Status „Entwurf“.
      Feld Wert
      Tabelle Aufgabe [task]
      Element state
      Bezeichnung Entwurf
      Wert 137
      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.
    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 state
      Bezeichnung Bereit
      Wert 173
      Tabelle : 4. Datensatz 3: Status „In Bearbeitung“.
      Feld Wert
      Tabelle Aufgabe [task]
      Element state
      Bezeichnung In Bearbeitung
      Wert 181
      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.

    Ergebnisse

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

    Erstellen Sie die Status Abgeschlossen und Abgebrochen

    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 Alle > First Advantage-Spoke > Arbeitsaufgaben.
    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 Elementsden Wert Abgebrochenein.
      2. Geben Sie 149 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.
    5. Führen Sie diese Schritte aus, um den Status Abgeschlossen zu erstellen:
      1. Geben Sie im Text des neuen Elements denWert Abgeschlossenein.
      2. Geben Sie 127 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.

    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

    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 Alle > First Advantage-Spoke > Mitarbeiteraufgabe.
    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 „Abgeschlossen – Erfolg“ein.
      2. Geben Sie 161 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.
    5. Führen Sie diese Schritte aus, um den Status Abgeschlossen zu erstellen:
      1. Geben Sie im Text „Neues Element“ „Abgeschlossen – Deal unterbrochen“ein.
      2. Geben Sie 117 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.

    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

    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

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

    Prozedur

    1. Navigieren zu Alle > First Advantage-Spoke > Details zum FADV-Webhook-Client.
    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 Schlüssel, den Sie gemäß Ihrer Anforderung generiert haben.
    4. Klicken Sie auf Absenden.

    Greifen Sie auf API-Endpunkte zu

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

    Prozedur

    1. Navigieren zu Alle > System-Webservices > Scripted 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 Ressourcenpfadangegebenen Pfad, und notieren Sie ihn, z. B. /api/sn_fadv_spoke/fadv/invite_status.
      3. Öffnen Sie den Datensatz für das Bestellereignis, z. B. Bestellstatus.
      4. Kopieren Sie den in Ressourcenpfadangegebenen Pfad, und notieren Sie ihn, z. B. /api/sn_fadv_spoke/fadv/order_status.

    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: fadvKey<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-Spoke > Details zum FADV-Webhook-Client.
      • Verwenden Sie den hier genannten Fall: fadvKey.
    • API-Endpunkt für die Einladungsereignisse in diesem Format:<ServiceNow-instance-URL> /api/sn_fadv_spoke/fadv/invite_status
    • API-Endpunkt für die Bestellereignisse in diesem Format:<ServiceNow-instance-URL> /api/sn_fadv_spoke/fadv/order_status

    First Advantage Accounts und Pakete mit ServiceNowsynchronisieren

    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 Alle > First Advantage-Spoke > Accounts.
    2. Klicken Sie auf Neu.
    3. Füllen Sie die Werte im Formular aus.
      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 > Accounts.
    6. Klicken Sie auf die zugehörige Liste Accounts abrufen.
    7. Navigieren zu First Advantage-Spoke > Pakete.
    8. Klicken Sie auf den zugehörigen Link Pakete abrufen.

    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.