Guia do usuário do Microsoft Office Code Compatibility Inspector

Sobre o inspetor

O Microsoft Office Code Compatibility Inspector foi desenvolvido para ajudar uma organização ou pequena empresa a atualizar o código VBA (Visual Basic for Applications) e o código do Visual Studio Tools for Office para que ele fique compatível com o Office 2010. O Inspetor não corrige o código; ele o inspeciona e comenta linhas específicas do código que fazem referências a itens no modelo de objeto que tenham sido alterados ou preteridos. No código VBA, a ferramenta também comenta as declarações Declare para compatibilidade com 64 bits. Você pode modificar o código com base nos comentários ou usar os links apresentados nesses comentários para exibir os tópicos na Web pertinentes a determinada linha do seu código.

Novamente, cabe a você modificar o código se achar necessário.

Veja a seguir os principais recursos do Office Code Compatibility Inspector:

• Consiste em quatro suplementos que são carregados, um suplemento por aplicativo, no Excel 2010, no PowerPoint 2010, no Word 2010 e no Visual Studio 2008.

• É executado por usuário ou por documento. Para o VBA, os usuários abrem um documento e executam a ferramenta na guia Desenvolvedor. Para projetos do Visual Studio, o desenvolvedor executa a ferramenta através do menu Ferramentas.

• Verifica os projetos no documento atual ou na Solução do Visual Studio, usando a pesquisa de texto simples e procurando pelas combinações parentObject.Property, e verifica as declarações Declare para compatibilidade com 64 bits (no VBA).

• Adiciona comentários nas partes do código em que encontra outros possíveis problemas.

• Exibe um resumo e um relatório detalhado de tudo o que encontrou após o término da inspeção.

Não é possível usar essa ferramenta para inspecionar código do Microsoft Outlook ou do Microsoft Access. No entanto, é possível usar a ferramenta para inspecionar código do Excel, do PowerPoint e do Word para interação com o modelo de objeto do Outlook.

Instalação

Para instalar o Office Code Compatibility Inspector, siga estas etapas:

