캔버스 앱에서 SharePoint에 연결Connect to SharePoint from a canvas app

SharePoint

사용자 지정 목록에서 앱을 자동으로 생성 하려면 SharePoint 사이트에 연결 하거나 기존 앱에 데이터를 추가 하거나 처음부터 앱을 작성 하기 전에 연결을 만듭니다.Connect to a SharePoint site to generate an app automatically from a custom list, or create a connection before you add data to an existing app or build an app from scratch.

데이터가 있는 위치에 따라 이러한 방법 중 하나 또는 모두를 수행할 수 있습니다.Depending on where your data resides, you can take either or both of these approaches:

  • SharePoint Online 사이트 또는 온-프레미스 사이트의 사용자 지정 목록에서 데이터를 표시합니다.Show data from a custom list in a SharePoint Online site or an on-premises site.
  • 이미지를 표시 하 고 (SharePoint Online에 해당) 라이브러리의 비디오 또는 오디오 파일을 재생 합니다.Show images and play video or audio files in a library (SharePoint Online only).

앱 생성Generate an app

사용자 지정 목록에서 데이터를 관리하려는 경우 PowerApps는 3개 화면의 앱을 자동으로 생성합니다.If you want to manage data in a custom list, PowerApps can generate a three-screen app for you automatically. 사용자는 첫 번째 화면에서 목록을 찾아보고, 두 번째 화면에서 항목의 세부 정보를 표시하고 세 번째 화면에서 항목을 업데이트하거나 만들 수 있습니다.Users can browse the list on the first screen, show details of an item in the second screen, and create or update items in the third screen.

참고

SharePoint 목록에 선택, 조회, 또는 개인 또는 그룹 열이 포함된 경우는 이 항목의 뒷부분에 나오는 갤러리에 데이터 표시를 참조하세요.If your SharePoint list contains a Choice, Lookup, or Person or group column, see Show data in a gallery later in this topic.

연결 만들기Create a connection

  1. PowerApps에 로그인하고, 왼쪽 탐색 모음에서 데이터 > 연결을 선택한 후, 왼쪽 위 모퉁이 근처의 새 연결을 선택합니다.Sign in to PowerApps, select Data > Connections in the left navigation bar, and then select New connection near the upper-left corner.

    데이터 선택 >의 왼쪽된 탐색 모음에서 연결 하 고 왼쪽 위 모서리 근처에서 새 연결을 선택 합니다.Select Data > Connections in the left navigation bar, and then select New connection near the upper-left corner.

  2. 오른쪽 위 모서리 근처의 검색 상자에 SharePoint를 입력하거나 붙여 넣고 SharePoint를 선택합니다.In the search box near the upper-right corner, type or paste SharePoint, and then select SharePoint.

    검색 상자 오른쪽 위 모서리 근처에서 입력 또는 붙여 SharePoint 하 고 SharePoint를 선택 합니다.In the search box near the upper-right corner, type or paste SharePoint, and then select SharePoint.

  3. 이러한 단계 중 하나를 수행 합니다.Perform either of these sets of steps:

    • SharePoint Online에 연결하려면 직접 연결(클라우드 서비스) 을 선택하고 만들기를 선택한 후, (메시지가 나타나는 경우) 자격 증명을 입력합니다.To connect to SharePoint Online, select Connect directly (cloud services), select Create, and then provide credentials (if prompted).

      SharePoint Online에 연결 하려면, 직접 연결 (클라우드 서비스)를 선택 합니다.To connect to SharePoint Online, select Connect directly (cloud services)

      연결이 만들어지고 기존 앱에 데이터를 추가 하거나 처음부터 앱을 빌드할 수 있습니다.The connection is created, and you can add a data to an existing app or build an app from scratch.

    • 온-프레미스 사이트에 연결하려면 온-프레미스 데이터 게이트웨이를 사용하여 연결을 선택합니다.To connect to an on-premises site, select Connect using on-premises data gateway.

      온-프레미스 사이트에 연결 하려면 선택 * * 온-프레미스 데이터 게이트웨이 사용 하 여 연결)To connect to on-premises site, select **Connect using on-premises data gateway)

      인증 유형으로 Windows를 지정한 다음 자격 증명을 지정합니다.Specify Windows as the authentication type, and then specify your credentials. 자격 증명에 도메인 이름이 포함된 경우 도메인\별칭 형식으로 지정합니다.(If your credentials include a domain name, specify it as domain\alias.)

      자격 증명 지정Specify credentials

      게이트웨이 선택 아래에서 사용하려는 게이트웨이를 선택하고 만들기를 선택합니다.Under Choose a gateway, select the gateway that you want to use, and then select Create.

      참고

      설치된 온-프레미스 데이터 게이트웨이가 없다면, 게이트웨이를 설치하고, 게이트웨이 목록을 새로 고치려면 해당 아이콘을 선택합니다.If you don't have an on-premises data gateway installed, install one, and then select the icon to refresh the list of gateways.

      게이트웨이 선택Choose gateway

      연결이 만들어지고 기존 앱에 데이터를 추가 하거나 처음부터 앱을 빌드할 수 있습니다.The connection is created, and you can add a data to an existing app or build an app from scratch.

