Microsoft Office Code Compatibility Inspector 사용자 가이드

Office Code Compatibility Inspector 정보

Microsoft Office Code Compatibility Inspector는 대기업 및 소규모 기업에서 Office 2010과 호환되도록 VBA 및 Visual Studio Tools for Office 코드를 업데이트하는 과정을 지원하기 위한 도구입니다. 이 도구에서는 코드를 수정하지는 않으며 코드를 검사한 다음 개체 모델에서 변경되었거나 더 이상 사용되지 않는 항목에 대해 언급하는 특정 코드 주석 줄을 남깁니다. VBA 코드의 경우 이 도구에서는 Declare 문에 64비트 호환성에 대한 주석을 남깁니다. 그러면 주석을 토대로 코드를 수정하거나 주석에 제공된 링크를 사용하여 웹에서 특정 코드 줄과 관련된 항목을 볼 수 있습니다.

다시 한 번 말하지만 코드를 수정해야 하는 것으로 확인한 경우 수정 작업은 직접 결정하고 수행해야 합니다.

Office Code Compatibility Inspector의 주요 기능은 다음과 같습니다.

• Excel 2010, PowerPoint 2010, Word 2010 및 Visual Studio 2008에서 응용 프로그램당 하나씩 로드되는 네 개의 추가 기능으로 구성되어 있습니다.

• 사용자 또는 문서를 기준으로 실행됩니다. VBA의 경우 사용자는 문서를 열고 개발 도구 탭에서 도구를 실행합니다. Visual Studio 프로젝트에서는 개발자가 도구 메뉴에서 이 도구를 실행합니다.

• parentObject.Property 조합을 찾는 단순한 텍스트 검색을 통해 현재 문서 또는 Visual Studio 솔루션에서 프로젝트를 검사하고 Declare 문에서 64비트 호환성을 검사합니다(VBA의 경우).

• 코드에서 다른 잠재적인 문제를 찾아 주석을 추가합니다.

• 검사를 완료한 후에는 검사 결과에 대한 요약 정보 및 세부 보고서를 표시합니다.

이 도구를 사용하여 Microsoft Outlook 또는 Microsoft Access에서 코드를 검사할 수는 없지만 Outlook 개체 모델과 연동되는 Excel, PowerPoint 및 Word 코드를 검사할 수는 있습니다.

설치

Office Code Compatibility Inspector를 설치하려면 다음 단계를 수행합니다.

