Power Apps에서 Office 365 사용자에 연결

Office 365 Users.

Office 365 사용자를 통해 Office 365 계정을 사용하여 조직의 사용자 프로파일에 액세스할 수 있습니다. 프로필, 사용자 프로필, 사용자의 관리자 또는 직속 부하의 정보 가져오기 등 다양한 작업을 수행할 수 있습니다.

앱의 레이블에 이 정보를 표시할 수 있습니다. 하나의 함수, 여러 함수를 표시할 수 있고 다양한 기능을 조합할 수도 있습니다. 예를 들어, 사용자 이름 및 전화 번호를 결합하는 식을 만들고 앱에서 이 정보를 표시할 수 있습니다.

이 문서에서는 앱에 Office 365 Users를 연결로 추가하고, Office 365 Users를 데이터 원본으로 추가하는 방법과 갤러리 컨트롤에서 테이블 데이터를 사용하는 방법을 설명합니다.

필수 구성 요소

연결 추가

  1. 데이터 연결을 추가하고 Office 365 사용자를 선택합니다.

    Office 365에 연결합니다.

  2. 연결을 선택하고 로그인하라는 메시지가 표시되면 회사 계정을 입력합니다.

Office 365 사용자 연결이 만들어지고 앱에 추가됩니다. 이제 사용할 수 있습니다.

앱에서 연결 사용

현재 사용자에 대한 정보 표시

  1. 삽입 메뉴에서 레이블을 선택합니다.

  2. 함수 막대에서 다음 수식 중 하나에 Text 속성을 설정합니다.

    Office365Users.MyProfile().City
    Office365Users.MyProfile().CompanyName
    Office365Users.MyProfile().Country
    Office365Users.MyProfile().Department
    Office365Users.MyProfile().DisplayName
    Office365Users.MyProfile().GivenName
    Office365Users.MyProfile().Id
    Office365Users.MyProfile().JobTitle
    Office365Users.MyProfile().Mail
    Office365Users.MyProfile().MailNickname
    Office365Users.MyProfile().mobilePhone
    Office365Users.MyProfile().OfficeLocation
    Office365Users.MyProfile().PostalCode
    Office365Users.MyProfile().Surname
    Office365Users.MyProfile().TelephoneNumber
    Office365Users.MyProfile().UserPrincipalName
    Office365Users.MyProfile().AccountEnabled

레이블에 현재 사용자에 대해 입력한 정보가 표시됩니다.

다른 사용자에 대한 정보 표시

  1. 삽입 메뉴에서 Text를 선택한 다음 Text input을 선택합니다. InfoAbout으로 이름을 바꿉니다.

    컨트롤 이름 바꾸기.

  2. InfoAbout에 조직의 사용자 전자 메일 주소를 입력하거나 붙여넣습니다. 예를 들어 yourName@yourCompany.com으로 입력합니다.

  3. 레이블(삽입 메뉴)를 추가하고 다음 수식 중 하나에 Text 속성을 설정합니다.

    • 다른 사용자에 대한 정보 표시:

      Office365Users.UserProfile(InfoAbout.Text).City
      Office365Users.UserProfile(InfoAbout.Text).CompanyName
      Office365Users.UserProfile(InfoAbout.Text).Country
      Office365Users.UserProfile(InfoAbout.Text).Department
      Office365Users.UserProfile(InfoAbout.Text).DisplayName
      Office365Users.UserProfile(InfoAbout.Text).GivenName
      Office365Users.UserProfile(InfoAbout.Text).Id
      Office365Users.UserProfile(InfoAbout.Text).JobTitle
      Office365Users.UserProfile(InfoAbout.Text).Mail
      Office365Users.UserProfile(InfoAbout.Text).MailNickname
      Office365Users.UserProfile(InfoAbout.Text).mobilePhone
      Office365Users.UserProfile(InfoAbout.Text).OfficeLocation
      Office365Users.UserProfile(InfoAbout.Text).PostalCode
      Office365Users.UserProfile(InfoAbout.Text).Surname
      Office365Users.UserProfile(InfoAbout.Text).TelephoneNumber
      Office365Users.UserProfile(InfoAbout.Text).UserPrincipalName
      Office365Users.UserProfile(InfoAbout.Text).AccountEnabled
      Office365Users.UserProfile(InfoAbout.Text).BusinessPhones

    • 다른 사용자의 관리자에 대한 정보 표시:

      Office365Users.Manager(InfoAbout.Text).City
      Office365Users.Manager(InfoAbout.Text).CompanyName
      Office365Users.Manager(InfoAbout.Text).Country
      Office365Users.Manager(InfoAbout.Text).Department
      Office365Users.Manager(InfoAbout.Text).DisplayName
      Office365Users.Manager(InfoAbout.Text).GivenName
      Office365Users.Manager(InfoAbout.Text).Id
      Office365Users.Manager(InfoAbout.Text).JobTitle
      Office365Users.Manager(InfoAbout.Text).Mail
      Office365Users.Manager(InfoAbout.Text).MailNickname
      Office365Users.Manager(InfoAbout.Text).mobilePhone
      Office365Users.Manager(InfoAbout.Text).OfficeLocation
      Office365Users.Manager(InfoAbout.Text).PostalCode
      Office365Users.Manager(InfoAbout.Text).Surname
      Office365Users.Manager(InfoAbout.Text).TelephoneNumber
      Office365Users.Manager(InfoAbout.Text).UserPrincipalName
      Office365Users.Manager(InfoAbout.Text).AccountEnabled
      Office365Users.Manager(InfoAbout.Text).BusinessPhones

