이 문서에서는 SharePoint Framework (SPFx) 확장 기능을 사용하여 Microsoft SharePoint 사이트에 Zendesk 웹 위젯을 임베드하는 방법에 대해 설명합니다. 다음 단계에 따라 문서 검색 및 상담사와 채팅을 비롯한 위젯의 기능으로 SharePoint 사이트를 강화할 수 있습니다. 이 예를 따르려면 Zendesk와 SharePoint 둘 다에서 관리자여야 합니다. 또한 이 문서에서는 사용자가 SharePoint에 대한 경험이 있다고 가정합니다. SharePoint에 대한 도움말은 SharePoint 도움말 및 학습을 참조하세요.
SharePoint 사이트에 웹 위젯을 추가하려면 다음 단계를 사용하세요.
1단계: 어느 확장 기능을 사용할지 결정한 후 패키징
새 확장 기능을 개발하기로 선택하든 기존 확장 기능을 활용하기로 결정하든 올바르게 확장 기능을 패키징하세요.
- Microsoft 커뮤니티에서 유지 관리하는 GitHub 저장소에서 기존 SPFx 확장 기능을 선택하거나 직접 개발하기로 선택합니다. 이 저장소는 Microsoft 직원들이 개발한 다양한 확장 기능을 호스팅합니다. 직접 확장 기능을 만들고자 하는 경우 튜토리얼과 가이드가 마련되어 있습니다. 이 예에서는 최신 페이지에 대한 스크립트 편집기 웹 파트 확장 기능을 사용합니다.
- 웹 파트의 GitHub 페이지에 있는 안내에 따라 확장 기능을 패키징합니다. SharePoint 페이지에 클라이언트 쪽 웹 파트 배포에서 자세한 패키징 도움말을 확인할 수 있습니다.
패키징이 완료된 후 `.sppkg` 확장자가 있는 파일을 받게 됩니다.
2단계: SharePoint 관리 센터에 확장 기능 업로드
확장 기능을 패키징한 후에는 다음 안내에 따라 SharePoint 사이트에 업로드합니다.
확장 기능을 업로드하려면 다음과 같이 하세요.
- SharePoint 관리 센터에 액세스합니다. SharePoint 사이트 URL에 /admin을 첨부하면 됩니다.
-
앱 관리 페이지로 이동하여 .sppkg 확장자로 패키징할 수 있습니다. 패키지 상태가 사용으로 설정되어 있는지 확인합니다. 업로드 후 이 작업을 수행하라는 메시지가 표시됩니다.
이제 SharePoint 사이트에 확장 기능이 업로드되었습니다. 패키지 업로드에 대한 도움말은 SharePoint 페이지에 클라이언트 쪽 웹 파트 배포를 참조하세요.
3단계: SharePoint 사이트에서 확장 기능 활성화
다음 안내에 따라 사이트 수준에서 확장 기능을 사용 설정합니다.
확장 기능을 사용 설정하려면 다음과 같이 하세요.
- SharePoint 사이트에서 사이트 설정 페이지로 이동합니다.
-
사이트 설정 페이지에서 기어 아이콘을 클릭한 다음 앱 추가를 클릭합니다.
- 앱을 선택하고 추가를 클릭합니다.
내 앱 페이지의 추가된 앱 아래에 이전에 추가한 패키지가 표시됩니다.
4단계: 웹 위젯 임베드
이제 확장 기능이 활성화되었으므로 페이지에 웹 위젯을 임베드할 수 있습니다.
웹 위젯을 임베드하려면 다음과 같이 하세요.
- 웹 위젯을 임베드하려는 SharePoint 페이지를 엽니다.
- 편집을 클릭합니다.
- 페이지 위쪽의 웹 파트 섹션을 클릭한 다음 추가한 확장 기능을 선택합니다.
- 마크업 편집을 클릭한 다음 HTML 코드 편집을 클릭합니다.
- 스크립트 편집기에서 표시된 대로 위젯 스크립트를 추가합니다.
위젯 스크립트 생성에 대한 자세한 내용은 웹사이트에 Zendesk Chat 위젯 추가하기를 참조하세요.
이제 SharePoint 페이지에서 웹 위젯을 사용할 수 있습니다.
자세한 정보
- SPFx 튜토리얼
- SPFx 확장 기능 - 최신 페이지에 대한 스크립트 편집기 웹 파트