Beim Betreiben von Migrations- und Integrationsschnittstellen zu Salesforce ist eine konsequente Überwachung wichtig, da Fehler bei der Datenübertragung vorkommen können. Unter Umständen haben diese fatale Folgen. Die Logdateien liegen normalerweise auf einem Schnittstellen-Server oder PC. Für Salesforce Administratoren bedeutet das, dass sie Fehlerprotokolle anfordern oder sie von den entsprechenden Servern auf den eigenen PC übertragen müssen. Das geht auch komfortabler!
Erich Hegel, Data Integration Specialist bei H+W CONSULT, zeigt Ihnen unsere bewährte Methode, um die Auswertung und Überwachung von Schnittstellen-Aktivitäten zu vereinfachen.
Hierfür erstellen Sie einfach ein benutzerdefiniertes Objekt (z.B. namens Interface Monitor). In dem Objekt werden die Daten der Schnittstellen-Läufe erfasst und es erfolgt ein automatischer Upload der Fehler-Datei.
Für das Objekt erstellen Sie relevante Felder aus der Logdatei:
Die Schnittstelle muss so angepasst werden, dass beim Starten der Übertragung ein Datensatz im Objekt für das Monitoring erstellt wird. Die Datensatz-ID ist wichtig für die spätere Aktualisierung.
Beim Start werden folgende Daten benötigt:
- „Startzeit (Job started)“ = aktuelles Datum/Uhrzeit
- „Jobname“ = Name des Jobs
- „Typ (Type)“ = aktueller Ausführungstyp
In unserem Beispiel nutzen wir folgende Werte für den Ausführungstyp:
- Running (die Schnittstelle wird gerade ausgeführt)
- Successful (der Schnittstellen-Lauf wurde erfolgreich beendet; es sind keine Fehler aufgetreten)
- Check Log (Es sind Fehler aufgetreten, den Monitoring Datensatz im Detail anzeigen)
Am Ende des Schnittstellen-Laufs werden dann weitere Felder im Monitoring-Datensatz aktualisiert.
Fall 1: Fehlerfreier Schnittstellen-Lauf
Bei einer fehlerfreien Übertragung werden die Daten wie folgt aktualisiert:
- row count success (Anzahl der erfolgreich übertragenen Datensätze)
- row_count_source (Gesamtanzahl der Datensätze, die übertragen werden sollen)
- Type = Successful
- Job finished (aktuelles Datum/Uhrzeit)
Fall 2: Fehlerhafter Schnittstellen-Lauf
Bei einer fehlerhaften Übertragung werden die Daten wie folgt aktualisiert:
- row count success (Anzahl der erfolgreich übertragenen Datensätze)
- row count errors (Anzahl der fehlgeschlagenen übertragenen Datensätze)
- row_count_source (Gesamtanzahl der Datensätze, die übertragen werden sollen)
- Type = Check Log
- Job finished (aktuelles Datum/Uhrzeit)
- Error Messages (Gruppierung der ca. ersten 20 Fehler der Fehler-Datei)
In der Fehler-Datei sieht der Salesforce Administrator alle fehlerhaften Datensätze mit den Daten, die übertragen werden sollten.
