Zum Hauptinhalt springen

View-Referenz

Diese Seite dokumentiert alle 24 versionslosen Views, die Insight Analytics in der Zieldatenbank anlegt, mit sämtlichen Spalten, Datentypen und Bedeutungen. Konzept, Verbindung und Beispielabfragen beschreibt die Seite Datenbank-Views; die angegebenen Datentypen gelten für das Zielsystem PostgreSQL.

Konventionen​

  • Bezeichner: In PostgreSQL sind alle Tabellen-, View- und Spaltennamen in doppelten Anführungszeichen angelegt und damit case-sensitiv — in Abfragen exakt und in doppelten Anführungszeichen schreiben ("CDR_Summary", "Account_ID").
  • Konto- und Dienst-IDs: ID-Spalten tragen die Standort-Kennung der Anlage als Präfix, Format Standort-UUID_ID (Trennzeichen _). Sie sind damit auch bei mehreren angebundenen Anlagen eindeutig und dienen als Verknüpfungsschlüssel zwischen den Views. Negative ID-Werte sind Platzhalterkonten („kein Konto", „gelöschtes Konto").
  • Zeitstempel: Alle TIMESTAMP-Spalten enthalten die lokale Anlagenzeit der STARFACE ohne Zeitzonenangabe.
  • Dauerspalten: Suffixe _s, _m, _h bezeichnen dieselbe Dauer in Sekunden, Minuten bzw. Stunden (gerundete DECIMAL-Werte).
  • _i18n-Spalten: sprachabhängige Anzeigetexte in der konfigurierten Berichtssprache des Moduls (Deutsch, Englisch oder Französisch). Die Beispielwerte in dieser Referenz zeigen die deutsche Berichtssprache. Für maschinelle Auswertungen die zugehörige sprachneutrale Spalte verwenden.

Gesprächsdaten​

CDR_Summary​

Tabelle CDR_Summary_4. Die zentrale Auswertungsquelle: je Anruf ein aufbereiteter, klassifizierter Datensatz; bei Weiterleitungen entsteht je Weiterleitungsziel ein Datensatz. Nicht repräsentative Zwischenzeilen der Klassifizierung tragen is_garbage = true — für Auswertungen stets NOT "is_garbage" filtern.

