Benutzerhandbuch für Microsoft Office Code Compatibility Inspector

Informationen zum Tool

Mit Microsoft Office Code Compatibility Inspector können große oder kleine Unternehmen Code von Visual Basic for Applications (VBA) und Visual Studio Tools für Office aktualisieren, damit dieser mit Office 2010 kompatibel ist. Der Code wird bei der Prüfung nicht korrigiert, sondern geprüft, und anschließend werden bestimmte Codezeilen kommentiert, in denen auf Elemente des Objektmodells verwiesen wird, die geändert wurden oder veraltet sind. (In VBA-Code wird auch die 64-Bit-Kompatibilität von Declare-Anweisungen kommentiert.) Dann können Sie den Code anhand der Kommentare ändern oder die in den Kommentaren bereitgestellten Links verwenden, um Themen im Web anzuzeigen, die sich auf eine bestimmte Codezeile beziehen.

Wenn Sie zum Schluss kommen, dass der Code geändert werden muss, liegt es bei Ihnen, diese Änderung vorzunehmen.

Zu den wichtigsten Features von Office Code Compatibility Inspector gehören folgende:

• Das Tool besteht aus vier Add-Ins, die (jeweils ein Add-In pro Anwendung) in Excel 2010, PowerPoint 2010, Word 2010 und Visual Studio 2008 geladen werden.

• Das Tool wird pro Benutzer oder pro Dokument ausgeführt. Bei VBA öffnen Benutzer ein Dokument und führen das Tool über die Registerkarte Entwicklertools aus. Bei Visual Studio-Projekten führt der Entwickler das Tool über das Menü Extras aus.

• Die Projekte im aktuellen Dokument bzw. in der aktuellen Visual Studio-Projektmappe werden mit einer einfachen Textsuche überprüft. Dabei wird nach parentObject.Property-Kombinationen gesucht, und Declare-Anweisungen werden auf die 64-Bit-Kompatibilität überprüft (in VBA).

• An Stellen im Code, an denen andere potenzielle Probleme gefunden werden, werden Kommentare hinzugefügt.

• Nach Abschluss der Prüfung werden eine Zusammenfassung und ein detaillierter Bericht zu den Ergebnissen angezeigt.

Sie können dieses Tool nicht verwenden, um Code aus Microsoft Outlook oder Microsoft Access zu untersuchen. Sie können das Tool jedoch verwenden, um Excel-, PowerPoint- und Word-Code auf Interaktionen mit dem Outlook-Objektmodell zu prüfen.

Installation

Zum Installieren von Office Code Compatibility Inspector führen Sie die folgenden Schritte aus:

1. Laden Sie die Update 1-Version von OCCI unter Office 2010-Tool: Compatibility Inspector (in englischer Sprache) (https://go.microsoft.com/fwlink/?linkid=171093\&clcid=0x407) herunter. Speichern Sie sie auf dem Desktop oder in einem anderen geeigneten Speicherort, navigieren Sie dann zu der Datei, und öffnen Sie sie, um die Installation zu starten.

   • Sie können auswählen, dass nur das Visual Studio-Add-In installiert wird.

   • Sie können auswählen, dass nur die Office-Add-Ins installiert werden.

   • Sie können auch auswählen, dass beide installiert werden.

2. Folgen Sie den Eingabeaufforderungen, und wählen Sie dann Fertig stellen aus, um die Installation abzuschließen.

Prüfen von VBA-Code

Zum Prüfen der Kompatibilität eines Dokuments führen Sie die folgenden Schritte aus:

1. Öffnen Sie das Dokument in Excel 2010, PowerPoint 2010 oder Word 2010.

2. Klicken Sie auf der Registerkarte Entwicklertools auf Inspect VBA Code.

   Abbildung 1. Optionen für Code Compatibility Inspector auf der Registerkarte "Entwicklertools"

   

3. Aktivieren bzw. deaktivieren Sie die Optionen im Dialogfeld Inspect VBA Project, und klicken Sie dann auf Inspect.

   Abbildung 2. Dialogfeld "Inspect VBA Project"

   

   1. Wählen Sie Inspect Visual Basic for Application Projects aus, um das VBA-Projekt auf Elemente im Objektmodell zu prüfen, die geändert oder entfernt wurden.

   2. Wählen Sie Inspect Declare statements aus, wenn das Projekt nur in Office 2010 ausgeführt wird oder wenn das Projekt möglicherweise auf einem System mit einer 64-Bit-Version von Office 2010 ausgeführt wird.

   3. Wählen Sie Add comments aus, um an Stellen im Code, an denen potenzielle Kompatibilitätsprobleme erkannt werden, Kommentare zu platzieren. Die bei der Prüfung hinzugefügten Kommentare sehen etwa wie im folgenden Beispiel aus.

      '<VBA_INSPECTOR>
      '      <DEPRECATION>
      '        <MESSAGE>Potentially contains ... </MESSAGE>
      '        <ITEM>AnswerWizard.ResetFileList</ITEM>
      '        <URL>https://go.microsoft.com/fwlink/?linkid=171730&clcid=0x407
      

   4. Wählen Sie Detailed Report aus, um am Ende des Prüfungsvorgangs einen Bericht zu erstellen. Beim Bericht handelt es sich um eine Textdatei, die etwa wie im folgenden Beispiel aussieht.

      SUMMARY:
      ========
      
      Document scanned:        c:\TestFile.xls
      Date Scanned:            Thursday, November 12, 2009
      Total lines scanned:     101
      Total items found:       1
      Deprecated items:        0
      Changed items:           1
      Redesigned items:        0
      Declare statements:      0
      
      DETAILS:
      ========
      
      MODULE:            Module1
      FUNCTION:          Macro1
      LINE:              19
      TYPE:              CHANGE
      ITEM:              Workbook.VBProject
      URL:               https://go.microsoft.com/fwlink/?linkid=170116&clcid=0x407:              For Each comp In
      ActiveWorkbook.VBProject.VBComponents
      

4. Nach Abschluss der Prüfung wird ein Zusammenfassungsbericht angezeigt, der etwa wie der folgende aussieht.

   Abbildung 2a. Zusammenfassung von Code Compatibility Inspector

   

   • Total lines scanned – Gesamtanzahl der überprüften VBA-Codezeilen im Dokument.

   • Total items found – Gesamtanzahl der problematischen Elemente, die bei der Prüfung im Code gefunden wurden, einschließlich zu aktualisierender Declare-Anweisungen, geänderter, veralteter und von Entwurfsänderungen betroffener Elemente.

   • Deprecated items – Elemente im Code, die aus dem Objektmodell entfernt wurden oder dort nicht mehr unterstützt werden. Wenn der Code von einem veralteten Element abhängt, müssen Sie diesen Teil des Codes neu schreiben.

   • Changed items – Elemente im Code, von denen ein Befehl verwendet wird, dessen Syntax geändert wurde. Wenn im Code veraltete Syntax verwendet wird, müssen Sie den Code aktualisieren.

   • Redesigned items – Elemente im Code, deren Syntax unverändert und noch vorhanden ist, deren aktualisierter Entwurf jedoch beim Code möglicherweise zu unerwarteten Ergebnissen führen kann. Beispielsweise wurde möglicherweise aufgrund neuer Textdienste die Formatierung eines bestimmten Textfelds geändert. Daher wird vom Code ein Textfeld erstellt, bei dem jedoch das Layout des Texts von dem vorheriger Versionen abweicht.

   • Declare statements – Gesamtanzahl der im VBA-Code erkannten Windows-API-Anweisungen, die anschließend aus Gründen der 64-Bit-Kompatibilität durch Hinzufügen des PTRSAFE-Schlüsselworts aktualisiert wurden.

Prüfen von Visual Studio-Code

Zum Prüfen der Kompatibilität eines Dokuments führen Sie die folgenden Schritte aus:

1. Öffnen Sie die zu prüfende Projektmappe in Visual Studio Tools für Office.

2. Klicken Sie im Menü Extras auf Inspect VSTO Code.

   Abbildung 3. VSTO-Menü "Extras"

   

3. Aktivieren bzw. deaktivieren Sie die Optionen im Dialogfeld Inspect VSTO Project, und wählen Sie dann Inspect aus.

   Abbildung 4. Dialogfeld "Inspect VSTO Project"

   

   1. Wählen Sie Inspect Visual Studio Tools for Office Source (VB.NET and C#) aus, um das Visual Studio Tools für Office-Projekt auf Elemente im Objektmodell zu prüfen, die geändert oder entfernt wurden.

   2. Wählen Sie Add comments aus, um an Stellen im Code, an denen potenzielle Kompatibilitätsprobleme erkannt werden, Kommentare zu platzieren. Die bei der Prüfung hinzugefügten Kommentare sehen etwa wie im folgenden Beispiel aus.

      //<VSTO_INSPECTOR>
      //  <DEPRECATION>
      //      <MESSAGE>Potentially contains removed items...</MESSAGE>
      //      <ITEM>[mso]AnswerWizard.ResetFileList</ITEM>
      //      <URL>https://go.microsoft.com/fwlink/?linkid=171730&clcid=0x407
      

   3. Wählen Sie Detailed Report aus, um am Ende des Prüfungsvorgangs einen Bericht zu erstellen. Beim Bericht handelt es sich um eine Textdatei, die etwa wie im folgenden Beispiel aussieht.

      SUMMARY:
      ========
      
      Solution scanned:        ExcelAddIn1
      Date scanned:            Thursday, November 12, 2009
      Total lines scanned:     43
      Total items found:       3
      Deprecated items:        3
      Changed items:           0
      Redesigned items:        0
      
      DETAILS:
      ========
      
      MODULE:      ThisAddIn.cs
      FUNCTION:    ThisAddIn_Startup
      LINE:        17
      TYPE:        DEPRECATION
      APP:         mso
      ITEM:        AnswerWizard
      URL:         https://go.microsoft.com/fwlink/?linkid=171730&clcid=0x407:        xlApp.AnswerWizard.ResetFileList();
      
      MODULE:      ThisAddIn.cs
      FUNCTION:    ThisAddIn_Startup
      LINE:        19
      TYPE:        DEPRECATION
      APP:         xls
      ITEM:        SmartTagRecognizers
      URL:         https://go.microsoft.com/fwlink/?linkid=170614&clcid=0x407:        xlApp.SmartTagRecognizers.Recognize = true;
      
      MODULE:      ThisAddIn.cs
      FUNCTION:    ThisAddIn_Startup
      LINE:        22
      TYPE:        DEPRECATION
      APP:         xls
      ITEM:        SmartTags
      URL:         https://go.microsoft.com/fwlink/?linkid=170617&clcid=0x407:        MessageBox.Show(r.SmartTags.Count.ToString());
      

   4. Wählen Sie Backup aus, um die Projektdateien vor der Prüfung des Codes zu sichern.

4. Nach Abschluss der Prüfung wird ein Zusammenfassungsbericht angezeigt, der etwa wie der folgende aussieht.

   Abbildung 5. Zusammenfassung von Code Compatibility Inspector

   

   • Total lines scanned – Gesamtanzahl der überprüften Visual Basic .NET- oder C#-Codezeilen im Dokument.

   • Total items found – Gesamtanzahl der problematischen Elemente, die bei der Prüfung im Code gefunden wurden, einschließlich geänderter, veralteter und von Entwurfsänderungen betroffener Elemente.

   • Deprecated items – Elemente im Code, die aus dem Objektmodell entfernt wurden oder dort nicht mehr unterstützt werden. Wenn der Code von einem veralteten Element abhängt, müssen Sie diesen Teil des Codes neu schreiben.

   • Changed items – Elemente im Code, von denen ein Befehl verwendet wird, dessen Syntax geändert wurde. Wenn im Code veraltete Syntax verwendet wird, müssen Sie den Code aktualisieren.

   • Redesigned items – Elemente im Code, deren Syntax unverändert und noch vorhanden ist, deren aktualisierter Entwurf jedoch beim Code möglicherweise zu unerwarteten Ergebnissen führen kann. Beispielsweise wurde möglicherweise aufgrund neuer Textdienste die Formatierung eines bestimmten Textfelds geändert. Daher wird vom Code ein Textfeld erstellt, bei dem jedoch das Layout des Texts von dem vorheriger Versionen abweicht.

   • Declare statements – Gesamtanzahl der im VBA-Code erkannten Windows-API-Anweisungen, die anschließend aus Gründen der 64-Bit-Kompatibilität durch Hinzufügen des PTRSAFE-Schlüsselworts aktualisiert wurden.

Verwenden des Tools

Wenn bei der Prüfung geänderte, veraltete oder neu entworfene Elemente im Code gefunden werden, müssen Sie den Code debuggen und die Probleme lösen. Es wird empfohlen, einen vollständigen Testdurchlauf für den Code auszuführen und dabei jede einzelne Funktion zu prüfen. Achten Sie beim Debuggen des Codes auf Office Code Compatibility Inspector-Kommentare über den Zeilen, in die der Code umbrochen ist. Diese Kommentare sollen Ihnen helfen, für die jeweilige Codezeile das zugrunde liegende Problem zu ermitteln. Wenn das Problem für Sie nicht sofort offensichtlich ist, fügen Sie die URL aus den Kommentaren in den Browser ein, um weitere Informationen zu erhalten.

Zusätzliche Ressourcen

Weitere Informationen finden Sie in den folgenden Quellen:

• Tool zur Bewertung der Office-Umgebung (Office Environment Assessment Tool, OEAT): Office-Kompatibilität (in englischer Sprache) (https://go.microsoft.com/fwlink/?linkid=171092\&clcid=0x407) (in englischer Sprache)

• Leitfaden zur Office 2010-Anwendungskompatibilität

• Anleitung für das Tool zur Bewertung der Office-Umgebung (OEAT) für Office 2010

• Übersicht über Office Migration Planning Manager für Office 2010

• Kompatibilitätsressourcencenter auf TechNet (https://go.microsoft.com/fwlink/?linkid=186766\&clcid=0x407)