====== EVN/CDR Daten per API in LibreOffice Calc abfragen ======
Voraussetzung:\\
Produkt: **vTK-EVN / CDR-Daten pro Nebenstelle**

Sie möchten sich detaillierte Verbindungsdaten ihrer Telefonanlage anzeigen lassen?\\
Ihnen ist das Herunterladen der csv-Datei aus dem reventix Portal zu lästig?\\
Sie haben wenig Web-/Programmierkenntnisse und brauchen eine schnelle, praktische Lösung?\\

Die API Anbindung über Libre Office Calc ist bequem und simpel.
Darüber hinaus können Sie die erstellte Tabelle nach Ihren Wünschen gestalten, Pivot Tabellen erstellen, Statistiken einbauen o.ä.

Hier zeigen wir Ihnen wie die Anbindung funktioniert.
-----
===== - Externe Verknüpfungen... =====

Öffnen Sie **Libre Office Calc** und navigieren Sie Ihnen Cursor zu folgenden Unterpunkten: **Tabelle** -> **Externe Verknüpfungen...** \\
\\
{{:api:beispiele:1.png|}}\\

Wenn Sie das richtige Feld ausgewählt haben, müsste sich folgendes Fenster öffnen:\\
\\
{{:pop_up_loc.png?|}}
\\
\\
Tippen Sie nun die komplette Abfrage URL in das leere Feld ein. Zur Erstellung der Abfragen können Sie gerne unsere **[[https://app.swaggerhub.com/apis-docs/reventix/API/v1|API Swagger Doku]]** verwenden oder uns darauf ansprechen. Bei Fragen und Problemen unterstützen wir Sie immer gerne.\\
\\
Alternativ können Sie folgende URL kopieren und die farbigen Felder mit Ihren gewünschten Angaben ersetzen: \\
** https://web-api-v1.reventix.de:8443/cdr/<color #ed1c24>**X**</color>/pbx?start_ts=<color #ed1c24>**Y**</color>&direction=<color #ed1c24> **Z**</color>&presentation=csv ** \\
\\
1-<color #ed1c24>**X**</color>: An dieser Stelle bitte **Ihre Kundennummer eingeben** \\
2-<color #ed1c24>**Y**</color>: An dieser Stelle bitte das Datum und die Uhrzeit als **[[https://www.unixtimestamp.com/|Unix Time Stamp]]** eintragen, von wann die Verbindungsdaten angezeigt werden sollen \\
3-<color #ed1c24>**Z**</color>: An dieser Stelle bitte die **Richtung eingeben**, die sie einsehen wollen → eingehende (in) oder ausgehende Anrufe (out)
\\
\\
{{:drop_down_menü.png?|}}
\\
\\
Nach erfolgreicher Konfiguration wird in Zukunft die Anwendung unter Verfügbare Tabelle/ Bereiche zur schnelleren Auswahl vorhanden sein. \\
\\
{{:5.png|}}
-----
===== - API-Zugangsdaten und Authentifizierung =====
Nach korrekter URL Eingabe benötigt Libre Office Calc noch Ihre API Zugangsdaten um sich mit der Ressource zu verbinden. \\
Ihre API-Zugangsdaten erhalten Sie auf Anfrage per E-Mail von uns. 
\\
\\ 
{{:3.png?400|}}
\\
\\ Geben Sie nun Ihre Zugangsdaten, also Benutzername und Passwort in die entsprechenden Felder ein und bestätigen Sie diese mit **OK**.\\
-----
===== - Datenabruf =====
Nun bekommen Sie nochmal eine Vorschau der Daten und können weitere Konfigurationen vornehmen. Wenn Sie mit der Anpassung fertig sind klicken Sie nun auf **OK**.\\
\\
{{:textimport.png?|}}
-----
===== - Datenaktualisierung =====

Um Ihre geöffneten Daten zu aktualisieren navigierten Sie bitte zu folgenden Unterpunkten: **Bearbeiten** -> **Verknüpfungen zu externen Dateien...**
\\
\\
{{:screenshot_2023-11-29_130553.png?|}}
\\
\\
Es wird sich folgendes Feld öffnen: 
\\
\\
{{:aktualisieren.png|}}
\\
\\
Klicken Sie nun auf **Aktualisieren**. \\
Falls sich ein Authentifizierungsfenster öffnen sollte geben Sie Ihre Zugangsdaten erneut ein und bestätigen Sie diese mit **OK**.
----- 

===== - Abkürzungen =====

**EVN** - Einzelverbindungsnachweis\\
**CDR** - Ein Call Detail Record oder Call Data Record enthält die Informationen, welche für ein Abrechnungssystem im Telekommunikationsbereich benötigt werden.

-----
===== - Literaturnachweise / Links =====


  * reventix API Swagger Doku: https://app.swaggerhub.com/apis-docs/reventix/API/v1
  * Wikipedia: https://de.wikipedia.org/wiki/Call_Detail_Record
  * Homepage der reventix GmbH: https://www.reventix.de
  * Kundenportal der reventix GmbH: https://login.sipbase.de

{{tag>api evn cdr }}