SpalteTypBedeutung
call_idTEXTAnruf-ID aus dem STARFACE-CDR (mit Standortpräfix); verknüpft CDR_Summary mit CDR_Data
answeredBOOLEANAnruf wurde angenommen
answered_elsewhereTEXTKennzeichen aus dem STARFACE-CDR: Anruf wurde anderweitig angenommen
call_resultTEXTAnrufergebnis aus dem STARFACE-CDR; bei Weiterleitungen z. B. FORWARD_TIMEOUT, FORWARD_BUSY, FORWARD_UNCONDITIONAL, FORWARD_USER_INTERACTIVE
call_result_timeTIMESTAMPZeitpunkt des Anrufendes (Eintritt des Anrufergebnisses)
callback_numberTEXTRückrufnummer aus dem STARFACE-CDR
called_account_idTEXTKonto-ID des angerufenen Kontos — Schlüssel zu Called_Account
called_caller_idTEXTÜbermittelte Rufnummernanzeige (Caller-ID) des Angerufenen
called_nameTEXTName des Angerufenen
called_numberTEXTRufnummer des Angerufenen
caller_account_idTEXTKonto-ID des anrufenden Kontos — Schlüssel zu Caller_Account
caller_caller_idTEXTÜbermittelte Rufnummernanzeige (Caller-ID) des Anrufers
caller_nameTEXTName des Anrufers
caller_numberTEXTRufnummer des Anrufers
cdr_account_idTEXTKonto, unter dem der CDR-Datensatz geführt wird — Schlüssel zu CDR_Account; identifiziert zusammen mit call_id und incoming einen Datensatz
dialed_numberTEXTTatsächlich gewählte Rufnummer
duration_sDECIMALGesamtdauer des Anrufs in Sekunden (call_result_time − start_time)
has_faxBOOLEANFax-Kennzeichen aus dem STARFACE-CDR
has_monitorBOOLEANMonitor-Kennzeichen aus dem STARFACE-CDR
has_voicemailBOOLEANVoicemail-Kennzeichen aus dem STARFACE-CDR
incomingBOOLEANtrue = eingehender, false = ausgehender Anruf
line_nameTEXTName der verwendeten Leitung
link_timeTIMESTAMPZeitpunkt der Gesprächsannahme; bei nie verbundenen Anrufen gleich call_result_time (Gesprächsdauer 0)
ringing_timeTIMESTAMPBeginn des Klingelns; hat der Anruf nie geklingelt, gleich link_time (Klingeldauer 0)
start_timeTIMESTAMPBeginn des Anrufs
call_result_caused_byTEXTKonto-ID, die das Anrufergebnis verursacht hat — Schlüssel zu Call_Result_Account
service_idTEXTSTARFACE-Dienst des Anrufs — Schlüssel zu Service_for_CDR_Summary
called_backBOOLEANRückruf-Status aus der Insight Analytics-Oberfläche; nachträgliche Änderungen werden stündlich per UPDATE übernommen
called_back_authorTEXTBenutzer, der den Rückruf-Status zuletzt gesetzt hat
called_back_modifiedTIMESTAMPZeitpunkt der letzten Änderung des Rückruf-Status
commentTEXTKommentar zum Anruf aus der Insight Analytics-Oberfläche; nachträgliche Änderungen werden stündlich per UPDATE übernommen
comment_authorTEXTBenutzer, der den Kommentar zuletzt geändert hat
comment_modifiedTIMESTAMPZeitpunkt der letzten Kommentaränderung
answered_i18nTEXTAnzeigetext zu answered — „Angenommen" / „Nicht Angenommen"
has_fax_i18nTEXTAnzeigetext zu has_fax — „Mit Fax" / „Ohne Fax"
has_monitor_i18nTEXTAnzeigetext zu has_monitor — „Mit Monitor" / „Ohne Monitor"
has_voicemail_i18nTEXTAnzeigetext zu has_voicemail — „Mit Voicemail" / „Ohne Voicemail"
incoming_i18nTEXTAnzeigetext zu incoming — „Eingehend" / „Ausgehend"
start_time_minuteTIMESTAMPstart_time, auf die Minute gerundet (Datumshierarchie für Berichte)
start_time_hourTIMESTAMPstart_time, auf die Stunde gerundet
start_time_dayTIMESTAMPstart_time, auf den Tag gerundet
start_time_monthTIMESTAMPstart_time, auf den Monat gerundet
start_time_yearTIMESTAMPstart_time, auf das Jahr gerundet
start_time_bin_30mTEXTWochentag und 30-Minuten-Raster des Anrufbeginns, Format MON_08:30-08:59
start_time_bin_30m_i18nTEXTSprachabhängige Variante, z. B. „Montag 08:30-08:59"
duration_mDECIMALGesamtdauer in Minuten
duration_hDECIMALGesamtdauer in Stunden
talk_duration_sDECIMALGesprächsdauer in Sekunden (call_result_time − link_time)
talk_duration_mDECIMALGesprächsdauer in Minuten
talk_duration_hDECIMALGesprächsdauer in Stunden
ringing_duration_sDECIMALKlingeldauer in Sekunden (link_time − ringing_time)
ringing_duration_mDECIMALKlingeldauer in Minuten
ringing_duration_hDECIMALKlingeldauer in Stunden
waiting_time_sDECIMALWartezeit bis zur Annahme in Sekunden (link_time − start_time)
waiting_time_mDECIMALWartezeit in Minuten
waiting_time_hDECIMALWartezeit in Stunden
announcement_duration_sDECIMALDauer zwischen Anrufbeginn und Klingelbeginn in Sekunden (ringing_time − start_time), z. B. Ansagen oder Warteschleife
announcement_duration_mDECIMALAnsagedauer in Minuten
announcement_duration_hDECIMALAnsagedauer in Stunden
other_participant_numberTEXTRufnummer der Gegenstelle — bei eingehenden Anrufen der Anrufer, bei ausgehenden der Angerufene
other_participant_nameTEXTName der Gegenstelle
other_participant_calleridTEXTRufnummernanzeige (Caller-ID) der Gegenstelle
other_participant_name_numberTEXTKombination „Name Nummer" der Gegenstelle — für Suche und Filter
call_origin_typeTEXTUrsprung des Anrufs: Internal oder External
call_origin_type_i18nTEXTAnzeigetext dazu — „Intern" / „Extern"
caller_name_numberTEXTKombination „Name Nummer" des Anrufers
callee_name_numberTEXTKombination „Name Nummer" des Angerufenen
is_garbageBOOLEANtrue = technischer Hilfsdatensatz der Klassifizierung (z. B. Mehrfacheinträge eines Gruppenanrufs); in Auswertungen ausfiltern
is_group_callBOOLEANAnruf wurde als Gruppenanruf klassifiziert
is_iqueue_callBOOLEANAnruf wurde als iQueue-Anruf (Warteschlange) klassifiziert
is_user_callBOOLEANAnruf wurde als Benutzeranruf klassifiziert
user_call_account_idTEXTBei Benutzeranrufen die Konto-ID des Benutzers — Schlüssel zu User_Call_Account
group_call_account_idTEXTBei Gruppen-/iQueue-Anrufen die Konto-ID der Gruppe bzw. Warteschlange — Schlüssel zu Group_Call_Account
pbx_location_nameTEXTName des Anlagen-Standorts
starface_versionTEXTSTARFACE-Version zum Zeitpunkt des Anrufs

