Office 추가 기능을 단계별로 만드는 방법

오피스 추가 기능(플러그인, 확장 프로그램 등 어떤 이름으로 부르든 상관없습니다)이 어떻게 만들어지는지 궁금하셨다면 제대로 찾아오셨습니다. 추가 기능은 Word , Excel, Outlook, PowerPoint, OneNote, Project 및 기타 앱 과 통합되어 Office의 기능을 확장하는 소규모 웹 애플리케이션입니다. 번거로운 작업을 자동화하는 것부터 외부 클라우드 서비스와 연결하는 것까지 다양한 기능을 제공합니다.

코딩을 시작하기 전에, 오피스 추가 기능은 단순히 독립 실행형 스크립트가 아니라는 점을 이해하는 것이 중요합니다 . 오피스 추가 기능은 오피스 추가 기능 플랫폼 내에 존재하며, 매니페스트 파일로 정의되고, JavaScript API를 사용하여 오피스와 통신하는 웹 애플리케이션으로 실행됩니다. 이제부터 프로젝트 생성 도구, 내부 구조, API 모델, 테스트 및 디버깅 방법, 게시 방법, 그리고 애플리케이션 내에서 권한 및 액세스를 관리하는 방법까지, 알아야 할 모든 것을 차근차근 살펴보겠습니다.

Office 추가 기능이란 정확히 무엇인가요?

Office 추가 기능은 기본적으로 Microsoft 365 애플리케이션(Word, Excel, Outlook, PowerPoint, OneNote, Project 등)과 통합되어 인터페이스와 기능을 확장하는 웹 애플리케이션 입니다 . 리본 메뉴, 상황별 메뉴 또는 사이드바에 "부착"되어 새로운 기능을 제공하는 추가 구성 요소라고 생각하면 됩니다.

이 플러그인 의 가장 큰 장점은 표준 웹 기술 (HTML, CSS, JavaScript 또는 TypeScript, React와 같은 프레임워크 포함)을 사용하여 실행되고 Office JavaScript API를 통해 문서 또는 이메일 메시지와 통신한다는 점입니다. 이를 통해 콘텐츠를 읽고 수정하고, 사용자 지정 인터페이스를 표시하고, 외부 서비스, REST API, 회사 내부 시스템 등과 통신할 수 있습니다.

Office 추가 기능의 두 가지 핵심 구성 요소

모든 Office 추가 기능은 항상 두 가지 별개의 부분 으로 구성되어 있으며 , 이는 처음부터 염두에 두어야 합니다.

• 보완 선언문구성, 동작 및 Office 인터페이스와의 통합 방식을 정의합니다.
• 웹 애플리케이션이는 작업 창 인터페이스, 대화 상자 또는 콘텐츠 플러그인을 렌더링하고 비즈니스 로직을 포함하는 실제 코드(HTML, CSS, JavaScript/TypeScript)입니다.

매니페스트는 추가 기능의 "신분증"이자 사용 설명서 역할을 하며, 웹 애플리케이션은 실제 작업을 수행하고 Office JavaScript API를 사용하여 문서 또는 이메일과 통신하는 "엔진" 역할을 합니다.

보완의 선언문을 정의하는 것은 무엇입니까?

일반적으로 프로젝트 루트에 manifest.xml 또는 manifest.json 파일로 저장되는 Office 추가 기능의 매니페스트에는 Office에서 추가 기능의 기능, 호스팅 위치 및 사용자에게 표시되는 방식을 파악하는 데 필요한 모든 정보가 포함되어 있습니다.

선언문에는 특히 다음과 같은 핵심 요소 들이 명시되어 있으며 , 이러한 요소들을 면밀히 감시해야 합니다.

• 플러그인 메타데이터: 식별자(ID), 버전, 사용자 표시 이름, 설명, 기본 로케일 등
• 호환되는 Office 응용 프로그램예를 들어, 추가 기능을 Word, Excel, Outlook, PowerPoint, Project 또는 OneNote에서 사용할 수 있는지 여부입니다.
• 필요한 권한: 문서, Outlook 사서함 또는 기타 리소스에 필요한 액세스 수준입니다.
• Office 인터페이스와의 통합: 사용자 정의 탭, 리본의 버튼, 상황에 맞는 메뉴에 추가된 명령 및 기타 UI 요소.
• 아이콘과 이미지: 플러그인의 브랜딩을 준수하여 리본, 메뉴 및 인터페이스의 다른 부분에 표시될 아이콘에 대한 경로입니다.
• 플러그인 크기예를 들어, 콘텐츠 추가 기능의 크기나 Outlook 추가 기능의 기본 높이 등입니다.
• Outlook의 활성화 규칙: 플러그인이 이메일이나 견적에 표시되는 시기를 결정하는 조건(발신자, 제목, 내용 등에 따라).
• 키보드 단축키Excel과 Word에서 사용자 정의 단축키를 사용할 수 있습니다.

