Richten Sie ein First Advantage-Spoke

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 7 Minuten Lesedauer

    • Integrieren Sie die Instanz ServiceNow mit Ihrem Konto First Advantage mithilfe eines API-Schlüssels, 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 verwendet diese Anmeldeinformationen zum Autorisieren von Aktionen.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Berechtigungen.
    2. Klicken Sie auf Neu.
      Das System zeigt die Meldung Welche Art von Anmeldeinformationen möchten Sie erstellen? an..
    3. Wählen Sie Anmeldeinformationen für API-Schlüssel aus.
      Ein leeres Formular für API-Schlüsselanmeldeinformationen 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.
      Reihenfolge Wählen Sie die Reihenfolge aus, in der diese Anmeldeinformationen angewendet werden. Geben Sie z. B. 100ein.
    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 zum Ausführen von Aktionen in First Advantage.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Aliasse für Verbindungen und Anmeldeinformationen.
    2. Für den Datensatz für First Advantageöffnen.
    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.
      Anmeldeinformation 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 Verteilungs-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. Für den Datensatz für First Advantageöffnen.
    9. Klicken Sie auf die Registerkarte Verbindungsattribute.
    10. Ändern Sie die Standardwerte der Verbindungsattributdatensätze gemäß Ihren Anforderungen.
      Datensatz mit Verbindungsattributen Standardwert
      Distributions-E-Mail Verteilungs-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 ServiceNow -Instanz 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 [Aufgabe].

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Geben Sie im Filternavigator sys_choice.listein.
      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 : 1. Datensatz 1: Entwurfsstatus
      Feld Wert
      Tabelle Aufgabe [task]
      Element Staat
      Bezeichnung Entwurf
      Wert 137
      Hinweis:
      • Stellen Sie sicher, dass Sie im Feld Wert die genauen Zahlen angeben, wie hier erwähnt. 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 die genauen Zahlen angeben, wie hier erwähnt. 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

    Die Status „Entwurf“, „Bereit“ und „In Bearbeitung“ werden in der Aufgabentabelle [task] 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 > Arbeitsaufgaben.
    2. Klicken Sie auf Neu.
      Hinweis:
      Stellen Sie sicher, dass der Datensatz in der First Advantage -Anwendung erstellt wird.
    3. Klicken Sie mit der rechten Maustaste auf Status, und klicken Sie auf Auswahlmöglichkeiten konfigurieren.
    4. Führen Sie diese Schritte aus, um den Status „Abgebrochen“ zu erstellen:
      1. Geben Sie Abgebrochen in Text für neues Element ein.
      2. Geben Sie 149 in das Feld 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 Abgeschlossen in Text für neues Element ein.
      2. Geben Sie 127 in das Feld 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 – Deal defekt“.

    Erstellen Sie in der Tabelle „First Advantage-Mitarbeiteraufgabe“ [sn_fadv_spoke_first_advantage_employee_task_table] die Status Abgeschlossen – Erfolg und Abgeschlossen – Deal defekt.

    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 First Advantage -Anwendung erstellt wird.
    3. Klicken Sie mit der rechten Maustaste auf Status, und klicken Sie auf Auswahlmöglichkeiten konfigurieren.
    4. Führen Sie diese Schritte aus, um den Status „Abgebrochen“ zu erstellen:
      1. Geben Sie Abgeschlossen – Erfolgreich in den Text für neues Element ein.
      2. Geben Sie 161 in das Feld 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 Abgeschlossen – Deal defekt in den Text für neues Element ein.
      2. Geben Sie 117 in das Feld 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

    In der Tabelle „First Advantage-Mitarbeiteraufgabe“ [sn_fadv_spoke_first_advantage_employee_task_table] werden die Status „Abgeschlossen – Erfolgreich“ und „Abgeschlossen – Deal defekt“ erstellt.

    Richten Sie First Advantage Webhooks ein

    Empfangen Sie Einladungs- und Bestell-Event-Updates in Ihrer ServiceNow -Instanz, 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 angeben.

    Vorbereitungen

    • Generieren Sie einen sicheren Schlüssel gemäß Ihren Anforderungen, und notieren 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 ServiceNow -Instanz einzurichten. Geben Sie dazu die folgenden Details an First Advantageweiter :
    • Benutzerdefinierter Header in diesem Format: fadvKey<authorization-key> .
      Hinweis:
      • Stellen Sie sicher, dass der benutzerdefinierte Header nur in diesem Format vorliegt. Die Spoke-Flows werden nicht ausgelöst, wenn Änderungen vorgenommen werden.
      • Geben Sie denselben Schlüssel an, den Sie zuvor in bereitgestellt haben First Advantage-Spoke > Details zum FADV-Webhook-Client.
      • Verwenden Sie den gleichen Fall wie hier: 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 Bestell-Events 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 Konten und Pakete von [ First Advantage, indem Sie Konten 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 das Konto ein primäres Konto ist. Aktivieren Sie das Kontrollkästchen .
      Account-ID ID des primären Accounts
      Accountname Name des primären Accounts.
    4. Klicken Sie auf Absenden.
      Das primäre Konto 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 Account- und Paketdetails First Advantage werden abgerufen.
    Hinweis:
    Nur Benutzer mit der FADV-Administratorrolle können die Account- und Paketdetails synchronisieren. Benutzer mit der FADV-Benutzerrolle können nur die abgerufenen Details anzeigen.