Problembehandlung bei Office-Dateien und benutzerdefinierte Lösungen mit dem Telemetrieprotokoll
Verwenden Sie das Telemetrieprotokoll für Office 2013, um Kompatibilitätsprobleme zwischen Office 2013 und Lösungen zu ermitteln, die für vorherige Versionen von Office entwickelt wurden.
Der folgende Artikel beschreibt das Telemetrieprotokoll und dessen Verwendung. Weitere Informationen über spezifische Ergebnisse, die im Telemetrieprotokoll angezeigt werden, finden Sie unter Kompatibilitätsprobleme in Office.
Microsoft hat im Laufe der Zeit viele Versionen von Tools und Frameworks für die Anpassung, Automatisierung und Erweiterung von Office bereitgestellt. Dadurch haben Unternehmen und Benutzer die Möglichkeit, Lösungen oder Add-Ins für Office-Anwendungen zu erstellen, um deren Produktivität und Effizienz zu steigern. Die Komplexität dieser Lösungen ist ganz unterschiedlich und reicht von einfachen VBA-Makros (Visual Basic for Applications) bis hin zu robusten .NET Framework-Anpassungen. Viele Benutzer, die diese Lösungen besitzen, setzen sie bei der Ausführung geschäftskritischer Aufgaben ein und wissen möglicherweise gar nicht, dass sie eine Anpassung ihrer Office-Anwendungen verwenden.
Bei einer solchen Vielfalt an Office-Lösungen können Upgrades von Office-Versionen sehr komplex werden. Unternehmen und Benutzer wissen nicht, ob ihre wichtigen und wertvollen Lösungen mit der neuen Version vollständig kompatibel sind. Ihre Lösungen verwenden möglicherweise inzwischen veraltete Features und Computercode aus vorherigen Versionen von Office. Wenn eine Lösung, die ein veraltetes Feature verwendet, in die "Hostanwendung" geladen wird, verhält sich die Lösung möglicherweise anders als erwartet, verursacht einen Fehler, lädt nicht oder führt dazu, dass die Hostanwendung nicht richtig ausgeführt wird.
Das Telemetrieprotokoll für Office 2013, ein auf Excel 2013 basierendes Tool, hilft Entwicklern und erfahrenen Benutzern bei der Diagnose von Kompatibilitätsproblemen, indem Ereignisse angezeigt werden, die in ausgewählten Office 2013-Anwendungen auftreten. Mit diesem Tool können Benutzer potenzielle Probleme mit Add-Ins ermitteln, die sie in ihrer Arbeitsumgebung verwenden, sodass Entscheidungsträger im Unternehmen die Informationen erhalten, die sie benötigen, um zu entscheiden, ob sie ein Upgrade auf Office 2013 durchführen möchten. Das Telemetrieprotokoll gibt auch detailliertes Feedback zu bestimmten Änderungen oder Veraltetkeiten in den Objektmodellen für die Office 2013-Anwendungen, sodass Entwickler problematischen Code oder Steuerelemente schnell identifizieren und umgestalten können. IT-Experten können Trends in der Lösungsintegrität über mehrere Clients hinweg anzeigen, indem sie das Telemetriedashboard für Office 2013 verwenden, ein Begleittool für das Telemetrieprotokoll.
Weitere Informationen finden Sie im Artikel Bereitstellen des Office-Telemetriedashboards.
So funktioniert Telemetrieprotokoll
Wenn eine Office-Datei oder -Lösung geladen, verwendet oder geschlossen wird oder einen Fehler in einer der ausgewählten Office 2013-Anwendungen auslöst, fügt die Anwendung einen Datensatz in einem lokalen Datenspeicher (einer Datenbank auf demselben Computer) hinzu, der Informationen über das Ereignis enthält. Der Datensatz umfasst einen Titel für das Ereignis, den Namen der Anwendung, die das Ereignis protokolliert hat, die Uhrzeit, den Namen der Datei oder Lösung, den Schweregrad und eine kurze Beschreibung eventueller Fehler, die aufgetreten sind. Nach einer Aktualisierung zeigt die Telemetrieprotokoll-Arbeitsmappe eine Liste der im lokalen Datenspeicher enthaltenen Datensätze an.
Hinweis
Der Standardspeicherort für den lokalen Datenspeicher ist %Users%[Aktueller Benutzer]\AppData\Local\Microsoft\Office\15.0\Telemetry. The default maximum size for the data store is 5 MB (5,120 KB).
Ausgewählte Office 2013-Anwendungen verfügen über eine Laufzeitprotokollierungs-API, die einen Datensatz im lokalen Datenspeicher erstellt, wann immer eine Datei oder eine Lösung eines der folgenden Ereignisse auslöst:
OnLoad: Ein Datensatz wird im lokalen Datenspeicher protokolliert, wenn eine Datei oder eine Lösung in bestimmte Office 2013-Anwendungen geladen wird. Die Laufzeitfehlerprotokollierung erfasst den Dateinamen, den Speicherort sowie andere Informationen im lokalen Arbeitsspeicher, wenn ein OnLoad-Ereignis ausgelöst wird.
OnClose: Ein Datensatz wird protokolliert, wenn eine Datei oder Projektmappe innerhalb der Anwendung geschlossen wird. Der Datensatz enthält den Namen der Projektmappe oder Datei, deren Speicherort und die Anwendung, die das Ereignis protokolliert hat.
OnError: Ein Datensatz wird protokolliert, wenn in einer Lösung für bestimmte Office 2013-Anwendungen ein Fehler gefunden wird. Der Datensatz umfasst den Namen der Lösung oder Datei und den Laufzeitfehler oder das Kompatibilitätsproblem, der/das aufgetreten ist. Soweit möglich werden Fehler bekannten Kompatibilitätsproblemen zugeordnet und als solche in Telemetrieprotokoll angezeigt.
Telemetrieprotokoll zeigt Informationen über eine Vielzahl von Dateien und Lösungstypen für eine Auswahl von Office 2013-Anwendungen an. Die Art der Dateien und Lösungen, die durch Laufzeitprotokollierungs-APIs überwacht werden, ist je nach Anwendung unterschiedlich. Tabelle 1 liefert Informationen darüber, welche Arten von Lösungen überwacht werden.
Tabelle 1. Typen von Office-Dateien und -Lösungen, die im Telemetrieprotokoll nachverfolgt werden
| Lösungstyp | Anwendungen | Beschreibung |
|---|---|---|
| Aufgabenbereich-Apps |
Excel 2013, Word 2013, Project 2013 |
Dies sind Office-Add-Ins, die in einem Aufgabenbereich innerhalb der Clientanwendung gehostet werden. |
| Inhalts-Apps |
Excel 2013 |
Dies sind Office-Add-Ins, die in den Inhalt der Office-Datei integriert sind. |
| Mail-Apps |
Outlook 2013 |
Dies sind Apps, die in Outlook 2013 angezeigt werden, wenn bestimmte Bedingungen erfüllt sind (der Nachrichtentext oder der Betreff enthält bestimmte Wörter oder Phrasen). |
| Aktive Dokumente |
Word 2013 PowerPoint 2013 Excel 2013 |
Aktive Dokumente sind alle Office-Dokumentdateien, mit Ausnahme der sonstigen Lösungstypen, die in dieser Tabelle aufgeführt sind. Dazu gehören: Office-Dateien im Binärformat (DOC, PPT, PPS, XLS) Office-Dateien im OpenXML-Format (DOCX, PPTX, PPSX, XLSX) Makroaktivierte Dateien mit VBA-Code (DOCM, DOTM, PPTM, POTM, XLSM, XLTM) Dateien mit ActiveX-Steuerelementen Dateien mit externen Datenverbindungen |
| COM-Add-Ins |
Word 2013 PowerPoint 2013 Excel 2013 Outlook 2013 |
COM-Add-Ins umfassen Office-Entwicklungstools in Visual Studio 2010-Add-Ins auf Anwendungsebene. |
| Excel-Automatisierungs-Add-Ins |
Excel 2013 |
Dieser Lösungstyp beinhaltet vorherige Versionen von Excel-unterstützten Automatisierungs-Add-Ins, die auf COM-Add-Ins gründen. Funktionen in Automatisierungs-Add-Ins können von Formeln in Excel-Arbeitsblättern aufgerufen werden. |
| Excel XLL-Add-Ins |
Excel 2013 |
XLL-Add-Ins (XLL) sind für Excel spezifisch und werden mit Compilern erstellt, die die Erstellung von DLLs (Dynamic Link Library) unterstützen. Sie müssen weder installiert noch registriert werden. Zu XLL-Add-Ins zählen auch DLLs, die benutzerdefinierte Befehle und Funktionen enthalten. |
| Excel XLS RTD-Add-Ins |
Excel 2013 |
XLS RTD-Add-Ins (Real-Time Data) sind Excel-Arbeitsblätter, die die RealTimeData-Arbeitsblattfunktion zum Aufrufen eines Automatisierungsservers verwenden, um Daten in Echtzeit abzurufen. |
| Word WLL-Add-Ins |
Word 2013 |
WLL-Add-Ins (WLL) betreffen nur Word und werden mit einem beliebigen Compiler erstellt, der das Erstellen von DLLs unterstützt. |
| Anwendungs-Add-Ins |
Word 2013 PowerPoint 2013 Excel 2013 |
Anwendungs-Add-Ins sind anwendungsspezifische Dateien, die VBA-Code enthalten. Hierzu zählen Word-Vorlagen mit Makros (DOTM), Excel-Add-Ins (XLA, XLAM) und PowerPoint-Add-Ins (PPA, PPAM). |
| Vorlagen |
Word 2013 PowerPoint 2013 Excel 2013 |
Vorlagen enthalten Dokument- (DOT, DOTX), Arbeitsblatt- (XLT, XLTX) oder Präsentationsvorlagen (POT, POTX), die an eine Office-Datei angehängt sind. |
Verwenden von Office Telemetry Log
Wenn Sie Office 2013 installieren, wird das Telemetrieprotokoll installiert, der lokale Datenspeicher wird auf demselben Computer erstellt, und die Laufzeitprotokollierungs-APIs sind in den zuvor aufgeführten Office 2013-Anwendungen aktiviert. Eine Projektmappe oder Datei muss jedoch in der Anwendung geladen oder geöffnet werden, bevor das Telemetrieprotokoll mit der Überwachung beginnen kann.
Gehen Sie folgendermaßen vor, um die erfassten Office-Probleme in Telemetrieprotokoll anzuzeigen.
So verwenden Sie Telemetrieprotokoll
Gehen Sie folgendermaßen vor, um Telemetrieprotokoll zu öffnen:
On Windows 7: On the Start menu, choose All Programs. Then, in the list of programs, expand Microsoft Office 2013, expand Office 2013 Tools, and then click Office 2013 Telemetry Log.
In Excel 2013 wird eine neue Arbeitsmappe geöffnet. Die neue Arbeitsmappe enthält drei Arbeitsblätter: Ereignisse, Systeminfo und Anleitung.
Für Windows 8: Machen Sie eine Streifbewegung, um die App-Leiste anzuzeigen, wählen Sie Alle Apps, und wählen Sie dann Office 2013 Telemetry Log.
In Excel 2013 wird eine neue Arbeitsmappe geöffnet. Die neue Arbeitsmappe enthält drei Arbeitsblätter: Ereignisse, Systeminfo und Anleitung.
Um eine aktuelle Ereignisliste anzuzeigen, klicken Sie oben auf dem Arbeitsblatt Ereignisse auf Aktualisieren.
Um die Ereignisdaten einzusehen, die von Office 2013-Anwendungen gesammelt werden, prüfen Sie die Tabelle auf dem Arbeitsblatt Ereignisse.
Um Informationen über den Computer zu erhalten, auf dem Office 2013 und Telemetrieprotokoll installiert sind, prüfen Sie die Informationen auf dem Arbeitsblatt Systeminfo.
Hinweis
Es ist nicht erforderlich, die Arbeitsmappe Telemetrieprotokoll in Excel 2013 zu speichern, um die Ergebnisse aufzuzeichnen, da die Informationen im lokalen Datenspeicher gespeichert werden (der vom Telemetrieprotokoll getrennt ist). Durch Speichern des Arbeitsblatts wird Telemetrieprotokoll aber auch nicht beschädigt.
Das Telemetrieprotokoll zeigt einige einfache Informationen zu den aufgezeichneten Ereignissen an. Jeder im Telemetrieprotokoll angezeigte Datensatz enthält einen Titel und listet den Schweregrad des angezeigten Ereignisses auf. Bei Fehlern enthalten die Datensätze auch eine Beschreibung des Fehlers sowie Schritte zum Beheben des Problems. Beachten Sie, dass nicht alle angezeigten Datensätze Fehler darstellen, die durch Office-Lösungen verursacht werden. Das Telemetrieprotokoll zeigt auch an, wann Lösungen und Dateien erfolgreich geladen oder geschlossen wurden.
Beispielsweise wird das Problem mit dem Titel "OM ausgeblendet: Comment.Initial-Eigenschaft" angezeigt, wenn eine Lösung oder eine in Word 2013 geöffnete makroaktivierte Datei versucht, die Initialen eines Kommentierenden abzurufen, der einem Kommentar zugeordnet ist. Word 2013 bietet eine verbesserte Kommentarfunktion, die die Initialen des Kommentierenden nicht standardmäßig anzeigt. Die mit dem älteren Kommentarmodell verknüpften APIs sind im Word 2013-Objektmodell ausgeblendet worden, bleiben jedoch für die Rückwärtskompatibilität erhalten. Das Problem "OM ausgeblendet: Comment.Initial" in gibt die Datei, die versucht hat, die API zu verwenden, die Anwendung, die das Ereignis ausgelöst hat (Word 2013), das Datum und die Uhrzeit des Ereignisses und die Kurzbeschreibung des Fehlers sowie die Abhilfemaßnahme an.
Abbildung 1: Office-Telemetrieprotokoll
Hinweis
Das Arbeitsblatt Systeminfo im Telemetrieprotokoll enthält Informationen über den Computer, auf dem Office 2013 installiert ist. Dieses Arbeitsblatt enthält die folgenden Informationen:
- Name des Benutzers
- Den vollständigen Namen des Computers
- Die Architektur des Betriebssystems (x64/64 Bit oder x86/32 Bit)
- Die auf dem Computer installierte Version von Windows
- Zeitzone für die Systemuhr des Computers
- Version des Telemetrieprotokolls
- Office-Version, die auf dem Computer installiert ist
Diese Informationen können nützlich sein, wenn Sie die im Arbeitsblatt Ereignisse aufgelisteten Probleme und Ereignisse interpretieren.
In Telemetrieprotokoll wird zusammen mit den bekannten Problemen der Schweregrad angegeben. Wie im vorherigen Beispiel hat ein Problem, bei dem ein Teil des Objektmodells ausgeblendet wurde, meist den Schweregrad "Informationell". Andere bekannte Probleme können aber schwerwiegender sein und ein sofortiges Eingreifen erfordern. In Telemetrieprotokoll werden die folgenden Abstufungen nach Schweregrad vorgenommen:
- Informative Das Problem hat möglicherweise keine sofortigen Auswirkungen auf die Anwendungskompatibilität, aber der Benutzer muss möglicherweise zu einem späteren Zeitpunkt Maßnahmen ergreifen. Viele Probleme des Typs "OM hidden" haben diesen Schweregrad.
- Warning Das Problem könnte zu Datenverlust oder verminderter Darstellungstreue führen.
- Critical Das Problem könnte einen signifikanten Verlust an Funktionalität verursachen oder zum Absturz der Anwendung führen.
Tabelle 2. Im Telemetrieprotokoll angezeigte Ereignistypen
Interpretieren Sie die in Telemetrieprotokoll angezeigten Datensätze anhand der folgenden Tabelle (Tabelle 2).
| Ereignis-ID | Titel | Schweregrad | Beschreibung |
|---|---|---|---|
| 1 |
Das Dokument wurde erfolgreich geladen |
Die in der Spalte File angegebene Datei wurde in der Office-Anwendung ohne Probleme geöffnet. | |
| 2 |
Das Dokument konnte nicht geladen werden. |
Warning |
Die Anwendung konnte die Datei nicht laden. Möglicherweise ist ein zugrunde liegendes Kompatibilitätsproblem die Ursache. Weitere Informationen dazu, wie Sie eine beschädigte Arbeitsmappe in Excel 2013 reparieren, finden Sie unter Reparieren einer beschädigten Arbeitsmappe. Weitere Informationen zur Reparatur eines beschädigten Dokuments in Word 2013 finden Sie unter Speichern und Wiederherstellen einer Sicherungskopie eines Dokuments. |
| 3 |
Die Vorlage wurde erfolgreich geladen. |
Die in der Spalte File angegebene Vorlagendatei wurde in der Office-Anwendung ohne Probleme geöffnet. | |
| 4 |
Die Vorlage konnte nicht geladen werden. |
Warning |
Die Anwendung konnte die Vorlagendatei nicht laden. Möglicherweise ist ein zugrunde liegendes Kompatibilitätsproblem die Ursache, oder die Vorlagenverfügbarkeit hat sich geändert. Weitere Informationen dazu, wie Sie eine beschädigte Arbeitsmappe in Excel 2013 reparieren, finden Sie unter Reparieren einer beschädigten Arbeitsmappe. Weitere Informationen zur Reparatur eines beschädigten Dokuments in Word 2013 finden Sie unter Speichern und Wiederherstellen einer Sicherungskopie eines Dokuments. |
| 5 |
Das Add-In wurde erfolgreich geladen. |
Das in der Spalte File angegebene Add-In wurde erfolgreich in die Office-Anwendung geladen. Es wurden keine Kompatibilitätsprobleme ermittelt. | |
| 6 |
Fehler beim Laden von Add-In |
Kritisch |
Die Anwendung konnte das in der Spalte File angegebene Add-In nicht laden. Weitere Informationen dazu, wie Sie eine beschädigte Arbeitsmappe in Excel 2013 reparieren, finden Sie unter Reparieren einer beschädigten Arbeitsmappe. Weitere Informationen zur Reparatur eines beschädigten Dokuments in Word 2013 finden Sie unter Speichern und Wiederherstellen einer Sicherungskopie eines Dokuments. |
| 7 |
Das Add-In-Manifest wurde erfolgreich heruntergeladen. |
Die Host-Anwendung hat das Manifest für die Office-Add-In erfolgreich heruntergeladen. | |
| 8 |
Das Add-In-Manifest konnte nicht heruntergeladen werden. |
Kritisch |
Die Hostanwendung konnte die Manifestdatei für die Office-Add-In nicht aus dem SharePoint-Katalog, dem Unternehmenskatalog oder aus dem Office Store laden. |
| 9 |
Das Add-In-Manifest konnte nicht analysiert werden. |
Kritisch |
Die Hostanwendung hat das Office-Add-In-Manifest für das Add-In geladen, konnte jedoch das XML-Markup nicht lesen. |
| 10 |
Die CPU-Nutzung des Add-Ins ist zu hoch. |
Kritisch |
Die Office-Add-In hat über eine begrenzte Zeitspanne mehr als 90 % der CPU-Ressourcen beansprucht. |
| 11 |
Anwendung beim Laden abgestürzt |
Kritisch |
Die Office-Anwendung hat beim Start versucht, ein Dokument oder eine Lösung zu laden. Probleme mit dem Dokument bzw. der Lösung haben den Start der Anwendung verhindert. |
| 12 |
Die Anwendung wurde aufgrund eines Problems geschlossen. |
Kritisch |
In der Anwendung ist ein kritischer Fehler aufgetreten. Sie musste geschlossen werden. |
| 13 |
Das Dokument wurde erfolgreich geschlossen |
Die in der Spalte File aufgeführte Datei ist erfolgreich geschlossen worden. | |
| 14 |
Die Anwendungssitzung wurde verlängert. |
Anwendungssitzungen, bei denen ein bestimmtes Dokument oder eine bestimmte Lösung geöffnet ist, sollten nicht länger als 24 Stunden dauern. Wenn eine Sitzung länger als 24 Stunden dauert, erstellt die Hostanwendung eine neue Sitzung. | |
| 15 |
Das Add-In wurde aufgrund eines Timeouts bei der Zeichenfolgensuche deaktiviert. |
Mail-Add-Ins durchsuchen die Betreffzeile und die Nachricht einer E-Mail, um zu ermitteln, ob sie mithilfe eines regulären Ausdrucks angezeigt werden sollte. Das Mail-Add-In, das in der Spalte File angegeben ist, wurde von Outlook 2013 deaktiviert, weil es bei dem Versuch, einen regulären Ausdruck zuzuordnen, mehrfach zu einer Zeitüberschreitung gekommen ist. | |
| 16 |
Dokument geöffnet beim Absturz der Anwendung |
Kritisch |
Die in der Spalte Datei aufgeführte Datei war geöffnet, als die Anwendung (in der Anwendungsspalte aufgeführt) abstürzte. Möglicherweise ist die Datei für den Absturz der Anwendung verantwortlich. |
| 17 |
Das Add-In wurde erfolgreich geschlossen. |
Informativ |
Die Anwendung konnte das Add-In erfolgreich herunterfahren. successfully. |
| 18 |
Die App wurde erfolgreich geschlossen. |
Die Hostanwendung konnte die Office-Add-In erfolgreich schließen. | |
| 19 |
Für das Add-In ist ein Laufzeitfehler aufgetreten, der lokal protokolliert wurde. |
Kritisch |
Das Office-Add-In hatte ein Problem, das dazu geführt hat, dass es fehlschlägt. Weitere Informationen finden Sie im Microsoft Office-Warnungsprotokoll mithilfe der Windows-Ereignisanzeige auf dem Computer, auf dem der Fehler aufgetreten ist. |
| 20 |
Das Add-In konnte die Lizenzierung nicht überprüfen. |
Kritisch |
Die Lizenzierungsinformationen für das Office-Add-In konnten nicht überprüft werden und sind möglicherweise abgelaufen. Weitere Informationen finden Sie im Microsoft Office-Warnungsprotokoll mithilfe der Windows-Ereignisanzeige auf dem Computer, auf dem der Fehler aufgetreten ist. |
| 21 |
Bei einem Makro ist ein Kompilierungsfehler aufgetreten |
Warnung |
Die Datei enthält ein Makro, das nicht kompiliert und nicht ausgeführt werden konnte. Weitere Details finden Sie in der Fehlermeldung, die beim Versuch der Kompilierung des Makros im Makro-Editor angezeigt wird. |
| 22 |
Bei einem Makro ist ein Laufzeitfehler aufgetreten |
Warnung |
Die Datei enthält ein Makro, bei dem ein Laufzeitfehler aufgetreten ist. Weitere Informationen finden Sie in der Fehlermeldung, die beim Ausführen des Makros über den Makro-Editor angezeigt wird, und sehen Sie sich die Referenz zu auffangbaren Fehlern in Visual Basic für Anwendungen an. |
| Verschiedene |
"OM Behavior Change: ..." |
Informativ |
Der von einem Add-In oder Makro aktivierte Dokumentcode verwendet ein Objekt, ein Element, eine Auflistung, eine Aufzählung oder eine Konstante, das bzw. die sich anders verhält als in früheren Versionen von Office. Weitere Informationen hierzu finden Sie unter Kompatibilitätsprobleme in Office. |
| Verschiedene |
"OM Removed: …" |
Kritisch |
Der von einem Add-In oder Makro aktivierte Dokumentcode verwendet ein Objekt, ein Element, eine Auflistung, eine Aufzählung oder eine Konstante, das bzw. die aus dem Objektmodell entfernt wurde. Weitere Informationen hierzu finden Sie unter Kompatibilitätsprobleme in Office. |
| Verschiedene |
"OM Hidden: …" |
Informativ |
Der von einem Add-In oder Makro aktivierte Dokumentcode verwendet ein Objekt, ein Element, eine Auflistung, eine Aufzählung oder eine Konstante, das bzw. die aus dem Objektmodell ausgeblendet wurde. Weitere Informationen hierzu finden Sie unter Kompatibilitätsprobleme in Office. |
| Verschiedene |
"Control: …" |
Die Datei enthält ein Steuerelement, das in Office 2013 oder vom Betriebssystem des Computers möglicherweise nicht unterstützt wird. Weitere Informationen hierzu finden Sie unter Kompatibilitätsprobleme in Office. |
Schlussbemerkung
Telemetrieprotokoll bietet großen Unternehmen, einzelnen Benutzern und Entwicklern ein einfaches Instrument für die Überwachung wichtiger Office-Lösungen. Indem Unternehmen problematische Office-Lösungen vor einem groß angelegten Upgrade identifizieren, können sie die Kosten einer Einführung von Office 2013 besser abschätzen.