Richten Sie die ein First Advantage-Spoke

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 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

    Anmeldeinformationsdatensatz für die First Advantage-Spoke erstellen

    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 Alle > Verbindungen und Anmeldeinformationen > Akadem. 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.
      Feld Wert erforderlich
      Name Name zur eindeutigen Identifizierung des Datensatzes. Geben Sie beispielsweise FADV-Anmeldeinformationenein.
      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. 100 ein.
    5. Klicken Sie auf Absenden.

    Verbindungsdatensatz für die First Advantage-Spoke erstellen

    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 Alle > Verbindungen und Anmeldeinformationen > Aliasse 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.
      Feld Wert erforderlich
      Name Name zur eindeutigen Identifizierung des Verbindungsdatensatzes. Geben Sie beispielsweise FADV-Verbindungein.
      Anmeldeinformationen Anmeldeinformationsdatensatz, den Sie für First Advantageerstellt haben. Wählen Sie beispielsweise FADV-Anmeldeinformationen aus.
      Verbindungs-URL First Advantage Verbindungs-URL. Geben Sie https://rest-ua.fadv.com ein.
    5. Geben Sie auf der Registerkarte Attribute diese Werte ein.
      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.
    6. Klicken Sie auf Absenden.
    7. Navigieren zu Verbindungen und Anmeldeinformationen > Aliasse 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.
      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.

    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 : 1. Datensatz 1: Status „Entwurf“.
      Feld Wert
      Tabelle Aufgabe [task]
      Element Staat
      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 : 2. Datensatz 2: Status „Bereit“.
      Feld Wert
      Tabelle Aufgabe [task]
      Element Staat
      Bezeichnung Bereit
      Wert 173
      Tabelle : 3. Datensatz 3: Status „In Bearbeitung“.
      Feld Wert
      Tabelle Aufgabe [task]
      Element Staat
      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 Elements den 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 den Wert 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: admin

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

    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 Ressourcenpfad angegebenen 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 Ressourcenpfad angegebenen 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 : 4. 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
      Accountname 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.