이 모든 점 때문에 매니페스트 파일은 개발과 배포 모두에 매우 중요 합니다 . 플러그인을 배포할 때 실제로 배포되는 것은 웹 애플리케이션이 호스팅되는 URL을 가리키는 매니페스트 파일입니다.

플러그인의 웹 애플리케이션

두 번째 중요한 요소는 사용자가 보고 상호 작용하는 웹 애플리케이션입니다. 이 애플리케이션은 일반적으로 HTML 페이지, CSS 스타일시트, JavaScript 또는 TypeScript 스크립트 로 구성되며 프레임워크를 사용하거나 사용하지 않고 구축할 수 있습니다(React는 가장 일반적인 프레임워크 중 하나이지만 유일한 것은 아닙니다).

이 페이지에서 추가 기능은 Office JavaScript API를 사용하여 실행되는 문서의 내용을 읽고 수정합니다. Excel 범위, Word 단락, Outlook 메시지, PowerPoint 슬라이드, 표, 차트 등 다양한 내용을 다룰 수 있습니다. 또한 웹 앱이므로 다음과 같은 기능도 제공합니다.

• 외부 웹 서비스에 연결 데이터를 얻거나 전송합니다.
• 사용자 인증 관리 OAuth, Azure AD 또는 다른 공급자를 통해.
• 내부 REST API 사용 당신의 조직의.
• 고급 계산부터 복잡한 자동화까지 필요한 모든 비즈니스 로직을 구현합니다.

Office 추가 기능 생성 도구

Office 추가 기능 플랫폼은 다양한 사용자 프로필과 작업 환경에 맞춰 개발 준비가 완료된 프로젝트를 생성 할 수 있는 여러 가지 방법을 제공합니다 . 주요 옵션으로는 Yeoman 생성기, Visual Studio, Visual Studio Code용 추가 기능 개발 키트, Microsoft 365 에이전트 툴킷이 있습니다.

Yeoman 생성기로 플러그인 만들기

Yeoman's Office 추가 기능 생성기를 사용하면 바로 사용할 수 있는 Node.js 프로젝트를 만들고 Visual Studio Code 또는 다른 편집기에서 관리할 수 있습니다. 명령줄 도구를 사용하는 순수 JavaScript 환경에서 작업하는 데 익숙하다면 매우 편리한 옵션입니다.

이 생성기를 사용하면 다음과 같은 플러그인을 만들 수 있습니다.

• 뛰어나다
• OneNote를
• Outlook
• 파워 포인트
• 하이라이트
• 워드
• 사용자 정의 Excel 함수

마법사를 실행하면 HTML, CSS, JavaScript 또는 TypeScript 기반의 프로젝트를 "있는 그대로" 생성할지, 아니면 React를 사용한 JavaScript 또는 TypeScript 기반의 프로젝트를 생성할지 선택할 수 있습니다. 생성기는 전체 구조, Node 종속성 및 초기 구성을 자동으로 설정합니다.

Yeoman 사용을 위한 전제 조건

Yeoman Office 생성기를 사용하려면 JavaScript 생태계에서 흔히 사용되는 몇 가지 기본 구성 요소를 설치 해야 합니다 .

• Node.js LTS 버전공식 Node.js 웹사이트에서 다운로드하여 운영 체제에 맞게 설치합니다.
• Yeoman과 Office 추가 기능 생성기다음 명령을 사용하여 전역적으로 설치됩니다.
  npm install -g yo generator-office
• 활성화된 Microsoft 365 구독 Office를 사용하면 데스크톱과 웹의 Office에서 모두 추가 기능을 테스트할 수 있습니다.

Yeoman으로 프로젝트 만들기

필요한 모든 것을 설치했으면 프로젝트 생성은 매우 간단합니다. 작업하려는 디렉토리에서 명령줄을 열고 다음 명령을 실행하세요.

yo office

