PowerApps에서 Office 365 사용자 연결Connect to Office 365 Users connection from PowerApps

Office 365 사용자

Office 365 사용자를 통해 Office 365 계정을 사용하여 조직의 사용자 프로파일에 액세스할 수 있습니다.Office 365 Users lets you access user profiles in your organization using your Office 365 account. 프로필, 사용자 프로필, 사용자의 관리자 또는 직속 부하의 정보 가져오기 등 다양한 작업을 수행할 수 있습니다.You can perform various actions such as get your profile, a user's profile, a user's manager or direct reports.

앱의 레이블에 이 정보를 표시할 수 있습니다.You can display this information in a label on your app. 하나의 함수, 여러 함수를 표시할 수 있고 다양한 기능을 조합할 수도 있습니다.You can display one function, multiple functions, or even combine different functions. 예를 들어, 사용자 이름 및 전화 번호를 결합하는 식을 만들고 앱에서 이 정보를 표시할 수 있습니다.For example, you can create an expression that combines the User Name and Phone Number, and then display this information in your app.

이 토픽에서는 앱에 Office 365 사용자를 연결 및 데이터 원본으로 추가하는 방법과 갤러리 컨트롤에서 테이블 데이터를 사용하는 방법을 설명합니다.This topic shows you how to add Office 365 Users as a connection, add Office 365 Users as a data source to your app, and use table data in a gallery control.

필수 조건Prerequisites

연결 추가Add a connection

  1. 데이터 연결을 추가하고 Office 365 사용자를 선택합니다.Add a data connection and select Office 365 Users:

    Office 365에 연결

  2. 연결을 선택하고 로그인하라는 메시지가 표시되면 회사 계정을 입력합니다.Select Connect, and if prompted to sign in, enter your work account.

Office 365 사용자 연결이 만들어지고 앱에 추가됩니다.The Office 365 Users connection has been created and added to your app. 이제 사용할 수 있습니다.Now, it's ready to be used.

앱에서 연결 사용Use the connection in your app

현재 사용자에 대한 정보 표시Show information about the current user

  1. 삽입 메뉴에서 레이블을 선택합니다.On the Insert menu, select Label

  2. 함수 막대에서 다음 수식 중 하나에 Text 속성을 설정합니다.In the function bar, set its Text property to any of the following formulas:

    Office365Users.MyProfile().Department
    Office365Users.MyProfile().DisplayName
    Office365Users.MyProfile().GivenName
    Office365Users.MyProfile().Id
    Office365Users.MyProfile().JobTitle
    Office365Users.MyProfile().Mail
    Office365Users.MyProfile().MailNickname
    Office365Users.MyProfile().Surname
    Office365Users.MyProfile().TelephoneNumber
    Office365Users.MyProfile().UserPrincipalName
    Office365Users.MyProfile().AccountEnabled

레이블에 현재 사용자에 대해 입력한 정보가 표시됩니다.The label shows the information that you entered about the current user.

다른 사용자에 대한 정보 표시Show information about another user

  1. 삽입 메뉴에서 텍스트 상자를 선택한 다음 텍스트 입력을 선택합니다.On the Insert menu, select Text, and then select Text input. InfoAbout로 이름을 바꿉니다.Rename it InfoAbout:

    컨트롤 이름 바꾸기

  2. InfoAbout에 조직의 사용자 전자 메일 주소를 입력하거나 붙여넣습니다.In InfoAbout, type or paste an email address of a user in your organization. 예를 들어 yourName@yourCompany.com으로 입력합니다.For example, type in yourName@yourCompany.com.

  3. 레이블(삽입 메뉴)를 추가하고 다음 수식 중 하나에 Text 속성을 설정합니다.Add a Label (Insert menu), and set its Text property to any of the following formulas:

    • 다른 사용자에 대한 정보 표시:To show information about another user:

      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).Surname
      Office365Users.UserProfile(InfoAbout.Text).TelephoneNumber
      Office365Users.UserProfile(InfoAbout.Text).UserPrincipalName
      Office365Users.UserProfile(InfoAbout.Text).AccountEnabled

    • 다른 사용자의 관리자에 대한 정보 표시:To show information about another user's manager:

      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).Surname
      Office365Users.Manager(InfoAbout.Text).TelephoneNumber
      Office365Users.Manager(InfoAbout.Text).UserPrincipalName
      Office365Users.Manager(InfoAbout.Text).AccountEnabled