기존 앱에 데이터 추가Add data to an existing app

  1. PowerApps Studio에서 업데이트하려는 앱을 열고 보기 탭을 선택한 후 데이터 원본을 선택합니다.In PowerApps Studio, open the app that you want to update, select the View tab, and then select Data sources.

    보기 탭에 선택 하 고 데이터 원본On the View tab, and then select Data sources

  2. 데이터 창에서 데이터 원본 추가 > SharePoint를 선택합니다.In the Data pane, select Add data source > SharePoint.

  3. SharePoint 사이트에 연결 아래 최근에 사용한 사이트 목록에서 사이트를 선택하거나 사용하려는 사이트의 URL을 입력하거나 붙여넣고 연결을 선택합니다.Under Connect to a SharePoint site, select an entry in the Recent sites list (or type or paste the URL for the site that you want to use), and then select Connect.

    사이트를 선택 합니다.Select site

  4. 목록 선택에서 사용하려는 문서 또는 하나 이상의 목록의 확인란을 선택한 후 연결을 선택합니다.Under Choose a list, select the check box for Documents or one or more lists that you want to use, and then select Connect:

    선택 목록에서를 사용 하려는 하나 이상의 목록 또는 문서에 대 한 확인란을 선택 하 고 연결을 선택Under Choose a list, select the check box for Documents or one or more lists that you want to use, and then select Connect

    일부 목록 형식은 기본적으로 표시되지 않습니다.Not all types of lists appear by default. PowerApps는 탬플릿 기반 목록이 아닌 사용자 지정 목록을 지원합니다.PowerApps supports custom lists, not template-based lists. 사용 하려는 목록의 이름을 표시 되지 않으면 아래쪽으로 스크롤하여 다음 포함 된 상자에 목록 이름을 입력 사용자 지정 테이블 이름을 입력합니다.If the name of the list that you want to use doesn't appear, scroll to the bottom, and then type the name of the list in the box that contains Enter custom table name.

    사용자 지정 목록 이름 입력을 포함 하는 상자에서 목록의 이름을 입력 합니다.Type the name of the list in the box that contains Enter a custom list name.

    데이터 원본이 앱에 추가됩니다.The data source or sources are added to your app.

처음부터 고유한 앱 빌드Build your own app from scratch

처음부터 앱 만들기의 개념을 Excel 대신 SharePoint에 적용합니다.Apply the concepts in Create an app from scratch to SharePoint instead of Excel.