마법사가 프로젝트를 세부적으로 조정하기 위해 일련의 질문을 합니다 . 예를 들어, Word용 작업창 추가 기능을 처음 만드는 경우 다음과 유사한 질문에 답할 수 있습니다.

• 프로젝트 유형을 선택하세요: Office 추가 기능 작업창 프로젝트
• 유형을 선택하세요 스크립트: JavaScript
• 추가 기능의 이름을 어떻게 지정하시겠습니까? 내 Office 추가 기능
• 어떤 Office 클라이언트 애플리케이션을 지원하고 싶으신가요? 워드

마법사를 완료하면 Yeoman이 모든 프로젝트 파일을 생성하고 필요한 Node 모듈을 설치하므로 완벽하게 작동하는 기본 플러그인을 사용할 수 있습니다.

Yeoman으로 생성된 프로젝트 구조

Yeoman으로 작업 보드를 위해 생성된 프로젝트는 일반적으로 다음과 매우 유사한 구조를 가지며, 각 부분은 특정 역할을 수행합니다.

• ./manifest.xml 또는 ./manifest.json: 웹 애플리케이션의 구성, 권한, 인터페이스 및 URL과의 통합을 정의하는 매니페스트입니다.
• ./src/taskpane/taskpane.html: 사용자에게 표시되는 작업 패널의 HTML 템플릿입니다.
• ./src/taskpane/taskpane.css: 패널의 모양과 디자인을 담당하는 스타일 시트입니다.
• ./src/taskpane/taskpane.js: Office API에 대한 논리와 호출을 구현하는 JavaScript 코드입니다.

Yeoman으로 만든 플러그인을 사용해 보세요

추가 기능을 테스트하려면 프로젝트 폴더로 이동하여 로컬 웹 서버를 시작하고 Office에 추가 기능을 로드하는 몇 가지 명령을 실행하기만 하면 됩니다.

1. 프로젝트의 루트 폴더로 이동합니다.
   cd "My Office Add-in"
2. 로컬 서버를 시작하고 데스크톱 Word에서 다음을 사용하여 테스트합니다.
   npm start

   이 명령은 웹 서버를 시작합니다(아직 시작되지 않은 경우). 그리고 자동으로 로드된 추가 기능이 있는 Word를 엽니다.

3. 브라우저에서 Word 추가 기능을 사용해 보려면 다음과 같은 명령을 사용하세요.
   npm run start -- web --document {url}

   여기서 {url} 은 사용자가 액세스 권한이 있는 OneDrive 또는 SharePoint 라이브러리 에 저장된 Word 문서의 주소입니다 . 어떤 이유로든 웹의 Office에서 추가 기능이 제대로 로드되지 않으면 수동으로 설치한 다음 로컬에 로드된 매니페스트를 수동으로 제거할 수 있습니다.

4. 문서가 업로드되면 탭에서 작업 창을 열 수 있습니다. Home 버튼을 클릭하여 작업창 표시링크를 클릭하면 달리기 패널에서 일반적인 예는 "Hello, world"를 자체 스타일로 문서에 삽입하는 것입니다.
5. 로컬 서버를 중지하고 필요한 경우 로드된 플러그인을 제거하려면 다음을 사용할 수 있습니다.
   npm stop

   애드온을 수동으로 로컬 업로드한 경우 해당 유형의 로컬 업로드를 제거하기 위한 특정 절차를 따라야 합니다.

Yeoman과 npm의 일반적인 문제

프로젝트 설치 또는 실행 중에 npm 경고 및 오류가 발생하는 것은 비교적 흔한 일입니다 . 일반적인 상황은 다음과 같습니다.

• 자동 단계 실패 npm 설치 발전기 자체가 작동하는 방식입니다. 나중에 npm 시작 오류가 발생합니다. 일반적으로 프로젝트 폴더로 이동하여 수동으로 실행하면 됩니다. npm install.
• 오래되었거나 호환되지 않는 종속성에 대한 경고입니다. 일반적으로 플러그인 실행에는 영향을 미치지 않지만 귀찮을 수 있습니다. 이러한 경고를 지우려면 도구를 사용하세요. npm-체크-업데이트 다음과 같이 :
  • 도구를 설치합니다. npm i -g npm-check-updates
  • package.json의 버전을 업데이트합니다. ncu -u
  • 종속성을 다시 설치합니다. npm install

Visual Studio로 애드온 만들기