레이블에 지정한 사용자 또는 해당 사용자의 관리자에 대해 입력한 정보가 표시됩니다.

참고

Microsoft Dataverse에서 테이블을 기반으로 하는 앱을 개발하는 경우 이메일 주소 대신 ID를 기준으로 사용자를 지정할 수 있습니다.

예를 들어, 앱을 자동으로 만들고, 레이블 컨트롤이 포함된 화면을 추가하고, 이 수식에 컨트롤의 Text 속성을 설정할 수 있습니다.
Office365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser).DisplayName

연락처를 만들고 앱의 찾아보기 화면에서 해당 연락처를 선택하면 레이블 컨트롤에 표시 이름이 나타납니다.

다른 사용자의 직속 부하 표시

  1. 텍스트 입력 컨트롤을 추가하고(삽입 메뉴 > 텍스트), 이름을 InfoAbout으로 바꿉니다.

  2. InfoAbout에 조직의 사용자 전자 메일 주소를 입력합니다. 예를 들어 yourManagersName@yourCompany.com으로 입력합니다.

  3. 텍스트 포함 갤러리를 추가하고(삽입 메뉴 > 갤러리) 다음 수식에 Items 속성을 설정합니다.

    Office365Users.DirectReports(InfoAbout.Text)

    갤러리에 사용자의 직속 부하에 대해 입력한 정보가 표시됩니다.

    선택한 갤러리의 오른쪽 창에는 해당 갤러리 옵션이 나와 있습니다.

  4. 두 번째 목록에서 JobTitle을 선택합니다. 세 번째 목록에서 DisplayName을 선택합니다. 갤러리에서 이러한 값을 표시하도록 업데이트됩니다.

참고

실제로 첫 번째 상자는 이미지 컨트롤입니다. 이미지를 설정하지 않은 경우 이미지 컨트롤을 삭제하고 그 자리에 레이블을 추가할 수 있습니다. 컨트롤을 추가하고 구성하는 것은 좋은 리소스입니다.

사용자 검색

  1. 텍스트 입력 컨트롤을 추가합니다(삽입 메뉴 > 텍스트 입력).

  2. 삽입 > 세로 갤러리를 선택합니다.

  3. 세로 갤러리 레이아웃을 제목, 부제목, 본문으로 변경합니다.

  4. 갤러리 내부의 첫 번째 행에서 화살표 아이콘을 선택하고 삭제합니다.

  5. 수직 갤러리 수식을 다음으로 업데이트합니다.

    Office365Users.SearchUserV2({searchTerm:TextInput1.Text,top:5}).value
    

    위의 공식에서 검색어는 텍스트 입력 컨트롤(이 예에서는 "TextInput1")에 입력된 텍스트를 참조합니다. 검색 결과는 상위 5개로 제한됩니다.

  6. 갤러리 제목에 표시 이름, 부제목에 직급, 본문에 부서를 표시하도록 세로 갤러리 필드를 업데이트합니다.

    갤러리 필드를 선택했습니다.

  7. 앱을 실행하고 텍스트 입력 상자에 텍스트를 입력합니다. 텍스트를 입력하면 입력 문자열 변경 사항에 따라 결과가 변경됩니다.

    검색의 예.

사용할 수 있는 함수 보기

이 연결에는 다음 함수가 포함됩니다.

함수 이름 설명
DirectReports 지정된 사용자의 직속 부하를 반환합니다.
관리자 지정된 사용자의 관리자에 대한 사용자 프로필을 검색합니다.
MyProfile 현재 사용자에 대한 프로필을 검색합니다.
SearchUser 사용자 프로필의 검색 결과를 검색합니다.
UserProfile 특정 사용자 프로필을 검색합니다.

MyProfile

내 프로필 가져오기: 현재 사용자에 대한 프로필을 검색합니다.

입력 속성

없음.

출력 속성

속성 이름 형식 설명
string 사용자의 도시.
CompanyName string 사용자의 회사.
국가 string 사용자의 국가.
부서 string 사용자의 부서.
DisplayName string 사용자의 표시 이름.
GivenName string 사용자의 이름.
Id string 사용자 id.
JobTitle string 사용자의 직함.
우편 string 사용자의 이메일 id.
MailNickname string 사용자의 닉네임.
mobilePhone string 사용자의 휴대폰 번호.
OfficeLocation string 사용자의 사무실 위치.
PostalCode string 사용자의 우편 번호.
Surname string 사용자의 성.
TelephoneNumber string 사용자의 전화 번호.
UserPrincipalName string 사용자 계정 이름.
AccountEnabled boolean 플래그가 활성화된 계정.
BusinessPhones string 사용자 회사의 전화 번호.