1. Baixe a versão Atualização 1 do OCCI em Ferramenta do Office 2010: Compatibility Inspector (em inglês) (https://go.microsoft.com/fwlink/?linkid=171093\&clcid=0x416) (em inglês). Salve-a na área de trabalho ou em algum outro local conveniente, procure pelo arquivo e clique duas vezes sobre ele para iniciar a instalação.

   • Você pode optar por instalar somente o suplemento do Visual Studio.

   • Você pode optar por instalar somente os suplementos do Office.

   • Se preferir, é possível instalar os dois.

2. Siga os prompts e clique em Concluir para concluir a instalação.

Inspecionando o código VBA

Para inspecionar a compatibilidade de um documento, siga estas etapas:

1. Abra o documento no Excel 2010, PowerPoint 2010 ou Word 2010.

2. Na guia Desenvolvedor, clique em Inspecionar Código VBA.

   Figura 1. Opções do Code Compatibility Inspector na guia Desenvolvedor

   

3. Na caixa de diálogo Inspecionar Projeto VBA, marque ou desmarque as opções, conforme apropriado, e clique em Inspecionar.

   Figura 2. Caixa de diálogo Inspecionar Projeto VBA

   

   1. Selecione Inspecionar Projetos do Visual Basic for Application para inspecionar no projeto VBA itens do modelo de objeto que foram alterados ou removidos.

   2. Selecione Inspecionar instruções Declare se o projeto for executado apenas no Office 2010 ou se ele puder ser executado em um sistema com o Office 2010 de 64 bits.

   3. Selecione Adicionar comentários para colocar comentários em seu código onde a ferramenta identificar potenciais problemas de compatibilidade. Os comentários adicionados pelo Inspetor são semelhantes ao exemplo a seguir.

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

   4. Selecione Relatório Detalhado para criar um relatório no final do processo de inspeção. O relatório é um arquivo de texto semelhante ao exemplo a seguir.

      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=0x416:              For Each comp In
      ActiveWorkbook.VBProject.VBComponents
      

4. Depois que o Inspetor concluir seu exame, ele exibirá um relatório de resumo semelhante ao seguinte.

   Figura 2a. Resumo do Code Compatibility Inspector

   

   • Total de linhas verificadas – Número total de linhas de código VBA verificadas no documento.

   • Total de itens encontrados – Número total de itens problemáticos que o Inspetor encontrou no código, incluindo declarações Declare a serem atualizadas, itens alterados, itens preteridos e itens afetados pelas alterações no design.

   • Itens preteridos – Itens no código que foram removidos do modelo de objeto ou que não têm mais suporte nele. Se seu código depender de um item preterido, reconfigure a parte do código necessária.

   • Itens alterados – itens do código que usam um comando cuja sintaxe foi alterada. Se o seu código usar uma sintaxe desatualizada, será preciso atualizá-lo.

   • Itens reprojetados – itens do código cuja sintaxe é igual e ainda existe, mas cujo design atualizado pode gerar resultados inesperados no seu código. Por exemplo, a formatação de uma determinada caixa de texto pode ter mudado por causa de novos serviços de texto e, como resultado, seu código poderia criar uma caixa de texto, mas o layout do texto na caixa poderia ser diferente das versões anteriores.

   • Instruções Declare – número total de instruções de API do Windows detectadas no código VBA e então atualizadas para compatibilidade com 64 bits por meio da inclusão da palavra-chave PTRSAFE.

Inspecionando o código Visual Studio

Para inspecionar a compatibilidade de um documento, siga estas etapas:

1. Abra a solução que deseja inspecionar no Visual Studio Tools for Office.

2. No menu Ferramentas, clique em Inspecionar Código VSTO.

   Figura 3. Menu Ferramentas do VSTO

   

3. Na caixa de diálogo Inspecionar Projeto VSTO, marque ou desmarque as opções, conforme apropriado, e clique em Inspecionar.

   Figura 4. Caixa de diálogo Inspecionar Projeto VSTO

   

   1. Selecione Inspecionar Origem do Visual Studio Tools for Office (VB.NET e C#) para inspecionar itens do projeto do Visual Studio Tools for Office no modelo de objeto que foram alterados ou removidos.

   2. Selecione Adicionar comentários para colocar comentários em seu código onde a ferramenta identificar potenciais problemas de compatibilidade. Os comentários adicionados pelo Inspetor são semelhantes ao exemplo a seguir.

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

   3. Selecione Relatório Detalhado para criar um relatório no final do processo de inspeção. O relatório é um arquivo de texto semelhante ao exemplo a seguir.

      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=0x416:        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=0x416:        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=0x416:        MessageBox.Show(r.SmartTags.Count.ToString());
      

   4. Selecione Backup para fazer backup dos arquivos do projeto antes de inspecionar o código.

4. Depois que o Inspetor concluir seu exame, ele exibirá um relatório de resumo semelhante ao seguinte.

   Figura 5. Resumo do Code Compatibility Inspector

   

   • Total de linhas verificadas – Número total de linhas de código Visual Basic .NET ou C# verificadas no documento.

   • Total de itens encontrados – Número total de itens problemáticos que o Inspetor encontrou no código, incluindo itens alterados, itens preteridos e itens afetados pelas alterações no design.

   • Itens preteridos – Itens no código que foram removidos do modelo de objeto ou que não têm mais suporte nele. Se seu código depender de um item preterido, reconfigure a parte do código necessária.

   • Itens alterados – itens do código que usam um comando cuja sintaxe foi alterada. Se o seu código usar uma sintaxe desatualizada, será preciso atualizá-lo.

   • Itens reprojetados – itens do código cuja sintaxe é igual e ainda existe, mas cujo design atualizado pode gerar resultados inesperados no seu código. Por exemplo, a formatação de uma determinada caixa de texto pode ter mudado por causa de novos serviços de texto e, como resultado, seu código poderia criar uma caixa de texto, mas o layout do texto na caixa poderia ser diferente das versões anteriores.

   • Instruções Declare – número total de instruções de API do Windows detectadas no código VBA e então atualizadas para compatibilidade com 64 bits por meio da inclusão da palavra-chave PTRSAFE.

Usando o inspetor

Se o Inspetor encontrar itens Alterados, Preteridos ou Reprojetados no código, depure o código e resolva todos os problemas. É aconselhável realizar um teste completo no código, inspecionando cada função. Enquanto você depura o código, verifique se há comentários do Office Code Compatibility Inspector acima das linhas que dividem o código. Esses comentários o ajudam a determinar o problema fundamental de determinada linha do código. Se o problema não for óbvio para você, cole a URL que aparece nos comentários em seu navegador para obter mais informações.

Recursos adicionais

Para obter mais informações, consulte os seguintes recursos:

• Office Environment Assessment Tool (OEAT): compatibilidade do Office (em inglês) (https://go.microsoft.com/fwlink/?linkid=171092\&clcid=0x416) (em inglês)

• Guia de compatibilidade de aplicativos para o Office 2010

• Guia do usuário da OEAT (Office Environment Assessment Tool) para o Office 2010

• Visão geral do Office Migration Planning Manager para o Office 2010

• Central de Recursos de Compatibilidade na TechNet (https://go.microsoft.com/fwlink/?linkid=186766\&clcid=0x416)