CDR_Data​

Tabelle CDR_Data_4. Rohdaten aus dem STARFACE-CDR: je Anrufschritt ein Datensatz (ein Anruf besteht aus einem oder mehreren Schritten, etwa bei Umleitungen oder Gruppenverteilung). Verknüpfung mit CDR_Summary über call_id.

SpalteTypBedeutung
call_idTEXTAnruf-ID (mit Standortpräfix) — verknüpft alle Schritte eines Anrufs und die zugehörige CDR_Summary-Zeile
call_step_idTEXTID des einzelnen Anrufschritts innerhalb des Anrufs; -1, wenn nicht gesetzt
call_leg_uuidTEXTUUID des Call-Legs aus dem STARFACE-CDR
cdr_account_idTEXTKonto, unter dem der Schritt geführt wird — Schlüssel zu CDR_Account_CDR_Data
caller_account_idTEXTKonto-ID des Anrufers — Schlüssel zu Caller_Account_CDR_Data
caller_caller_idTEXTRufnummernanzeige (Caller-ID) des Anrufers
called_account_idTEXTKonto-ID des Angerufenen — Schlüssel zu Called_Account_CDR_Data
called_caller_idTEXTRufnummernanzeige (Caller-ID) des Angerufenen
service_idTEXTSTARFACE-Dienst des Schritts — Schlüssel zu Service_for_CDR_Data
start_timeTIMESTAMPBeginn des Anrufschritts
ringing_timeTIMESTAMPKlingelbeginn des Schritts; ohne Klingeln gleich link_time
link_timeTIMESTAMPAnnahmezeitpunkt des Schritts; ohne Verbindung gleich call_result_time
call_resultTEXTErgebnis des Schritts aus dem STARFACE-CDR (z. B. Weiterleitungstypen FORWARD_…)
call_result_timeTIMESTAMPEndzeitpunkt des Schritts
call_result_caused_byTEXTKonto-ID, die das Ergebnis verursacht hat — Schlüssel zu Call_Result_Account_CDR_Data
line_idTEXTID der verwendeten Leitung
line_nameTEXTName der verwendeten Leitung
callback_numberTEXTRückrufnummer aus dem STARFACE-CDR
answered_elsewhereTEXTKennzeichen „anderweitig angenommen" als Text (true/false)
incomingTEXTKennzeichen „eingehend" als Text (true/false)
answeredTEXTKennzeichen „angenommen" als Text (true/false)
has_faxTEXTFax-Kennzeichen als Text (true/false)
has_monitorTEXTMonitor-Kennzeichen als Text (true/false)
has_voicemailTEXTVoicemail-Kennzeichen als Text (true/false)
deletedTEXTKennzeichen aus dem STARFACE-CDR: Eintrag in der Rufliste gelöscht (true/false)
private_callTEXTKennzeichen „privater Anruf" (true/false)
callback_number_externTEXTKennzeichen „externe Rückrufnummer" aus dem STARFACE-CDR (true/false)
duration_sDECIMALGesamtdauer des Schritts in Sekunden (call_result_time − start_time)
summary_stepTEXTKennzeichen aus dem STARFACE-CDR, ob dieser Schritt der zusammenfassende Schritt des Anrufs ist (true/false)
start_time_hourTIMESTAMPstart_time, auf die Stunde gerundet
start_time_dayTIMESTAMPstart_time, auf den Tag gerundet
start_time_monthTIMESTAMPstart_time, auf den Monat gerundet
duration_mDECIMALGesamtdauer des Schritts in Minuten
talk_duration_sDECIMALGesprächsdauer des Schritts in Sekunden (call_result_time − link_time)
talk_duration_mDECIMALGesprächsdauer in Minuten
ringing_duration_sDECIMALKlingeldauer des Schritts in Sekunden (link_time − ringing_time)
ringing_duration_mDECIMALKlingeldauer in Minuten
call_origin_typeTEXTUrsprung des Anrufs: Internal oder External
pbx_location_nameTEXTName des Anlagen-Standorts