UserProfile

사용자 프로필 가져오기: 특정 사용자 프로필을 검색합니다.

입력 속성

이름 데이터 형식 필수 참석자 설명
Id string 사용자 계정 이름 또는 이메일 id.

출력 속성

속성 이름 형식 설명
string 사용자의 도시.
CompanyName string 사용자의 회사.
국가 string 사용자의 국가.
부서 string 사용자의 부서.
DisplayName string 사용자의 표시 이름.
GivenName string 사용자의 이름.
Id string 사용자 id.
JobTitle string 사용자의 직함.
우편 string 사용자의 이메일 id.
MailNickname string 사용자의 닉네임.
Surname string 사용자의 성.
TelephoneNumber string 사용자의 전화 번호.
UserPrincipalName string 사용자 계정 이름.
AccountEnabled boolean 플래그가 활성화된 계정.
BusinessPhones string 사용자 회사의 전화 번호.

관리자

관리자 가져오기: 지정된 사용자의 관리자에 대한 사용자 프로필을 검색합니다.

입력 속성

이름 데이터 형식 필수 참석자 설명
Id string 사용자 계정 이름 또는 이메일 id.

출력 속성

속성 이름 형식 설명
string 사용자의 도시.
CompanyName string 사용자의 회사.
국가 string 사용자의 국가.
부서 string 사용자의 부서.
DisplayName string 사용자의 표시 이름.
GivenName string 사용자의 이름.
Id string 사용자 id.
JobTitle string 사용자의 직함.
우편 string 사용자의 이메일 id.
MailNickname string 사용자의 닉네임.
mobilePhone string 사용자의 휴대폰 번호.
OfficeLocation string 사용자의 사무실 위치.
PostalCode string 사용자의 우편 번호.
Surname string 사용자의 성.
TelephoneNumber string 사용자의 전화 번호.
UserPrincipalName string 사용자 계정 이름.
AccountEnabled boolean 플래그가 활성화된 계정.
BusinessPhones string 사용자 회사의 전화 번호.

DirectReports

직속 부하 가져오기: 직속 부하를 가져옵니다.

입력 속성

이름 데이터 형식 필수 참석자 설명
Id string 사용자 계정 이름 또는 이메일 id.

출력 속성

속성 이름 형식 설명
string 사용자의 도시.
CompanyName string 사용자의 회사.
국가 string 사용자의 국가.
부서 string 사용자의 부서.
DisplayName string 사용자의 표시 이름.
GivenName string 사용자의 이름.
Id string 사용자 id.
JobTitle string 사용자의 직함.
우편 string 사용자의 이메일 id.
MailNickname string 사용자의 닉네임.
mobilePhone string 사용자의 휴대폰 번호.
OfficeLocation string 사용자의 사무실 위치.
PostalCode string 사용자의 우편 번호.
Surname string 사용자의 성.
TelephoneNumber string 사용자의 전화 번호.
UserPrincipalName string 사용자 계정 이름.
AccountEnabled boolean 플래그가 활성화된 계정.
BusinessPhones string 사용자 회사의 전화 번호.

SearchUser

사용자 검색: 사용자 프로필의 검색 결과를 검색합니다.

입력 속성

이름 데이터 형식 필수 참석자 설명
searchTerm string 아니요 검색 문자열입니다. 적용 대상: 표시 이름, 이름, 성, 메일, 메일 닉네임 및 사용자 계정 이름.

출력 속성

속성 이름 형식 설명
string 사용자의 도시.
CompanyName string 사용자의 회사.
국가 string 사용자의 국가.
부서 string 사용자의 부서.
DisplayName string 사용자의 표시 이름.
GivenName string 사용자의 이름.
Id string 사용자 id.
JobTitle string 사용자의 직함.
우편 string 사용자의 이메일 id.
MailNickname string 사용자의 닉네임.
mobilePhone string 사용자의 휴대폰 번호.
OfficeLocation string 사용자의 사무실 위치.
PostalCode string 사용자의 우편 번호.
Surname string 사용자의 성.
TelephoneNumber string 사용자의 전화 번호.
UserPrincipalName string 사용자 계정 이름.
AccountEnabled boolean 플래그가 활성화된 계정.
BusinessPhones string 사용자 회사의 전화 번호.

참조

참고

귀사의 설명서 언어 기본 설정에 대해 말씀해 주시겠습니까? 간단한 설문 조사에 응해주세요. (이 설문 조사는 영어로 되어 있습니다.)

이 설문 조사는 약 7분 정도 걸립니다. 개인 데이터는 수집되지 않습니다(개인정보처리방침).