캔버스 앱에서 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.

  • 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 붙여 넣습니다 선택한 후 Connect합니다.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. 아래 목록을 선택에 대 한 확인란을 선택 문서 또는 사용 하 고 클릭 하려는 하나 이상의 목록 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:

    선택 목록에서를 사용 하려는 하나 이상의 목록 또는 문서에 대 한 확인란을 선택 하 고 연결을 선택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 a custom list 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:

  • 선택 또는 조회 열에 대해 해당 열에 데이터를 표시하도록 ThisItem.[ColumnName].Value를 지정합니다.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]. (맨 마지막에 마침표 있음).(with 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].Label을 지정합니다.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. 설정 합니다 항목 속성을 ImageList문서합니다.Set the Items property of ImageList to Documents.

  4. 속성 열고 오른쪽 창의 탭을 목록 및 선택한 이름합니다.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. 추가 된 이미지 설정 해당 이미지 속성을이 식: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을 지원 하지 않습니다 합니다 다운로드 함수입니다.PowerApps Mobile doesn't support the Download function.
  • 사용자가 앱에서 PowerApps Mobile 또는 Windows 10 앱을 실행 하는 경우 사용 합니다 시작 라이브러리 콘텐츠 갤러리에 표시할 함수.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