Zum Hauptinhalt gehen

Wie konfiguriere ich die Reporting-Schnittstelle?

Aktualisiert

Über die OData Reporting-Schnittstelle kann d.vinci Daten über Bewerbungen und Ausschreibungen mit externen Systemen teilen, z. B. für intensives Reporting in BI-Tools.

Um die Reporting-Schnittstelle verwenden zu können, benötigt das externe System, das auf die d.vinci-Daten zugreifen soll, einen API-Benutzer mit dem Recht, die Reporting-Schnittstelle zu verwenden.

Hinweis 
Der API-Benutzer kann auch mit OAuth2.0 abgesichert werden.

 

Hinweis 
Im Artikel Inhalte anzeigen für OData Reporting-Schnittstelle erfahren Sie, wie Sie die technischen Inhalte der Schnittstelle prüfen können.

Gehe wie folgt vor:

  1. Rolle anlegen:
    • Im Feld Name kannst du z. B. "Reporting-Schnittstelle" eingeben.
    • Wähle im Feld Benutzerrolle die Option Nein. Dadurch entfällt auch die Angabe einer Sicherheitsstufe.
    • Wähle im Feld Produkt die Option d.vinci Bewerbermanagement.
    • Wähle im Feld Berechtigungen die Option OData-Reporting-Daten | abrufen
  2. API-Benutzer anlegen:
    • Lege für jedes System, dass an d.vinci angeschlossen werden soll, einen eigenen API-Benutzer an.
    • Im Feld Benutzername kannst du z. B. den Namen des externen Systems angeben, welches mittels dieses Benutzers auf die Reporting-Daten zugreifen soll.
    • Wähle im Feld Organisationseinheit die Option Global.
    • Gib in den Feldern Anrede, Vorname, Nachname und E-Mail-Adresse z. B. die Personendaten einer verantwortlichen Person für das externe System an. Das kann eine Person in ihrem Unternehmen sein, oder der Ansprechpartner im Unternehmen des externen Systems. (Diese Felder haben in diesem Fall keine relevante Funktion, können aber als Kontaktdaten im Falle Anbindungsproblemen des externen Systems dienen.)
    • Wähle im Feld Rolle die oben angelegte Reporting-Schnittstellenrolle aus.
    • Nach dem Anlegen wird ein API-Token generiert. Notiere den Namen des API-Benutzers sowie den API-Token. Du benötigst diese Daten im nächsten Schritt für das Anschließen des externen Systems an d.vinci.

Nachdem der API-Benutzer für das externe System angelegt wurde, kannst du das System an d.vinci anschließen.

Auf der Seite von d.vinci, gehe wie folgt vor:

  1. Öffne die Seite Reports.
  2. Drücke auf das Zahnrad-Symbol  , um weitere Aktionen anzuzeigen. Drücke auf den Button   Reporting-Schnittstelle verwenden. Das gleichnamige Modalfenster wird angezeigt.
  3. Im Modalfenster wird die OData-Quelle des d.vinci-Systems angezeigt. Notiere die URL.

Du verfügst nun über drei wesentliche Daten:

  • Die URL der OData-Quelle
  • Den Namen des API-Benutzers
  • Den API-Token

Mit diesen Daten kannst du d.vinci an alle OData-kompatiblen Systeme anschließen. 

Beispiel: Microsoft Excel 365

  1. Öffne eine Arbeitsmappe in Microsoft Excel 365.
  2. Aktiviere die Registerkarte Daten.
  3. Drücke in der Gruppe Daten abrufen und transformieren auf Daten abrufen, dann auf Aus anderen Quellen und wähle die Option Aus OData-Datenfeed. Das Dialogfenster OData-Feed wird angezeigt.
  4. Gib im Dialogfenster die URL der OData-Quelle an, die du zuvor notiert hast.
  5. Drücke auf Ok. Das Dialogfenster wird neu geladen, diesmal mit einer Menüleiste.
  6. Drücke in der Dialogfenstermenüleiste auf Standard und gib den zuvor notierten Namen des API-Benutzers als Benutzernamen ein und den zuvor notierten API-Token als Kennwort.
  7. Drücke auf Verbinden. Die Reporting-Daten werden aus d.vinci als Tabellen geladen, mit denen ihr eure eigenen Reports erstellen könnt.

Verknüpfung mit

Verwandte Beiträge