Richten Sie ein First Advantage Spoke

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

    • Integrieren Sie ServiceNowInstanz mit Ihrem First AdvantageAccount, der einen API-Schlüssel zur Authentifizierung verwendet ServiceNowAnforderungen.

    Vorbereitungen

    • Fordern Sie an IntegrationHubAbonnement.
    • 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 ServiceNowInstanz und First Advantage-Server. Ihr ServiceNowInstanz 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. First Advantage Spoke-Verbindungsformular
      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.
      Verteilungs-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 ServiceNowInstanz

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

    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 im Formular diese Werte aus, und erstellen Sie drei Datensätze für den Status „Entwurf“.
      Tabelle : 2. Datensatz 1: Entwurfsstatus
      Feld Wert
      Tabelle Aufgabe [Aufgabe]
      Element Staat
      Bezeichnung Entwurf
      Wert 137
      Hinweis:
      • Stellen Sie sicher, dass Sie die genauen Zahlen in 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 [Aufgabe]
      Element Staat
      Bezeichnung Bereit
      Wert 173
      Tabelle : 4. Datensatz 3: Status „in Bearbeitung“
      Feld Wert
      Tabelle Aufgabe [Aufgabe]
      Element Staat
      Bezeichnung In Bearbeitung
      Wert 181
      Hinweis:
      • Stellen Sie sicher, dass Sie die genauen Zahlen in 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 den 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. Eingabetaste Abgebrochen In Neuer Elementtext .
      2. Eingabetaste 149 In Numerischer Wert .
        Hinweis:
        Stellen Sie sicher, dass Sie die genauen Zahlen in 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. Eingabetaste Abgeschlossen In Neuer Elementtext .
      2. Eingabetaste 127 In Numerischer Wert .
        Hinweis:
        Stellen Sie sicher, dass Sie die genauen Zahlen in 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 – Deal defekt“

    Erstellen Sie die status „Abgeschlossen – Erfolg“ und „Abgeschlossen – Deal defekt“ 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. Eingabetaste Abgeschlossen: Erfolg In Neuer Elementtext .
      2. Eingabetaste 161 In Numerischer Wert .
        Hinweis:
        Stellen Sie sicher, dass Sie die genauen Zahlen in 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. Eingabetaste Abgeschlossen: Deal Unterbrochen In Neuer Elementtext .
      2. Eingabetaste 117 In Numerischer Wert .
        Hinweis:
        Stellen Sie sicher, dass Sie die genauen Zahlen in 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 unterbrochen“ 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 ServiceNowInstanz durch Einrichten der Webhooks.

    Vorbereitungen

    Erforderliche Rolle: admin

    Geben Sie den Schlüssel in an ServiceNowInstanz

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

    Vorbereitungen

    • Generieren Sie einen sicheren Schlüssel gemäß Ihren Anforderungen, und zeichnen Sie den Wert auf. Beispiel: Ein base64-codierter Schlüssel.
    • Erforderliche Rolle: Administrator

    Prozedur

    1. Navigieren zu Alle > First Advantage-Spoke > FADV-Webhook-Clientdetailsan.
    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 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 AdvantageUm Webhooks für einzurichten ServiceNowInstanz. Geben Sie hierfür diese Details an 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 hatten First Advantage-Spoke > FADV-Webhook-Clientdetailsan.
      • 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 von 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 im Formular die Werte 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.
      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 > 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.