Konten-Views​

Elf strukturgleiche Views mit den Stammdaten aller Benutzer-, Gruppen- und iQueue-Konten der Anlage (Tabellen …_4). Jede View enthält denselben, vollständigen Kontenbestand einschließlich Platzhalterzeilen für „kein Konto" und „gelöschtes Konto"; die Mehrfachausführung dient BI-Werkzeugen wie Power BI, die je Beziehung eine eigene Nachschlagetabelle benötigen. Die Zuordnung:

ViewNachschlage-View für
CDR_AccountCDR_Summary.cdr_account_id
Caller_AccountCDR_Summary.caller_account_id
Called_AccountCDR_Summary.called_account_id
Call_Result_AccountCDR_Summary.call_result_caused_by
User_Call_AccountCDR_Summary.user_call_account_id
Group_Call_AccountCDR_Summary.group_call_account_id
CDR_Account_CDR_DataCDR_Data.cdr_account_id
Caller_Account_CDR_DataCDR_Data.caller_account_id
Called_Account_CDR_DataCDR_Data.called_account_id
Call_Result_Account_CDR_DataCDR_Data.call_result_caused_by
Group_Account_for_User_Group_StatesUser_Group_States.GROUP_ACCOUNT_ID

Spalten aller elf Konten-Views:

SpalteTypBedeutung
Account_IDTEXTKonto-ID mit Standortpräfix — der Verknüpfungsschlüssel; negative IDs sind Platzhalter für „kein Konto" bzw. „gelöschtes Konto"
Account_NameTEXTAnzeigename des Kontos; bei Platzhaltern z. B. „-" oder „Gelöschter Account"
Account_TypeTEXTKontotyp: AGENT (Benutzer), GROUP, IQUEUE oder UNKNOWN
Account_Type_i18nTEXTAnzeigetext dazu — „StarfaceUser", „Gruppe", „iQueue", „Unbekannt"
Queue_Max_Wait_TimeINTEGERMaximale Wartezeit laut iQueue-Konfiguration; -1 bei Konten ohne Warteschlange
Queue_SizeINTEGERWarteschlangengröße laut iQueue-Konfiguration; -1 bei Konten ohne Warteschlange
sam_account_nameTEXTWindows-Anmeldename (sAMAccountName) des Benutzers, sofern auf der Anlage gepflegt

Dienste-Views​

Zwei strukturgleiche Views (Tabellen …_4) mit den STARFACE-Diensten aus der Anlagendatenbank — die Auflösung der service_id-Spalten der Gesprächsdaten: Service_for_CDR_Summary (für CDR_Summary.service_id) und Service_for_CDR_Data (für CDR_Data.service_id).

SpalteTypBedeutung
service_idTEXTDienst-ID mit Standortpräfix — der Verknüpfungsschlüssel
nameTEXTName des STARFACE-Dienstes

Modulnachrichten-Views​

Zwei strukturgleiche Views (Tabellen …_4) für anrufbezogene Nachrichten anderer Module: Module_Message_for_CDR_Summary und Module_Message_for_CDR_Data, verknüpfbar über Call_ID mit den Gesprächsdaten. Das Schema ist Teil des Datenmodells; Inhalte werden von der aktuellen Modulversion nicht geschrieben — die Views sind leer.