레이블에 지정한 사용자 또는 해당 사용자의 관리자에 대해 입력한 정보가 표시됩니다.The label shows the information that you entered about the user you specified or that user's manager.

참고

Common Data Service에서 엔터티를 기반으로 하는 앱을 개발하는 경우 이메일 주소 대신 ID를 기준으로 사용자를 지정할 수 있습니다.If you're developing an app based on an entity in the Common Data Service, you can specify a user based on ID instead of email address.

예를 들어, 앱을 자동으로 만들고, 레이블 컨트롤이 포함된 화면을 추가하고, 이 수식에 컨트롤의 Text 속성을 설정할 수 있습니다.For example, you can create an app automatically, add a screen that contains a Label control, and set the control's Text property to this formula:
Office365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser).DisplayNameOffice365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser).DisplayName

연락처를 만들고 앱의 찾아보기 화면에서 해당 연락처를 선택하면 레이블 컨트롤에 표시 이름이 나타납니다.If you create a contact and select that contact in the browse screen of the app, the Label control will show your display name.

다른 사용자의 직속 부하 표시Show the direct reports of another user

  1. 텍스트 입력 컨트롤을 추가하고(삽입 메뉴 > 텍스트), 이름을 InfoAbout으로 바꿉니다.Add a Text input control (Insert menu > Text), and rename it InfoAbout.

  2. InfoAbout에 조직의 사용자 전자 메일 주소를 입력합니다.In InfoAbout, enter the email address of a user in your organization. 예를 들어 yourManagersName@yourCompany.com으로 입력합니다.For example, enter yourManagersName@yourCompany.com

  3. 텍스트 추가 갤러리를 추가하고(삽입 메뉴 > 갤러리) 다음 수식에 Items 속성을 설정합니다.Add a With text gallery (Insert menu > Gallery), and set its Items property to the following formula:

    Office365Users.DirectReports(InfoAbout.Text)

    갤러리에 사용자의 직속 부하에 대해 입력한 정보가 표시됩니다.The gallery shows information about the direct reports of the user you entered.

    선택한 갤러리의 오른쪽 창에는 해당 갤러리 옵션이 나와 있습니다.With the gallery selected, the right-hand pane shows options for that gallery.

  4. 두 번째 목록에서 JobTitle을 선택합니다.In the second list, select JobTitle. 세 번째 목록에서 DisplayName을 선택합니다.In the third list, select DisplayName. 갤러리에서 이러한 값을 표시하도록 업데이트됩니다.The gallery is updated to show these values.

참고

실제로 첫 번째 상자는 이미지 컨트롤입니다.The first box is actually an image control. 이미지를 설정하지 않은 경우 이미지 컨트롤을 삭제하고 그 자리에 레이블을 추가할 수 있습니다.If you don't have an image, you can delete the image control, and add a label in its place. 컨트롤을 추가하고 구성하는 것은 좋은 리소스입니다.Add and configure controls is a good resource.

사용자 검색Search for users

  1. 텍스트 입력 컨트롤을 추가하고(삽입 메뉴 > 텍스트), SearchTerm으로 이름을 바꿉니다.Add a Text input control (Insert menu > Text), and rename it SearchTerm. 검색할 이름을 입력합니다.Enter a name to search. 예를 들어 성을 제외한 이름을 입력합니다.For example, enter your first name.

  2. 텍스트 추가 갤러리를 추가하고(삽입 메뉴 > 갤러리) 다음 수식에 Items 속성을 설정합니다.Add a With text gallery (Insert menu > Gallery), and set its Items property to the following formula:

    Office365Users.SearchUser({searchTerm: SearchTerm.Text})

    갤러리에 입력한 검색 텍스트를 포함한 이름이 표시됩니다.The gallery shows users whose name contains the search text you entered.

    선택한 갤러리의 오른쪽 창에는 해당 갤러리 옵션이 나와 있습니다.With the gallery selected, the right-hand pane shows options for that gallery.

  3. 두 번째 목록에서 Mail을 선택합니다.In the second list, select Mail. 세 번째 목록에서 DisplayName을 선택합니다.In the third list, select DisplayName.

    갤러리의 두 번째와 세 번째 레이블이 업데이트됩니다.The second and third labels in the gallery are updated.