Visual Studio를 사용하면 Visual Studio 내에서 직접 Office 추가 기능을 만들 수 있습니다. 이 경우 추가 기능 프로젝트는 더 큰 솔루션의 일부이며 HTML, CSS 및 JavaScript를 기반으로 합니다.

Visual Studio를 사용하면 다음에 대한 추가 기능을 만들 수 있습니다.

• 뛰어나다
• Outlook
• 파워 포인트
• 워드

하지만 이 프로그램 은 OneNote나 Project용 추가 기능을 만드는 것을 지원하지 않습니다 . 해당 애플리케이션의 경우 Yeoman의 생성기를 사용하고 특정 빠른 시작 가이드를 따라야 합니다.

Visual Studio에서 플러그인을 개발하고 사용자 정의합니다.

Visual Studio에서 플러그인 프로젝트를 생성하면, 개발 환경에서 기능이 제한된 기본 플러그인이 생성되는데 , 이는 시작점으로 활용할 수 있도록 설계되었습니다. 그 후, 사용자는 해당 플러그인을 사용자 정의할 수 있습니다.

• El 명백한메타데이터, 권한, 활성화 규칙 및 인터페이스 요소를 조정합니다.
• 파일 HTML, CSS 및 자바 스크립트 작업창이나 대화 상자를 형성하는 요소입니다.

추가 기능 플랫폼을 최대한 활용하려면 플랫폼의 일반적인 개념 (개발 수명 주기, 매니페스트, API 모델, 요구 사항 세트)과 각 애플리케이션(Excel, Word, Outlook 등)의 특정 측면을 이해하는 것이 중요합니다.

Visual Studio에서 실행, 디버그 및 게시

개발 과정에서 Visual Studio는 로컬 웹 서버(localhost)를 대상으로 플러그인을 실행합니다 . 프로덕션 환경에 배포할 준비가 되면 일반적인 절차는 다음과 같습니다.

1. 웹 애플리케이션 게시 서버 또는 호스팅 서비스(예: Microsoft Azure)에서.
2. 매니페스토를 업데이트하세요 이렇게 하면 애플리케이션이 호스팅되는 최종 URL을 가리킵니다.
3. 구현 방법 선택 (내부 플러그인 카탈로그, AppSource 등)을 만들고 매니페스트 파일을 사용자에게 배포합니다.

다양한 플랫폼에서 디버깅하는 방법과 특정 문제를 해결하는 방법에 대한 자세한 내용은 Visual Studio의 Office 추가 기능 디버깅 문서 와 일반 테스트 및 디버깅 가이드를 참조하십시오.

Visual Studio Code용 Office 추가 기능 개발 키트

Visual Studio Code를 주로 사용하는 경우, 편집기 내에서 추가 기능 프로젝트를 더 쉽게 만들고 실행하고 디버깅할 수 있도록 해주는 확장 프로그램인 Office 추가 기능 개발 키트를 설치할 수 있습니다.

이 확장 프로그램을 사용하면 안내 인터페이스를 통해 새 플러그인 프로젝트를 생성 하고 모든 것을 수동으로 구성할 필요 없이 예제를 환경에 직접 로드할 수 있습니다 . 이 확장 프로그램은 Visual Studio Marketplace에서 다운로드할 수 있으며 자체 아이콘과 함께 VS Code 활동 표시줄에 통합됩니다.

개발 키트로 프로젝트 만들기

확장 프로그램에서 제공하는 프로젝트 생성 버튼을 클릭하세요 . 확장 프로그램이 설치되어 있지 않으면 설치하라는 메시지가 표시됩니다.

확장 프로그램 페이지에서 프로젝트 설명이 표시되며, ' 만들기 ' 옵션을 선택하여 추가 기능 생성을 시작할 수 있습니다.

폴더 선택 대화 상자가 나타나면 프로젝트가 생성될 작업 폴더를 선택하십시오 .

개발 키트는 파일 구조를 생성하고 두 번째 VS Code 창에서 프로젝트를 엽니다 . 이때, 기존 창을 닫고 새 창에서만 작업하는 것이 좋습니다.

결과물로 생성된 프로젝트에는 실행 및 수정이 가능한 샘플 코드가 포함된 기본 작업 패널 플러그인 도 들어 있습니다.

VS Code 프로젝트의 구조 및 주요 파일