SpalteTypBedeutung
Call_IDTEXTAnruf-ID — Verknüpfung zu CDR_Summary.call_id bzw. CDR_Data.call_id
Module_IDTEXTID des sendenden Moduls
Module_Instance_IDTEXTID der sendenden Modulinstanz
TimestampTIMESTAMPZeitpunkt der Nachricht
MessageTEXTNachrichteninhalt

Kennzahlen und Konstanten​

Constant_Values​

Tabelle Constant_Values_4. Ziel- und Maximalwerte aus den Moduleinstellungen (Grenzwerte für Berichte, z. B. Soll-Klingeldauer). Bei jedem Upload wird eine Zeile mit dem aktuellen Stand angefügt; die Zeile mit dem jüngsten timestamp ist der gültige Stand.

SpalteTypBedeutung
const_max_ringing_durationINTEGERMaximalwert Klingeldauer
const_target_ringing_durationINTEGERZielwert Klingeldauer
const_max_call_durationINTEGERMaximalwert Gesprächsdauer
const_target_call_durationINTEGERZielwert Gesprächsdauer
const_max_missed_callsINTEGERMaximalwert verpasste Anrufe
const_target_missed_callsINTEGERZielwert verpasste Anrufe
timestampTIMESTAMPZeitpunkt des Uploads dieser Konstanten

Measurements​

Tabelle Measurements_4. Hilfstabelle des Power-BI-Datenmodells: Sie trägt dort die vordefinierten Kennzahlen (DAX-Measures wie Erreichbarkeit oder Anrufzahlen). In der SQL-Datenbank wird die Tabelle nur aus Gründen der Schema-Parität angelegt und enthält keine Nutzdaten.

SpalteTypBedeutung
timestampTIMESTAMPTechnische Ankerspalte; ohne Inhalte

Benutzer-, Gruppen- und Gerätezustände​

Diese drei Views werden nur befüllt, wenn in der Modulkonfiguration der Export Benutzer-/Gruppenstatus aktiviert ist (Experten-Modus). Das Modul schreibt dann je Erfassungsintervall (Standard 60 Sekunden, Minimum 30) eine Momentaufnahme je Objekt. PERIOD_S gibt das konfigurierte Erfassungsintervall in Sekunden an — die Zeitspanne, die eine Momentaufnahme repräsentiert (Grundlage für Dauer-Hochrechnungen).

User_States​

Tabelle User_States_4. Eine Zeile je Benutzer und Erfassungszeitpunkt.

SpalteTypBedeutung
timestampTIMESTAMPErfassungszeitpunkt der Momentaufnahme
ACCOUNT_IDTEXTKonto-ID des Benutzers (mit Standortpräfix)
DNDBOOLEAN„Nicht stören" zum Erfassungszeitpunkt aktiv
REDIRECT_ALWAYSBOOLEANImmer-Umleitung zum Erfassungszeitpunkt aktiv
PERIOD_SINTEGERErfassungsintervall in Sekunden

User_Group_States​

Tabelle User_Group_States_4. Eine Zeile je Gruppenmitgliedschaft (Benutzer × Gruppe) und Erfassungszeitpunkt.

SpalteTypBedeutung
timestampTIMESTAMPErfassungszeitpunkt der Momentaufnahme
GROUP_ACCOUNT_IDTEXTKonto-ID der Gruppe — Schlüssel zu Group_Account_for_User_Group_States
USER_ACCOUNT_IDTEXTKonto-ID des Benutzers
IS_LOGGED_INBOOLEANBenutzer war zum Erfassungszeitpunkt in der Gruppe angemeldet
PERIOD_SINTEGERErfassungsintervall in Sekunden

User_Device_States​

Tabelle User_Device_States_4. Eine Zeile je Telefonzuordnung (Benutzer × Endgerät) und Erfassungszeitpunkt.

SpalteTypBedeutung
timestampTIMESTAMPErfassungszeitpunkt der Momentaufnahme
USER_ACCOUNT_IDTEXTKonto-ID des Benutzers
PHONE_NAMETEXTName des Telefons bzw. Endgeräts
IS_ACTIVEBOOLEANTelefon war zum Erfassungszeitpunkt als aktives Gerät des Benutzers angemeldet
PERIOD_SINTEGERErfassungsintervall in Sekunden