사용자 지정 목록이 이러한 유형의 열을 포함하는 경우, 갤러리에 있는 하나 이상의 레이블 컨트롤의 텍스트 속성을 설정하기 위해 수식 입력줄을 사용하여 해당 데이터를 갤러리의 컨트롤에서 표시할 수 있습니다.If your custom list contains any of these types of columns, show that data in a Gallery control by using the formula bar to set the Text property of one or more Label controls in that gallery:

  • 에 대 한는 Choice 또는 조회 열을 지정 ThisItem. ColumnName합니다. 값 해당 열에 데이터를 표시 하도록 합니다.For a Choice or Lookup column, specify ThisItem.ColumnName.Value to show data in that column.

    예를 들어 이름이 Location선택 열이 있으면 ThisItem.Location.Value을, 이름이 PostalCode조회 열이 있으면 ThisItem.PostalCode.Value를 지정합니다.For example, specify ThisItem.Location.Value if you have a Choice column named Location, and specify ThisItem.PostalCode.Value if you have a Lookup column named PostalCode.

  • 개인 또는 그룹 열을 지정 ThisItem. ColumnName합니다. DisplayName 사용자 또는 그룹의 표시 이름을 표시 합니다.For a Person or Group column, specify ThisItem.ColumnName.DisplayName to show the display name of the user or the group.

    예를 들어 이름이 Manager개인 또는 그룹을 표시하려면 ThisItem.Manager.DisplayName을 지정합니다.For example, specify ThisItem.Manager.DisplayName to show display names from a Person or Group column named Manager.

    이메일 주소나 직함 등과 같은 다른 사용자 정보를 표시할 수도 있습니다.You can also show different information about users, such as email addresses or job titles. 지정할 옵션의 전체 목록을 표시할 ThisItem. ColumnName합니다.To display a complete list of options, specify ThisItem.ColumnName. (마침표 포함).(including the trailing period).

    참고

    CreatedBy 열에 대해 목록에서 항목을 만든 사용자의 표시 이름을 표시하려면 ThisItem.Author.DisplayName을 지정합니다.For a CreatedBy column, specify ThisItem.Author.DisplayName to show the display names of users who created items in the list. ModifiedBy 열에 대해 목록에서 항목을 변경한 사용자의 표시 이름을 표시하려면 ThisItem.Editor.DisplayName을 지정합니다.For a ModifiedBy column, specify ThisItem.Editor.DisplayName to show the display names of users who changed items in the list.

  • 관리 되는 메타 데이터 열을 지정 ThisItem. ColumnName합니다. 레이블 해당 열에 데이터를 표시 하도록 합니다.For a Managed Metadata column, specify ThisItem.ColumnName.Label to show data in that column.

    예를 들어 이름이 Languages관리되는 메타데이터가 있으면 ThisItem.Languages.Label을 지정합니다.For example, specify ThisItem.Languages.Label if you have a Managed Metadata column named Languages.

라이브러리에서 데이터 표시Show data from a library

SharePoint 라이브러리에 몇 개의 이미지가 있는 경우 드롭다운 컨트롤을 추가하여 사용자가 표시할 이미지를 지정할 수 있습니다.If you have several images in a SharePoint library, you can add a Drop down control to your app so that users can specify which image to show. 비디오 같은 다른 종류의 데이터 및 갤러리 컨트롤 같은 다른 컨트롤에도 동일한 원칙을 적용할 수 있습니다.You can also apply the same principles to other controls, such as Gallery controls, and other types of data, such as videos.

  1. 기존 연결이 없으면 연결을 만듭니다. 그리고 기존 앱에 데이터를 추가합니다.If you haven't already, create a connection, and then add data to an existing app.

  2. 드롭다운 컨트롤을 추가하고 이름을 ImageList로 변경합니다.Add a Drop down control, and name it ImageList.

  3. ImageListItems 속성을 문서로 설정합니다.Set the Items property of ImageList to Documents.

  4. 오른쪽 창의 속성 탭에서 Value 목록을 열고 이름을 선택합니다.On the Properties tab of the right-hand pane, open the Value list, and then select Name.

    ImageList에 라이브러리의 이미지 파일 이름이 나타납니다.The file names of the images in your library appear in ImageList.

    이미지 목록List of images

  5. 이미지 컨트롤을 추가하고 image 속성을 다음 식으로 설정합니다.Add an Image control, and set its Image property to this expression:

    ImageList.Selected.'Link to item'

  6. F5 키를 선택한 후에 ImageList에서 다른 값을 선택합니다.Press F5, and then select a different value in ImageList.

    지정 된 이미지가 표시 됩니다.The image that you specified appears.

    샘플 이미지Sample image

SharePoint 라이브러리에서 데이터를 표시하는 더 복잡한 접근 방식을 보여 주는 샘플 앱을 다운로드할 수 있습니다.You can download a sample app that demonstrates a more complex approach to showing data from a SharePoint library.

  1. 앱을 다운로드한 후, PowerApps Studio를 열어 왼쪽 탐색 모음에서 열기를 선택한 후 찾아보기를 선택합니다.After you download the app, open PowerApps Studio, select Open in the left navigation bar, and then select Browse.
  2. 열기 대화 상자에서 다운로드한 파일을 찾아서 열고, 이 항목의 처음 두 절차를 수행하여 데이터 원본으로 SharePoint 라이브러리를 추가합니다.In the Open dialog box, find and open the file that you downloaded, and then add a SharePoint library as a data source by following the first two procedures in this topic.

참고