사용할 수 있는 함수 보기View the available functions

이 연결에는 다음 함수가 포함됩니다.This connection includes the following functions:

함수 이름Function Name 설명Description
MyProfileMyProfile 현재 사용자에 대한 프로필을 검색합니다.Retrieves the profile for the current user
UserProfileUserProfile 특정 사용자 프로필을 검색합니다.Retrieves a specific user profile
ManagerManager 지정된 사용자의 관리자에 대한 사용자 프로필을 검색합니다.Retrieves user profile for the manager of the specified user
DirectReportsDirectReports 지정된 사용자의 직속 부하를 반환합니다.Returns the direct reports for the specified user
SearchUserSearchUser 사용자 프로필의 검색 결과를 검색합니다.Retrieves search results of user profiles

MyProfileMyProfile

내 프로필 가져오기: 현재 사용자에 대한 프로필을 검색합니다.Get my profile: Retrieves the profile for the current user.

입력 속성Input properties

없음None.

출력 속성Output properties

속성 이름Property Name 유형Type 설명Description
DepartmentDepartment 문자열string 사용자의 부서입니다.Department of the user.
DisplayNameDisplayName 문자열string 사용자의 표시 이름입니다.Display name of user.
GivenNameGivenName 문자열string 사용자의 지정된 이름입니다.Given name of user.
ID입니다.Id 문자열string 사용자 ID입니다.User id
JobTitleJobTitle 문자열string 사용자의 직위입니다.Job Title of the user.
메일Mail 문자열string 사용자의 전자 메일 ID입니다.Email id of user.
MailNicknameMailNickname 문자열string 사용자의 애칭입니다.Nickname of user.
SurnameSurname 문자열string 사용자의 성입니다.Surname of user.
TelephoneNumberTelephoneNumber 문자열string 사용자의 전화 번호입니다.Telephone number of user.
UserPrincipalNameUserPrincipalName 문자열string 사용자 계정 이름입니다.User Principal Name.
AccountEnabledAccountEnabled 부울boolean 플래그가 활성화된 계정입니다.Account enabled flag.

UserProfileUserProfile

사용자 프로필 가져오기: 특정 사용자 프로필을 검색합니다.Get user profile: Retrieves a specific user profile.

입력 속성Input properties

이름Name 데이터 형식Data Type 필수Required 설명Description
ID입니다.Id 문자열string yes 사용자 계정 이름 또는 전자 메일 ID입니다.User principal name or email id

출력 속성Output properties

속성 이름Property Name 유형Type 설명Description
DepartmentDepartment 문자열string 사용자의 부서입니다.Department of the user.
DisplayNameDisplayName 문자열string 사용자의 표시 이름입니다.Display name of user.
GivenNameGivenName 문자열string 사용자의 지정된 이름입니다.Given name of user.
ID입니다.Id 문자열string 사용자 ID입니다.User id
JobTitleJobTitle 문자열string 사용자의 직위입니다.Job Title of the user.
메일Mail 문자열string 사용자의 전자 메일 ID입니다.Email id of user.
MailNicknameMailNickname 문자열string 사용자의 애칭입니다.Nickname of user.
SurnameSurname 문자열string 사용자의 성입니다.Surname of user.
TelephoneNumberTelephoneNumber 문자열string 사용자의 전화 번호입니다.Telephone number of user.
UserPrincipalNameUserPrincipalName 문자열string 사용자 계정 이름입니다.User Principal Name.
AccountEnabledAccountEnabled 부울boolean 플래그가 활성화된 계정입니다.Account enabled flag.

ManagerManager

관리자 가져오기: 지정된 사용자의 관리자에 대한 사용자 프로필을 검색합니다.Get manager: Retrieves user profile for the manager of the specified user

입력 속성Input properties

이름Name 데이터 형식Data Type 필수Required 설명Description
ID입니다.Id 문자열string yes 사용자 계정 이름 또는 전자 메일 ID입니다.User principal name or email id