이러한 유형의 프로젝트 구조는 Yeoman 이 생성하는 구조와 매우 유사하며, 일반적으로 다음과 같은 내용을 포함합니다.

1. 파일 ./manifest.xml 또는 ./manifest.json 루트에서 애드온의 구성과 기능을 살펴봅니다.
2. 파일 ./src/taskpane/taskpane.html 여기에는 작업창의 HTML이 포함되어 있습니다.
3. 스타일시트 ./src/taskpane/taskpane.css 시각적 디자인을 제어합니다.
4. 스크립트 ./src/taskpane/taskpane.js Office JavaScript API 코드를 사용하여 작업창을 Office 응용 프로그램에 연결합니다.

개발 키트에서 플러그인 테스트 및 중지

VS Code 개발 키트에서 플러그인을 테스트하려면 확장 프로그램 자체의 활동 표시줄을 사용하여 몇 가지 간단한 단계를 따르면 됩니다 .

1. 아이콘을 클릭하여 확장 프로그램을 엽니다. Office 추가 기능 개발 키트 활동 막대에서.
2. 옵션을 선택 Office 추가 기능 미리 보기(F5)정화 환경을 준비합니다.
3. 빠른 선택 메뉴에서 옵션을 선택하세요 {Office 응용 프로그램} 데스크톱(Edge Chromium){Office 응용 프로그램}을 원하는 앱(Word, Excel 등)으로 바꾸세요. 그러면 데스크톱 응용 프로그램이 실행되고 추가 기능이 로드되며 디버거가 연결됩니다.

이 과정에서 키트는 모든 필수 조건이 충족되었는지 확인하고, 문제가 발생할 경우 터미널 에 자세한 정보를 표시합니다 . 첫 부팅 시 에는 필요한 종속성 및 인증서가 설치되므로 다소 시간이 걸릴 수 있습니다.

테스트 및 디버깅을 마친 후에는 추가 기능을 올바르게 중지하는 것이 매우 중요합니다 . 단순히 Office 앱을 닫는 것만으로는 추가 기능 등록이 제대로 무효화되지 않는 경우가 있기 때문입니다. 올바른 방법은 다음과 같습니다.

1. 확장 프로그램을 다시 열어보세요 활동 표시줄의 아이콘을 클릭합니다.
2. 클릭 Office 추가 기능 미리 보기 중지이렇게 하면 웹 서버가 닫히고 캐시에서 플러그인 로그가 지워집니다.
3. 마지막으로 닫으세요 Office 응용 프로그램 창.

추가 기능이 시작되지 않거나 이상하게 작동하는 경우, 모든 Office 인스턴스를 닫고 추가 기능 자체의 옵션을 사용하여 이전 서버를 중지하면 문제가 해결되는 경우가 많습니다. 공식 설명서에는 Office 추가 기능 개발 중 문제 해결에 대한 특정 섹션도 포함되어 있으며 , 심각한 문제는 GitHub에 이슈를 등록하여 보고할 수도 있습니다.

Microsoft 365 에이전트 도구 키트

또 다른 최신 옵션은 Microsoft 365 Agents Toolkit을 사용하는 것입니다 . 이 툴킷은 Office 추가 기능을 포함하여 Microsoft 365용 거의 모든 유형의 확장 프로그램을 만들 수 있도록 설계된 도구 모음입니다. 특히 고급 로직을 통합하거나 Microsoft 365 생태계 내에서 지능형 에이전트 기능을 사용하려는 경우에 유용합니다.

이 도구를 사용하면 특정 템플릿과 마법사를 활용하여 기존 Office뿐 아니라 전체 Microsoft 365 환경을 아우르는 보다 폭넓은 관점에서 추가 기능 프로젝트를 구성 할 수 있습니다 . 공식 설명서에는 이 툴킷을 사용하여 추가 기능 프로젝트를 만드는 방법과 다른 서비스 및 워크플로와 통합하는 방법에 대한 자세한 내용이 나와 있습니다.

Office JavaScript API에 대한 액세스

웹 애플리케이션이 실행 중인 Office 문서 또는 메시지와 통신하려면 Microsoft의 공식 CDN에서 제공되는 Office JavaScript 라이브러리(office.js)를 로드해야 합니다.

표준 라이브러리 URL은 다음과 같습니다.
https://appsforoffice.microsoft.com/lib/1/hosted/office.js