1. OCCI의 업데이트 1 버전은 Office 2010 도구: Compatibility Inspector(영문일 수 있음)(https://go.microsoft.com/fwlink/?linkid=171093\&clcid=0x412)(영문일 수 있음)에서 다운로드할 수 있습니다. 바탕 화면이나 기타 편리한 위치에 OCCI를 저장하고 파일을 찾은 다음 열어서 설치를 시작합니다.

   • Visual Studio 추가 기능만 설치하도록 선택할 수 있습니다.

   • Office 추가 기능만 설치하도록 선택할 수 있습니다.

   • 또는 둘 다 설치하도록 선택할 수도 있습니다.

2. 화면의 지침을 따른 다음 **Finish(마침)**를 선택하여 설치를 완료합니다.

VBA 코드 검사

문서에서 호환성을 검사하려면 다음 단계를 수행합니다.

1. Excel 2010, PowerPoint 2010 또는 Word 2010에서 문서를 엽니다.

2. 개발 도구 탭에서 **Inspect VBA Code(VBA 코드 검사)**를 선택합니다.

   그림 1. 개발 도구 탭의 Code Compatibility Inspector 옵션

   

3. Inspect VBA Project(VBA 프로젝트 검사) 대화 상자에서 옵션을 적절히 선택하거나 선택을 취소한 다음 **Inspect(검사)**를 선택합니다.

   그림 2. Inspect VBA Project(VBA 프로젝트 검사) 대화 상자

   

   1. **Inspect Visual Basic for Application Projects(Visual Basic for Application 프로젝트 검사)**를 선택하여 VBA 프로젝트에서 변경되거나 제거된 개체 모델의 항목을 검사합니다.

   2. 프로젝트를 Office 2010에서만 실행하거나 64비트 Office 2010이 실행되는 시스템에서 실행할 수도 있는 경우에는 **Inspect Declare statements(Declare 문 검사)**를 선택합니다.

   3. **Add comments(주석 추가)**를 선택하여 도구를 통해 잠재적인 호환성 문제를 식별하는 코드에 주석을 남깁니다. Code Compatibility Inspector에서 추가하는 주석은 다음 예제와 유사합니다.

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

   4. **Detailed Report(세부 보고서)**를 선택하여 검사 프로세스가 완료될 때 보고서를 작성합니다. 이 보고서는 다음 예제와 유사한 텍스트 파일입니다.

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

4. Code Compatibility Inspector에서 검사를 완료하면 다음과 같은 요약 보고서가 표시됩니다.

   그림 2a. Code Compatibility Inspector Summary(Code Compatibility Inspector 요약)

   

   • Total lines scanned(총 검사된 줄 수) – 문서에서 검사된 VBA 코드 줄의 총 수입니다.

   • Total items found(총 확인된 항목 수) – 업데이트할 Declare 문, 변경된 항목, 더 이상 사용되지 않는 항목, 디자인 변경으로 인해 영향을 받는 항목 같은 코드에서 도구를 통해 확인된 문제가 있는 항목의 총 수입니다.

   • Deprecated items(더 이상 사용되지 않는 항목) – 개체 모델에서 제거되었거나 더 이상 지원되지 않는 코드의 항목입니다. 코드에서 더 이상 사용되지 않는 항목을 활용하는 경우 코드의 해당 부분을 다시 작성해야 합니다.

   • Changed items(변경된 항목) – 구문이 변경된 명령을 사용하는 코드의 항목입니다. 코드에 사용되는 구문이 오래된 경우 코드를 업데이트해야 합니다.

   • Redesigned items(다시 디자인된 항목) – 구문이 같고 여전히 사용되지만 디자인이 업데이트되어 코드에 대해 예기치 않은 결과가 발생할 수 있는 코드의 항목입니다. 예를 들어 새로운 텍스트 서비스로 인해 특정 텍스트 상자의 형식 지정 방식이 변경되었을 수 있으며 이로 인해 코드에서 텍스트 상자를 만들 수 있지만 상자의 텍스트 레이아웃이 이전 버전과 달라질 수 있습니다.

   • Declare statements(Declare 문) – VBA 코드에서 검색된 후 PTRSAFE 키워드를 추가하여 64비트와 호환되도록 업데이트된 Windows API 문의 총 수입니다.

Visual Studio 코드 검사

문서에서 호환성을 검사하려면 다음 단계를 수행합니다.

1. Visual Studio Tools for Office에서 검사할 솔루션을 엽니다.

2. Tools(도구) 메뉴에서 **Inspect VSTO Code(VSTO 코드 검사)**를 선택합니다.

   그림 3. VSTO Tools(도구) 메뉴

   

3. Inspect VSTO Project(VSTO 프로젝트 검사) 대화 상자에서 옵션을 적절히 선택하거나 선택을 취소한 다음 **Inspect(검사)**를 선택합니다.

   그림 4. Inspect VSTO Project(VSTO 프로젝트 검사) 대화 상자

   

   1. **Inspect Visual Studio Tools for Office Source (VB.NET and C#)(Inspect Visual Studio Tools for Office 원본(VB.NET 및 C#) 검사)**를 선택하여 Visual Studio Tools for Office 프로젝트에서 변경되거나 제거된 개체 모델의 항목을 검사합니다.

   2. **Add comments(주석 추가)**를 선택하여 도구를 통해 잠재적인 호환성 문제를 식별하는 코드에 주석을 남깁니다. Code Compatibility Inspector에서 추가하는 주석은 다음 예제와 유사합니다.

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

   3. **Detailed Report(세부 보고서)**를 선택하여 검사 프로세스가 완료될 때 보고서를 작성합니다. 이 보고서는 다음 예제와 유사한 텍스트 파일입니다.

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

   4. **Backup(백업)**을 선택하여 코드를 검사하기 전에 프로젝트 파일을 백업합니다.

4. Code Compatibility Inspector에서 검사를 완료하면 다음과 같은 요약 보고서가 표시됩니다.

   그림 5. Code Compatibility Inspector Summary(Code Compatibility Inspector 요약)

   

   • Total lines scanned(총 검사된 줄 수) – 문서에서 검사된 Visual Basic .NET 또는 C# 코드 줄의 총 수입니다.

   • Total items found(총 확인된 항목 수) – 변경된 항목, 더 이상 사용되지 않는 항목, 디자인 변경으로 인해 영향을 받는 항목 같은 코드에서 도구를 통해 확인된 문제가 있는 항목의 총 수입니다.

   • Deprecated items(더 이상 사용되지 않는 항목) – 개체 모델에서 제거되었거나 더 이상 지원되지 않는 코드의 항목입니다. 코드에서 더 이상 사용되지 않는 항목을 활용하는 경우 코드의 해당 부분을 다시 작성해야 합니다.

   • Changed items(변경된 항목) – 구문이 변경된 명령을 사용하는 코드의 항목입니다. 코드에 사용되는 구문이 오래된 경우 코드를 업데이트해야 합니다.

   • Redesigned items(다시 디자인된 항목) – 구문이 같고 여전히 사용되지만 디자인이 업데이트되어 코드에 대해 예기치 않은 결과가 발생할 수 있는 코드의 항목입니다. 예를 들어 새로운 텍스트 서비스로 인해 특정 텍스트 상자의 형식 지정 방식이 변경되었을 수 있으며 이로 인해 코드에서 텍스트 상자를 만들 수 있지만 상자의 텍스트 레이아웃이 이전 버전과 달라질 수 있습니다.

   • Declare statements(Declare 문) – VBA 코드에서 검색된 후 PTRSAFE 키워드를 추가하여 64비트와 호환되도록 업데이트된 Windows API 문의 총 수입니다.

Office Code Compatibility Inspector 사용

Office Code Compatibility Inspector를 통해 코드에서 Changed(변경됨), Deprecated(더 이상 사용되지 않음) 또는 Redesigned(다시 디자인됨) 항목이 확인되면 코드를 디버깅하고 문제를 해결해야 합니다. 코드에 대해 전체 테스트를 수행하여 각 기능을 검사하는 것이 좋습니다. 코드를 디버깅할 때는 코드를 손상시킨 줄 위에 있는 Office Code Compatibility Inspector 주석을 확인합니다. 이러한 주석은 해당 코드 줄과 관련된 근본적인 문제를 확인하는 데 도움이 됩니다. 문제를 한눈에 명확하게 이해하기 어려운 경우 주석에 있는 URL을 브라우저에 붙여 넣어 추가 정보를 확인합니다.

추가 리소스

자세한 내용은 다음 리소스를 참조하십시오.

• OEAT(Office Environment Assessment Tool): Office 호환성(영문일 수 있음)(https://go.microsoft.com/fwlink/?linkid=171092\&clcid=0x412)(영문일 수 있음)

• Office 2010 응용 프로그램 호환성 가이드

• Office 2010용 OEAT(Office Environment Assessment Tool) 사용자 가이드

• Office 2010의 Office 마이그레이션 계획 관리자 개요

• TechNet의 호환성 리소스 센터(https://go.microsoft.com/fwlink/?linkid=186766\&clcid=0x412)