Viva Engage 데이터 내보내기 및 관리
Engage 관리자는 네트워크에서 사용자 및 콘텐츠를 관리하기 위해 데이터를 내보내야 하는 경우가 많습니다. 이 문서에서는 사용량, 규정 준수 및 검색을 관리하는 데 사용할 수 있는 다양한 옵션을 설명합니다.
데이터 내보내기
참고
Viva Engage 테넌트 간에 데이터를 마이그레이션하려면 콘텐츠 마이그레이션에 대해 알아봅니다.
| 이 데이터 내보내기 메서드 사용 | 이 목적을 위해 |
|---|---|
| 사용자 및 관리자 목록 내보내기 | 현재 관리자 및 사용자의 상태 식별합니다. 각 사용자에 대해 이메일 주소, 제목, 위치 및 부서를 가져옵니다. |
| 날짜 범위별로 테넌트 데이터 내보내기 | 특정 날짜 범위에 대한 홈 네트워크의 모든 사용자에 대한 테넌트 데이터를 보고 감사합니다. 옵션을 사용하면 외부 네트워크의 첨부 파일 및 데이터를 포함할 수도 있습니다. |
| 한 명의 사용자에 대한 데이터 내보내기 | 단일 사용자와 관련된 모든 데이터를 끌어오기. 이 방법을 사용하여 GDPR 데이터 주체 요청을 준수하기 위해 삭제해야 하는 데이터를 식별합니다. |
| 데이터 내보내기 자동화 | 데이터 내보내기 API를 통해 규정 준수를 위해 되풀이 내보내기를 자동화합니다. |
| API를 사용하여 Engage 파일 내보내기 | 대용량 파일을 내보낼 때 API를 사용합니다. 날짜 범위를 지정하고 외부 네트워크의 파일을 포함할 수 있습니다. 이 메서드는 데이터를 보관하는 데 가장 적합합니다. |
데이터 내보내기 옵션 액세스
Engage 관리 포털의 데이터 내보내기 페이지에서 모든 내보내기 옵션에 액세스합니다.
거버넌스 및 규정 준수 탭을 선택합니다.
데이터 내보내기를 선택합니다.
사용자 및 관리자 목록 내보내기
이 메서드를 사용하여 특정 기간의 데이터를 내보냅니다.
데이터 내보내기 페이지에서 모든 사용자에 대해 데이터 내보내기를 선택합니다.
날짜 범위 및 기타 옵션을 지정합니다.
- 날짜 범위: 데이터를 사용할 날짜 범위를 지정합니다. 현재 날짜가 종료 날짜로 표시됩니다.
- 첨부 파일 포함: 파일 이름 목록을 얻으려면 선택되지 않은 상태로 둡니다. 를 선택하여 모든 첨부 파일의 목록과 파일 폴더를 기본 형식으로 가져옵니다.
- 외부 네트워크 포함: 홈 네트워크에서만 데이터를 가져오기 위해 선택되지 않은 상태로 둡니다. 각 네트워크에 대한 데이터를 별도의 폴더에 가져오려면 선택합니다(폴더 이름은 네트워크 ID임). 전체 네트워크 이름은 Networks.csv에 나열됩니다.
CSV 다운로드를 선택합니다. 파일은 .zip 파일 이름 확장명을 가진 압축 파일로 저장됩니다.
압축 파일을 저장한 위치로 이동하여 압축 파일을 확장합니다. 데이터 내보내기 에는 다음 파일이 포함됩니다.
File 내용 log.txt 내보내기 요약 request.txt 내보내기의 매개 변수 Admins.csv 현재 관리자, 해당 전자 메일 주소 및 해당 역할 Lists
Viva Engage 관리자 유형에 대한 자세한 내용은 Viva Engage 관리자 역할 관리를 참조하세요.Answers.csv ID, messageId, networkId, threadId, voterID, createdAt 타임스탬프 및 업데이트 답변 투표의 타임스탬프 Lists Campaigns.csv 해시태그, 생성 날짜, 상태 등을 포함한 캠페인에 대한 데이터를 제공합니다. scope_type 특성은 공식(네트워크) 캠페인과 커뮤니티(그룹) 캠페인을 구분합니다. scope_id 특성은 커뮤니티 캠페인을 호스트한 네트워크 또는 커뮤니티를 식별합니다. networks.csv 파일 또는 groups.csv 파일에서 네트워크 또는 커뮤니티에 대한 자세한 캠페인 세부 정보를 확인하세요. Networks.csv 홈 네트워크 및 이름, URL, 생성 날짜, 사용자 수, 조정 또는 사용 정책을 포함하는 외부 네트워크에 대한 정보입니다. Users.csv 사용자 데이터를 Lists. 속성은 다음과 같습니다. ID, 이름, 이메일, 직함, 위치, 부서, 사용자 ID, 삭제 상태(삭제를 수행한 사람의 날짜, 이름 및 ID), 가입 날짜, 일시 중단 상태(비활성화를 수행한 사용자의 날짜, 이름 및 ID), 사용자 상태(활성 또는 soft_delete). soft_delete: 보류 중이며, 다른 값이 없는 경우 입니다. suspended_at 함께 deleted_at 값이 없는 경우 일시 중단 (비활성화됨) 또는 deleted_at 값이 함께 포함된 경우 삭제됩니다. 홈 네트워크 도메인과 일치하지 않는 이메일 주소로 게스트를 식별합니다.
api_url 사용자 메타데이터를 제공합니다. 이 필드의 데이터 사용에 대한 자세한 내용은 REST API를 참조하세요.파일 폴더 Viva Engage 저장되고 지정된 기간 동안 생성되거나 수정된 파일을 포함합니다. 파일의 이름은 계정 ID로 지정되며 네이티브 형식입니다. 예를 들어 PowerPoint 프레젠테이션이 127815379.pptx 표시될 수 있습니다.
이 데이터 내보내기에는 다음이 포함되지 않습니다.
- 다음을 포함하여 사용자 설정에서 사용할 수 있는 데이터
- 사용자 프로필
- 사용자가 멤버인 테넌트(네트워크)
- 사용자 계정 활동, 애플리케이션, 알림 및 언어 기본 설정
- 조직도
- 사용자 활동 데이터
- 책갈피가 지정된 메시지
- 그룹 멤버십
- 팔로우하거나 팔로우하는 사용자 또는 팔로우한 문서
- SharePoint에 저장된 파일 첨부 파일
날짜 범위별로 테넌트 데이터 내보내기
이 메서드를 사용하여 Viva Engage 네트워크에 대한 데이터를 내보냅니다.
중요
대규모 네트워크(10,000명 이상의 사용자)에 있고 네트워크 내보내기 작업을 실행할 때 시간 제한 오류가 발생하는 경우 다음을 수행하는 것이 좋습니다. 내보내기할 표준 운영 시간 외 시간을 선택하고 날짜 범위를 1개월 이하로 제한하는 것이 좋습니다.
데이터 내보내기 페이지에서 테넌트 데이터 내보내기를 선택합니다.
날짜 범위 및 기타 옵션을 지정합니다.
- 날짜 범위: 지정된 날짜 범위의 데이터만 포함합니다. 오늘 날짜는 자동으로 종료 날짜로 미리 채워집니다.
- 첨부 파일 포함: 선택하지 않으면 파일 목록만 내보냅니다. 이 옵션을 선택하면 모든 파일이 기본 형식으로 포함된 Files 폴더가 내보내집니다.
- 외부 네트워크 포함: 선택하지 않으면 홈 네트워크의 데이터만 내보내집니다. 이 옵션을 선택하면 각 네트워크에서 별도의 데이터 폴더가 내보내집니다. 각 네트워크는 ID로 식별되며 전체 네트워크 이름은 Networks.csv에 나열됩니다.
CSV 다운로드를 선택합니다. 데이터는 .zip 파일로 내보내집니다.
압축 파일을 저장한 위치로 이동하여 압축 파일을 확장합니다.
둘 이상의 네트워크를 내보낸 경우 각 네트워크에 대해 별도의 폴더가 만들어집니다.
데이터 내보내기 에는 다음 파일이 포함됩니다.
| File | 내용 |
|---|---|
| log.txt | 내보내기 요약 |
| request.txt | 내보내기의 매개 변수 |
| Admins.csv | 이름, 전자 메일 및 관리자 유형을 포함하여 선택한 각 네트워크에 대한 관리자 목록 |
| EngageTopicMigrationLog.csv | Viva Topics 또는 경량 topics Viva Engage 마이그레이션되거나 가져오지 않은 topics 목록입니다. 속성은 다음과 같습니다. Cortex_topic_ID, migrated_at, migrated_action |
| EngageTopicApplicationMigrationLog.csv | Viva Topics 또는 경량 topics Viva Engage 가져오지 않은 토픽 애플리케이션 목록입니다. 속성은 다음과 같습니다. Cortex_topic_id, target_id, target_type, migrated_at, migration_action |
| Groups.csv | 지정된 날짜 범위 동안 생성되거나 수정된 모든 그룹입니다. 속성에는 계정 ID, 이름, 설명, 개인 정보 상태, 그룹이 내부 또는 외부인지 여부, 그룹에 대한 링크, 그룹을 만든 사람, 생성 날짜 및 업데이트된 날짜가 포함됩니다. |
| LikedMessagesHistory.csv | 사용자의 메시지에 대한 모든 반응 활동을 Lists. 기록을 포함하여 반응 활동에 포함된 속성: - 선택한 반응(예: 좋아요, 사랑 또는 감사) - 반응 동작(추가, 제거) - 반응 타임스탬프 - 반응한 사용자의 사용자 ID입니다. |
| MutedThreads.csv | 네트워크의 모든 사용자에 대해 음소거된 모든 메시지를 Lists. 속성에는 다음이 포함됩니다. 네트워크 ID, 스레드 ID, 사용자 ID로 업데이트된 가 음소거되고, 생성되고, 업데이트됩니다. |
| Messages.csv | 파일에서 만든 메시지(지능형 가져오기 사용)를 포함하여 지정된 날짜 범위 동안 전송되거나 수정된 모든 메시지입니다. 속성에는 메시지 ID, 스레드 ID, 그룹 ID, 그룹 이름, GDPR 삭제 URL(gdpr_delete_url), 개인 정보 상태, 보낸 사람 ID, 이름 및 전자 메일, 메시지의 전체 본문, 첨부 파일, 만들기 및 삭제 정보 및 초안 상태가 포함됩니다. |
| MessageThreadsOutbound.csv | 아웃 바운드 메시지에서 외부 참가자의 ID가 포함되어 있습니다. |
| MessageVersions.csv | 편집된 메시지에 대한 ID 및 수정 정보가 포함되어 있습니다. |
| Networks.csv | 내보내기에 포함된 홈 네트워크 및 모든 외부 네트워크를 나열합니다. |
| Pages.csv | 지정된 날짜 범위 동안 만들거나 수정한 페이지에 대한 ID, 날짜 및 페이지 소유자를 Lists. |
| Topics.csv | Lists 지정된 날짜 범위 동안 만든 아티클에 대한 만들기 정보 및 링크를 참조하세요. |
| Users.csv | Lists 지정된 날짜 범위 동안 가입했거나 삭제되거나 일시 중단된 모든 사용자에 대한 데이터입니다.
속성에는 이메일 주소, 직함, 위치, 부서, 사용자에 대한 링크 및 사용자의 현재 상태(활성 또는 soft_delete)에 대한 정보가 포함됩니다. soft_delete: 보류 중이며, 다른 값이 없는 경우 입니다. suspended_at 함께 deleted_at 값이 없는 경우 일시 중단 (비활성화됨) 또는 deleted_at 값이 함께 포함된 경우 삭제됩니다. 홈 네트워크 도메인과 일치하지 않는 이메일 주소로 게스트를 식별합니다. api_url 사용자 메타데이터를 제공합니다. 이 필드의 데이터 사용에 대한 자세한 내용은 REST API를 참조하세요. |
| VivaTopicApplications.csv | 게시물에 적용된 항목의 경우 지정된 날짜 범위에 대한 각 애플리케이션에 대한 정보를 나열합니다(있는 경우). |
| VivaTopicCurationStateLogs.csv | Viva 답변에만 적용됩니다. 주요 topics 대한 큐레이션 상태 로그를 포함합니다. cortex_topic_id VivaTopics.csv 콘텐츠와 함께 사용하여 토픽과 관련된 다른 정보를 검색할 수 있습니다. |
| VivaTopics.csv | 지정한 날짜 범위에 대해 만들거나 업데이트한 항목이 표시됩니다(있는 경우). ID는 Viva 항목 식별자를 참조합니다. api_url 토픽 메타데이터를 가져오는 데 사용되는 URL입니다. |
| 파일 폴더 | Viva Engage 저장되고 지정된 기간 동안 생성되거나 수정된 파일을 포함합니다. 파일의 이름은 계정 ID로 지정되며 네이티브 형식입니다. 예를 들어 PowerPoint 프레젠테이션이 127815379.pptx 표시될 수 있습니다. |
이 데이터 내보내기에는 다음이 포함되지 않습니다.
- 다음을 포함하여 사용자 설정에서 사용할 수 있는 데이터
- 사용자 프로필
- 사용자가 멤버인 테넌트(네트워크)
- 사용자 계정 활동, 애플리케이션, 알림 및 언어 기본 설정
- 조직도
- 사용자 활동 데이터
- 책갈피가 지정된 메시지
- 그룹 멤버십
- 팔로우하거나 팔로우하는 사용자 또는 팔로우한 topics
- SharePoint에 저장된 파일 첨부 파일
한 명의 사용자에 대한 데이터 내보내기
사용자가 여러 네트워크의 구성원인 경우 각 네트워크에서 데이터를 별도로 내보내야 합니다.
데이터 내보내기 페이지에서 단일 사용자에 대한 데이터 내보내기를 선택합니다.
사용자의 이름을 입력하고 사용자를 선택한 다음 내보내기를 선택합니다.
사용자 데이터는 이러한 파일이 포함된 .zip 파일로 내보냅니다.
사용자의 계정 활동 데이터가 준비되면 데이터에 대한 링크가 있는 메시지가 Viva Engage 받은 편지함에 표시됩니다.열려는 링크를 선택합니다.
데이터 내보내기 에는 다음 파일이 포함됩니다.
| File | 내용 |
|---|---|
| log.txt | 각 .csv 파일의 항목 수를 요약하고 내보내기 중에 발생하는 오류를 나열합니다. |
| request.txt | 내보내기에서 사용되는 매개 변수 |
| Broadcast.csv | 사용자가 라이브 이벤트 비디오를 게시한 경우 포함됩니다. 네트워크 ID, 그룹 ID 및 이름, 제목, 설명, 비디오 링크 및 비디오에 대한 추가 정보를 Lists. 비디오 콘텐츠는 내보내기에서 제외됩니다. 비디오는 녹화를 시작한 사용자의 OneDrive에 저장됩니다. 메타데이터를 편집하거나 비디오를 삭제하려면 Microsoft Stream 관리 모드에서 비디오를 열 수 있습니다. 자세한 내용은 MICROSOFT STREAM 관리 기능 및 GDPR에 대한 Microsoft 365 데이터 주체 요청을 참조하세요. |
| Files.csv | Viva Engage 사용자가 추가하거나 수정한 모든 파일을 Lists.
속성에는 계정 ID, 파일 형식, 이름, 설명 및 파일에 대한 경로와 게시된 그룹을 포함한 메타데이터가 포함됩니다. storage_path 열에는 파일이 Viva Engage 또는 SharePoint에 저장되어 있는지 여부가 표시됩니다. Viva Engage 저장된 파일은 기본 형식으로 zip 파일의 Files 폴더로 내보냅니다. SharePoint에 저장된 파일은 내보내지지 않습니다. Files 폴더에서 파일을 식별하려면 file_ID 및 경로 열을 사용합니다. SharePoint에 저장된 파일을 다운로드하려면 download_url 열을 사용합니다. SharePoint 파일에 Microsoft Entra 토큰이 없는 경우 Microsoft Entra 앱을 만들어야 합니다. 또는 Microsoft 365에서 콘텐츠 검색을 사용하여 특정 날짜 범위에 대해 SharePoint에 저장된 파일을 찾습니다. 항상 Viva Engage 저장된 파일을 삭제하여 SharePoint 및 Viva Engage 파일과 메타데이터를 모두 지웁 수 있습니다. SharePoint에서 파일을 삭제하면 메타데이터가 Viva Engage 유지됩니다. |
| Groups.csv | 사용자가 만들거나 수정한 모든 그룹을 Lists.
속성에는 그룹 ID, 이름, 설명, 개인 정보 상태, 내부 또는 외부, 생성 날짜, 업데이트된 날짜 및 그룹에 대한 링크가 포함됩니다. 추가 정보에는 사용자가 투표한 총 설문 조사 수와 사용자가 만든 설문 조사가 포함됩니다. |
| LikedMessagesHistory.csv | 사용자의 메시지에 대한 모든 반응 활동을 Lists. 기록을 포함하여 반응 활동에 포함된 속성: - 선택한 반응(예: 좋아요, 사랑 또는 감사) - 반응 동작(추가, 제거) - 반응 타임스탬프 - 반응한 사용자의 사용자 ID입니다. |
| MutedThreads.csv | 사용자가 네트워크에 대해 음소거한 모든 메시지를 Lists. 속성에는 다음이 포함됩니다. 네트워크 ID, 스레드 ID, 사용자 ID로 업데이트된 가 음소거되고, 생성되고, 업데이트됩니다. |
| Messages.csv | 파일에서 생성된 메시지(지능형 가져오기 사용)를 포함하여 사용자가 보내거나 수정한 모든 메시지를 Lists.
속성에는 메시지 ID, 스레드 ID, 그룹 ID, 그룹 이름, 개인 정보 상태, 보낸 사람 ID, 이름 및 전자 메일, 메시지의 전체 본문, 첨부 파일, 만들기 및 삭제 정보 및 초안 상태가 포함됩니다. 또한 사용자가 만든 설문 조사 목록과 게시된 공지 사항의 제목도 제공합니다. 첨부 파일과 함께 이 OGO(Open Graph Object) 정보는 ID, URL, 제목 및 설명으로 내보내집니다. |
| BestReplyMessages.csv | 사용자가 가장 적합한 회신으로 표시된 모든 메시지를 Lists. 속성에는 메시지 ID, 스레드 ID, 그룹 ID, 그룹 이름, 개인 정보 상태, 보낸 사람 ID, 이름 및 전자 메일 주소, 메시지의 전체 본문, 첨부 파일 ID, 만들기 및 삭제 정보가 포함됩니다. |
| Topics.csv | 생성 정보 및 항목에 대한 링크를 포함하여 지정된 날짜 범위 동안 사용자가 만든 모든 topics Lists. |
| VivaTopicApplications.csv | 게시물에 적용된 항목의 경우 지정된 날짜 범위에 대한 각 애플리케이션에 대한 정보를 나열합니다(있는 경우). |
| VivaTopicCurationStateLogs.csv | Viva 답변에만 적용됩니다. 주요 topics 대한 큐레이션 상태 로그를 포함합니다. cortex_topic_id VivaTopics.csv 콘텐츠와 함께 사용하여 토픽과 관련된 다른 정보를 검색할 수 있습니다. |
| VivaTopics.csv | 지정한 날짜 범위에 대해 만들거나 업데이트한 항목이 표시됩니다(있는 경우). ID는 Viva 항목 식별자를 참조합니다. api_url 토픽 메타데이터를 가져오는 데 사용되는 URL입니다. |
| 파일 폴더 | 지정된 기간 동안 사용자가 만들거나 수정한 Viva Engage 저장된 파일을 포함합니다. SharePoint에 저장된 Engage 파일은 제외됩니다. 파일은 네이티브 형식이며 계정 ID로 이름이 지정됩니다. 예를 들어 PowerPoint 프레젠테이션이 127815379.pptx 표시될 수 있습니다. |
이 데이터 내보내기에는 다음이 포함되지 않습니다.
- 책갈피가 지정된 메시지
- 그룹 멤버 자격 또는 조직도
- 팔로우한 사용자, 다음 사용자, 다음 topics
- Viva Engage(또는 Microsoft Teams 또는 Microsoft Outlook)의 사용자 알림
- 애플리케이션 및 언어 설정
참고
사용자의 스킨 톤 선택에 대한 데이터는 내보낸 데이터에서 제외됩니다. 그러나 사용자의 반응을 포함하는 Viva Engage 모든 게시물에서 스킨 톤 선택에 액세스할 수 있습니다. 특정 게시물 또는 댓글에 대한 그룹화된 모달 대화 상자를 열고 목록에서 사용자의 스킨 톤 기본 설정을 확인합니다.
PowerShell을 사용하여 Viva Engage 만든 topics 내보내기
PowerShell을 사용하여 Viva Engage 사용자가 만든 topics(Lite Topics라고도 함)를 .csv 파일로 내보낼 수 있습니다. Topics Viva Engage 통합을 사용하도록 설정하기 전에 만든 것을 포함합니다. 자세한 내용은 PowerShell을 사용하여 Viva Engage 만든 topics 내보내기 를 참조하세요.
데이터 내보내기 문제 해결
.zip 파일이 손상되어 압축을 풀 수 없는 경우 다시 시도합니다. 파일이 계속 확장되지 않으면 지원에 문의하세요.
log.txt 파일에 한 가지 데이터 범주에 대한 내보내기 오류가 표시되면 다시 시도합니다. 여전히 오류가 있는 경우 지원에 문의하세요.
데이터 내보내기 자동화
자동 되풀이 내보내기를 설정하려면 API를 사용합니다. 자세한 내용은 데이터 내보내기 API를 참조하세요.
API를 사용하여 대량의 파일 내보내기
확인된 관리자는 데이터 내보내기 API를 사용하여 Viva Engage 스토리지의 파일을 비동기적으로 보관하고 내보낼 수 있습니다. 이 API는 Viva Engage 대용량 파일을 내보내기 위한 것입니다. 자세한 내용은 데이터 내보내기 API를 참조하세요.