플러그인의 웹페이지 중 API를 사용해야 하는 모든 페이지에는 <head> 섹션 안에 다음과 같은 스크립트 태그를 추가해야 합니다.

<head> ... <script src="https://appsforoffice.microsoft.com/lib/1/hosted/office.js" type="text/javascript"></script> </head>

그 시점부터 Office 네임스페이스에 액세스할 수 있으며, 응용 프로그램별 API (Excel, Word 등)와 여러 응용 프로그램에서 공유하는 공통 API를 모두 사용할 수 있습니다. 또한 공식 문서에서는 편집기에서 IntelliSense 와 같은 기능을 활성화하여 더욱 편리한 작업 흐름을 만드는 방법을 설명합니다 .

사용 가능한 API 모델

Office 추가 기능 플랫폼은 서로 보완적인 두 가지 주요 JavaScript API 모델을 제공하며, 이 두 모델은 명확하게 구분되어야 합니다.

• 애플리케이션별 API
• 공통 API

애플리케이션별 API는 특정 애플리케이션의 기본 객체와 상호 작용하도록 설계되었습니다. 예를 들어 Excel API를 사용하면 강력한 형식의 객체를 이용하여 워크시트, 범위, 표, 차트 및 기타 Excel 관련 요소를 작업할 수 있습니다.

이 API 모델은 프로미스를 기반으로 작동하며, 여러 작업을 하나의 Office 애플리케이션 요청으로 묶어 처리할 수 있는 배치 작업 모델을 지원합니다 . 이를 통해 특히 웹 기반 Office에서 성능이 크게 향상됩니다. 이 모델은 Office 2016에 처음 도입되었으며, 새로운 요구 사항 세트가 추가되면서 더욱 확장되었습니다.

반면 공통 API는 대화 상자, 클라이언트 설정 또는 사용자 인터페이스의 특정 부분과 같이 여러 Office 애플리케이션에서 공유되는 기능에 중점을 둡니다. 이 모델은 프로미스 대신 콜백을 기반으로 하며 요청당 하나의 작업만 허용합니다. Office 2013에서 도입되어 하위 호환성을 유지하며, 예를 들어 Outlook, PowerPoint 또는 Project와 기본적인 수준에서 상호 작용하는 데 사용됩니다.

API 요구 사항 세트

JavaScript API 내에서 다양한 기능 그룹은 요구 사항 세트 라고 하는 것으로 구성됩니다 . 각 세트는 이름과 버전을 기준으로 API 멤버 집합을 그룹화하므로 각 Office 클라이언트에서 사용할 수 있는 기능을 매우 정확하게 파악할 수 있습니다.

예를 들어, 다음과 같은 세트를 찾을 수 있습니다.

• 엑셀Api 1.7특정 버전에서 사용할 수 있는 Excel용 특정 API를 그룹화한 것입니다.
• 다이얼로그Api 1.1여러 Office 응용 프로그램에 대한 일반적인 대화 상자 기능을 제공합니다.

추가 기능은 이러한 API 세트를 사용하여 런타임에 애플리케이션이 필요한 API를 지원하는지 확인할 수 있으며, 필요한 API를 사용할 수 없는 경우 동작을 조정하거나 적절한 메시지를 표시할 수 있습니다. 각 API 세트의 구체적인 호환성은 플랫폼( Windows , Mac , 웹, 모바일) , Office 버전 및 애플리케이션(Word, Excel 등) 에 따라 다릅니다 .

Script Lab으로 API 탐색

전체 프로젝트를 구축하지 않고 API를 시험해 보고 싶다면 Microsoft Marketplace에서 무료로 제공되는 추가 기능인 Script Lab을 사용할 수 있습니다.

Script Lab을 사용하면 Excel이나 Word 같은 응용 프로그램 내에서 코드 조각을 직접 테스트하고 문서에 어떤 영향을 미치는지 즉시 확인할 수 있습니다. API를 학습하거나, 간단한 로직을 검증하거나, 실제 추가 기능에 통합하기 전에 빠른 프로토타입을 구축하는 데 이상적입니다.

스크립트 랩에는 바로 실행하거나 이를 기반으로 자신만의 코드를 작성할 수 있는 다양한 사전 제작 예제가 있습니다 . 또한 공식 문서에는 스크립트 랩의 작동 방식을 보여주는 짧은 동영상이 포함되어 있어, 스크립트 랩의 모든 기능을 쉽게 이해할 수 있습니다.

