Microsoft 365에서 조직 데이터 가져오기 및 사용
조직 데이터는 관리자가 Microsoft 365의 조직 데이터 기능을 사용하여 업로드하는 직원 데이터를 나타냅니다. Microsoft 365의 조직 데이터는 업로드된 데이터를 기존 Microsoft 365 데이터와 결합하여 Microsoft 365 애플리케이션의 특정 기능을 지원합니다. 또한 이 기능은 현재 organization 외부 시스템(예: 인적 자본 관리 시스템)에 있는 조직 데이터를 수집하여 Microsoft 365 사용자 프로필 데이터를 개선하는 데 도움이 됩니다. 이는 누락되거나 부실한 사용자 프로필 데이터와 관련된 간격을 채울 수 있으며 Microsoft 365 및 Microsoft Viva에서 더 풍부한 환경을 사용할 수 있습니다.
Microsoft 365 사용자 프로필 데이터는 사용자의 계정과 연결된 정보를 참조하며 Microsoft 365 사용자 프로필에 저장됩니다. 이 정보에는 이메일 주소, 전화번호, 직함 및 기타 설명 정보가 포함됩니다.
Microsoft 365 사용자 프로필 데이터는 기본 설정인 Microsoft Entra ID(이전의 Azure Active Directory) 또는 업로드하는 .csv 파일을 통한 Microsoft 365의 조직 데이터라는 두 기본 원본에서 제공됩니다. Microsoft Entra 스키마 및 Microsoft 365 사용자 프로필의 속성은 .csv 파일의 열 이름과 일치하며 Microsoft 365의 조직 데이터에서 특성이라고 합니다.
데이터 특성
.csv 파일을 업로드하는 경우 각 직원에 대해 하나 이상의 필수 특성(Microsoft_PersonEmail)을 포함해야 합니다. 조직 데이터 .csv 파일을 설정하고 구성하는 방법을 알아보려면 조직 데이터 준비 및 가져오기를 참조하세요.
다음과 같은 선택적 특성을 포함할 수도 있습니다. (괄호 안의 값은 Microsoft 365 사용자 프로필 스키마의 해당 속성 이름입니다.)
Microsoft 365 특성의 조직 데이터가 Microsoft 365 사용자 프로필 데이터에 매핑되는 방법에 대한 자세한 내용은 특성 참조 및 속성 매핑 에 대한 특성을 참조하세요.
- 이름
- Microsoft_FirstName(첫 번째)
- Microsoft_LastName(마지막)
- Microsoft_DisplayName(displayName)
- 직책
- 자세한 정보
- Microsoft_JobTitle(jobTitle)
- Microsoft_JobDiscipline(역할)
- Microsoft_LevelDesignation(수준)
- Microsoft_Layer(레이어)
- Company
- Microsoft_Company(displayName)
- Microsoft_Organization (부서)
- Microsoft_CompanyOfficeLocation(officeLocation)
- 주소
- Microsoft_CompanyPostOfficeBox(postOfficeBox)
- Microsoft_CompanyOfficeStreet(거리)
- Microsoft_CompanyOfficeCity(도시)
- Microsoft_CompanyOfficeState(주)
- Microsoft_CompanyOfficeCountryOrRegion(countryOrRegion)
- Microsoft_CompanyOfficePostalCode(postalCode)
- 주소
- Company
- 자세한 정보
- Manager
- Microsoft_ManagerEmail(userId)
중요
- Microsoft 365 사용자 프로필에서 Microsoft Entra 데이터가 Microsoft 365의 조직 데이터보다 우선합니다. 서비스에서 Microsoft 365 사용자 프로필을 쿼리할 때 조직 데이터와 단일 특성에 대한 Microsoft Entra 데이터가 모두 있는 경우 Microsoft Entra 값이 사용됩니다.
- 세 가지 이름 관련 특성(Microsoft_FirstName, Microsoft_LastName 및 Microsoft_DisplayName)은 Microsoft 365 사용자 프로필에서 그룹으로 처리되므로 입력 .csv 파일에 값이 있는 경우 다른 두 특성에도 값이 있어야 합니다. 그렇지 않으면 지정된 값이 Microsoft 365 사용자 프로필에 저장되지 않습니다.
조직 데이터 준비 및 가져오기
조직 데이터를 업로드하기 전에 다음을 수행해야 합니다.
1단계 - .csv 템플릿 다운로드
- 전역 관리 권한이 있는 사용자로 Microsoft 365 관리 센터에 로그인합니다.
- Microsoft 365의 조직 데이터 페이지(마이그레이션 및 가져오기 설정>에서)에서 시작을 선택합니다.
- CSV 템플릿 다운로드를 선택합니다.
참고
조직 데이터 내보내기에서 설명한 대로 HR 소프트웨어와 같은 다른 시스템에서 내보낸 조직 데이터를 시작점으로 사용할 수도 있습니다.
2단계 - 조직 데이터 구조화
이제 .csv 파일 시작 지점이 있으므로 Microsoft 365에서 사용하려는 조직 데이터를 추가합니다. 파일을 SharePoint에 저장합니다.
조직 데이터 파일에 추가할 수 있는 특성에는 필수, 예약된 선택 사항 및 사용자 지정의 세 가지 유형이 있습니다. 특성은 파일의 순서에 따라 다를 수 있습니다. 그러나 필수 및 예약된 특성의 이름은 새 사용자 지정 특성의 이름으로 사용할 수 없습니다.
- 필수 - 기본적으로 필요한 유일한 특성은 이메일 주소입니다.
- 예약 - 특성은 현재 데이터를 계산하고, 필터링하고, 그룹화하는 데 사용되는 특성에 대한 예약 열 헤더입니다.
- 사용자 지정 - 사용자 지정 특성은 데이터 필터링 및 그룹화에 사용할 다른 특성입니다. 이러한 특성을 업로드할 때 분석가는 쿼리를 작성할 때 이를 사용할 수 있습니다. 사용자 지정 특성을 업로드하는 방법을 알아보려면 조직 데이터 업로드(첫 번째 업로드)를 참조하세요.
모든 날짜에 MM/DD/YYYY 형식을 사용합니다. 모든 숫자 필드는 "숫자" 형식이어야 하며 쉼표 또는 달러 기호를 포함할 수 없습니다.
참고
시스템에서 허용되는 총 특성의 최대 수는 필수 특성을 포함하는 105개입니다.
샘플 데이터 파일
다음은 유효한 .csv 파일의 예제 코드 조각입니다.
Microsoft_PersonEmail,Microsoft_ManagerEmail,Microsoft_LevelDesignation,Microsoft_Organization,Microsoft_Layer,Microsoft_CompanyOfficeCity
Emp1@contoso.com,Mgr1@contoso.com,Junior IC,Sales,8,Seattle
Emp2@contoso.com,Mgr1@contoso.com,Junior IC,Sales,8,Seattle
Emp3@contoso.com,Mgr2@contoso.com,Manager,Sales,7,Seattle
Emp4@contoso.com,Mgr3@contoso.com,Support,Sales,9,New York
Emp5@contoso.com,Mgr3@contoso.com,Support,Sales,9,New York
Emp6@contoso.com,Mgr3@contoso.com,Support,Sales,9,New York
특성에 대한 자세한 내용은 특성 참조를 참조하세요.
3단계 - 처음으로 조직 데이터 가져오기
데이터를 사용하여 .csv 파일을 만든 후 다음 단계는 SharePoint에 데이터를 저장한 다음 Viva로 가져오는 것입니다.
SharePoint에 .csv 파일 업로드
다음 단계를 사용하여 SharePoint에 데이터를 업로드합니다. SharePoint 사이트에 올바른 권한이 있고 데이터에 액세스할 수 있어야 하는 권한만 사이트에 액세스할 수 있는지 확인합니다.
- SharePoint 사이트 라이브러리를 엽니다.
- 업로드를 선택한 다음 파일을 선택합니다.
- .csv 파일을 저장한 위치로 이동한 다음 열기를 선택합니다.
끌어서 놓기를 사용하여 파일을 업로드할 수도 있습니다.
데이터를 Viva로 가져오기 전에 SharePoint의 파일 경로(https:// domain.sharepoint.com/sites/sitename/Documents/foldername/filename.csv 형식)가 필요합니다. 다음 단계를 사용하여 파일의 경로를 가져옵니다.
- 파일 옆에 있는 타원(...)을 선택한 다음 세부 정보를 선택합니다.
- 경로 값을 찾은 다음 복사 아이콘을 선택합니다.
참고
파일의 경로를 얻으려면 다음 단계를 따라야 합니다. SharePoint에서 .csv 파일을 볼 때 브라우저의 URL 필드에 표시되는 것과는 다른 경로입니다.
Microsoft 365로 데이터 가져오기
이제 데이터를 가져올 준비가 되었습니다.
- 전역 관리 권한이 있는 사용자로 Microsoft 365 관리 센터에 로그인합니다.
- Microsoft 365의 조직 데이터 페이지(마이그레이션 및 가져오기 설정>에서)에서 시작을 선택합니다.
- SharePoint에서 데이터 가져오기 페이지에서 .csv 파일을 저장한 SharePoint 위치를 입력합니다. 업로드 단계가 끝날 때 위치를 복사한 경우 여기에 붙여넣습니다.
- 여기에서 업로드하는 데이터가 Microsoft Graph를 통해 데이터에 대한 액세스 권한을 부여한 비 Microsoft 서비스뿐만 아니라 Viva 및 Microsoft 365에서 처리될 수 있음을 이해했는지 확인합니다. 다음을 선택합니다.
- 업로드에 대한 세부 정보를 검토한 다음 유효성 검사 시작을 선택합니다.
조직 데이터는 Viva 및 Microsoft 365 서비스에서 사용하기 위한 요구 사항에 대해 유효성을 검사합니다. 최대 24시간이 걸릴 수 있습니다. 관리 센터의 조직 데이터 페이지에서 유효성 검사 상태를 검사할 수 있습니다. 유효성 검사가 완료되면 Viva 및 Microsoft 365에서 데이터를 사용하고 관리한다는 메시지가 표시됩니다.
각 최종 사용자의 조직 데이터는 해당 최종 사용자의 사서함에 저장되며 Exchange Online 대한 Data Residency 설명된 대로 Exchange Online 대한 데이터 보존 규칙을 준수합니다.
4단계 - 데이터 업데이트 또는 기타 변경
전역 관리자만 Microsoft 365 사용자 프로필에 저장된 조직 데이터를 업데이트하거나 삭제할 수 있습니다.
최종 사용자의 조직 데이터를 업데이트하거나 삭제하려면 데이터를 업데이트하거나 삭제하려는 사용자만 포함하는 새 .csv 파일을 만들고 업로드합니다.
- 값을 업데이트하려면 업데이트하려는 모든 특성을 포함합니다. 변경하려는 특성에 대해 다른 값을 제공합니다. 특성을 포함하지만 값을 제공하지 않지만 빈 문자열로 설정 하지 않으면 Microsoft 365 사용자 프로필의 현재 값이 사용됩니다(업데이트되지 않음).
- 값을 삭제하려면 두 개의 작은따옴표('')를 사용하여 특성 값을 빈 문자열로 설정합니다. ( Microsoft_Layer 특성 "-1"을 설정합니다. 사용자의 모든 데이터를 삭제하려면 모든 특성에 대해 빈 문자열 또는 정수 값을 입력합니다.
참고
Excel을 사용하여 .csv 파일을 편집하는 경우 두 개의 작은따옴표('')가 아닌 세 개의 작은따옴표('')를 사용합니다. Excel에서는 작은따옴표(')를 이스케이프 문자로 표시합니다.
새 조직 데이터를 업로드한 후 영향을 받는 각 최종 사용자의 이전 데이터는 30일 동안 삭제됩니다.
Microsoft 365의 조직 데이터에 대한 데이터 사용량, 보존 및 관리 정보
다음 정보를 검토하여 조직 데이터를 사용, 저장 및 삭제하는 방법을 이해합니다.
Viva Insights 업로드된 데이터
전역 관리자가 Microsoft 365의 조직 데이터 기능과 Viva Insights 데이터를 공유하는 데 동의하는 경우 다음 데이터가 공유됩니다.
- PersonId
- ManagerId
- 조직
- LevelDesignation
- FunctionType
- 층
- 위치
- RoleStart 데이터
다음 데이터는 조직 데이터 기능에서 업로드되지만 Insights에서 사용할 수 없습니다.
- Microsoft_FirstName
- Microsoft_LastName
- Microsoft_DisplayName
- Microsoft_JobTitle
- Microsoft_RoleEndDate
- Microsoft_City
- Microsoft_CountryOrRegion
- Microsoft_PostalCode
- Microsoft_PostOfficeBox
데이터 사용량
업로드하는 조직 데이터는 Viva, Microsoft 365 서비스 및 Microsoft Graph API 통해 액세스 권한이 부여된 비 Microsoft 서비스에서 사용할 수 있습니다. 이 데이터는 조직 내에서 공개적으로 사용할 수 있는 것으로 처리되므로 조직의 최종 사용자에게 표시될 수 있습니다. 이 데이터는 테넌트 간 공동 작업 시나리오, Microsoft 365 Copilot 및 기계 학습 모델 학습에도 사용될 수 있습니다.
Microsoft 365 사용자 프로필에서 Microsoft Entra 데이터는 기본적으로 Microsoft 365의 조직 데이터보다 우선적으로 적용됩니다. 서비스에서 Microsoft 365 사용자 프로필을 쿼리할 때 조직 데이터와 단일 특성에 대한 Microsoft Entra 데이터가 모두 있는 경우 Microsoft Entra 값이 반환됩니다. 예를 들어 지정된 최종 사용자에게는 Microsoft Entra ID의 jobTitle 속성으로 "소프트웨어 엔지니어"가 있습니다. 조직의 전역 관리자는 Microsoft 365 기능의 조직 데이터를 사용하여 동일한 최종 사용자에 대한 Microsoft_JobTitle 특성에 대해 "선임 소프트웨어 엔지니어" 값을 업로드합니다. 업로드 후 두 값은 모두 최종 사용자의 Microsoft 365 사용자 프로필에 저장됩니다. Microsoft 365의 프로필 카드와 같은 환경이 Microsoft 365 사용자 프로필을 쿼리하여 해당 최종 사용자의 jobTitle 속성을 가져오는 경우 "소프트웨어 엔지니어"가 반환됩니다("수석 소프트웨어 엔지니어" 대신).
Microsoft 365 사용자 프로필에서 조직 데이터의 값을 사용하려면 에 요청을 orgdatainm365support@microsoft.com보내 Microsoft에 문의하세요. "테넌트용 Microsoft 365 사용자 프로필 [이름] [테넌트 ID]에서 Microsoft Entra 데이터보다 조직 데이터 우선 순위를 부여하도록 요청"이라는 제목 줄을 포함합니다. 이 변경 내용이 적용되는 데 최대 4일이 걸릴 수 있습니다.
나중에 기본 동작(Microsoft Entra 데이터가 우선 순위가 지정된 위치)으로 다시 전환하려면 "테넌트용 Microsoft 365 사용자 프로필 [이름] [테넌트 ID]의 조직 데이터보다 Microsoft Entra 데이터 우선 순위를 부여하도록 요청"이라는 제목 줄을 사용하여 Microsoft에 다시 문의하세요. 이 변경은 최대 4일이 걸립니다.
Microsoft 365 사용자 프로필의 데이터가 최신 상태로 정확하게 유지되도록 하려면 새로 고친 조직 데이터를 정기적으로 업로드하는 것이 좋습니다(예: 매주). 이렇게 하면 organization 인적 자본 관리 시스템의 데이터와 비교할 때 사용자 프로필의 데이터가 부실해지는 것을 방지할 수 있습니다.
업로드하는 데이터가 특성 참조에 나열된 특성 이름 및 설명과 일치하는지 확인합니다. 또한 중요한 개인 데이터를 업로드하지 않습니다.
데이터 삭제
사용자 데이터 삭제에 대한 자세한 내용은 조직 데이터 업데이트 또는 기타 변경을 참조하세요. 업데이트가 처리된 후 연결된 사용자 데이터는 30일 이내에 삭제됩니다.
테넌트에서 Microsoft 365 라이선스가 제거되거나 Microsoft 365 관리 센터 동의가 제거되면 30일 이내에 모든 데이터 아티팩트가 제거됩니다.
데이터 보존
조직 데이터는 최종 사용자가 활성 상태이고 유효한 라이선스가 있고 최종 사용자 또는 전역 관리자가 삭제 요청을 하지 않은 한 저장됩니다.
데이터 보존
조직 데이터를 업로드하면 .csv 파일이 SharePoint Online 사이트에 저장되고 각 최종 사용자의 조직 데이터 특성이 Microsoft 365 사용자 프로필에 대처되고 사용자의 Exchange Online 사서함에 저장됩니다. SharePoint Online 및 Exchange Online 대한 데이터 보존 정보는 SharePoint Online에 대한 Data Residency 및 Exchange Online Data Residency 참조하세요.
데이터 주체 요청 관리
데이터 주체 요청 또는 DSR은 데이터 주체(최종 사용자)가 컨트롤러에 개인 데이터에 대한 작업을 수행하도록 공식적으로 요청하는 것입니다. 최종 사용자에게 어떤 데이터 주체 권한이 있는지 이해하려면 GDPR 및 CCPA에서 Office 365 데이터 주체 요청을 참조하세요.
다음 정보를 사용하여 최종 사용자의 DSR을 처리합니다.
- 액세스 및 내보내기 – 최종 사용자는 프로필 카드 데이터 내보내기 기능을 사용하여 전역 관리자가 업로드하고 Microsoft 365 사용자 프로필에 저장된 조직 데이터에 액세스하고 내보낼 수 있습니다. 프로필 카드에서 데이터 내보내기를 참조하세요.
- 편집 – 조직 데이터 업데이트 또는 기타 변경 내용을 참조하세요.
- 삭제 – 조직 데이터 및 데이터 삭제에 대한 업데이트 또는 기타 변경 내용을 참조 하세요.
특성 참조
다음 표에서는 Microsoft 365 특성의 조직 데이터에 대한 자세한 내용을 제공합니다.
참고
Microsoft_LevelDesignation 및 Microsoft_Layer 특성에는 Microsoft Entra 해당 속성이 없습니다. 이 때문에 Microsoft 365 사용자 프로필에 이러한 값을 추가하는 유일한 방법은 Microsoft 365의 조직 데이터 기능을 사용하는 것입니다.
| # | 특성 | 설명 | 데이터 형식 | 예제 |
|---|---|---|---|---|
| 1 | Microsoft_PersonEmail | 직원 레코드의 고유 식별자 - 직원의 이메일 주소입니다. | 전자 메일 | person.name@xyz.com |
| 2 | Microsoft_ManagerEmail | 직원의 관리자에 대한 고유 식별자 - 직원의 관리자 이메일 주소입니다. | 전자 메일 | manager.name@xyz.com |
| 3 | Microsoft_Organization | 직원이 속한 내부 조직 또는 부서 이름입니다. | String | 재무 계획 및 분석 |
| 4 | Microsoft_LevelDesignation | 조직 내 직원의 경험, 관리 수준 또는 연공서열을 나타내는 수준입니다. 이는 회사에서 사용하는 공개 수준 지정입니다. | String | 이사 |
| 5 | Microsoft_JobDiscipline | 직원이 속한 분야입니다. 실행 가능한 인사이트를 더 많이 사용하려면 고유한 작업 분야를 너무 적거나 너무 많이 사용하지 않도록 합니다. 이것은 공공 직업 분야입니다. | String | 재무 관리 |
| 6 | Microsoft_Layer | 조직 계층 구조 내에서 직원의 위치로, 조직의 최고 지도자와의 거리로 표현됩니다. 예를 들어 CEO는 계층 0에 있습니다. 고유 계층을 너무 적거나 너무 많이 사용하지 않도록 합니다. 회사에서 공개적으로 사용할 수 있는 계층입니다. | 정수 | 2 |
| 7 | Microsoft_FirstName | 최종 사용자의 이름입니다. | String | Alexa |
| 8 | Microsoft_LastName | 최종 사용자의 성입니다. | String | Smith |
| 9 | Microsoft_DisplayName | 표시할 직원의 기본 이름입니다. 직원이 나열하도록 선택한 공개 표시 이름입니다. | String | Alexa Smith |
| 10 | Microsoft_JobTitle | 직원의 공개 직급입니다. | String | 소프트웨어 엔지니어 |
| 11 | Microsoft_CompanyOfficeLocation | 직원의 회사 사무실 위치입니다. 건물 번호, 바닥 또는 방과 같은 위치 코드입니다. 직원의 홈 오피스 또는 개인 주소가 되어서는 안 됩니다. | String | 2N |
| 12 | Microsoft_CompanyPostOfficeBox | PostOfficeBox 매개 변수는 사용자의 사서함 번호를 지정합니다. 공개적으로 사용 가능한 회사 사무실 사서함 번호입니다. | String | 사서함 12 |
| 13 | Microsoft_CompanyOfficeStreet | 거리. 공개적으로 사용 가능한 회사 사무실 주소입니다. | String | NE 12번가 |
| 14 | Microsoft_CompanyOfficeCity | 사용자가 관련된 회사 사무실의 도시입니다. 공개적으로 사용 가능한 사무실 주소 도시입니다. | String | Redmond |
| 15 | Microsoft_CompanyOfficeState | 주. 이는 공개적으로 사용 가능한 회사 사무실 주입니다. | String | 워싱턴 |
| 16 | Microsoft_CompanyOfficeCountryOrRegion | 국가 또는 지역입니다. 자유 형식 문자열 값입니다(예: "미국"). 공개적으로 사용 가능한 회사 사무실 국가 또는 지역입니다. | String | 미국 |
| 17 | Microsoft_CompanyOfficePostalCode | 우편 번호입니다. 공개적으로 사용 가능한 회사 사무실 우편 번호입니다. | String | 98004 |
| 18 | Microsoft_Company | 회사 이름입니다. | 문자열 | Contoso |
속성 매핑에 대한 특성
다음 표에서는 Microsoft 365 특성의 조직 데이터가 Microsoft 365 사용자 프로필 스키마의 속성에 매핑하는 방법을 보여줍니다.
| # | .csv 파일의 특성(열 머리글) | Microsoft 365 사용자 프로필 스키마의 속성 |
|---|---|---|
| 1 | Microsoft_PersonEmail | 해당 없음 전자 메일은 최종 사용자의 Microsoft Entra objectId로 변환되며 내부 처리에 사용됩니다. |
| 2 | Microsoft_ManagerEmail | 직책 -> 관리자 -> userId 전자 메일은 관리자의 Microsoft Entra objectId로 변환되고 Microsoft 365 사용자 프로필에 저장됩니다. |
| 3 | Microsoft_Organization | 직책 -> positionDetail -> companyDetail -> 부서 |
| 4 | Microsoft_LevelDesignation | 직책 -> positionDetail -> 수준 |
| 5 | Microsoft_JobDiscipline | 직책 -> positionDetail -> 역할 |
| 6 | Microsoft_Layer | 직책 -> positionDetail -> 계층 |
| 7 | Microsoft_FirstName | 이름 -> 이름 |
| 8 | Microsoft_LastName | 이름 -> 성 |
| 9 | Microsoft_DisplayName | 이름-> displayName |
| 10 | Microsoft_JobTitle | 직책 -> positionDetail -> jobTitle |
| 11 | Microsoft_CompanyOfficeLocation | 직책 -> positionDetail -> companyDetail -> officeLocation |
| 12 | Microsoft_CompanyPostOfficeBox | 직책 -> positionDetail -> companyDetail -> physicalAddress -> postOfficeBox |
| 13 | Microsoft_CompanyOfficeStreet | 직책 -> positionDetail -> companyDetail -> physicalAddress -> street |
| 14 | Microsoft_CompanyOfficeCity | 직책 -> positionDetail -> companyDetail -> physicalAddress ->시 |
| 15 | Microsoft_CompanyOfficeState | 직책 -> positionDetail -> companyDetail -> physicalAddress ->주 |
| 16 | Microsoft_CompanyOfficeCountryOrRegion | 직책 -> positionDetail -> companyDetail -> physicalAddress -> countryOrRegion |
| 17 | Microsoft_CompanyOfficePostalCode | 직책 -> positionDetail -> companyDetail -> physicalAddress ->postalCode |
| 18 | Microsoft_Company | 직책 -> positionDetail -> companyDetail -> displayName |
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기