Live-Daten​

Die beiden Live-Views werden im Live-Daten-Intervall (Standard 10 Sekunden) fortlaufend ergänzt und wachsen entsprechend schnell. Über die Option Zurücksetzen der Live-Daten kann das Modul beide Tabellen periodisch leeren. Die Spalten …_account_id_timestamped kombinieren Konto-ID und Erfassungszeitpunkt zu einem Schlüssel, der Agent_State und iQueue_State je Momentaufnahme verknüpft.

Agent_State​

Tabelle Agent_State_1. Eine Zeile je iQueue-Agent, Warteschlange und Erfassungszeitpunkt — inklusive des gerade laufenden Warteschlangen-Anrufs, falls vorhanden. Die Zustandsspalten enthalten sprachabhängige Anzeigetexte in der Berichtssprache (Beispielwerte: Deutsch).

SpalteTypBedeutung
timestampTIMESTAMPErfassungszeitpunkt der Momentaufnahme
account_id_timestampedTEXTKonto-ID des Agenten kombiniert mit dem Erfassungszeitpunkt (Verknüpfungsschlüssel)
queue_account_id_timestampedTEXTKonto-ID der Warteschlange kombiniert mit dem Erfassungszeitpunkt — Schlüssel zu iQueue_State
account_idTEXTKonto-ID des Agenten (mit Standortpräfix)
agent_nameTEXTName des Agenten
chat_presenceTEXTChat-Präsenz, z. B. „Verfügbar", „Weg", „Nicht Stören", „Frei zum Chatten"
chat_presence_messageTEXTIndividuelle Präsenznachricht des Agenten
telephony_stateTEXTTelefoniestatus, z. B. „Verfügbar", „Spricht", „Klingelt", „Nachbearbeitungszeit", „Nicht Verfügbar"
is_do_not_disturb_settingTEXT„Nicht stören"-Einstellung — „Aktiviert" / „Deaktiviert"
is_logged_inTEXTAnmeldestatus in der Warteschlange — „Angemeldet" / „Abgemeldet"
is_redirect_always_activeTEXTImmer-Umleitung — „Aktiviert" / „Deaktiviert"
call_idTEXTID des aktuellen Warteschlangen-Anrufs (ohne Standortpräfix); leer, wenn kein Anruf läuft
queue_account_idTEXTKonto-ID der Warteschlange (mit Standortpräfix)
call_stateTEXTZustand des aktuellen Anrufs — „Wartet", „Klingelt", „Verbunden", „Verlassen"; leer, wenn kein Anruf läuft
incoming_timeTIMESTAMPEingangszeitpunkt des aktuellen Anrufs
connected_timeTIMESTAMPVerbindungszeitpunkt des aktuellen Anrufs
caller_nameTEXTName des aktuellen Anrufers
caller_numberTEXTRufnummer des aktuellen Anrufers
durationDECIMALBisherige Dauer des aktuellen Anrufs in Minuten (0, wenn nicht verbunden)
pbx_location_nameTEXTName des Anlagen-Standorts

iQueue_State​

Tabelle iQueue_State_1. Eine Zeile je iQueue-Warteschlange und Erfassungszeitpunkt.

SpalteTypBedeutung
timestampTIMESTAMPErfassungszeitpunkt der Momentaufnahme
queue_Account_IDTEXTKonto-ID der Warteschlange (mit Standortpräfix)
queue_account_id_timestampedTEXTKonto-ID kombiniert mit dem Erfassungszeitpunkt — Schlüssel zu Agent_State
connected_callsINTEGERAnzahl der aktuell verbundenen Anrufe der Warteschlange
waiting_callsINTEGERAnzahl der aktuell wartenden Anrufe (einschließlich klingelnder)
queue_nameTEXTName der Warteschlange
max_waiting_timeINTEGERMaximale Wartezeit laut iQueue-Konfiguration
queue_sizeINTEGERWarteschlangengröße laut iQueue-Konfiguration
pbx_location_nameTEXTName des Anlagen-Standorts