Office 사용자 인터페이스 확장

추가 기능의 장점 중 하나는 단순히 "배경에서 " 코드를 실행하는 데 그치지 않고 Office 인터페이스에 완벽하게 통합되어 필요에 맞게 탭, 단추, 메뉴 및 패널을 추가할 수 있다는 점입니다.

인터페이스를 확장하는 가장 일반적인 방법은 다음과 같습니다.

• 플러그인 명령 리본이나 상황에 맞는 메뉴에 통합되어 있습니다.
• HTML 컨테이너예를 들어 작업창, 콘텐츠 추가 기능, 사용자 지정 대화 상자 등이 있습니다.

추가 기능 명령을 사용하면 Office 리본에 새 탭이나 단추 그룹을 추가하거나 Excel에서 텍스트 또는 개체를 마우스 오른쪽 버튼으로 클릭했을 때 나타나는 상황별 메뉴를 확장할 수 있습니다. 사용자가 이러한 명령 중 하나를 클릭하면 JavaScript 코드를 실행하거나 특정 작업 창을 열거나 대화 상자를 실행할 수 있습니다.

반면 작업 창, 콘텐츠 추가 기능 및 대화 상자는 추가 기능의 인터페이스를 표시하는 HTML 컨테이너입니다. 콘텐츠는 매니페스트에 지정한 웹 페이지에서 제공되며, 이러한 페이지에서 Office API를 사용하여 문서와 상호 작용할 수 있을 뿐만 아니라 일반 웹 사이트에서 수행하는 모든 기능(인증, 외부 API 호출, 데이터 시각화 등)도 사용할 수 있습니다.

Office 추가 기능의 사용자 인터페이스 요소에 대한 설명서에는 사용자 환경을 설계하는 방법 , 권장되는 패턴, 각 컨테이너 유형을 활용하는 방법에 대한 자세한 내용이 나와 있습니다.

이미 설치된 플러그인을 찾아 사용하세요

최종 사용자의 관점에서 볼 때, 추가 기능이 설치되거나 배포된 후에는 Office 내에서 해당 기능을 찾는 것이 매우 간단 하지만, 응용 프로그램에 따라 약간의 차이가 있을 수 있습니다.

1. 우선, 당신은 Office에 로그인 적절한 Microsoft 365 계정을 사용하세요. 이렇게 하려면 Office 응용 프로그램을 열고 오른쪽 상단에서 로그인 옵션을 선택한 후 이메일과 비밀번호를 입력하세요.
2. Word, Excel 또는 PowerPoint 데스크톱 응용 프로그램에서 다음으로 이동할 수 있습니다. 삽입 > 내 추가 기능 해당 애플리케이션에 사용 가능한 추가 기능 목록을 확인하세요.
3. 상자 내부 Office 추가 기능이름으로 추가 기능을 검색할 수 있습니다. 검색 결과가 나타나지 않으면 올바른 계정으로 로그인했는지 확인하고 필요한 경우 클릭하세요. 업데이트 목록을 새로 고치세요.
4. 액세서리를 찾으면 간단히 다음을 수행하십시오. 그것을 더블 클릭 그러면 문서 내에서 인터페이스가 시작되고 표시됩니다.

사용자 계정에 추가 기능을 연결하는 이 동작을 통해 동일한 Microsoft 365 계정을 사용하는 한 다양한 장치 및 애플리케이션에서 추가 기능을 일관되게 사용할 수 있습니다.

다른 오피스 제품군의 애드온 및 확장 기능 관리

여기서는 오피스 추가 기능 플랫폼에 중점을 두지만, 다른 오피스 제품군 및 해당 확장 프로그램 관리 와 비교해 보는 것도 도움이 됩니다 . 기본적인 철학이 유사하기 때문입니다.

COM 추가 기능 및 클래식 Microsoft Office의 추가 기능

Word 2016과 같은 데스크톱 버전에서는 최신 웹 기반 추가 기능 외에도 기존 COM 구성 요소 및 추가 기능을 계속 사용할 수 있습니다 . 이를 관리하려면 파일 > 옵션 으로 이동한 다음 추가 기능 섹션에서 유형별로 그룹화된 목록을 확인하십시오.

목록에서 항목을 선택하면 창 하단에 해당 항목의 세부 정보가 표시됩니다. 대표적인 예로는 FoxitReader PDF Creator 추가 기능이 있는데 , 이는 FoxitReader 설치 시 선택적으로 추가되며 Word 문서에서 PDF를 생성하고 편집할 수 있는 추가 탭이나 버튼을 제공합니다.