출력 속성Output properties

속성 이름Property Name 유형Type 설명Description
DepartmentDepartment 문자열string 사용자의 부서입니다.Department of the user.
DisplayNameDisplayName 문자열string 사용자의 표시 이름입니다.Display name of user.
GivenNameGivenName 문자열string 사용자의 지정된 이름입니다.Given name of user.
ID입니다.Id 문자열string 사용자 ID입니다.User id
JobTitleJobTitle 문자열string 사용자의 직위입니다.Job Title of the user.
메일Mail 문자열string 사용자의 전자 메일 ID입니다.Email id of user.
MailNicknameMailNickname 문자열string 사용자의 애칭입니다.Nickname of user.
SurnameSurname 문자열string 사용자의 성입니다.Surname of user.
TelephoneNumberTelephoneNumber 문자열string 사용자의 전화 번호입니다.Telephone number of user.
UserPrincipalNameUserPrincipalName 문자열string 사용자 계정 이름입니다.User Principal Name.
AccountEnabledAccountEnabled 부울boolean 플래그가 활성화된 계정입니다.Account enabled flag.

DirectReportsDirectReports

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

입력 속성Input properties

이름Name 데이터 형식Data Type 필수Required 설명Description
ID입니다.Id 문자열string yes 사용자 계정 이름 또는 전자 메일 ID입니다.User principal name or email id

출력 속성Output properties

속성 이름Property Name 유형Type 설명Description
DepartmentDepartment 문자열string 사용자의 부서입니다.Department of the user.
DisplayNameDisplayName 문자열string 사용자의 표시 이름입니다.Display name of user.
GivenNameGivenName 문자열string 사용자의 지정된 이름입니다.Given name of user.
ID입니다.Id 문자열string 사용자 ID입니다.User id
JobTitleJobTitle 문자열string 사용자의 직위입니다.Job Title of the user.
메일Mail 문자열string 사용자의 전자 메일 ID입니다.Email id of user.
MailNicknameMailNickname 문자열string 사용자의 애칭입니다.Nickname of user.
SurnameSurname 문자열string 사용자의 성입니다.Surname of user.
TelephoneNumberTelephoneNumber 문자열string 사용자의 전화 번호입니다.Telephone number of user.
UserPrincipalNameUserPrincipalName 문자열string 사용자 계정 이름입니다.User Principal Name.
AccountEnabledAccountEnabled 부울boolean 플래그가 활성화된 계정입니다.Account enabled flag.

SearchUserSearchUser

사용자 검색: 사용자 프로필의 검색 결과를 검색합니다.Search for users: Retrieves search results of user profiles

입력 속성Input properties

이름Name 데이터 형식Data Type 필수Required 설명Description
searchTermsearchTerm 문자열string 아니요no 검색 문자열입니다.Search string. 적용 대상: 표시 이름, 지정된 이름, 성, 메일, 메일 애칭 및 사용자 계정 이름Applies to: display name, given name, surname, mail, mail nickname, and user principal name

출력 속성Output properties

속성 이름Property Name 유형Type 설명Description
DepartmentDepartment 문자열string 사용자의 부서입니다.Department of the user.
DisplayNameDisplayName 문자열string 사용자의 표시 이름입니다.Display name of user.
GivenNameGivenName 문자열string 사용자의 지정된 이름입니다.Given name of user.
ID입니다.Id 문자열string 사용자 ID입니다.User id
JobTitleJobTitle 문자열string 사용자의 직위입니다.Job Title of the user.
메일Mail 문자열string 사용자의 전자 메일 ID입니다.Email id of user.
MailNicknameMailNickname 문자열string 사용자의 애칭입니다.Nickname of user.
SurnameSurname 문자열string 사용자의 성입니다.Surname of user.
TelephoneNumberTelephoneNumber 문자열string 사용자의 전화 번호입니다.Telephone number of user.
UserPrincipalNameUserPrincipalName 문자열string 사용자 계정 이름입니다.User Principal Name.
AccountEnabledAccountEnabled 부울boolean 플래그가 활성화된 계정입니다.Account enabled flag.