기본적으로 이 앱은 위임 경고를 표시하지만, 라이브러리에 500개 미만의 항목이 포함되어 있으면 무시할 수 있습니다.By default, this app shows delegation warnings, but you can ignore them if your library contains fewer than 500 items.

이 한 화면 앱의 왼쪽 아래 모서리에 있는 목록에는 라이브러리의 모든 파일 보여 줍니다.In this one-screen app, the list in the lower-left corner shows all files in your library.

  • 맨 위쪽에 있는 검색 상자에 하나 이상의 문자를 입력하거나 붙여 넣어 파일을 검색할 수 있습니다.You can search for a file by typing or pasting one or more characters in the search box near the top.
  • 라이브러리에 폴더가 있으면 제목 표시줄 바로 아래 폴더 목록에서 필터 아이콘을 선택하여 파일 목록을 필터링할 수 있습니다.If your library contains folders, you can filter the list of files by selecting a filter icon in the list of folders just under the title bar.

원하는 파일을 찾으면 오른쪽의 비디오, 이미지, 또는 오디오 컨트롤에 표시되도록 선택합니다.When you find the file that you want, select it to show it in the Video, Image, or Audio control along the right-hand side.

샘플 이미지Sample image

알려진 문제Known issues

목록Lists

PowerApps는 공백을 포함하는 열 이름을 읽을 수 있지만 16진수 이스케이프 코드("_x0020_")를 사용하여 공백을 바꿉니다.PowerApps can read column names that contain spaces, but the spaces are replaced with the hexadecimal escape code "_x0020_". 예를 들어 SharePoint의 "Column Name" 은 데이터 레이아웃에 표시되거나 수식에 사용될 때 PowerApps에 "Column_x0020_Name" 으로 나타납니다.For example, "Column Name" in SharePoint will appear as "Column_x0020_Name" in PowerApps when displayed in the data layout or used in a formula.

일부 유형의 열은 지원 되며 일부 유형의 열에는 모든 카드 형식을 지원 합니다.Not all types of columns are supported, and not all types of columns support all types of cards.

열 형식Column type 지원Support 기본 카드Default cards
한 줄 텍스트Single line of text Yes 보기 텍스트 View text
여러 줄 텍스트Multiple lines of text Yes 보기 텍스트 View text
선택Choice Yes 보기 조회View lookup
편집 조회Edit lookup
다중 선택 보기View multiselect
다중 선택 편집Edit multiselect
번호Number Yes 보기 백분율View percentage
보기 등급View rating
보기 텍스트 View text
통화Currency Yes 보기 백분율View percentage
보기 등급View rating
텍스트 보기View text
날짜 및 시간Date and Time Yes 보기 텍스트 View text
조회Lookup Yes 보기 조회View lookup
편집 조회Edit lookup
다중 선택 보기View multiselect
다중 선택 편집Edit multiselect
부울(Yes/No)Boolean (Yes/No) Yes 보기 텍스트 View text
보기 설정/해제View toggle
개인 또는 그룹Person or Group Yes 보기 조회View lookup
편집 조회Edit lookup
다중 선택 보기View multiselect
다중 선택 편집Edit multiselect
하이퍼링크Hyperlink Yes 보기 URLView URL
보기 텍스트 View text
그림Picture 예(읽기 전용)Yes (read-only) 보기 이미지View image
보기 텍스트 View text
첨부 파일Attachment 예(읽기 전용)Yes (read-only) 첨부 파일 보기View Attachments
계산됨Calculated 예(읽기 전용)Yes (read-only)
작업 결과Task Outcome 아니요No
외부 데이터External data 아니요No
관리되는 메타데이터Managed Metadata 예(읽기 전용)Yes (read-only)
등급Rating 아니요No

라이브러리Libraries

  • PowerApps에서 라이브러리에 파일을 업로드할 수 없습니다.You can't upload files from PowerApps to a library.
  • PDF 뷰어 컨트롤의 라이브러리에서 PDF 파일을 표시할 수 없습니다.You can't show PDF files from a library in a PDF Viewer control.
  • PowerApps Mobile은 Download 함수를 지원하지 않습니다.PowerApps Mobile doesn't support the Download function.
  • 사용자가 PowerApps Mobile 또는 Windows 10 앱에서 앱을 실행하는 경우 갤러리의 라이브러리 콘텐츠를 표시하도록 Launch 함수를 사용합니다.If your users will run the app in PowerApps Mobile or the Windows 10 app, use the Launch function to display library content in a gallery.

다음 단계Next steps