이 창 하단에는 드롭다운 메뉴와 ' 이동...' 버튼이 있는 '관리' 영역이 있습니다 . 이 버튼을 사용하여 특정 유형의 확장 프로그램을 활성화, 비활성화 또는 제거할 수 있습니다. 모든 추가 기능에 눈에 보이는 버튼이나 탭이 있는 것은 아니며, 이는 개발자의 설계 방식에 따라 다릅니다.

LibreOffice Calc의 확장 기능

LibreOffice, 특히 Calc에서는 도구 > 확장 관리자 메뉴에서 확장 프로그램을 관리할 수 있습니다 . 이 메뉴에는 설치된 확장 프로그램 목록이 표시되며, 새 확장 프로그램을 추가하거나 기존 확장 프로그램을 업데이트하거나 제거할 수 있는 옵션이 제공됩니다.

일부 확장 프로그램은 작은 노란색 자물쇠 아이콘으로 표시되는데 , 이는 해당 확장 프로그램이 LibreOffice 기본 패키지의 일부이며 제거할 수 없음을 나타냅니다. 새 확장 프로그램을 설치하려면 일반적으로 LibreOffice 공식 확장 프로그램 및 템플릿 페이지 (https://extensions.libreoffice.org/ )를 방문하면 됩니다 . 이 사이트는 대부분 영어로 되어 있지만, 대부분의 개발자가 확장 프로그램을 영어로 게시하므로 부담 없이 이용할 수 있습니다.

Google Docs 문서의 애드온

Google Docs는 인터페이스 자체에 통합된 추가 기능 시스템도 제공합니다 . 문서의 추가 기능 메뉴에서 이미 설치된 추가 기능을 관리하고 Google 데이터베이스 에서 새 추가 기능을 검색할 수 있습니다.

이 시스템을 사용하면 카테고리별 필터링, 각 애드온 설치 사용자 수 확인 , 평점 및 리뷰 확인, 그리고 몇 번의 클릭만으로 바로 설치까지 가능합니다. 통합 스토어 덕분에 외부 개발자 웹사이트를 방문하지 않고도 필요한 애드온을 찾을 수 있어 과정이 훨씬 간편해졌습니다.

장치 기능에 대한 권한 및 액세스

일부 플러그인, 특히 최신 웹 기술을 기반으로 하는 플러그인은 카메라, 위치 정보 또는 마이크와 같은 기기 기능에 대한 접근 권한이 필요할 수 있습니다 . 이러한 경우 브라우저 또는 플랫폼 자체에서 사용자의 동의를 요청하는 대화 상자를 표시합니다.

일반적으로 '허용', '한 번만 허용', '거부' 와 같은 옵션이 표시됩니다.

• 당신이 선택하면 허용추가 기능은 추가 기능을 제거하거나 실행 중인 브라우저의 캐시를 지울 때까지 요청된 리소스에 지속적으로 액세스할 수 있습니다.
• 당신이 선택하면 한 번 허용추가 기능이 실행 중인 탭이나 창을 닫을 때까지 현재 세션 동안에만 액세스가 허용됩니다.
• 당신이 선택하면 거부추가 기능은 액세스할 수 없으며, 다시 액세스가 필요할 때 다른 대화 상자를 통해 다시 권한을 요청합니다.

"허용"을 클릭하여 수락한 권한을 언제든지 취소하려면 추가 기능을 제거하거나 브라우저 캐시를 삭제하여 이전 결정을 삭제하고 새 요청을 해야 합니다.

Office 추가 기능 생태계는 표준 웹 기술, Yeoman, Visual Studio, VS Code 개발 키트와 같은 도구, 그리고 특정 및 공통 모델을 지원하는 요구 사항 세트를 갖춘 JavaScript API를 사용하여 Word, Excel, Outlook 및 기타 Office 애플리케이션을 확장할 수 있는 매우 유연한 프레임워크를 제공합니다. 매니페스트, 프로젝트 구조, 디버깅 옵션, 배포 방법, 권한 및 장치 액세스의 의미를 이해하면 사용자의 일반적인 작업 흐름을 방해하지 않고 일상적인 Office 환경에 원활하게 통합되는 강력한 솔루션을 구축할 수 있습니다.